IBM SC34-6814-04 - Manual (Page 577)

If the default user program is not adequate for your purposes, you can write a
customized version of the default program or create your own program to provide
enhanced function. CICS supplies the source code of the default program in several
programming languages; see “The sample autoinstall user program for IPIC
connections (IPCONN)” on page 557.
Recovery and restart
Autoinstalled IPCONNs are cataloged by CICS, for recovery at an emergency
restart only. They are not recovered at a warm restart.
The autoinstall user program at INSTALL
When the autoinstall user program is invoked for the installation of an IPCONN,
CICS passes it a parameter list in a communication area addressed by DFHEICAP.
The communication area at INSTALL for IPCONNs
The communications area is mapped by the DSECT for the assembler version of
DFHISAIP, which is supplied in CICSTS32.CICS.SDFHSAMP.
isaic_applid (Input/Output)
An 8-character field containing the applid of the remote system trying to
connect, as sent on the connect flow. The user program can change this value
only if it is blank on input (which indicates that the connecting system is
probably a Java client). If it is blank on output, CICS uses the “suggested
applid” pointed to by the isaic_suggested_applid field.
isaic_function (Input)
A 1-character code indicating the function for which the autoinstall user program
has been invoked. Contains X'F0' for install.
isaic_host (Input/Output)
A 116-character field containing the host name of the remote system, as passed
in the connect flow. The autoinstall user program is allowed to modify this
because it is possible that it has a better idea of what the connecting system is
known as locally than does the system itself.
isaic_ipconn (Output)
An 8-character field containing the name to be used for the autoinstalled
IPCONN connection. The user program must supply the name.
isaic_function char(1) Function code (X'F0' for Install)
isaic_response char(1) Response code
* char(2) Reserved
isaic_ipconn char(8) Name for the autoinstalled IPCONN
isaic_applid char(8) The applid of remote system
isaic_suggested_applid char(8) Suggested applid, if isaic_applid
is blank
isaic_networkid char(8) Network ID of remote system
isaic_tcpipservice char(8) Name of the TCPIPSERVICE on which
this connect flow arrived
isaic_template char(8) Name of the template IPCONN
isaic_host char(116) Host name of remote system
isaic_port bin(4) Call back port number of remote system
isaic_receivecount bin(4) Number of receive sessions wanted by
remote system
Figure 49. Autoinstall user program’s communications area at INSTALL. For IPCONNs.
Chapter 13. Writing a program to control autoinstall of IPIC connections 555