How to build an IOCP data set

  1. On the Primary Task Selection panel, specify the name of a production IODF and select Activate or process configuration data.
  2. On the resulting panel select Build IOCP input data set. HCD displays the Available Processors screen.
  3. On the Available Processors screen, select the processor for which you want to build the IOCP input data set. HCD displays the Build IOCP Input Data Set dialog.
    Figure 1. Build IOCP Input Data Set
    ┌──────────────────────── Build IOCP Input Data Set ────────────────────────┐
│                                                                           │
│ Specify or revise the following values.                                   │
│                                                                           │
│ IODF name . . . . . . . . . : 'BOKA.IODF08'                               │
│ Processor ID  . . . . . . . : CF01                                        │
│ Title1 : ________________________________________________________________ │
│ Title2 : BOKA.IODF08 - 2009-07-02 15:42                                   │
│                                                                           │
│ IOCP input data set                                                       │
│ ________________________________________________________                  │
│ Input to Stand-alone IOCP?  Yes  (Yes or No)                              │
│                                                                           │
│ Job statement information                                                 │
│ //WIOCP   JOB (5765),'BOKA',NOTIFY=BOKA,CLASS=A,MSGCLASS=X,REGION=5M      │
│ //JOBLIB     DD   DSN=HCDTEST.IZPIOCP.FALC,DISP=SHR                       │
│ //GO.HCDPROF DD   DSN=HCDTEST.PROFILE(MIGENH51),DISP=SHR                  │
│ //*                                                                       │
└───────────────────────────────────────────────────────────────────────────┘
  4. On this panel you can:
    • Enter the identification information you want to be written on the first header line of the IOCP input data set in the Title1 field.
    • Specify the name of the IOCP input data set. The IOCP input data set will automatically be allocated (record length 80, record format fixed block). If the data set already exists, you will be asked to confirm replacing it with the new one.
    • Specify whether to build the IOCP data set for stand-alone IOCP.
      Yes
      This is the default. The generated IOCP statements can be used as input to the stand-alone IOCP program or to the CHPID Mapping Tool.
      Note: You may not be able to use such a generated IOCP input data set for the migration function of HCD because, for example, the unit name of control units and device types can be truncated due to IOCP restrictions.
      No
      The IOCP input data set is built using the IOCP changes described in IOCP enhancements and generating the extended migration parameters and statement (if the profile statement MIGRATE_EXTENDED is set to YES) as described in IOCP input data sets using extended migration. Note that if you try to process these IOCP statements with the stand-alone IOCP program, you may run into problems, because the program may not accept the generated syntax.
    • Change the job statement information to meet the installation needs. With JCL overwrite statements you can modify the EXEC procedure that is invoked. You can, for example, specify the HCD profile using the job step name GO. (See Job statement information used in panels for a description of the job control information that you need to specify when you build an IOCP input data set.) Ensure that the batch job runs in a region with at least 4 MBytes.

TOK=value

Configuration programs use this keyword to forward information to the CPC which is required to enable the dynamic I/O configuration capability of any resulting IOCDS. This keyword is not intended for direct user input. The contents needs not relate to the target processor. It just must match the token in the IOCDS/HSA and the currently active IODF.

You can also invoke this task in batch mode. See Build an IOCDS or an IOCP input data set.

Note:

You should never change an IOCP input file generated by HCD and use it to write an IOCDS. If changes are necessary, use HCD to regenerate the IOCP input.

Parent topic: Build an IOCP input data set