PH20606: DFHLG0772 AN ERROR DURING MVS LOGGER OPERATION IXGCONN DISCONNECT FOR LOG STREAM. MVS LOGGER CODES: X'4', X'404'.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CICS region attempts to open a data set with a forward
  recovery log stream.
  The Log steam is connected OK. The Data
  set is opened in RLS mode and received
  an error that the data
  set is quiesced. CICS attempts to disconnect from the
  forward
  recover stream and issues the following message
  .
  +DFHLG0772
  CIC1AA02
   An error has occurred during MVS logger operation
  IXGCONN DISCONNECT
   for log stream DATA.CICSVR.DSNNAME1. MVS
  logger codes: X'00000004',
   X'00000404'. Log stream attributes:
  SYSTEMLOG(NO), DASDONLY(NO),
   STRUCTNAME(DATA_DFHJ01),
  RETPD(X'00000002'), AUTODELETE(YES).
  .
  This takes an SDUMP
  because LG0772 has been added to the dump tale by the
  supplied
  URM: DFHSYDMP
  .
  In this case, logger is reporting that it has
  not disconnected but in the back
  ground so there is no
  problem.
  .
  Additional Symptom(s) Search Keyword(s):
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provide a new message for the           *
  *                      case of an IXGCONN disconnect           *
  *                      returning a warning response for reason *
  *                      IxgRsnCodeDisconnectInProgress.         *
  ****************************************************************
  If CICS issues an IXGCONN to disconnect from a logstream,
  the z/OS Logger may return a warning (rc4) with a reason of
  IxgRsnCodeDisconnectInProgress (404). This means the disconnect
  is proceeding asynchronously, as a result of a coupling
  facility structure rebuild taking place. CICS will issue
  message DFHLG0772 to report this situation, but not request a
  system dump to accompany the message as this is not an error
  situation. However, use of the default DFHSYDMP user
  replaceable module results in a system dump being captured. To
  avoid this, a new message is required for this particular
  circumstance, to report the asynchronous progress of the
  disconnect while now resulting in a system dump.
  KEYWORDS: msgdfhlg0772 lg0772 lg 0772 772 URM mvs
            msgdfhlg0802 lg0802 0802 802
  

Problem conclusion

• DFHL2HS3 has been changed to issue new message DFHLG0802 in
  this specific circumstance,
   The CICS TS 5.4 and 5.5 Messages manuals will be updated to
  document the new message after the entry for DFHLG0801, as
  follows:
  
  DFHLG0802 applid An error has occurred during
  MVS logger operation {IXGCONN |
  IXGWRITE | IXGBRWSE | IXGDELET |
  IXGQUERY } {CONNECT |
  DISCONNECT | | START |
  READCURSOR | READBLOCK | END |
  ALL | RANGE |
  CHECKCONNSTATUS(YES)} for log
  stream lsn. MVS Logger codes: X'ret',
  X'rsn'. Log stream attributes:
  SYSTEMLOG({YES | NO}),
  DASDONLY({YES | NO}),
  STRUCTNAME(structname),
  RETPD(X'retpd'), AUTODELETE({YES |
  NO}).
  Explanation: The CICS log manager made a call to the
  z/OS Logger to access a log, which returned an error
  condition. The z/OS Logger operation that returned the
  error condition is identified in the message, and the
  return and reason codes shown are those returned by
  the z/OS Logger. This is followed by some of the
  attributes which define the log stream. A structure
  name of ****************" indicates that no structure is
  being used by this log stream.
  If the error occurred during a log stream connection,
  these attributes may not have been updated to the
  correct values for the log stream and should be
  ignored. These attributes are only valid following a
  successful connection.
  This message may be followed by other CICS
  messages, especially if the log stream is part of the
  CICS system log.
  For further guidance, see the z/OS MVS Programming:
  Assembler Services Reference ABE-HSP.
  Note: a reason code of x'00000404' means an
  IxgRsnCodeDisconnectInProgress has been returned from the z/OS
  Logger. CICS has been disconnected from the log stream and the
  stream token is no longer valid, however the disconnect request
  is being completed asynchronously by the z/OS Logger. This
  response can be returned if a coupling facility structure
  rebuild is taking place when the disconnect is issued.
  System action: An exception entry is made in the
  trace table. No system dump is taken.
  The log manager returns an exception condition.
  Message DFHME0116, which contains the symptom
  string for this problem, is produced.
  User response: If the z/OS Logger was recently
  restarted, AUTO start CICS. Otherwise use the z/OS
  Logger return and reason codes to diagnose the
  problem. If you cannot resolve the problem or the
  problem recurs, there may be a more severe error. In
  this case, you will need assistance from IBM. See IBM
  problem support for guidance on how to proceed.
  Check the log for message IXG301I to determine the
  cause of the error.
  Module: DFHL2HS3
  XMEOUT parameters/Message inserts:
  1. applid
  2. Value chosen from the following options:
  1=IXGCONN ,
  2=IXGWRITE,
  3=IXGBRWSE ,
  4=IXGDELET ,
  5=IXGQUERY
  3. Value chosen from the following options:
  1=CONNECT,
  2=DISCONNECT,
  3= ,
  4=START,
  5=READCURSOR,
  6=READBLOCK,
  7=END,
  8=ALL,
  9=RANGE,
  10=CHECKCONNSTATUS(YES)
  4. lsn
  5. X'ret'
  6. X'rsn'
  7. Value chosen from the following options:
  1=YES,
  2=NO
  8. Value chosen from the following options:
  1=YES,
  2=NO
  9. structname
  10. X'retpd'
  11. Value chosen from the following options:
  1=YES,
  2=NO
  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:

  UI68298 UI68299

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 UI68298

     UP20/03/11 P F003

• R200 PSY UI68299

     UP20/03/11 P F003

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.