IBM Support

PM77486: ROUTING REGION DOES NOT CONNECT TO THE WORKLOAD AFTER IPL OF THE LPAR

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After IPL of the LPAR the CMAS and the MAS's are started.
    The TOR region tries to connect to the CPSM workload but
    this fails with the messages EYUWI0082E and EYUWM0401E.
    The CMAS trace shows the following exception trace entries:
    WMQB WMQM WMWC WLM EXCP  4 BUF2SML  CPSM CMASTC91 CMAS
    WMQM WMWC WMWC WLM EXCP 13 WMQMWMQB CPSM CMASTC91 CMAS
    WMWC XLOP WMWC WLM EXCP 16 WMWCWMQM CPSM CMASTC91 CMAS
    

Local fix

  • Use the COSH and COLM transactions to stop and restart the CPSM
    agend code or recycle the routing region.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V4R2M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: Messages EYUWI0080I, EYUWI0082E and     *
    *                      EYUWM0401E will be issued by a CMAS     *
    *                      when it attempts to import a workload,  *
    *                      if the workload has an active affinity  *
    *                      of lifetime PERMANENT, SYSTEM, PROCESS  *
    *                      or ACTVITY.                             *
    *                                                              *
    *                      The text of the messages will be        *
    *                      similar to the following:               *
    *                                                              *
    *                      EYUWI0080I WLM Workload query process   *
    *                                 for context (<plexname>)     *
    *                                 has been started -           *
    *                                 directed to CMAS             *
    *                                 (<cmasname>).                *
    *                                                              *
    *                      EYUWI0082E WLM Workload query process   *
    *                                 failed for context           *
    *                                 (<plexname>) - directed to   *
    *                                 CMAS (<cmasname>).           *
    *                                                              *
    *                      EYUWM0401E Workload Specification       *
    *                                 (<wlmspecname>) failed to    *
    *                                 install for                  *
    *                                 context(<plexname>)  -       *
    *                                 initiated by join of         *
    *                                 router (<torname>).          *
    *                                                              *
    *                      Examination of the auxtrace dataset for *
    *                      the CMAS that issued the messages will  *
    *                      show the following exception traces:    *
    *                                                              *
    *                        Method  Caller  TPID   Debug text     *
    *                        ------  ------  ----   ----------     *
    *                        WMQB    WMQM       4   BUF2SML        *
    *                        WMQM    WMWC      13   WMQMWMQB       *
    *                        WMWC    XLOP      16   WMWCWMQM       *
    *                                                              *
    *                      Even though message EYUWM0401E          *
    *                      indicates that the workload failed to   *
    *                      install, and the routing region for     *
    *                      which the import was performed will     *
    *                      fail to join the workload, the workload *
    *                      will be partially installed.            *
    *                      Additionally, routing regions started   *
    *                      under the CMAS after the import failure *
    *                      will join the workload, including the   *
    *                      routing region that failed to join the  *
    *                      workload at the time of import, if it   *
    *                      is restarted.  This can result in       *
    *                      invalid routing by these routing        *
    *                      regions.                                *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be restarted.  Note    *
    *                 that the restarts do not need to occur at    *
    *                 the same time.                               *
    *                                                              *
    *                 Note that if any CMAS has exhibited the      *
    *                 symptoms of the problem, it will be          *
    *                 necessary to terminate not only that CMAS,   *
    *                 but all MASes and batch API programs that    *
    *                 connect to it, to ensure that the partial    *
    *                 workload has been removed from that CMAS.    *
    *                 The EYU9XENF utility can be used to check    *
    *                 which MASes and batch API programs are       *
    *                 connected to the CMAS.                       *
    *                                                              *
    *                 For details on the EYU9XENF utility refer to *
    *                 "CICS Transaction Server for z/OS Version 4  *
    *                 Release 2 CICSPlex SM Problem Determination" *
    *                 (GC34-7203-xx).                              *
    ****************************************************************
    When a CMAS imports a workload from another CMAS, the CMAS that
    exports the workload fills a queue with records that define the
    workload.  This queue is then returned to the importing CMAS,
    where method EYU0WMQB (WMQB) reads the records from the queue
    and calls various other methods to process them.
    
    If an affinity of lifetime PERMANENT, SYSTEM, PROCESS or
    ACTIVITY is active at the time of the export/import, then the
    exporting CMAS will add a WLMAFFET record for each of those
    affinities to the queue.  For CPSM V4R2M0, the size of the
    WLMATTEF record has increased from X'AC' to X'10F'.  However,
    WMQB was never updated to reflect this change.  Instead, it
    attempts to read the WLMAFFET record into a buffer that is too
    small.  This causes the import to fail at that point.
    

Problem conclusion

  • Copybook EYURWRKQ, which defines the workload records that are
    delivered in the export/import queue, has been updated to set a
    new equate with the maximum length of the queue records.  WMQB
    has been updated to use this new equate as the buffer length
    when requesting records from the queue.
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PM77486

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    70M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-11-21

  • Closed date

    2012-11-28

  • Last modified date

    2013-01-02

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

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

    PM77964 UK83824

Modules/Macros

  •    EYU0WMQB
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R70M PSY UK83824

       UP12/12/04 P F212

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":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 January 2013