Previous Topic: LRDYR ExamplesNext Topic: LREQ Examples


LREQ Command

The LREQ command lists job information from the request queue for jobs that have been scheduled into the queue, but still have preexecution requirements that must be satisfied before the job can execute. Jobs that have completed successfully return temporarily to the request queue for job completion processing. Jobs that run and abnormally terminate are also returned to this queue to await restart by the user.

The LIST command has more information about displaying jobs waiting for a restart.

This command has the following format:

►►─ LREQ ─┬───────────────────────┬─┬──────────┬──────────────────────────────►
          └─ ,AGENT= ─┬─ * ◄ ───┬─┘ └─ ,CLS=x ─┘
                      ├─ agent ─┤
                      └─ mask ──┘

 ►─┬───────────────────────┬─┬─────────────────────────────┬──────────────────►
   └─ ,CPUID= ─┬─ * ◄ ───┬─┘ └─ ,DRCLASS= ─┬─ * ◄ ───────┬─┘
               ├─ smfid ─┤                 ├─ @ANY ──────┤
               └─ mask ──┘                 ├─ @NONE ─────┤
                                           ├─ drclass ───┤
                                           └─ mask ──────┘

 ►─┬──────────────────────┬─┬─────────────────────────┬───────────────────────►
   └─ ,DRMODE= ─┬─ * ◄ ─┬─┘ └─ ,JOB= ─┬─ * ◄ ───────┬─┘
                ├─ YES ─┤             ├─ jobname ───┤
                └─ NO ──┘             ├─ jobnumber ─┤
                                      └─ mask ──────┘

 ►─┬───────────────────────┬─┬─────────────────────────┬──────────────────────►
   └─ ,LIST= ─┬─ AGJOB ──┬─┘ └─ ,NODE= ─┬─ * ◄ ──────┬─┘
              ├─ ALL ────┤              ├─ nodename ─┤
              ├─ CPU ────┤              └─ mask ─────┘
              ├─ JCL ────┤
              ├─ PRM ────┤
              ├─ PROS ───┤
              ├─ Q ──────┤
              ├─ RQMT ───┤
              ├─ STATUS ─┤
              └─ XPJOB ──┘

 ►─┬─────────────────────┬─┬───────────────────────────────────┬──────────────►
   └─ ,SCHID= ─┬─ 0 ◄ ─┬─┘ └─ ,SEG= ─┬─ xxxxxxxx ────────────┬─┘
               └─ nnn ─┘             └─ (xxxxxxxx,yyyyyyyy) ─┘

 ►─┬────────────────────────┬─┬──────────────┬────────────────────────────────►
   └─ ,SEQ= ─┬─ NATV ◄ ───┬─┘ └─ ,ST=option ─┘
             └─ sequence ─┘

 ►─┬──────────────────────────┬───────────────────────────────────────────────►◄
   └─ ,SYS= ─┬─ * ◄ ────────┬─┘
             ├─ systemname ─┤
             └─ mask ───────┘
AGENT

(Optional) Indicates an agent name or mask that an agent name must match before its information is selected for display.

Default: * (all agent names)

Limits: 1 to 16 characters

CLS

(Optional) Specifies the CA Workload Automation SE Workload Balancing class of jobs to select. If omitted or CLS=*, all classes are selected for display.

Limits: 1 alphanumeric character

CPUID

(Optional) Defines the CPU ID name or mask that a CPU ID must match before its information is selected for display. For agent jobs, use AGJ. For XPJOBs use 7XPJ.

Note: The CPU ID is not filled in until CA Workload Automation SE has processed a job initiation record.

Default: * (all CPU IDs)

Limits: 1 to 8 characters

DRCLASS

(Optional) Defines the disaster recovery class name, a reserved name, or mask that a disaster recovery class name must match before its information is selected for display.

Limits: 1 to 8 characters

Default: * (all disaster recovery class names)

@ANY

Specifies that jobs with any DRCLASS should be selected.

@NONE

Specifies that jobs with no DRCLASS should be selected.

DRMODE

(Optional) Indicates the class of jobs to select.

*

