IXGCONLS – Connect, wait (WTOR) and disconnect a log stream
Function:
This sample JCL procedure will invoke a program to connect to
the input log stream, issue a WTOR, and disconnect from the log stream
after receiving the message reply.
Use:
This procedure can be used by a system programmer to request that
a log stream connection be established and maintained until the WTOR
reply is given (as an alternative to writing a program to perform
the connection). To allow this program to maintain the log stream
connection for the desired period of time, use the TIME= specification
on the EXEC statement.
Syntax:
s ixgconls,logstrm=log_stream_name
Parameters:
log_stream_name
Name of the log stream to be connected.
Output:
When the procedure completes successfully, the following actions
will happen:
Message IXG273I will be issued to the console indicating that
the log stream was connected.
Message IXG227E will be issued to the console indicating that
the log stream will remain connected until a reply is provided.
Message IXG273I will be issued to the console indicating that
the log stream was disconnected.
When the procedure does not complete successfully, the following
action will happen:
Message IXG274I will be issued to the console indicating which
function failed and listing the return and reason code.
Note: Logger may also issue other messages to indicate whether
the request was successful or not.
Requires:
Access to procedure library used by the installation from submitting
userid. Assuming Security Authority Facility (SAF) is available and
CLASS(LOGSTRM) is defined to SAF, READ access to the RESOURCE(log_stream_name)
CLASS(LOGSTRM) is required by the owning userid to allow the program
invoked by the procedure to connect to the log stream with READ authority.