SMS ACS Routines

ACS routine variables

When the SMS Automatic Class Selection (ACS) routines are invoked for allocation of a data set on a system with SMS active, various read-only variables are available to those routines, for use in deciding what classes (if any) to assign to the data set. These variables and their values are fully described in IBM Storage Administration manuals in the chapter on “ACS Language Reference”.

The following are brief descriptions of the variables and their values when SMS is invoked by FDRDSF, FDRCOPY, or FDRABR when restoring or copying/moving a data set. Some of the values are set by FDR itself, and some (such as RACF values) are set by SMS before the ACS routine gets control.

ACS variables for all data set allocations by FDR

&ACSENVIR

Environment in which the allocation is being done:

RECALL

for any restore from Archive Backup (including auto-recall) or from Application Backup)

RECOVER

for all other data set restores

ALLOC

for FDRCOPY copy/move

CONVERT

for FDRCONVT (SMS conversion in-place).

&ANYVOL/&ALLVOL

The target volume chosen by FDR for data set allocation. For FDRCONVT, the volumes are the data set currently resides.

&APPLIC

RACF application identifier.

&DEF_DATACLAS

RACF default data class.

&DEF_MGMTCLAS

RACF default management class.

&DEF_STORCLAS

RACF default storage class.

&DSN

Data set name being allocated for converted.

&DSNTYPE

Data set type (“HFS”, “LIBRARY”, “PDSE”, “PDS”, null)

&DSORG

Data set organization (“PS”, “PO”, “VS”, “DA”, null)

&DSOWNER

RACF data set owner.

&DSTYPE

Data set type (“GDS”, “PERM”, “TEMP”, null).

&EXPDT

Expiration date (yyyyddd).

&GROUP

RACF group name.

&HLQ

High-level (first) qualifier of the data set name.

&LLQ

Low-level (last) qualifier of the data set name.

&MAXSIZE

Maximum size of data set in KB or MB.

&NQUAL

Number of qualifiers in the data set name

&NVOL

Number of volume serial numbers (always 1, except for FDRCONVT).

&RECORG

For VSAM, data set organization (“ES”, “KS”, “LS”, “RR”).

&RETPD

Retention period.

&SIZE

Primary allocation size of data set in KB or MB.

&UNIT

Unit type (for example, “3390”, “SYSALLDA”) for the FDR-selected target volume.

&USER

User id of the person running the job. Do not use this for selection criteria when the &ACSENVR is RECALL.

ACS variables ONLY available for FDRCOPY COPY/MOVE

&ACCT_JOB

Accounting information from the JOB statement.

&ACCT_STEP

Accounting information from the EXEC statement.

&JOB

JOB name, TASK name, or TSO user id.

&PGM

Job step program name (usually “FDRCOPY”).

&XMODE

Execution mode (“BATCH”, “TASK”, “TSO”).