How to configure CA DADS Plus for CICS to use alternate files? This feature allows the user to switch from primary file to an alternate file.

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

Description

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.

Solution

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.

    FUNCTION=DADS,APPLID=(A04ICI33,QUEUE) 
REQUEST=(A,F,MASTER.P )

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 )