SHOWIN



SHOWIN

     Reports the status of input device files.  (CM)

SYNTAX


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

PARAMETERS


#Innn Identifier of particular input device file for which
you want information. The numeric portion of the
identifier is equivalent to the LDEV number. For
example, LDEV 20 will have an input device file
identifier of #I20. The 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 the 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. The syntax appears on the next page. FOR ITEM

SYNTAX FOR ITEM


[DEV=ldev]

{@J }
{@S }
[JOB={@ }]
{[ #]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 us device files for all
jobs and sessions.

[ #]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.

Default is @.

ACTIVE, OPENED, Displays the status of all input files in a
or READY 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

     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

     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 DFID is identical to the LDEV
                    number.

JOBNUM              Job or session number (jsnum) of job/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 will appear
                    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.

                    A 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.

     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)

     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

ADDITIONAL INFORMATION

Commands:   SHOWOUT

Manuals :   Performing System Operation Tasks (32650-90137)