The Com-plete online utility UQ enables you to obtain system status information.
This document covers the following topics:
The specific functions available with UQ are grouped into two categories:
Display operations;
Control 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 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.
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.
Certain functions of the UQ utility are restricted to users with control status. These functions are marked as such in this section.
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.
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.
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.
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.
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 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.
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.
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 |
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. |
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. |
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
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: | ||||||||||||||||||||||||
|
||||||||||||||||||||||||
SERIES | The type of disk unit defined. The codes used to designate unit types are: | |||||||||||||||||||||||
|
||||||||||||||||||||||||
STATUS | The mount status for the indicated unit and the disk volume on that unit. The status indicators are: | |||||||||||||||||||||||
|
||||||||||||||||||||||||
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. |
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
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.
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.
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:
Function: | any valid UQ function |
Operand/Command: | operand for the above UQ Function or operator command for sending the data to the console. |
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.
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.
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:
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:
- Function =' ' (blanks) has the same effect as Function='K ' if the Command field is not empty.
- 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.
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.
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: | ||||||||||||||||
|
||||||||||||||||
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: | |||||||||||||||
|
||||||||||||||||
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. |
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: | |||||||
|
||||||||
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: | |||||||
|
||||||||
ORIGIN | The JES3 job origin (ORG). |
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: | |||||||
|
||||||||
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: | |||||||
|
||||||||
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. |
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.
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
.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 |
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
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.
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.
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.
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. | |||||||
|
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 |
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.
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: | |||||
|
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 |
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.
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.
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.
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.
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: | |||||||||||||||||
|
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.
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: | ||||||
|
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.
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. |
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. |
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.
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.
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.
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
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).
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.
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.
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
. 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.
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: |
||||||||||||
cond | Default: EQ | |||||||||||
Specifies the condition under which the search is to be performed. One of six values can be specified: | ||||||||||||
|
||||||||||||
direction | Default: + | |||||||||||
Specifies the direction in which the search is to proceed. One of two values may be specified: | ||||||||||||
|
||||||||||||
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: |
||||||||||||
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.
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. |
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: | ||||||||||
|
||||||||||
For z/VSE: | ||||||||||
|
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.
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: | |||||||||
|
If you do not initialize the SQ keyword, the default job queue display will have no sorting in effect.
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.
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.
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.