UQ - System Job Queue Display Utility

#### Search Results

Search

# UQ - System Job Queue Display Utility

The Com-plete online utility UQ enables you to obtain system status information.

This document covers the following topics:

- Overview

- Security

- Command Format

- UQ Commands

- UQ Keywords

- Entering Operator Commands (Control User)

## Overview

The specific functions available with UQ are grouped into two categories:

- Display operations;

- Control operations.

### Display Operations

Display operations include combinations of command functions and keyword arguments that permit you to inquire about the status of pending, active, or completed jobs. These operations include:

- Displaying job names and status information for active batch jobs;

- Displaying paging statistics if the system is a pageable system;

- Displaying job names and status information for jobs in the input/output queues;

- Displaying jobs in the input queue;

- Displaying information for jobs in the output queue;

- Displaying status information for the tape units and disk units defined;

- Displaying operator messages including those that require a reply;

- Obtaining a display of the available disk space for all available volumes.

### Control Operations

Control operations include combinations of command functions and keyword arguments that enable you to control the disposition of pending, active, or completed jobs. These operations include:

- Placing jobs in hold status in order to prevent execution or printing;

- Releasing jobs from hold status;

- Canceling job output from the output queue;

- Changing the output class of specific jobs;

- Selectively routing all or portions of the output for a job to a hard copy terminal.

Note
Because UQ can include a user-written exit routine for establishing usage conventions, some of the features described in this section may not function as described or may function in a restricted manner.

## Security

Because the function of UQ enables you to both view and control system job information and job flow, four levels of security have been established in order to guarantee both user control and authorization at the terminal user level. These security levels are:

- Control;

- Com-plete initialization;

- Comment control statements;

- User-written exit.

### Control

Certain functions of the UQ utility are restricted to users with control status. These functions are marked as such in this section.

### Com-plete Initialization

Any user can, by default, normally view and control job output for any job submitted to the operating system for execution. This control is not restricted by terminal, user ID, or control status. Note, however, that this control can be initially restricted at the time Com-plete is initialized.

When Com-plete is initialized, the UQDEFAULT sysparm enables an installation to either:

- Permit any user to view and control all input and output information;

- Disallow all users from viewing and controlling any input or output information.

If this security restriction option is selected, users cannot view any SYSIN or SYSOUT information from the job queue unless the job stream contains UQ comment control statements.

Note
The UQDEFAULT sysparm is described in the Com-plete System Programming documentation.

### Comment Control Statements

UQ recognizes six comment control statements that can be used to restrict the display and control of job input and output to designated users. These comment control statements are summarized in the following figure.

> To restrict job access to the specified user ID(s):

>       //*UQ USERID userid(,userid,...,userid)                  (z/OS)
>       * *UQ                                                    (z/VSE)

> To restrict job access to user IDs having the indicated accounting information:

>       //*UQ ACCOUNT account(,account,...,account)              (z/OS)
>       * *UQ                                                    (z/VSE)

> To restrict job access to user IDs having the indicated auhorization levels:

>       //*UQ AUTHORIZE auth#(,auth#,...,auth#)                  (z/OS)
>       * *UQ                                                    (z/VSE)

> For no restrictions on job access:

>       //*UQ ALLOW                                              (z/OS)
>       * *UQ                                                    (z/VSE)

> For restricting any terminal user to access the job:

>       //*UQ DISALLOW                                           (z/OS)
>       * *UQ                                                    (z/VSE)

> Passes data to the user-written security exit and determines job access security from this data:

>       //*UQ USER ... user determined data ...                  (z/OS)
>       * *UQ                                                    (z/VSE)

Note that in order to be recognized by UQ, all comment control statements must be placed in the job stream after the job statement and before the first EXEC statement. In addition, UQ comment control statements will be ignored if the user does not log on to Com-plete.

The UQ keyword arguments affected by usage of the comment control statements are H, R, C, DE, and S.

If one of these keyword arguments has been initialized and the S command is in effect, the request against a job that contains no comment control statements is allowed or disallowed depending on the setting of the Com-plete sysparm UQDEFAULT. If the selected job contains one or more comment control statements, the job can be accessed by any terminal user that passes at least one condition specified in the control statements.

### User-Written Exit

Some of the features discussed in this section may generate security violation messages. Except for the conditions discussed in this section, security violation messages are caused by implementation of the UQ user-written security exit. For more details on the use and implementation of the UQ security exit, consult the system programmer responsible for Com-plete maintenance.

## Command Format

UQ is a fully conversational program. This means that you do not need to invoke UQ each time you request a new display. You can request a new display conversationally simply by entering a new command. For example, to display the status of the medium drives once you have invoked UQ, you need to enter only the display command "T". You can request functions either at the time you initially invoke UQ, or after invocation.

In addition to the various UQ functions, a set of keyword arguments is available that enable you to tailor the output of the various functions. You can also request these keyword arguments conversationally, either at the time you invoke UQ or after invocation.

Note
Since each keyword argument is designed to augment the use of a specific command, the use of a keyword argument without the appropriate command has no effect on execution of other command functions.

The command format for invoking UQ is:

    *UQ [function][,keyword=value,keyword=value,...]

Note that you can only request one function at any one time. You must enter the function before entering any keyword options, and separate each keyword option from the preceding option (or function) by a comma. If you request a function at the time you invoke UQ, you must separate it from the characters "UQ" by a single space.

### UQ Menu

You can also invoke UQ functions via the UQ menu. To display the UQ menu, simply enter the UQ commands with no operands, as shown below:

    *UQ

The following figure illustrates the UQ menu.

    13:20:06       TID    11           COMPLETE          User SAG          03.07.03
                                                                               UQY2
                           --- System Job Queue display ---

    Function .....................  Fc           Function .....................Fc
    --------------------------------  --         ------------------------------  --
    Active task display ...........  A           Disk Unit status display .....  D
    Job queue display .............  Q           Tape allocation display ......  T
    Selective Job display .........  S           Free space data (OS) .......  V
    Console message display .......  M           List JES datasets (OS) .........  L
    Console action display ........  O

             Please select function

             and keywords for Job/Job queue functions:

    JB: COMTEST2  Job name                       SI:     ..... type of queue info
    DS: 01   .... logical data set nbr           LL: 132  .... line length display
    PP:      .... start display position

In addition to the default functions, COM-PASS allows you to set the JB, DS, LL, SI, and PP keywords as defaults. Note that, except for JB, all keywords set by default will override any user-supplied keywords. Note also that the CANCEL command is not available from the UQ menu.

## UQ Commands

UQ commands are one-character function identifiers. You can execute a command either at the time you invoke UQ, or any time thereafter.

After you enter a command, the last two lines of the display will contain the status of all keyword values including OP. The keyword OP always identifies the current command that is being executed.

For example, the expression "OP=M" indicates that the currently executed command is the M command function (a request for display of all operator messages).

The commands available with UQ and the display that results from their usage are summarized in the following table. The UQ commands are described in detail in the remainder of this section.

Command | Description
--- | ---
A | Displays active tasks (default)
D | Displays disk allocation status
L | List JES datasets for a job (OS only)
M | Displays operator messages
O | Displays operator messages requiring a reply
Q | Displays the input/output job queue
S | Enables the selective display of input or output
T | Displays tape allocation status
V | Displays a volume free space summary (OS only)

Note that if you do not issue a command when you invoke UQ, the A command function is the default.

In addition to the commands listed, there are three control operations that you can request using the Q command function. They are summarized in the following table.

Operation | Description
--- | ---
C | Cancels or purges a job from the input or the output queue
H | Holds a job that is either in the input or the output queue
R | Releases a job that is in hold status

Note
These control operations are available only after execution of the Q command and only if a unique job has been selected by using the JB keyword argument.

