PIPE EXPOSE
Syntax
EXPOSE .- --RESPECT-. |--EXPOSE--+------------+--+----------+-------------------------| +- --FORCE---+ '- --NOLOG-' +- --COMMAND-+ '- --TOTRAP--'
Command Description
EXPOSE causes messages in the pipeline to be exposed and consists
of the following actions:
- Passing a message to installation exit 02A
- TRAP (or &WAIT) processing
- Matching for action in automation table (message automation)
- Passing a message to installation exit 16
- ASSIGN COPY routing
- Logging to the network log, system log, or hardcopy log, as appropriate.
Streams
| Stream Type | Number Supported |
|---|---|
| Input | 1 |
| Output | 1 |
Termination Conditions
EXPOSE terminates when the input stream disconnects.
Operand Descriptions
- COMMAND
- Specifies that messages that are generated by the processing
of a command in a previous CORRCMD, NETVIEW, MVS™, or VTAM® stage
is exposed before being absorbed into the pipeline. It is an error
to specify COMMAND unless a previous CORRCMD, NETVIEW, or VTAM stage exists in the pipeline
specification. If more than one previous CORRCMD, NETVIEW, or VTAM stage exists in the pipeline
specification, then only the one nearest to the EXPOSE stage is affected.
Use of the COMMAND option allows a NETVIEW stage to successfully process command procedures that use TRAP MESSAGES (or &WAIT).
When COMMAND is specified, the effect of the EXPOSE stage occurs entirely before the messages are absorbed into the pipeline. There is no further action when the messages pass through EXPOSE at its position in the pipeline.
When COMMAND is specified, the command itself (command echo) is also exposed.
COMMAND implies RESPECT.
- FORCE
- Specifies that messages are exposed to exit 02A, message automation, and exit 16 regardless of whether they have been previously exposed to those interfaces.
- NOLOG
- Specifies that messages are processed as indicated by other specified keywords, but no logging is to occur.
- RESPECT
- Specifies that messages that have already been exposed to exit 02A, message automation, or exit 16 is not exposed to the same interfaces again. The default value is RESPECT.
- TOTRAP
- Specifies that messages are only exposed to TRAP processing. TOTRAP implies NOLOG.
Usage Notes
- EXPOSE cannot be a first stage.
- Exposure can cause messages to be deleted. For example, if message automation matches the message and DISPLAY(NO) is the action, then that message is considered deleted and does not continue in the pipeline. Such deletion can affect the processing of CORRWAIT, TOSTRING, and TAKE that follow a CORRCMD, NETVIEW, MVS, or VTAM stage.
- Exposure causes null characters (X'00') in messages to be translated into blanks (X'40').