COPY

Syntax

   > C[OPY] [spoolfileid [,spoolfileid [,...] ];

             * ;

             username[.acctname];

             seleq ; ] 



   [range[,filename] ]

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 COPY command (abbreviated C) copies all or a range of one or more spool files to a new spooled device file (filename). The new spool file is closed at the end of the command and enters the READY state. Spool files may be designated explicitly in a list (for example, #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. If you have TEXTed in #O18450, but you then COPY #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:

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.

Entering CtrlY during command execution stops the execution after the current record is transferred. The current target file is closed. The current source file remains open as the current spool file.

When you interrupt a copy 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 target 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

   COPY #O6490;ALL

Creates a new spool file with attributes identical to #O6490.

   COPY [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 copies to the target file following the environment information.

   COPY 101,102,103;ALL,*MYPP

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

COPY [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.

COPY 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

> COPY 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.

   >COPY ALL, *MYPP

   You have no current TEXT file (SPERR 81)

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