Chapter 5 357
Command Definitions L-O
LISTSPF
• parm ::= PAGES: Number of pages in the spool file (if known). A positive
integer number is expected. This attribute does not apply to input spool
files; therefore, any logical condition involving the attribute always
returns FALSE when tested against an input spool file.
• parm:= FORMID: Form name. You can use wildcards. (The formid is an
ASCII string up to 8 characters, the first of which must be a letter.).
This attribute does not apply to input spool files; therefore, any logical
condition involving the attribute always returns FALSE when tested
against an input spool file.
You may also select files based on a null string by entering FILEDES=
"" or FILEDES= ''. You must include such a construct if you specifically
want to select such an attribute. Note that "" is not the same as " ";
the blank is significant.
• parm:= STATE: The state can be one of READY, ACTIVE, OPEN,
CREATE, PRINT, PROBLM, DELPND, SPSAVE, DEFER, XFER.
• parm ::= JOBNAME: Job or session name under which the spool file was
created. The job name can consist of up to 8 alphanumeric characters,
the first of which must be a letter.
For a job input spool file, the JOBNAME shown is allocated to that job,
not the job or session that streamed it.
You may use wildcards. The JOBNAME=@ parameter is a different use of
the @ symbol in that it wildcards an optional field. The omission of this
optional parameter indicates that all entries are displayed whether or
not a job name exists.
• parm ::= DISP: Disposition: SPSAVE or PURGE. This attribute does not
apply to input spool files; therefore, any logical condition involving the
attribute always returns FALSE when tested against an input spool
file.
• parm ::= COPIES: Number of copies. Minimum is 1, maximum is 65,535.
This attribute does not apply to input spool files; therefore, any logical
condition involving the attribute always returns FALSE when tested
against an input spool file.
• parm ::= PRI: Output priority. Minimum is 0, maximum is 14.
• parm ::= JOBNUM: Job or session number under which the spool file was
created, for example: #S257, #J329, or Sn (the "#" is optional) where 1 ≤
n ≤ 16,383. (The comma is shown for clarity; do not enter any commas in
the actual equation.)
For a job input spool file, the JOBNUM shown is allocated to the job, not
the job or session that streamed it.
