Symbolic variables
You can use the symbolic variables in the following table only in the following items:
- Service DD statements
- User-defined service syntax
- Service parameters
Use && to specify that DASD MANAGER PLUS should not substitute the variable but rather should remove one & and generate the remaining syntax. If DASD MANAGER PLUS encounters an & with a symbol that it does not recognize, it generates the symbolic variable in the text.
Symbolic variables specific to DASD MANAGER PLUS
Symbolic variable | Description |
|---|---|
ALID | Same as WKID |
CR CREATOR | Creator |
DA | Date, same as DD |
DATE | Date in YYMMDD format |
DATEJ | Date in YYYYDDD format |
DB | Database |
DBNAME | Database name |
DD | Day of month |
DDD | Julian day |
DDSEQ DSQ | DD sequence number |
DOPTS | Default options module, for full automation mode only |
DSNUM | Same as PART |
DT | Date in YYMMDD format |
HH | Hour |
HMS | Same as TIME |
HO | Hour |
IX | Index |
IXCR | Index creator |
IXNAME | Index name |
JD | Date in YYDDD format |
JDATE | Date in YYYYDDD format |
JDAY | Julian day |
JOBTYP | Job type, for online generation only |
JQID | Same as WKID |
JUL4Y | Date in YYYYDDD format |
JULIAN | Date in YYDDDD format |
MEMBER | For online generation only |
MI | Minutes |
MM MO | month |
OBJKW | Object keyword |
OBJNAME | Object name |
OBJT | Object type |
OBJTYPE | Object type |
OBNAM | Object name |
PART | Partition ID |
PART2 | Partition ID, at least 2-digits |
PART3 | Partition ID, at least 3-digits |
PART4 | Partition ID, is 4-digits |
PGMR | For online generation only |
PREFIX | Same as USERID, for online generation only |
RUNTYP | Run type, for online generation only |
SC SS | Seconds |
SPNAME | Either table space name or index space name |
SSID | Subsystem ID |
TIME | Time in HHMMSS format |
TS | Table space |
TSNAME | Table space name |
UID | Same as USER, for online generation only |
USER | For online generation only |
USERID | For online generation only |
UTILID UTID | Utility ID, for full automation mode only |
VCAT | VCAT name |
WKID | Action name |
WKID8 | First 8 characters of WORKID or action |
WORKID | Same as WKID |
YEAR | Year in YYYY format |
YY | Year in YY format |
YYYY | Year in YYYY format |
ZPREFIX | Same as PREFIX, for online generation only |
ZUSER | Same as USERID, for online generation only |
You can use symbolic variables in the installation options module, in the POF, and on several of the options panels. The symbolic variables are used in job cards and data set names. On product panels, an ampersand (&) must precede the symbolic variable. In the JCL of the installation options module, two ampersands (&&) must precede the symbolic variable. For information about the use of symbolic variables, see the customization guide.
Symbolic variables for BMC Administrative products
You can use symbolic variables in the installation options module, the product options file (POF), and on several of the options panels. The symbolic variables are used in job cards and data set names.
The following table lists all of the symbolic variables that the JCL Generation and Execution components use. Some of these variables are not applicable to each of the BMC Administrative products. The table indicates which products resolve the variables in job cards and data set names. The table also lists the related skeleton library (SLIB) (or ISPF) variable and the corresponding OUTPUT and TEMPLATE descriptor variables.
On product panels, an ampersand (&) must precede the symbolic variable. In the JCL of the installation options module, two ampersands (&&) must precede the symbolic variable. For information about the use of symbolic variables, see the Installation System and Customizing BMC Products and Solutions for DB2.
macro:id
Symbolic variable and description | Size | Value | Related SLIB variable | OUTPUT descriptor variable | TEMPLATE descriptor variable |
|---|---|---|---|---|---|
AJXODS44 Whether JCL Generation verifies that the prefix of a data set name contains 44 characters | 1 | Y N | AJXDSN44 | None | None |
8 | ALTER CATMGR DASDMGR | AJXJAID | UTIL | UT | |
ATTACH Db2 subsystem ID | 4 | None | AJXJSSID | ATTACH | JOBNAME |
BMCCP Partition number in which insignificant digits are suppressed If the partition number is between 0 and 99, the variable will resolve to 2 digits; between 100 and 999, 3 digits; and between 1000 and 4096, 4 digits. | 2 to 4 | None | AJXBMCCP | PART | PART |
CR Creator | 8 | None | AJXCR | DB | DB |
DA DAY Day part of YYMMDD format | 2 | DD | AJXYMD | DAY | DA DAY |
6 | YYMMDD | AJXYMD | DATE | DATE | |
DATEJ Julian date is shown with a four-digit year | 7 | YYYYDDD | AJX4YDDD | JDATE | JDATE |
DB DBNAME Database name | 8 | Name of current database | AJXDB | DB | DB |
DB2V2 | 2 | Version of Db2 | AJXDB2V2 | None | None |
DB2V3 | 3 | Version of Db2 | AJXDB2V3 | None | None |
DDD Julian day | 3 | DDD | AJXYYDDD | JDAY | JD |
DDNAME DDname | 8 | None | AJXJDDN | None | None |
DDOPT Name of the installation options module | 8 | None | AJXDDOPT | SEQ | JOBNAME |
DDSEQ Sequence number | 4 | None | AJXDDSQC | SEQ | SEQ |
DSNUM Partition number | 3 | None | AJXPARTC | DSNUM | PART |
DT System date (same format as JYMD and YMD) | 6 | YYMMDD | AJXYMD | DATE | DT |
FCMD Full command name | 8 | None | AJXFCMD | UTIL | UT |
GDG 3 Generation data group (GDG) counter | 4 | Initially 1 | AJXGDGPC | +1 | +1 |
GRPNM Db2 subsystem ID | 8 | None | AJXJSSID | SSID | SSID |
HM Time of JCL creation in hours and minutes | 4 | HHMM | AJXHM | HOUR.MINUTE | HO.MI |
HMS Time of JCL creation in hours, minutes, and seconds | 6 | HHMMSS | AJXHMS | TIME | TIME |
HO HOUR Hour part of HHMMSS format | 2 | HH | AJXHMS | HOUR | HO HOUR |
IC ICTYPE Image copy type | 1 | L = Local R = Remote | AJXIC | ICTYPE | IC ICTYPE |
IS Index space name | 8 | None | AJXIXSPC | TS | TS |
IX IXNAME Index name | 16 | Name of current index | AJXIX | TS | IS |
IXCR Index creator name | 8 | Creator of current index | AJXCR | DB | DB |
IXNODE 4 Index node | 22 | None | AJXIXNOD | DB.TS | DB..IS |
IXSPC Index space name | 8 | None | AJXIXSPC | TS | IS |
JD Julian date is shown with a two-digit year | 5 | YYDDD | AJXYYDDD | None | JDATE(3) |
JDATE Julian date is shown with a four-digit year | 7 | YYYYDDD | AJX4YDDD | JDATE | JDATE(3) |
JDAY Julian day | 3 | DDD | AJXYYDDD | JDAY | JD |
JDDN ddname for skeleton | 8 | None | AJXDDN | SEQ | JOBNAME |
JHMS Time of work ID creation | 6 | HHMMSS | AJXHMS | TIME | TIME |
JJULD Julian date of work ID creation | 5 | YYDDD | AJXJJULD | JDAY | JDAY |
1 | A = Analysis B = Baseline C = Compare E = Execution I = Import | AJXFJCHR | JOBNAME | JOBNAME | |
JOBNAME Work ID or name assigned to a job | 8 | Work ID or job name in the JOB statement | AJXWKID AJXJOBNM | JOBNAME | JOBNAME |
8 | ANALYSIS EXECUTION BASELINE COMPARE IMPORT CATMGR UTILITY DEFINE CAT ALTER CHGMGR DASDMGR | AJXJOBT | TYPE | IC | |
JPCOD 1 Product code | 3 | ACM = Change Manager ACT = Catalog Manager ALU = ALTER ASU = DASD MANAGER PLUS | AJXJPCOD | JOBNAME | JOBNAME |
JS1 Job sequence number | 1 | None | None | None | None |
JS2 Job sequence number | 2 | None | None | None | None |
JS4 Job sequence number | 4 | None | None | None | None |
JQID Work ID | 8 | Work ID | AJXJQID | UTIL | UT |
JSSID 5 Db2 subsystem ID | 4 | None | AJXSSID | SSID | SSID |
JU Julian date is shown with a four-digit year | 7 | YYYYDDD | AJX4YDDD | JDATE | JDATE |
JUL4Y 1 Julian date | 7 | YYYYDDD | AJX4YDDD | JDATE | JDATE |
5 | YYDDD | AJXYYDDD | JDATE | JDATE | |
JYMD Date of work ID creation (same as DATE) | 6 | YYMMDD | AJXJYMD | DATE | DATE |
LDSNUM Partition number | 3 | None | AJXPARTC | None | None |
LI LIST LISTDEF name | 8 | None | AJXLDEFN | UTIL | LI LIST |
LLQ | 4 | Low-level qualifier for ISPF data sets | AJXLLQ | None | None |
LOCREM Image copy type | 1 | L = Local R = Remote | AJXLR | TYPE | LOCREM |
LPART Partition number | 3 | None | AJXPARTC | LPART | PART |
LR Image copy type | 1 | L = Local R = Remote | AJXLR | TYPE | LR |
8 | First seven characters of the work ID, with one of the following values appended: J = JCL W = Worklist D = Diagnostics C = CDL S = Source (CM/PILOT) T = Target (CM/PILOT) Z = Other Note: If the work ID template is used in CM/PILOT, then the task ID is used. | AJXMEMBER AJXMEMBR | JOBNAME | JOBNAME | |
MI MINUTE Minute part of HHMMSS format | 2 | MM | AJXHMS | MINUTE | MI |
MMDD JCL date | 4 | MMDD |
| MONTH.DAY | MONTH.DAY |
MO MONTH Month part of YYMMDD format | 2 | MM | AJXYMD | MONTH | MO |
MSSID Db2 subsystem ID | 4 | Determined at runtime from the -JCLP command in the worklist | AJXMSSID | SSID | SSID |
OBJT OBJTYP Object type | 2 | Object type: TS, TB, IX | AJXOBT | UTIL TYPE | IC |
OBNAM Object name | 27 | None | AJXOBNAM | DB.TS CREATOR.IX | DB..SN |
OBNOD Database and either table space name or index space name | 17 | #### (for objects that do not exist) | AJXOBNOD | DB.TS | DB..SN |
PA Partition number | 3 | None | AJXPARTC | PART | PA |
PART Partition number in which insignificant digits are suppressed | 4 | None | AJXPARTC | PART | PART |
PART4 Partition number in which leading zeros are not suppressed | 4 | None | AJX4PART | PART | PA(2) |
PART5 Partition number in which leading zeros are not suppressed | 5 | None | AJX5PART | PART | PART |
PB PRIBAC Type of copy | 1 | P = Primary B = Backup | AJXPB | TYPE | PB PRIBAC |
20 | ’&&JOBTYP - &&WKID’ | AJXPGMR | JOBNAME | JOBNAME | |
8 | In foreground, TSO prefix (&ZUSER if NOPREFIX) In batch, user ID | ZPREFIX | None | **PREFIX** | |
RHLQ High-level qualifier | 60 | High-level qualifier (HLQ) for ISPF data sets | AJXRHLQ | None | None |
RSEQ# Restart sequence number | 6 | None | AJXRSEQ# | SEQ | SEQ |
RTYPE Object type | 2 | None | AJXOBJT | TYPE | IC |
9 | ANALYZE EXECUTE BASELINE COMPARE IMPORT ALTER RESTART STARTOVER | AJXRUNTP | TYPE | IC | |
SC SEC SECOND Second part of HHMMSS format | 2 | SS | AJXHMS | SEC SEC SECOND | SC SC SECOND |
SEQ DD sequence number | 4 | None | AJXDDSQC | SEQ | SEQ |
SEQ# Sequence number | 6 | None | AJXSEQ# | SEQ | SEQ |
SN Table space name or index space name | 8 | None | AJXSPNAM | TS | SN |
SPNAME Table space name or index space name | 8 | None | AJXSPNAM | TS | SN |
SQ DD sequence number | 4 | None | AJXDDSQC | SEQ | SQ |
SS Db2 subsystem ID | 2 | None | AJXJSSID | SSID | SS |
4 | Determined at runtime | AJXSSID | SSID | SSID | |
ST STEPN STEPNAME Step name | 8 | None | AJXSTEPN | STEPNAME | STEPNAME |
STEP# Step number | 6 | None | AJXSTEPC | None | None |
SYSMLIB System ISPF message library | 46 | Name of system ISPF message library | AJXSYSM | None | None |
SYSUID JCL symbolic parameter | 8 | None | None | None | **PREFIX** |
TBCR TBCRE Table creator name | 8 | Owner of current table | AJXTBCR AJXTBCRE | DB | DB |
12 | Name of current table | AJXTBNAM | TS | TS | |
TBNODE Table node | 22 | None | AJXTBNOD | DB.TS | DB..TS |
6 | HHMMSS | AJXHMS | TIME | TI TIME | |
TIME4 Hours and minutes of HHMMSS format | 6 | HHMMSS | AJXHMS | TIME | HO.MI |
TS TSNAME Table space name | 8 | Name of current table space | AJXTS | TS | TS |
TSCR Table space creator | 8 | None | AJXTSCR | None | None |
TSIX Table space name or index space name | 8 | None | AJXSPNAM | TS | SN |
TSSID Db2 subsystem ID | 4 | Determined at runtime from the -JCLP command in the worklist | AJXTSSID | SSID | SSID |
TU1 Tape unit 1 | 4 | None | AJXTU1 | STEPNAME | STEPNAME |
TU2 Tape unit 2 | 4 | None | AJXTU2 | STEPNAME | STEPNAME |
TU3 Tape unit 3 | 4 | None | AJXTU3 | STEPNAME | STEPNAME |
TYPE Type of copy | 1 | L = Local R = Remote | AJXLR | TYPE | IC |
UCMD Command ID | 4 | None | AJXUCMD | UTIL | UT |
UDOPT Installation options file lname | 8 | None | AJXUDOPT | STEPNAME | STEPNAME |
UID TSO user ID | 7 | None | ZUSER | None | **PREFIX** |
ULLQ Low-level qualifier for user-defined data sets | 4 | Low-level qualifier for user-defined data sets | AJXULLQ | None | None |
UP UPART Partition number variable compared to AJXPARTC in which insignificant digits are suppressed For example, if a partition number is 10, AJXUPART will contain 010, while AJXPARTC will contain 10. | 3 | None | AJXUPART | PART | PART |
USER1 User-defined | None | None | None | UTIL | UT |
USER2 User-defined | None | None | None | UTIL | UT |
7 | TSO user ID | ZUSER | USERID | **PREFIX** | |
UT UTID UTIL UTILID Utility ID | 17 | None | AJXUTID | UTIL UTID UTIL UTIL | UT |
UTILPFX First eight bytes of utility ID | 8 | None | AJXUTID | UTIL | UT |
UTILSFX Last eight bytes of utility ID | 8 | None | AJXUTID | UTIL | UT |
UVR1 UVR2 UVR3 UVR4 UVR5 User-defined character variable | 8 | User-defined variable or ######## (if value is blank) | AJXUVR1 AJXUVR2 AJXUVR3 AJXUVR4 AJXUVR5 | User-defined | User-defined |
UVX1 UVX2 UVX3 UVX4 UVX5 User-defined REXX variable for string substitution | 72 | User-defined REXX variable | AJXUVX1 AJXUVX2 AJXUVX3 AJXUVX4 AJXUVX5 | None | None |
VCAT VCAT name | 8 | None | AJXVCAT | DB | DB |
( DASD MANAGER PLUS ) WKID 2 Name of the work ID | 8 | Name of the current work ID in use | AJXJQID | None | UT |
8 | Owner of the current work ID in use | AJXWKOWN | JOBNAME STEPNAME | JOBNAME STEPNAME | |
18 | Name of the current work ID in use or, for Compare only, the outbound migrate profile name specified that is for use If the work ID name contains characters that are invalid for use in data set names, the work ID will be truncated at the first invalid character. | AJXJQID | None | UT | |
8 | If the work ID name contains characters that are invalid for use in data set names, the work ID will be truncated at the first invalid character. | AJXWKID | None | UT | |
YE YEAR Year from Julian date | 4 | YYYY | AJX4YDDD | YEAR YY | YE |
YMD Date of JCL creation (same as DATE and JYMD) | 6 | YYMMDD | AJXYMD | DATE | DATE |
YY Year from Julian date | 2 | YY | AJXYYDDD | None | None |
YYDDD Julian date of JCL creation (same as JULIAN) | 5 | YYDDD | AJXYYDDD | JDATE | JDATE(3) |
YYYYDDD Julian date is shown with a four-digit year | 7 | YYYYDDD | AJX4YDDD | JDATE | JDATE |
ZACCTNUM User’s account number for jobs that are generated by the product | 40 | If the replacement value is not known or does not fit in the space provided, question marks (?) are substituted. | ZACCTNUM | USERID | JOBNAME |
8 | None | ZPREFIX | USERID | **PREFIX** | |
ZSYSID ISPF system variable |
| System name | ZSYSID | ATTACH | **PREFIX** |
8 | None | ZUSER | USERID | **PREFIX** |
1 ALTER and Change Manager resolve this variable for job cards and data set names.
2 DASD MANAGER PLUS resolves this variable for job cards and data set names.
3 This variable is incremented each time any image copy is taken for a specific table space. Consider the following items if you use the GDG variable:
a JCL Generation does not verify that the GDG base definitions already exist.
b No GDG numbers are built for invalid or incomplete table space names. JCL Generation builds the &AJXDB, &AJXTS, and &OBNOD variables by parsing the utility commands in the worklist. An alter-type worklist might contain incomplete table space names for implicit table spaces because these names will not be known until the worklist is executed.
4 This value truncates after eight characters when used by JCL Generation.
5 This value is determined at runtime (same as SSID).
6 For the Compare component of Change Manager, this variable indicates the outbound migrate profile name.
7 Leave this variable blank for NOPREFIX (same as PREFIX).
