LIST

Lists a line range of the currently TEXTed spool file to $STDLIST.

Syntax

   > L[IST] [range]

where range is

   [ [recnumber[{+

                 -} offset ]

      * [{+

          -} offset]

      FIRST [{+

              -} offset]

      LAST [{+

             -} offset] ] [, count

                                                              / recnumber[{+

                                                               -} offset]

                                                              / * [{+

                                                                    -} offset]

                                                              / FIRST [{+

                                                                        -} offset]

                                                              / LAST [{+

                                                                       -} offset] ]

   ALL ]

Semantics

The LIST command operates only on the currently TEXTed spool file. It is an error if used when there is no current spool file.

Range expressions are limited to:

(first line number of file) <= expression <= (last line number of file).

Lines are numbered from 0 to N-1. No error is generated for exceeding these limits; SPIFF simply limits the expression. For example, FIRST-2 evaluates to FIRST.

Specifying a first position range expression that evaluates to a greater line number than that of the second position range expression is an error.




	NOTE: The expression, not its components, is tested. A range of `LAST/FIRST` is always an error, but a range of `LAST-20/FIRST+40` is valid for any file consisting of no more than 61 lines (numbered 0 to 60).

Parameters

range: The range of lines of the spool file to list. By default (when the range parameter is omitted), only the current record is listed; this is equivalent to LIST *. Any line number specified that is outside the range of lines in the spool file will be handled as though FIRST or LAST was specified, as appropriate. If your range consists of two expressions, the first expression must evaluate to a number no larger than the second.
ALL: Specifies that all of the records in the spool file should be listed. No other range element is allowed if this keyword is used.
FIRST: The first record in the spool file.
LAST: The last record in the spool file.
*: The current record in the spool file.
recnumber: An absolute record or line number of text in the spool file. Records are numbered starting with 0.
offset: A relative number of records before (-) or after (+) the specified record.
count: A numeric value, the number of lines to be listed, including the starting record.

Operation Notes

The LIST command (abbreviated L) lists a range of records of the current spool file to $STDLIST. Omitting the range parameter is the same as specifying LIST *. In either case, the current record pointer is left at the record following the last record in range, or at LAST, whichever is less.

It is an error to use the LIST command if you do not have a current spool file.




	NOTE: The ouput of the `LIST` command does not pause at nominal screen intervals the way that the output from `HELP` does. To list short intervals of the spool file, enter a command such as `> LIST /+10` as many times as you need to view the portion(s) of the file that you wish to see.

Examples

EXAMPLES OF range:




   */*+20

   *-20/*

   ALL

   FIRST/LAST

   */LAST

   LAST-100/LAST

   FIRST,20

   100/200


   5

EXAMPLE OF A COMMAND:

LIST FIRST/10

  0

  1

  2 :JOB MYJOB,MYUSER.MYACCT.

  3 PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS.

  4 JOB NUMBER = #J624.

  5 THU, DEC 19, 1991, 10:24 AM.

  6 HP3000  RELEASE: B.30.00   USER VERSION: B.30.00

  7 MPE XL  HP31900 B.08.14  Copyright Hewlett-Packard 1987.

  8 All Rights Reserved.

  9 STREAMED BY MYUSER.MYACCT (#S385) ON LDEV# 43

 10    STREAM DATE:   THU, DEC 19, 1991, 10:24 AM

LIST

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Semantics

Parameters

Operation Notes

Examples