IBM Support

PK61072: BAS RESOURCES ARE REINSTALLED AFTER RESTARTING A MAS WITH COLM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You start a CICS region COLD as part of normal operation.
    Later on in its life, if, due to problems, you need to stop and
    restart the CPSM agent code via COSH & COLM transaction.
    When the COLM transaction starts, there is an attempt to
    reinstall all of the business application services (BAS)
    resources.  The CICS system definition is defined to only
    install resources on a COLD start (CSYSDEF AUTOINST -  Install
    Resources -> COLDONLY).
    This generates a lot of EYUBN0005E messages.  This also
    circumvents change control, in that a program may have been
    deleted since the COLDSTART, and now is reinstalled when COLM is
    entered.
    Additional Symptom(s) Search Keyword(s):  EYUBN0012W, DFHAM4838
    KIXREVSPW
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    You start a CICS region COLD as part *
    *                      of normal operations.  Later on in its  *
    *                      life, you need to stop and restart the  *
    *                      CPSM agent code via the COSH and COLM   *
    *                      transactions.  When the MAS Agent is    *
    *                      restarted, CPSM attempts to reinstall   *
    *                      CICS resource which were installed at   *
    *                      startup by BAS (Business Application    *
    *                      Services).  The CICS system is defined  *
    *                      to install BAS resources on COLD start  *
    *                      only.                                   *
    *                      .                                       *
    *                      (CSYSDEF_AUTOINST -  Install Resources  *
    *                         -> COLDONLY).                        *
    *                      .                                       *
    *                         This may circumvent change control,  *
    *                      in that resources could be discarded or *
    *                      modified after the COLDSTART, and re-   *
    *                      installed with the original attributes  *
    *                      when the MAS agent restarts.  It also   *
    *                      results in message EYUBN0005E for any   *
    *                      resources which could not reinstall in  *
    *                      an active CICS region.                  *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes and MASes must be recycled  *
    *                 to pick up the new code.  Note that the      *
    *                 restarts do not need to be done at the same  *
    *                 time.  However, the fix will not take effect *
    *                 for a given MAS until the MAS and the CMAS   *
    *                 that it connects to have been restarted.     *
    ****************************************************************
       When the MAS agent is stopped by the COSH transaction or by
    the STOP action against the MAS resource, state information
    that would show that the CPSM MAS agent had been active in the
    current CICS region is not retained.  Thus when the MAS Agent
    is restarted by transaction COLM, resources are installed as
    if the region was starting for the first time.  This results
    in reinstallation of CICS resources that were installed during
    the original start of the MAS agent.
    

Problem conclusion

  •    Module EYU9XLEV (XLEV - Kernel Linkage Environment) was modi-
    fied to retrieve the CICS Dispatcher Start Time from Dispatcher
    statistics, and store the value in the Kernel Work Area (XLWA).
    Module EYU0CLIN (CLIN - Protocol Services Initialization) was
    modified to place the Start Time into the initial contact ele-
    ment which is passed to the CMAS, instead of the current time.
    This time is placed in the EENDCONN (Network Endpoint Connect)
    notification block, and copied to the CICS System Descriptor
    Block (CSDB) in module EYU0TIST (TIST - Topology Long-Running
    Task).  Module EYU0TSSC has been modified to compare the saved
    Start Time with the time the MAS Agent last became active (MAS
    Agent Active Time), before the Active Time is reset.  If the
    Start Time is earlier than the Active Time for the last MAS
    agent execution, then this connect will be treated as a restart
    and BAS will not be called to install CICS resources.  If the
    Start Time is later than the Active Time for the previous MAS
    Agent instance, then the region was restarted, and resources
    must be installed.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

  •    You start a CICS region COLD as part
    of normal operations.  Later on in its
    life, you need to stop and restart the
    CPSM agent code via the COSH and COLM
    transactions.  When the MAS Agent is
    restarted, CPSM attempts to reinstall
    CICS resource which were installed at
    startup by BAS (Business Application
    Services).  The CICS system is defined
    to install BAS resources on COLD start
    only.
    .
    (CSYSDEF_AUTOINST -  Install Resources
       -> COLDONLY).
    .
       This may circumvent change control,
    in that resources could be discarded or
    modified after the COLDSTART, and re-
    installed with the original attributes
    when the MAS agent restarts.  It also
    results in message EYUBN0005E for any
    resources which could not reinstall in
    an active CICS region.
    
    
       When the MAS agent is stopped by the COSH transaction, state
    information which would show that the CPSM MAS agent had been
    active in the current CICS region is not retained.  Thus when
    the MAS Agent is restarted by transaction COLM, resources are
    installed as if the region was starting for the first time.
    This results in reinstallation of CICS resources which were in-
    stalled during the original start of the MAS agent.
    
    
       Module EYU9XLEV (XLEV - Kernel Linkage Environment) was modi-
    fied to retrieve the CICS Dispatcher Start Time from Dispatcher
    statistics, and store the value in the Kernel Work Area (XLWA).
    Module EYU0CLIN (CLIN - Protocol Services Initialization) was
    modified to place the Start Time into the initial contact ele-
    ment which is passed to the CMAS, instead of the current time.
    This time is placed in the EENDCONN (Network Endpoint Connect)
    notification block, and copied to the CICS System Descriptor
    Block (CSDB) in module EYU0TIST (TIST - Topology Long-Running
    Task).  Module EYU0TSSC has been modified to compare the saved
    Start Time with the time the MAS Agent last became active (MAS
    Agent Active Time), before the Active Time is cleared.  If the
    Start Time is earlier than the Active Time for the last MAS
    Agent execution, then this connect will be treated as a restart
    and BAS will not be called to install CICS resources.  If the
    Start Time is later than the Active Time for the previous MAS
    Agent instance, then the region was restarted, and resources
    must be installed.
    

APAR Information

  • APAR number

    PK61072

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    50M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-02-15

  • Closed date

    2008-04-28

  • Last modified date

    2008-05-02

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

    PK61159

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

    UK35914

Modules/Macros

  •    EYURTISD EYURXLWA EYU0CLIN EYU0TSSC EYU0TSSE
    EYU9XLEV
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R50M PSY UK35914

       UP08/04/30 P F804

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

Document Information

Modified date:
02 May 2008