Previous Topic: ExamplesNext Topic: XQ Usage Notes


More information:

Masking

QM.1 CPU Jobs Status Prompt Panel

XQ, XQJ, XQN, and XQM Commands

The XQ, XQJ, XQN, and XQM commands result in the display of jobs in the request, ready or active queues and allow the status of those jobs to be updated. The CANCEL, HOLD, RELEASE, and REQUEUE command functions, in addition to others, can also be performed on the XQ, XQJ, XQN, and XQM panels with a single function character. It is also possible to transfer from any of these panels to the XRST panel if a job requires a restart. These commands are valid only from online 3270 type terminals. Each command provides a different display sequence as follows:

XQ

Lists the jobs in the order in which they occur in the queue.

XQJ

Lists the jobs in job name sequence.

XQN

Lists the jobs in CA Workload Automation SE job number sequence.

XQM

Lists the jobs in job name sequence with a requirements summary. (LIST=ANY is the default for XQM. This is different from the other XQ panels where LIST=ALL is the default.)

Some requirements can be satisfied directly on these panels. Control can also be passed to other panels such as XRQ and XUPD, from which control functions can be performed.

This function is available through QM.1 CPU Jobs Status Prompt panel.

This command has the following format:

►►─┬─ XQ ──┬─┬──────────────────┬─┬─────────────────────────┬─────────────────►
   ├─ XQJ ─┤ └─ ,FILL=function ─┘ └─ ,JOB= ─┬─ * ◄ ───────┬─┘
   ├─ XQN ─┤                                ├─ jobname ───┤
   └─ XQM ─┘                                ├─ jobnumber ─┤
                                            └─ mask ──────┘

 ►─┬─────────────────┬─┬───────────────────┬─┬───────────────────────┬────────►
   └─ ,LIST=options ─┘ └─ ,Q= ─┬─ REQ ◄ ─┬─┘ └─ ,SEQ= ─┬─ ENTRY ───┬─┘
                               ├─ RDY ───┤             ├─ NUMBER ──┤
                               └─ ACT ───┘             └─ JOBNAME ─┘

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

Lists the jobs in the order in which they occur in the queue.

XQJ

Lists the jobs in job name sequence.

XQN

Lists the jobs in CA Workload Automation SE job number sequence.

XQM

Lists the jobs in job name sequence with a requirements summary.

FILL

(Optional) Identifies the character to be inserted in the function fields when the formatted panel is initially displayed. This option facilitates performing the same function for many jobs. For a discussion of the available values for FILL and how they are used, see the QM.1 CPU Jobs Status Prompt Panel.

JOB

(Optional) Indicates the jobs for which information is to be listed from the request, ready, and active queues.

*

Indicates all jobs. This value is the default.

jobname

Indicates a specific job name.

Limits: 1 to 8 alphanumeric characters

jobnumber

Indicates a specific CA Workload Automation SE job number or a range of job numbers specified as nnnn-nnnn.

Limits: 1 to 4 numeric characters

mask

Specifies all job names matching the mask pattern.

LIST

(Optional) Specifies the outstanding requirements selection criteria.

ALL

List all jobs regardless of outstanding requirements. This value is the default for XQ, XQJ, and XQN.

ANY

List only those jobs with at least one requirement. This value is the default for XQM.

BINT

List only those jobs that have internal data set requirements, but no unsatisfied job requirements.

EXT

List only those jobs with external data set requirements.

HLD

List only those jobs with a hold requirement.

INT

List only those jobs with internal data set requirements.

JCLO

List only those jobs with a JCL override requirement.

JOB

List only those jobs with job requirements.

NWK

List only those jobs with network requirements.

REST

List only those jobs in restart status.

SKEL

List only those jobs in skeleton status.

SUB

List only those jobs with submit-time requirements.

USR

List only those jobs with user requirements.

VER

List only those jobs with a verify requirement.

Q

(Optional) Identifies the queue for which jobs are to be listed.

REQ

Specifies the request queue. This value is the default.

ACT

Specifies the active queue.

RDY

Specifies the ready queue.

SEQ

(Optional) Indicates the sequence that the jobs should be listed in. You can use this option to change the default sequence for the XQM command (default is job name sequence).

ENTRY

Lists jobs in the order in which they occur in the queue.

JOBNAME

Lists jobs in job name sequence.

NUMBER

Lists jobs in CA Workload Automation SE job number sequence.

SYS

(Optional) Specifies jobs associated to a system should be listed.

*

Indicates all jobs regardless of system name. This value is the default.

system

Indicates only list jobs having this system name.

mask

Indicates only list jobs whose system matches the mask pattern entered.