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

PIPE TSO
PIPE TSO
Syntax
238 Programming: Pipes
TSO:
TSO
(ECHO) tso_command
Command Description
TSO transfers a command to a NetView TSO server, which is a batch job submitted
by NetView or a started task. The command is executed and the results returned.
Specify CORRWAIT to follow TSO to enable the return of command responses.
Commands can be passed on the stage or on the input stream. If tso_command is
not specified and a multiline message is received on the primary input stream, the
first line of the message is considered the TSO command and all other message
lines are passed as the data of that command. If tso_command is specified, that
command is executed for each input message or only once if there is no primary
input stream.
When TSO has a primary input stream and no tso_command is specified, the
command to be executed is read from the primary input stream. The message
input to the TSO stage at the time the TSO command is scheduled is passed to the
TSO server for execution. The message data is contained in a sequential file
userid.NVCMDIN that is allocated as DD NVCMDIN. NVCMDIN is not allocated if
there is no current message for the command.
A secondary input stream can be connected to TSO. The secondary input stream
must contain records that contain the TSO user ID optionally followed by the TSO
server job member name. The user ID and server job member name must be
separated by at least one blank. If the server job member name is not specified, it
defaults to CNMSJTSO. The default server is the server specified for this operator
by the START command.
If a secondary input stream is not connected, the TSO server started for the issuing
operator is used. The default operator is specified on the START command.
The TSO server job member name is specified on the START command with the
TSOSERV and MEM keywords.
Each primary input stream message is associated one-for-one to each secondary
input stream message. That is, for each primary input stream message there can be
a secondary input stream message indicating the TSO server where the primary
input stream messages are to be sent. If either the primary or secondary input
stream is exhausted before the other, the remaining input on the active input
stream is discarded. If no secondary input stream is defined, all messages on the
primary input stream are sent to the TSO server started for the issuing operator.