SMART Folder parameters

The following table describes parameters for a SMART Folder that is used to define scheduling, prerequisites, and actions of the Jobs contained in the SMART Folder:

Parameter

Description

Control-M rules

Folder Type

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

Value: SMART

 

Folder Name

Defines the name of the Folder. In the Properties pane, this parameter indicates the Folder where the Job belongs.

Length:

  • 1-64 characters
  • z/OS: 1-8 characters

Case Sensitive: Yes

Invalid Characters:

  • Blanks
  • Single quotation marks
  • z/OS: Non-English characters
  • "$", "/", "*", "?", " " .

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.

Length:1-4000 characters

Case Sensitive: Yes

Order Method

Defines the method for ordering the entity as one of the following:

  • Automatic (Daily): When set to Automatic, at the same time each day (known as New Day time), each Control-M/Server runs a procedure called New Day. This procedure performs a number of tasks, including scheduling the day’s Jobs, and running maintenance and cleanup utilities. The New Day procedures orders the Folder or Folder Jobs.
  • None (Manual Order): The Folder is not automatically ordered.
  • Specific User Daily: Identifier used to assign the Folder to a specific User Daily Job. The User Daily name is ordered at a specific time of the day. For load balancing purposes, the User Daily Jobs are scheduled for different times, throughout the day, other than the New Day time.

 

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.

Length:

  • 1-30 characters
  • z/OS: 1-8 characters

Case Sensitive: Yes

Invalid Characters:

  • Blanks
  • Single quotation marks

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.

Length: None

Case Sensitive: Yes

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.

Length: 1-64 characters

Case Sensitive: Yes

Invalid Characters:

  • Blanks
  • Single quotation marks

Site Standard

Applies the defined Site Standard to the Folder and all Jobs contained in the Folder. For more information on Site Standards, see Administrative regulations.

If only one Site Standard exits, it is selected by default. If there are no Site Standards defined, it is set to None.

Contact your Control-M Administrator

Business Parameter

Defines one or more Business parameters, according to the Site Standard you have selected. For more information on Business parameters, see Administrative regulations.

If the Site Standard field is set to None, there are no Business parameters displayed.

Contact your Control-M Administrator

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.

Length:

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

z/OS:

  • Name: 1-66
  • Value: 1-66

Created By

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

(not z/OS Folders)

Length: 1-64 characters

Case Sensitive: Yes

Invalid Characters:

  • Blanks
  • Single quotation marks

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 whether the documentation for an OS Job is in a file or URL. The format starts with "http://", "ftp://", or "file://".
  • File: Specifies the file that contains the Job script.

URL Length:

Combines the length of Doc Member/Doc File/Doc Library/Doc Path

File length: 1-64

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.

Length:

  • Microsoft Windows and UNIX: 1-255 characters
  • iSeries (AS/400): 1-21 characters
  • OpenVMS: 1-60 characters
  • z/OS: 1-44 characters

Case Sensitive: Yes

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.

Length:

  • 1-64 characters
  • z/OS: 1-8 characters

Case Sensitive: Yes

Invalid Characters:

  • Blanks
  • z/OS: Non-English characters

Priority

Determines the order of Job processing by Control-M.

 

Parent Topic

Job types