How do I update the CA DADS Plus for CICS global allocation options, that are stored in the DADS01 control file?

Products

• DADS Plus
• Telon Application Generator

Issue/Introduction

Description:

The CA DADS Plus for CICS Global Allocation Options are stored in the DADS01 control file.
These options can be updated from CICS by using the GLOBAL ALLOCATION OPTIONS DISPLAY menu or by using the batch utility program DADBCNTL.

Solution:

CICS Online Updating

There are two ways to access the Global Allocation Options Display menu once you sign onto CICS. From a clear screen enter transaction DADS and press ENTER and the CA DADS Plus PRIMARY MENU appears.

Next, select option 1 - DYNAMIC ALLOCATION FACILITY and press ENTER and the DYNAMIC ALLOCATION FACILITY MENU appears.
Next, select 6 OPTIONS - DISPLAY/MODIFY GLOBAL ALLOCATION OPTION and press ENTER and the GLOBAL ALLOCATION OPTIONS DISPLAY appears.

You can also display the GLOBAL ALLOCATION OPTIONS DISPLAY menu by entering the DADC transaction from a clear screen in CICS and pressing ENTER.
The DADC transaction is a shortcut that gives the user direct access to global allocation options menu.
In some environments the DADC transaction may not be available due to security requirements.

When the GLOBAL ALLOCATION OPTIONS DISPLAY menu appears press the PF9-UPDTE key and the options become unprotected.
Next make the necessary option changes and press PF9-UPDTE to apply the updates.
The following message will appear DADSC005 - UPDATE COMPLETE FOR CONTROL RECORD.

 APPLID A11IC4S6                 CA-DADS/PLUS  4.0          12/15/2008 11:31:14
                        GLOBAL ALLOCATION OPTIONS DISPLAY
 
 COMMAND  ===>
 
 OPTION  STATUS:  CURRENT  CNTL FILE                         CURRENT  CNTL FILE
                  --------|---------                         --------|---------
 DADS APPLID ==>           A11IC4S5      BATCH INTERFACE =>     Y         Y
 VERIFY      ==>     Y         Y         BATCHQUEUECOLD ==>     N         N
 ALTDSNAME   ==>     Y         Y         BATCHQUEUEWARM ==>     N         N
 SUBTASKING  ==>               N         BATCHQUEUEEMER ==>     N         N
 SVC NUMBER  ==>    230       230
 FCTUPDATE   ==>     A         A
 
 ONLINE EXITS =>     N         N         ACTIVEPSB      ==>     N         N
 (EXIT PROGRAM NAMES LISTED BELOW)       (N=NORMAL|B=BYPASS|MM=WAIT MINS)
 
 PREREQUEST  ==>                         POSTREQUEST    ==>
 PREALLOCATE ==>                         PREDEALLOCATE  ==>
 PREOPEN     ==>                         PRECLOSE       ==>
                                         MIGRATEDDSN    ==>     N         N
 
 DADSC005 - UPDATE COMPLETE FOR CONTROL RECORD.
            PF3-END    PF4-EXIT   PF9-UPDTE

NOTE: Not all the control file parameters can be updated from this menu. For example the DADS APPLID and SVC NUMBER cannot be changed. These options can only be updated using the batch utility program DADBCNTL.

Batch Update

The example JCL below was used to update the DADS01 control file using the batch utility program DADBCNTL.
In this example control file options HEADER and SVC number were updated using the UPDATE parameter.
Note: the UPDATE parameter instructs batch utility program DADBCNTL to update the contents of the control file.
When running the DADBCNTL batch utility program the CA DADS Plus for CICS control file can be allocated to CICS but must be closed.

//UPDTCNTL JOB           
//CNTL     EXEC PGM=DADBCNTL,REGION=700K                                
//STEPLIB  DD  DSN=DADSPL40.P0507.SMP.LOADLIB,DISP=SHR           
//DADS01   DD  DSN=CICS65.DADS.CONTROL,DISP=SHR          
//SYSPRINT DD SYSOUT=A,DCB=(LRECL=133,RECFM=FBA,BLKSIZE=133)            
//SYSIN    DD *                                                         
UPDATE                                                                  
HEADER=CA DADS PLUS FOR CICS TEST REGION A11IC4S6                       
SVC=230                                                                 
/*                                                                      
//

Environment

Release:
Component: DADSPL