358 Chapter 5
Command Definitions L-O
LISTSPF
You may use some wildcards; J@ accepts all jobs, S@ accepts all
sessions. J'@ and S'@ are also allowed, The apostrophe (') indicates an
imported spool file or a spool file recovered during START NORECOVERY.
• parm ::= RECS: Number of records in the spool file. A positive integer is
expected.
• parm ::= OWNER: The user under which the spool file was created. The
format of the owner is user.account. If the account is not specified, the
user's current account is assumed. You can use wildcards.
For a job input spool file, the OWNER is the user logon for the job, not the
job or session that streamed it.
• parm ::= JOBABORT: Select based on whether or not this is the
$STDLIST of a job which aborted when an error was encountered but no
CONTINUE was in effect.
Valid values are TRUE and FALSE. Only "=" and "<*gt;" are allowed as
relational operators.
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 ::= DATE: Creation date in the format mm/dd/yy or mm/dd/year. Note
that the year can be in the form of yy, as in 10/10/88, or in the form of
year, as in 10/10/1988; both are legal syntax for the DATE parameter.
^indirect_file The indirect_file parameter specifies the name of a file containing the
selection equation. It must be preceded by a caret (^). The selection
equation contained in the file may not exceed 509 characters in length,
including the brackets in which it must reside. There is no restriction on
the indirect file code. If the record size exceeds 509, only 509 characters
per record are read and a warning is issued. Backreferencing to a formal
file designator is also allowed for an indirect_file name; that is, ^*filename is
allowed. Any file is accepted as an indirect_file, unless the file system
returns an error from FOPEN or FREAD.
There is no limit to the number of records in the indirect_file, only the total
character count.
Records are processed as follows:
• Leading and trailing blanks are stripped.
• If the last nonblank character is an ampersand (&), it is also stripped;
otherwise, one blank is added back to the end of the record as a
delimiter.
• The character count of the record is added to that of the records
processed previously. If the total character count exceeds 509, an error
is returned. If the total is less than 509, the current record is appended
to previous records.
