PK76852: REBUILD OF RM STRUCTURE FAILS AFTER PK64986 08/12/03 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• 1st REBUILD of an RM structure succeeds.  2nd & subsequent
  REBUILDs fail with messages:
    CQS0014E STRUCTURE xxxxxxxx INIT FAILURE; FUNC=CONN XES
            RC=0000000C RSN=02010C08
    IXL013I IXLCONN REBUILD REQUEST FOR STRUCTURE xxxxxxxx FAILED.
            IXLCONN RETURN CODE: 0000000C, REASON CODE: 02010C08
    IXC522I REBUILD FOR STRUCTURE 451
            xxxxxxxx IS BEING STOPPED
            TO FALL BACK TO THE OLD STRUCTURE DUE TO
            CONNECTOR SPECIFIC REASON
            USER CODE: 4300000D
    IXC521I REBUILD FOR STRUCTURE xxxxxxxx HAS BEEN STOPPED
    CQS0242E CQS FAILED STRUCTURE REBUILD FOR STRUCTURE xxxxxxxx
            RC=4300000D
  Problem does not occur if all CQSs of the IMSplex are recycled
  between each SETXCF START,REBUILD,STRNAME=xxxxxxx.
  ..
  PK64986 is believed to be somehow implicated.  All reported
  cases occur with this applied.  It is not known if the problem
  also occurs without it.
  

Local fix

• The workaround for this situation is to recycle all CQSs of the
  IMSplex and retry the REBUILD.  To minimise disruption to users
  this can be done with IMS active, recycling each CQS in turn as
  follows:
    /CQC SYSTEM STRUC ALL (not obligatory, but recommended)
    MVS CANCEL CQS
    Restart CQS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS V10 Users of CQS.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: After PK64986, an attempt to rebuild    *
  *                      resource structure fails after one      *
  *                      successful structure copy with the      *
  *                      following XES and CQS messages:         *
  *                                                              *
  *                      IXL013I IXLCONN REBUILD REQUEST FOR     *
  *                      STRUCTURE IMSRSRC01 FAILED.             *
  *                      IXLCONN RETURN CODE: 0000000C,          *
  *                      REASON CODE: 02010C08                   *
  *                                                              *
  *                      CQS0014E STRUCTURE IMSRSRC01            *
  *                      INIT FAILURE; FUNC=CONN XES             *
  *                      RC=0000000C RSN=02010C08 CQS1CQS        *
  *                                                              *
  *                      IXC522I REBUILD FOR STRUCTURE 332       *
  *                      IMSRSRC01 IS BEING STOPPED              *
  *                      TO FALL BACK TO THE OLD STRUCTURE DUE   *
  *                      TO CONNECTOR SPECIFIC REASON            *
  *                      USER CODE: 4300000D                     *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  For a structure rebuild request, CQS first attempts to connect
  to the target structure to determine the connection between CQS
  and structure by issuing IXLCONN call with specified element to
  entry (E/E) ratio for data storage.  Upon a successful
  connection, z/OS returns data element and entry counts in the
  connect answer area.  These returned values might be different
  from the specified values previously requested by IXLCONN.
  
  After PK64986, CQS uses the data element and entry counts from
  the connect answer area to calculate the element to entry (E/E)
  ratio and saves the calculated ratio in temporary variables
  STRRENTY and STRRELMT in the structure block.  This calculated
  ratio is considered the substantially accurate data which can be
  used for future structure reconnection and recovery.
  
  Following the established connection, the structure is rebuilt.
  At the end of the structure rebuild phase 4, CQS copies the
  calculated ratio to the real variables STRENTRY and STRELMNT,
  which can be passed as input parameters to an IXLCONN call in a
  subsequent rebuild request.  CQS then zeros out the calculated
  values in the structure block as part of CQS's cleanup process.
  
  For the reported problem, PK64986 did not perform the E/E ratio
  calculation for the resource structure during rebuild case as
  expected.  This ratio calculation should be applied to all
  structure connection cases including MSGQ, EMHQ and resource
  structures during rebuild.
  
  The first resource structure rebuild attempt proceeded with a
  successful structure connection using the correct E/E ratio
  from the structure block.  At the end of the resource structure
  rebuild, the ratio variables were overlaid with zero from the
  temporary variables, because these temporary ratio variables
  stayed zero from initialization and never were updated by the
  expected ratio calculation.
  
  The subsequent resource structure rebuild request failed at
  structure reconnection attempt due to the zero values of
  ENTRYRATIO and ELEMENTRATIO parameters passed to the IXLCONN
  call.  The failure was externalized as a combination of XES, XCF
  and CQS connection and rebuild error messages:
  
  IXL013I IXLCONN REBUILD REQUEST FOR STRUCTURE IMSRSRC01 FAILED.
  JOBNAME: CQS1 ASID: 0028 CONNECTOR NAME: CQSCQS1CQS
  IXLCONN RETURN CODE: 0000000C,  REASON CODE: 02010C08
          CONADIAG0:   00000002
          CONADIAG1:   00000008
          CONADIAG2:   00000C08
  
  IXL015I REBUILD NEW STRUCTURE ALLOCATION INFORMATION FOR
  STRUCTURE IMSRSRC01, CONNECTOR NAME CQSCQS1CQS
   CFNAME     ALLOCATION STATUS/FAILURE REASON
   --------   ---------------------------------
   LF04       PARAMETER ERROR
   LF03       PARAMETER ERROR
  
  IXC521I REBUILD FOR STRUCTURE IMSRSRC01 333
  HAS BEEN STOPPED
  
  IXC522I REBUILD FOR STRUCTURE 332
  IMSRSRC01 IS BEING STOPPED
  TO FALL BACK TO THE OLD STRUCTURE DUE TO
  CONNECTOR SPECIFIC REASON
   USER CODE: 4300000D
  
  CQS0014E STRUCTURE IMSRSRC01        INIT FAILURE; FUNC=CONN XES
  RC=0000000C RSN=02010C08 CQS1CQS
  
  CQS0242E CQS FAILED STRUCTURE REBUILD  FOR STRUCTURE IMSRSRC01
         RC=4300000D CQS1CQS
  

Problem conclusion

• AIDS: RIDS/SYS RIDS/QMGR SYS QMGR
   GEN:
  KEYWORDS: SYSPLEXSQ
  
  *** END IMS KEYWORDS ***
  
  CQSSTS10 - CQS STRUCTURE SERVICES CONNECT/DISCONNECT
  For the case of resource structure connection during rebuild,
  added the EERATIO ratio calculation call after a successful
  IXLCONN connection call and structure block data population.
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

  PK76781

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

  UK43403

Modules/Macros

• CQSSTS10
  

Fix information

• Fixed component name

  IMS V10

• Fixed component ID

  5635A0100

Applicable component levels

• R010 PSY UK43403

     UP09/01/30 P F901 «

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.