Output data sets, job cards, and symbolic variables
When you specify a recovery job for one or more object sets, you must supply the data set names into which the output JCL should be placed and the job card information for that JCL. Both items can include symbolic variables.
When you do not specify job card information for recovery job generation, BMC AMI Recovery Manager uses a default. You can view or update the defaults by:
- Selecting Product Option Sets in the BMC AMI Recovery Manager Main Menu
- Selecting the option set
- Expanding Common Options
- Expanding Job Card Options
You can also edit the default during job creation; the edited information then becomes the new default for your user ID.
Output data set (JCLOUT) specification
The name of the data set into which the JCL is placed must be the name of an existing cataloged partitioned data set or sequential data set.
You can use the following symbolic variables when you specify the data set name:
Symbol | Result |
---|---|
&SSID | ID of the Db2 subsystem |
&USERID, &USER, &UID | Time Sharing Option (TSO) user ID |
&SUIDnm | Substring of your user ID, starting with character n for a length of m characters |
&DATE | Current date (in the form YYMMDD) 1 |
&TIME | Current time (in the form HHMMSS) 1 |
&SEQ | (BMC AMI Copy only) Sequence number that increments with each reference The sequence number restarts at 1 for each job step and is used to provide unique output data set names. |
1 Symbols with a numeric result must be prefixed by at least one alphabetic character.
Job card (JCARD) specification
The job card information (JCARD1 through JCARD5) must include symbolic variables to enable BMC AMI Recovery Manager to be able to utilize the multiple job optimization feature.
The job name must include one of the following symbolic in the job name:
&#—the least significant digit of the job number
&##—the two least significant digits of the job number
&###—the three least significant digits of the job number
&####—all four digits of the job number
If you do not use this symbolic variable, BMC AMI Recovery Manager issues an error message.
You can also use substrings of symbolic variables in job names in the format symbolicVariable(n,m). The substring starts with character n for a length of m characters. In the following example, 2 is the substring starting position and 4 is the substring length:
The complete list of symbolic variables that are available to use in your job card specification is shown in the following table:
Symbol | Result 1 |
---|---|
&SSID | ID of the Db2 subsystem |
&USERID, &USER, &UID | TSO user ID |
&SUIDnm | Substring of your user ID, starting with character n for a length of m characters |
&#....&#### 2 | Generated numeric digits |
1 The maximum total length allowed for a data set name is 44 bytes.
2 WARNING: You must include enough variables (#) in this value to handle the maximum number of jobs that you request BMC AMI Recovery Manager to generate. Otherwise, BMC AMI Recovery Manager might generate duplicate job names. (For example, if you want 10 jobs, you must specify at least &##:. If you want 100 jobs, you must specify &###:.)