INQUIRE AUTOINSTALL
Retrieve autoinstall values.
Syntax
Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).
Conditions: NOTAUTH
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations. For more information
about the use of CVDAs, see CICS-value data areas (CVDAs).
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 z/OS consoles in your CICS® system.
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 installation and delete functions.
- FULLAUTO
- Consoles can be autoinstalled if ENABLESTATUS returns a CVDA of ENABLED. The autoinstall control program is not called for the installation 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
-
- CONSOLES CVDA returns NOAUTO.
- 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
-
- CONSOLES CVDA returns FULLAUTO.
- 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.