HP 3000 Manuals

SHOWIN [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

SHOWIN 

Reports the status of input device files.

Syntax 

SHOWIN [#Innn ] [;SP] [;item [;item [;...]]]
       [STATUS]
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 

           [     {@J     }]
           [     {@S     }][{ACTIVE}]
[DEV=ldev] [JOB= {@      }][{OPENED}]
           [     {[#]Jnnn}][{READY }]
           [     {[#]Snnn}]
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    Displays the status of all input files in a
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 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     #I1088  #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.

JOBNUM                Job or session number (jsnum) of 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      #I80  #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      #I80  #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       #I81  #S38   MASTER    OPENED
     26      #I36  #S18   $STDIN    OPENED
     32      #I85  #S41   $STDIN    OPENED
     34      #I58  #S26   $STDIN    OPENED
     42      #I64  #S28   $STDIN    OPENED
     43      #I80  #S37   $STDIN    OPENED
     50      #I84  #S40   $STDIN    OPENED
     51      #I35  #S17   $STDIN    OPENED

     8 FILES (DISPLAYED):
         0 SPOOFLES:  0 SECTORS

Related Information 

Commands      SHOWOUT, LISTSPF

Manuals       Performing System Operation Tasks (32650-90137)



MPE/iX 5.0 Documentation