PIPE APPEND
Syntax
Command Description
APPEND defines a pipeline that runs after the preceding stage is complete. Arguments to APPEND are a series of stage specifications separated by the same stage separator (STAGESEP) character defined for the pipeline. Because the same stage separator is used, it must be escaped using either the defined escape character (ESC) or using the self-escaping technique of coding duplicate stage separators.
APPEND begins processing by initializing the stages specified as arguments. The first stage coded after APPEND is treated as a first stage and the last stage generated by APPEND has its primary output stream connected to the input stream of the stage following APPEND.
For more information on STAGESEP, ESC, and the self-escaping technique, issue HELP PIPE SYNTAX.
For more information on STAGESEP, ESC, and the self-escaping technique, see PIPE (NCCF).
Streams
| Stream Type | Number Supported |
|---|---|
| Input | 1 |
| Output | 1 |
Operand Descriptions
- ||
- The stage separator used within the APPEND definition. This stage
separator must be the same as that used in the rest of the pipeline.
However, it must be escaped using either the defined ESC character
or using the self-escaping technique of coding two stage separators
together.
If an APPEND is included within an APPEND, the inner APPEND must escape the stage separators of the higher-level APPEND. For example, if the first APPEND uses || for its stage separator, an APPEND within that APPEND uses ||||.
- stage_specification
- A complete stage specification including parameters. The stage_specification cannot include labels or connectors.
Usage Notes
- All processing of the preceding stage must complete before the APPEND stages are run.
- APPEND stages can be nested.
Example: Switch and Send LIST DST Results to Operator
The following switches the DSILOG, waits for the completion of the switch, issues a LIST DST and sends the results of both commands to the operator:/* Route SWITCH and LIST DST output to operator with attributes*/
'PIPE (NAME APPNXMP)'
'| NETVIEW SWITCH DSILOG,P', /* Begin the switch */
'| CORRWAIT 30', /* CORRWAIT several seconds */
'| PRESATTR UND', /* Underscore SWITCH output only */
'| APPEND', /* following stages run after wait */
' || NETV LIST DSILOG', /* list runs AFTER switch completes*/
' || WAIT 5', /* this wait starts AFTER LIST runs*/
' || PRESATTR REVERSE', /* reverse-video LIST output */
'| PRESATTR YELLOW', /* color output of both cmds yellow*/
'| CONSOLE' /* send command outputs to console */