ENDASPBAL (End ASP Balance)

ENDASPBAL Command syntax diagram

 

Purpose

The End ASP Balance (ENDASPBAL) command allows the user to end the auxiliary storage pool (ASP) balance function that was started using the Start ASP Balance (STRASPBAL) CL command. A message will be sent to the system history (QHST) log when the ASP balance function is ended for each ASP.

For more information about ASP balancing see the Hierarchical Storage Management

book.

Restrictions: You must have *ALLOBJ special authority to use this command.

ASP

Specifies the auxiliary storage pool (ASP) number for which the ASP balancing function is to be ended. A value must be specified for the ASP parameter or the ASPDEV parameter.

*ALL: ASP balancing will be ended for the system ASP (ASP number 1) and all basic ASPs (ASP numbers 2-32) defined to the system.

auxiliary-storage-pool-number: Specify the ASP for which ASP balancing is to be ended. Valid ASP numbers are 1 to 32. Up to 32 ASP numbers may be specified.

ASPDEV

Specifies the name of the auxiliary storage pool (ASP) device for which the ASP balancing is to be ended. A value must be specified for the ASP parameter or the ASPDEV parameter.

*ALLAVL: ASP balancing will be ended for all ASP devices that currently have a status of 'Available'.

auxiliary-storage-device-name: Specify the name of the independent ASP device for which ASP balancing is to be ended. Up to 32 ASP device names may be specified.>

Examples for ENDASPBAL

Example 1: End ASP Balance for ASP 1

ENDASPBAL  ASP(1)

This command allows the user to end the ASP balancing function for ASP 1.

Example 2: End ASP Balance for ASPs 1-32

ENDASPBAL  ASP(*ALL)

This command will end the ASP balancing functions for the system ASP (ASP number 1) and each basic ASP (ASP numbers 2-32) that is currently being balanced.

Example 3: End ASP Balance for an ASP Device

ENDASPBAL  ASPDEV(MYASP1)

This command will end the ASP balancing function for ASP device MYASP1.

Example 4: End ASP Balancing for All ASPs

ENDASPBAL  ASP(*ALL) ASPDEV(*ALLAVL)

This command will end the ASP balancing functions that may be active on ASP numbers 1-32 and all ASP devices that have a status of 'Available'.

Error messages for ENDASPBAL

*ESCAPE Messages

CPF18AC

ASP balancing not active for ASP &2.

CPF18AD

ASP &2 must contain more than a single unit.

CPF1890

*ALLOBJ authority required for requested operation.

CPF9829

Auxiliary storage pool &2 not found.