Previous Topic: LQP Usage NotesNext Topic: LQR Examples


LQR Command

The LQR command lists workload balancing information about all job resource requirements from the CA Workload Automation SE queues. The queue information provided shows current resource requirements for each job.

This command has the following format:

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

 ►─┬───────────────────────┬─┬─────────────────────────┬─┬─────────────┬──────►
   └─ ,CPUID= ─┬─ * ◄ ───┬─┘ └─ ,JOB= ─┬─ * ◄ ───────┬─┘ └─ ,LIST=CPU ─┘
               ├─ smfid ─┤             ├─ jobname ───┤
               └─ mask ──┘             ├─ jobnumber ─┤
                                       └─ mask ──────┘

 ►─┬────────────────────────┬─┬─────────────────────────┬─────────────────────►
   └─ ,MAINID= ─┬─ ALL ◄ ─┬─┘ └─ ,NODE= ─┬─ * ◄ ──────┬─┘
                ├─ SYn ───┤              ├─ nodename ─┤
                ├─ /SYn ──┤              └─ mask ─────┘
                └─ -SYn ──┘

 ►─┬─────────────────────┬─┬────────────────────────┬─┬──────────────┬────────►
   └─ ,SCHID= ─┬─ 0 ◄ ─┬─┘ └─ ,SEQ= ─┬─ NATV ◄ ───┬─┘ └─ ,ST=option ─┘
               └─ nnn ─┘             └─ 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

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 to list only CPU jobs. If specified, must be LIST=CPU.

Default: blank

MAINID

(Optional) Specifies that only those jobs with this MAINID (as defined on the DB.1 panel) are to be listed. Jobs defined with MAINID of ALL are selected regardless of MAINID entered.

Limits: MAINID is ignored for XPJOB jobs.

ALL

Specifies all MAINIDs. ALL is the default.

SYn

Where n indicates a CPU assigned number as defined in the initialization file CPU statement for which information is to be listed. (For more information about the initialization file, see the Systems Programming Guide.) The value of n can range from 1 to 7. If a slash (/) precedes the SYn, the only jobs selected are those that are denoted to execute on CPUs other than SYn.

-SYn

Where n indicates a CPU assigned number for which information is not to be listed. The value of n can range from 1 to 7.

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)

SEQ

(Optional) Specifies 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, all jobs in the request, ready, and active queues are displayed.

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

LATE

Indicates late jobs.

MANV

Indicates jobs requiring manual verification.

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

More information:

Masking