Build an IOCDS or an IOCP input data set

This utility function builds the IOCDS or the IOCP input data set using the definitions of a production IODF. This function is invoked by passing the following parameter string.

>>-IOCDS--,--+-------+--,--procid--,--| ind |------------------><
             '-iocds-'
 
ind
 
           .-SA---.
|--+-D--,--+------+----------------------+----------------------|
   |       '-NOSA-'                      |
   +-I--+-------------+--+-------------+-+
   |    '-,--NOCHKCPC-'  '-,--LOCALWRT-' |
   +-W--+-------------+--+-------------+-+
   |    '-,--NOCHKCPC-'  '-,--LOCALWRT-' |
   +-S-----------------------------------+
   '-T-----------------------------------'
 

iocds

is a two-character IOCDS identifier, if building an IOCDS

procid

Processor ID

D | I | W | S | T

One-character request code:

D

Build an IOCP input data set

SA

The generated IOCP statements can be used for the stand-alone IOCP program (default).

NOSA

Depending on the HCD profile option MIGRATE_EXTENDED=YES, the generated IOCP statements have additional information that can be used for the extended migration. This information is shown as comments to IOCP.

Note:

An IOCP input data set generated with operand NOSA may not be accepted by the stand-alone IOCP program, because of differences between the IOCP program running in z/OS and the stand-alone IOCP program.

I

Build an IOCDS

NOCHKCPC

Write an IOCDS regardless of the type of the receiving processor. Refer to Supported Hardware Report for a list of processor types that can receive an IOCDS in preparation for a processor upgrade and for processor types for which such an IOCDS can be written.

LOCALWRT

This parameter enforces a local IOCDS write. A defined SNA address which is normally used by HCD to initiate a remote IOCDS build to the support element with the designed SNA address, is ignored in this case.

W

Build an IOCDS with dual-write option (optionally with NOCHKCPC and LOCALWRT, see option I).

S

Build an IOCDS and set the IOCDS active for next POR

T

Build an IOCDS with dual-write option and set the IOCDS active for next POR

Batch invocation

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

Example 1: 

The following example shows a Build IOCDS job.

//BWINJOB  JOB (3259,RZ-28),'BWIN',NOTIFY=BWIN,CLASS=A,
//             MSGCLASS=Q,MSGLEVEL=(1,1),REGION=5M
//*
//* BUILD IOCDS (WITH DUAL-WRITE OPTION)
//*
//IOCDS    EXEC PGM=CBDMGHCP,
//            PARM='IOCDS,A0,PROC1,W'
//HCDIODFS DD   DSN=BWIN.IODFA3,DISP=OLD
//HCDMLOG  DD   DSN=BWIN.HCD.LOG,DISP=OLD
//SYSPRINT DD   DSN=&&IOCPOUT,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=6650),
//             SPACE=(CYL,(1,1)),DISP=(NEW,PASS,DELETE),UNIT=SYSALLDA
//SYSIN    DD   DSN=&&TEMP,DISP=(NEW,DELETE),SPACE=(CYL,(1,1)),
//             DCB=(RECFM=FB,LRECL=80,BLKSIZE=6080),UNIT=SYSALLDA
//HCDCNTL  DD   *
IOCDSNAM
/*
//* EXECUTED ONLY IF RETURN CODE HIGHER THAN 0
//PRINT    EXEC PGM=IEBGENER,COND=(0,EQ,IOCDS)
//SYSUT1   DD   DSN=&&IOCPOUT,DISP=(OLD,DELETE)
//SYSUT2   DD   SYSOUT=*
//SYSIN    DD   DUMMY
//SYSPRINT DD   DUMMY
//*
//CLEANUP  EXEC PGM=IEFBR14,COND=(0,NE,IOCDS)
//SYSUT    DD   DSN=&&IOCPOUT,DISP=(OLD,DELETE)
//

Example 2: 

The following example shows a Build IOCP input data set job.

//BWINJOB  JOB (3259,RZ-28),'BWIN',NOTIFY=BWIN,CLASS=A,
//             MSGCLASS=Q,MSGLEVEL=(1,1),REGION=5M
//*
//* BUILD IOCP DECK
//*
//IOCP     EXEC PGM=CBDMGHCP,
//            PARM='IOCDS,,PROC1,D,SA'
//HCDIODFS DD   DSN=BWIN.IODFA3,DISP=SHR
//HCDDECK  DD   DSN=BWIN.IOCP3.DECK,DISP=OLD
//HCDMLOG  DD   DSN=BWIN.HCD.LOG,DISP=OLD
//HCDCNTL  DD   *
IOCDSNAM
/*
//