SET AUTOINSTALL

Description

The SET AUTOINSTALL command lets you change some of the values that control the automatic installation (autoinstall) of z/OS® Communications Server terminals, APPC sessions, virtual terminals (bridge facilities) used by the 3270 bridge mechanism, and MVS™ consoles in a CICS® region.

Options

AIBRIDGE(cvda)

Specifies whether the autoinstall user replaceable program (URM) is to be called for bridge facilities. The CVDA values are:

AUTOTERMID

Bridge facilities are to be defined automatically by CICS. The autoinstall user replaceable program is not to be called.

URMTERMID

The autoinstall user replaceable program is to be called.

CONSOLES(cvda)

specifies whether CICS is to autoinstall an MVS console when it receives an MVS MODIFY command from a console that is not defined. The CVDA values are:

PROGAUTO

MVS consoles are to be autoinstalled, and CICS is to call the user autoinstall control program to obtain the termid and other user-specified information.

FULLAUTO

MVS consoles are to be autoinstalled by CICS automatically, without calling the user autoinstall control program. CICS assigns the termid for the console automatically, using the ¬ (logical not) symbol as the first character.

NOAUTO

Autoinstall for consoles is not allowed.

MAXREQS(data-value)

specifies the largest number of autoinstall requests that can be processed concurrently, as a fullword binary value. The value must be in the range 0-999.

Note: MAXREQS does not limit the total number of terminals that can be installed automatically, only the arrival rate. However, you can prevent automatic installation of any additional terminals by setting MAXREQS to 0. Terminals already autoinstalled are not affected, but if they log off, they cannot log on again while MAXREQS is 0.

PROGRAM(data-value)

specifies the 8-character name of the program to be used in the autoinstall process for terminals. You can specify either an installation-specific program or the CICS-supplied default, DFHZATDX.

Note: This program and any programs it invokes must be installed before they can be used in the program autoinstall process. You can do this either with explicit PROGRAM definitions or by autoinstall when some other autoinstall program is in force. Otherwise, the program autoinstall process fails when it is next used, and CICS makes it inactive.

Conditions

INVREQ

RESP2 values:

1

z/OS Communications Server is not in use in this system.

2

The MAXREQS value is not in the range 0-999.

4

One of the modules invoked by DFHZATDX (DFHZATA and DFHZATD) cannot be found.

20

CONSOLES has an invalid CVDA value.

41

AIBRIDGE has an invalid CVDA value.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

PGMIDERR

RESP2 values:

3

The program name cannot be found.