### A Command

The A command enables you to display the active tasks in the system.

The command format is:

    A

The default display generated by this command is a display of the active user partitions. Note that the display format varies slightly in each operating system environment.

#### z/OS (JES2)

A typical display for an z/OS (JES2) operating system is illustrated in the following figure.

    ID       JOBNAME  STEPNAME PROCSTEP ST DP STORE       CPU  EXCP  ASID DM RP

    S0030318 DAEFCI06 DAEFCI06 CICS     NS E3   888K   169.18  6419  00B9 00
    S0030323 DAEFCIT1 DAEFCIT1 CICS     NS ED   796K   214.01  6059  00BB 00
    S0030406 DAEFCQS  DAEFCQS  CQSPROC  NS FE   480K   367.62   697  00C5 00
    S0030650 DAEFCI17 DAEFCI17 CIQESMF  NS ED  1068K   301.02 16437  00D7 00
    S0022269 DAEFCI09 DAEFCI09 CICS     NS ED  1180K    17.82  6647  00DA 00
    S0041203 DAEFCOAD DAEFCOAD IEFPROC  NS F5   584K     8.49  7892  017C 00
    S0043699 DAEFCI10 DAEFCI10 CICS     NS E3  1536K   232.35 16987  01B3 00
    S0052293 DAEFCI01 DAEFCI01 CICS     NS E3  1148K    88.94 14125  01E3 00
    S0030892 DAEFCODE DAEFCODE SCO##034 NS F5  5072K    18.17 12827  02C3 00
    S0022979 DAEFCI15 DAEFCI15 CICS     NS E3  6384K   393.90 18334  0300 00
    S0030894 DAEFCO   DAEFCO   IEFPROC  NS F5 28592K   680.40   292K 032B 00
    S0023507 DAEFCIA1 DAEFCIA1 CICS     NS E3  1156K   236.13 13872  0332 00
    S0030896 DAEFCOTS DAEFCOTS IEFPROC  NS F5   976K    19.70  4762  033E 00
    S0031260 DAEFCIA2 DAEFCIA2 CICS     NS E3  1124K     5.21  5808  0352 00
    S0032261 DAEFCIUK DAEFCIUK CICSESA  NS E3 13488K     1.09  3224  0376 00
    S0031699 DAEFCI11 DAEFCI11 CICS     NS E3  7900K     3.58  4953  0379 00
    S0032194 DAEFCOT  DAEFCOT  IEFPROC  NS F5 12184K     6.54 16140  0390 00

    --------------------- CPU %   95.25  PAGE RATE/SEC   16.50  INTERVAL  14.55 S
    OP=A CL=ALL IN=ALL JB=DAEFC DS=1 SI=CC LR=1 LL=132 PP=0 DC= RL=999999
    AD=S DE= SC= PT= SQ= RR=0 OC= SD=1500  20.02.2002, 14:25:17

Various display formats are available using the A command. The type of display information is determined by the AD keyword (see the section on keywords below).

Note that the column headings remain the same regardless of the display option selected. The column headings are explained in the following table:

Heading/Field | Description
--- | ---
ID | The identification number of each initiator. ID is blank for system tasks and TSO tasks.
JOBNAME | The jobname of the active task.
STEPNAME | The job step name being executed, either within the procedure or within the job if no procedure is being executed.
PROCSTEP | The name of the procedure being executed, if any.
ST | Status of the indicated task or job: OT - swapped-out NS - non-swappable ND - not dispatchable
DP | The dispatching priority for a job.
STORE | The amount of virtual storage assigned to the job.
CPU | The number of CPU seconds consumed.
EXCP | The I/O the job has generated.
DM | The performance group domain.
AS | The address space.
RP | The reply ID.
CPU % | The percent of time the CPU was active of the time period displayed in the INTERVAL field (see below).
PAGE RATE/SEC | The average paging rate.
INTERVAL | The interval of time, in minutes and seconds, over which the paging statistics have been accumulated.

#### z/OS (JES3)

In z/OS (JES3) environments, the active display has a slightly different format. The header format for the A display in an z/OS (JES3) environment is illustrated in the following figure.

    ID  JOBNAME  STEPNAME  PROCSTEP  STATUS  GROUP  DP  RT  LINES  STORE  CPU  RP

Note that in z/OS (JES3) environments, the active display includes the JES3 job class group and the JES3 job number. In addition, the SYSOUT line count provided does not include any output in a "held" SYSOUT class.

The following table describes the column headings that appear on the UQ A display for the z/OS (JES3) environment.

Heading | Description
--- | ---
ID | The identification number of each initiator. ID is blank for system tasks and TSO tasks.
JOBNAME | The jobname of the active task.
STEPNAME | The job step name being executed, either within the procedure or within the job if no procedure is being executed.
PROCSTEP | The name of the procedure being executed, if any.
STATUS | The number of subtasks associated with the indicated task or job. This count identifies the number of unique z/OS subtasks created.
GROUP | Performance group.
DP | The displatching priority for a job.
RT | Ready TCB count.
LINES | Output spool lines produced by job.
STORE | The amount of virtual storage assigned to the job.
CPU | The number of CPU seconds consumed.
RP | The reply ID.

### D Command

The D command enables you to display the current status of all disk units defined to the operating system.

The command format is:

    D

The display generated by the UQ D command is illustrated in the following figure.

    UNIT   SERIES  STATUS    VOLUME  DCB   UNIT   SERIES  STATUS    VOLUME  DCB

     124    3390   OFFLINE                  125    3390   OFFLINE
     126    3390   OFFLINE                  127    3390   OFFLINE
     128    3390   OFFLINE                  129    3390   OFFLINE
     12A    3390   OFFLINE                  12B    3390   OFFLINE
     12C    3390   OFFLINE                  12D    3390   OFFLINE
     12E    3390   OFFLINE                  12F    3390   OFFLINE
     200 A  3380 RSIDNT/PRIV DBDC02  000    201 A  3380 RSIDNT/PRIV DBDC06  039
     202 A  3380 RSIDNT/PRIV DBDC07  056    203 A  3380 RSIDNT/PRIV DBDC01  089
     204 A  3380 RSIDNT/PRIV EUP001  009    205 A  3380 RSIDNT/PRIV EUP002  005
     206 A  3380 RSIDNT/PRIV EUP003  006    207 A  3380 RSIDNT/PRIV GSALL1  003
     208 A  3380 RSIDNT/PRIV GSMUE1  003    209 A  3380 RSIDNT/PRIV GSSTU1  007
     20A A  3380 RSIDNT/PRIV RSC001  002    20B A  3380 RSIDNT/PRIV ANW001  002
     20C A  3380 RSIDNT/PRIV AER001  004    20D A  3380 RSIDNT/STOR USR006  006
     20E A  3380 RSIDNT/STOR USR007  017    20F O  3380 RSIDNT/PRIV SMIG01
     210 A  3380 RSIDNT/PRIV DCE001  003    211 A  3380 RSIDNT/PRIV DCE002  010
     212 A  3380 RSIDNT/PRIV XCOL01  001    213 A  3380 RSIDNT/PRIV XKGSD1  022
     214 A  3380 RSIDNT/PRIV ADA003  028    215 A  3380 RSIDNT/PRIV ADA004  007
     216 A  3380 RSIDNT/PRIV ADAE01  010    217 A  3380 RSIDNT/PRIV ADAE02  005

    --------------------------------------------------------------------------------
    OP=D CL=ALL IN=ALL JB= DS=1 SI=CC LR=LAST LL=80 PP=1 DC= RL=999999 AD=J
    DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 14:48:13

Note
The last column of the display ("DCB") is only shown in z/OS environments.

