HP 3000 Manuals HP 3000 Manuals
Displaying Information About Spool Files--the LISTSPF Command
Use the LISTSPF command to obtain information about input and output
spool files. The general form of the LISTSPF command is:
LISTSPF[[IDNAME=] {spoolid }] [[;SELEQ=] {select-eq }]
[ {(spoolid [,spoolid]...)}] [ {^indirect_file }]
[;DETAIL]
[;STATUS]
For a detailed explanation of this command and its parameters refer to
chapter 4.
The set of spool files that you are allowed to see depends on your
capabilities.
Information by SPOOLID
Use the following command to obtain information by spool file identifier
(SPOOLID) for specific output spool files:
LISTSPF IDNAME=O357
This command works if any one of the following applies:
* You created the spool file.
* You are the account manager (AM) of the creator's account.
* You have system manager (SM) or system operator (OP) capability.
* You are the console user.
You may omit the keyword IDNAME and the O. Enter:
LISTSPF 357
If you have more than one SPOOLID, you may string them as follows:
LISTSPF IDNAME=357,375,458
By grouping multiple id names within parentheses you may omit the IDNAME
keyword:
LISTSPF (357,375,458)
If the O is omitted, the default is output SPOOLIDs. To specify input
SPOOLIDs, you must precede each identifier with I.
Use the following command to obtain information about multiple spool
files (those spool files residing in IN.HPSPOOL and OUT.HPSPOOL):
LISTSPF @
This command displays information for the following:
* all spool files in IN.HPSPOOL and OUT.HPSPOOL, if you are the
console user, or if you have SM or OP capability
* all spool files created by any user in your logon account, if you
have AM capability
* all spool files in your user.account, if you are a user other than
a console user
If you are the console user, to obtain information about all output spool
files, you may also enter:
LISTSPF
If you are not the console user, you can use this same command to obtain
information about all output spool files for your user.account.
NOTE The SPOOLIDs provided in these examples are for illustrative
purposes only. You would use actual SPOOLIDs from your
environment.
Using wildcards in the SPOOLID
You may use wildcards in specifying the SPOOLID in the following way:
@ Specifies all spool files if you are the console user or
have SM or OP capability, specifies input and output spool
files by any user of your logon account if you have AM
capability, or specifies all spool files for your
user.account if you are any other user.
O@ Specifies all output spool files if you are the console
user or have SM or OP capability, specifies all output
spool files created by any user of your logon account if
you have AM capability, or specifies all output spool files
for your user.account if you are any other user.
I@ Specifies all input spool files if you are the console user
or have SM or OP capability, specifies all input spool
files created by any user of your logon account if you have
AM capability, or specifies all input spool files for your
user.account if you are any other user.
@, O@ and I@ are mutually exclusive. In other words, you may use only
one at a time.
If you are the console user or a user with SM or OP capability and you
want to obtain information about all output spool files, enter:
LISTSPF O@
If you are a user with AM capability, the LISTSPF O@ command displays all
output spool files created by users in your account. If you are any
other user, the LISTSPF O@ displays all the output spool files for your
user.account.
If you are not the console user and do not have SM or OP capability, to
obtain information about input spool files for your user.account, enter:
LISTSPF I@
If you are the console user or you have SM or OP capability, LISTSPF I@
displays all input spool files. If you have AM capability, LISTSPF I@
displays all input spool files created by any user in your logon account.
Listing only the statistical summary
Used with only the ;STATUS option of the LISTSPF command, the display is
limited to a statistical summary of spool file data, known as a status
display. If you are not the console user, to see only this summary for
the spool files for your user.account without listing the spool files,
enter:
LISTSPF ;STATUS
If you are the console user, LISTSPF ;STATUS displays the status for all
spool files.
If you are not the console user, to see this summary for all spool files
to which you have access without listing the spool files, enter:
LISTSPF @ ;STATUS
NOTE If you use ;STATUS in combination with ;DETAIL, you get an error
message.
Listing more detailed information
To obtain a more detailed set of information regarding spool files, you
may add the ;DETAIL parameter to the LISTSPF command as follows:
LISTSPF IDNAME=O234;DETAIL
Selecting information on subsets of spool files the SELEQ option
A useful feature of the LISTSPF command is the ability to define or
select a subset of spool files for which to obtain information. This is
accomplished by using a selection equation with the ;SELEQ= parameter.
For example, suppose that you are the console user and you want to obtain
spool file information for all output spool files with an output priority
of less than 8. You would enter:
LISTSPF;SELEQ=[PRI < 8]
If you have AM capability, this command displays information for all
output spool files created by users in your logon account; otherwise, it
displays information for all output spool files in your user.account.
NOTE The selection equation, in this case, PRI < 8, must be enclosed in
brackets.
Using AND and OR in the selection equation.
You may use the logical operators AND and OR in the selection equation.
If you use AND and OR in the same selection equation, AND takes
precedence over OR unless you use parentheses to indicate otherwise.
If you are not the console user, to select information for all output
spool files created by your user.account that have an output priority
less than 8 and that were sent to LDEV 6, you would enter:
LISTSPF;SELEQ=[PRI < 8 AND DEV = 6]
In this example, the LDEV number (6) was used with DEV =. Even so, you
could also use a device name or device class name.
This command displays information for all spool files which meet the
selection criteria if you are the console user.
For example, if you are not the console user, to obtain information for
all output spool files created by your user.account with priority less
than or equal to 10 or with destination device EPOC you would enter:
LISTSPF;SELEQ=[PRI <= 10 OR DEV = EPOC]
This command displays information for all output spool files on the
system that meet the selection criteria if you are the console user.
Excluding items in the selection equation.
Use NOT to exclude specified items. You may use NOT with AND and OR.
If you are the console user or if you have SM or OP capability, to select
all spool files not created by MANAGER.SYS, enter:
LISTSPF @;SELEQ=[NOT(OWNER=MANAGER.SYS)]
If you are not the console user, to select output spool files in your
user.account that do not have a priority of 8, enter:
LISTSPF;SELEQ=[NOT(PRI=8)]
If you are the console user, this command selects from all output spool
files that have a priority of 8.
Suppose that you are the console user or you have SM or OP capability.
The following command line uses AND and selects all spool files created
with formal file designator MRKTDATA that have not been routed to device
class LP:
LISTSPF @;SELEQ=[FILEDES=MRKTDATA AND NOT (DEV=LP)]|
Suppose that you have AM capability. The following command line uses OR
and selects all spool files created by users in your logon account that
have priority 8 or are not in the ready state:
LISTSPF @;SELEQ=[PRI=8 OR NOT(STATE=READY)]
Using wildcard characters.
Wildcards are also supported in selection equations specifying owners.
Use the @ sign to represent any combination of characters. For example,
if you are the console user and you want to select all output spool files
created by any user in the MFG account, you would enter:
LISTSPF;SELEQ=[OWNER=@.MFG]
If you want to do the same thing but you are a user with SM or OP
capability and not a console user, enter:
LISTSPF @;SELEQ=[OWNER=@.MFG]
In a selection equation that specifies a job number, you may use J@ and
S@ to specify all job numbers and all session numbers respectively. If
you do not have SM, OP, or AM capability nor are you the console user,
the following example displays all your spool files that were created by
a job:
LISTSPF @;SELEQ=[JOBNUM=J@]
This command displays all spool files that were created by a job if you
are the console user or if you have SM or OP capability. If you have AM
capability, this command displays all spool files that were created by a
job in your logon account.
You may also specify a specific job or session number.
NOTE Spool file job and session numbers are transposed from the J'nnn or
S'nnn format to the `Jnnn or Snnn format whenever you perform a
system START with the NORECOVERY option or whenever you import
files to the system with RESTORE or the SPFXFER utility.
In the above command, J@ or S@ does not select output spool files
with job/session identifiers in the Jnnn or Snnn format. To select
these use J@ or S@ instead. Similarly, to select a single
job/session number use Jnnn or Snnn.
Using the indirect file with ;SELEQ=.
The indirect file is a convenient way to avoid the extra keystrokes
associated with often-used and complex selection equations. An indirect
file is simply an ASCII file that contains the selection equation. When
you use the LISTSPF command you enter the indirect file instead of the
selection equation.
Suppose that you want to select all spool files sent to formal file
designator MRKTDATA but not sent to device LP. You would put the
selection equation
[FILEDES=MRKTDATA AND NOT (DEV=LP)]
into an ASCII file using any HP 3000 text processor. This ASCII file
would then be your indirect file. Remember to include both left and
right brackets ( [ ] ) as part of the selection equation.
In the following example, the indirect file is named INDFILE. To use the
indirect file with the LISTSPF command, enter: LISTSPF command, indirect
file
LISTSPF;SELEQ=^INDFILE
You may give your file any name that suits you. You must remember to
always precede the indirect file with the ^ sign.
Relational operators for the selection equation
You may use the following relational operators in the ;SELEQ equation:
= equal
<> not equal
> greater than
>= greater than or equal
< less than
<= less than or equal
Parameters for the selection equation
Use the above relational operators with any of the following keyword
parameters to construct the selection equation of your choice.
DEV * LDEV number, device name, or device class name
FILEDES * Formal file designator
SPOOLID * Spool File identifier number
PAGES Number of pages in spool file
FORMID * Form name
STATE * State
JOBNAME * Job or session name
DISP * Disposition (PURGE or SPSAVE)
COPIES Number of copies requested
PRI Output priority
JOBNUM * Job or session number under which spool file
was created
RECS Number of records in spool file
OWNER * Owner in user.account format
JOBABORT * $STDLIST of job that aborted with no continue
in effect (TRUE or FALSE)
DATE Creation date in mm/dd/yy or mm/dd/yyyy format
NOTE The asterisk (*) indicates that only relational operators = and <>
may be used with that keyword in the above list.