Previous Topic: LPRRN ExamplesNext Topic: LQ Examples


LQ Command

The LQ command lists information about jobs from the request, ready, and active queues. The queue information provided shows the status on all production activity known to CA Workload Automation SE. This command is helpful in determining the queue in which a job currently resides.

This command has the following format:

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

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

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

 ►─┬────────────────┬─┬─────────────────────────┬─────────────────────────────►
   └─ ,LIST=option ─┘ └─ ,NODE= ─┬─ * ◄ ──────┬─┘
                                 ├─ nodename ─┤
                                 └─ mask ─────┘

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

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

 ►─┬──────────────────────────┬─┬───────────────────┬─────────────────────────►◄
   └─ ,SYS= ─┬─ * ◄ ────────┬─┘ └─ ,TZ= ─┬─ CA7 ──┬─┘
             ├─ systemname ─┤            └─ EXEC ─┘
             └─ 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

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

NO

Specifies 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 internal cross-platform agent information only.

ALL

Indicates all data related to the jobs.

CPU

Specifies only CPU jobs.

JCL

Indicates JCL information or internal cross-platform parameter data for cross-platform job types.

Depending on the security options your installation selected, the following JCL 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 or JCL information for CPU jobs. For more information, see the JCL parameter.

PROS

Indicates a documentation information only.

Q

Indicates a job data only.

RQMT

Indicates all requirements information only. This information can include a possible ARF message.

STATUS

Indicates unsatisfied requirements information only.

XPJOB

Indicates internal cross-platform XPJOB information only.

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

Note: If RQMT or STATUS is specified, VRM requirements are listed for jobs in the ready queue with a status of W-RSRC.

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 the segment.

Limits: 1 to 8 alphanumeric characters

(xxxxxxxx,yyyyyyyy)

Defines the name 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, ready, and active queues.

Default: All jobs in the request, ready, and active queues

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 jobs are in JCL or PARM error status.

LATE

Indicates late jobs.

MANV

Indicates jobs requiring manual verification.

MJOB

Indicates jobs requeued because of multiple JOB statements.

NODE

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

NOID

Indicates only the jobs that are in security error status.

REPLY

Indicates only agent jobs that are waiting for a reply to an Intervention Required message.

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.

SUBM

Indicates jobs that are submitted to the host system for execution.

WRSC

Indicates jobs that are waiting for VRM resources.

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

TZ

(Optional) Controls whether a job's start date/time should be normalized to the time zone of the running CA Workload Automation SE.

Default: Specified by the TZDISPLAY keyword on the SMF initialization file statement.

CA7

Defines that the start date/time should be normalized to the running CA Workload Automation SE time zone.

EXEC

Defines that the start date/time should be in the execution time zone.

More information:

Masking

ARF Information Section Messages