SHOWOUT


SHOWOUT

     Displays the status of output device files.  (CM)

SYNTAX


{#Onnn }
SHOWOUT [{STATUS }]
{SP }
{item[;item[;...]]}


PARAMETERS


#Onnn Identifies a particular output device file for which
you want information, displayed in Type I format as
described in the OPERATION section. 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 is #020.
The default is to display 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".
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". 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.


SYNTAX FOR ITEM


{ldev }
[DEV={classname}]
{@J }
{@S }

[JOB={@ }]
{[ #]Jnnn }
{[ #]Snnn }

{ACTIVE }
[{OPENED }]
{LOCKED }
{READY [,N] }
[,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,
READY, or LOCKED
Displays status of all output files in the 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 or. 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

     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 output priority,
device class, and rank. If the priorities are equal, the
spooler alternates between queues. 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

COLUMN MEANING

DEV/CL Logical device number or device class name of the
device.

DFID Device file identification, in the form #Onnn. The
numeric portion of the device file identifier is
identical to the LDEV number of the device.

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, plotter, or
card punch.

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. 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 command determines the
file's rank.

A 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 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 #045 #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 ** LDEV 13 is assigned an **
** outfence of 2. **

This command may be issued from a session, job, in BREAK, or
from a program. Pressing [Break] aborts the execution of
this command.


EXAMPLE(S)

     To display the total number of output device files currently
existing, the number of those that are spooled, and the
states that they are in, 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 #043 #S37 $STDLIST OPENED

OUTFENCE= 2

ADDITIONAL INFORMATION

Commands:   SHOWIN

Manuals : Performing System Operation Tasks (32650-90137)