Note that there are no options available with this command function. If, however, the number of disk units defined is large enough, the display may extend, for a 3270 display terminal, to multiple displays. In this situation, press ENTER to scroll to the next screen page.

The column headings remain the same regardless of the length of the display.

The following table describes the column headings that appear on the UQ D display for all environments.

Heading | Description
--- | ---
UNIT | The CUU of the indicated disk unit.
The indicator in the column immediately to the right of the UNIT column specifies the current usage of the defined unit. It can have one of the following four values:
O | The unit is online, but not in use.
A | The unit is online and allocated.
B | The unit is online, allocated, and busy performing I/O.
blank | The unit is offline.
SERIES | The type of disk unit defined. The codes used to designate unit types are:
3375 | 3375
3380 | 3380
3390 | 3390
FBA | 3310-3370 (z/VSE)
none | Unknown unit type
STATUS | The mount status for the indicated unit and the disk volume on that unit. The status indicators are:
ONLINE | The unit is online (z/VSE).
MOUNT RQD | There is a mount pending.
OFFLINE | The unit is offline.
NOT READY | The unit is inoperative.
CHNG STATUS | The mount status is transient.
RESERVD | The volume is dismountable only upon request.
RSIDNT | The volume is non-removable.
REMOVE | The volume can be removed dynamically.
PRIV | It is a private volume.
PUBL | Temporary data sets will be allocated.
STOR | Permanent data sets with nonspecific volume references will be allocated.
SYSRES | It is a system residence volume(z/VSE).
VOLUME | The volume identification name of the disk volume mounted on this unit. This entry is blank if the unit is offline.
DCB (OS) | The number of z/OS data sets currently allocated and in use on the indicated volume.
OWN (VSE) | The number of z/VSE partitions owning the indicated volume.

### L Command

The L command enables you to display all JES datasets for a given job. If the result of a previous job selection gave more than one job, the datasets for the first one found are listed. By selecting one of the datasets with the cursor, you can display this dataset.

The command format is:

    L

### M Command

The M command enables you to display the console operator messages.

The command format is:

    M

Note that no arguments are given with this command.

#### z/OS (JES3)

In z/OS (JES3) environments, the M command displays the system log for the processor on which Com-plete is executing. You can, however, examine active SYSLOG jobs on any processor in the JES3 complex by using the S command.

#### Source of the displayed messages:

If you have a CONSOLE server statement in your sysparms, the data is taken from the internal table built by the server and limited by the number of entries you have defined in the server statement. On z/VSE, this is the only possible source for the data.

z/OS: If there is no CONSOLE server in the sysparms, the data is taken from the system's OPERLOG or SYSLOG. The time/date of the oldest/newest record available are displayed on the Selection screen (PF5).

Data is scrolled using PF7/PF8. PF9 goes to the oldest record available. Outstanding WTORs are displayed and highlighted at the end of the last page. Use PF10/PF11 to display the left, right or center part of the message.

Notes:

1. Using the CONSOLE server: The Console messages and WTORs are stored in the incore table as they arrive. This means that only messages and outstanding replies arriving after activation of the server can be displayed.
2. Function =' ' (blanks) has the same effect as Function='K ' if the Command field is not empty.
3. Operator commands must be entered in the command field. The function field may contain only blanks, "K" followed by a blank or "/" followed by a blank.

#### Input Fields/Keys:

Function: | any valid UQ function
Operand/Command: | operand for the above UQ Function or operator command for sending the data to the console.

#### Special Functions/PFKeys:

ENTER | Performs the entered function or command. If both are empty, the latest messages are displayed.
CLEAR | Terminates UQ.
PF5 | Shows the selection screen (Sel) or goes back to the normal display (NoSel). Only available if OPERLOG/SYSLOG are used.
PF6 | Retrieves the last (10) operator commands entered. The command is displayed and can be modified before execution.
PF7/PF8 | Scrolls backward/forward within the number of records available.
PF9 | Shows the oldest record available on OPERLOG/SYSLOG.
PF10/PF11 | Moves displayed window to the left or right. For all terminal models except 5, the default part is the center. On model 5 terminals the default is the left part of the line.

All other PF keys will honor the user and global PFKey definitions made for UQ in UUTIL. Note that some definitions may not be applicable and no action will be displayed on the UQ M screen.

#### Selection:

The display can be limited by Date/Time. The FROM date must be always lower than the TO date. You can give also give SCAN arguments. The next line found containing the argument will be shown at the bottom of the displayed messages. For SYSLOG records the display is always for the local system. On OPERLOG you can show messages from the local system only or from all systems.

### O Command

The O command displays console operator reply messages requiring a reply only.

The command format is:

    O

Note that no arguments are given with this command.

Notes:

1. Function =' ' (blanks) has the same effect as Function='K ' if the Command field is not empty.
2. Operator commands must be entered in the commandfield. The function field may contain only blanks, "K" followed by a blank or "/" followed by a blank.

#### Sample UQ M Screen (Model 2):

    16:25:42        TID    23          COM-5.1.          User RSF1         30.08.97
                             ---   System Messages   ---                       UQM1

    JOB01502  IEF404I KAS - ENDED - TIME=16.25.27
    JOB01502  -KAS      ENDED.  NAME-                     TOTAL TCB CPU TIME=   .00
    JOB01504  IEF403I KAS - STARTED - TIME=16.25.28
    JOB01504  -                                                --TIMINGS (MINS.)--
    JOB01504  -JOBNAME  STEPNAME PROCSTEP    RC   EXCP   CONN    TCB    SRB  CLOCK
    JOB01504  -KAS      TEST                 00     29     38    .00    .00     .0
    STC01303  .C      J01502
    JOB01502  .HASP634 KAS      CAN NOT BE CANCELED
    STC01303  .P      J01499
    JOB01499  .HASP608 KAS      AWAITING PURGE            PRIO  1 PURGE ANY
    JOB01503  -                                                --TIMINGS (MINS.)--
    JOB01503  -JOBNAME  STEPNAME PROCSTEP    RC   EXCP   CONN    TCB    SRB  CLOCK
    JOB01503  -ESI      ESI                  00     95    254    .06    .00     .1
    JOB01503  IEF404I ESI - ENDED - TIME=16.25.35
    JOB01503  -ESI      ENDED.  NAME-                     TOTAL TCB CPU TIME=   .06
    STC06632 *23 DFS996I *IMS READY*  IMS4
    ******************************** BOTTOM OF DATA *******************************
    Select Function:                                                       CONSOLE
    Operand/Command:
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                                       Retrv  up    down        left  right

> Input Fields/Keys:

>   Function: any valid UQ function

>   Operand/Command: operand for the above UQ Function or operator command for the data to be send to the console.

> Special Functions/PF Keys:

>   ENTER | Performs the entered Function or Command . If both are empty the last messages are displayed.
>   CLEAR | Terminate UQ
>   PF6 | Retrieve the (10) last entered operator commands. The command is displayed and can be modified before execution.
>   PF7 | Scroll backward/forward within the limits of the table.
>   PF10/PF11 | Move displayed window to left or right. For all terminal models except 5 the default part is the center. On model 5 terminals the default is the left part of the line.

>   All other PF Keys will honor the definitions made for UQ in UUTIL - user and global PFKey definitions. Note that some definitions may not be applicable thus not causing any action on the UQ M screen.

>   Notes:

>   1. Function =' ' (blanks) has the same effect as Function='K ' if the Command field is not empty.
>   2. Operator commands must be entered in the commandfield. The function field may contain only blanks, "K" followed by a blank or "/" followed by a blank.

### Q Command

The Q command enables you to request a display of the jobs residing in the input/output queue.

The command format is:

    Q

