HP 3000 Manuals HP 3000 Manuals
LISTSPF
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 }] [;DETAIL]
[ {(spoolid [,spoolid]...)}] [;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:
_____________________________________________________________________________
| |
| 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 |
_____________________________________________________________________________
Single-Line Display
* 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:
____________________________________________________________________________________
| |
| 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 |
| |
____________________________________________________________________________________
Two-Line Display
* 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:
____________________________________________________________
| |
| 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 |
| |
____________________________________________________________
Status Display
Related Commands
LISTFILE
PRINT
SPOOLF
SHOWIN
SHOWOUT