The following AutoEdit System variables are supported by Control-M (in both JCL and in job scheduling definitions):
Table 248 Non-Date AutoEdit System Variables
Variable |
Description |
---|---|
%%. |
Concatenation symbol. |
%%APPL |
Application to which the job belongs. |
%%BLANK |
Blank. |
%%BLANKn |
Resolves to n blanks, where n is a number from 1 through 80. |
Note: When entering an AutoEdit variable assignment (such as %%A = 1), any leading spaces (blanks) following the '=' are ignored and any succeeding spaces in the character string terminate the variable value when the variable is resolved. System variables %%BLANK and %%BLANKn enable you to embed spaces in the variable expression. The variable assignment %%A = This%%BLANKis%%BLANK1an%%BLANKexample, using %%BLANK and %%BLANKn to create embedded spaces, resolves to The similar variable assignment, %%A = THIS IS AN EXAMPLE, resolves to THISISANEXAMPLE. |
|
%%GROUP |
Group to which the job belongs. |
%%JOBNAME |
Name of the submitted job as specified in the JCL job statement. If %%JOBNAME is resolved before the job submission (for example, %%JOBNAME is used in a SHOUT WHEN LATESUB statement, and the job has not been submitted), its value is assigned the %%$MEMNAME value. |
%%ORDERID |
Unique job order ID under Control-M (5 characters). |
%%OWNER |
Owner of the job, as specified in the scheduling definition. |
%%RN |
Run number (can exceed one for cyclic and rerun and restarted jobs). |
%%TIME |
Current time of day, in HHMMSS format. This variable returns the current time each time it is invoked. |
%%TIMEF |
Current time of day, in HH:MM:SS format. This variable returns the current time each time it is invoked. |
%%TIMEID |
Current time of day, in HHMMSS format.* |
%%$AVGELAP |
The average elapsed time (in seconds) for the job. |
%%$MAXELAP |
The job's maximum elapsed time (in seconds). |
%%$DATEFMT |
Resolves to A, W, or J, according to the DATETYP date format parameter defined in the IOAPARM member in the IOA PARM library. |
%%$HOUR |
This variable returns the hours of the current time of day in a 2-character format, based on a 24-hour clock.* |
%%$HUN |
This variable returns the hundredths of a second of the current time of day in a 2-character format.* |
%%$L |
The computer LPAR name where the job executed. |
%%$MEMLIB |
The MEMLIB, as it appears in the job definition. One of the following:
|
%%$MEMNAME |
Name of the JCL member from which the job is submitted. (This corresponds to the value specified in the job scheduling definition.) |
%%$MIN |
This variable returns the minutes of the current time of day in a 2-character format.* |
%%$OVERLIB |
The OVERLIB, as it appears in the job definition. One of the following:
|
%%$QNAME |
Qname (unique identifier) of the monitor that submitted the job. |
%%$RBC |
Name of the rule-based calendar by which the job was scheduled. If the SMART Table was forced, or if the job was scheduled based on basic scheduling criteria other than a rule-based calendar, this value resolves to blanks. |
%%$SCHDLIB |
Name of the scheduling library that contains the job scheduling definition of the job. This variable is resolved only after the job has been ordered. |
%%$SCHDTAB |
Name of the table that contains the job scheduling definition of the job. This variable is resolved only after the job has been ordered. |
%%$SCHENV |
Name of the scheduling environment that is specified in the job scheduling definition. |
%%$SEC |
This variable returns the seconds of the current time of day in a 2-character format.* |
%%$SIGN |
1-character ID of the computer on which the job is running. The %%$SIGN variable is commonly used when assigning system affinity, as in the following example: /*JOBPARM SYSAFF=CPU%%$SIGN For more information, see Controlling the Target Computer by System Affinity. |
|
Note: The %%$SIGN variable is not resolved unless the job scheduling definition from which the job is ordered contains a resource name with a $ mask character used as a generic indicator. For more information, see RESOURCE: Runtime Scheduling Parameter. |
%%$SUBLIB |
The name of the library from which the job was submitted. One of the following:
|
%%$SYSNAME |
Name of the system on which the Control-M monitor is running. |
%%$TBLRN3 |
Run number of the Cyclic SMART Table — a numeric counter based on the last three digits of the SMART Table run number. This counter is initialized at 001 for the first cycle and incremented by 1 for each cycle of a Cyclic SMART Table that ended OK or NOT OK. When the counter reaches 999, it restarts at 000. |
%%$TIMEH |
Current time of day, in HHMMSSth format, based on a 24-hour clock.* This format includes the following elements:
|
%%$UFLOW |
Unique job flow ID, a suffix up to 3 characters long to append to new condition names. The unique job flow ID ensures that the flow is not affected by conditions that already exist as relationships between jobs in the AJF. A unique job flow ID is useful, for example, when the same table is ordered multiple times a day, and you need an independent job flow for each invocation. |
* Note: This AutoEdit variable receives the current time only when it is first resolved in a job JCL. Subsequent resolutions within that job JCL do not update the variable. Outside the job JCL (for example, in DO SHOUT) this variable may receive a different value, depending on the time of the corresponding resolution.
Parent Topic |