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

PIPE XCFMSG
Syntax
XCFMSG:
XCFMSG group_name
.member_name
Command Description
The XCFMSG stage sends and receives messages using z/OS XCF signaling
services. Sending one-way messages and receiving unsolicited messages is
supported.
Streams
Stream Type Number Supported
Input 1
Output 1
Termination Conditions
The XCFMSG stage terminates when the primary output stream is disconnected.
Operand Descriptions
Usage Notes
PIPE XCFMSG
group_name
Specifies the name of the group on which to listen, or the group that contains
the member to whom a messages is being sent. The value can be 1–8
characters in length.
member_name
Specifies the name of the member to receive the message. For DSIPLXnn
groups, the member name must be the NetView domain name.
v The XCFMSG stage accepts one input stream. If it is connected, the stage sends
out the input message. If it is the first stage in the pipeline, the pipe receives
messages from the specified group. The member_name option is not valid for
receiving messages.
v For sends, the primary output is the message sent. For receives, the primary
input is the received message, which is the second line of the multiline BNH590I
message.
v If a multiline message is passed to the stage, separate XCF sends are done for
each line of the message. You can use the JOINTCONT stage command to
consolidate a multiline message and then use the SPLIT stage command in the
receiving pipeline to preserve multiline messages.
v XCF messages can only be sent to or received from XCF groups to which the
NetView program belongs.
v Only one XCF receive PIPE stage can be outstanding for a group at any given
time.
Chapter 2. Pipeline Stages and Syntax 269