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 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. The parameter list passed at INSTALL of Client virtual terminals is described in The communications area at INSTALL for Client virtual terminals. This section describes only INSTALL of local APPC connections initiated by BIND requests.
The communications area is mapped by the DSECT for the assembler version of DFHZATDY, which is supplied in CICSTS31.CICS.SDFHMAC.
*---------------------------------------------------------------------*
* APPC Install parameter list - Functions 2, 3, and 4 *
*---------------------------------------------------------------------*
INSTALL_APPC_COMMAREA DSECT Install Parameter List
*
INSTALL_APPC_STANDARD DS F Standard field
ORG INSTALL_APPC_STANDARD
INSTALL_APPC_EXIT_FUNCTION DS XL1 Install request type
INSTALL_APPC_PS_CINIT EQU X'F2' Install PS via CINIT
INSTALL_APPC_PS_BIND EQU X'F3' Install PS via BIND
INSTALL_APPC_SS_BIND EQU X'F4' Install SS via BIND
INSTALL_APPC_EXIT_COMPONENT DS CL2 Component ID 'ZC'
DS XL1 Reserved
*
ORG ,
INSTALL_APPC_NETNAME_PTR DS A -> NETNAME Input
INSTALL_APPC_CINIT_PTR DS 0A -> CINIT_RU Input
INSTALL_APPC_BIND_PTR DS A -> BIND Input
INSTALL_APPC_SELECTED_PTR DS A -> Return fields Output
INSTALL_APPC_SYNCLEVEL_PTR DS A -> Sync level Input
*
INSTALL_APPC_TEMPLATE_NETNAME_PTR DS A -> Template NETNAME I/O
INSTALL_APPC_TEMPLATE_SYSID_PTR DS A -> Template SYSID Output
INSTALL_APPC_SYSID_PTR DS A -> New SYSID Output
INSTALL_APPC_NETNAME2_PTR DS A -> Generic or Input
* member NETNAME
INSTALL_APPC_NETID_PTR DS A -> Network ID of Input
* incoming bind
INSTALL_APPC_TYPE_PTR DS A -> Generic Input
resource type
*
TEMPLATE_NETNAME DS CL8 Put netname of template here
TEMPLATE_SYSID DS CL4 Put sysid of template here
SYSID DS CL4 Put name of new connection here
SYNCLEVEL DS XL2 Synclevel of new connection
APPC_NETID DS CL8 NETID of incoming bind
APPC_GR_TYPE DS CL1 G = NETNAME is generic resource name
M = NETNAME is member name
blank = This CICS is not a generic
resource or the partner is not a
generic resource.
APPC_NETNAME2_FIELD DSECT
APPC_NETNAME2_LENGTH DS XL2 Length of NETNAME
APPC_NETNAME2 DS 0X Generic or member NETNAME
For connections to CICS TORs where the partner is a generic resource, NETNAME can be the partner’s generic resource name, or its member name, depending on the setting of APPC_GR_TYPE. (For introductory information about generic resources, see the CICS Intercommunication Guide.)
Note that for APPC autoinstall (functions X'F3' and X'F4') only the return code is used. You return other information for APPC in other fields defined in the communications area.
Your control program can use the TEMPLATE_NETNAME field to specify the NETNAME of the template. For connections between generic resources, your program can accept the suggested template passed by CICS, or specify a different one--either in this field or by overwriting the suggested template with blanks and putting a value in the TEMPLATE_SYSID field.
If the specified name is less than 8 bytes, it must be padded with trailing blanks. If, as an alternative to specifying the NETNAME of the template, your program specifies its CONNECTION name in TEMPLATE_SYSID, it should fill TEMPLATE_NETNAME with blanks.
If you are using recoverable resources, the SYSID chosen for a connection after a restart must be the same as that chosen in the previous CICS run.
If both the partner and the local CICS are generic resources, APPC_NETNAME2 is the partner’s generic resource name or member name, depending on the setting of APPC_GR_TYPE.
If the partner is not a generic resource, APPC_NETNAME2 contains the same value as NETNAME.
If the local CICS is not a generic resource, the value of APPC_NETNAME2 is meaningless.