How To
Summary
New Advanced Analysis command OVERFLOWEDASP is now available to check overflowed status of a user ASP and either enable or disable automatic recovery during a normal, unattended IPL. Previously, the ability to enable ASP overflow recovery was only available in the Navigator GUI.
Steps
Apply the appropriate PTF to add the new Service Tools Advanced Analysis command:
7.2 - MF68245
7.3 - MF68244
7.4 - MF68238
(These are immediate apply PTFs.)
7.2 - MF68245
7.3 - MF68244
7.4 - MF68238
(These are immediate apply PTFs.)
Once the PTF is applied, go into System Service Tools by running command STRSST, and then sign in.
Enter option 1 to Start a service tool.
Enter option 4 to use the Display/Alter/Dump function.
Enter option 1 to Display/Alter storage.
Enter option 2 for Licensed Internal Code (LIC) data.
Enter option 14 for Advanced analysis.
On the top blank line, enter option 1 and command OVERFLOWEDASP.
On the options screen, if you press F4 or enter -H, you will see the help text for the command:
Enter option 1 to Start a service tool.
Enter option 4 to use the Display/Alter/Dump function.
Enter option 1 to Display/Alter storage.
Enter option 2 for Licensed Internal Code (LIC) data.
Enter option 14 for Advanced analysis.
On the top blank line, enter option 1 and command OVERFLOWEDASP.
On the options screen, if you press F4 or enter -H, you will see the help text for the command:
Example:
DISPLAY/ALTER/DUMP
Running macro: OVERFLOWEDASP -H
This macro controls when the recovery of an overflowed Auxiliary Storage
Pool (ASP) is performed.
When the disk units allocated to a traditional User ASP become full, the
User ASP is in an overflowed status. You should recover a User ASP in an
overflowed status as soon as possible. An overflowed ASP affects the
performance of jobs in the partition. If a disk unit in the System ASP
fails, a User ASP in the overflowed status makes recovery much more
difficult and could increase the amount of data that is lost.
The recovery of the overflowed User ASP is performed during the IPL of the
partition in the step called Storage Management Recovery. The data from
the User ASP that resides in the System ASP is moved back to the disk
units in the User ASP. The recovery is only performed if there is enough
capacity in the User ASP to hold the data. Note that moving the data from
the System ASP to the User ASP could require a significant amount of time.
-RECOVER : Overflow recovery will be attempted during an unattended,
normal mode IPL of the partition.
-NORECOVER : Overflow recovery will not be attempted during an unattended,
normal mode IPL, but can still be selected at DST during an
attended IPL in manual mode.
-DISPLAY : Display the current overflow state, current recover setting,
amount of overflowed storage, and capacity amounts of the
User ASPs on this partition.
-ASP : The decimal number of the User ASP the function is to
operate on.
This macro controls when the recovery of an overflowed Auxiliary Storage
Pool (ASP) is performed.
When the disk units allocated to a traditional User ASP become full, the
User ASP is in an overflowed status. You should recover a User ASP in an
overflowed status as soon as possible. An overflowed ASP affects the
performance of jobs in the partition. If a disk unit in the System ASP
fails, a User ASP in the overflowed status makes recovery much more
difficult and could increase the amount of data that is lost.
The recovery of the overflowed User ASP is performed during the IPL of the
partition in the step called Storage Management Recovery. The data from
the User ASP that resides in the System ASP is moved back to the disk
units in the User ASP. The recovery is only performed if there is enough
capacity in the User ASP to hold the data. Note that moving the data from
the System ASP to the User ASP could require a significant amount of time.
-RECOVER : Overflow recovery will be attempted during an unattended,
normal mode IPL of the partition.
-NORECOVER : Overflow recovery will not be attempted during an unattended,
normal mode IPL, but can still be selected at DST during an
attended IPL in manual mode.
-DISPLAY : Display the current overflow state, current recover setting,
amount of overflowed storage, and capacity amounts of the
User ASPs on this partition.
-ASP : The decimal number of the User ASP the function is to
operate on.
Usage: OVERFLOWEDASP <<-RECOVER> <<-ASP> <Asp Number>>
Usage: OVERFLOWEDASP <<-NORECOVER>> <<-ASP> <Asp Number>>
Usage: OVERFLOWEDASP <<-DISPLAY>>
Usage: OVERFLOWEDASP <<-HELP>>
Usage: OVERFLOWEDASP <<-NORECOVER>> <<-ASP> <Asp Number>>
Usage: OVERFLOWEDASP <<-DISPLAY>>
Usage: OVERFLOWEDASP <<-HELP>>
Sample usage:
Recover the overflowed ASP number 6 during an unattended, normal mode
IPL of the partition, if there is sufficient capacity.
OVERFLOWEDASP -RECOVER -ASP 6
Display the overflow status of all user ASPs.
OVERFLOWEDASP -DISPLAY
Do not recover the overflowed ASP number 7 during an unattended, normal
mode IPL of the partition.
OVERFLOWEDASD -NORECOVER -ASP 7
Recover the overflowed ASP number 6 during an unattended, normal mode
IPL of the partition, if there is sufficient capacity.
OVERFLOWEDASP -RECOVER -ASP 6
Display the overflow status of all user ASPs.
OVERFLOWEDASP -DISPLAY
Do not recover the overflowed ASP number 7 during an unattended, normal
mode IPL of the partition.
OVERFLOWEDASD -NORECOVER -ASP 7
On the options screen, if you enter -DISPLAY, you will see the current status of any user ASPs:
Example:
Running macro: OVERFLOWEDASP -DISPLAY
Asp Number: 2
Overflowed: NO
Recover ASP on IPL: NO
Overflow amount: 0 MB
Available Capacity 139574 MB
Total Capacity: 139586 MB
The above example shows the system has only one user ASP (#2), it is has not overflowed into the system ASP, and it is not enabled for automatic recovery during an unattended IPL.
Below is an example that shows ASP 2 has overflowed into the system ASP and the overflow amount exceeds the current free space in ASP 2 (available capacity).
Example:
Example:
Running macro: OVERFLOWEDASP -DISPLAY
Asp Number: 2
Overflowed: YES
Recover ASP on IPL: NO
Overflow amount: 11057 MB
Available Capacity 5 MB
Total Capacity: 139586 MB
Here is an example showing the status of ASP 2 after cleaning up the ASP.
Example:
Running macro: OVERFLOWEDASP -DISPLAY
Asp Number: 2
Overflowed: YES
Recover ASP on IPL: NO
Overflow amount: 11057 MB
Available Capacity 107594 MB
Total Capacity: 139586 MB
At this point there is plenty of free space in ASP 2, but some of the objects that should be in ASP 2 still reside in ASP 1, so the status still shows overflowed. An attended, manual mode IPL could be used to move the overflowed objects back into ASP 2 and reset the overflowed status. However, the OVERFLOWEDASP Advanced Analysis command can also be used to enable automatic recovery during a normal IPL with no user intervention during the IPL, by using the -RECOVER and -ASP parameters.
Example:
Running macro: OVERFLOWEDASP -RECOVER -ASP 2
You selected the option to recover the overflowed ASP
during an unattended, normal mode IPL of the partition.
The function to recover the overflowed ASP during an unattended,
normal mode IPL is enabled.
The -DISPLAY option can be used to verify that automatic recovery has been enabled.
Example:
Running macro: OVERFLOWEDASP -DISPLAY
Asp Number: 2
Overflowed: YES
Recover ASP on IPL: YES
Overflow amount: 11057 MB
Available Capacity 107594 MB
Total Capacity: 139586 MB
A normal, unattended IPL was then performed, which spent some extra time at SRC C6004272 while it moved objects back into ASP 2. After the IPL, OVERFLOWEDASP was used again to check the status.
Example:
Running macro: OVERFLOWEDASP -DISPLAY
Asp Number: 2
Overflowed: NO
Recover ASP on IPL: YES
Overflow amount: 0 MB
Available Capacity 96538 MB
Total Capacity: 139586 MB
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0"}]
Was this topic helpful?
Document Information
Modified date:
28 December 2020
UID
ibm16394510