 |
» |
|
|
|
Accesses an output spool file for use by the ALTER, APPEND, BROWSE, COPY, FIND, LIST, PURGE, and SHOW commands. Parameters | |
- spoolfileid
An existing spoolid to which the user has access. This parameter must begin with a number or with a pound sign (#). The full syntax is [#O]nnnnn, where the n's represent digits. If the # is used, the O must also be used. If the O is used without the #, an error message is displayed. - *
The current spool file—one that has been TEXTed in, or is current because it is the last spool file processed by the COPY, APPEND or BROWSE command. If this form is used when no spool file has been TEXTed, an error message is displayed.
Operation Notes | |
The TEXT command (abbreviated T) opens the specified output spoolfileid for use as the currently TEXTed spool file. If another spool file has been TEXTed in previously, it is first closed. TEXTing in a spool file enables the * parameter of the ALTER, APPEND, BROWSE, COPY, PURGE, SHOW, and TEXT commands. Once * is enabled, you may, if you wish, omit a spoolfileid specification in the APPEND, BROWSE, and COPY commands. A currently TEXTed spool file is required for the FIND and LIST commands. The TEXT * form of the command closes the current spool file without TEXTing in another. It is an error to use this form if there is no current spool file. Other issues to be aware of include these: Native mode spool files have no LOCKED state; therefore, there is no indication that a spool file has been opened with the TEXT command. The spool file state does not change as a result of its being opened by SPIFF. The PURGE * command close the current spool file as part of its operation, allowing the PURGE to complete. This is consistent with SPOOK5 behavior. You may TEXT in an output spool file in the CREATE state. Once it is the current spool file, you may execute the APPEND, COPY, FIND, and LIST commands on it. Each such command obtains the current end-of-file before evaluating its range expression. The BROWSE, INPUT, OUTPUT, and STORE commands are not allowed; they require exclusive access to the file. The PURGE command is not allowed on a file that is in the CREATE state. The last spool file processed by the APPEND, BROWSE, or COPY command is left open as the current spool file.
|