The default display generated by this command is a display of the jobs in the input/output queue. The following figure illustrates a typical Q display for an z/OS (JES2) system.

     JOB     NUMBER     Q J O SYST  DEST     PRI  ST      LINES  FORM  FCB  WRITER
    COMTEST4 S.54447   *X   - DAEF            15              0
    COMTEST2 S.52908   *X   - DAEF            15              0
    COMTEST4 S.53792    O S X                112  H       1,728  STD
    COMTEST4 S.53792    O S X                144            239  STD
    COMTEST4 S.53443    O S X                144  H         412  STD
    COMTEST4 S.53443    O S X                144            261  STD
    COMTEST4 S.53331    O S X                144  H         412  STD
    COMTEST4 S.53331    O S X                144            229  STD
    COMTEST4 S.53039    O S X                144  H         422  STD
    COMTEST4 S.53039    O S X                144            231  STD
    COMTEST2 S.50616    O S X                112          1,452  STD
    COMTEST5 S.33907    O S X                144            202  STD
    COMTEST5 S.33907    O S X                144            562  STD
    COMTEST4 S.53792    O S Z                144            398  STD
    COMTEST4 S.53443    O S Z                144            534  STD
    ... 64 PERCENT SPOOL UTILIZATION.

    ------------------------------------ JOBS      15  TOTAL RECORDS        7,082
    OP=Q CL=ALL IN=ALL JB=COMT DS=1 SI=SM LR=1 LL=132 PP=0 DC= RL=999999
    AD=J DE= SC= PT= SQ=C RR=0 OC= SD=1500 WR=  10.06.2005, 11:01:19

Various display formats are available with the Q command. The display format is determined by both the operating system environment and the keywords CJ, CL, CO, DE, IN, JB, JC, JO, OC, and SQ. The display format can also be determined by the UQ user-written exit.

Column headings vary depending on the operating system environment.

- z/OS (JES2)
- z/OS (JES3)
- z/VSE (POWER)

#### z/OS (JES2)

If the selection criteria limit the display to 1500 entries, the entries are sorted. For IN=I the sort sequence is set to priority + number, for all others it is set to class. If more entries are selected, they are listed in the sequence in which they are read by the subsystem interface. In this case the bottom line of the display indicates the number of entries already read by the interface and the total number of jobs matching the selection criteria.

The following table describes the column headings that appear on the UQ Q display for the z/OS (JES2) environment.

Heading | Description
--- | ---
JOB | The names of the jobs on the queue.
NUMBER | The job numbers assigned to specific jobs by the spooling system (JES).
Q | The type of queue in which a job resides.
For non-JES systems, one of the following two values will appear:
I | The job is in the input queue.
O | The job is in the output queue.
For JES systems, one of the following five values will appear:
* | The task is active.
I | The job is in the input queue.
X | The job is executing.
O | The job is in the output queue.
P | A purge request is pending for the job.
J | The job class set in the JCL.
O | The output class set in the JCL.
DEST | The destination code of the job. The codes displayed are those codes defined to the spooling system and normally indicate that the job either originated from or was destined for an RJE station.
In JES systems, if the job task is active on an I/O device, the device name is also displayed.
PRI | The priority of the indicated job within the indicated job class queue.
ST | The status of the indicated job. One of the following two values may appear:
H | The job is in hold status.
blank | The job is not in hold status.
LINES | Number of lines generated by the job (not including lines in output datasets, which are logically deleted).
FORM | Name of the JES2 form associated with the output.
FCB | Name of the JES2 forms control buffer associated with the output.
FLASH | Name of the JES2 flash associated with the output.

#### z/OS (JES3)

The header format for a Q display in an z/OS (JES3) environment is illustrated in the following figure.

    OB-NAME JOB# Q CLASS PRI ST ORIGIN

The following table describes the column headings that appear on the UQ Q display for z/OS (JES3).

Heading | Description
--- | ---
JOB-NAME | The name(s) of the job(s) on the queue.
JOB# | The JES3 job number.
Q | The JES3 function that the selected job is currently executing. One of the following three functions may be indicated:
I | Input service
M | Main service
O | Output service
CLASS | The JES3 job class.
PRI | The JES3 priority.
Note that PRI can have a value ranging from 0 to 15.
ST | The JES3 job class status. ST can be one of the following:
H | The job is in hold.
A | The job is currently active on the function indicated by Q.
Q | The job is currently available for the functionindicated by Q.
W | The job is currently waiting for the function indicated by Q.
ORIGIN | The JES3 job origin (ORG).

#### z/VSE (POWER)

The header format for a Q display in a z/VSE environment is illustrated in the following figure.

    JOB NUMBER Q CL PR DI RECORDS DEST SID

The following table describes the column headings that appear on the UQ Q display for VE:.

