Code Reference


Control-M Automation API enables you to manage jobs through JSON code.

The following topics provide code samples that describe how to define Control-M objects using JSON notation:

Control-M objects in JSON code

Each Control-M object begins with a "Name" and then a "Type" specifier as the first property. All object names are defined in PascalCase notation with first letters in capital case. In the examples below, the "Name" of the object is "ObjectName" and the "Type" is "ObjectType".

"ObjectName" : {
"Type" : "ObjectType"
}

The following object types are the most basic objects in Control-M job management:

Object type

Description

Folder

A container of jobs. The following types of folders are available:

  • Regular folder — Groups together a collection of jobs and enables you to configure definitions at the folder level and have these definitions inherited by the jobs within the folder. For example, you can set schedules and manage events, resources, and notifications at the Folder level, to be applied to all jobs in the folder.
  • SubFolder — A folder nested within another regular folder or subfolder. Subfolders offer many (but not all) of the capabilities that are offered by regular folders.
  • Simple folder — Groups together a collection of jobs. Folder definitions are not inherited by jobs within the folder.

You can use a Flow to define order dependency between jobs in a folder.

A business process that you schedule and run in your enterprise environment.

A set of scheduling criteria that you can apply to multiple jobs (instead of having to define scheduling criteria in each individual job).

A set of rules that enable you to control job definition by enforcing restrictions on job parameters.

Site Standard Policies enable you to enforce Site Standards on folders.

Access methods and security credentials for a specific application that runs jobs for an installed plug-in.

Definitions of default parameter values that you can apply to multiple objects, all at once.

Related information

For more information about Control-M, use the following resources.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*