IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PM30696

  • Reported component name

    CPSM CICS 3.1

  • Reported component ID

    5655M1501

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-01-18

  • Closed date

    2011-05-24

  • Last modified date

    2011-12-07

  • 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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZMG3","label":"CICSPlex System Manager"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB17","label":"Mainframe TPS"}}]

Document Information

Modified date:
07 December 2011