HPlogo Native Mode Spooler Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 Utilities

SHOW

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Displays information about one or more spool files.

Syntax

   > S[HOW]  [ spoolfileid [,spoolfileid [,...] ]

               *

               [username[.acctname] 

                seleq ] [;[@

                           I

                           O] ] ] 

Parameters

none

Displays all spool files (input and output) belonging to the logon user in the logon account.

spoolfileid

An existing spoolid to which the user has access. To be taken as a spoolid (instead of a username), this parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn or [#I]nnnnn, where the n's represent digits. If the # is used, the O or "I" must also be used. If the O or "I" is used without the #, the parameter is interpreted as a username and will probably cause an error. Default: All output spool files created by the logon user in the logon account.

*

The current spool file—one that has been TEXT ed in, or is current because it is the last spool file processed by the COPY, APPEND, or BROWSE command. If this form is used when no spool file has been TEXTed, an error message is displayed.

When this parameter is specified, the current spool file is displayed using LISTSPF's DETAIL (two-line) display format.

username

The name of a user on the system. Full MPE wildcarding is supported. The SPIFF user must have access to files generated by username. Refer to “Security ”.

acctname

The name of an account on the system. Full MPE wildcarding is supported. Default: the logon account is assumed. The SPIFF user must have access to files generated by users in acctname. Refer to “Security ”.

seleq

A native mode spooler selection equation specifying the set of spool files to be shown. The selection equation must be enclosed in brackets as in the following example that displays all spool files created by the user MANAGER.SYS with priority less than 3:

   SHOW [OWNER=MANAGER.SYS AND PRI<3]

If you choose this (seleq) form of file set selection, SPIFF inserts an OWNER=!HPUSER.!HPACCOUNT in its internal selection equation, unless you explicitly include your own OWNER definition. This prevents users with SM, OP, or AM capabilities from accidentally accessing files that they did not create.

Consult one of the following documents for more information about selection equation syntax and semantics:

  • MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115)

  • MPE/iX online help facility

@

Displays selected files using LISTSPF's DETAIL (two-line) format. Omitting this parameter displays selected files in LISTSPF's one-line format. @ is valid only when selecting files with username.acctname or with seleq.

I

Restricts display to input spool files. I is valid only when selecting files with username.acctname or with seleq.

O

Restricts display to output spool files. O is valid only when selecting files with username.acctname or with seleq.

NOTE: You may specify both I and O to display both input and output spoofiles. This is equivalent to specifying neither.

Operation Notes

The SHOW command (abbreviated S) displays attributes of one or more spool files using the MPE/iX LISTSPF command format. The display may be in either the one-line or two-line format of the LISTSPF command, according to your specification of the SHOW command:

  1. The two-line format is produced in either of these cases:

    • SHOW spoolfileid (or a list of spoolfileids), or SHOW

    • SHOW username.acctname or seleq with the ;@ option.

  2. The one-line format is produced in all other cases.

When the username.acctname or seleq form is used, the @, I, and O keywords may be used in any combination or repeatedly. Once used, each parameter enables its option for the duration of the command and cannot be disabled. Thus @IOI@OO@I and @@@@@@@@ are both valid.

Examples

SHOW ;O



SPOOLID    JOBNUM   FILEDES  PRI COPIES DEV      STATE  RSPFN OWNER



#O7817     J166     $STDLIST   2      1 LP       CREATE       MYUSER.MYACCT

#O7820     S104     MYFILE     2      1 PP       READY        MYUSER.MYACCT



INPUT SPOOL FILES            OUTPUT SPOOL FILES

ACTIVE   = 0;                CREATE   = 1;              READY    = 1;

OPEN     = 0;                DEFER    = 0;              SELECTED = 0;

READY    = 0;                DELPND   = 0;              SPSAVE   = 0;

                             PRINT    = 0;              XFER     = 0;

                             PROBLM   = 0;



TOTAL IN FILES   = 0;        TOTAL OUT FILES   = 2;

      IN SECTORS = 0;              OUT SECTORS = 2128;



OUTFENCE = 6



> SHOW *



You have no current TEXT file. (SPERR 81)

> TEXT 7820

> SHOW *



SPOOLID    JOBNUM   FILEDES  PRI COPIES DEV      STATE  RSPFN OWNER

           FORMID   JOBNAME      COPSRM SECTS    RECS   PAGES DATE     TIME



#O7820     S104     MYFILE     2      1 PP       READY        MYUSER.MYACCT

                                      1 80       234       ~4 01/07/92 08:42



INPUT SPOOL FILES            OUTPUT SPOOL FILES

ACTIVE   = 0;                CREATE   = 0;              READY    = 1;

OPEN     = 0;                DEFER    = 0;              SELECTED = 0;

READY    = 0;                DELPND   = 0;              SPSAVE   = 0;

                             PRINT    = 0;              XFER     = 0;

                             PROBLM   = 0;



TOTAL IN FILES   = 0;        TOTAL OUT FILES   = 1;

      IN SECTORS = 0;              OUT SECTORS = 80;



OUTFENCE = 6




> SHOW MYUSER.MYACCT;@O



SPOOLID    JOBNUM   FILEDES  PRI COPIES DEV      STATE  RSPFN OWNER

           FORMID   JOBNAME      COPSRM SECTS    RECS   PAGES DATE     TIME



#O7817     J166     $STDLIST   2      1 LP       CREATE       MYUSER.MYACCT

                    MYJOB             1 2048     0



#O7820     S104     MYFILE     2      1 PP       READY        MYUSER.MYACCT

                                      1 80       234       ~4 01/07/92 08:42



INPUT SPOOL FILES            OUTPUT SPOOL FILES

ACTIVE   = 0;                CREATE   = 1;              READY    = 1;

OPEN     = 0;                DEFER    = 0;              SELECTED = 0;

READY    = 0;                DELPND   = 0;              SPSAVE   = 0;

                             PRINT    = 0;              XFER     = 0;

                             PROBLM   = 0;



TOTAL IN FILES   = 0;        TOTAL OUT FILES   = 2;

      IN SECTORS = 0;              OUT SECTORS = 2128;



OUTFENCE = 6

>

Feedback to webmaster