Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Displays the status of output device files. (CM)
{#Onnn } SHOWOUT [{STATUS }] {SP } {item[;item[;...]]}
#Onnn Identifies a particular output device file for which you want information, displayed in Type I format as described in the OPERATION section. The number of the device file identifier is identical to the LDEV number of the device. For example, if the LDEV number is 20, the device file identifier is #020. The default is to display status information for all output device files used by the logon job or session. STATUS Summarizes the status information for all current output device files. The information is displayed in Type II format, described under "OPERATION". Default is a display of status information for all output device files used by the logon job or session. SP Displays the status information for currently spooled output device files associated with the logon job or session. The information is displayed in Type I followed by Type II format, described under "OPERATION". Default is a display of status information for all output device files used by the logon job or session. item Displays the status of all current output device files as identified. If information for only one device file is displayed, output is in Type I format; if information for more than one device file is displayed, output is in Type I followed by Type II format.
{ldev } [DEV={classname}] {@J } {@S } [JOB={@ }] {[ #]Jnnn } {[ #]Snnn } {ACTIVE } [{OPENED }] {LOCKED } {READY [,N] } [,D]
ldev or classname Displays the status of output device files. The ldev parameter displays the files residing on the device identified by the logical device number. The classname parameter displays the status of the output device files residing on all devices in a class name. JOB= Displays the status of output device files using one of the following options. @J Displays the status of output device files for all jobs. @S Displays the status of output device files for all sessions. @ Displays the output device files for all jobs and sessions. [ #]Jnnn Displays all output device files for specified job. [ #]Snnn Displays the status of all output device files for a specified session. ACTIVE, OPENED, READY, or LOCKED Displays status of all output files in the specified state. An ACTIVE file is one that is currently being produced on your printer or plotter. Only one output spoolfile can be ACTIVE at any one time. OPENED files are those being accessed by a program. A spoolfile will be OPENED when a spooler process is writing the file to disk; during that time, however, the file is not ready to be printed or. READY files are completely spooled and ready to be output. A LOCKED file is READY but cannot be accessed until the system relinquishes its exclusive use of the file. READY files may include one of the following N Displays the status of nondeferred READY device files. D Displays the status of deferred READY device files.
This command displays the status information for one or more currently defined output device files. The information reflects the status at the time the command is entered and always appears on the standard list device. Two types of spooling queues are maintained in MPE/iX, one output queue for each logical device configured on the system and one additional queue for all device classes. Within each queue, files are linked according to the following parameters and listed in descending order of importance output priority, device class, and rank. If the priorities are equal, the spooler alternates between queues. To list information about an individual output device file, you may specify its device file identifier (DFID) in the SHOWOUT command SHOWOUT #O26 DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C EPOC #O26 #J242 $STDLIST READY 36 D 1 1 OUTFENCE = 6 COLUMN MEANING DEV/CL Logical device number or device class name of the device. DFID Device file identification, in the form #Onnn. The numeric portion of the device file identifier is identical to the LDEV number of the device. JOBNUM The job/session number (jsnum) of job/session using the device file. FNAME File name assigned to device file. STATE The status, indicated by one of the following subparameters ACTIVE The spooled device file on disk is actually being written to a printer, plotter, or card punch. OPENED The device file on disk is being accessed by a program. If the device file is spooled, a program is currently writing to the disk. READY The spooled device file on disk is ready for output. LOCKED READY, but the system has exclusive access to the file. FRM The forms message indicator (the letter F) appears only if a forms alignment message applies to this device file. SPACE The approximate disk space currently used in sectors. This applies only to spooled output device files. RANK The ranking of the file. Its order in the system with respect to other files of the same output priority and classname or ldev. A time stamp activated by the FCLOSE command determines the file's rank. A D following RANK indicates a deferred file. This applies only to spooled device files. A file can be deferred if its priority is less than or equal to system outfence or to the outfence of a specific device. PRI The output priority requested by user or as adjusted by the system operator for spooled device files only. A priority of 1 is lowest, and 13 is highest. #C Number of copies needed, for spooled device files only. The output may appear in two possible formats or in a combination of the two formats Type I DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 45 #045 #S16 $STDLIST OPENED OUTFENCE=6 Type II 19 FILES O ACTIVE 2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED 17 OPENED; INCLUDING 1 SPOOFLE 0 LOCKED; INCLUDING 0 SPOOFLES 3 SPOOFLES 1572 SECTORS OUTFENCE = 6 OUTFENCE = 2 FOR LDEV 13 ** LDEV 13 is assigned an ** ** outfence of 2. ** This command may be issued from a session, job, in BREAK, or from a program. Pressing [Break] aborts the execution of this command.
To display the total number of output device files currently existing, the number of those that are spooled, and the states that they are in, enter SHOWOUT STATUS 11 FILES 1 ACTIVE 1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED 9 OPENED; INCLUDING 1 SPOOFLES 0 LOCKED; INCLUDING 0 SPOOFLES 3 SPOOFLES 7212 SECTORS OUTFENCE= 2 You can also request information about a specific output device file, device number or device class name of the device for which the file is destined in the SHOWOUT command SHOWOUT DEV=43 DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 43 #043 #S37 $STDLIST OPENED OUTFENCE= 2
Commands: SHOWIN Manuals : Performing System Operation Tasks (32650-90137) Back to Main Index