HP 3000 Manuals HP 3000 Manuals
The Spoolfile Interface Facility (SPIFF) (Cont.)
SPIFF commands (Cont.)
TEXT.
Accesses an output spool file for use by the ALTER, APPEND, BROWSE, COPY,
FIND, LIST, PURGE, and SHOW commands.
> T[EXT] {spoolfileid}
{* }
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.
XPLAIN.
Displays a summary of SPIFF commands.
Syntax.
> X[PLAIN]
Parameters.
The X[PLAIN] command has no parameters.
Operation Notes.
The XPLAIN command (abbreviated X) is implemented as the HELP SUMMARY
command. This serves two purposes:
* It retains SPOOK5's XPLAIN command in the form most nearly
compatible with that command.
* It provides a simple interface to that form of help for users who
would rather not concern themselves with some of the subtleties of
the revised HELP command.
Refer to the HELP command description for further details.