IBM Support

PM79038: PROTECT CPSM MAS AGENT TASKS FROM BEING ACCIDENTALLY PURGED THROUGH THE WUI, CICS EXPLORER, OR CPSM API PROGRAM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You use the CPSM WUI to look at active tasks in a CICS region.
    This view allows you to purge running tasks. This includes tasks
    that are running as part of the CPSM MAS agent code.
    These tasks should not be purged. They should be considered
    system tasks. In order to prevent accidental purging of these
    tasks through the WUI, CICS Explorer, or CPSM API program, this
    APAR is being opened to protect them.
    .
    Additional Keywords/Symptoms
    CONL COI0 CONA COIE
    KIXREVSVR
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V5R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    You use the CPSM WUI to display all  *
    *                      active tasks in a CICS region.  During  *
    *                      an emergency, you select all tasks and  *
    *                      click Purge to FORCEPURGE all active    *
    *                      user tasks.  This also purges tasks     *
    *                      that are running as part of the CPSM    *
    *                      MAS agent code.  The MAS agent must be  *
    *                      restarted by entering the COLM trans-   *
    *                      action, or by recycling the 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 regions  *
    *                 do not need to be brought down and restarted *
    *                 at the same time.  However, in order that    *
    *                 MAS agent tasks be protected in a MAS, the   *
    *                 CMAS to which the MAS connects must be re-   *
    *                 started with MASTASKPROT(YES) added to the   *
    *                 CMAS EYUPARMs.  After the CMAS is restarted  *
    *                 protection can be enabled in each MAS by     *
    *                 bringing down and restarting the CICS region *
    *                 or by stopping the MAS agent using the COSH  *
    *                 transaction, and restarting it using the     *
    *                 COLM transaction.                            *
    *                    If CICS Explorer or another client that   *
    *                 uses the CICS Management Client Interface    *
    *                 (CMCI) is used to manage a CICSplex, or a    *
    *                 user program uses the CPSM API to manage     *
    *                 TASK resources, the CMAS to which the server *
    *                 or API program connects must be restarted    *
    *                 to enable support for MAS task protection.   *
    ****************************************************************
       The CPSM MAS agent tasks run as user tasks and can be modi-
    fied or purged through the CPSM API, Web User Interface (WUI),
    or CMCI clients like CICS Explorer.  CICS does not support
    protecting running tasks through an external security manager.
    

Problem conclusion

  • A new CMAS EYUPARM, MASTASKPROT, makes it possible to prevent
    modification or purging of CPSM MAS agent tasks through the CPSM
    API, WUI, or CMCI.  It does not prevent individual CPSM tasks
    from being purged using the CEMT transaction or by a program
    executing CICS SPI commands.
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PM79038

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    80M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-12-12

  • Closed date

    2013-01-04

  • Last modified date

    2015-03-04

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

    PM75983

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

    UK90734

Modules/Macros

  • CJA0NLGT CJB0NLGT CJC0NLGT CJD0NLGT EYU0NLGT EYU0NSTK EYU0TIML
    EYU0TSSC EYU9NAP3 EYU9NAP4 EYU9NAP6 EYU9NAPU EYU9NAR3 EYU9NAR4
    EYU9NAR6 EYU9NARU EYUA0020 EYUC0020 EYUE0020 EYUL0020 EYUP0020
    EYUT0020 EYUTXLPD EYUY0020
    

Publications Referenced
GC34285700    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80M PSY UK90734

       UP13/01/05 P F301

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:
04 March 2015