PM30696: CICSPLEX SM COMPATIBILITY WITH CICS TRANSACTION SERVER FOR Z/OS V4.2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICSPlex SM compatibility
  

Local fix

• None.
  Additional Keywords: kixdcfcic670
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    When a CICSPlex SM V4R2M0 CMAS is    *
  *                      part of a network which includes CMASes *
  *                      running prior releases of CPSM, callers *
  *                      that request the CICSPlex SM V4R2M0     *
  *                      COMSET, COMSETE, or WLMAROUT objects    *
  *                      will receive an API response and reason *
  *                      of:                                     *
  *                       ENVIRONERROR (1030) REQTIMEOUT (1342). *
  *                        -----------------------------------   *
  *                         When a CICSPlex SM V4R2M0 CMAS is    *
  *                      part of a network which includes CMASes *
  *                      running prior releases of CPSM, callers *
  *                      that request the RELEASE action for     *
  *                      PROGRAM objects in MASes connecting to  *
  *                      a CMAS running a prior release of CPSM  *
  *                      will receive an API response and reason *
  *                      of:                                     *
  *                       ENVIRONERROR (1030) REQTIMEOUT (1342). *
  *                        -----------------------------------   *
  *                         If a PROGDEF created or updated in a *
  *                      CICSPlex SM V4R2M0 CMAS with attribute  *
  *                      CONCURRENCY=REQUIRED is installed in a  *
  *                      MAS executing a lower release of CPSM,  *
  *                      the install will fail.  If the install  *
  *                      was requested by an API program or WUI  *
  *                      user, an API response and reason of:    *
  *                       TABLEERROR (1038) DATAERROR (1361)     *
  *                      will be returned to the requester.      *
  *                        -----------------------------------   *
  *                         If a FILEDEF or LSRDEF created or    *
  *                      updated in a CICSPlex SM V4R2M0 CMAS    *
  *                      with attribute LSRPOOLID containing a   *
  *                      value greater than 8 is installed in a  *
  *                      MAS executing a lower release of CPSM,  *
  *                      the install will fail.  If the install  *
  *                      was requested by an API program or WUI  *
  *                      user, an API response and reason of:    *
  *                       TABLEERROR (1038) DATAERROR (1361)     *
  *                      will be returned to the requester.      *
  *                        -----------------------------------   *
  *                         Requests for monitor resources which *
  *                      originate in a CICSPlex SM V4R2M0 CMAS  *
  *                      may return incomplete or empty result   *
  *                      sets from CMASes executing lower relea- *
  *                      ses of CICSPlex SM.                     *
  *                        -----------------------------------   *
  *                         Actions executed on behalf of CPSM   *
  *                      API programs including a WUI (Web User  *
  *                      Interface) server may receive an API    *
  *                      response and reason of:                 *
  *                       FAILED (1029) EXCEPTION(1359)          *
  *                      if the action definition was last       *
  *                      updated for a version lower than the    *
  *                      current table version.                  *
  *                        -----------------------------------   *
  *                         If a WLMSPEC created or updated in   *
  *                      a CICSPlex SM V4R2M0 CMAS with the      *
  *                      routing algorithm (ALGTYPE) set to      *
  *                      LNGOAL is installed in or imported      *
  *                      into a CMAS executing a lower release   *
  *                      of CPSM, the routing algorithm in ef-   *
  *                      fect in routing regions connected to    *
  *                      the lower level CMAS will be QUEUE.     *
  *                        -----------------------------------   *
  *                         If a CMAS executing a lower release  *
  *                      of CPSM is started on an LPAR where a   *
  *                      CMAS is already executing CICSPlex SM   *
  *                      V4R2M0, the version of CPSM's subsystem *
  *                      exit router EYU9XEER which was loaded   *
  *                      into common storage during startup for  *
  *                      the V4R2M0 CMAS, will be replaced by    *
  *                      the lower version of EYU9XEER.          *
  ****************************************************************
  * RECOMMENDATION:    After applying the PTF that resolves this *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.  Note that regions  *
  *                 do not have to be shut down and restarted at *
  *                 the same time.                               *
  *                                                              *
  *                    If a CMAS executing from a library to     *
  *                 which the PTF resolving this APAR is applied *
  *                 connects, directly or indirectly, to a CMAS  *
  *                 executing CICSPlex SM for CICS Transaction   *
  *                 Server V3.2 or CICSPlex SM for CICS Trans-   *
  *                 action Server V4.1, the PTFs which resolve   *
  *                 the following APARs must be applied to the   *
  *                 appropriate target libraries.                *
  *                                                              *
  *                 - CTS 3.2 - CICSPlex SM 3.2.0 - APAR PM30686 *
  *                 - CTS 4.1 - CICSPlex SM 4.1.0 - APAR PM30655 *
  ****************************************************************
     Requests for the CICSPlex SM V4.2 COMSET, COMSETE, or
  WLMAROUT resource might cause the V4.2 CMAS to send a Method
  Argument List (MAL) for module EYU0CSBR (CSBR - Browse COMM
  Set Directories), EYU0CSBC (CSBC - Browse Comm Set Directory
  entries), or EYU0WABU (WABU - Browse Active TORs in Workload)
  to one or more CMASes running a release of CPSM lower than
  V4.2.  Because pre-V4.2 CMASes do not have support for these
  methods, the MAL cannot be processed in pre-V4.2 CMASes, nor
  can it be returned to the V4.2 CMAS to resolve the request.
  As a result the originating request will wait until the com-
  munication times out.
  
     Requests for the RELEASE actions for PROGRAM objects might
  cause the V4.2 CMAS to send a Method Argument List (MAL) for
  module EYU0NRGR (NRGR - MAS Generic Release Processor) to one
  or more MASes running a release of CPSM lower than V4.2.
  Because pre-V4.2 MASes do not have support for this method,
  the MAL cannot be processed in pre-V4.2 MASes, nor can it be
  returned to the V4.2 CMAS to resolve the request.  As a result
  the originating request will wait until the communication times
  out.
  
     In CICSPlex SM V4.2, the PROGDEF resource table was updated
  to allow CONCURRENCY=REQUIRED.  If a PROGDEF resource defined
  in a CPSM V4.2 CMAS with CONCURRENCY=REQUIRED is installed in
  a MAS executing an earlier release of CICS Transaction Server,
  the install will fail because the value REQUIRED is not valid
  for the CONCURRENCY attribute in the earlier release of CICS.
  
     CICS Transaction Server V4.2 supports up to 255 Local Shared
  Resource (LSR) pools.  An attempt to install a FILEDEF or an
  LSRDEF specifying an LSRPOOLID greater than 8 will fail in a
  MAS executing a lower release of CICSPlex SM.
  
     In CICSPlex SM V4.2, the length of the resource name field,
  RESNAME, in the Method Argument List (MAL) for module EYU0MSIN
  (MSIN - Monitor Data Selector) was increased to 9 bytes as part
  of the changes to support 255 LSR pools.  Earlier releases of
  CICSPlex SM support an 8 byte RESNAME and may return no data or
  incorrect data if the RESNAME field is truncated.
  
     When an API command is submitted against a resource table or
  a result set containing one or more resource tables, the Managed
  Object Services (MOS) dictionary is searched to find the method
  which supports the requested action.  The search logic assumes
  that the resource table data and action version and subversion
  indices are synchronized.  In fact actions are rarely subver-
  sioned, so if an action was last updated at a version lower
  than the version of the CMAS to which it connects, using the
  data subversion number to index the action table may result in
  errors including, but not limited to, the wrong method being
  identified for the action, or MOS being unable to identify the
  action to be performed.
  
     When a workload using the new LNGOAL or LNQUEUE routing al-
  gorithms is installed in or imported into a CMAS executing a
  prior release of CPSM, the routing algorithm should revert to
  the GOAL or QUEUE algorithm, respectively.
  
     When CMASes executing different releases of CICSPlex SM are
  started on the same LPAR, the active version of CPSM's subsys-
  tem exit router, EYU9XEER, should correspond to the highest
  version of CPSM executing on the LPAR.  A change to the format
  of the CPSM service module header causes the CMAS initialization
  program EYU9XECS to extract the version of the active router
  program from an incorrect location, resulting in the copy of
  the router program installed when the V4R2M0 CMAS started, being
  replaced by the version installed by the earlier CMAS.
  

