IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

PIPE TSO
tso_command
A TSO line mode command to be invoked at the TSO server. Tso_command is
required when TSO has no input stream and is otherwise optional.
If tso_command is specified, the command is invoked once if the TSO stage has
an input stream. Otherwise, the command is invoked when an input message
is passed to the TSO stage.
If tso_command is not specified, the commands to be invoked are read from the
input stream.
Usage Notes
240 Programming: Pipes
Note: Long running commands, such as IPTRACE, and commands requiring a
dialog, such as ACCOUNT, are not supported.
v Command responses are delayed until command completion. For example, a
TSO command that issued a message every 2 seconds and runs for 10 seconds
delays 10 seconds before issuing 5 messages together.
v Command execution is single threaded for each server.
v Commands requiring a dialog are not supported. However, data for a dialog can
be assembled into a multiline message. This multiline message can be used to
drive a TSO REXX procedure managing the dialog within TSO.
v Command authority is checked prior to and after submitting the command.
Prior to submission authority is checked for the pipe stage and for the verb of
the TSO command. The verb of the TSO command is the first blank delimited
token. To permit only BOSS to use the TSO stage, code the following statements:
PROTECT *.*.DSIPITSO
PERMIT BOSS *.*.DSIPITSO
The verb of the TSO command is treated as the value of the PROTECT keyword
VERB for authority checking purposes. For example, if you want to prevent
operators from issuing a PIPE TSO IPTRACE command, code the following
statements:
PROTECT *.*.DSIPITSO.VERB.IPTRACE
The specified server is treated as the value of the PROTECT keyword TSOSERV
for authority checking purposes. For example, to prevent operators from using
server USER1 in combination with the started job SERVJOB1, code the following
statements:
PROTECT *.*.DSIPITSO.TSOSERV.USER1/SERVJOB1
See the START command in the NetView online help for additional information
on started jobs.
Note: The TSO stage cannot resolve TSO synonyms. All command synonyms
must be protected.
TSO performs command authority checking using the same rules that apply
when the TSO user name is directly logged-on.
Return Codes
A secondary output stream can be connected to receive command response codes.
Each code begins with a 10-digit, 0-padded, signed number. Nonzero codes
indicate an error and are followed by a space and keyword indicating the source of
the error such as +0000000100 PPI.
The keyword can be one of the following keywords: