How to Enable Deferred File Creation

Enable Deferred File Creation to facilitate the creation of development work areas
As a
CA Endevor
administrator, you can enable the Deferred File Creation feature to facilitate the creation of development work areas for your developers and their development process.
Instead of having to predefine all the data sets that are associated with a
CA Endevor
development work area, this feature allows the creation of Base, Delta, Source Output, and Processor Output files when the first attempt at allocation fails because the file does not exist. This feature works by allowing you to specify the parameters needed to allocate the files as
new
files.
CA Endevor
symbols can be used in the file specifications to allow a single entry in the Deferred File Creation member to be used for the allocation of files based on their location within the
CA Endevor
systems and lifecycle.
The Deferred File Creation feature is enabled by completing three procedures.
Follow these steps:
  • Files that are specified on your Type definition (Base, Delta, Source Output) must be defined with symbols in their names in order to take advantage of Deferred File Creation. Files that are specified on a Type definition that are explicit
    must exist
    in order for the Type to be defined successfully.
  • CA Endevor
    files that can be created with the Deferred File Creation process, and that are used as
    input
    in your processors (for example, files used in a SYSLIB DD statement) should be specified in the processor input DD statement with the ALLOC=COND parameter, which will only allocate the file if it exists. This specification of files avoids unnecessary attempts to create files that remain empty. Attempted creation of the file by the Deferred File Creation process might fail because the file might not match an entry in the Deferred File Creation member.
Allocation of processor input files that do not exist
will automatically be skipped
if the
ALLOC=LMAP
or
ALLOC=PMAP
parameter is specified. In other words, if DFC is active and a DD is coded in your processor with ALLOC=LMAP or ALLOC=PMAP, any file in the concatenation that does not exist will have its allocation automatically skipped (the allocation of each file becomes conditional) as if COND was also specified as part of the ALLOC parameter. The file will not be created by the DFC process.
Review Process for Defining Development Work Areas
Review or create the process for defining development work areas within
CA Endevor
for the developers at your site to determine whether the Deferred File Creation process would be a benefit in defining and creating these work areas.
Configure C1DEFLTS for Deferred File Creation
To enable the Deferred File Creation feature, you must update your C1DEFLTS table.
Follow these steps:
  1. Define the name of the Deferred File Creation member to your C1DEFLTS table TYPE=MAIN section using the DFCMBR= parameter.
  2. Reassemble your C1DEFLTS table.
Create Deferred File Creation Member
To enable the Deferred File Creation feature, a member must be added to your PARMLIB data set that defines the parameters necessary to allocate files as
new
when they are being allocated for the first time and the allocation fails because the file does not exist.
The Deferred File Creation member contains statements that will be parsed at element action execution time and used during file allocations if a file does not exist. You can use
CA Endevor
symbols to define your data set names within this member. Substitution for these symbols takes place at file-allocation time
before
input data set matching against the entries in the Deferred File Creation member takes place.
Follow these steps:
  1. Create the Deferred File Creation member using the following syntax diagram.
  2. Add the Deferred File Creation member to your PARMLIB.
  3. Validate the Deferred File Creation member by running
    CA Endevor
    with the EN$TROPT (the
    CA Endevor
    Options Trace) DD statement. The Deferred File Creation member is printed as part of this trace if it is successfully parsed. If a parsing or other error occurs, messages should be visible in the output. An error in the Deferred File Creation member does not terminate the execution and will
    not affect
    the return code.
