HPlogo Commands Reference HP 3000 Series 9X8LX Computer Systems > Chapter 2 MPE/iX Commands

LISTSPF
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

The LISTSPF command produces a listing of input and output spooled files. The information reflects the status at the time you enter the command and always appears on the standard list device.

Syntax



   LISTSPF [ [IDNAME=] { spoolid

                         (spoolid [,spoolid]...) } ] [;DETAIL

                                                    ;STATUS]

Parameter Definitions

IDNAME

Specifies one or more spool file IDs. #Innn represents input spool files and #Onnn represents output spool files. The spooling subsystem assigns these IDs when the spool files are created.

Rules for use of this parameter are as follows:

  • Use # optionally, but if you use it, make sure to include an I or O with the # symbol. #O is assumed if you do not specify either #I or #O.

  • Use @ to specify all spool files.

  • Use I@ to specify all input spool files. All input spool files reside in @.IN.HPSPOOL.

  • Use O@ to specify all output spool files. All output spool files reside in @.OUT.HPSPOOL.

  • You must have account manager (AM) capability when specifying O@ in order to display all output spool files created by users in the same account. Similar rules apply to I@ and @.

  • You must have system manager (SM) or system supervisor (OP) capability when specifying O@ in order to display all output spool files on the system. Similar rules apply to I@ and @.

  • All users without AM, SM, or OP capability are limited to displaying only files that they have created.

The default display is all of the output spool files created by the current user.account. The default display for the console user is all of the output spool files on the system.

DETAIL

Produces a two-line description of the specified spool file(s), rather than the default one-line description. You cannot specify the STATUS parameter with this parameter.

STATUS

By default, LISTSPF displays a listing of selected spool files, followed by a statistical summary of these spool files, known as the status summary. If you specify the STATUS parameter, the system only displays the status summary. You cannot specify the DETAIL parameter with this parameter.

