Previous Topic: /XTASK ExamplesNext Topic: ADDRQ Usage Notes


ADDRQ Command

The ADDRQ command manually adds temporary, one-time, preexecution user or predecessor job requirements. These requirements must be added to the job while it is in the CA WA CA 7 Edition request queue. These added requirements apply only to the current run of the job. You must manually satisfy user requirements with the QM.2 panel (POST) or XRQ command before the job executes. Predecessor job requirements are satisfied automatically when the predecessor job completes successfully.

This command has the following format:

ADDRQ,{JOB={jobname|jobnumber}|JOBL=longjobname},{DEPJOB=depjob|USR=text}
JOB

Defines the job to which you want to add the job requirement. The job must be in the request queue. JOB and JOBL are mutually exclusive.

jobname

Defines the job name to which you want to add the requirement for this run of the job.

Limits: 1 to 8 alphanumeric characters

jobnumber

Defines the CA 7 job number to which you want to add the requirement for this run of the job.

Limits: 1 to 4 numeric characters

JOBL

(Optional) Defines the long job name to which you want to add the job requirement. The job must be in the request queue. JOB and JOBL are mutually exclusive. You cannot enter a job number on the JOBL keyword.

Limits: 1 to 64 characters

DEPJOB

Defines a temporary one-time job dependency requirement. The DEPJOB value specifies the job name that must complete execution or be manually posted complete before the job identified by JOB is eligible for submission. DEPJOB is required unless USR is used, in which case, omit DEPJOB. This requirement is satisfied automatically when the predecessor job completes. Only in unusual situations would this requirement need to be satisfied manually. That is, any time that a normal completion did not occur.

Limits: 1 to 8 alphanumeric characters

Required: Yes, unless USR is used.

USR

Defines the description of a temporary, one-time user requirement. This requirement must be manually satisfied before the job identified by JOB is eligible for submission. If any commas are included as part of the text, enclose the entire requirements text in parentheses. USR is required unless DEPJOB is used, in which case, omit USR.

Limits: 1 to 36 alphanumeric characters

Required: Yes, unless DEPJOB is used.