DADS Plus CICS deallocate of a IMS DBD fails with message DADSP829 DBCTL COMMAND FAILURE.

Products

• DADS Plus

Issue/Introduction

The client is using DADS Plus CICS to manage their IMS DBD'S. When the client attempts to deallocate a DADS Plus class that contains files and IMS DBD'S the deallocate
fails with message DADSP829 DBCTL COMMAND FAILURE. Also the IMS DBD'S  fail to allocate at CICS startup time. The following message is in the DADSLOG

DADSP829 07:45:50 CICST3A1 'DBD '='KDBOM   ' DBCTL COMMAND FAILURE

Environment

Z/OS 
CICS

Cause

IMS DBCTL was not configured correctly in the CICS region.

Resolution

DADS Plus CICS requires the CICS region to be configured for IMS CBCTL and initialized at CICS startup time. The SIT parameter  DBCTLCON=YES is required. The CICS log at startup time should contain messages

DFHSI8440I CICST3A1 Initiating connection to DBCTL.
DFHSI8441I CICST3A1 Connection to DBCTL IRD1 successfully completed.

To test the connection from CICS to the DBCTL address space the user needs to run the CICS transaction CDBM. DADS Plus CICS uses the CDBM interface to communicate with and pass commands to DBCTL.
 
If the CDBM transaction does not work then DADS Plus allocate and deallocate commands will not work.

Below is the CDBM transaction screen.


CDBM                  CICS-DBCTL Operator Transaction       
                                                
  Type IMS command. _____________________                             
                                                              
                                                              
                                                              
  For /DBDUMP or /DBRECOVER commands                          
                                                              
  Choose one. 1 1. Do not force end of volume                 
                2. Force end of volume                        
                                                              
                                                              
  Press enter to display responses.                           
                                 
  CICS APPLID A11IC4S5                                        
  DBCTL ID                                                    
                       
 F1=Help  F2=Maintenance  F3=Exit  F5=Refresh  F12=Cancel   


Below is an example of the DADS Plus Online transaction DADA that  fails when the user attempts to deallocate the class that contains the IMS DBD'S KDBOM and KDBOMI.  


 
APPLID CICSTEST                 CA-DADS/PLUS  4.0        
                     ALLOCATION - DEALLOCATION REQUEST        
                                                                             
COMMAND ===> D      
 
             A - ALLOCATE  ENABLE TRAN/PROG
             D - DEALLOCATE  DISABLE TRAN/PROG
             E - ENABLE TRAN/PROG
             R - DISABLE TRAN/PROG
             X - ALLOCATE  NO ENABLE TRAN/PROG
 
TYPE ===> C      NAME ===> KD2000            OPTIONS ===> R      
 
     F - FILE          FILEID DDNAME                 DBDS: D - DB DUMP
     C - CLASS         CLASS                               R - DB RECOVERY
     D - DBD           DBDNAME                             S - DB STOP
     T - TRANSACTIONS  FILEID DBDNAME DESTID CLASS         G - GLOBAL
     P - PROGRAMS      FILEID DBDNAME DESTID CLASS         E - LOG EOV
     Q - TD QUEUE      DESTID                              A - ASYNC (NO WAIT)
                                                     RLS:  I - IMMQUIESCE
                                                           N - DON'T PROPAGATE
 

APPLID TEST                 CA-DADS/PLUS  4.0         
                           DEALLOCATION RESULTS            
                                                                             
 
 
COMMAND ===> D        TYPE ===> C   NAME ===> KD2000     OPTIONS ===> R      
 
  TYPE:NAME       DATASET NAME OR SYSOUT CLASS                 CURRENT STATUS
 
  F:VCVBOM        TEST.ME.VCVBOM                               DEA CLO UEN
  F:VINACHT       TEST.MK.VINACHT                              DEA CLO UEN
  D:KDBOM                                                      DBCTL CMD FAILED
  D:KDBOMI                                                     DBCTL CMD FAILED                                
 

The DADSLOG contains the following messages 

DADSA571 09:13:28 CICST3A1 TERM=AAPA     'DBD '='KDBOM   ' DEALLOCATION STARTING.
DADSA829 09:13:28 CICST3A1 TERM=AAPA     'DBD '='KDBOM   ' DBCTL COMMAND FAILURE
DADSA571 09:13:28 CICST3A1 TERM=AAPA     'DBD '='KDBOMI  ' DEALLOCATION STARTING.
DADSA829 09:13:28 CICST3A1 TERM=AAPA     'DBD '='KDBOMI  ' DBCTL COMMAND FAILURE