PM75983: 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 V4R2M0 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

    PM75983

  • 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-10-26

  • Closed date

    2012-12-07

  • 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:

    UK90153 PM79038

Modules/Macros

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

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R70M PSY UK90153

       UP12/12/11 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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

CICS Transaction Server

Software version:

4.2

Reference #:

PM75983

Modified date:

2013-01-02

Translate my page

Machine Translation

Content navigation