Chapter 11. Writing a program to control autoinstall ofconsoles
Considerations common to all user-replaceable programs
Note that the comments contained in Chapter 5, “General notes about
user-replaceable programs,” on page 435 apply to this chapter.
This chapter describes how to write a program to control the automatic installation
of MVS console devices (including TSO consoles). For information about controlling
the automatic installation of locally-attached VTAM terminals, see Chapter10,
“Writing a program to control autoinstall of terminals,” on page 515.
The chapter is divided into the following sections:
1. “Autoinstalling consoles—preliminary considerations”
2. “The autoinstall control program at INSTALL” on page 536
3. “The autoinstall control program at DELETE” on page 540
4. “The sample autoinstall control programs for consoles” on page 541.

Autoinstalling consoles—preliminary considerations

The reasons for using autoinstall for MVS consoles are the same as those that
apply to the autoinstall for VTAM devices: you don't have to define each device
explicitly, and you save on storage (see “Autoinstalling terminals—preliminary
considerations” on page 515).

Leaving it all to CICS

For consoles, in addition to the normal autoinstall support, you can also choose to
let CICS autoinstall consoles without calling the autoinstall program. In this case,
CICS uses either:
vA model console definition with anAUTINSTNAME (model name) that matches
the MVS console name, or
vThe first suitable console model it finds in alphanumeric sequence
If the autoinstall control program is not called, CICS generates a 4-character termid
starting with the ¬(logical not) symbol.
If you want CICS to install your consoles automatically:
vSpecify AICONS=AUTO (or issue a CEMT(or EXEC CICS) SET AUTOINSTALL
CONSOLES(FULLAUTO) command).
vCreate at least one model TERMINAL definition that references a TYPETERM
definition specifying DEVICE(CONSOLE). Youcan use the IBM-supplied
definition in group DFHTERMC if it suits your needs.
vInstall the model TERMINAL and TYPETERM definition.

Using an autoinstall control program

If you choose to have your autoinstall control program invoked for consoles, follow
these steps:
vUse the default autoinstall control program for terminals (DFHZATDX or
DFHZATDY), or write your own program, using the source code of the default
program and the customization examples in this chapter as a basis.
© Copyright IBM Corp. 1977, 2011 535