JBS DEFINE (Single, Job-related)

This command defines Binding Agents and their attributes that must be activated from a job by using control statements. Such Binding Agents are known as job-related Agents. Job-related Binding Agents are activated by a particular job and expire at the end of the job, unless deactivated earlier.

Scope: JES2 Node

Duration: Until deleted or the Control File is reformatted.

JBS DEFINE JBS DEF

[? | HELP] agent-name JOBRELATED [attr] agent-name JOBRELATED [attr] NOTE(note) agent-name JOBRELATED [attr] PANEL(id) agent-name JOBRELATED [attr] NOTE(note) PANEL(id)

Requests the command syntax from HELP.

The name of the Binding Agent. It must be a one to two level name. The valid characters to form a name follow the same rules as a data set name, but only two levels are allowed.

If the Agent has already been defined, the operator is informed. No action is taken.

Indicates that the Agent being defined must be activated by a running job with control statements contained in the job's JCL.

The short form of this keyword is JOB.

attr

Can be one or more of the following attributes:

• CATEGORY(n | name)- Specifies an Incompatibility Category for the Agent.
• n - Is a single decimal digit from the range 1-9, indicating the Incompatibility Category for the Agent.
• name - Is a name consisting of 1-8 alphabetic, numeric, or national characters, identifying the Incompatibility Category for the Agent.
• LOG - Requests that all activates and deactivates requested by a job for this Agent be recorded in the system log.

• MULTIPLE - Indicates that this job-related Binding Agent can be activated more than once in a MAS complex:

  • Once per system if activated with the LOCAL attribute.
  • Once in the MAS complex if activated with the GLOBAL attribute.

  This keyword is mutually exclusive with UNIQUE.

• UNIQUE - Indicates that a job can activate this job-related Binding Agent only once in a MAS complex, regardless of its activation attribute of GLOBAL or LOCAL. Jobs activating this Agent are therefore serialized.
  This keyword is mutually exclusive with MULTIPLE.

Allows you to add a note to the Agent. The note is displayed with the DETAILS keyword of the JBS DISPLAY command.

• note - 1-32 characters of notes. If the note is longer than 32 characters, it is truncated.

Allows you to add the identifier for an ISPF panel that can be invoked to display installation- defined information when using the UDF facility.

• id - Is a valid ISPF panel identifier.