Previous Topic

Next Topic

Book Contents

Book Index

Order Job

The Order Job parameter forces an individual job or all jobs in a folder to be placed in the Active Jobs file (regardless of each job’s Scheduling criteria) when the On Statement/Code criteria are satisfied.

Order Job causes the specified job to be placed immediately in the Active Jobs database. The job is submitted for execution as soon as all its submission criteria are satisfied.

Additional information

Description

Usage

Optional

Format

Select Order Job from the Do list box. The Folder, Job Name, and Date text boxes are displayed.

These sub-parameters are described below.

Variable Support

None

Alternate names

  • Control‑M/EM Utilities: FORCEJOB
  • Reporting Facility: (none)
  • Control‑M/Server Utilities: ‑forcejob
  • Control‑M for z/OS: FORCE JOB
  • Control‑M/EM API: force_job

Alternate formats

Control‑M/EM Utilities

FORCEJOB consists of the DSN, FOLDER_NAME, NAME, and ODATE sub-parameters. The value of DSN is the Folder Library name, which must be specified for z/OS jobs.

EXAMPLE: <FORCEJOB DSN="z/OS.FLD" FOLDER_NAME="fld1" JOB="Job3" ODATE="DATE"/>

Control‑M for z/OS

ORDER JOB consists of the FOLDER, NAME, and LIBRARY sub-parameters. The value of DSN is the Folder Library name, which must be specified for z/OS jobs.

Sub-parameters

Folder

Name of the job folder

Length

1 through 20 characters

Invalid Characters

Blanks; single quotation marks

OS/900: Non-English characters

Job Name

Job name. If this field is blank, all jobs in the specified folder are forced.

Length

  • Computers other than z/OS: 1 through 64 characters.
  • z/OS: 1 through 8 characters.

Invalid Characters

Blanks (embedded); single quotation marks

Date

Value to be used as the original scheduling date for the job. Valid values are:

ODAT

Resolves to the original scheduling date of the job resulting in the execution of this parameter (default).

NOTE: As of Control-M/Server version 6.1.03, ODAT can also be specified when modifying details of a job in the Active Jobs database.

date

A date reference, 4 or 6 characters long (either mmdd, ddmm, yymmdd, or yyddmm format, depending on the site standard).
z/OS: Only the yymmdd or yyddmm format can be used

NOTE: When Order Job forces a job that belongs to a SMART Folder, it treats it as a regular job and forces it alone (that is, without a SMART Folder)

Parent Topic

On/Do Actions