IBM Support

PM16246: EYUNX0048E OCCURS WHEN SHUTTING DOWN THE MAS USING THE IBM CICS EXPLORER WITH CONNECTION TYPE CMCI/SMSS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You have the IBM CICS Explorer connected to
    a single MAS using the connection type
    "CICS Management Interface" (CMI).
    From the CICS Explorer, you request a shutdown
    of the MAS and it fails with message:
    EYUNX0048E SMSS Shutdown transaction unable to obtain
    transaction parameters. Shutdown request failed.
    The failure only occurs when the MAS System Initialization
    table specifies parameter SEC=NO.
    You will also see the CICS Explorer message
    CNX0611I:Perform SHUTDOWN(NORMAL) on Region "region" succeeded
    even though the shutdown failed.
    
    
    EYU0NPSD (Pid level) at offset x'049E' if no security is active,
    execution continues at label PRSD_DO_NORMSTART where an EXEC
    CICS START is issued for COND with FROM(PCMD). No pointer was
    setup for PCMD so later when COND runs, EYU9NPS2 issues an
    inline DFHXMIQI to inquire on ATTACH_PARMS which fails resulting
    in undocumented message:
    EYUNX0048E applid SMSS Shutdown transaction unable to obtain
               transaction parameters. Shutdown request failed.
    EYU0NPSD for an SMSS RMAS should be issuing a DFHXMATM to attach
    COND as a system task even if the region is running with SEC=NO
    in the SIT.
    .
    Additional Symptom(s) Search Keyword(s): EYUNX0048
    KIXREVJXD
    

Local fix

  • Run with SEC=YES in the SMSS SIT or apply the following zap
    after you copy EYU9NA02 from SEYULOAD into a user.loadlib which
    is concatenated ahead of SEYULOAD in the DFHRPL.
    .
    //AMASPZAP JOB (3871),'userid',CLASS=F,REGION=32M,MSGCLASS=R,
    // NOTIFY=&SYSUID
    //STEP       EXEC PGM=AMASPZAP
    //SYSPRINT   DD   SYSOUT=A
    //SYSLIB     DD   DSNAME=&&user.LOADLIB,DISP=SHR
    //SYSIN      DD   *
    NAME EYU9NA02 EYU0NPSD
    VER 049E 4780,35DC
    REP 049E 4780,34F0
    /*
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    You have the IBM CICS Explorer       *
    *                      connected to a System Managed Single    *
    *                      Server (SMSS), using the connection     *
    *                      type "CICS Management Interface"        *
    *                      (CMI).  From the CICS Explorer, you     *
    *                      request a shutdown of the region and    *
    *                      the action fails with message:          *
    *                      .                                       *
    *                           EYUNX0048E  SMSS Shutdown trans-   *
    *                                action unable to obtain       *
    *                                transaction parameters.       *
    *                                Shutdown request failed.      *
    *                      .                                       *
    *                      Even though the shutdown action failed, *
    *                      you see CICS Explorer message:          *
    *                      .                                       *
    *                           CNX0611I:Perform SHUTDOWN(NORMAL)  *
    *                                on Region "region" succeeded  *
    *                      .                                       *
    *                      The failure only occurs when the System *
    *                      Initialization Table specifies parm     *
    *                      "SEC=NO".                               *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all System Managed Single Servers      *
    *                 must be recycled to pick up the new code.    *
    *                 Note that the restarts do not need to be     *
    *                 done at the same time.                       *
    ****************************************************************
       A logic error in module EYU0NPSD (NPSD - Region Perform
    Shutdown) caused the Shutdown Assist Task COND, executing
    program EYU9NPS2 (NPS2), to be started as a user task if
    security is not active in an SMSS region.  Because NPS2 is
    executing in an SMSS, it expects to be running as a system
    task.  It issues a call to the CICS XM domain to retrieve the
    task's attach parms to determine the type of shutdown which
    was requested, but they were not set properly because of the
    incorrect startup.
    

Problem conclusion

  •    Module EYU0NPSD was modified to start COND as a system task
    in an SMSS region, regardless of whether security is active in
    the region.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM16246

  • 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-06-09

  • Closed date

    2010-06-30

  • Last modified date

    2010-08-02

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

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

    UK58461

Modules/Macros

  •    EYU0NPSD
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60M PSY UK58461

       UP10/07/06 P F007

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 August 2010