SHOWIN

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


SHOWIN


     Reports the status of input device files.

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)

Back to Main Index