Problem conclusion

•    Toleration support has been added for EYU0CSBC, EYU0CSBR,
  and EYU0WABU.  Note that these methods can never return any
  resource objects from a pre-V4R2M0 CMAS because the resources
  are not known at prior releases.
  
     Module EYU0NRGR has been ported to V3R1M0 of CPSM.  A CPSM
  user will be able to issue the RELEASE action for PROGRAM re-
  sources in MASes connected to CMASes executing CPSM V3R1M0,
  from a V4R2M0 API program or WUI or CMCI client.
  
     Module EYU0BNC2 (BNC2 - Install PROGDEF and TYPTMDEF) was
  updated to replace the CONCURRENCY attribute value REQUIRED with
  THREADSAFE.
  
     Modules EYU0BNC1 (BNC1 - Install LSRDEF, JRNMDEF, PROFDEF,
  and TRNCLDEF) and EYU0BNC3 (BNC3 - Install FILEDEF and TRANDEF)
  were modified to set the LSRPOOLID to the CICS default (1) if a
  value greater than 8 is encountered.
  
     The length of the RESNAME field in the MAL for EYU0MSIN was
  increased to 9 bytes, to accomodate requests originating in a
  CICSPlex SM V4R2M0 CMAS.
  
     Module EYU0MOCM (MOCM - MOS Common Service Functions) was
  updated to select the proper subversion number for an action
  which was last updated in a prior release of CPSM.  Programs
  EYU0MOAC (MOAC - MOS Inquire Action), EYU0MOMB (MOMB - MOS Build
  MAL), EYU0MOPA (MOPA - MOS Inquire Parameter value Assertions),
  EYU0MOPM (MOPM - MOS Inquire Action Parameters), and EYU0MOSS
  (MOSS - MOS String Services) were recompiled to incorporate
  the changes to MOCM.
  
     Modules EYU0WMWC (WMWC - Workload Create) and EYU0WMQB
  (WMQB - Build Imported Workload) have been modified to convert
  the LNGOAL and LNQUEUE algorithm types to the appropriate
  supported algorithms.
  
     Module EYU9XECS was modified to recognise the changed header
  format and to avoid replacing a higher version of EYU9XEER in
  common storage.  The ESSS Information Display utility program
  EYU9XENF was also modified to display "Unknown Version" if it
  encounters an active router program whose module header cannot
  be mapped.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• None.
  ž**** PE11/12/06 FIX IN ERROR. SEE APAR PM53322  FOR DESCRIPTION
  

