LGJN gate, EXPLICIT_OPEN function

Inquire on a journal and if the journal does not already exist in the set of known journals perform the autoinstall process to define it.

Input Parameters

JNL_NAME
The 8-byte journal 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:
  • ERROR_OPENING_LOG
  • INVALID_JNL_NAME
  • JNL_HAS_FAILED
  • JNL_IS_DISABLED
  • SYSTEM_LOG_CONFLICT
  • UNABLE_TO_CREATE_JNL
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.

JNL_STATUS
Optional Parameter
The associated log stream status. Status will always appear as disconnected for journals that have not been used as user journals (i.e. system logs, forward recovery logs, fc auto journals) even though they may be in use
Values for the parameter are:
  • CONNECTED
  • DISABLED
  • DISCONNECTED
  • FAILED
  • FLUSH
LOG_TOKEN
Optional Parameter
The token to be used on subsequent WRITE, FORCE, CLOSE requests.
LOG_TYPE
Optional Parameter
The associated log stream type.
Values for the parameter are:
  • DUMMY
  • MVS
  • SMF
STREAM_NAME
Optional Parameter
The associated MVS log stream name. Blank for SMF or DUMMY
STRUCTURE_NAME
Optional Parameter
is the 16 byte name of the coupling facility structure of the log stream.


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