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 information is to be displayed. The
information is displayed in Type I format,
described under "Operation Notes." Default is a
display of status information for all output device
files used by the logon job or session.
STATUS Summarizes the status information for all current
output device files. The information is displayed
in Type II format, described under "Operation
Notes." Default is a display of 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
Type I followed by Type II format, described under
"Operation Notes." Default is a display of 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, output is in Type I
format; if information for more than one device
file is displayed, output is in Type I followed by
Type II format. Refer to "Operation Notes." 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 #O11470
DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C
EPOC #O11470 #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, in the form #Onnn.
Note that this identifier begins with the
alphabetic character O, not a zero.
JOBNUM The job/session number (jsnum) of job/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 used 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
45 #032 #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 #089 #S37 $STDLIST OPENED
OUTFENCE= 2
:
Related Information
Commands SHOWIN, LISTSPF
Manuals Performing System Operation Tasks (32650-90137)