Allocating the image copy data set
The output image copy data set can be allocated by using DD statements supplied in the JCL or by using dynamic allocation.
BMC recommends dynamic allocation because of the flexibility and improved control that it provides.
Using JCL to allocate the image copy data set
Use the DDNAME keyword to indicate that the image copy data set is allocated using JCL DD statements.
The example below shows the request to make an image copy of an area. The output image copy is written by the DD statement named icddname that is supplied in the JCL.
//STEPLIB DD DISP=SHR,DSN=BMC.PFP.LOAD
// BMC.ICP.LOAD,DISP=SHR
// DD DISP=SHR,DSN=IMS.RESLIB
//icddname DD UNIT=TAPE,DISP=(NEW,CATLG),
// DSN=your.dataset.name
//PFPSYSIN DD *
ANALYZE DBD=dbdname,IAREA=areaname
IC DDNAME=icddname
/*
Using dynamic allocation for the image copy data set
Use the DSNAME keyword to indicate that the image copy data set is to be dynamically allocated and to supply a mask for constructing the data set name.
Substitution variables within the mask can be used to generate unique names for each output data set.
Additional keywords such as UNIT, DISP and DATACLAS can be used to control the allocation and disposition of the data set, similar to the corresponding JCL keywords.
The example below requests the creation of a single output image copy data set for each area (using the default IAREA=ALL) within the database. Each image copy data set is written to a tape device and recorded in the system catalog.
IC DSNAME='dataset-name-mask',
DISP=(NEW,CATLG),UNIT=TAPE
The data set name that is specified with the DSNAME keyword can refer to a generation data group (GDG). Code the DSNAME keyword to specify the base name for the GDG. You can include the (+1) relative generation number as part of the DSNAME keyword.
The example below uses a DSNAME keyword to refer to a GDG.
IC DSNAME='dataset-name-mask(+1)',
DISP=(NEW,CATLG),UNIT=TAPE
If you do not specify the (+1) relative generation number, the product automatically appends the incremented (+1) generation number to the data set name if it is recorded in the system catalog as a GDG base name.
Related topic