APAR Information

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

  PM30655

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

  UK68038

Modules/Macros

•    DYU0MOAC DYU0MOCM DYU0MOMB DYU0MOPA DYU0MOPM
  DYU0MOSS EYUCCSBC EYUCCSBR EYUCMSIN EYUCNRGR EYUCXXRS EYUQCSBC
  EYUQCSBR EYUQMSIN EYUQNAGR EYUQNRGR EYUQWABU EYUQXXRC EYURCSBC
  EYURCSBR EYURMSIN EYURNRGR EYURWABU EYUTMOMI EYUTMOSD EYUTNAGA
  EYUTNAG9 EYUTRCOM EYUTRDIR EYUTRMAS EYUTRMON EYUTRWLM EYUTVOSX
  EYUUXXFI EYUUXXRS EYUUXXTC EYUYCSBC EYUYCSBR EYUYMSIN EYUYNRGR
  EYUYWABU EYUZCSBC EYUZCSBR EYUZMSIN EYUZNRGR EYUZWABU EYU0BNC1
  EYU0BNC2 EYU0BNC3 EYU0CSBC EYU0CSBR EYU0MOAC EYU0MOMB EYU0MOPA
  EYU0MOPM EYU0MOSS EYU0MSIN EYU0NHCT EYU0NLRT EYU0NPGR EYU0NQGF
  EYU0NQGR EYU0NQHT EYU0NQRA EYU0NQRB EYU0NQRC EYU0NQRD EYU0NQRE
  EYU0NRGR EYU0NSDC EYU0NSFL EYU0NSGR EYU0TAAC EYU0WABU EYU0WMQB
  EYU0WMWC EYU2MSIN EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9CMP5 EYU9MNPU
  EYU9MNP3 EYU9MNP4 EYU9NAPU EYU9NAP3 EYU9NAP4 EYU9NAP5 EYU9WMPU
  EYU9WMP3 EYU9WMP4 EYU9WMP6 EYU9XECS EYU9XENF HCP3100J
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK68038

     UP11/05/26 P F105

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.