Implementing autoinstall for MVS consoles

To implement autoinstall for MVS consoles, define appropriate resource definitions and configure system initialization parameters.

About this task

To autoinstall MVS consoles, you must ensure that the required model resource definitions are installed. The autoinstall models supplied in DFHLIST do not contain models suitable for console autoinstallation. The supplied group DFHTERMC contains an autoinstall model definition for a console, but it is not included in DFHLIST.

You can optionally write an autoinstall control program if you want to have additional control over the autoinstall process; for example, you might want to restrict the consoles that can be autoinstalled in a production environment. The autoinstall program must be able to handle console installation and delete requests. For information about writing an autoinstall program for consoles, see Writing a program to control autoinstall of consoles.

Procedure

  1. Define a console terminal definition with the following attributes:
    • Specify AUTINSTMODEL(YES), or AUTINSTMODEL(ONLY)
    • Specify the CONSNAME(name)
    • Reference a TYPETERM that specifies DEVICE(CONSOLE)
    You can use the model console definition defined in the group DFHTERMC, which is added to your CSD by the INITIALIZE and UPGRADE commands.
    Note: When a model terminal definition is used by the console autoinstall function, CICS® ignores the console name specified on the model definition.
  2. Install the model console definition. You can either add its group to a group list and perform a cold start or install the resource by using CICS Explorer®.
  3. If you provide your own program to control the autoinstall of MVS consoles, set the AICONS system initialization parameter to YES.
    You can define this value in the SIT or override it dynamically using the SET AUTOINSTALL CONSOLES(PROGAUTO) command.
  4. To use the autoinstall control program that is supplied with CICS, set the AICONS system initialization parameter to AUTO.
    You can define this value in the SIT or override it dynamically using the SET AUTOINSTALL CONSOLES(FULLAUTO) command. With the AUTO option, CICS allocates the TERMID automatically.
  5. Ensure that the required autoinstall programs and transactions are installed. These resources are your autoinstall control program, the transactions CATA and CATD, and the programs DFHZATD and DFHZATA.
    You must have the following resources installed:
    • PROGRAM resource for your autoinstall control program
    • TRANSACTION resources for CATA and CATD
    • PROGRAM resources for DFHZATD and DFHZATA.
    The supplied autoinstall control program, DFHZATDX or DFHZATDY, accepts a request from any console, provided an autoinstall model for a console is found in the AMT. Use the model definition supplied in group DFHTERMC, or alternatively create your own autoinstall console models (see The autoinstall control program for MVS consoles)