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.

Products

• DADS Plus

Issue/Introduction

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.

Environment

Z/OS 

CICS

Resolution

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 APPLID01                 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 APPLID01                 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=(APPLID01,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=(APPLID01,QUEUE) 
    REQUEST=(A,F,MASTER.A )