Job Type

Defines the type of Job that determines which fields are exposed in a Job definition. The value of the Job type is usually based on the platform for the Job run. Jobs defined as Dummy provide instructions for Control-M such as post-processing actions.

Value: Control-M Report

Job Name

Defines the name of the Job processing definition.

Control-M rules:

• 1-64 characters
• Case sensitive
• Invalid characters:

  Single quotation marks

  "$", "/", "*", "?", " "

Description

Provides a description of the Job in free text. A well written description can help you determine why the Job was defined and how it fits into your Job flow. Control-M rules:

• 1-4000 characters
• Case sensitive

Run as dummy

Enables you to run Jobs of Job types other than Dummy, as dummy Jobs.

Control-M Report Attributes (Details)

Defines the following parameters:

• Run as
• User
• Password
• Password file
• Sever Host
• emreportcli Path
• Template
• Template path
• Output to:

  Output to file (Output file type and Output file)

  Output to Sysout

• Report Parameters (Parameter Name and Parameter Value)
• Save

Run as

Identifies the user name with the authorization to execute the Job. This parameter is used by the Control-M security mechanism.

Control-M rules:

• 1-30 characters
• Case sensitive
• Invalid characters: Single quotation marks, Blanks

User

Control-M/EM user that runs the report.

Password

Control-M/EM user password.

Password file

Flat file containing an unencrypted username and password in the following format: user=username password=password.

Server Host

Host name of the Control-M/EM Server.

emreportcli path

Specifies the path where Reporting Facility is installed on Control-M/EM.

Template

Specifies the name of the template.

Template path

Specifies the Folder in which the template file is located.

Output to file

• Sends the output to a specified file to:
• Output file type
• Output file

Output file type

Specifies the type of the output file, such as EXCEL, EXCEL_DO (for data only), PDF, DOC, HTML, TXT, or XML.

Output file

Specifies the full filename of the output file (which is overwritten if it exists already).

Output to Sysout

Defines where to send the Job report.

Report Parameters

Defines an individual parameter, whose name and value is specified.

Parameter Name

Name of the parameter as defined in the report template filter panel.

Parameter Value

Value of the report parameter (wildcard characters can be used for text fields when the field operator in the filter panel is set to "LIKE" for the fields)

Save

Defines the Save button to save the Job specific settings.

Host (/Group)

Defines the name of a Control-M/Agent computer, remote host computer, or host group where the Job is submitted.

Control-M rules:

• 1-30 characters
• Case sensitive
• Invalid characters: Single quotation marks, Blanks

Control-M/Server

Defines the name of the Control-M/Server (or Control-M for z/OS) that processes the Job.

Run job on all hosts in group

Specifies that Job submission details be broadcast to all agents within a defined Host Group. All available agents in the Host Group run an identical Job, and each such Job has a unique Order ID.

Variables

All variables are identified by the %% prefix. If %% is included in the value for a Job processing parameter, Control‑M assumes that it is referring to a variable or function.

Control-M rules:

Length:

• Name: 1-40
• Value: 1-4000

Application

Provides a logical name for sorting groups of Jobs. This parameter is used to supply a common descriptive name to a set of related Job groups. The Jobs do not necessarily have to run at the same time.

Control-M rules:

• Case sensitive
• Invalid characters: Blanks, Single quotation marks

Sub Application

Indicates the name of the Sub Application where the Job belongs logically. It is a sub-category of the Application parameter. For example, the Application is Finances, and the Sub Application is Payroll.

Control-M rules:

• 1-64 characters
• Case sensitive
• Invalid characters: Single quotation marks, Blanks

Created by

Indicates the Control‑M/EM user who defined the Job.

Control-M rules:

• 1-64 characters
• Case sensitive
• Invalid characters: Single quotation marks, Blanks

Documentation

Defines a description related to the Job, and is saved in a defined location. The Documentation area in the Properties pane includes information about where to find the Documentation. In a z/OS Job, the Documentation is in a Doc Member located in a Doc Library. In a non-z/OS Job, the Documentation depends on whether the type is File or URL. For a file, the description is located in a file located in a file path. For a URL, the Documentation is located in a URL address.

Type

Defines whether the documentation for an OS Job is in a file or URL. See the following:

• URL: Defines the URL address where the documentation is located. The format starts with "http://", "ftp://", or "file://".
• File: Specifies the file that contains the Job script.

Control-M rules:

• URL Length: Combines the length of Doc Member/ Doc File 64 characters and Doc Library/ Doc Path 255 characters
• File Length: 1-64 characters

Doc Path

For a z/OS Job, Doc Library defines the name of the library where the Documentation (description) is saved. For a non-z/OS Job, Doc Path defines the name of the file path where the Documentation is saved.

Control-M rules:

• Microsoft Windows and UNIX: 1-255 characters
• iSeries (AS/400): 1-21 characters
• OpenVMS: 1-60 characters
• Case sensitive

Doc File

For a z/OS Job, defines the name of the member where the Job Documentation (description) is saved. For a non-z/OS Job, the Doc File is the name of the file where the Job Documentation is saved.

Control-M rules:

• 1-64 characters
• Case Sensitive
• Invalid characters: Blanks

Priority

Determines the order of Job processing.

Critical

Determines whether the Job is a critical-path Job in Control-M, which ensures resources allocation order.