LGGL gate, OPEN function

Opens a general log and returns a log token. The log token is used by the WRITE, FORCE and CLOSE operations.

Input Parameters

COMPONENT
Identifies the component (e.g. FC) opening this stream
JNL_NAME
The 8-byte journal name to be opened
STREAM_NAME
The 26-byte log stream name to be opened
ERROR_GATE
Optional Parameter
The domain gate number that the logger should call using ERROR if an error occurs accessing the log stream.
USER_TOKEN
Optional Parameter
is a user token that is returned by BROWSE_CHAINS_GET_NEXT and BROWSE_ALL_GET_NEXT.

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • ERROR_OPENING_LOG
  • INVALID_JNL_NAME
  • LOG_HAS_FAILED
  • LOG_IS_DISABLED
  • LOG_IS_SYSTEM_LOG
  • LOG_NOT_DEFINED
The following values are returned when RESPONSE is INVALID:
  • INVALID_PARAMETERS
LOG_TOKEN
The token to be used on subsequent WRITE, FORCE, CLOSE requests.
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
JNL_STREAM
Optional Parameter
The MVS logstream name associated with the journal being opened
LOG_TYPE
Optional Parameter
The associated log stream type.
Values for the parameter are:
  • DUMMY
  • MVS
  • SMF


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