SHOWIN

Reports the status of input device files.

Syntax

SHOWIN [ #Innn STATUS ] [;SP] [;item [;item [;...]]]

Parameters

#Innn

Identifies the particular input device file for which information is to be displayed. Default is that MPE/iX displays information for all input device files used by the logon job or session.

STATUS

Summarizes the status information for all current input device files. Default is that MPE/iX displays information for all input device files used by the logon job or session. The information appears in following format:

 8 FILES DISPLAYED
   0 ACTIVE
   0 READY;INCLUDING 0 SPOOFLES, 0 DEFERRED
   8 OPENED; INCLUDING 0 SPOOFLES
   0 SPOOFLES; 0 SECTORS
 0 LOCKED; INCLUDING 0 SPOOFLES

SP

Displays status information for the currently spooled input device files associated with the logon job or session. Default is a display of status information for all input device files.

item

Displays the status of current input device files as identified. Default is that MPE/iX displays status information for all input device files used by this job.

Syntax for Item

[DEV=ldev] [JOB={ @J @S @ [ #]Jnnn [ #]Snnn }] [{ ACTIVE | OPENED | READY }]

Parameters for Item

ldev

Displays the status of input device files identified by logical device number ldev.

JOB=

Displays the status of input device files. JOB= may be one of the following options:

@J: Displays the status of input device files for all jobs.
@S: Displays the status of input device files for all sessions.
@: Displays the status of device files for all jobs and sessions. (Default.)
[#]Jnnn: Displays the status of all input device files for a specified job.
[#]Snnn: Displays the status of all input device files for a specified session.

ACTIVE, OPENED, or READY

Displays the status of all input files in a specified state. ACTIVE displays the status of active device files. OPENED displays the status of opened device files. READY displays the status of ready device files.

Operation Notes

This command displays the status information about one or more currently defined input device files. This information reflects the status at the time the command is entered, and always appears on the standard list device. Except for the keyword STATUS, which has its own format (refer to "Parameters"), the format of the information is as follows:

 DEV/CL DFID  JOBNUM FNAME  STATE   FRM SPACE RANK PRI #C
 10     #I10  #J133  $STDIN OPENED

The information displayed in this format is defined as follows:

COLUMN

MEANING

DEV/CL

Logical device number of device.

DFID

Device file identification in the form #Innn. The number displayed in the DFID is identical to the LDEV number.

JOBNUM

Job or session number (jsnum) of the job or session using the device file, if not used for READY or ACTIVE data. Otherwise, the job/session name appears on the line following standard device information.

FNAME

File name associated with the device file.

STATE

One of the following:

ACTIVE: Input being read from a spooled device to a disk.
READY: Input spooling completed; file is now ready for use by a program.
OPENED: A file is being accessed by a program.

FRM

Forms message indicator. The letter F appears only if a forms alignment message applies to the device file. Does not apply to input files.

SPACE

Approximate disk space currently used (in sectors), for jobs only.

RANK

The order in which the file is entered into the system with respect to other files of the same priority and class name or logical device.

The letter D following RANK indicates a deferred file for spooled device files only. A file can be deferred if its priority is less than or equal to the system outfence or the outfence of a specific device.

PRI

The outpriority of the device file, requested by the user or adjusted by the system operator. Specified for spooled output device files only.

#C

The number of copies needed, specified for spooled output device files only.

Use

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

Examples

The following is an example of how to determine the status of an individual input device file:

  SHOWIN #I80
 
 DEV/CL DFID JOBNUM FNAME   STATE   FRM SPACE RANK PRI #C
 43     #I43 #S37  $STDIN   OPENED              8

If you do not know the device file identification number (DFID) of the device file whose status you want to determine, you may request the status display by entering either the logical device number or the device class name of the device on which the file originated:

  SHOWIN DEV=43
 
 DEV/CL DFID JOBNUM FNAME  STATE  FRM SPACE RANK PRI #C
 43     #I43 #S37  $STDIN  OPENED

You may also request displays of device file information using various combinations of qualifications (devices, jobs/sessions, and states). For example, to display information about all OPENED input device files used by all sessions (but not jobs) in the system, enter:

  SHOWIN JOB=@S;OPENED
 
 DEV/CL DFID JOBNUM FNAME   STATE FRM SPACE RANK PRI #C
 7      #I7  #S38  MASTER  OPENED
 26     #I26 #S18  $STDIN  OPENED
 32     #I32 #S41  $STDIN  OPENED
 34     #I34 #S26  $STDIN  OPENED
 42     #I42 #S28  $STDIN  OPENED
 43     #I43 #S37  $STDIN  OPENED
 50     #I50 #S40  $STDIN  OPENED
 51     #I51 #S17  $STDIN  OPENED
 8 FILES (DISPLAYED):
   0 SPOOFLES: 0 SECTORS

Related Information

Commands: SHOWOUT, LISTSPF
Manuals: Performing System Operation Tasks (32650-90137)