Creating a Job

This procedure describes how to create a job in a folder or sub-folder in your WorkspaceA working area in the Planning domain where you define and edit new jobs and SMART folders..

Begin

From the Center Pane Toolbar, click Add Job and from the drop-down list, drag and drop the job typeThe type of the job, such as an OS Job that executes at the operating system level or integrations that run on third-party applications, such as AWS, Azure, and Control-M for Databases. into a folder or sub-folder within the Workspace.

For a list of all available job types, see Job Types.
From the Edit tab, define one or more of the following:
- General: Defines information about the job, as described in Job General Attributes.
- Scheduling: Defines scheduling attributes for the job, as described in Job Scheduling Attributes.
- Prerequisites: Defines the prerequisitesThe part of the job definition that controls the flow of your jobs, such as an event that controls flow sequence or a resource that controls load balancing. required for the job to run, as described in Prerequisites.
- Actions: Defines the actions that Control-M performs after the job has executed, as described in Actions.

Job General Attributes

The following table describes the General attributes for a job:

Attribute	Description
Job Type	Determines the job type selected from the drop-down list.
Job Name	Defines the name of the job. Rules: Characters: 1–64 Case Sensitive: Yes Invalid Characters: ' (apostrophes), $ (dollar signs), / (forward slashes), * (asterisks), and ? (question marks). Variable Name: %%JOBNAME The name of a job must be unique within each folder. The job cannot have the same name as the parent folder or sub-folder. To include a parenthesis -) or (- precede it with a slash: /( or /).
Description	Defines a description of the job using free text. Rules: Characters: 1–4,000 Case Sensitive: Yes
Run as Dummy	Runs as a dummy job, and not as a Dummy job type. A job that is set to Run as Dummy is not submitted by Control-M/Server and only performs post processing actions. On: Runs as a dummy job Off: Runs according to job type
Server	Indicates the name of the Server that processes the job.
Host /Host Group	Defines the name of an AgentA Control-M component installed on a host (computer) that runs and monitors the jobs on the host. computer, Remote Host, or host group where the job is submitted. Rules: Characters: 1–50 Valid Characters: A–Z, a–z, 0–9, and the following special characters: - (hyphens), , (commas),. (periods), _ (underscores), and : (colons). Invalid Characters: Latin-1 special characters (uppercase and lowercase).
Parent Folder	Defines the name of the parent folder or parent folder and sub-folder.
Application	Defines a descriptive name for related job groups. Jobs do not have to run at the same time. Rules: Case Sensitive: Yes Invalid Characters: Blanks, and ' (apostrophes). Variable Name: %%APPLIC For more information, see Application and Sub-application Variables
Sub-application	Defines a logical name for the Sub-application. Rules: Characters: 1–64 Case Sensitive: Yes Invalid Characters: Blanks, and ' (apostrophes). Variable Name: %%APPLGROUP For more information, see Application and Sub-application Variables Application = Finance, and Sub-application = Payroll.
Variables	Determines variable types, names, and values, as described in Variables. Rules: Characters: 1–40 Value: 1–4,000 Invalid Characters : Latin-1 special character letters (uppercase and lowercase) If you include %% in the value for a job definition attribute, Control-M treats this as a variableA memory location with a name and value that you can reference in your job processing definitions, which Control-M resolves for the current job execution..
Advanced
Override Path	Defines a temporarily-modified job script file without changing the original script file in the File Path and without changing the run schedule of a folder. Rules: Characters: 1–255 Case Sensitive: Yes Invalid Characters: Blanks. If the job runs on any version of Microsoft Windows 2000, prohibited filename characters: \ (backslashes), / (forward slashes), * (asterisks), ? (question marks), < (less than), > (greater than), and \| (vertical bar or pipe). Variable Name: %%OVERLIB
Pre-execution Command	Defines a command that runs immediately before running the job. The return code is ignored. Characters: 1–4,000 Variable Name: %%PRECMD
Post-execution Command	Defines a command that runs immediately after running the job. The return code is ignored. Characters: 1–4,000 Variable Name: %%POSTCMD
Run Job on All Hosts in Group	Determines whether Control-M runs the job on all Agents within the Host Group. All available Agents in the Host Group run an identical job, and each such job has a unique run IDThe identification code for a SMART folder, sub-folder, or job execution.. On: The job runs on all Agents within the Host Group. Off: The job runs only on the current Agent.
End Folder on Job Completion	Determines whether Control-M stops executing jobs and sub-folders in the folder. To enable this option, you must have full User Views set in User and Role Authorizations.
Created By	Defines the Control‑M user who created the job. Rules: Characters: 1–64 Case Sensitive: Yes Invalid Characters: Blanks, and ' (apostrophes).
Documentation	Defines the location of the documentation of the folder.
Type	Determines whether the documentation for the job is in a file or URL, as follows: URL: Saves the documentation in the URL that you provide in the URL field. The format of the URL address must start with http://, https://, ftp://, or file://. File: Saves the documentation in a file that you specify in the Doc Path and Doc File fields. Doc Path Rules: Characters: 1–255 Case Sensitive: Yes Doc File Rules: Characters: 1–64 Case Sensitive: Yes Invalid Characters: Blanks
Priority	Determines the order that Control-M processes jobs. A higher priority forces Control-M to reserve resources from the Resource PoolA type of quantifiable resource, which represents the total amount of resources from a physical or logical device that a job can access. to ensure that the job is submitted as soon as possible.
Critical	Determines whether the job is a critical-path job in Control-M. This ensures a resource allocation order.