PI19304: CICS APPLICATION WITH INCOMPLETE BUNDLES FAILS TO DISCARD WHEN V5.1 CMAS PRESENT IN ENVIRONMENT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CICS Application resource is installed into a CPSM environment
  containing a mix of CMAS regions at V5.2 and V5.1. One of the
  bundles included in the Application contains a cics.xml file
  which is not correctly encoded.
  Message DFHRL0112 is issued:
  DFHRL0112 date time applid tranid The encoding of the manifest
     manifest_name in the root directory of the bundle bundle_name
     is not valid.
  The application is installed as INCOMPLETE as expected, but
  cannot be discarded.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: -  When a CICS PLATDEF or APPLDEF is    *
  *                         installed into a CPSM environment    *
  *                         containing a mix of CMAS regions at  *
  *                         V5R2M0 and V5R1M0, attempting to     *
  *                         discard the installed PLATFORM or    *
  *                         APPLCTN will result in a failure     *
  *                         indicating that some bundles were    *
  *                         discarded.                           *
  *                                                              *
  *                         For PLATFORMs, the error received    *
  *                         will be:                             *
  *                                                              *
  *                           PLATFORM_DISCARDED_SOME_BUNDS      *
  *                                                              *
  *                         For APPLCTNs, the error received     *
  *                         will be:                             *
  *                                                              *
  *                           APPLCTN_DISCARDED_SOME_BUNDS       *
  *                                                              *
  *                      -  When a CPSM V5R2M0 CMAS connects     *
  *                         directly or indirectly to a CMAS     *
  *                         running a previous release of CPSM,  *
  *                         if any of the following resource     *
  *                         table records are passed between the *
  *                         CMASes, the data contained within    *
  *                         the records may be invalid:          *
  *                                                              *
  *                           DSPPOOL  , IPCONDEF , MGMTPART     *
  *                           MONITOR  , RULE                    *
  *                                                              *
  *                      -  Spelling errors exist in for WUI     *
  *                         field level help for the NUMCIPHERS  *
  *                         attribute in the IPCONN and TCPIPS   *
  *                         resource tables.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.                     *
  *                                                              *
  *                 The restarts need not be performed at the    *
  *                 same time, however if systems are not        *
  *                 restarted at the same time, the following    *
  *                 rules apply:                                 *
  *                                                              *
  *                 - Maintenance Point (MP) CMASes must be      *
  *                   restarted on the updated code before       *
  *                   non-MP CMASes.                             *
  *                                                              *
  *                 - If you have more than one MP CMAS and any  *
  *                   of those MP CMASes are connected directly  *
  *                   or indirectly, then those MP CMASes must   *
  *                   be restarted at the same time.             *
  *                                                              *
  *                 - Before a MAS is restarted with the updated *
  *                   code, the CMAS to which the MAS connects   *
  *                   must be running with the updated code.     *
  ****************************************************************
  -  When a PLATFORM or APPLCTN discard request is shipped from
     one CMAS to another, a queue of MGMTPART records
     is shipped with the request, to allow the CMAS receiving the
     request to identify which bundles need to be discarded.  The
     records are in a blocked queue, and the receiving CMAS adds
     the MGMTPART table record length to the current position in
     the buffer to get to the next record.
  
     A coding error in CPSM V5R2M0, causes the receiving CMAS to
     be passed a record that is 8 bytes smaller than it should be.
     So when the receiving CMAS adds the proper length to index
     into the buffer, it points eight bytes into the next record,
     instead of at the beginning of the next record.  This will
     cause the discard process to fail.
  
  -  Various code errors in CPSM V5R2M0 has resulted in invalid
     records being shipped to a pre V5R2M0 CMAS from a V5R2M0 CMAS
     for the following tables:
  
       DSPPOOL  , IPCONDEF , MGMTPART , MONITOR , RULE
  
     Note that when the records are shipped from a pre V5R2M0
     CMAS to a V5R2M0 CMAS, the records will be correct, but
     the V5R2M0 CMAS will transform them improperly.
  
  -  The work "cipher" is misspelled in the WUI field level help
     for NUMCIPHERS attribute in both thee IPCONN and TCPIPS
     resource tables.
  

Problem conclusion

• -  The MGMTPART resource table has been updated to correct the
     error that results in sending an invalid record to a V5R1M0
     CMAS when a PLATFORM or APPLCTN is discarded.
  
  -  The errors that result in invalid records being shipped
     between V5R2M0 and pre V5R2M0 CMASes for the following
     records has been corrected:
  
       DSPPOOL  , IPCONDEF , MGMTPART , MONITOR , RULE
  
  -  The IPCONN and TCPIPS resource tables have been updated to
     correct the spelling of "cipher" in the field level help for
     attribute NUMCIPHERS.
  

Temporary fix

• *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UI20308

Modules/Macros

• EYUA0103 EYUA0125 EYUA0133 EYUA0167 EYUA0215 EYUA3528 EYUA3836
  EYUC0103 EYUC0125 EYUC0133 EYUC0167 EYUC0215 EYUC3528 EYUC3836
  EYUE0103 EYUE0125 EYUE0133 EYUE0167 EYUE3836 EYUK0103 EYUK0125
  EYUK0133 EYUK0167 EYUK3836 EYUL0103 EYUL0125 EYUL0133 EYUL0167
  EYUL0215 EYUL3528 EYUL3836 EYUP0103 EYUP0125 EYUP0133 EYUP0167
  EYUP0215 EYUP3528 EYUP3836 EYUS0103 EYUS0125 EYUS0133 EYUS0167
  EYUS3836 EYUT0103 EYUT0125 EYUT0133 EYUT0167 EYUT0215 EYUT3528
  EYUT3836 EYUY0103 EYUY0125 EYUY0133 EYUY0167 EYUY0215 EYUY3528
  EYUY3836
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90M PSY UI20308

     UP14/08/08 P F408 ½

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.