CONTROL-M system variables

CONTROL-M system variables

%%CYCLIC Y|N This variable is used in the command line of the
ctmorder utility to override the Cyclic
parameter in cases where the user wishes to
order a single run of a job that is defined as
cyclic.
Y – job is cyclic
N – job should be run only once.

%%DATACENTER string Name of the data center for the current
CONTROL-M installation.
Note: This variable is available on certain
CONTROL-M computers as of
CONTROL-M version 2.20. However, prior to
CONTROL-M/EM version 6.1.02,
%%DATACENTER returned the host name for
the current CONTROL-M/Server.

%%DATE yymmdd Current system date.

%%DAY dd Current system day.

%%GROUP_ORDID nnnnnn Order ID of the group to which the job belongs.
Note: This variable is valid only for jobs in a
group scheduling table and it is evaluated in
base 10.

%%JOBNAME string Name of the submitted job. This variable can be
used to override the value specified for the
JOBNAME parameter (for example, in the
ctmorder utility).
Note: On a Microsoft Windows computer,
JOBNAME must comply with Microsoft naming
conventions (for example, it cannot contain /
and \ characters).

%%JULDAY nnn Current system day of the year (Julian format).

%%MEMLIB string Mem Lib (name of the library or directory in
which job script is stored) of the job.

%%MONTH mm Current system month.

%%NEXT yymmdd Next scheduling date for the job.

%%ODATE yymmdd Original scheduling date of the job.

%%ODAY dd Original scheduling day of the job.
%%OJULDAY nnn Original scheduling day of the year (Julian
format).
For example, 36 for February 5th.

%%OMONTH mm Original scheduling month of the job.
Name Format Description

%%ORDERID nnnnnn Unique job order ID under CONTROL-M.

%%OWDAY d Original scheduling day of the week of the job
(1= Sun., 2= Mon., and 0=Sat.).

%%OWNER string Owner (user ID) associated with the job.

%%OYEAR yy Original scheduling year of the job.

%%POSTCMD command Specifies a command to run immediately after
running the job defined by MEMNAME. The
return code is ignored.
Note: Not relevant for z/OS jobs. Relevant only
for CONTROL-M/Server version 6.0.01 or later,
or (without SYSOUT) for any job submitted by
CONTROL-M/Agent for Microsoft Windows
2000 version 6.0.01 or later. This variable is not
used with group scheduling tables.

%%PRECMD command Specifies a command to run immediately before
running the job defined by MEMNAME. The
return code is ignored.
Note: Not relevant for z/OS jobs. Relevant only
for CONTROL-M/Server version 6.0.01 or later,
or (without SYSOUT) for any job submitted by
CONTROL-M/Agent for Microsoft Windows
2000 version 6.0.01 or later. This variable is not
used with group scheduling tables.

%%PREV yymmdd Previous scheduling date for the job.

%%RDATE yymmdd Installation current working date.

%%RDAY dd Installation current working day.

%%RJULDAY nnn Installation current working day of the year
(Julian format).
For example, 36 for February 5th.

%%RMONTH mm Installation current working month.

%%RUNCOUNT nnnn Number of times the job order has been
submitted for execution (that is, the first time
the job is being submitted, this variable returns
a value of 1).

%%RWDAY n Installation current working day of the week
(1=Sun., 2=Mon., and 0=Sat.).

%%RYEAR yy Installation current working year.

%%SCHEDTAB string Name of the job’s Scheduling table.
Note: This variable is available on certain
CONTROL-M computers as of
CONTROL-M version 2.2x.

%%TIME hhmmss Time of day.
Table 49 CONTROL-M system variables (part 3 of 4)
Name Format Description
The following variables are not assigned values until after the job is submitted or
completes execution. These variables can be used only for the Shout, Do Shout, Do
Mail, and Do AutoEdit parameters.

%%WDAY n Current system day of the week (1=Sun.,
2=Mon., and 0=Sat.).

%%YEAR yy Current system year.
NOTE
AutoEdit variables that return runtime statistics for a job must be resolved before the
variables can return any values. AutoEdit variables for job statistics: %%AVG_CPU,
%%AVG_TIME, %%SD_CPU, and %%SD_TIME.
Run the ctmjsa utility to compile data in the Statistical Details table before specifying the
required AutoEdit statistics variable. For more information, see “Runtime Statistics” and
Name Format Description

%%AVG_CPU numeric Average CPU time (in seconds) for previous runs of the
current job. Note: Do not use this variable in a group
scheduling table definition.

%%AVG_TIME numeric Average run time (in seconds) for previous runs of the
current job or group scheduling table.

%%COMPSTAT numeric Completion code assigned to the job by the
operating system of the computer that executes the job.
Initial value: 0.

%%JOBID string Identification assigned to the job by the operating system
of the computer that executes the job. Note: Do not use
this variable in a group scheduling table definition.

%%NODEID string Node ID of agent computer that submitted the job. Note:
This variable is available for certain computers as of
CONTROL-M version 2.2x.

%%SD_CPU numeric Standard deviation of the CPU time (in seconds) from the
average CPU time for previous runs of the current job.
Note: Do not use this variable in a group scheduling table
definition.

%%SD_TIME numeric Standard deviation of the elapsed run time (in seconds)
from the average elapsed run time for previous runs of
the current job or group scheduling table.