CEMT INQUIRE AUTOINSTALL

Retrieve information and parameters that control the automatic installation (autoinstall) of z/OS® Communications Server terminals, APPC connections, virtual terminals (bridge facilities) used by the 3270 bridge mechanism, and MVS™ consoles.

In the CICS Explorer, the Regions operations view provides a functional equivalent to this command.

Description

The INQUIRE AUTOINSTALL command displays information about autoinstall values. For information about autoinstall, see Autoinstall.

Input

Press the Clear key and type CEMT INQUIRE AUTOINSTALL (or suitable abbreviations for the keywords).

The resulting display is similar to the following example. To change any of the values shown, tab to the highlighted fields and overtype them as required.

Sample screen

Figure 1. CEMT INQUIRE AUTOINSTALL screen
  INQ AUTOINSTALL
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Auto Max( 100 ) Pro( DFHZATDX ) Cur(000) Pro Ena

If you place the cursor against the result and press ENTER, CICS® displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display of an individual entry
 IN AUTOIN
 RESULT - OVERTYPE TO MODIFY
   Autoinstall
   Maxreqs( 100 )
   Program( DFHZATDX )
   Curreqs( 000 )
   Consoles( Fullauto )
   Enablestatus( Enabled )
   Aibridge( Autotermid )

CEMT INQUIRE AUTOINSTALL

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE AUTOINSTALL

Displayed fields

AIBRIDGE
Indicates whether the autoinstall user replaceable module (URM) is called for bridge facilities. The values are as follows:
AUTOTERMID
Bridge facilities are defined automatically by CICS. The autoinstall URM is not called.
URMTERMID
The autoinstall URM is called.
AUTOINSTALL
Identifies that this panel relates to terminal autoinstall.
CONSOLES(value)
Displays the status of autoinstall for MVS consoles in the CICS region. The values are as follows:
FULLAUTO
Autoinstall for consoles is active without any support from the autoinstall control program. CICS generates the required terminal ID automatically without calling the control program, and sets the default delete-delay period (60 minutes) for the console entry.
PROGAUTO
Autoinstall for consoles is active, with the support of the autoinstall control program (specified on the AIEXIT system initialization parameter). The autoinstall control program is required to provide the terminal ID and, optionally, a delete-delay period.
NOAUTO
Autoinstall for consoles is not active.

You can change this attribute by overtyping it with a different value.

CURREQS(value)
Displays the number of autoinstall requests that are currently being processed. This is not the number of terminals that are currently installed using autoinstall.
ENABLESATUS(value)
Displays the overall status of the terminal autoinstall facility, indicating whether CICS is enabled to install z/OS Communications Server terminals and MVS consoles. The values displayed are as follows:
ENABLED
CICS can currently install consoles, terminals, or both. To determine which of these the facility is enabled for, check the values returned on the MAXREQS and CONSOLES options. Enabled is returned for the following conditions:
TERMINALS
MAXREQS not equal 0 and autoinstall control program is enabled.
CONSOLES
  1. CONSOLES displays FULLAUTO.
  2. CONSOLES displays PROGAUTO and the autoinstall control program is enabled.
DISABLED
Neither consoles nor terminals can be autoinstalled in CICS. DISABLED is returned for the following conditions:
TERMINALS
MAXREQS equal 0, or autoinstall control program is disabled.
CONSOLES
  1. CONSOLES displays NOAUTO.
  2. CONSOLES displays PROGAUTO but the autoinstall control program is disabled.
MAXIMUM(value)
Displays the largest number of autoinstall requests that are allowed to queue at any one time. This is not the largest number of terminals that can be installed using autoinstall.
Note: You can reset this value by overtyping it with a different value.
PROGRAM(value)
Displays the name of the program that controls the autoinstall process. This is either the CICS-supplied default autoinstall program, DFHZATDX, or a user-written program.

You can reset this value by overtyping it with a different value.