CHGASPA (Change ASP Attribute)

CHGASPA Command syntax diagram

 

Purpose

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: You must have *ALLOBJ special authority to use this command.

 

Required Parameters

ASP

Specifies the auxiliary storage pool (ASP) for which the ASP attributes are to be changed. A value must be specified for the ASP parameter or the ASPDEV parameter.

*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.

auxiliary-storage-pool-number: Specify the ASP for which the specific attribute is to be changed. Valid ASP numbers are 2 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 attributes are to be changed. A value must be specified for the ASP parameter or the ASPDEV parameter.

*ALLAVL: The specified attributes will be changed 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 the specific attribute is to be changed. Up to 32 ASP device names may be specified.>

 

Optional Parameters

CPRRCYPCY

Specifies what the compression recovery policy for the 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 topic in the Information Center for further detail about the compression recovery policy.

*SAME: The compression recovery policy does not change if it was previously set. Otherwise, *OVERFLOW is used.

*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.

*RETRY: When the system detects a condition where the ASP capacity is about to be exceeded, the system posts 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, the SRC is removed from the system control panel and the data overflows into the system ASP. Normal operation will then resume.

*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.

Examples for CHGASPA

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.

Error messages for CHGASPA

*ESCAPE Messages

CPF1890

*ALLOBJ authority required for requested operation.

CPF9829

Auxiliary storage pool &2 not found.