Work with ASP Descriptions (WRKASPBRM)

The Work with ASP Descriptions (WRKASPBRM) command takes you to the Work with ASP Descriptions display or produces the ASP Descriptions report. The resulting display or report depends on the values that you specify in the Work with ASP Descriptions command. You can specify an individual auxiliary storage pool, all auxiliary storage pools or a generic auxiliary storage pool. You can further define your request by ASP class and the sequence in which you want to sort the resulting output.

Output can be a display or printed report. The report that is produced is the ASP Descriptions report. The report, if printed, is written to printer file QP1AXS.

To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.

Restriction:

Parameters

Keyword Description Choices Notes
ASP Auxiliary storage pool Generic name, name, *ALL, *NONE, *SYSTEM, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 Optional
ASPCLS ASP class Generic name, name, *ALL, *NONE Optional
SORT Sort sequence *NAME, *CLASS Optional
OUTPUT Output *, *PRINT Optional

Auxiliary storage pool (ASP)

Specifies the name of the auxiliary storage pool or special value that you want to display or report.

*ALL
All auxiliary storage pools are to be included in the display or report.
*NONE
Do not include any auxiliary storage pools in the display or report.
*SYSTEM
Only the system (1) auxiliary storage pool is to be included in the display or report.
generic*-ASP-name
Specify a generic auxiliary storage pool name. For example, specifying ASP0* would cause all auxiliary storage pools whose names begin with ASP0 to be included in the report or on the display.
ASP-name
Specify the name of an auxiliary storage pool to be included in the report or display.
ASP-number
Specify the number of the system (1) or basic user auxiliary storage pool (2-32) to be included in the report or display.

ASP class (ASPCLS)

Specifies the name of the ASP class or special value that you want to display or report.

*ALL
All ASP classes are to be included in the display or report.
*NONE
Only auxiliary storage pools that have not been assigned to an ASP class are to be included in the display or report.
generic*-ASP-class-name
Specify a generic ASP class name. For example, specifying MEDIUM* would cause all ASP classes whose names begin with MEDIUM to be included in the report or on the display.
ASP-class-name
Specify the name of a specific ASP class to be included in the report or display.

Sort sequence (SORT)

Specifies the order in which you want to to display or report the resulting information.

*NAME
The resulting display or report is sequenced in auxiliary storage pool name order. Auxiliary storage pools that have no name are listed first.
*CLASS
The resulting display or report is sequenced in ASP class hierarchy order. ASPs which have not been assigned to a class are shown last.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
*PRINT
The output is printed with the job's spooled output.

Examples

Example 1: Working with the System ASP 

WRKASPBRM ASP(1)

This command will show the Work with ASP Descriptions panel for ASP 1, which is the system ASP. From this panel you can review or change the description for the system ASP.

Error messages

*ESCAPE Messages

BRM1917
Feature not installed.
BRM1921
Feature not licensed.
BRM4040
Access denied for user &1.
BRM40A2
BRMS product initialization required.
CPF9800
All CPF98xx messages could be signaled. xx is from 01 to FF.