PH39710: DFHLG0772 LOGGER RETURN CODE 8 82D NOT CLEAR WHY REGION TERMINATES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS region receives the following message:
  DFHLG0772 An error has occurred during MVS logger operation
            IXGQUERY CHECKCONNSTATUS(YES) for log stream
            xxxx.yyyyyyy.DFHLOG.
            MVS logger codes: X'00000008', X'0000082D'.
            Log stream attributes: SYSTEMLOG(YES), DASDONLY(YES),
            STRUCTNAME(****************),
            RETPD(X'00000000'), AUTODELETE(NO).
  
  The IXGQUERY reason code means IXGRSNCODEEXPIREDSTMTOKEN error.
  The stream token is no longer valid because the connector
  has been disconnected.
  This is followed by the following messages:
  
  DFHLG0735 A failure has occurred while writing to the system log
            (DFHLOG). Access to the system log has been lost.
            CICS will be terminated.
  DFHKE1800  ABNORMAL TERMINATION OF CICS IS COMPLETE.
  
  CICS design in such a case is to terminate and emergency restart
  with Reconnect. This does this to avoid any potential issue with
  the data integrity and consistency.
  This APAR is being taken to put out a more informative message
  as to this behavior for these logger codes.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: No informational message issued for an  *
  *                      IXGLOGR error with reason code of       *
  *                      IxgRsnCodeExpiredStmToken (0000082D).   *
  ****************************************************************
  If CICS is returned an 8,82D response from the z/OS Logger
  then it issues generic failure message DFHLG0772. There is no
  explanation of why CICS has to terminate in this particular
  case.
  

Problem conclusion

• The CICS log manager will issue new informational message
  DFHLG0803 if a call to the z/OS logger returns an error with
  a reason code of an IxgRsnCodeExpiredStmToken (0000082D).
    The CICS Messages manual will be updated with the following
  new message:
  
  DFHLG0803 applid The z/OS logger has detected an expired stream
  token on an operation against a CICS system log logstream.
  Explanation: The z/OS logger has returned an
  IxgRsnCodeExpiredStmToken (0000082D) Reason Code to the CICS
  log manager. The token invalidation may be the result of an
  IXGLOGR region failure, for example.
  System action: CICS has to terminate and reconnect to the
  logstream during the next startup. An emergency restart will
  ensure any inflight work is backed out in a coordinated manner.
  User response: This is an informational message. Refer to
  earlier message DFHLG0772 for further details of the z/OS logger
  operation and logstream which returned the
  IxgRsnCodeExpiredStmToken Reason Code.
  Module: DFHL2HS2, DFHL2HS3, DFHL2HS4, DFHL2HS5, DFHL2HS6,
  DFHL2HS7, DFHL2HS8, DFHL2HS9, DFHL2HSF, DFHL2HSG, DFHL2HSJ,
  DFHL2HB
  XMEOUT parameters/Message inserts:
  1. applid
  Destination: Console
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI78722 UI78723 UI78724

Modules/Macros

• DFHL2BA  DFHL2BL1 DFHL2BL2 DFHL2BS1 DFHL2BS2 DFHL2BS3 DFHL2BS4
  DFHL2CB  DFHL2CC  DFHL2CH1 DFHL2CH2 DFHL2CH3 DFHL2CH4 DFHL2CH5
  DFHL2CHA DFHL2CHE DFHL2CHG DFHL2CHH DFHL2CHI DFHL2CHL DFHL2CHM
  DFHL2CHN DFHL2CHO DFHL2CHP DFHL2CHR DFHL2CHS DFHL2DM  DFHL2DU0
  DFHL2HB  DFHL2HS2 DFHL2HS3 DFHL2HS4 DFHL2HS5 DFHL2HS6 DFHL2HS7
  DFHL2HS8 DFHL2HS9 DFHL2HSF DFHL2HSG DFHL2HSJ DFHL2LB  DFHL2MV
  DFHL2OFI DFHL2SL1 DFHL2SLE DFHL2SLN DFHL2SR  DFHL2SR1 DFHL2SR2
  DFHL2SR3 DFHL2SR4 DFHL2SR5 DFHL2TI2 DFHL2TRI DFHL2VP1 DFHL2WF
  DFHMELGC DFHMELGE DFHMELGK
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI78724

     UP21/12/24 P F112

• R200 PSY UI78723

     UP21/12/24 P F112

• R300 PSY UI78722

     UP21/12/24 P F112

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.