Build a Production IODF

This utility function creates a production IODF using the work IODF. The work IODF has to be specified with DD name HCDIODFS, the target production IODF with DD name HCDIODFT. First, the target production IODF has to be created by defining a VSAM DIV file and initializing it using the utility Initialize IODF (see Initialize IODF).

If the work IODF has an associated MCF, the MCF data set is copied and associated to the production IODF.

After the production IODF has been built, it is copied back to the work IODF. Thus, the work IODF contains the new tokens and can be used for further updates. Since the production IODF may be larger than the original work IODF, the work IODF may be automatically enlarged to accommodate the contents of the production IODF.

This function is invoked by passing the following parameter string.

|--PRODIODF--+-------------------------------------+------------|
             +-DESC1=descriptor1-------------------+
             +-DESC2=descriptor2-------------------+
             '-DESC1=descriptor1,DESC2=descriptor2-'
 

DESC1=descriptor 1

Default is the first qualifier of the production IODF name (up to 8 characters).

DESC2=descriptor 2

Default is the second qualifier of the production IODF name, which is IODFxx (up to 8 characters).

The descriptor fields describe the IODF and will be part of the HSA token. Attention: If you specify asterisks (**), equals (==), pluses (++), or minuses (--) for the IODF suffix in LOADxx, never change the default descriptor field values, because z/OS uses these values to find the current IODF during IPL. Take this relationship also into consideration, if you copy the IODF to a different data set name.

Batch invocation

A data set must be allocated to the following DD names when invoking the batch utility.

Example: 

//BWINJOB  JOB (3259,RZ-28),'BWIN',NOTIFY=BWIN,CLASS=A,
//             MSGCLASS=Q,MSGLEVEL=(1,1),REGION=4M
//*
//* BUILD PRODUCTION IODF
//*
//PROD     EXEC PGM=CBDMGHCP,
//             PARM='PRODIODF DESC1=BWIN,DESC2=IODF03'
//HCDIODFS DD   DSN=BWIN.IODF03.WORK,DISP=OLD
//HCDIODFT DD   DSN=BWIN.IODF03,DISP=OLD
//HCDMLOG  DD   DSN=BWIN.HCD.LOG,DISP=OLD
//