Syntax Diagram:
|<------------------------------------------------------------<| >>-+- DSN 'data.set.name.with.symbols' ------------------------------> | >--+------------------------------------------+----------------------> |- LIKe 'like.data.set.name.with.symbols' -| | | | * The specification of the MODEL keyword indicates this | * DFC entry is for the creation of a VSAM data set. | >--+--------------------------------------------+--------------------> |- MODel 'model.data.set.name.with.symbols' -| | | >--+-----------------+-----------------------------------------------> |- UNIt unitname -| | | >--+---------------------------+-------------------------------------> |- SPAceunits -+- CYLs ---+-| | |- TRKs ---| | | >--+-----------------+-----------------------------------------------> |- PRImary nnnnn -| | | >--+-------------------+---------------------------------------------> |- SECondary nnnnn -| | | >--+-----------------+-----------------------------------------------> |- DIRblks nnnnn -| | | >--+--------------------------------+--------------------------------> |- DSNType ----+- PDS ---------+-| | |- PDSE --------| Same as LIBrary | |- LIBrary -----| | |- EXTReq ------| | |- EXTPref -----| | |- BASic -------| | |- LARge -------| | | >--+--------------------------------+--------------------------------> |- DSOrg ------+- DA ----------+-| | |- DAU ---------| | |- PO ----------| | |- POU ---------| | |- PS ----------| | |- PSU ---------| | | >--+----------------------+------------------------------------------> |- VERsion ----+- 1 -+-| PDSE only | |- 2 -| | | >--+-----------------+-----------------------------------------------> |- MAXgens nnnnn -| PDSE V2 only | | >--+----------------------------+------------------------------------> |- RECfm ------+- F -------+-| Most RECFM values are | |- FB ------| supported. This is a | |- FBA -----| sample list only. | |- V -------| | |- VB ------| | |- VBA -----| | |- U -------| | | >--+---------------+-------------------------------------------------> |- LREcl nnnnn -| | | >--+-----------------+-----------------------------------------------> |- BLKsize nnnnn -| | | >--+---------------------+-------------------------------------------> |- STOrclas storclas -| | | >--+---------------------+-------------------------------------------> |- MGMtclas mgmtclas -| | | >--+---------------------+-------------------------------------------> |- DATaclas dataclas -| | | >--+-----------------+-----------------------------------------------> |- VOLume volume -| | | * The following parameters are
only
for ELIB initialization. | * ALLOCATE PAGES
must
be coded for ELIB initialization to take place. | >--+---------------------+-------------------------------------------> |- PAGe SIZe = ##### -| | | >--+----------------------------------+------------------------------> |- ALLocate PAGes = (#####,#####) -| | | >--+-------------------------+---------------------------------------> |- REServe PAGes = ##### -| | | >--+----------------------------+------------------------------------> |- DIRectory PAGes = #####> -| | | >---- . ----------------------------------------------------------+-><
Syntax rules:
  • Comments are allowed. You must code an asterisk (*) in column 1.
  • Multiple DSN statements are allowed.
  • All keywords other than DSN are optional.
  • Data set names are not checked for validity.
  • Wildcarded data set names are
    not
    supported.
  • CA Endevor
    Site and C1 symbols in data set names are supported, including the LIKE and MODEL parameter data set names.
    For all non-VSAM allocations, the allocation parameters that are supplied in the DFC member are used as input to Dynamic Allocation, and produce the same results as their JCL equivalents. For example, if you specify a RECFM of FB and an LRECL of 80 but no BLKSIZE for a DFC entry, you get the same default BLKSIZE as you would if the file was allocated by JCL.
    The LIKE parameter causes most attributes of the "liked" data set to be inherited by the target data set. Notably, the BLKSIZE attribute is not inherited. If a particular BLKSIZE is required, you must supply one. Supplying a BLKSIZE is especially important for RECFM U data sets (typically load libraries). If a RECFM U data set is created with no BLKSIZE supplied, that data set will most likely be created with a BLKSIZE of zero and be unusable.
    When allocating a PDSE, if you do not supply a LIKE parameter, you must include “DSNTYPE LIBRARY” or “DSNTYPE PDSE” and “DSORG PO” or “DIRBLKS”. If you do not include either DSORG PO or DIRBLKS, the file will be allocated as DSORG PS. This behavior is the same as in a JCL allocation.
  • There are no default values. New allocations will be done with whatever parameters are specified.
  • The LIKE and MODEL keywords are mutually exclusive.
  • The MODEL keyword
    must
    be coded if the DFC entry is for the deferred file creation of a VSAM data set.
  • A call to IDCAMS is made to allocate a new VSAM data set through DFC.
  • For a VSAM DFC entry, only the following additional parameters, other than MODEL (required) and ELIB initialization parameters, are supported: SPACEUNITS, PRIMARY, SECONDARY, STORCLAS, MGMTCLAS, DATACLAS, VOLUME. These additional parameters, if specified, override those specifications as found on the MODEL data set.
  • For VSAM file space requests, SPACEUNITS
    must
    be coded and PRIMARY must be greater than 0. Otherwise, they will not be included in the parameters passed to IDCAMS, and will be taken from the MODEL.
  • ALLOCATE PAGES must be coded if the DFC entry is for the deferred file creation of an ELIB data set.
  • Both BDAM and VSAM ELIB specifications are supported.
  • Only 1 volume can be specified.
  • The VERSION keyword is only supported for PDSE data sets. Specification of VERSION for a non-PDSE data set in the Deferred File Creation member will cause an SMS dynamic allocation error when that entry is used for deferred file creation.
  • The MAXGENS keyword is only supported for PDSE version 2 data sets. Specification of MAXGENS for a non-PDSE version 2 data set in the Deferred File Creation member is usually ignored when that entry is used for deferred file creation.
  • If any keywords are specified more than once, last in wins. No error is generated.
  • Statements are
    order-dependent
    and are matched against the input data set in the order in which they are coded. More explicit DSN statements should be coded first.
