| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start ASP Balance (STRASPBAL) command allows the user to start the auxiliary storage pool (ASP) balancing function for one or more ASPs. The types of ASP balancing that can be started are:
The user may specify a time limit that the function is to run for each ASP being balanced or the balance can be set to run to completion. If the balance function needs to be ended, use the End ASP Balance (ENDASPBAL) command. A message will be sent to the system history (QHST) log when the balancing function is started for each ASP. A message will also be sent to the QHST log when the balancing function completes or is ended.
If the balance function is run for a few hours and then stopped, it will continue from where it left off when the balance function restarts. This allows the balancing to be run during off hours over a several day period.
For more information about ASP balancing, see the Hierarchical Storage Management Use, SC41-5351.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TYPE | Balance type | *CAPACITY, *USAGE, *HSM, *MOVDTA, *ENDALC, *RSMALC, *MP | Optional, Positional 2 |
| ASP | ASP number | Single values: *ALL Other values (up to 32 repetitions): 1-32 |
Optional, Positional 1 |
| ASPDEV | ASP device | Single values: *ALLAVL Other values (up to 32 repetitions): Name |
Optional |
| UNIT | Storage unit | Values (up to 300 repetitions): Integer | Optional |
| TIMLMT | Time limit | 1-9999, *NOMAX | Optional, Positional 3 |
| PRIORITY | Balance priority | *LOW, *MEDIUM, *HIGH | Optional |
| SUBTYPE | Subtype | *CALC, *HDD, *SSD | Optional |
| Top |
Specifies the type of auxiliary storage pool (ASP) balancing operation to be done.
Note: A value must always be specified for this parameter.
| Top |
Specifies the auxiliary storage pool (ASP) for which the ASP balancing function is to be started.
Note: A value must be specified for either the ASP number (ASP) parameter or the ASP device (ASPDEV) parameter if *CAPACITY, *USAGE, *HSM or *MP is specified for the Balance type (TYPE) parameter.
Single values
Other values (up to 32 repetitions)
| Top |
Specifies the name of the auxiliary storage pool (ASP) device for which the ASP balancing is to be started.
Note: A value must be specified for either the ASP number (ASP) parameter or the ASP device (ASPDEV) parameter if *CAPACITY, *USAGE, *HSM or *MP is specified for the Balance type (TYPE) parameter.
Single values
Other values (up to 32 repetitions)
| Top |
Specifies the unit number for which new allocations are to be ended (if *ENDALC is specified for the Balance type (TYPE) parameter) or for which new allocations are to resume (if *RSMALC is specified for the TYPE parameter). Specifying TYPE(*MOVDTA) will start moving data off the units marked *ENDALC.
Note: A value must be specified for this parameter if *ENDALC or *RSMALC is specified for the TYPE parameter.
| Top |
Specifies the amount of time, in minutes, that the ASP balancing function will be allowed to run. When the time limit is reached, the function will end. For example, if ASP(*ALL) is specified and the machine has four ASPs configured and TIMLMT(60) is specified, four balance functions are started and each can run 60 minutes. If the balancing of any ASP has not completed after 60 minutes, it will be forced to end. This allows you to do ASP balancing incrementally. The balance function will not run across an IPL.
Note: A value must be specified for this parameter if *CAPACITY, *USAGE, *HSM, *MP or *MOVDTA is specified for the Balance type (TYPE) parameter.
| Top |
Specifies the priority that is to be assigned to the *HSM, *MOVDTA or *MP balance operation.
| Top |
Specifies the disk types that are to participate in the balance and the extent of data movement.
| Top |
Example 1: Starting ASP Balancing for ASP 1
STRASPBAL ASP(1) TIMLMT(*NOMAX) TYPE(*CAPACITY)
This command starts the *CAPACITY ASP balance function for ASP 1. The balance function will run until the capacity for each of the units has been balanced.
Example 2: Starting ASP Balancing with a Time Limit
STRASPBAL ASP(*ALL) TIMLMT(60) TYPE(*USAGE)
This command starts the *USAGE ASP balance function for the system ASP and each configured basic ASP for which the TRCASPBAL command has been run. Each balance function will have a time limit of sixty minutes. After sixty minutes, any balance functions which have not completed will be ended.
Example 3: Starting ASP Balancing for an ASP Device
STRASPBAL ASPDEV(MYASP1) TIMLMT(*NOMAX) TYPE(*CAPACITY)
This command starts the *CAPACITY ASP balance function for the ASP device named MYASP1. The balance function will run until complete.
Example 4: Preparing to Remove Units
STRASPBAL UNIT(11 12 13) TYPE(*ENDALC)
STRASPBAL TYPE(*MOVDTA)
The first command marks units 11, 12 and 13 to no longer receive new allocations. The second command begins to move data off the marked units. It is recommended that the *MOVDTA ASP balancing function be done during an off-peak time.
Example 5: Starting *HSM
STRASPBAL TYPE(*HSM) ASP(MYASP) TIMLMT(600) PRIORITY(*LOW)
This command starts the *HSM ASP balance function for MYASP. The balance function will move low use data from high performance units to low performance units and high use data from low performance units to high performance units. It runs at low priority. If the balance has not completed within 600 minutes, it ends.
Example 6: Starting *HSM from *SSD
STRASPBAL TYPE(*HSM) ASP(1) TIMLMT(240) SUBTYPE(*HDD)
This command starts the *HSM ASP balance function for ASP 1. The balance function will move low use data from high performance HDD units to low performance HDD units and high use data from low performance HDD units to high performance HDD units. It runs at low priority. If the balance has not completed within 240 minutes, it ends.
Example 7: Starting *MP
STRASPBAL TYPE(*MP) ASP(1) TIMLMT(120) PRIORITY(*HIGH)
This command starts the *MP ASP balance function for ASP 1. The balance function will move data with a 'media preference' attribute from HDD units to SSD units and data without the attribute from SSD units to HDD units. It runs at high priority. If the balance has not completed within 120 minutes, it ends.
Example 8: Starting *MP from *SSD
STRASPBAL TYPE(*MP) ASP(1) TIMLMT(240) SUBTYPE(*HDD)
This command starts the *MP ASP balance function for ASP 1. The balance function will move data with a 'media preference' attribute from HDD units to SSD units. It runs at high priority. If the balance has not completed within 120 minutes, it ends.
| Top |
*ESCAPE Messages
| Top |