Change ASP Attribute (CHGASPA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Auxiliary Storage Pool Attributes (CHGASPA) command allows the user to change attributes that control the behavior of an auxiliary storage pool (ASP).

Restrictions:

Top

Parameters

Keyword Description Choices Notes
ASP ASP number Single values: *ALLUSR
Other values (up to 31 repetitions): 2-32
Optional, Positional 1
ASPDEV ASP device Single values: *ALLAVL
Other values (up to 32 repetitions): Name
Optional
CPRRCYPCY Compression recovery policy *SAME, *OVERFLOW, *RETRY, *WAIT Optional
Top

ASP number (ASP)

Specifies the auxiliary storage pool (ASP) for which the ASP attributes are to be changed.

Note: A value must be specified for either the ASP number (ASP) parameter or the ASP device (ASPDEV) parameter.

Single values

*ALLUSR
The specified attributes will be changed for all basic ASPs (ASP numbers 2-32) defined. The system ASP (ASP number 1) will not be changed.

Other values (up to 31 repetitions)

2-32
Specify the number of the basic ASP for which the specified attribute is to be changed.
Top

ASP device (ASPDEV)

Specifies the name of the auxiliary storage pool (ASP) device for which the attributes are to be changed.

Note: A value must be specified for either the ASP number (ASP) parameter or the ASP device (ASPDEV) parameter.

Single values

*ALLAVL
The specified attributes will be changed for all ASP devices that currently have a state of 'Available'.

Other values (up to 32 repetitions)

name
Specify the name of the independent ASP device for which the specific attribute is to be changed.
Top

Compression recovery policy (CPRRCYPCY)

Specifies what the compression recovery policy for the auxiliary storage pool (ASP) will be. This policy is how the system will handle ASP overflow situations when the ASP contains compressed units. See the Backup and Recovery book, SC41-5304 for more information about the compression recovery policy.

*SAME
The compression recovery policy does not change.
*OVERFLOW
When the system detects a condition where the ASP capacity is about to be exceeded, data will immediately overflow into the system ASP. The system default compression recovery policy is *OVERFLOW.

Note: This parameter value cannot be specified for ASP devices.

*RETRY
When the system detects a condition where the ASP capacity is about to be exceeded, the system posts system reference code (SRC) A6xx 0277 in the system control panel and waits for space to become available in the ASP. Once space becomes available, the SRC is removed from the system control panel and normal operation will resume for that ASP.

If space cannot be made available in the ASP and the ASP is a basic user ASP (ASP numbers 2-32), the SRC is removed from the system control panel, the data overflows into the system ASP (ASP number 1), and normal operation resumes. For an ASP device, the operation fails if space cannot be made available.

*WAIT
When the system detects a condition where the ASP capacity is about to be exceeded, the system posts an SRC A6xx 0277 in the system control panel and will wait indefinitely for space to become available. Normal operations against this ASP will not resume until the user takes action. Some possible actions that the user could take will include changing the compression recovery policy to allow the ASP to overflow or deleting objects in the ASP.
Top

Examples

Example 1: Change All User ASPs

CHGASPA   ASP(*ALLUSR)  CPRRCYPCY(*WAIT)

This command changes the compression recovery policy for all user auxiliary storage pools to *WAIT.

Example 2: Change Specific ASPs

CHGASPA   ASP(2 5)  CPRRCYPCY(*RETRY)

This command changes the compression recovery policy for auxiliary storage pools 2 and 5 to *RETRY.

Example 3: Change Specific ASP Devices

CHGASPA   ASPDEV(MYASP1)  CPRRCYPCY(*RETRY)

This command changes the compression recovery policy for auxiliary storage pool ASP device MYASP1.

Top

Error messages

*ESCAPE Messages

CPF9829
Auxiliary storage pool &1 not found.
CPF1890
*ALLOBJ authority required for requested operation.
Top