OS/400 External Job

OS/400 External jobs are a subset of the OS/400 Full job, which enables you to define and execute external jobs. External jobs are submitted to the operating system externally by another job scheduler or process, while Control-M attaches to that job and monitors it until completion. This job type enables attaching to an external job or an active subsystem.

The following table describes the OS/400 External Job and External Subsystem attributes:

Attribute

Description

External Job or External Subsystem

Defines the name of the job to run as External Job or External Subsystem.

  • When selecting External subsystem, the Run as field is set to QSYS and all other attributes are disabled for input.

  • All attributes listed below apply to an External Job type only.

Job status

Enables you to select the job status as follows:

Values:

  • Any Job's status
  • Active
  • Job queue
  • Output queue

Duplicate Job option

Enables you to select an option if more than one External Job matches the External Job attributes (Job name, owner, and job status):

  • Error: Do not attach the External Job. The Control-M job ends NOTOK with an appropriate error message (Default)
  • First Job: Take the first job (time based) that matches the External Job attributes
  • Last Job: Take the last job (time based) that matches the External Job attributes

Release Job

Enables you to release the job from JOBQ when the job is attached to Control-M.

If the job could not be released, a message is logged in the Control-M/Agent log. However, the job is attached to Control-M.

Move to Job Queue

Defines the name of a job queue to move a job to, when a job is attached to Control-M.

If a job cannot be moved, a message is logged in the Control-M/Agent log. However, the job is attached to Control-M.

Library

Defines the name of the library where the job queue resides.

Change job command

Specifies any OS/400 CHGJOB command keyword and value to set the job when the job is attached to Control-M.

The following format is used:

Keyword1(value1) ... Keywordn(Valuen)

EXAMPLE:

  • RUNPTY(77) LOG(4 00 *SECLVL) LOGCLPGM(*NO)

If the job could not be changed, a message is logged in the Control-M/Agent log. However, the job is attached to Control-M.

Set accounting code

Specifies the accounting code to set the job, when the job is attached to Control-M.

A maximum of 15 characters accounting code can be specified.

If the accounting code is not set for a job, a message is logged in the Control-M/Agent log. However, the job is attached to Control-M.

MSGW auto reply profile (MSGWPRF)

Must be the name of an existing MSGW auto reply profile file that is located in the Agent Data directory

Spooled files handling profile (RPTDSTPRF)

Must be the name of an existing Spooled files handling profile file that is located in the Agent Data directory.

Bypass Job

The job does not run and the following message is generated in the job output:

Job was bypassed

Skip validity checks for this job

Enables you to skip validity checks for all fields.