SHOWOUT

Displays the status of output device files.

Syntax

SHOWOUT [{ #Onnn 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

[DEV={ ldev classname }]

[JOB={ @J | @S | @ | [@,]username.acctname |[jsname,] username.acctname}

[;[INTRO | EXEC | SUSP | WAIT [ ,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. 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