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