Folder Type

Indicates whether the folder type is a regular folder, a SMART folder, or a Sub Folder.

Folder Name

Defines the name of the folder. In the Properties pane, this parameter indicates the folder where the job belongs.

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 business workflow.

Reference

Defines the sub-folder as a Reference sub-folder. A Reference sub-folder references to a SMART folder or a job within a SMART folder.

The following sub-folder properties are updated with values from the referenced SMART folder or job, if these properties are not set:

• Description
• Documentation path
• Documentation file
• Priority

  Note: You cannot add jobs to a Reference sub-folder, or reference an existing sub-folder that contains jobs.

Reference Path

Defines the full reference path name, such as referenceFolder2/job7.

Valid values:

• Number of levels: Up to 9
• Characters: 0-1024

  Example: If you reference a SMART folder named Dailyflow, the reference path is Dailyflow.

  If you reference job2 within a sub-folder named Hourflow within a SMART folder named Dailyflow, the reference path is Dailyflow/Hourflow/job2.

  Note:

• The reference path cannot include wildcards.
• If a Site Standard is applied on a SMART folder that contains a referencing sub-folder, the Site Standard is validated on the sub-folder but not on the referenced entities.

Control-M/Server

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

Run as

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

Parent Folder

Defines the name of the folder that contains the job or Sub Folder.

Names of folders and Sub Folders may be up to 64 characters, with the exception of Control-M for z/OS folders which may be up to 8 characters. Folder names cannot contain the character “/”. SMART Folders in Control-M for z/OS can only contain jobs (not Sub Folders).

More

Defines an area of the Properties pane to click to define more parameters.

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. You can add a variable, as described in Adding a variable.

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.

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.

Created by

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

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: Defines the file that contains the job script.

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.

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.

Priority

Determines the order of job processing by Control-M in the Active Jobs database.