Expressions, operator commands, messages, rule records and SMF records can use symbolic fields. Symbolic fields usually start with the ampersand (&) character, the only exception being an expression.
When symbolic fields are used in the rules language, the entire symbolic name need not be entered — only enough of the name to ensure that the field is unique. For example, a symbolic name of &JOBN can be used to specify &JOBNAME.
Using symbolic fields in expressions
Since only symbolic fields can be used on the left side of an expression, the ampersand character is optional. For example, both of the following expressions compare the user's account number to the literal SY-0286-DJT.
IF &JOBACCT = SY-0286-DJT IF JOBACCT = SY-0286-DJT
IF &OWNERID NE &JOBNAME Using symbolic fields in definitions and messages
The DEFCMD, DEFMSG, DEFREC, and DEFSMF statements can use symbolic fields to build operator commands, messages, rule records, and SMF records. For example, the following message performs symbolic substitution for the current job name.
DEFMSG WRNMSG01 ** WARNING ** &JOBNAME INVALID
Substring extraction
When only part of a symbolic field is required, specify the displacement and length of the substring with the symbolic name. The displacement and length should be enclosed in parentheses and separated by a comma or blank. The parenthetical field must be concatenated with the symbolic field name and cannot be separated by blanks. For example, the following symbolic name evaluates to the first three characters of the job name.
&JOBNAME(1,3)
Symbolic Fields for VSAM
Symbolic fields related to VSAM parameters have additional capabilities. By default, symbolic names evaluate the data associated with the cluster component of a VSAM file. To force the evaluation of a particular component of the VSAM file, the symbolic name should be prefixed with “C:” for cluster, “D:” for data, or “I:” for index. For example, the following expression can be used to evaluate the name of the data component.
IF &D:DSNAME = *ACCIVP*
When no component is specified, the Monitor defaults to the cluster component. During compare processing or message build, the product will automatically attempt to access the data component fields when the cluster field is not available. No attempt to substitute the data component is made when “C:” is explicitly specified. During SET processing, the “D:” and “I:” suffixes are required to update fields associated with the data and index components of a VSAM file.
Since the Monitor has a large number of symbolic field names, the symbolic fields have been divided into several tables. These tables should help you in locating a particular sym-bolic field name.
The order of the tables listed in this section is very important. When a symbolic field is accessed, the tables are searched in sequence. The first table that contains an entry for the symbolic field will be used by the product. When the rules language attempts to modify the data associated with the symbolic field, the first table entry that can be updated will be used for the update.
Note: When a symbolic name is specified in more than one table, the product will often provide a unique name for each table. For example, the volume name in the UCB can be accessed via VOLSER or UVOLSER.
Table 15-1. Symbolic Names for Internal Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
| ACTION_REC_TEXT | CHAR(125) | ACTION MESSAGE TEXT |
| CLUSTER | CHAR(44) | VSAM CLUSTER NAME |
| DADSM_RC | NUM | DADSM IGGPOST0 RETURN CODE |
| DATASET_GROUP | CHAR(20) | DATA SET GROUP NAME |
| DATASET_SOURCE | CHAR(8) | DATA SET SOURCE |
| FIELD | CHAR(50) | DIF VARIABLE FIELD NAME |
| GDG_ENTRIES | NUM | ABC DB RECORD - NO. OF GDG TO INCLUDE DURING GENERATE |
| IGNORE | CHAR(3) | ???????????????????? |
| NEWDSN | CHAR(44) | NEW DSNAME ON DADSM RENAME REQUEST |
| NEWDSN_HLQ | CHAR(8) | HLQ FOR THE NEW DSNAME ON DADSM RENAME REQUEST |
| NEWDSN_QUALL1 | CHAR(8) | LAST QUALIFIER FOR THE NEW DSNAME ON RENAME REQUEST |
| NEWDSN_QUAL{n}1 | CHAR(8) | nTH QUALIFIER FOR THE NEW DSNAME ON RENAME REQUEST |
| POOL_FREECYL | NUM | FREE CYLINDERS AVAILABLE IN POOL |
| POOL_FREESPC | NUM | PERCENTAGE OF FREE SPACE AVAILABLE IN POOL |
| POOL_NVOL | NUM | NUMBER OF VOLUMES IN POOL |
| POOL_RESPTIME | NUM | AVERAGE RESPONSE TIME IN POOL |
| POOL_TOTALCYL | NUM | TOTAL CYLINDERS AVAILABLE IN POOL |
| PPARM | CHAR(50) | DIF VARIABLE CHARACTER FIELD |
| PPARMN | NUM | DIF VARIABLE NUMERIC FIELD |
| REQUEST_SIZE-K | NUM | DATA SET REQUESTED SPACE IN KILOBYTES |
| REQUEST_SIZE-M | NUM | DATA SET REQUESTED SPACE IN MEGABYTES |
| REQUEST_SIZE-T | NUM | DATA SET REQUESTED SPACE IN TRACKS |
| SEL_DSNAME | CHAR(44) | ABC DB RECORD - DATA SET NAME |
| FIELD VALUE | CHAR(50) | VALUE OF DIF VARIABLE CHARACTER FIELD |
| VALUEN | NUM | VALUE OF DIF VARIABLE NUMERIC FIELD |
| VOLUME_GROUP | CHAR(20) | VOLUME GROUP NAME |
|
Note:
1 This field is read only. SET processing will
not allow the field to be modified.
|
||
Table 15-2. Symbolic Names for EVR Records
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
| AGGREGATE | CHAR(30) | ABARS AGGREGATE NAME |
| CLASS | CHAR(1) | JOB CLASS |
| CRDATE | CHAR(8) | CREATE DATE (YYYY.DDD) |
| CRTIME | CHAR(8) | CREATE TIME (HH.MM.SS) |
| DATACLAS | CHAR(8) | SMS DATA CLASS |
| DDNAME | CHAR(8) | DDNAME |
| DSNAME | CHAR(44) | DATA SET NAME |
| DSTYPE | CHAR(1) | DATA SET TYPE (???????????) |
| EVR_AGGREGATE | CHAR(30) | ABARS AGGREGATE NAME |
| EVR_CLASS | CHAR(1) | JOB CLASS |
| EVR_CRDATE | CHAR(8) | CREATE DATE (YYYY.DDD) |
| EVR_CRTIME | CHAR(8) | CREATE TIME (HH.MM.SS) |
| EVR_DATACLAS | CHAR(8) | SMS DATA CLASS |
| EVR_DDNAME | CHAR(8) | DDNAME |
| EVR_DSNAME | CHAR(44) | DATA SET NAME |
| EVR_DSTYPE | CHAR(1) | DATA SET TYPE (???????????) |
| EVR_EXT_SOURCE | CHAR(8) | SOURCE OF EVR RECORD (VTOC/SMF/ABCAGG) |
| EVR_GDGBASE | CHAR(44) | GDG BASE DATA SET NAME |
| EVR_HLQ | CHAR(8) | HIGH-LEVEL-QUALIFIER OF DATA SET NAME |
| EVR_JACCT | CHAR(142) | JOB ACCOUNT FIELD |
| EVR_JACCT{n} | CHAR(142) | JOB nth ACCOUNT FIELD |
| EVR_JES3_CLASS | CHAR(8) | JES3 JOB CLASS |
| EVR_JOBNAME | CHAR(8) | JOBNAME THAT UPDATED THE ABC DB ENTRY |
| EVR_MGMTCLAS | CHAR(8) | SMS MANAGEMENT CLASS |
| EVR_PGM | CHAR(8) | PROGRAM NAME THAT UPDATED THE ABC DB ENTRY |
| EVR_PGMRNAME | CHAR(20) | PROGRAMMER NAME FIELD (COMMENT) |
| EVR_PROC_DADSMCRE | CHAR(3) | ABC DB ENTRY - DADSM CREATE WAS PERFORMED (YES/NO) |
| EVR_PROC_DADSMDEL | CHAR(3) | ABC DB ENTRY - RECORD IS LOGICALLY DELETED (YES/NO) |
| EVR_PROC_DADSMEXT | CHAR(3) | ABC DB ENTRY - DATA SET WAS EXTENDED (YES/NO) |
| EVR_PROC_DADSMREL | CHAR(3) | ABC DB ENTRY - DATA SET RLSE REQUESTED (YES/NO) |
| EVR_PROC_DADSMREN | CHAR(3) | ABC DB ENTRY - DATA SET RENAME REQUESTED (YES/NO) |
| EVR_PROC_OPENIN | CHAR(3) | ABC DB ENTRY - DATA SET WAS OPENED INPUT (YES/NO) |
| EVR_PROC_OPENOUT | CHAR(3) | ABC DB ENTRY - DATA SET WAS OPENED OUTPUT (YES/NO) |
| EVR_PROD1 | ||
| EVR_PROD2 | ||
| EVR_PROD3 | ||
| EVR_PROD4 | ||
| EVR_PSTEPNAM | CHAR(8) | PROCEDURE STEP NAME |
| EVR_QUALL1 | CHAR(8) | THE LAST QUALIFIER OF THE DATA SET NAME |
| EVR_QUAL{n}1 | CHAR(8) | THE nTH QUALIFIER OF THE DATA SET NAME |
| EVR_RGROUP | CHAR(8) | RACF GROUP |
| EVR_RUSER | CHAR(8) | RACF USER |
| EVR_SEL_TYPE | CHAR(30) | ABARS SELECT TYPE (INCLUDE/EXCLUDE/...) |
| EVR_SIZE-K | NUM | DATA SET SIZE IN KILOBYTES |
| EVR_STEPNAME | CHAR(8) | STEPNAME THAT UPDATED THE ABC DB ENTRY |
| EVR_STORCLAS | CHAR(8) | SMS STORAGE CLASS |
| EVR_STORGRP | CHAR(30) | SMS STORAGE GROUP |
| EVR_SYSID | CHAR(4) | CURRENT SMF SYSTEM IDENTIFIER |
| EVR_UNITDEV | CHAR(4) | UNIT DEVICE TYPE (3380) |
| EVR_UNITTYPE | CHAR(7) | UNIT DEVICE TYPE (DASD/TAPE/COMMUN/SYSOUT/SYSIN/DUMMY/VIO/DISPLAY/UNITREC) |
| EVR_USERC{n} | CHAR(100) | nTH (1-2) CHARACTER USER FIELDS |
| EVR_USERN{n} | NUM | nTH (1-5) NUMERIC USER FIELDS |
| EVR_VOLSER | CHAR(6) | VOLSER |
| EXT_SOURCE | CHAR(8) | SOURCE OF EVR RECORD (VTOC/SMF/ABCAGG) |
Note: 1 This field is read only. SET processing
will not allow the field to be modified.
|
||
Table 15-2. Symbolic Names for EVR Records (Continued)
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
GDGBASE |
CHAR(44) |
GDG base data set name |
HLQ1 |
CHAR(8) |
High-level-qualifier of data set name |
JACCT |
CHAR(142) |
Job account field |
JACCT{n}1 |
CHAR(142) |
Job nth account field |
JES3_CLASS |
CHAR(8) |
JES3 job class |
JOBNAME |
CHAR(8) |
Jobname that updated the ABC DB entry |
MGMTCLAS |
CHAR(8) |
SMS management class |
PGM |
CHAR(8) |
Program name that updated the ABC DB entry |
PGMRNAME |
CHAR(20) |
Programmer name field (COMMENT) |
PROC_DADSMCRE |
CHAR(3) |
ABC DB entry - DADSM create was performed (YES/NO) |
PROC_DADSMDEL |
CHAR(3) |
ABC DB entry - record is logically deleted (YES/NO) |
PROC_DADSMEXT |
CHAR(3) |
ABC DB entry - data set was extended (YES/NO) |
PROC_DADSMREL |
CHAR(3) |
ABC DB entry - data set RLSE requested (YES/NO) |
PROC_DADSMREN |
CHAR(3) |
ABC DB entry - data set rename requested (YES/NO) |
PROC_OPENIN |
CHAR(3) |
ABC DB entry - data set was opened input (YES/NO) |
PROC_OPENOUT |
CHAR(3) |
ABC DB entry - data set was opened output (YES/NO) |
PSTEPNAM |
CHAR(8) |
Procedure step name |
QUALL1 |
CHAR(8) |
The last qualifier of the data set name |
QUAL{n}1 |
CHAR(8) |
The nTH qualifier of the data set name |
RGROUP |
CHAR(8) |
RACF group |
RUSER |
CHAR(8) |
RACF user |
SEL_TYPE |
CHAR(30) |
ABARS selection type (INCLUDE/EXCLUDE/...) |
SIZE-K |
NUM |
Data set size in kilobytes |
STEPNAME |
CHAR(8) |
Stepname that updated the ABC DB entry |
STORCLAS |
CHAR(8) |
SMS storage class |
STORGRP |
CHAR(30) |
SMS storage group |
SYSID |
CHAR(4) |
Current SMF system identifier |
UNITDEV |
CHAR(4) |
Unit device type (3380) |
UNITTYPE |
CHAR(7) |
Unit device type (DASD/TAPE/COMMUN/SYSOUT/SYSIN/DUMMY/VIO/DISPLAY/UNITREC) |
VOLSER |
CHAR(6) |
VOLSER |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-3. Symbolic Names for EVR Control Records
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
DD |
— |
DD statement reference |
DSNAME |
— |
Data set name |
EVC_DD |
— |
Event control DD name |
EVC_DSNAME |
— |
Event control data set name |
EVC_MEMBER |
— |
Event control member name |
EVC_T_ALLOC |
— |
Event control time of allocation |
EVC_T_CLOSE |
— |
Event control time of close |
EVC_T_EJECT |
— |
Event control time of eject |
EVC_T_FREE |
— |
Event control time of free |
EVC_UNIT |
— |
Event control unit |
EVC_USER |
— |
Event control user ID |
EVC_VOL |
— |
Event control volume serial |
MEMBER |
— |
Member name |
T_ALLOC |
— |
Time of allocation |
T_CLOSE |
— |
Time of close |
T_EJECT |
— |
Time of eject |
T_FREE |
— |
Time of free |
UNIT |
— |
Unit name |
USER |
— |
User ID |
VOL |
— |
Volume serial |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-4. Symbolic Names for Database ADR Records
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
AGGREGATE |
— |
Aggregate symbolic field |
PROC_DADSMCRE |
— |
DADSM create processing procedure |
PROC_DADSMDEL |
— |
DADSM delete processing procedure |
PROC_DADSMEXT |
— |
DADSM extend processing procedure |
PROC_DADSMREL |
— |
DADSM release processing procedure |
PROC_DADSMREN |
— |
DADSM rename processing procedure |
PROC_OPENIN |
— |
Open input processing procedure |
PROC_OPENOUT |
— |
Open output processing procedure |
PROCF1 |
— |
Processing function 1 |
PROCF2 |
— |
Processing function 2 |
PROCF3 |
— |
Processing function 3 |
PROCF4 |
— |
Processing function 4 |
SEL_TYPE |
— |
Selection type |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-5. Symbolic Names for Device Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
AUTO_LOAD1 |
CHAR(3) |
Tape device support auto-loader (YES/NO) |
AUTO_LOAD_ACT1 |
CHAR(3) |
Tape device has tapes in auto-loader (YES/NO) |
CACHE1 |
CHAR(3) |
Device support cache (YES/NO) |
DUALCOPY1 |
CHAR(3) |
Device support DUALCOPY (YES/NO) |
EXT_CYL1 |
NUM |
Largest free extent in cylinders |
EXT_TRK1 |
NUM |
Largest free extent in tracks (not belonging to CYL) |
FASTWRT1 |
CHAR(3) |
Device support fast write (YES/NO) |
FRAG_INDEX1 |
NUM |
Fragmentation index — see LSPACE SVC |
FREE_CYL1 |
NUM |
Free CYL available on volume |
FREE_DSCB1 |
NUM |
Free DSCBs in the VTOC |
FREE_EXT1 |
NUM |
Number of free extents available on volume |
FREE_SPACE1 |
NUM |
Percentage freespace available on volume |
FREE_TRK1 |
NUM |
Free tracks available on volume |
INDEX_VTOC1 |
CHAR(3) |
Indexed VTOC (YES/NO) |
JES31 |
CHAR(3) |
JES3 controlled device (YES/NO) |
MNTYPE1 |
CHAR(7) |
Mount type (PRIVATE/PUBLIC/STORAGE) |
RESPTIME1 |
NUM |
Response time for DASD devices (milliseconds × 100) |
SMS1 |
CHAR(3) |
SMS controlled (YES/NO) |
STORGRP1 |
CHAR(8) |
Owning SMS storage group |
TOTAL_CYL1 |
NUM |
Total cylinders available on volume |
UNITADDC1 |
CHAR(3) |
Unit address (character) |
UNITADDR1 |
NUM |
Unit address (numeric) |
UNITDEV1 |
CHAR(4) |
Unit device type (e.g., 3380) |
UNITTYPE1 |
CHAR(7) |
Unit device type (DASD/TAPE/COMMUN/SYSOUT/SYSIN/DUMMY/VIO/DISPLAY/UNITREC) |
UJES31 |
CHAR(3) |
JES3 controlled device (YES/NO) |
USHARED1 |
CHAR(3) |
Device is gen’d as shared (YES/NO) |
USTORGRP1 |
CHAR(8) |
Owning SMS storage group |
UONLINE1 |
CHAR(3) |
Device is currently online (YES/NO) |
UALLOC1 |
CHAR(3) |
Device is currently allocated (YES/NO) |
UCHANGE1 |
CHAR(3) |
Device is currently changing status (YES/NO) |
USMS1 |
CHAR(3) |
SMS controlled volume (YES/NO) |
UVOLSER1 |
CHAR(6) |
VOLSER from UCB |
VOLSER1 |
CHAR(6) |
Name of volume |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-6. Symbolic Names for DD Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
ACCODE1 |
CHAR(8) |
ACCODE on DD statement |
ALX |
CHAR(3) |
ALX on DD SPACE (YES/NO) |
AVGBLEN |
NUM |
Average data block length on DD SPACE |
AVGREC |
CHAR(1) |
AVGREC operand (U/K/M) |
BFALN |
CHAR(1) |
BFALN on DD DCB (D/F) |
BFTEK |
CHAR(1) |
BFTEK on DD DCB (S/A/R/E/D) |
BLKSIZE |
NUM |
BLKSIZE on DD DCB |
BUFIN |
NUM |
BUFIN on DD DCB |
BUFL |
NUM |
BUFL on DD DCB |
BUFMAX |
NUM |
BUFMAX on DD DCB |
BUFND |
NUM |
BUFND on DD AMP |
BUFNI |
NUM |
BUFNI on DD AMP |
BUFNO |
NUM |
BUFNO on DD DCB |
BUFOFF |
CHAR(1) |
BUFOFF on DD DCB (L) |
BUFOUT |
NUM |
BUFOUT on DD DCB |
BUFSIZE |
NUM |
BUFSIZE on DD DCB |
BUFSP |
NUM |
BUFSP on DD AMP |
BURST |
CHAR(3) |
BURST output (YES/NO) |
CATLOC1 |
CHAR(3) |
Device type obtained from CATLG (YES/NO) |
CATALOG |
CHAR(3) |
Data set is a catalog (YES/NO) |
CHARSn |
CHAR(4) |
n(1-4)TH field on CHARS |
CHKPTEOV |
CHAR(3) |
CHKPT=EOV specified (YES/NO) |
CONCAT1 |
CHAR(3) |
Data set in concatenation (YES/NO) |
CONTIG |
CHAR(3) |
CONTIG specified on SPACE (YES/NO) |
COPIES |
NUM |
Number of SYSOUT copies to print |
COPIES{n} |
NUM |
Copies for nTH group |
CPRI |
CHAR(1) |
(DCB=CPRI) - TCAM transmission priority (R/E/S) |
CROPS |
CHAR(3) |
CROPS on DD AMP (RCK, NCK, NRE, NRC) |
CYLOFL |
NUM |
CYLOFL on DD DCB |
DATACLAS |
CHAR(8) |
SMS data class |
DDJES31 |
CHAR(3) |
JES3 controlled DD (YES/NO) |
DDNAME |
CHAR(8) |
DDNAME for allocation |
DDSMS1 |
CHAR(3) |
SMS controlled DD (YES/NO) |
DDTYPE1 |
CHAR(7) |
Type of DD statement (DASD/TAPE, COMMUN/SYSOUT/SYSIN/DUMMY/VIO/DISPLAY/UNITREC) |
|
|
Defer volume mount (YES/NO) |
|
|
Tape recording density (1/2/3/4) |
|
|
DEST node on DD |
|
|
DEST ID on DD |
|
|
DIAGNS on DD DCB (YES/NO) |
|
|
Directory space requested |
|
|
Disposition status (NEW/SHR/OLD/MOD) VOS3(RNW) |
|
|
Normal DISP (PASS/KEEP/DELETE/CATLG/UNCATLG) |
|
|
Abnormal DISP (KEEP/DELETE/CATLG/UNCATLG) |
|
|
Data set name |
|
|
Data set type (LIBRARY/PDS/PIPE/HFS) |
|
|
Data set organization - PS, PO, DA, VS, IS, PSU, etc. |
|
|
Directory space requested |
|
|
DD statement is DUMMY (YES/NO) |
|
|
First volume in DD statement |
|
|
Dynamic allocation (YES/NO) |
|
|
EROPT on DD DCB (ACC, SKP, ABE, T) |
|
|
Expiration date (YYYY.DDD) |
|
|
FCB name on DD |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-6. Symbolic Names for DD Fields (Continued)
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
FCBALIGN |
CHAR(3) |
ALIGN specified on DD FCB (YES/NO) |
FCBVER |
CHAR(3) |
VERIFY specified on DD FCB (YES/NO) |
FILESEQ |
NUM |
File sequence number (TAPE) |
FLASH |
CHAR(4) |
FLASH name on DD |
FLASHCT |
NUM |
Count on DD FLASH |
FORM |
CHAR(4) |
SYSOUT form name |
FREE |
CHAR(5) |
When to free data set (CLOSE/END) |
FUNC |
CHAR(5) |
FUNC on DD DCB |
GDG |
CHAR(3) |
Data set a GDG (YES/NO) |
GDGALL |
CHAR(3) |
DD is part of GDG ALL request (YES/NO) |
GNCP |
NUM |
GNCP on DD DCB |
HLQ1 |
CHAR(8) |
High-level-qualifier of data set name |
HOLD |
CHAR(3) |
HOLD on DD (YES/NO) |
IN |
CHAR(3) |
IN on DD LABEL (YES/NO) |
INTVL |
NUM |
INTVL on DD DCB |
IPLTXID |
CHAR(7) |
IPLTXID on DD DCB |
JES31 |
CHAR(3) |
JES3 controlled device (YES/NO) |
JOBLIB1 |
CHAR(3) |
JOBLIB DD statement (YES/NO) |
KEYLEN |
NUM |
Key length |
KEYOFF1 |
NUM |
KEYOFF on DD |
LABEL |
CHAR(3) |
LABEL on DD |
LIKE1 |
CHAR(44) |
LIKE on DD |
LIMCT |
NUM |
LIMCT on DD DCB |
LRECL |
NUM |
Logical record length |
MEMBER |
CHAR(8) |
Member name on PDS |
MGMTCLAS |
CHAR(8) |
SMS management class |
FCBALIGN |
CHAR(3) |
ALIGN specified on DD FCB (YES/NO) |
FCBVER |
CHAR(3) |
VERIFY specified on DD FCB (YES/NO) |
FILESEQ |
NUM |
File sequence number (TAPE) |
FLASH |
CHAR(4) |
FLASH name on DD |
FLASHCT |
NUM |
Count on DD FLASH |
FORM |
CHAR(4) |
SYSOUT form name |
FREE |
CHAR(5) |
When to free data set (CLOSE/END) |
FUNC |
CHAR(5) |
FUNC on DD DCB |
GDG |
CHAR(3) |
Data set is a GDG (YES/NO) |
GDGALL |
CHAR(3) |
DD is part of GDG ALL request (YES/NO) |
GNCP |
NUM |
GNCP on DD DCB |
HLQ1 |
CHAR(8) |
High-level-qualifier of data set name |
HOLD |
CHAR(3) |
HOLD on DD (YES/NO) |
IN |
CHAR(3) |
IN on DD LABEL (YES/NO) |
INTVL |
NUM |
INTVL on DD DCB |
IPLTXID |
CHAR(7) |
IPLTXID on DD DCB |
JES31 |
CHAR(3) |
JES3 controlled device (YES/NO) |
JOBLIB1 |
CHAR(3) |
JOBLIB DD statement (YES/NO) |
KEYLEN |
NUM |
Key length |
KEYOFF1 |
NUM |
KEYOFF on DD |
LABEL |
CHAR(3) |
LABEL on DD |
LIKE1 |
CHAR(44) |
LIKE on DD |
LIMCT |
NUM |
LIMCT on DD DCB |
LRECL |
NUM |
Logical record length |
MEMBER |
CHAR(8) |
Member name on PDS |
MGMTCLAS |
CHAR(8) |
SMS management class |
|
|
MODE on DD DCB (CO/CR/EO/ER/C/E) |
|
|
MODIFY on DD or OUTPUT |
|
|
TRC field on DD MODIFY |
|
|
MSVGP on DD |
|
|
MXIG on DD SPACE (YES/NO) |
|
|
NCP on DD DCB |
|
|
NOPWREAD on DD LABEL (YES/NO) |
|
|
NTM on DD DCB |
|
|
Number of volumes |
|
|
OPTION CODE (DCB=OPTCD) - Chained scheduling (YES/NO) |
|
|
OPTION CODE (DCB=OPTCD) - Allow data check (YES/NO) |
|
|
OPTION CODE (DCB=OPTCD) - Write validity check (YES/NO) |
|
|
OPTION CODE (DCB=OPTCD) - Use reduced error recovery (YES/NO) |
|
|
OUT on DD LABEL (YES/NO) |
|
|
OUTLIM on DD |
|
|
OUTPUT on DD |
|
|
P on DD UNIT (YES/NO) |
|
|
PASSWORD on DD LABEL (YES/NO) |
|
|
PCI on DD DCB (N/R/A/X) |
|
|
PCI on DD DCB (N/R/A/X) |
|
|
Permanent data set (YES/NO) |
|
|
Permanent data set (YES/NO) |
|
|
Private volume request (YES/NO) |
|
|
PROTECT on DD (YES/NO) |
|
|
PRTSP on DD DCB (0/1/2/3) |
|
|
Primary quantity on SPACE request |
|
|
QNAME on DD |
|
|
The last qualifier of the data set name |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-6. Symbolic Names for DD Fields (Continued)
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
QUAL{n}1 |
CHAR(8) |
The nTH qualifier of the data set name |
RECFM |
CHAR(8) |
The record format of the data set |
RECORG |
CHAR(2) |
RECORG on DD |
REFDD |
CHAR(28) |
REFDD on DD |
RESERVE1 |
NUM |
RESERVE on DD DCB |
RESERVE2 |
NUM |
RESERVE on DD DCB |
RETAIN |
CHAR(3) |
RETAIN on DD volume (YES/NO) |
RETPD |
NUM |
Retention period of data set |
RKP |
NUM |
Relative key position |
RLSE |
CHAR(3) |
Release flag (YES/NO) |
RNWACTIVE |
CHAR(3) |
DISP=RNW specified for existing DSN (YES/NO) - VOS3 only |
ROUND |
CHAR(3) |
ROUND flag (YES/NO) |
SECMODEL1 |
CHAR(44) |
SECMODEL on DD |
SEGMENT |
NUM |
SEGMENT on DD |
SMS1 |
CHAR(3) |
SMS controlled (YES/NO) |
SOWA |
NUM |
Length of QTAM workarea |
SPACE |
CHAR(5) |
Type of space request (ABSTR/AVR/CYL/TRK) |
SPACEAVR |
NUM |
Number of blocks in DD space |
SPIN |
CHAR(7) |
SPIN on DD (UNALLOC/NO) |
SSPACE |
NUM |
Secondary quantity on SPACE |
STACK |
CHAR(1) |
STACK on DD DCB (1/2) |
STEPCAT |
CHAR(3) |
STEPCAT DD stmt (YES/NO) |
STORCLAS |
CHAR(8) |
SMS storage class |
STRNO |
NUM |
STRNO on DD |
SUBSYS |
CHAR(4) |
SUBSYS on DD |
SYSIN1 |
CHAR(3) |
SYSIN DD statement (YES/NO) |
SYSOUT |
CHAR(1) |
SYSOUT DD statement |
SYSOUTN |
CHAR(8) |
SYSOUT writer name |
TAPE_LIBRARY |
CHAR(3) |
DD allocated to IBM tape silo (YES/NO) |
TAPE_TO_DISK |
CHAR(3) |
Tape redirected to SMS DASD (YES/NO) |
TEMP1 |
CHAR(3) |
Temporary data set (YES/NO) |
TEMPDSN1 |
CHAR(3) |
Temporary data set (YES/NO) |
TERMINAL |
CHAR(3) |
TERM=TS (YES/NO) |
THRESH |
NUM |
THRESH on DD DCB |
TRTCH |
CHAR(6) |
DCB TRTCH (T/E/C/ET/TC/COMP/NOCOMP) |
UCS |
CHAR(4) |
Printer UCS image name |
UCSFOLD |
CHAR(3) |
Printer UCS image in fold mode (YES/NO) |
UCSVER |
CHAR(3) |
Printer UCS image to be verified (YES/NO) |
UNITAFF |
CHAR(3) |
Unit affinity (YES/NO) |
UNITCNT |
NUM |
Unit count |
UNITNAME |
CHAR(8) |
Unit name |
VIO |
CHAR(3) |
VIO data set (YES/NO) |
VOLAFF |
CHAR(3) |
DD volume affinity (YES/NO) |
VOLCOUNT |
NUM |
DD volume count |
VOLREF |
CHAR(6) |
DD VOL referback (DSNAME/DDNAME/NONE) |
VOLSEQ |
NUM |
Volume sequence number |
VOLSER |
CHAR(6) |
Name of volume |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-7. Symbolic Names for EXEC Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
ACCT1 |
CHAR(142) |
Account fields on JOB or EXEC |
ACCT{n}1 |
CHAR(142) |
nTH account field on JOB or EXEC |
ADDRSPC1 |
CHAR(4) |
ADDRSPC on JOB or EXEC (REAL/VIRT) |
COND1 |
CHAR(4) |
COND field (EVEN/ONLY) |
DPRTY |
NUM |
EXEC dispatching priority |
PARM |
CHAR(100) |
PARM field on EXEC |
PERFORM |
NUM |
PERFORM on EXEC or JOB |
PGM |
CHAR(8) |
Program name on EXEC |
PSTEPNAM |
CHAR(8) |
Procedure step name |
RD1 |
CHAR(3) |
Automatic step restart (NC/NR/RNC/R) |
REGION1 |
NUM |
Region size |
SACCT1 |
CHAR(142) |
Step account field |
SACCT{n}1 |
CHAR(142) |
Step nTH account field |
SADDRSPC1 |
CHAR(4) |
ADDRSPC on EXEC (REAL/VIRT) |
SCOND1 |
CHAR(4) |
Step COND field (EVEN/ONLY) |
SRD1 |
CHAR(3) |
EXEC automatic step restart (NC,NR,RNC,R) |
SREGION1 |
NUM |
EXEC region field |
STEPNAME |
CHAR(8) |
Current step name |
STIME |
NUM |
Time on EXEC |
TIME1 |
NUM |
Time on JOB or EXEC |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-8. Symbolic Names for JOB Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
ACCT1 |
CHAR(142) |
Account fields on JOB or EXEC |
ACCT{n}1 |
CHAR(142) |
nTH account field on JOB or EXEC |
ADDRSPC1 |
CHAR(4) |
ADDRSPC on JOB or EXEC (REAL/VIRT) |
CLASS1 |
CHAR(1) |
Job class |
COMMENT1 |
CHAR(20) |
Programmer name field (COMMENT) |
GROUP1 |
CHAR(8) |
RACF group |
JACCT1 |
CHAR(142) |
Job account field |
JACCT{n}1 |
CHAR(142) |
Job nTH account field |
JADDRSPC1 |
CHAR(4) |
ADDRSPC on JOB (REAL/VIRT) |
JGROUP1 |
CHAR(8) |
Group field |
JOBNAME1 |
CHAR(8) |
Current JOBNAME, STCNAME, or TSO user |
JOBSDATE1 |
CHAR(8) |
Job start date (MM/DD/YY) |
JOBSDAY1 |
CHAR(10) |
Job start day |
JOBSJDAT1 |
CHAR(8) |
Job start Julian date |
JOBSLDATE1 |
CHAR(10) |
Job start date (MM/DD/YYYY) |
JOBSTIME1 |
CHAR(8) |
Job start time |
JOBTYPE1 |
CHAR(3) |
Current job type (JOB/TSU/STC) |
JRD1 |
CHAR(3) |
Automatic step restart (NC, NR, RNC, R) |
JREGION1 |
NUM |
Region size |
JTIME1 |
NUM |
Time field |
JUSER1 |
CHAR(7) |
User field |
MSGCLASS1 |
CHAR(1) |
MSGCLASS |
MSGL11 |
CHAR(1) |
MSGLEVEL1 field (0/1/2) |
MSGL21 |
CHAR(1) |
MSGLEVEL2 field (0/1) |
PERFORM1 |
NUM |
Performance group |
PGMRNAME1 |
CHAR(20) |
Programmer name field |
PRTY1 |
NUM |
PRTY on JOB statement |
RD1 |
CHAR(3) |
Automatic step restart (NC/NR/RNC/R) |
REGION1 |
NUM |
Region size |
ROOM1 |
CHAR(142) |
Room field |
TIME1 |
NUM |
Time on JOB or EXEC |
USER1 |
CHAR(8) |
RACF user |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-9. Symbolic Names for RACF Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
|
|
RACF installation data field |
|
|
RACF group |
|
|
DEVTYPE of dataset |
|
|
Data application at group level in RACF database |
|
|
Dataclass at group level of RACF group |
|
|
RACF installation data at group level |
|
|
MGMTCLAS of RACF group at group level |
|
|
Storage class of RACF group at group level |
|
|
RACF group name |
|
|
Installation data |
|
|
RACF level |
|
|
Notify information in RACF database |
|
|
Owner from RACF database |
|
|
Resource owner from RACF database |
|
|
Data application at user level in RACF database |
|
|
Dataclass at user level of RACF group |
|
|
Dataclass at group level of RACF group |
|
|
RACF installation data at user level |
|
|
MGMTCLAS of RACF group at user level |
|
|
RACF PGMRNAME |
|
|
Storage class of RACF group at user level |
|
|
RACF version number |
|
|
Automatic data set protection (YES/NO) |
|
|
User has audit auth (YES/NO) |
|
|
RACF group |
|
|
User has OPER auth (YES/NO) |
|
|
User has SPECIAL auth (YES/NO) |
|
|
RACF user |
|
|
RACF user |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-10. Symbolic Names for Miscellaneous Fields
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
AVGREC |
CHAR(1) |
AVGREC operand (U/K/M) |
CAT_DATACLAS1 |
CHAR(8) |
SMS data class from catalog |
CAT_MGMTCLAS1 |
CHAR(8) |
SMS management class from catalog |
CAT_STORCLAS1 |
CHAR(8) |
SMS storage class from catalog |
DATASET_CATVOL1 |
CHAR(6) |
1st catalog volume for data set. *** WARNING *** SHOULD NOT BE USED FOR RULES PROCESSED DURING ALLOCATION |
CDENAME1 |
CHAR(8) |
Current executing program name |
CURDATE1 |
CHAR(8) |
Current date (MM/DD/YY) |
CURDAY1 |
CHAR(10) |
Current day of the week |
CURJDAT1 |
CHAR(8) |
Current Julian date (YYYY.DDD) |
CURLDATE1 |
CHAR(10) |
Current date (MM/DD/YYYY) |
CURTIME1 |
CHAR(8) |
Current time (HH:MM:SS) |
DATACLAS1 |
CHAR(8) |
SMS data class |
JOBNUM1 |
NUM |
Current job number |
JOBTYPE1 |
CHAR(3) |
Current job type (JOB/TSU/STC) |
MGMTCLAS1 |
CHAR(8) |
SMS management class |
SIZE1 |
NUM |
Primary size in megabytes |
SIZE-K1 |
NUM |
Primary size in kilobytes |
SIZE-K-ALL1 |
NUM |
Total size in kilobytes |
SIZE-M1 |
NUM |
Primary size in megabytes |
SIZE-M-ALL1 |
NUM |
Total size in megabytes |
SIZE-T1 |
NUM |
Primary size in tracks |
SIZE-T-ALL1 |
NUM |
Total size in tracks |
SIZE-V1 |
CHAR(16) |
Symbolic used for size – defaults to “PSPACE” |
SMS1 |
CHAR(3) |
SMS controlled (YES/NO) |
STORCLAS1 |
CHAR(8) |
SMS storage class |
SYSID1 |
CHAR(4) |
Current SMF system identifier |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-11. Symbolic Names for Modifying Rules Statements
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
ENV_LOG |
CHAR(8) |
DEFENV LOG(ddname) |
ENV_LOGLEVEL |
CHAR(1) |
DEFENV LOG(LEVEL(I/W/A/E/C)) |
ENV_MODE |
CHAR(8) |
DEFENV MODE(WARN/ACTIVE/INACTIVE) |
ENV_MSGLEVEL |
CHAR(1) |
DEFENV MSG(LEVEL(I/W/A/E/C)) |
ENV_NOPOOL |
CHAR(3) |
DEFENV NOPOOL (YES/NO) |
ENV_RULESET |
CHAR(6) |
DEFENV RULESET(ALWAYS/ONETIME/NEVER) |
ENV_SMFRID |
NUM |
DEFENV SMF(value) |
ENV_SMFLEVEL |
CHAR(1) |
DEFENV SMF(LEVEL(I/W/A/E/C)) |
ENV_UIDLEVEL |
CHAR(1) |
DEFENV USERID(LEVEL(I/W/A/E/C)) |
ENV_USERID |
CHAR(8) |
DEFENV USERID(userid) |
MSG_CN |
NUM |
DEFMSG CN(num) |
MSG_ILOG |
CHAR(3) |
INHIBIT WRITE TO LOG (YES/NO) |
MSG_INTERNAL |
CHAR(3) |
INTERNAL PRODUCT MESSAGE (YES/NO) |
MSG_IPRINT |
CHAR(3) |
INHIBIT MSG WRITE (YES/NO) |
MSG_ISMF |
CHAR(3) |
INHIBIT WRITE TO SMF (YES/NO) |
MSG_IUSERID |
CHAR(3) |
INHIBIT WRITE TO USERID (YES/NO) |
MSG_IWTO |
CHAR(3) |
INHIBIT WTO (YES/NO) |
MSG_LEVEL |
NUM |
NUMERIC VALUE = DEFMSG LEVEL(I/W/A/E/C) |
MSG_LOG |
CHAR(8) |
DEFMSG LOG(ddname) |
MSG_LOGLEVEL |
NUM |
NUMERIC VALUE = DEFMSG LOG(LEVEL(I/W/A/E/C)) |
MSG_MSGLEVEL |
NUM |
NUMERIC VALUE = DEFMSG MSG(LEVEL(I/W/A/E/C)) |
MSG_OLOG |
CHAR(3) |
ONLY WRITE TO LOG (YES/NO) |
MSG_OPRINT |
CHAR(3) |
ONLY MSG WRITE (YES/NO) |
MSG_OSMF |
CHAR(3) |
ONLY WRITE TO SMF (YES/NO) |
MSG_OUSERID |
CHAR(3) |
ONLY WRITE TO USERID (YES/NO) |
MSG_SKIP |
CHAR(3) |
SKIP CURRENT MESSAGE (YES/NO) |
MSG_SMFRID |
NUM |
DEFMSG SMF(value) |
MSG_SMFLEVEL |
NUM |
NUMERIC VALUE = DEFMSG SMF(LEVEL(I/W/A/E/C)) |
MSG_TEXT |
CHAR(125) |
DEFMSG ‘text’ |
MSG_UIDLEVEL |
NUM |
NUMERIC VALUE = DEFMSG USERID(LEVEL(I/W/A/E/C)) |
MSG_USERID |
CHAR(8) |
DEFMSG USERID(userid) |
|
|
DEFPROD MSG(CLASS) (YES/NO) |
|
|
DEFPROD DDNAME(IGNORE(ddname)) |
|
|
DEFPROD DDNAME(LOG(ddname)) |
|
|
DEFPROD DDNAME(MSG(ddname)) |
|
|
DEFPROD DDNAME(TRACE(ddname)) |
|
|
DEFPROD DDNAME(TEST(ddname)) |
|
|
DEFPROD MSG(GENID) (YES/NO) |
|
|
DEFPROD LOG(ddname) |
|
|
DEFPROD LOG(LEVEL(I/W/A/E/C)) |
|
|
DEFPROD MSG(LEVEL(I/W/A/E/C)) |
|
|
DEFPROD MSG(MSGID) (YES/NO) |
|
|
DEFPROD SMF(value) |
|
|
DEFPROD SMF(LEVEL(I/W/A/E/C)) |
|
|
DEFPROD MSG(SYSLOG) (YES/NO) |
|
|
DEFPROD USERID(LEVEL(I/W/A/E/C)) |
|
|
DEFPROD USERID(userid) |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||
Table 15-11. Symbolic Names for Modifying Rules Statements
| SYMBOLIC NAME | TYPE | DESCRIPTION |
|---|---|---|
|
|
DEFPOOL LOG(ddname) |
|
|
DEFPOOL LOG(LEVEL(I/W/A/E/C)) |
|
|
DEFPOOL MODE(WARN/ACTIVE/INACTIVE) |
|
|
DEFPOOL MSG(LEVEL(I/W/A/E/C)) |
|
|
DEFPOOL name |
|
|
DEFPOOL ADDVOL(TAPE(NEWUNIT)) (YES/NO) |
|
|
DEFPOOL NOPOOL (YES/NO) |
|
|
DEFPOOL RECAT(option) (YES/NO) |
|
|
DEFPOOL REDUCEP(LIMIT(percent)) |
|
|
DEFPOOL REDUCEP(PERCENT(percent)) |
|
|
DEFPOOL REDUCES(option) (YES/NO) |
|
|
DEFPOOL REDUCES(LIMIT(percent)) |
|
|
DEFPOOL REDUCES(PERCENT(percent)) |
|
|
DEFPOOL RESTRICT(option) (ALL/NEW/blank) |
|
|
POOL CONTAINS RUN-TIME EXPRESSIONS (YES/NO) |
|
|
DEFPOOL SETSEC(option) (YES/NO) |
|
|
DEFPOOL SMF(value) |
|
|
DEFPOOL SMF(LEVEL(I/W/A/E/C)) |
|
|
DEFPOOL SPECIFIC(CHECKPOOL/FLOAT/NOFLOAT) |
|
|
DEFPOOL USERID(userid) |
Note: 1 This field is read only.
SET processing
will not allow the field to be modified. |
||