A fix is available
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