How do I update or change a VSAM file defined to the CA DADS Plus for CICS control file using the batch utility program DADM? What is the syntax of the DADM utility program changefile command?

Document ID : KB000025527
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

You can change options on files stored in the CA DADS Plus for CICS control file using the CICS online facility or by using the batch utility program DADM. If the CA DADS Plus control file is allocated to CICS you must close the control file before running the DADM utility program to perform the requested update.

Solution:

The FILE ALLOCATION DEFINITION CHANGE menu below can be used to update a file defined to the CA DADS Plus for CICS control file. In the example below alternate dataset CA.DADSPLUS.FILE001.ALTERNAT
was added to the ALT-DSNAME entry and ALT DISP was set to SHR.

APPLID A11IC4S6                 CA-DADS/PLUS  4.0         12/19/2008 12:58:14
                         FILE ALLOCATION DEFINITION CHANGE
   
   
   COMMAND  ===>  C
   
      TYPE  ===>  F   NAME  ===>  FILE001
   DSORG => VSAM
   PRI-DSNAME ===> CA.DADSPLUS.FILE001                             DISP ==> SHR
   ALT-DSNAME ===> CA.DADSPLUS.FILE001.ALTERNAT                    DISP ==> SHR
   ALLOC/OPEN AT COLD START    ===> N N   OPEN AFTER ONLINE ALLOC  ===> Y
   ALLOC/OPEN AT WARM START    ===> N N   VSAM VERIFY AT START-UP  ===> N
   ALLOC/OPEN AT EMER RESTART  ===> N N   EFFECTIVE DATE(YYYY/DDD) ===> 0000/000
   ALLOCATE IF NOT IN FCT    ===> N
   LAST PROCESSED:  2008/352 10:34:51 BY DADSPLTI
   CURRENT STATUS:  NOT-ALL CLO ENA 
                   USER OPTION
   
   -------------------------------------------------------------------------------
                PF3-END    PF4-EXIT   PF6-CLASS  PF9-TRAN   PF10-PROG  PF11-AUTO

The example DADM batch utility JCL below was used to update file FILE001. Alternate file CA.DADSPLUS.FILE001.ALTERNAT was added to the ALT-DSNAME option and the alternate file
DISP was set to SHR.
The DADM batch utility is outlined in the CA DADS Plus for CICS User Guide Chapter Batch Maintenance Dynamic Allocation.

//JOBCARD 
//ALTS       EXEC PGM=DADM,REGION=700K
//DADS01     DD DSN=CA.DADSPLUS.CONTROL,DISP=SHR
//SYSPRINT   DD SYSOUT=*,DCB=(LRECL=133,RECFM=FBA,BLKSIZE=133)
//SYSIN      DD *
CHANGEFILE NAME(FILE001) ALTDSNAME(CA-DADSPLUS.FILE001.ALTERNAT) -
                         ALTDISP(SHR)