Operation Notes

  • Usage

    You can enter this command from a session, a job, a program, or in break mode. Pressing Break aborts the execution of this command.

  • First line fields and description

    The first line of the display for LISTSPF appears as shown in the following example:

    

   SPOOLID  JOBNUM  FILEDES  PRI  COPIES  DEV    STATE   RSPFN   OWNER



   #01      J12345  $STDLIST   6       1  EPOC   CREATE  RSPFN   THISUSER.ACCOUN

    Descriptions of the fields are as follows:

    SPOOLID

    Indicates the unique spool file identifier. You can display this output spool file by entering PRINT 01.OUT.HPSPOOL.

    JOBNUM

    Indicates the job or session identifier of the job or session that created the spool file.

    FILEDES

    Indicates the formal or actual file designator for the spool file. The name of a file equation becomes its formal file designator. For instance, printing to a file equation, such as FILE EPOCLONG;DEV=EPOC;ENV=LP88LONG.HPENV.SYS, creates spool files whose formal designator is EPOCLONG.

    PRI

    Indicates the input or output priority of the spool file.

    COPIES

    Indicates the total number of copies of the spool file to be printed.

    DEV

    Indicates the spool file's destination as an LDEV, device name, or device class name. LDEVs intentionally appear with leading zeroes to simulate a device name.

    STATE

    Indicates the current state of the spool file as described below:

    • CREATE: An output spool file is being created; an output spooled device has been opened and is being written to, which generates an output spool file. When the device closes, the spool file enters the ready state.

    • READY: An output spool file is ready to be printed or an input spool file is ready to be accessed.

    • ACTIVE: An input spool file is being read from a stream file or a spooled device to a disk.

    • OPEN: A JOB input spool file (the $STDIN for a batch job) is being accessed by the job's CI process, or a data input spool file is being accessed by a process.

    • PRINT: An output spool file is printing.

    • DEFER: An output spool file is in a deferred state.

    • SPSAVE: Either you specified the SPSAVE option when you created the spool file or when the spool file would have been deleted after its final copy printed. The final copy has printed, so the spool file is now in this state instead of being deleted.

    • PROBLM: The target device of the spool file does not match any device name or device class on the system. This usually occurs because you have restored the spool file to a system that has a different configuration from the system where you stored the spool file.

    • DELPND: Either the spooler has printed the last copy of the output spool file and is waiting for you or others to close the spool file before purging it, or you or others have requested that the spool file be purged and the deletion is pending on file management processing to finish.

    • XFER: The spool file has been selected for transport from one network another.

    RSPFN

    The columns under these letters are defined as follows:

    • R indicates a restartable spooled job file.

    • S indicates that you have specified SPSAVE for this spool file. The spool file is saved in the OUT.HPSPOOL group and account after the last copy prints.

    • P indicates that the spool file is private.

    • F indicates that the spool file has a forms message associated with it and requires special forms on which to print. If a formid is present, you can show its identity by specifying the DETAIL parameter and looking on the second line of the display for the given spool file.

    • N indicates that the spool file is incomplete because sufficient account-level, group-level, or system disk space was unavailable when you created the spool file, or the system aborted while you were creating the spool file.

    OWNER

    Indicates the fully qualified name of the creator of the spool file.

  • Second line fields and description

    The optional second line of the display for LISTSPF;DETAIL appears as shown in the following example:

    

   FORMID   JOBNAME      COPSRM   SECTS   RECS   PAGES    DATE         TIME

   

            TESTJOB           1   250      500    ~9      12/20/88    8:39

    Descriptions of the fields are as follows:

    FORMID

    Indicates an 8-character display, the first of which is a letter. If an F appears in the RSPFN column but this field is blank, the file has a forms message, but formid was not specified.

    JOBNAME

    Indicates the job or session name of the user who created the spool file or, for a job input spool file, the name of the job that will use the input spool file as its $STDIN file.

    COPSRM

    Indicates the number of copies of this file that remain to be printed, including any currently printing copy.

    SECTS

    Indicates the number of sectors that the spool file occupies.

    RECS

    Indicates the number of records in the spool file.

    PAGES

    Indicates the number of physical pages in the spool file.

    DATE

    Indicates the date that the file first entered the ready state in month/day/year form (mm/dd/yy).

    TIME

    Indicates the time that the file first entered the ready state in 24-hour form (hh:mm).

  • Status display fields and description

    The status display appears as shown in the following example:

    

   INPUT SPOOL FILES           OUTPUT SPOOL FILES

   ACTIVE   = 1;               CREATE    = 2;       READY    = 3;

   OPEN     = 2;               DEFER     = 1;       SELECTED = 4;

   READY    = 3;               DELPND    = 0;       SPSAVE   = 1;

                               PRINT     = 1;       XFER     = 0;

                               PROBLM    = 0;





   TOTAL IN FILES  =  6;       TOTAL OUTFILES    = 8;

         IN SECTORS = 144;           OUT SECTORS = 13090;

   

   OUTFENCE  = 6

   OUTFENCE  = 10 FOR LDEV  6

    Descriptions of the fields are as follows:

    ACTIVE

    Indicates the number of input spool files being read from a stream file or a spooled device to a disk.

    OPEN

    Indicates the number of JOB input spool files (the $STDIN for a batch job) that are being accessed by the job's CI process, or the number of data input spool files that are being accessed by a process.

    READY

    Indicates the number of input spool files ready to be accessed.

    CREATE

    Indicates the number of output spool files being created.

    DEFER

    Indicates the number of output spool files in a deferred state.

    DELPND

    Indicates the number of output spool files that the spooler is waiting for you or others to close before it purges them. This can also indicate the number of spool files that you or others have requested be purged, but deletion is pending on file management processing to finish.

    PRINT

    Indicates the number of output spool files that are printing.

    PROBLM

    Indicates the number of spool files for which the target device does not match any device name or device class on the system.

    SELECTED

    Indicates the number of output spool files whose output priority is higher than the global outfence. This field shows the sum of files printing plus the ready files whose output priority is higher than the global outfence.

    SPSAVE

    Indicates the number of output spool files in this state instead of being deleted after printing. This state occurs if you specified the SPSAVE option of the SPOOLF command when you created the spool file or when the spool file would have been deleted after its final copy printed.

    XFER

    Indicates the number of output spool files selected for transport from one network to another.

    TOTAL IN FILES

    Indicates the total number of input spool files.

    IN SECTORS

    Indicates the sector count for input spool files.

    TOTAL OUTFILES

    Indicates the total number of output spool files.

    OUT SECTORS

    Indicates the sector count for output spool files.

    OUTFENCE

    Indicates the global outfence and any device-specific outfences.

