A fix is available
APAR status
Closed as program error.
Error description
You COLD start the CMAS while the VTAM ACB for this CMAS is inactive. The Connection and Session to the partner CMAS is CREATED and installed. The connection fails with message DFHZC2405 E CMASA -AAA CSNE NODE CICSA NOT ACTIVATED VTAM RETURN CODE 1000 ((6) MODULE. When the VTAM ACB for this CMAS is subsequently activated, the connection is never acquired. Additional Symptom(s) and Keyword(s): 5655M1501 R100 R310 R3.1 CSLT ACQ REL RELEASED Connection STATUS INSERVICE INSERV INS
Local fix
Manually set the CMAS connection status to ACQuired.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: LU62 CMAS to CMAS links may not be * * established between two CMASes if * * a network issue does not allow the * * automatic connection attempt to * * succeed at CMAS startup, VTAM ACB * * open, or CMTCMDEF install. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and Web User Interface * * servers must be recycled to pick up the * * new code. Note that the restarts do not * * need to be done at the same time. * * * * Additionally users of the CICSPlex SM * * supplied starter set viewsets and menus must * * re-import the updated starter set viewset * * and menu definitions into each Web User * * Interface (WUI) server's repository in order * * to pick up the changes. * * * * The starter set viewsets and menus can be * * re-imported either via the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters or the IMPORT (from a dataset) * * function of the COVC WUI transaction. * * * * If COVC is used to re-import the starter * * set, ensure that the OVERWRITE import option * * is specified if the WUI server's repository * * previously contained that starter set * * viewsets and menus. * * * * For details on the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters see 'Specify the Web User * * Interface server initialization parameters' * * in the CICS Transaction Server for z/OS * * Version 3 Release 2 Installation Guide * * (GC34-6812). * * * * For details on the COVC IMPORT function see * * 'The CICSPlex SM Web User Interface * * transaction (COVC)' in the CICS Transaction * * Server for z/OS Version 3 Release 2 CICSPlex * * SM Web User Interface Guide (SC34-6841). * * * * The updated starter set member name that * * needs to be imported is: * * * * ViewSet : EYUxA1VW * * * * Replace x with the required language version * * to be imported: E - English, K - Japanese, S * * - Chinese. * * * * Insure that the import references the * * SEYUVIEW dataset that was updated by the PTF * * that resolves this APAR. * **************************************************************** The initial acquire of a APPC CMAS to CMAS link depends upon the AUTOCONNECT(YES) option of the CICS connection definition that is automatically created for a CMAS to CMAS link. CICS will attempt to process the AUTOCONNECT(YES) option at CICS startup, VTAM ACB open, or connection install. If a required network resource is not available when both systems start, for example a CDRSC, then the connection may never be automatically acquired.
Problem conclusion
A new CICSPlex SM CMAS system parameter called CMTCMLNKACQ has been added to control when CICSPlex SM network surveillance attempts to re-acquire the CICS connection for CMTCMLNKs. CMTCMLNKACQ may be set to: ALWAYS - The CMAS will attempt to acquire CMTCMLNKs even if they have never been established in the current CMAS run. RECONN - The CMAS will attempt to re-acquire CMTCMLNKs only for CMTCMLNKs that were previously established in the current CMAS run. This is the default and is how CICSPlex SM operates prior to installing the PTF that resolves this APAR. To prevent users of CMTCMLNKACQ(RECONN) from having to logon to a CMAS to acquire the CICS connections for a CMTCMLNK, support has been added to the CICSPlex SM API and WUI to allow for a new ACQUIRE action on the CMTCMLNK resource table. This action can be used to inservice and acquire LU62 CMTCMLNKs. The following changes have been made to enable this support: - EYU0CSLT (CSLT) has been changed to retrieve the new CMTCMLNKACQ system parameter. CSLT will attempt to reacquire LU62 CMTCMLNKs based upon the following: 1 - The CMAS must be the 'first-speaker' CMAS for the CMTCMLNK. The 'first-speaker' CMAS is the CMAS that has the lowest CICS SYSID of the two CMASes. If the CMAS is not the first speaker the CMTCMLNK will not attempt to be reacquired and no further checks will be made. 2 - If the CMTCMLNK was previously active during this CMAS run, CSLT will attempt to reacquire without making any further checks. 3 - If the CMTCMLNK was not previously active during this CMAS run and the CMTCMLNKACQ(ALWAYS) system parameter is set, then CSLT will attempt to reacquire. - EYUTXLPD has been updated to define the new CMTCMLNKACQ system parameter. - New method EYU0CSMC (CSMC) has been defined. This method is responsible for performing the new ACQUIRE action that has been added to the CMTCMLNK resource table. - The following IBM supplied Web User Interface views have been updated: - EYUSTARTCMTCMLNK.ACQUIRE has been created. This is a confirmation panel for the ACQUIRE action. - EYUSTARTCMTCMLNK.TABULAR has been updated to add a button for the ACQUIRE action. Additionally, columns for the CICS ACQUIRE and INSERVICE status have been added. Finally a link to the EYUSTARTCMAS.DETAILED view has been added. - EYUSTARTCMTCMLNK.DETAILED has been updated to add a button for the ACQUIRE action. Additionally links have been added to the EYUSTARTCMAS.DETAILED view, the local CMASes EYUSTARTCMTCMDEF.DETAILED view, the local CMASes EYUSTARTCMASLIST.TABULAR view, the target CMASes EYUSTARTCMASLIST.TABULAR view, and the target CMASes EYUSTARTCMTCMLNK.TABULAR view. - EYU0VIFM (VIFM) has been updated so that if message EYUVC1270 is to be issued, and the OBJSTAT_CICSNAME information is not available, OBJSTAT_CONTEXT is retrieved and used in its place.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK45640
Reported component name
CICSTS 3.X Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-05-23
Closed date
2007-08-21
Last modified date
2007-09-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK28384
Modules/Macros
CMTCMLNK DYU0VIFM EYUA2444 EYUCXXRS EYUC2444 EYUEA1VW EYUE2444 EYUKA1VW EYUK2444 EYUL2444 EYUP2444 EYUQCSIN EYUQCSMC EYUQXXRC EYURCOEB EYURCSIN EYURCSMC EYUR2444 EYUSA1VW EYUS2444 EYUTRCOM EYUTRDIR EYUTXLPD EYUT2444 EYUUXXFI EYUUXXRS EYUUXXTC EYUYCSIN EYUYCSMC EYUY2444 EYUZCSIN EYUZCSMC EYU0CSIN EYU0CSLT EYU0CSMC EYU0DSET EYU0VIFM EYU0XLPS EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9DBG1 JCI650MJ
GC34681200 | SC34685000 |
Fix information
Fixed component name
CICSTS 3.X Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK28384
UP07/08/23 P F708
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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 September 2007