z/OS DFSMSdfp Storage Administration
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Read-write variables

z/OS DFSMSdfp Storage Administration
SC23-6860-01

You write ACS routines to assign values to read-write variables. You can also use read-write variables as values in comparison operations. These read-write variables are case sensitive. The ACS language has four read-write variables:
  • &DATACLAS
  • &STORCLAS
  • &MGMTCLAS
  • &STORGRP

The &STORGRP read-write variable should only be used in the storage group routine. It is null on input to the routine unless VOL=REF is specified.

If the read-write variables are explicitly specified by the user, they have an initial value that might be overridden by the ACS routine. If the value is not overridden and the initial name is not defined in a currently active configuration, the allocation fails.

Requirement: You must specify a read-write variable on the PROC statement of the corresponding ACS routine. See PROC statement for details.
Each ACS routine can set only its corresponding read-write variable:
  • The data class routine can set only &DATACLAS.
  • The storage class routine can set only &STORCLAS.
  • The management class routine can set only &MGMTCLAS.
  • The storage group routine can set only &STORGRP.
The ACS routines assign values to read-write variables using the SET command, which is explained in SET statement.

In an ACS routine, you can assign an alphanumeric name enclosed in single quotation marks to the read-write variables. Also, you can assign a list of up to fifteen alphanumeric storage group names, each enclosed in single quotation marks, to the &STORGRP read-write variable. If more than one storage group name exists in the list, then each name must be enclosed in single quotation marks and separated by commas (for example, 'SG1', 'SG2').

Table 1 indicates which read-write variables you can set, which ones you can use for comparisons, and which ones are invalid, for each of the ACS routines:

Table 1. Using Read-Write Variables in ACS Routines
  Read-Write Variable
ACS Routine &STORGRP &MGMTCLAS &STORCLAS &DATACLAS
Storage group Set/Compare Compare Compare Compare
Management class Invalid Set/Compare Compare Compare
Storage class Invalid Compare Set/Compare Compare
Data class Invalid Compare Compare Set/Compare

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014