OS2200 parameters

The following table describes OS2200 parameters:

Parameter

Description

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.

Job Name

Defines the name of the job processing definition and appears in the job definition and tracking displays, and enables you to identify the job, and order the job.

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.

What

What to run:

  • Runstream: Indicates that the job executes an existing operating system runstream.
  • Embedded Script: Indicates that the job executes the run stream embedded within the Control-M job definition.
  • Command: Indicates that the job executes an operating system command line.

Embedded Script

Defines a script exactly as it would be specified in a terminal for the specific computer and is part of the job definition.

Run as

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

Account ID

Optional. Specifies the desired account ID to be set on the runcard of the job.

Qualifier

Mandatory. Indicates the qualifier name of the job runstream location.

File

Mandatory. Specifies the file name of the job runstream location.

Cycle

Optional. Defines the cycle number of the file.

Default: 1

Element

Optional. Specifies the element name within the file which contains the job runstream location.

Version

Optional. Indicates the version of the element.

Overriding Qualifier

Optional. Specifies a temporarily-modified qualifier name of the job runstream location without changing the original.

Command line

Mandatory. Indicates the command line entry, if this is a Command type of job.

Pre-command

Optional. Determines the command line instruction to be executed before the specified command line.

Post-command

Optional. Determines the command line instruction to be executed after the specified command line.

Priority

Optional. Determines the job's OS2200 processing priority.

Options

Optional. Specifies the options to be set with the @START command.

Run ID

Optional. Indicates the desired run ID to be set on the runcard of the job.

Default: order_ID run_Number

Project ID

Optional. Defines the desired project ID to be set on the runcard of the job.

Do not use @SYM and

@BRKPT in job wrapper

Indicates that an additional @SYM and @BRKPT will not be added to the job’s wrapper.

  • Checked: There is no additional @SYM or @BKRPT redirection statements besides the ones contained by the job’s JCL. The output will be written only if MULTIPLE_SYM is set to Y or Y-ALL (Equivalent to Printout data to include in output is set to All job printouts. The printouts can be retained or not retained). See Multiple SYM options.
  • Cleared: (Default) The job’s wrapper will include @BRKPT and @SYM redirection to the queue of the user id under which the job is executing.

Use original runcard from user job runstream

Uses the runcard as specified in the job runstream

in the job wrapper. Default: unchecked

Use Run id from autoedit variable or job's runstream

Uses the run Id on the job runcard on submission, based on the value of the Run Id field, or based on the run Id as specified on the original job's runstream runcard.

Equivalent: USER-RUNIDS

Allow job submission under different owner

Runs the job under the specified user Id via the @START,/U option.

Analyze and translate

variables in job

runstream

Parses user runstream content and resolve any

specified variables. Default: unchecked

Equivalent: RUNSARG

Inc.job bkp.output

Includes user runstream’s @SYM or @BRKPT parts in output.

Default: Default

  • Default: The default value as set by the MULTIPLE_SYM configuration parameter
  • Yes, and delete all output
  • No, and retain job output
  • Yes, and retain all output
  • No, and retain all output

Do not set job owner to job wrapper on submission

Does not set the job wrapper’s owner to the specified user. Default: unchecked

Equivalent: SKIPCHGOWN

Perform account validation before submission

An option to validate the specified account before allowing submission. Default: unchecked

Bypass checking of the status file indicator

Bases the job completion and exit code solely on the job’s completion statistics.

Do not run user job via

@ADD in job wrapper

Executes user job content as is. Default: unchecked

Set Condition

Specifies a positive octal number to be placed in T2 of the condition word of the run being scheduled.

Pages

Indicates the estimated number of printed pages expected as output from the run.

Run time

Indicates the estimated run time in standard units of processing (SUP). This is roughly equivalent to minutes, or use a leading 'S' to set seconds.

Deadline

Indicates the elapsed time since run submission or the time of day (Dhhmm) when a run must complete, based on a 24-hour clock.

Cards

Indicates the estimated number of cards expected as output from the run.

Start time

Indicates the earliest time when a run can be processed. The format of this value is the same as for DEADLINE.

Parent Topic

Job types