IBM Support

PM28008: EYUVC1231E FORCE REQUEST FAILED EXCEPTION EYUSTARTWLMATRAN WLMATRAN

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are using the CICSPlex SM Web User Interface or an API
    program to perform actions on installed workload objects which
    exist in more than one workload of the same name.  This is
    typically referred to as a duplicate workload environment.  In
    this instance, if for example a WUI user needs to discard a
    transaction from an active workload, the user would select one
    or more rows from the EYUSTARTWLMATRAN.TABULAR view and click
    the FORCE action.  In a duplicate workload environment, the WUI
    user will receive message:
    .
    EYUVC1231E  'Force' (FORCE) request failed. Request complete
    for 1 records. (Failed, Exception)
    .
    The CMAS auxtrace dataset to which the WUI server connects will
    contain an exception trace entry with debug text XDP4CPLE with
    a Point Id 26.
    .
    The same error message will be issued for other active workload
    actions, for example, performing a DISCARD action from the
    EYUSTARTWLMAWDEF.TABULAR view, or a DORMANT or ACTIVE action
    from the EYUSTARTWLMTGRP.TABULAR view.
    .
    Additional Symptom(s) Search Keyword(s):
    EYUSTARTWLMATAFF.TABULAR WLMATAFF
    EYUSTARTWLMATAFF.FORCE FORCE EYUSTARTWLMAWDEF.TABULAR WLMAWDEF
    EYUSTARTWLMAWDEF.DISCARD DISCARD EYUSTARTWLMATGRP.TABULAR
    WLMATGRP
    EYUSTARTWLMATGRP.DORMANT EYUSTARTWLMATGRP.ACTIVE DORMANT ACTIVE
    XDP4 CPLE CPLE_STATUS CPLE_BUFFER_TOO_SMALL CLOSEST EYUBCPSE
    KIXREVWJB
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: Actions issued against active workload  *
    *                      tables may fail if a duplicate workload *
    *                      condition exists.                       *
    *                                                              *
    *                      The affected tables and their           *
    *                      associated actions are:                 *
    *                                                              *
    *                        Tables      Actions                   *
    *                        --------    ---------------------     *
    *                        WLMATAFF    FORCE                     *
    *                        WLMATGRP    ACTIVE   , DORMANT        *
    *                        WLMATRAN    FORCE                     *
    *                        WLMAWAOR    ACTIVATE , QUIESCE        *
    *                        WLMAWDEF    DISCARD                   *
    *                                                              *
    *                      In the case of the WLMAWAOR table, the  *
    *                      error may occur when a generic workload *
    *                      was specified on the request.           *
    *                                                              *
    *                      API programs will fail with a RESPONSE  *
    *                      of 1029 (FAILED) and a REASON of 1359   *
    *                      (EXCEPTION).                            *
    *                                                              *
    *                      WUI users will receive message          *
    *                      EYUVC1231E indicating that the action   *
    *                      failed with (Failed, Exception).        *
    *                                                              *
    *                      In either instance, examination of the  *
    *                      auxtrace dataset of the CMAS to which   *
    *                      the API program or WUI server connects  *
    *                      will show an exception trace issued by  *
    *                      method EYU0XDP4 (XDP4), with a debug    *
    *                      text of "XDP4CPLE" and a trace point ID *
    *                      of 26.                                  *
    ****************************************************************
    * 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.                               *
    ****************************************************************
    When an action is issued against an active workload table,
    method EYU0XDP4 (XDP4), running in the CMAS to which the API
    program or WUI server is connected, issues a call to method
    EYU0CPLE (CPLE) to determine which CMAS should process the
    request.  If the specified workload for the request has
    duplicate copies, or in the case of the WLMAWAOR table, if the
    request specified a generic workload, CPLE attempts to return an
    element for each workload.  Since XDP4 is only expecting one
    element, CPLE fails with a STATUS of BUFFER_TOO_SMALL.  This
    results in the action request being failed with a
    Response/Reason of Failed/Exception.
    

Problem conclusion

  • If XDP4 receives a BUFFER_TOO_SMALL status from CPLE, XDP4 will
    reissue the CPLE call including both the workload name and the
    workload owner name.  This will result in CPLE returning only a
    single element to XDP4.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM28008

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    60M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-12-03

  • Closed date

    2011-02-16

  • Last modified date

    2011-03-02

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

    PM28036

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

    UK64840

Modules/Macros

  •    EYU0XDP4
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60M PSY UK64840

       UP11/02/18 P F102

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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 March 2011