IBM Support

PH10853: EYUNX0019E DURING CICS REGION SHUTDOWN IF CPSM MAS AGENT CODE TERMINATED MANUALLY USING COSH PRIOR TO SHUTDOWN

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are using CICS version 5.5 and are shutting your CICS
    region down. You see the following message:
    .
    EYUNX0019E NOAPPLID EXTRACT Exit EYU9NXSD failed,
               EIBRCODE=800200000000
    .
    This did not occur prior to CICS 5.5. The region does shut down
    normally but the presence of the error level message is
    unexpected. The EYUNX0019E does not appear if you do NOT use
    COSH first to terminate the CPSM MAS agent code and let CICS
    shutdown terminate the CPSM code on its own.
    .
    .
    Additional Symptom(s) Search Keyword(s): KIXREVSVR
    

Local fix

  • Do not use COSH prior to region termination with CEMT.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CPSM users for V5R5M0.                   *
    ****************************************************************
    * PROBLEM DESCRIPTION: Performing LMAS CICS region shutdown    *
    *                      after executing COSH, will cause error  *
    *                      message 'EYUNX0019E' issued in LMAS.    *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves         *
    *                 PH10853, all MAS regions must be recycled    *
    *                 to pick up the new code. Note that the       *
    *                 restarts do not need to occur at the same    *
    *                 time.                                        *
    ****************************************************************
    During CICS shutdown, an LMAS region will attach transaction
    COSH to terminate the CPSM MAS agent. If the MAS agent has
    already terminated (e.g: terminated by COSH), then additional
    instance of COSH attached by CICS shutdown is unnecessary.
    The additional instance of COSH running during CICS shutdown
    causes message EYUNX0019E to be issued.
    Additional Keywords: msgEYUNX0019E EYUNX0019 NX0019
    

Problem conclusion

  • EYU9NXTM has been modified to suppress message 'EYUNX0019E' when
    COSH is executing during CICS shutdown after MAS agent has
    already terminated.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH10853

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    20M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-04-10

  • Closed date

    2019-05-29

  • Last modified date

    2019-06-03

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

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

    UI63300

Modules/Macros

  • EYU9NXTM
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R20M PSY UI63300

       UP19/05/31 P F905

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

Document Information

Modified date:
03 June 2019