LGST gate, CONNECT function

Connect to an MVS log stream, or increment use count on subsequent call.

Input Parameters

STREAM_NAME
The 26-byte log stream name to be opened
SYSTEM_LOG
Whether or not this journal is to be used as a system log.
Values for the parameter are:
  • NO
  • YES

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • CONNECT_FAILURE
  • DEFINE_FAILURE
  • LOG_HAS_FAILED
  • SYSTEM_LOG_CONFLICT
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
STREAM_TOKEN
The log stream token if the journal is currently connected to an MVS log stream or the logbuf token for an SMF journal.

If specified the stream shared lock will be acquired and it its the callers responsibility to free the lock when they have finished with the stream token.

STRUCTURE_NAME
Optional Parameter
is the 16 byte name of the coupling facility structure of the log stream.


dfhs3_LGSTconnect.html | Timestamp icon Last updated: Monday, 5 June 2017