Usage

Mandatory

Length

1-64 characters

Case Sensitive

Yes

Invalid Characters

Single quotation marks

Variable Name

When defining a SMART folder, you can add variables that are resolved during ordering time. The same time and date for ordering time is used for all jobs within the ordered folders. In the Monitoring domain, the SMART folders and jobs that are ordered within it, appear under the same Application/Sub Application.

If folders are ordered before New Day time, their ordering time is set as the time of the New Day, even though they may be actually ordered later. For example, if there are many folders ordered during New Day, some of the folders are actually ordered at different times. You can order the same flow of jobs using a variable such us %%TIME in the Application/Sub Application field, and each job will receive a different Application or Sub Application name in each order.

Supported variables:

%%$DATE, %%$ODATE, %%$OYEAR, %%$RDATE, %%$RYEAR, %%$YEAR, %%CENT, %%DATE, %%DAY, %%JULDAY, %%MONTH, %%ODATE, %%ODAY, %%OJULDAY, %%OMONTH, %%OWDAY, %%OYEAR, %%RDATE, %%RDAY, %%RJULDAY, %%RMONTH, %%RWDAY, %%RYEAR, %%TIME, %%WDAY, %%YEAR, %%OMONNAM, %%RMONNAM, %%MONNAM

If you use variables that are not listed above, they will be evaluated during the time of submission.

EXAMPLE: If Application = %%TIME.%%VAR1

During ordering time, %%TIME is resolved to 140413 and the %%VAR1 will be resolved during submission time. The Application of the job is: 140413%%VAR1

NOTE: Relevant for Control-M/EM version 8.0.00 fix pack 6 and above. For more information, see Control-M system variables.

EXAMPLE: FolderX is ordered twice, once at New Day time and later through ctmudly, at 14:00. You want the jobs that were ordered at New Day time to have a different Application name than the jobs ordered at 14:00.

Define all the jobs in FolderX with application APP_X_%%TIME, which resolves at order time. All of the jobs in each job flow will have the same Application name and jobs ordered at different times will have different Application names:

Jobs ordered at New Day time will receive the Application name “APP_X_07:00” (assuming the New Day time is 07:00). Jobs ordered at 14:00 will receive the application name “APP_X_14:00”

Multiple variables and fixed text can be used for a single field.

EXAMPLE:

Application = Shipments_%%ODATE.%%TIME

Will be resolved to shipments 01012017.07:00

NOTES:

• The following variables will be resolved based on the ODAT received as a parameter to the ordering request or command:

  %%ODATE, %%$ODATE, %%CENT, %%OYEAR,

  %%$OYEAR, %%OMONTH, %%ODAY, %%OWDAY, %%OJULDAY,

  %%OMONNAM.

• The following variables will be resolved based on the Control-M/Server date (or based on the next New Day date for pre-ordering):

  %%RDATE, %%$RDATE , %%RYEAR, %%$RYEAR, %%RMONTH,

  %%RDAY, %%RWDAY, %%RJULDAY, %%RMONNAM

• The following variables will be calculated based on the current date (or on the next date for pre-ordering):

  %%DATE, %%$DATE, %%YEAR, %%$YEAR,

  %%MONTH, %%DAY, %%WDAY, %%JULDAY, %%MONNAM

• The following variable will be calculated based on the current time (or on the New Day time for pre-ordering):

  %%TIME

Alternate Names

• Control‑M/EM Utilities: SUB_APPLICATION
• Reporting Facility: SUB-APPLICATION NAME
• Control‑M/Server Utilities: -subapp
• Control-M for z/OS: SUB APPLICATION
• Control-M/EM API: Sub Application

Previously Known As

Group