HP 3000 Manuals HP 3000 Manuals
SHOWOUT
Displays the status of output device files.
Syntax
[{#Onnn }]
SHOWOUT [{STATUS }]
[{SP }]
[{item[;item[;...]]}]
Parameters
#Onnn Identifies a particular output device file for
which you want information. The information is
displayed in Type I format, which is described in
the "Operation Notes" section of this command. The
default is to display status information for all
output device files used by the logon job or
session.
The number of the device file identifier is
identical to the LDEV number of the device. For
example, if the LDEV number is 20, the device file
identifier appears in the DFID column as #20.
STATUS Summarizes the status information for all current
output device files. The information is displayed
in Type II format, described in the "Operation
Notes" section. The default is to display status
information for all output device files used by the
logon job or session.
SP Displays the status information for currently
spooled output device files associated with the
logon job or session. The information is displayed
in a combination of two formats, Type I format
followed by Type II format, which is described in
the "Operation Notes" section. The default is to
display status information for all output device
files used by the logon job or session.
item Displays the status of all current output device
files as identified. If information for only one
device file is displayed, the output appears in
Type I format. If information for more than one
device file is displayed, the output appears in
Type I format followed by Type II format. The
syntax for item follows:
Syntax for Item
[ {@J }] [{ACTIVE }]
[ {@S }] [{OPENED }]
[DEV={ldev }][JOB= {@ }] [{LOCKED }]
[ {classname}][ {[#]Jnnn}] [{READY [,N]}]
[ {[#]Snnn}] [{ [,D]}]
Parameters for Item
ldev or classname Displays the status of output device files. The
ldev parameter displays the files residing on the
device identified by the logical device number.
The classname parameter displays the status of the
output device files residing on all devices in a
class name.
JOB= Displays the status of output device files using
one of the following options:
@J Displays the status of output
device files for all jobs.
@S Displays the status of output
device files for all
sessions.
@ Displays the output device
files for all jobs and
sessions.
[#]Jnnn Displays all output device
files for specified job.
[#]Snnn Displays the status of all
output device files for a
specified session.
ACTIVE, OPENED, Displays status of all output files in the
READY, or LOCKED specified state. An ACTIVE file is one that is
currently being produced on your printer or
plotter. Only one output spoolfile can be ACTIVE
at any one time. OPENED files are those being
accessed by a program. A spoolfile will be OPENED
when a spooler process is writing the file to disk;
during that time, however, the file is not ready to
be printed. READY files are completely spooled and
ready to be output. A LOCKED file is READY but
cannot be accessed until the system relinquishes
its exclusive use of the file.
READY files may include one of the following:
N Displays the status of
nondeferred READY device
files.
D Displays the status of
deferred READY device files.
Operation Notes
This command displays the status information for one or more currently
defined output device files. The information reflects the status at the
time the command is entered and always appears on the standard list
device. Two types of spooling queues are maintained in MPE/iX, one
output queue for each logical device configured on the system and one
additional queue for all device classes. Within each queue, files are
linked according to the following parameters and listed in descending
order of importance by output priority, device class, and rank. If the
priorities are equal, the spooler alternates between queues.
Information about all spoolfiles on the system is available only from the
console. Information about spoolfiles created in a specific job or
session is available during that job or session only.
To list information about an individual output device file, you may
specify its device file identifier (DFID) in the SHOWOUT command:
SHOWOUT #O26
DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C
EPOC #O26 #J242 $STDLIST READY 36 D 1 1
OUTFENCE = 6
The information provided in this format is defined as follows:
COLUMN MEANING
DEV/CL Logical device number or device class name of the
device.
DFID Device file identification, which begins with the
letter O (not zero) followed by a number. The
numeric portion of the DFID is identical to the
LDEV number of the device.
JOBNUM The job/session number (jsnum) of job or session
using the device file.
FNAME File name assigned to device file.
STATE The status, indicated by one of the following
subparameters:
ACTIVE The spooled device file on
disk is actually being
written to a printer or
plotter.
OPENED The device file on disk is
being accessed by a program.
If the device file is
spooled, a program is
currently writing to the
disk.
READY The spooled device file on
disk is ready for output.
LOCKED READY, but the system has
exclusive access to the file.
FRM The forms message indicator (the letter F) appears
only if a forms alignment message applies to this
device file.
SPACE The approximate disk space currently being used,
expressed in sectors. This applies only to spooled
output device files.
RANK The ranking of the file and its order in the system
with respect to other files of the same output
priority and classname or ldev. A time stamp
activated by the FCLOSE intrinsic determines the
file's rank.
The letter D following RANK indicates a deferred
file. This applies only to spooled device files.
A file can be deferred if its priority is less than
or equal to system outfence or to the outfence of a
specific device.
PRI The output priority requested by a user or as
adjusted by the system operator for spooled device
files only. A priority of 1 is lowest, and 13 is
highest.
#C Number of copies needed, for spooled device files
only.
The output may appear in two possible formats or in
a combination of the two formats:
Type I:
DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C
32 #O32 #S16 $STDLIST OPENED
OUTFENCE=6
Type II:
19 FILES
O ACTIVE
2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED
17 OPENED; INCLUDING 1 SPOOFLE
0 LOCKED; INCLUDING 0 SPOOFLES
3 SPOOFLES: 1572 SECTORS
OUTFENCE = 6
OUTFENCE = 2 FOR LDEV 13
Use
This command may be issued from a session, job, program, or in BREAK.
Pressing Break aborts the execution of this command.
Examples
To display the total number of output device files currently existing,
the number of those that are spooled, and their current status, enter:
SHOWOUT STATUS
11 FILES:
1 ACTIVE
1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED
9 OPENED; INCLUDING 1 SPOOFLES
0 LOCKED; INCLUDING 0 SPOOFLES
3 SPOOFLES: 7212 SECTORS
OUTFENCE= 2
:
You can also request information about a specific output device file,
device number or device class name of the device for which the file is
destined in the SHOWOUT command:
SHOWOUT DEV=43
DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C
43 #O43 #S37 $STDLIST OPENED
OUTFENCE= 2
:
Related Information
Commands SHOWIN, LISTSPF
Manuals Performing System Operation Tasks (32650-90137)