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