Configuring autoinstall for programs

To automatically install programs, mapsets, and partitionsets, you must configure CICS® to use an autoinstallation program and install the required resources.

About this task

CICS supplies an autoinstallation program called DFHPGADX, but you can write your own customized version if required.

Procedure

  1. Write a customized version of the autoinstall control program for programs, DFHPGADX, unless the supplied version is entirely suitable for your purposes.
  2. Specify the name of your control program on the PGAIEXIT system initialization parameter, or on a SET SYSTEM PROGAUTOEXIT command.
    The default name is DFHPGADX. For more information on this parameter, see PGAIEXIT system initialization parameter.
  3. Make program autoinstall active by specifying ACTIVE on the PGAIPGM system initialization parameter, or by issuing a SET SYSTEM PROGAUTOINST(AUTOACTIVE) command.
    For more information on this parameter, see PGAIPGM system initialization parameter.
  4. Specify whether you want autoinstalled program definitions to be recorded on the CICS global catalog.
    You can use the PGAICTLG system initialization parameter or a SET SYSTEM PROGAUTOCTLG command. For more information on this parameter, see PGAICTLG system initialization parameter.
  5. Include the DFHPGAIP resource definition group in your CICS startup group list.
    DFHPGAIP is already included in the supplied startup list, DFHLIST. It contains the default program, mapset, and partitionset model definitions passed to the autoinstall control program, and a definition of DFHPGADX. You might have to amend the definition for DFHPGADX.
  6. Create any additional program, mapset, and partitionset model definitions that you need, and add this group to your startup group list.
  7. If you want to log messages associated with program autoinstall, define the CSPL transient data (TD) queue.

Results

You have successfully configured autoinstallation for programs, mapsets, and partitionsets.