CA DADS Plus for CICS has a feature that allows the user to define two DSN names for a file. (FCT entry).
A file can be allocated by its primary DSN name or an alternate DSN name.
This feature allows the user to point to a backup copy of a file while batch processing is processing the production cluster.
The alternate file feature is controlled by the CA DADS Plus Global allocation option ALTDSNAME= which is stored in the CA DADS Plus control file. The default for this option is NO. To active this feature the batch utility program DADBCNTL can be used to set ALTDSNAME=YES. The JCL example below can be used to update the control file. If the control file is allocated to CICS it must be closed before updating this option.
The DADBCNTL is outlined in the CA DADS Plus for CICS Installation guide Chapter Control file Initialization programs.
// JOBCARD //UPDTCNTL EXEC PGM=DADBCNTL,REGION=700K //STEPLIB DD DSN=CA.DADSPLUS.LOAD,DISP=SHR //DADS01 DD DSN=CA.DADSPLUS.CONTROL,DISP=SHR //SYSPRINT DD SYSOUT=A,DCB=(LRECL=133,RECFM=FBA,BLKSIZE=133) //SYSIN DD * UPDATE ALTDSNAME=YES /* //
In the example below file MASTER is defined to CA DADS Plus for CICS with a primary DSNAME and an alternate DSNAME.
APPLID A11IC4S5 CA-DADS/PLUS 4.0 DATE TIME FILE ALLOCATION DEFINITION INQUIRY
COMMAND ===> I
TYPE ===> F NAME ===> MASTER DSORG => UNAV PRI-DSNAME ===> MASTER.FILE.PRIMARY DISP ==> SHR ALT-DSNAME ===> MASTER.FILE.ALTERNAT DISP ==> SHR ALLOC/OPEN AT COLD START ===> Y Y OPEN AFTER ONLINE ALLOC ===> Y ALLOC/OPEN AT WARM START ===> A Y VSAM VERIFY AT START-UP ===> N ALLOC/OPEN AT EMER RESTART ===> A Y EFFECTIVE DATE(YYYY/DDD) ===> 0000/000 ALLOCATE IF NOT IN FCT ===> N LAST PROCESSED: 2008/351 20:08:40 BY DADSMN3 CURRENT STATUS: NOT-ALL NOTINFCT JUST CREATED
------------------------------------------------------------------------------- PF3-END PF4-EXIT PF6-CLASS PF9-TRAN PF10-PROG PF11-AUTO
Below is an example of using the CA DADS Plus for CICS DADA transaction to Allocate the alternate dataset MASTER.FILE.ALTERNAT associated with file F:MASTER.
To allocate the alternate file you specify name MASTER.A
To allocate the Primary file you specify name MASTER.P
APPLID A11IC4S6 CA-DADS/PLUS 4.0 DATE TIME ALLOCATION PRE-REQUEST STATUS
COMMAND ===> A TYPE ===> F NAME ===> MASTER.A OPTIONS ===>
TYPE:NAME DATASET NAME OR SYSOUT CLASS CURRENT STATUS
F:MASTER MASTER.FILE.ALTERNAT NOT-ALL NOTINFCT
PRESS ENTER TO PROCESS
PF3-END PF4-EXIT PF9-REFR
You can also allocate a primary or alternate file in a batch JOB using the CA DADS Plus for CICS batch interface facility.
The example below lists the CA DADS Plus for CICS control cards needed to allocate the primary dataset name for file MASTER.
The example below lists the CA DADS Plus for CICS control cards needed to allocate the Alternate dataset name for file MASTER
FUNCTION=DADS,APPLID=(A04ICI33,QUEUE) REQUEST=(A,F,MASTER.A )