See 'System Logger Processing at Disconnection' in z/OS MVS Programming: Assembler Services Guide for additional details on log stream disconnect processing and log stream tokens.
However, note that there is a special case for the ENF 48 events when the "event specific reason" actually designates the significant state of the log stream resource. That is when a log stream is disconnected and deemed unavailable and an ENF 48 event with IxgEnfLogstreamsNotAvailable and IxgEnfLogstreamDisconnected are both set on.
System logger will issue an ENF 48 event that indicates that a connector has disconnected from the log stream.
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfLogstreamConnDisc |
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEfLogstreamsNotAvailable |
IxgenfEventReasons | (IxgenfEventReasonsByte0): | IxgEnfXESRecommendAction |
IxgenfEventSpecificInfo | (IxgenfEventSpecificInfoByte0): | IxgEnfLogstreamDisconnected and IxgEnfLossOfConnectivity |
System logger issues an ENF 48 informing the connectors that they have been disconnected (staging data set error), after which any system logger that uses the same log stream token receives the return code 8, reason code 82D response.
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfLogstreamsNotAvailable |
IxgenfEventReasons | (IxgenfEventReasonsByte0): | IxgEnfReqLogResNotAvail |
IxgenfEventSpecificInfo | (IxgenfEventSpecificInfoByte0): | IxgEnfLogstreamDisconnected and IxgEnfStgAllocErr |
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfLogstreamsNotAvailable |
IxgenfEventReasons | (IxgenfEventReasonsByte1): | IxgEnfSetLogrForceDisconnect |
IxgenfEventSpecificInfo | (IxgenfEventSpecificInfoByte0): | IxgEnfLogStreamDisconnected |
When system logger becomes available again, system logger will issue an ENF 48 and the application should connect to the log stream and not make use of the expired stream token.
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfSystemLoggerAvail |
An ENF 48 event is issued informing the connectors that they have been disconnected (component error) and any future Logger service requests using the same log stream token will receive the rc8,rsn82D response.
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfLogstreamsNotAvailable |
IxgenfEventReasons | (IxgenfEventReasonsByte1): | IxgEnfComponentError |
IxgenfEventSpecificInfo | (IxgenfEventSpecificInfoByte0): | IxgEnfLogstreamDisconnected |
When system logger completes the disconnection processing for all connectors on a system and the log stream will no longer appear "actively" connected on that system, the system issues an ENF 48 event. For example, if a DISPLAY LOGGER,CONN,LSN=logstreamname command is issued after the ENF 48 event, the resulting IXG601I message indicates the percent of the connectors to the log stream for the log stream as zero (num_conn =0).
The ENF 48 event indicates that it is a "system level" log stream disconnect along with the number of systems in the sysplex still connected to this log stream.
ENF 48 event indicators: | ||
---|---|---|
IxgenfEvents | (IxgenfEventsByte0): | IxgEnfLogStreamConnDisc |
IxgenfEventReasons | (IxgenfEventReasonsByte1): | IxgEnfSystemLevelDisc |
IxgEnfConnDiscInfo section identifies the system and log stream name for the disconnect event along with some additional indicators:
ENF 48 event indicators: | |
---|---|
IxgenfConnDiscFlags | IxgEnfConnDiscDisConnect |
IxgenfConnDiscCount | Contains the number of systems still connected to this log stream in the sysplex. |