Heading | Description
--- | ---
JOB | The name(s) of the job(s) on the queue.
NUMBER | The POWER job number.
Q | The type of queue in which a job resides:
R | The job is in the reader queue.
L | The job is in the list queue.
P | The job is in the punch queue.
CL | The POWER job class for jobs in the RDR queue, the PUN/LST class for any kind of output.
PR | The POWER priority.
DI | The POWER job disposition. DI may be one of the following:
L | Disposition "Leave".
H | Disposition "Hold".
D | Disposition "Delete".
* | Job is marked active.
RECORDS | The number of data records contained in a job.
DEST | The POWER remote output destination.
SID | The POWER system ID (only applicable if shared spooling is used.

### S Command

The S command enables you to request a display of a specific job as it exists either in the input or output queues. It is used in conjunction with the JB keyword.

The following table summarizes the z/OS and z/VSE equivalents of the information that may be displayed using the S command.

z/OS | z/VSE
--- | ---
Input queue jobs: | Reader queue jobs:
a. JCL | a. Job control
b. SYSIN data | b. SYSIPT data
Output queue jobs: | List or Punch queue jobs:
a. SMB information | a. SYSLST information
b. Job step information | b. SYSPUN information
c. SYSOUT information |

The information to be displayed is determined by use of the keyword argument SI; it can be displayed in one of several formats. The format is determined by use of the keyword arguments DS, JB, LR, LL, PP, RL, SC, and SI. Other keywords used in conjunction with the S command are DC, DE, PT, and RR.

The command format for the S command is:

    S,JB=identifier

JB=identifier | Identifies the specific job to be selected for display.
Note that identifier can be either the jobname or the job number (as determined by POWER, or JES).
Jobnames are not necessarily unique but job numbers are. identifier , however, must uniquely identify the job to be selected.

The default display generated by this command is determined by the initialized value of the SI keyword argument. If you do not initialize this keyword argument, it defaults to SI=SM for z/OS and LS for z/VSE.

The output displayed is the SMB/SYSLST information.

The following figure illustrates a typical display that might occur as a result of using the default values of the S command in an z/OS (JES2) environment.

    2 //STARTING EXEC XCOM148
           4 XXXCOM148  EXEC PGM=NPRINIT,REGION=8M,TIME=1440
    IEF287I   MM.SYSF.LISTING                              NOT CATLGD  2
    IEF287I   VOL SER NOS= ADAE01.
    IEF287I   MM.SYSF.LISTING                              NOT CATLGD  2
    IEF287I   VOL SER NOS= ADAE02.
    IEF287I   ADABAS.SYSF.QAS.RESULT.KM02.V620             NOT CATLGD  2
    IEF287I   VOL SER NOS= WRK001.
    IEF287I   ADABAS.SYSF.QAS.RESULT.KM02.V620             NOT CATLGD  2
    IEF287I   VOL SER NOS= WRK001.
    IEF287I   ADABAS.SYSF.QAS.RESULT.KM02.V620             NOT CATLGD  2
    IEF287I   VOL SER NOS= WRK001.
    IEF287I   ADABAS.SYSF.QAS.RESULT.KM02.V620             NOT CATLGD  2
    IEF287I   VOL SER NOS= WRK001.
    IEF287I   ADABAS.SYSF.QAS.RESULT.KM02.V620             NOT CATLGD  2
    IEF287I   VOL SER NOS= WRK001.
    IEF287I   PUX.UNXTRANS.ALF150                          NOT CATLGD  2

    --------------------------------------------------------------------------------
    OP=S CL=ALL IN=ALL JB=XCOM148,S.3374 DS=1 SI=CC LR=1 LL=80 PP=1 DC= RL=999999
    AD=J DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 15:13:23

Note that the output displayed is arranged in data sets, each of which is displayed by use of the DS keyword.

### T Command

The T command enables you to request a display of the status of the tape units defined to the operating system.

The command format is:

    T

No keyword arguments affect the output displayed by this command.

The default display generated by this command is a display of all the tape units defined to the operating system and the mount status associated with them. For a display type terminal, if the number of units exceeds the capacity of one screen display, you can display the additional tape units by pressing ENTER.

The following figure illustrates a typical display that might occur when the T command is entered in an z/OS (JES2) environment.

    UNIT SERIES BPI       STATUS    VOLUME

     810  3480  38000     OFFLINE
     811  3480  38000     ALLOCATED 004988
     812  3480  38000     OFFLINE
     813  3480  38000     OFFLINE
     814  3480  38000     ONLINE
     815  3480  38000     OFFLINE
     816  3480  38000     OFFLINE
     817  3480  38000     OFFLINE
     818  3480  38000     OFFLINE
     819  3480  38000     OFFLINE
     81A  3480  38000     OFFLINE
     81B  3480  38000     OFFLINE
     81C  3480  38000     OFFLINE
     81D  3480  38000     OFFLINE
     81E  3480  38000     OFFLINE
     81F  3480  38000     OFFLINE
     880  3400  1600/6250 ONLINE
     890  3490  38000     OFFLINE
     8A0  3400  1600/6250 OFFLINE
    --------------------------------------------------------------------------------
    OP=T CL=ALL IN=ALL JB= DS=1 SI=CC LR=1 LL=80 PP=1 DC= RL=999999 AD=J
    DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 15:15:05

### V Command (z/OS Only)

The V command enables you to request a display that summarizes the free space available on all direct access volumes currently mounted and online to the operating system.

The command format is:

    V

No keyword arguments affect the output of the resulting display.

The display generated by this command is a display of direct access devices online to the operating system and a summary of the free space for each volume as shown in the following figure. Note that a maximum of 16384 volumes is displayed.

The following figure illustrates a typical display that might occur when the V command is entered in an z/OS environment.

                TOTAL    TOTAL    TOTAL        LARGEST CONTIG
                                   FREE     FREE     FREE             FREE
    VOLUME  CUU DEVTYP  STATUS     CYLS     TRACKS   EXTNTS       CYLS, TRACKS

    EDU107  10B 3390    ONLINE     1951        5        3         1528       0
    DBDC02  200 3380    ONLINE      907        9        4          907       0
    DBDC06  201 3380    ONLINE        0        0        0            0       0
    DBDC07  202 3380    ONLINE       49      173       68           13       0
    DBDC01  203 3380    ONLINE       19      306       65            2       0
    EUP001  204 3380    ONLINE      786      165       89           81       0
    EUP002  205 3380    ONLINE      529      294       57          208       3
    EUP003  206 3380    ONLINE      326      575       97           34       0
    GSALL1  207 3380    ONLINE      514      447      140          132       0
    GSMUE1  208 3380    ONLINE     1206       51       14          878       0
    GSSTU1  209 3380    ONLINE      290       86       25          140       0
    RSC001  20A 3380    ONLINE     1692       47       11          735       0
    ANW001  20B 3380    ONLINE      279        5        4          144       0
    AER001  20C 3380    ONLINE       51       66       23           11       0
    USR006  20D 3380    ONLINE       31     1296      320            1      21
    USR007  20E 3380    ONLINE       87     1134      249            6       3

    --------------------------------------------------------------------------------
    OP=V CL=ALL IN=ALL JB= DS=1 SI=CC LR=1 LL=80 PP=1 DC= RL=999999 AD=J
    DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 15:16:26

If the number of volumes to be displayed exceeds the capacity of one display for a display type terminal, press ENTER to continue the display.

The column headings illustrated in the UQ V display are described in the following table.

Heading | Description
--- | ---
VOLUME | The volume identification name of the DASD volume mounted on this unit.
CUU | The CUU of the unit.
DEVTYP | The device type of the unit.
STATUS | The mounted status of the DASD volume. Normally, this entry is online.
TOTAL FREE CYLS | The sum of the count of all free cylinders on the indicated volume.
TOTAL FREE TRACKS | The sum of the count of all free track extents on the indicated volume.
TOTAL FREE EXTNTS | The sum of the count of all free extents for the indicated volume.
LARGEST CYLS/TRKS | The largest free extent, per volume, given for both cylinders and tracks.

Note that the volume display is obtained for a five-minute interval only. The beginning of this interval is given at the bottom right of the display.

Note
If you repeat the V command within this five-minute interval, the display is repeated. It will not reflect any data set allocations that may have occurred since the start of this interval.

## UQ Keywords

The UQ keyword is used to tailor the output of a specific UQ command function or to direct hard copy routing of portions of a display.

Although some command functions are unaffected by keyword usage, you can enter any keyword at any time while UQ is active, and it will subsequently be in effect when a command is executed that uses one or more of them.

This section gives a detailed description of all keywords and the effect they have on specific command functions. Sample displays are given to illustrate the effects of specific keywords on output displays.

### Keyword Values

You can enter keyword values, either when you invoke UQ or after invocation; however, using a specific keyword will have no apparent effect if the command function with which you enter it is not applicable to that keyword. Keyword initialization occurs at the point that a function is issued that uses that keyword. In addition, the use of some keyword values may cause other keyword values to be modified. When you use the keywords later, their output results will reflect the most recent modifications made, either by you or other keyword values.

The keywords and their general application are summarized in the following table. The keywords are designed to be used with specific commands. The commands associated with each keyword are also indicated. Keywords that have related effects when used with other keywords are also listed.

Keyword | Description | Used With Command | Related Keywords
--- | --- | --- | ---
AD | Sets the display option. | A |
CJ | Sets which job classes are displayed. | Q | JES2 only
CL | Sets which job classes are displayed. | Q | all systems except z/OS JES3
S | z/OS JES3 only
CO | Sets which output classes are displayed. | Q | JES2 only
DC | Sets the destination code for hard copy output. | S | DS, RL, PP, LL, LR, SD
DE | Sets the destination code for job output being sent to a RJE station. | S,Q | JB
DS | Sets which logical data set within a unique job is to be displayed. | S | DC, RL, SI
IN | Sets whether input or output jobs will be displayed. | Q |
JB | Sets which job(s) will be displayed. | S, L, Q |
JC (z/OS[JES3] only) | Sets a JES3 job class. | Q |
JO (z/OS [JES3] only) | Sets a JES3 job origin. | Q |
LL | Sets the line length to be used for output display of a specific queued job. | S |
LR | Sets the line number to be used for output display of a specific queued job. | S | DS
NO | Remembers a position in the spool file. | S |
OC (z/OS) | Sets the output class of the job being displayed to the specific output class. | Q | JB
OP |  | All (used for information purposes only) |
PO | Points to a previously noted position in the spool file. | S |
PP | Sets the print position to be used for output of a specific queued job. | S |
PT | Sets the destination code for hard copy output. | S |
RL | Sets the maximum number of statements to be sent to another terminal. | S | DC
RR | Specifies the frequency with which UQ will write displayed data to the terminal. | all |
SC | Specifies a character string to be searched for using the S command. | S |
SD | Sets the number of lines that will be written to a UEDIT work file. | S | DC
SI | Specifies the type of queue information to be displayed. | S |
SQ | Specifies the sorting sequence for the job queue display. | Q |
WR (z/OS) | Changes the WRITER name of the job being displayed to the specific name. | Q | JB

The status of all keyword values is maintained by UQ; their initialized values are displayed in the bottom two lines of every command function display.

Default values are established for most keywords. To view the default values for any keyword at any time, enter the keyword, followed by an equal sign, but do not specify a value. The SC keyword is an exception; details about its use are given later in this section. A more detailed description of UQ keywords follows below.

### AD Keyword (z/OS only)

The AD keyword affects the output display of the A command.

The format is:

    AD=[value]

value | Specifies the display option to be used when the A command function is executed.
J | The display is to be restricted to jobs (default).
T | The display is to be restricted to TSO users.
S | The display is to be restricted to started tasks.
I | The display is to be restarted to initiators.

#### Example:

The following figure illustrates a typical display that might occur when the the AD keyword is used with a value of S (in a z/OS environment) and the A command function is subsequently requested.

    ID     JOBNAME  STEPNAME PROCSTEP ST DP STORE       CPU  EXCP  LINES  ASID DM RP

    S03032 TMON8DLS TMON8DLS TMON8DLS NS EF   748K   575.13 25550    N/A  003E 00
    S03042 TMDBDLS  TMDBDLS  TMDBDLS  NS EF   356K    38.28  9984    N/A  003F 00
    S03120 NUC177   NUC177   NUC177   NS F3  2152K  6818.66  1938K   N/A  0040 00
    S03077 TIMER    TIMER    TIMER    OT FF   176K    79.20  2549    N/A  0041 00
    S03124 NATEDPM2 NATEDPM2 GLOBAL   OT FF   156K    48.64     3    N/A  0043 00
    S03122 NUC11177 NUC11177 NUC11177 NS F3   368K   107.78 31064    N/A  0044 00
    S03528 NUC010   NUC010   NUC010   NS F3  4416K 10614.39  3696K   N/A  0045 00
    S03343 DB23DIST DB23DIST IEFPROC  NS EF   224K     4.28   340    N/A  0046 00
    S03130 NATEDPM3 NATEDPM3 GLOBAL   OT FF   144K    46.37     8    N/A  0047 00
    S03286 IRL4PROC IRL4PROC          NS EF   220K    80.72    90    N/A  0048 00
    S03128 NATGBPM  NATGBPM  GLOBAL   OT FF   140K    46.43     2    N/A  0049 00
    S03132 NATGBPM2 NATGBPM2 GLOBAL   OT FF   148K    48.57     3    N/A  004A 00
    S03167 NATGBPM3 NATGBPM3 GLOBAL   OT FF   144K    46.49     7    N/A  004B 00
    S03169 NATSWPMH NATSWPMH GLOBAL   OT FF   152K    48.60     3    N/A  004C 00
    S03196 TSO      TSO      TSO      OT FF   332K     9.63  1075    N/A  004D 00
    S03190 XCOM145  XCOM145  XCOM145  NS F3  4384K 17866.57  1537K   N/A  004E 00
    S03292 DB23DBM1 DB23DBM1 IEFPROC  NS EF  3652K  6523.80  2123    N/A  004F 00
    S03231 DB23MSTR DB23MSTR IEFPROC  NS EF   340K   548.11  6141    N/A  0050 00
    --------------------- CPU %   46.00  PAGE RATE/SEC    0.71  INTERVAL   1.42 S
    OP=A CL=ALL IN=ALL JB= DS=1 SI=CC LR=1 LL=80 PP=1 DC= RL=999999 AD=S
    DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 15:19:29

### CJ Keyword

In JES2 systems the CJ keyword affects the output display of the Q command. This keyword determines which job classes are displayed. Note that CJ and CO are mutually exclusive.

### CL Keyword

In all systems except z/OS (JES3), the CL keyword affects the output display of the Q command. This keyword determines which job classes are displayed.

In z/OS (JES3) systems, the CL keyword is used in conjunction with the Q command when SI=SO in order to limit the display to specific SYSOUT class(es).

The format is:

    CL=[value]

value | Specifies the job classes for which the display is to be restricted. One of two formats can be specified:
ALL | The display is to include all job classes.
ab...n | The display is to be restricted to one or more job classes. For example, CL=A restricts the display to jobs in class A; CL=ABC restricts the display to jobs in job queue classes A, B, and C.
Default: If the Q or S command in z/OS (JES3) systems is issued and no value is specified for the CL keyword argument, the default is ALL.

The following figure illustrates a typical display that might occur when the CL keyword is used with a value of A and the Q command is subsequently requested.

    JOB     NUMBER   Q CLS DEST    PRI  ST      LINES    FORM    FCB  FLASH
    OPFWDMS2 J.3151  *X  A           10              0
    SSFDEV   J.8752   O  A  AHU       9              2    STAN
    USARMU   J.8882   O  A  USARMU    9              2    STAN
     ... 45 PERCENT SPOOL UTILIZATION.

    ------------------------------------ JOBS       3  TOTAL RECORDS            4
    OP=Q CL=A IN=ALL JB= DS=1 SI=SO LR=1 LL=80 PP=1 DC= RL=999999 AD=S
    DE= SC= PT= SQ= RR=0 OC= SD=1500  11.11.1997, 15:24:05

### CO Keyword

In JES2 systems the CO keyword affects the output display of the Q command. This keyword determines which output classes are displayed. Note that CJ and CO are mutually exclusive.

### DC Keyword

The DC keyword is used only in conjunction with the S command. It sets the destination code of the destination terminal(s) to be used when data is sent to another terminal. The data sent is from the currently displayed SYSIN/SYSIPT or SYSOUT/SYSLST for a specific job.

The format is:

    DC=destination

where destination is either any valid Terminal Identification number (TID) or any valid message switching code.

When you enter destination as an asterisk (DC=*), the output is directed to a work file. You can then use the RECOVER function in order to process the work file under UEDIT.

The DC keyword is used primarily to obtain hard copy output of data from a job queued either in the input or output queue. The amount of data to be sent is determined by the settings of the DS, RL, PP, LL, LR, and SD keywords.

The DS keyword determines which logical output data set is to be included. Since job queue data, whether on the input or output queue, is arranged in logical data sets by Com-plete, the only data that will be sent by using the DC keyword is data in the logical data set determined by the DS keyword. For example, if DS=5 is in effect, only data from logical data set 5 will be sent.

The RL keyword determines the number of statements to be sent. For example, if RL=28 is in effect, only 28 lines of data will be sent.

The PP keyword determines the beginning position of each statement from which the data will be generated. The PP keyword determines the beginning column or print position within each statement being displayed. Note that this same print position will be used in all DC output.

Note
If the spool data set includes carriage control characters, they will be transmitted and used only if PP=0.

The LL keyword determines the length of each line to be displayed. When the DC keyword is used to send the data to another location, the same line length will be used.

The LR keyword determines the logical record or statement number of the first line to be included in the output data.

The SD keyword determines the size (number of lines) of the UEDIT work file that will be used when "DC=*" is specified.

### DE Keyword

The DE keyword is used with either the S or Q command when a unique job is being displayed. It sets the destination code of the destination RJE station to be used when job output is sent to an RJE station. The data being sent is data from the currently displayed SYSOUT/SYSLST for a specific job.

The format is:

    DE=destination

or:

    DE=node.destination

where destination is any valid RJE destination code as defined to the spooling system (JES, or POWER), possibly on a different node.

The DE keyword is used primarily to route all output to a line printer, either central or remote. Note that a Com-plete terminal cannot be designated as an RJE terminal.

The amount of data to be routed is the entire job. Use of the DE keyword submits a standard operating system route statement to the operating system. Any and all standards in effect for a given spooling system (JES, or POWER) are in effect when the route statement is executed. For example, if the operating system in use is z/OS, a route statement routes all jobs with the same name. These jobs are then executed on a priority basis (that is, a job in execution is routed upon completion; the jobs in the output queue is not routed).

Note that even though multiple jobs with the same job name may exist in the output queue, a unique display must be obtained by using the JB keyword before a request using the DE keyword is accepted.

### DS Keyword

The DS keyword affects the output display of the S command. This keyword determines which logical data set within a unique job (whether on the input or output queue) is to be displayed. Note that the DC and RL keywords are restricted by the use of the DS keyword.

The format is:

    DS=[number]

number | Identifies the relative number of the logical data set to be displayed.
Note that number can be specified as a "-" or "+" integer. If "+" or "-" is specified immediately before the integer, the data set displayed is the logical data set plus or minus that amount relative to the data set currently displayed.

> z/OS

>   In z/OS, when you use UQ to view job statement information from the input or output queue, Com-plete arranges the data in logical data sets. These data sets are determined as follows:

>   Input queue logical data sets:

>   - Job stream JCL

>   - Each SYSIN data set

> z/VSE

>   In z/VSE, when you use UQ to view job statement information from the List or Punch queue, Com-plete arranges the data from duplicate job names/job numbers in logical files. These files are determined by the order in the List or Punch queue.

>   Output queue logical data sets:

>   - JOB statement SMB messages

>   - EXEC statement SMB JCL

>   - Each SYSOUT data set

>   The end of a logical data set forces the DS keyword to be incremented by one, thus enabling the continued display of data from one data set to the next. In order to force the display to switch from one data set to the next, however, you must initialize the DS keyword. If the DS keyword is not initialized at the time the S command is requested or if the DS keyword is initialized with a null value, the default is DS=1. Note that the DS keyword can be initialized at any time.

>   The SI keyword determines which logical data set can be displayed. Note that using SI without specifying the DS keyword forces the DS keyword value to be initialized to one.

### IN Keyword

The IN keyword affects the output display of the Q command. This keyword determines whether input or output jobs are displayed.

The format is:

    IN=[value]

value | Specifies the restrictions to be imposed upon the display given as a result of execution of the Q command. One of the following nine formats may be specified:
ALL | The display is to include all jobs, whether in the input queue or the output queue.
I | The display is to be restricted to jobs in the input queue.
O | The display is to be restricted to jobs in the output queue.
H | The display is to be restricted to jobs that are in hold status and includes jobs from both the input and output queues.
R | The display is to be restricted to jobs that are not in hold status and includes jobs from both the input and output queues.
IH | The display is to be restricted to jobs both in the input queue and in hold status.
OH | The display is to be restricted to jobs both in the output queue and in hold status.
IR | The display is to be restricted to jobs both in the input queue and not in hold status.
OR | The display is to be restricted to jobs both in the output queue and not in hold status.

Note that the display resulting from executing the Q command with the IN keyword specified is the same type of display as that given when the IN keyword is not initialized. The only difference is the restrictions imposed by the specification of IN.

If you specify the IN keyword with a null value, the default is IN=ALL. The default sort sequence for IN=I is SQ=P#, for all others SQ=C.

### JB Keyword

The JB keyword is used with both the S command and the Q command. This keyword determines which job(s) are displayed.

The format is:

    JB=[value]

value | Specifies the jobname prefix, jobname, or job number to which the display is to be restricted. The acceptable formats for value are:
a. | A one- to eight-character value to be used as a jobname prefix. Note that all jobs with this character string as a prefix to their jobnames will be included in the display. Note This option cannot be used in conjunction with the S command.
b. | A one- to eight-character value to be used as a jobname. Note that use of this option assumes that only one job having this unique name is in the queue. If more than one job exists with the same name, this option is treated the same as the prefix option (see above).
c. | The unique job number as assigned by the spooling system (JES, or POWER). Since all job numbers are unique, this option guarantees a unique job selection.
The job selected will have a job number relative to the current job number established for JB.

If you enter the Q command without specifying a value for the JB keyword, the default display is all jobs in the queue. If you request the S command without specifying a value for the JB keyword, an error will result.

You can reset the default display of queued jobs produced by the Q command to display all jobs in the queue by entering the JB keyword with a null value.

### JC Keyword z/OS (JES3) Only

The JC keyword, valid for z/OS (JES3) systems only, is used in conjunction with the Q command.

The format is:

    JC=[number]

number | Default: All jobs in the queue will be displayed.
Specifies a JES3 job class. All jobs assigned to the specified job class will be included in the display.
Note that number is a one- to eight-character value.

### JO Keyword z/OS (JES3) Only

The JO keyword, valid for z/OS (JES3) systems only, is used in conjunction with the Q command.

The format is:

    JO=[number]

number | Default: All jobs in the queue will be displayed.
Specifies a JES3 job origin. All jobs originating at the specified origin will be included in the display.
Note that number is a one- to eight-character value.

### LL Keyword

The LL keyword is used only in conjunction with the S command. This keyword determines the line length to be used when information about a specific job either on the input or the output queue is on display.

The format is:

    LL=[number]

number | Specifies the line length to be used when statements are displayed from either SYSIN/SYSIPT or SYSOUT/SYSLST. All displays begin with the column position indicated by the PP keyword argument.
Note that number can optionally be entered with a "+" or "-" sign. In this form, the value of number is added or subtracted, respectively, from the initialized value of LL in order to obtain a new LL value.

If you enter the S command without specifying a value for the LL keyword, the default is LL=133. If you enter the LL keyword with a null value, the default is LL=80.

If you select a line length for a display that is longer than the line length of the terminal you are using, the line length continues on the following line. If you select a line length that is shorter than the line length of the terminal, the line length is displayed in its entirety on one line.

### LR Keyword

The LR keyword is used only in conjunction with the S command. This keyword determines the line number to be used when you're displaying information about a specific job either on the input or the output queue.

The format is:

    LR=[number]

number | Specifies the relative line number or displacement from the current line number to be used when statements are displayed from either SYSIN/SYSIPT or SYSOUT/SYSLST.
Note that number can optionally be entered with a "+" or "-" sign. In this situation, the statement to be displayed is the statement relative to the current statement by a value of +n or -n, respectively.

Note
If the value you request exceeds the maximum line count for the logical data set being displayed, an error will result. To cause the display to resume, reenter a correct value.

You can optionally specify the LR keyword in the format:

    LR=LAST[-n]

This format specifies that the last line in the logical data set is to be displayed. The optional -n indicates that the statement that is nlines before the last line is to be displayed.

If you enter the S command without specifying a value for the LR keyword, the default is LR=1. If you enter the LR keyword with a null value, the default is also LR=1. Note that whenever you change or initialize the DS keyword, LR=1 becomes effective.

### OC Keyword

The OC keyword is used only in conjunction with the Q command after a unique job has been displayed. It sets the output class of the job being displayed to the specified output class.

The format is:

    OC=class

where class is any valid output class code as defined to the spooling system (JES, or POWER).

The OC keyword is used primarily to change all output for a unique job to a designated output class. For example, if class D is reserved for a dummy output writer, entering OC=D will route output to this class and effectively result in deletion of the output from the queue.

Note
In z/OS (JES3) systems, you can only use the OC keyword to change the SYSOUT class from the JES3 "HOLD-Q" to the "WRITER-Q".

Even though multiple jobs with the same job name exist in the output queue, you must obtain a unique display using the JB keyword before the OC keyword is accepted.

### OP Keyword

The use of OP is for information purposes only. Each time a UQ command is issued, the OP keyword is initialized. The initialized value always contains the UQ command code for the command currently in effect.

If you attempt to initialize this keyword, the following error message will appear:

    UQI0002 - INVALID COMMAND

### PP Keyword

The PP keyword is used only in conjunction with the S command. This keyword determines the print position to be used when you're displaying information about a specific job either on the input or the output queue.

The format is:

    PP=[number]

number | Specifies the print position or relative print position to be used when statements are displayed from either SYSIN/SYSIPT or SYSOUT/SYSLST.
Note that number can optionally be entered with a "+" or "-" sign. The display then begins in the column plus or minus, respectively, the number of positions from the current value contained in the PP keyword.

If you enter the S command without specifying a value for the PP keyword argument, the default is PP=0. If you enter the PP keyword with a null value, the default is also PP=0.

Note
You must use the PP=0 value when printout/spooling data sets with embedded carriage control characters (when you want carriage control to occur).

### PT Keyword

The PT keyword is used only in conjunction with the S command. It sets the destination code of the destination terminal(s) to be used when you ere sending data to another terminal. The data that is sent is the entire output of the currently displayed job. Carriage control characters in output data sets are executed.

The format is:

    PT=destination

where destination is any valid Terminal Identification number (TID) or any valid message switching code. The entire SYSOUT/SYSLST data set including SMB information is sent to the destination terminal.

Note that other initialized keyword values such as PP, LR, LL, etc., have no effect on the format of the output generated by the PT keyword.

### RL Keyword

The RL keyword is used only with the S command, in conjunction with the DC keyword. It enables you to limit the number of statements to be sent to the destination terminal(s).

The format is:

    RL=[number]

number | Specifies the maximum number of statements to be sent to another terminal(s).
Note that number can optionally be entered with a "+" or "-" sign. In this format, the maximum number of statements to be sent is determined by adding or subtracting, respectively, n to the current value of RL.

If you specify a number that is less than the number of statements in the logical data set, the number of statements sent is determined by number. If number is more than the number of statements in the logical data set, the number of statements sent is all statements beginning with the statement determined by the LR keyword.

If you do not initialize the RL keyword argument, the default is RL=999999. If you initialize the RL keyword value to a null value, the default is RL=1000.

Note
For DC=*, the number of lines written to the SD file is limited not only by the value of RL, but also by the value of the SD keyword.

### RR Keyword

The RR keyword is not restricted to a specific UQ command. This keyword determines the refresh rate or write rate with which UQ display information will be written to the terminal.

The format is:

    RR=[number]

number | Default: 0 seconds
Specifies the frequency, in seconds, with which UQ will write displayed data to the terminal.
Note that number must be an integer from 0 to 32,767.

If you enter a value for the RR keyword argument, the data displayed will be the same as that which you could obtain by pressing ENTER. If an active task display is the current display at the time you initialize RR, the active task display will automatically be refreshed when the specified number of seconds has elapsed. If you enter an S command before initializing RR, the output of the S command will continue from page to page.

The RR keyword invokes a timed rollout function. To terminate the output of RR, use the Clear key or reset the RR keyword to 0.

### SC Keyword

The SC keyword is used only in conjunction with the S command. This keyword enables you to specify a character string for which the S command is to search.

The format is:

    SC=[string] [,cond]
       [,direction]
       [,begin]
       [,end]

string | Default: The initialized value of SC is used.
Specifies the character string for which the search is to proceed. Note that string may be from 1 to 16 characters. Note If the specified string contains embedded blanks or commas, it must be enclosed in single quotation marks. Embedded quotation marks (apostrophies) must be entered as two single quotation marks only if the character string is enclosed in quotation marks.
cond | Default: EQ
Specifies the condition under which the search is to be performed. One of six values can be specified:
EQ | An equal condition.
NE | A not equal condition.
LT | A less than condition.
GT | A greater than condition.
LE | A less than or equal condition.
GE | A greater than or equal condition.
direction | Default: +
Specifies the direction in which the search is to proceed. One of two values may be specified:
+ | A forward search.
- | A backward search.
begin | Default: Zero
Specifies the location within the record, relative to zero, at which the search is to begin.
If no ending value is specified (see below), a beginning value is required.
end | Default: The value specified for the beginning location.
Specifies the ending location within the record, relative to zero, at which the search is to terminate. Note Any ending location specified must be greater than the specified beginning location.
Note that if both the beginning and ending locations are omitted, the value 240 is used for the end location.

When you use the SC keyword, a SCAN function is invoked. The scan proceeds, statement by statement, according to the conditions specified with the keyword values. If a match is found in a statement, that statement is displayed as the first output statement. If no match is found, an end-of-data set condition will occur.

### SD Keyword

The SD keyword is used only in conjunction with the S command and when the DC keyword is specified as an asterisk (i.e., DC=*). This keyword determines the number of lines that will be written to a UEDIT work file.

The format is:

    SD=number

number | Default: The system programmer's setting of the SDSIZE sysparm.
Specifies the number of lines in the UEDIT work file.
Note that number must be an integer from 0 to 32767.

### SI Keyword

The SI keyword is used only in conjunction with the S command. This keyword determines the type of job queue information to be displayed.

The format is:

    SI=value

value | Specifies the type of information to be displayed from the input/output job queue. One of the following values can be specified:
For z/OS:
JL | The job to be displayed is on the input queue and a display of the JCL is requested.
SM | The job to be displayed is on the output queue and a display of the SMB information is requested.
SO | The job to be displayed is on the output queue and a display of the SYSOUT is requested.
SI | The job to be displayed is on the input queue and a display of the SYSIN is requested.
CC | The job to be displayed is on the output queue and a display of the condition codes is requested.
For z/VSE:
LS | The job to be displayed is on the power List queue.
PU | The job to be displayed is on the power Punch queue.
RD | The job to be displayed is on the Reader queue.

If you omit the SI keyword argument when you enter the S command, the default is SI=SM in z/OS, or SI=LS in z/VSE.

### SQ Keyword

The SQ keyword is used only in conjunction with the Q command. This keyword argument is used to sort the job queue display into a desired sequence.

The format is:

    SQ=[option]

option | Specifies the sorting sequence into which the job queue display is to be sorted. One of five values can be specified:
Q | The display is sorted by the type of job queue entry (input, output).
C | The display is sorted by the output class.
P | The display is sorted by the priority of the job queue entry.
N | The display is sorted by the jobname of the job queue entry.
# | The display is sorted by the job number of the job queue entry.

If you do not initialize the SQ keyword, the default job queue display will have no sorting in effect.

### WR Keyword

The WR keyword is used only in conjunction with the Q command after a unique job has been displayed. It sets the writer name of the job being displayed to the specified name.

The format is:

    WR=name

where name is any valid writer name (JES).

Note
Even though multiple jobs with the same job name exist in the output queue, you must obtain a unique display using the JB keyword before the WR keyword is accepted.

## Entering Operator Commands (Control User)

The UQ K command allows the entry of operator commands.

Any valid operator command may be issued from a Com-plete terminal if the terminal user has control status. The command format for performing this function is:

    *UQ K command

where command is any valid operator command.

### Example

The operator system's DISPLAY ACTIVE command can be invoked by entering the command while invoking UQ:

    *UQ K D A

Or the command may be entered after invoking UQ:

    K D A

After the entry of an operator command, the UQ utility displays the operator WTO messages at the Com-plete terminal.

### On this page

- Overview
- Security
- Command Format
- UQ Commands
- UQ Keywords
- Entering Operator Commands (Control User)