Control-M system variables

The following table describes the available system variables. These reserved variables can be used to include system information in job processing parameter values.

Please note the following:

• Start of the week depends upon user preferences specifying whether 1 = Sunday or 1 = Monday. Descriptions in the following table that refer to day of the week presume that 1= Sun. Consult your Control-M administrator to determine which standard is used at your site.
• All System variable names must be specified using uppercase letters.
• Certain system variables can be referenced only after job completion (in postprocessing parameters). These variables are listed separately in Action system variables.

  Name	Format	Description
  %%APPLGROUP	string	Name of the group to which the job belongs.
  %%APPLIC	string	Name of the Application to which the job’s group belongs. NOTE: For z/OS jobs the %%APPL variable is used to reference the Application name.
  %%BLANKn	n spaces	Resolves to n blanks, where n is a number between 1 - 214.
  %%CENT	yy	First two digits in the current year (for example, 20 in year 2006).
  %%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.
  %%DAILYNAME		Defines User Daily jobs whose purpose is to order jobs. Length 1-10.
  %%DATACENTER	string	Name of the Control-M/Server 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.
  %%$DATE	yyyymmdd	Current system date (4-digit year).
  %%DAY	dd	Current system day.
  %%FOLDER_ID	nnnnnn	Order ID of the folder to which the job belongs. NOTE: Valid for jobs in a folder and is evaluated in base 100.
  %%$FOLDER_ID	nnnnnn	Order ID of the folder to which the job belongs. NOTE: Valid for jobs in a folder and is evaluated in base 36.
  %%GROUP_ORDID	nnnnnn	Order ID of the Sub Application to which the job belongs. NOTE: This variable is valid only for jobs in an active folder and it is evaluated in base 100.
  %%$GROUP_ORDID	nnnnnn	Order ID of the Sub Application to which the job belongs. NOTE: This variable is valid only for job in an active folder and its evaluated in base 36.
  %%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.
  %%MONNAM	mm	Defines the month name.
  %%MONTH	mm	Current system month.
  %%NEXT	yymmdd	Next scheduling date for the job.
  %%$NEXT	yyyymmdd	Next scheduling date for the job (4-digit year).
  %%ODATE	yymmdd	Original scheduling date of the job.
  %%$ODATE	yyyymmdd	Original scheduling date of the job (4-digit year).
  %%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.
  %%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.
  %%$OYEAR	yyyy	Original scheduling year of the job (4-digit year).
  %%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 OUTPUT) for any job submitted by Control-M/Agent for Microsoft Windows 2000 version 6.0.01 or later. This variable is not used with SMART Folder.
  %%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 OUTPUT) for any job submitted by Control-M/Agent for Microsoft Windows 2000 version 6.0.01 or later. This variable is not used with SMART Folder.
  %%PREV	yymmdd	Previous scheduling date for the job.
  %%$PREV	yymmdd	Previous scheduling date for the job (4-digit year)
  %%$RDATE	yyyymmdd	Installation current working date (4-digit year).
  %%RDAY	dd	Installation current working day.
  %%RJULDAY	nnn	Installation current working day of the year (Julian format). For example, 36 for February 5th.
  %%RMONNAM		Defines the name of the month, which is resolved on the Control-M/Server date (or based on the New date for pre ordering).
  %%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.
  %%$RYEAR	yyyy	Installation current working year (4-digit year).
  %%SCHEDTAB	string	Name of the job’s folder. NOTE: This variable is available on certain Control‑M computers as of Control‑M version 2.2x.
  %%SMART_ORDERID		Defines the order ID of an existing SMART Folder. NOTE: Valid for jobs in SMART Folder and is evaluated in base 100.
  %%$SMART_ORDERID		Defines the order ID of an existing SMART Folder. NOTE: Valid for jobs in SMART Folder and is evaluated in base 36.
  %%$TABLE_ID	nnnnnn	Order ID of the folder to which the job belongs. NOTE: Valid for jobs in SMART Folder and is evaluated in base 36.
  %%TIME	hhmmss	Time of day.
  %%$WCALC	yymmdd	Performs a shift from the specified date to a working date in the specified calendar, according to indicated instructions. For more information, see %%$WCALC.
  %%WDAY	n	current system day of the week (1=Sun, 2=Mon, and 0=Sat)
  %%YEAR	yy	Current system year