Application file not allocated by CA DADS CICS when doing a COLD start message DADSP691?

Document ID : KB000107989
Last Modified Date : 26/07/2018
Show Technical Document Details
Issue:
The client normally does CICS warm start of their CICS region and all the application files under CA DADS Plus control are allocated to CICS. When the client does a CICS COLD start one of their application programs does not get allocated to CICS at startup time. This causes one of the applications running in the CICS region not to function properly.   

The client sees the following message in the CICS startup messages
DADSP691 15:22:20 S3CICS 'FILE'='WCODF010' ALLOCATE AT COLD START OPTION = N.
 
Environment:
Z/OS 
CICS
Cause:
When you place files under CA DADS Plus CICS control the user specifies how CA DADS Plus CICS should allocate and open the file during COLD, WARM and emergency restarts.
 
In the example below this client specified options that would not allocate or open the file TESTFILE when a CICS COLD start was done. See parameter
 
ALLOC/OPEN AT COLD START ===> N N
 
The WARM and EMER startups the client specified 
 
ALLOC/OPEN AT WARM START ===> A N
ALLOC/OPEN AT EMER RESTART ===> A N
 
A (automatic) instructs CA-DADS Plus  CICS to allocate the file according to its last status during the previous execution of CICS.
N the file will not be opened until first reference.
 
TYPE ===> F NAME ===> TESTFILE
DSORG => VSAM
PRI-DSNAME ===> SUPPORT.TESTFILE      DISP ==> SHR
ALT-DSNAME ===> DISP ==>
ALLOC/OPEN AT COLD START ===> N N OPEN AFTER ONLINE ALLOC ===> N
ALLOC/OPEN AT WARM START ===> A N VSAM VERIFY AT START-UP ===> N
ALLOC/OPEN AT EMER RESTART ===> A N EFFECTIVE DATE(YYYY/DDD) ===> 0000/000
ALLOCATE IF NOT IN FCT ===> N
 
 
Resolution:
If the client would like the file allocated to CICS during a COLD start then can change the COLD start parameter to the DEFAULT setting of
 
COLD Y Y
 
For example
 
 
TYPE ===> F NAME ===> TESTFILE
DSORG => VSAM
PRI-DSNAME ===> SUPPORT.TESTFILE      DISP ==> SHR
ALT-DSNAME ===> DISP ==>
ALLOC/OPEN AT COLD START ===> Y Y  OPEN AFTER ONLINE ALLOC ===> N
ALLOC/OPEN AT WARM START ===> A N VSAM VERIFY AT START-UP ===> N
ALLOC/OPEN AT EMER RESTART ===> A N EFFECTIVE DATE(YYYY/DDD) ===> 0000/000
ALLOCATE IF NOT IN FCT ===> N
 
Here’s the link to the CA DADS PLUS CICS R 4.0 Users Guide that explains these parameters. Please review chapter 3.
 
ALLOC|OPEN AT COLD START A/Y/N | Y/N
ALLOC|OPEN AT WARM START A/Y/N | Y/N
ALLOC|OPEN AT EMER START A/Y/N | Y/N
 
Specifies how Advantage CA-DADS Plus for CICS should allocate and open the file during COLD, WARM and emergency restarts.
A (automatic) instructs Advantage CA-DADS Plus for CICS to allocate the file according to its last status during the previous execution of CICS.
Y instructs Advantage CA-DADS Plus for CICS to always allocate the file
N instructs Advantage CA-DADS Plus for CICS not to allocate the primary
 
The defaults are:
COLD Y Y
WARM A Y
EMER A Y