Examples
Example: Deferred File Creation Member
The following is an example of a Deferred File Creation member and is meant to show the options you have for allocating new files as they are needed by
CA Endevor
. The LIKE parameter is recommended for use, if possible, for your DSN entries for ease of coding. For VSAM entries, MODEL is required.
For RECFM=U data sets (usually LOADLIBs), when LIKE is coded, we recommend that you also code BLKSIZE. The block size is not copied to the newly allocated data set from the LIKE data set when RECFM=U.
* * These first entries are to see how symbols get resolved. * Data set names are not checked for validity. * DSN '&C1EN/&C1S#/&C1SY/&C1SU/&C1ELEMENT/&C1TY' . DSN 'Stage ID: &C1SI Stage Name: &C1ST' . * * Processor output libraries. * Site symbols begin with #. * DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..ELMOUT' LIKE '&#BASEPRFX..&C1SY..GA.&C1EN(1,1)&C1S#..ELMOUT' . DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..LOADLIB1' UNIT SYSDA RECFM U BLKSIZE 32760 SPACE CYLS PRIMARY 1 SECONDARY 5 DSNTYPE PDSE DIRBLKS 91 . DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..LOADLIB2' LIKE '&#BASEPRFX..&C1SY..GA.&C1EN(1,1)&C1S#..LOADLIB2' BLKSIZE 32760 . DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..LISTLIB' UNIT SYSDA RECFM FBA LRECL 133 BLKSIZE 26600 SPACE CYLS PRIMARY 5 SECONDARY 5 DIRBLKS 91 . * * Base, Delta and Source Output files. * * Type VBDATA base data set – VB-259 * This must be before the entry with &C1TY as last qualifier DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..VBDATA' UNIT SYSDA RECFM VB LRECL 259 BLKSIZE 27998 SPACE CYLS PRIMARY 1 SECONDARY 1 DIRBLKS 90 . * All other Type base data sets – FB-80 DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..&C1TY' UNIT SYSDA RECFM FB LRECL 80 BLKSIZE 27920 SPACE CYLS PRIMARY 1 SECONDARY 1 DIRBLKS 90 . * All DELTA files – VB-259 DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..DELTA' UNIT SYSDA RECFM VB LRECL 259 BLKSIZE 27998 SPACE CYLS PRIMARY 1 SECONDARY 1 DIRBLKS 90 . * Source Output files – FB-80 DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..SOL' UNIT SYSDA RECFM FB LRECL 80 BLKSIZE 27920 SPACE TRKS PRIMARY 5 SECONDARY 15 DSNTYPE LIBRARY VERSION 2 DIRBLKS 91 MAXGENS 7 . * * Sequential processor output file, 1 per element. * DSN '&#BASEPRFX..&C1SY..&C1SU..&C1ST..&C1ELEMENT' UNIT SYSDA RECFM VBA LRECL 137 BLKSIZE 27998 SPACE TRKS PRIMARY 1 SECONDARY 1 DSORG PS . * * Sample BDAM ELIB specification. DSN '&#BASEPRFX..&C1ST..DELTA' * LIKE '&#BASEPRFX..&C1ST..MODLBDAM' DSORG DA LRECL 4096 BLKSIZE 4096 SPACE CYLS PRIMARY 10 SECONDARY 2 * ELIB initialization parameters... PAGE SIZE = 4096 ALLOCATE PAGES = (540,360) RESERVE PAGES = 150 DIRECTORY PAGES = 45 . * * Sample VSAM ELIB specification. DSN '&#BASEPRFX..&C1ST..LISTING' * MODEL indicates VSAM MODEL '&#BASEPRFX..&C1ST..MODLVSAM' * Other parameters supported for a VSAM file through DFC: ** SPACE CYLS ** PRIMARY 5 ** SECONDARY 5 ** STORCLAS storclas ** MGMTCLAS mgmtclas ** DATACLAS dataclas ** VOLUME volume * ELIB initialization parameters... PAGE SIZE = 4088 ALLOCATE PAGES = (499,100) RESERVE PAGES = 250 DIRECTORY PAGES = 50 .