The autoinstall control program is invoked at INSTALL for:
On each invocation, CICS® passes a parameter list to the control program by means of a communication area addressed by DFHEICAP. The parameter list passed at INSTALL of local terminals and APPC single-session connections initiated by CINIT is described in The communication area at INSTALL for terminals. The parameter list passed at INSTALL of local APPC connections initiated by BIND requests is described in The communication area at INSTALL for APPC connections. The parameter list passed at INSTALL of MVS consoles is described in The autoinstall control program at INSTALL. The parameter list passed at INSTALL of shipped terminals and connections is described in The communications area at INSTALL for shipped terminals. This section describes only parameters passed at INSTALL of Client virtual terminals, in The communications area at INSTALL for Client virtual terminals, and of bridge facilities in The communications area at INSTALL for bridge facility virtual terminals.
The communications area is mapped by the DSECT for the assembler version of DFHZATDX or DFHZATDY, which are supplied in CICSTS31.CICS.SDFHMAC.
*--------------------------------------------------------------------------*
* Remote install parameter list - Client virtual terminal function 9 *
*--------------------------------------------------------------------------*
INSTALL_SHIPPED_COMMAREA DSECT Install Parameter List
*
INSTALL_SHIPPED_STANDARD DS F Standard field
ORG INSTALL_SHIPPED_STANDARD
INSTALL_SHIPPED_EXIT_FUNCTION DS XL1 Install type
INSTALL_SHIPPED_TERM EQU X'F9' Install virtual terminal
INSTALL_SHIPPED_EXIT_COMPONENT DS CL2 Component ID 'ZC'
INSTALL_SHIPPED_CLASH DS CL1 Install clash Y/N
ORG ,
INSTALL_SHIPPED_NETNAME_PTR DS A Pointer to netname of Client
INSTALL_SHIPPED_SELECTED_PTR DS A Pointer to return fields
INSTALL_SHIPPED_TERMID_PTR DS A Pointer to incoming TERMID
INSTALL_SHIPPED_APPLID_PTR DS A Pointer to applid of Client
INSTALL_SHIPPED_SYSID_PTR DS A Pointer to sysid of Client
INSTALL_SHIPPED_CORRID_PTR DS A Pointer to correlation ID
INSTALL_SHIPPED_SELECTED_PARMS DSECT ,
DS CL8 Reserved
SELECTED_SHIPPED_TERMID DS CL4 Selected TERMID
DS CL4 Reserved
DS CL4 Reserved
SELECTED_SHIPPED_RETURN_CODE DS CL1 Selected return code
RETURN_OK EQU X'00' Accept request
REJECT EQU X'01' Reject request
*
On invocation, if INSTALL_SHIPPED_CLASH is set to 'N' (indicating no conflict of terminal names), SELECTED_SHIPPED_TERMID contains the same value as the field pointed to by INSTALL_SHIPPED_TERMID_PTR (the supplied name). If INSTALL_SHIPPED_CLASH is set to 'Y', SELECTED_SHIPPED_TERMID contains a CICS-generated alias.
Your user program can override the suggested name.
The communications area is mapped by the DSECT for the assembler version of DFHZATDX or DFHZATDY, which are supplied in CICSTS31.CICS.SDFHMAC.
-----------------------------------------------------------------------
* Install Bridge Facility - Function 15 & 17
*---------------------------------------------------------------------*
INSTALL_BRFAC_COMMAREA DSECT Install Parameter List
INSTALL_BRFAC_STANDARD DS F Standard field
ORG INSTALL_BRFAC_STANDARD
INSTALL_BRFAC_EXIT_FUNCTION DS XL1 Install type
INSTALL_LINK_BRFAC EQU X'0F' Install Link Brfacility
INSTALL_START_BRFAC EQU X'11' Install Start Brfacility
INSTALL_BRFAC_EXIT_COMPONENT DS CL2 Component ID 'BR'
DS CL1 Reserved
ORG ,
INSTALL_BRFAC_NETNAME_PTR DS A Pointer to input netname
INSTALL_BRFAC_SELECTED_PTR DS A Pointer to return fields
INSTALL_BRFAC_TERMID_PTR DS A Pointer to input termid
DS A Reserved
DS A Reserved
DS A Reserved
INSTALL_BRFAC_SELECTED_PARMS DSECT ,
DS CL8 Reserved
SELECTED_BRFAC_TERMID DS CL4 Selected termid
SELECTED_BRFAC_RETURN_CODE DS B Selected return
SELECTED_BRFAC_NETNAME DS CL8 Selected netname
*
*-----------------------------------------------------------------------*