LGJN gate, INQUIRE function

Returns information about the current state of a user journal

Input Parameters

JNL_NAME
The 8-byte journal name to be opened
FORCE
Optional Parameter
Indicates that a force of the data in the buffer has been requested. This is used to indicate when the stats field in the journal info, which records the number of flushes, needs incrementing.
Values for the parameter are:
  • NO
  • YES

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • UNKNOWN_JNL_NAME
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
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
LOG_TYPE
Optional Parameter
Values for the parameter are:
  • DUMMY
  • MVS
  • SMF
STREAM_NAME
Optional Parameter
The associated MVS log stream name. Blank for SMF or DUMMY
STREAM_TOKEN
Optional Parameter
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.
SYSTEM_LOG
Optional Parameter
Whether or not the journal is a system log.
Values for the parameter are:
  • NO
  • YES


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