IBM Support

PI42418: MAS TARGET REGION(S) FAIL TO CONNECT TO RS SERVER IF STARTED BEFORE RS SERVER BECOMES AVAILABLE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When starting a target region prior to the RS data table server
    being started, the region does not automatically connect to the
    RS server as it does for routing regions.  Every 15 seconds the
    MAS heart-beat processing is driven.  As part of this
    processing, WNHD calls DFHRSSR to test the connection to the RS
    Server.  If the server is not yet available, the following
    message is issued:
    .
    DFHFC7085 applid On a request to process OPEN for coupling
     facility data table CPSMPLEX for file DFHRSTAT, it has been
     found that the server for coupling facility data table pool
     DFHRSTAT,  is down. The server should be restarted.
    .
    In the MAS log file this message is only issued once, on the
    first attempt to connect to the RS server.  The MAS heartbeat
    processing is running but the check to test the connection to
    the RS Server is not being issued.
    .
    .
    .
    Additional Keyword(s) and Symptom(s):  KIXREVGJT
    

Local fix

  • Ensure the RS Server is up and running before starting the
    target regions
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V5R1M0 and V5R2M0 Users      *
    ****************************************************************
    * PROBLEM DESCRIPTION: When a CPSM WLM target region that is   *
    *                      defined as being enabled for            *
    *                      optimization is started before the      *
    *                      Region Status (RS) server becomes       *
    *                      available, the following message is     *
    *                      issued in the region's Job log:         *
    *                                                              *
    *                      DFHFC7085 applid                        *
    *                           On a request to process OPEN for   *
    *                           coupling facility data table dddd  *
    *                           for file ffff, it has been found   *
    *                           that the server for coupling       *
    *                           facility data table pool poolname, *
    *                           is down. The server should be      *
    *                           restarted.                         *
    *                                                              *
    *                      However, the region does not attempt to *
    *                      reconnect to the RS server as CPSM WLM  *
    *                      routing regions will do every 15        *
    *                      seconds.  As a result, when the RS      *
    *                      server is available, the target region  *
    *                      will not automatically connect to it.   *
    *                      Instead, it will have to be restarted   *
    *                      in order to become enabled for          *
    *                      optimization.                           *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all MASes defined as CPSM WLM target   *
    *                 regions must be restarted.  Note that the    *
    *                 restarts do not need to occur at the same    *
    *                 time.                                        *
    ****************************************************************
    During the AOR activation, if a region is defined as optimized
    target region, flag WAOR_OPT_ENABLE is turned on, and method
    EYU0WNRS (WNRS) calls module DFHRSSR to open the CFDT (Coupling
    Facility Data Table) file for region status data storage.
    
    If RS (Region Status) server is not available at that time, the
    CFDT file fails to open, RSSR_EXCEPTION is returned, and message
    DFHFC7085 is issued to indicate the failure.
    
    Every 15 seconds, method EYU0WNHD (WNHD) is driven on the MAS
    region for WLM heart-beat processing. As part of the processing,
    WNHD validates flag WAOR_OPT_ENABLE and other conditions. If the
    flag is on, and other conditions match, DFHRSSR is called to
    open the CFDT file.
    
    However, the flag WAOR_OPT_ENABLE is turned off by WNRS after
    the failure of DFHRSSR call. As a result, the DFHRSSR call in
    WNHD is ignored, and the target region doesn't try to reconnect
    to the RS server.
    

Problem conclusion

  • Method EYU0WNRS has been updated to turn off flag
    WAOR_OPT_ENABLE only if the failure returned from DFHRSSR is
    caused by incorrect pool name.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI42418

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    80M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-06-05

  • Closed date

    2015-08-24

  • Last modified date

    2015-09-02

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

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

    UI30489 UI30490

Modules/Macros

  • CJA0WNRS CJB0WNRS CJC0WNRS CJD0WNRS CJE0WNRS EYU0WNRS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80M PSY UI30489

       UP15/08/28 P F508

  • R90M PSY UI30490

       UP15/08/28 P F508

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

Document Information

Modified date:
02 September 2015