Spooler Utilities Reference Manual

Peruse
Spooler Utilities Reference Manual—522295-003
3-34
LIST Command
If you do not specify OUT list-file, output is directed to the OUT file-name
specified when Peruse was started (the home terminal by default). If you specify
E[DIT], S[POOL], or C[OMPRESS] without specifying OUT list-file, these
keywords have no effect.
!
specifies that list-file is to be purged, if it exists, and a new list file is to be
created before listing begins. If list-file exists and you do not specify “!”, new
data is appended to any data already in the file if the file is a spooler job file, an
EDIT file, or an entry-sequenced file.
page-range
describes the set of pages to be listed to list-file and can be
A[LL] | page [ / page ]
where page is
{ F | L | * | number } [ + number | - number ]
The set of pages can be identified by absolute page numbers or with a base-offset
notation. Absolute page numbering begins with the first page as page 1. Base-
offset notation uses a base, which can be F (the first page), L (the last page), or *
(the current page). An offset is then added to or subtracted from the base to define
the page.
The total number of pages you can access ranges from 0 through 999,999.
If you do not specify page-range, the last page of the job is listed.
If the offset page number you specify represents a negative-numbered page,
Peruse returns an error.
If the page you specify has a number that exceeds the 999,999 page limit, Peruse
returns an error.
If the page you specify is greater than the the total number of pages in the job,
Peruse accesses the last page of the job.
C
if list-file is not a spooler job file or spooler collector, causes formatting-
control information (CONTROLs, CONTROLBUFs, and SETMODEs) embedded in
the job to be written to list-file along with the print data. Normally, this
information is suppressed, except when listing to a spooler job file or spooler
collector. For details about formatting control, refer to the Guardian Programmer's
Guide.
N
if list-file is a spooler job file or a spooler collector, prevents formatting-control
information (CONTROLs, CONTROLBUFs, and SETMODEs) embedded in the job