Specifies all jobs. This value is the default.

YES

Indicates to select only jobs that entered the request queue while CA Workload Automation SE was in Disaster Recovery mode.

NO

Indicates to select only jobs that entered the request queue while CA Workload Automation SE was not in Disaster Recovery mode.

JOB

(Optional) Defines the job number, job name, or mask that a job name must match before its information is selected for display.

Default: * (all jobs)

Limits: 1 to 8 characters

LIST

(Optional) Specifies the amount of queue information requested.

AGJOB

Indicates agent information only.

ALL

Indicates all data related to the jobs.

CPU

Indicates only CPU jobs.

JCL

Indicates JCL information only.

Depending on certain security options selected for your installation, the following values may be concealed in the display:

  • JOB statement USER keyword
  • JOB statement GROUP keyword
  • JOB statement PASSWORD keyword
  • //*LOGONID statement
  • //*PASSWORD statement
  • //*JOBFROM statement
PRM

Indicates internal cross-platform PARMLIB information only.

PROS

Indicates documentation information only.

Q

Indicates job data only.

RQMT

Indicates all requirement information only.

STATUS

Indicates unsatisfied requirement information only.

XPJOB

Indicates internal cross-platform information only.

When LIST is not specified, a default display consisting of a single description line for each queue record is listed. However, when a specific job is requested by the JOB parameter, the default is LIST=STATUS and all unsatisfied job requirements are listed. If SEG is specified, the default is LIST=PROS.

NODE

(Optional) Defines the node name or mask that a node name must match before its information is selected for display.

Default: * (all node names)

Limits: 1 to 8 characters

SCHID

(Optional) Specifies the schedule ID for which information is to be selected.

Default: 0 (all schedule IDs)

SEG

(Optional) Specifies a segment and subsegment of documentation to be listed. If a subsegment, use the form (xxxxxxxx,yyyyyyyy).

xxxxxxxx

Defines the name of a segment.

Limits: 1 to 8 alphanumeric characters

(xxxxxxxx,yyyyyyyy)

The names of a segment (xxxxxxxx) and subsegment (yyyyyyyy) enclosed in parentheses and separated by a comma.

Limits: 1 to 8 alphanumeric characters each

SEQ

(Optional) Controls the display sequence of the selected information.

NATV

Indicates native sequence (the order in which it is in the queue). NATV is the default.

AGENT

Indicates agent name sequence.

CA7

Indicates CA Workload Automation SE job number sequence.

DLTM

Indicates deadline time sequence.

DOTM

Indicates due-out time sequence.

JOB

Indicates job name sequence.

NODE

Indicates node name sequence.

ST

(Optional) Specifies the display criteria for the queue information. If omitted, displays all jobs in the request queue.

ABND

Indicates only the jobs that are in abend status.

AGENT

Indicates only agent jobs that encountered a problem with the agent.

ARAE

Indicates only jobs that encountered an ARF attach error.

ARF

Indicates only jobs that are being tracked by ARF.

ARFH

Indicates only jobs that are in ARF recovery status.

ARFJ

Indicates only ARF recovery jobs (entry mode=ARFJ).

CBAD

Indicates only the jobs that are in bad completion code status.

COMP

Indicates jobs that have completed successfully and are waiting for CA Workload Automation SE completion processing.

HELD

Indicates jobs in hold status.

JCLO

Indicates jobs requiring JCL or PARM overrides.

JCLR

Indicates that are in JCL or PARM error status.

LATE

Indicates late jobs.

MANV

Indicates jobs requiring manual verification.

MJOB

Indicates jobs containing multiple JOB statements status.

NODE

Indicates only internal cross platform jobs that encountered a node problem.

NOID

Indicates only the jobs that are in security error status.

REQU

Indicates only the jobs that are in requeue status.

RSTR

Indicates jobs requiring restart.

RTRY

Indicates only the jobs that are in retry status.

SKEL

Indicates only the jobs that are in skeleton status.

SYS

(Optional) Defines the system name or mask that a system name must match before its information is selected for display.

Default: * (all system names)

Limits: 1 to 8 characters

More information:

Masking

LIST Command