INQUIRE AUTOINSTALL

Retrieve autoinstall values.

INQUIRE AUTOINSTALL

Read syntax diagramSkip visual syntax diagramINQUIRE AUTOINSTALLAIBRIDGE( cvda)CONSOLES( cvda)CURREQS( data-area)ENABLESTATUS( cvda)MAXREQS( data-area)PROGRAM( data-area)

Conditions: NOTAUTH

Description

The INQUIRE AUTOINSTALL returns information relating to 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 your CICS® system.

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Options

AIBRIDGE(cvda)
returns a CVDA value indicating whether the autoinstall user replaceable program (URM) is called for bridge facilities. The CVDA values are:
AUTOTERMID
Bridge facilities are defined automatically by CICS. The autoinstall user replaceable program is not called.
URMTERMID
The autoinstall user replaceable program is called.
CONSOLES(cvda)
returns a CVDA value indicating the status of console autoinstall in CICS. The CVDA values are:
PROGAUTO
Consoles can be autoinstalled if ENABLESTATUS returns a CVDA of ENABLED. The autoinstall control program is called for the install and delete functions.
FULLAUTO
Consoles can be autoinstalled if ENABLESTATUS returns a CVDA of ENABLED. The autoinstall control program is not called for the install and delete functions, and CICS generates the terminal identifier automatically for the consoles it autoinstalls.
NOAUTO
Consoles cannot be autoinstalled.
CURREQS(data-area)
returns a fullword binary field indicating the number of terminal autoinstall requests that are currently being processed. This count does not include terminals already installed in this manner.
ENABLESTATUS(cvda)
returns a CVDA value indicating the overall status of the CICS autoinstall facility. CVDA values are:
DISABLED
Neither consoles nor terminals can be autoinstalled in CICS. DISABLED is returned for the following conditions:
Terminals
MAXREQS equal 0, or the autoinstall control program is disabled.
Consoles
  1. CONSOLES CVDA returns NOAUTO.
  2. CONSOLES CVDA returns PROGAUTO but autoinstall control program is disabled.
ENABLED
Either consoles or terminals or both can be autoinstalled in CICS. If you want to check whether ENABLED applies to consoles, terminals, or both, check the values returned on other options. ENABLED is returned for the following conditions:
Terminals
MAXREQS not equal 0 and autoinstall control program is enabled.
Consoles
  1. CONSOLES CVDA returns FULLAUTO.
  2. CONSOLES CVDA returns PROGAUTO and autoinstall control program is enabled.
MAXREQS(data-area)
returns a fullword binary field indicating the largest number of autoinstall requests that can be processed concurrently. Note that this value has no effect on the total number of terminals that can be installed automatically. (The MAXREQS option corresponds to the AIQMAX system initialization parameter.)
PROGRAM(data-area)
returns the 8-character name of the installation-supplied program used in the autoinstall process. This is either the CICS-supplied default autoinstall program, DFHZATDX, or a user-written program.

Conditions

NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.