IBM Support

PK45640: CMAS CONNECTION NOT ACQUIRED AFTER COLD START. DFHZC2405 NODE NOT ACTIVATED VTAM RETURN CODE 1000

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PK33320

  • 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
    

Publications Referenced
GC34681200SC34685000   

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