634 Chapter 8
Command Definitions SP-Z
SPOOLF
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 may 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 this is the $STDLIST of a job that aborted
when an error was encountered when no CONTINUE was in effect.
Valid values are TRUE and FALSE. Only "=" and "<>" 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 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 also 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 non-blank 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.
• This process repeats until either 509 characters have been counted or
the end-of-file is detected. Records terminating with or without
ampersands may be mixed as desired in the indirect file.