Examples

  • To display all output spool files for the current user.account not using the console, enter:

    

   :LISTSPF

    The system responds by producing the following display:

    Figure 2-6 Single-Line Display

    



SPOOLID  JOBNUM  FILEDES  PRI COPIES DEV          STATE RSPFN  OWNER



#0123    J12     SP        13      2 PP           PRINT    F   DEV.HPE

#0124    S14     LIST       9      1 00000012     READY    F   DEV.HPE

#0128    J144    $STDLIST   8      1 EPOC         READY        DEV.HPE

#01233   S1234   OUTLIST    0      1 FASTLP       DEFER        DEV.HPE



INPUT SPOOL FILES       OUTPUT SPOOL FILES

ACTIVE  = 0;            CREATE   = 0;        READY    = 2;

OPEN    = 0;            DEFER    = 1;        SELECTED = 3;

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

                        PRINT    = 1;        XFER     = 0;

                        PROBLM   = 0;



TOTAL IN FILES   = 0;   TOTAL OUTFILES    = 4;

      IN SECTORS = 0;         OUT SECTORS = 5964;



OUTFENCE  = 6

  • To display all spool files for the current user.account not using the console, enter:

    

   :LISTSPF @;DETAIL

    The system responds by producing the following display:

    Figure 2-7 Two-Line Display

    

   SPOOLID JOBNUM   FILEDES PRI COPIES  DEV        STATE  RSPFN  OWNER

           FORMID   JOBNAME     COPSRM  SECTS      RECS   PAGES  DATE     TIME

   

   #O123   J12      SP       13      2  PP         PRINT     F   DEV.HPE

                    TESTJOB          1  250        500      125  07/09/88 8:39

   

   #O124   S14      LIST      9      1  00000012   READY     F   DEV.HPE

           PAYCHECK TESTJOB          1  250        500       ~9  12/20/88 8:39

   

   #O128   J144     $STDLIST  8      5  EPOC       READY           DEV.HPE

                    LPJOB            3  250        127       21 12/20/88 22:19

   

   #O1233  S1234    OUTLIST   0      1  FASTLP     DEFER DEV.HPE

                    TESTJOB          1  250        500       ~9  12/20/88 8:39

   

   #I564   J164     $STDIN              00000010   READY          DEV.HPE

                    BATCHJOB            17         12             2/20/88  22:23

   

   

   INPUT SPOOL FILES       OUTPUT SPOOL FILES

   ACTIVE  = 0;            CREATE  = 0;                READY    = 2;

   OPEN    = 0;            DEFER   = 1;                SELECTED = 3;

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

                           PRINT   = 1;                XFER     = 0;

                           PROBLM  = 0;

   

   TOTAL IN FILES   = 1;   TOTAL OUT FILES    = 4;

         IN SECTORS = 17;        OUT SECTORS  = 1000;

   

   OUTFENCE  = 6

  • To display abbreviated information for all output spool files of the current user.account not using the console, enter:

    

   :LISTSPF;STATUS

    The system responds by producing the following status display:

    Figure 2-8 Status Display

    

   INPUT SPOOL FILES       OUTPUT SPOOL FILES

   ACTIVE  = 0;            CREATE  = 0;    READY    = 2;

   OPEN    = 0;            DEFER   = 1;    SELECTED = 3;

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

                           PRINT   = 1;    XFER     = 0;

                           PROBLM  = 0;

   

   TOTAL IN FILES   = 0;   TOTAL OUTFILES    = 4;

         IN SECTORS = 0 ;        OUT SECTORS = 1000;

   

   OUTFENCE  = 6

Related Commands



   LISTFILE

   PRINT

   SPOOLF

   SHOWIN

   SHOWOUT


LISTGROUP
  		 


LISTUSER  
Feedback to webmaster