APPEND

Syntax

   > AP[PEND]

   [  [spoolfileid [,spoolfileid [,...] ];

       * ;

       username[.acctname ];

       seleq 

       ;] [range[,filename] ]  

   END ]  

where range is

   [ [recnumber[{+ offset]

                 -}

      * [{+ offset]

          -} 

      FIRST [{+ offset]

              -}

      LAST  [{+ offset]

              -} ] 

                     

                     

     [,count

      /recnumber[{+ offset]

                  -} 

      / * [{+ offset]

            -} 

      / FIRST [{+ offset]

                -}

      / LAST [{+ offset]

               -}

   ALL ]

Semantics

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.

The following situations, although syntactically valid, are semantic errors and are flagged as such:

Operation Notes

The APPEND command (abbreviated AP) appends all or a range of one or more spool files to a new spooled devicefile (filename in the syntax above). Spool files may be designated explicitly in a list (#O12345, #O67890), by user and/or account (MYUSER.MYACCT), or by selection equation.

If you have a current spool file you may omit the source file specification and SPIFF will take its source from the current spool file. It is an error to omit the source file specification if you do not have a current spool file.

The last source file processed remains as the current spool file, regardless of any earlier current spool file. For example, if you have TEXTed in #O18450, but you then APPEND #O18451,#O18452;ALL, the current spool file at the end of the command is #O18452.

The target file must be a local spooled device file. An ordinary disc file, a spooled device file on a remote node, or a non-spooled device file (such as a tape drive) is not supported and, if specified, results in an error.

The FCOPY subsystem can be used to create such a target file, but this is not recommended: except for the remotely spooled device file, doing so deletes information from the target file, which is usually vital to printing data properly. Once this information has been deleted, it cannot be recovered.

Examples of such information include the following:

A remotely spooled device file—one that exists on another system node—is not supported and, if specified, results in an empty spool file on the remote system and an error message. SPIFF cannot delete this empty spool file on the remote system.

Once a target device file has been opened, any spool files specified in this command or subsequent APPEND commands are appended to it until an APPEND END command is entered. At that time, the device file is closed and enters the READY state. The next APPEND command will open a new target device file.

	NOTE: If you use the seleq or username.acctname form, and if this resolves to more than one file, the order in which these files are appended to the target file is determined by the underlying LISTSPF command generated by SPIFF. In general, for a given device or class queue, the order of source spool files is determined first by output priority, then by the time they first entered the READY state. To ensure a specific order in the target file, enter an explicit list of spoolid's. These will be processed in left-to-right order.

Entering CtrlY during command execution stops the execution after the current record is transferred. The current target file remains open for possible use by subsequent APPEND commands. The current source file remains open as the current spool file.

When you interrupt an append operation with CtrlY, the identity of the last record transferred is usually not known. Therefore, you should regenerate the file or use it to create a new append file with the desired subset of records.

Examples

EXAMPLES OF range:

   */*+20

   *-20/*

   ALL

   FIRST/LAST

   */LAST

   LAST-100/LAST

   FIRST,20

   100/200

   5

EXAMPLES OF COMMANDS:

   FILE MYLP;DEV=LP

   FILE MYPP;DEV=PP;ENV=MYENV



   APPEND #O6490;ALL

Creates a new spool file with attributes identical to #O6490. The new spool file remains open until closed with APPEND END.

   APPEND [OWNER=MYUSER.MYACCT];ALL,*MYPP

Creates a new spool file targeted to device class PP using environment file MYENV. Spool files belonging to MYUSER.MYACCT are appended to this environment information.

   APPEND 101,102,103;ALL,*MYPP

This is the same as the previous example, except that an explicit list of spoolfileid's has been used.

APPEND [OWNER=SOMEBODY.ELSE];ALL,*MYLP

The specified fileset contains no accessible spoolfiles. (SPERR 82)

The user does not have SM or OP capability or is not an AM user in the ELSE account.

APPEND 10000;ALL

One or more of the specified spoolfile(s) is invalid. (SPERR 44)

Spool file #O10000 does not exist or is inaccessible to this user.

Assume that MYLP is a terminal for a session and that spoolfileid 101 was sent to it.

> :FILE MYLP=$STDLIST

> APPEND 101;ALL

The target of a COPY or APPEND command must be a local spooled devicefile (SPERR 124)

>

Redefining the attributes of MYLP makes it impossible to copy spoolfileid #O101 to MYLP.

   >APPEND ALL, *MYPP

   You have no current TEXT file (SPERR 81)

No source spool file is specified nor was one opened in an earlier command.

> T #O357

> FIND @ "header: Start APPEND at next line"

100 This is the end of the header: Start APPEND at next line

>APPEND */LAST, *MYPP

After LISTing or FINDing a line, the current record pointer is advanced to the next record. Here the APPEND will start with record number 101.