Previous Topic

Next Topic

Book Contents

Book Index

Non-Date System Variables

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
This is an example
%%BLANK and %%BLANK1 each produce the same result, a single embedded space.

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:

  • Library name (for example, MY.JCLS)
  • GENERAL
  • DD-name (for example, MYJOBS)
  • Unresolved expression with AE variables (for example, %%MYLIB)
  • DUMMY (in the case of a dummy job)
  • INLINE (in the case of inline JCLs)
  • USER (in the case of JCLs loaded from a user exit)

%%$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:

  • Empty (null)
  • Library name (for example, MY.JCLS)
  • GENERAL
  • DD-name (for example, MYJOBS)
  • Unresolved expression with AE variables (for example, %%MYOVER)
  • DUMMY (in the case of a dummy job)
  • INLINE (in the case of inline JCLs)
  • USER (in the case of JCLs loaded from a user exit)

%%$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:

  • Actual library name, from either the MEMLIB or the OVERLIB.
    The library name must be fully resolved (that is, no variables or DD name references).
  • DUMMY (in the case of a dummy job)
  • INLINE (in the case of inline JCLs)
  • USER (in the case of JCLs loaded from a user exit)

%%$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:

  • HH — hours
  • MM — minutes
  • SS — seconds
  • th — hundredths of a second

%%$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

System variables