Previous Topic: ExamplesNext Topic: XQ Usage Notes


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 lets you update the status of those jobs. 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. You can also transfer from any of these panels to the XRST panel when 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 a job name sequence.

XQN

Lists the jobs in a CA 7 job number sequence.

XQM

Lists the jobs in a job name sequence with a requirements summary. LIST=ANY is the default for XQM. This value 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 the QM.1 CPU Jobs Status Prompt panel.

This command has the following format:

{XQ|XQJ|XQN|XQM}[,FILL=function]
                [,{JOB={*|jobname|jobnumber|mask}|JOBL={*|longjobname|mask}}]
                [,LIST=options]
                [,Q={REQ|RDY|ACT}]
                [,SEQ={ENTRY|NUMBER|JOBNAME}]
                [,SYS={*|systemname|mask}]
XQ

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

XQJ

Lists the jobs in a job name sequence.

XQN

Lists the jobs in a job number sequence.

XQM

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

FILL

(Optional) Identifies the character to insert in the function fields when the formatted panel is initially displayed. This option facilitates performing the same function for many jobs. For more information about 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 you want to list information from the request, ready, and active queues. JOB and JOBL are mutually exclusive.

*

Indicates all jobs. This value is the default.

jobname

Indicates a specific job name.

Limits: 1 to 8 alphanumeric characters

jobnumber

Indicates a specific job number or a range of job numbers that are specified as nnnn-nnnn.

Limits: 1 to 4 numeric characters

mask

Specifies all job names matching the mask pattern.

JOBL

(Optional) Indicates the jobs for which you want to list information from the request, ready, and active queues.

*

Indicates all jobs.

longjobname

Indicates a specific long job name.

Limits: 1 to 64 alphanumeric characters

mask

Specifies all long job names matching the mask pattern.

Note: Listing by job name using the JOBL keyword returns and displays the regular, eight-character job names in alphabetic order of the long job name. This process sometimes causes the listed job names to appear as out of order.

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 to list jobs.

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 in which to list the jobs. You can use this option to change the default sequence for the XQM command (default is the job name sequence).

ENTRY

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

JOBNAME

Lists the jobs in a job name sequence.

NUMBER

Lists the jobs in a CA 7 job number sequence.

SYS

(Optional) Specifies to list jobs that are associated to a system.

*

Indicates all jobs regardless of the 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.

More information:

Masking

QM.1 CPU Jobs Status Prompt Panel