The Autoinstall User Program At Install - IBM SC34-6814-04 Customization Manual

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_function
isaic_response
*
isaic_ipconn
isaic_applid
isaic_suggested_applid
isaic_networkid
isaic_tcpipservice
isaic_template
isaic_host
isaic_port
isaic_receivecount
Figure 49. Autoinstall user program's communications area at INSTALL. For IPCONNs.
isaic_applid (Input/Output)
isaic_function (Input)
isaic_host (Input/Output)
isaic_ipconn (Output)
char(1)
char(1)
char(2)
char(8)
char(8)
char(8)
char(8)
char(8)
char(8)
char(116)
bin(4)
bin(4)
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.
A 1-character code indicating the function for which the autoinstall user program
has been invoked. Contains X'F0' for install.
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.
An 8-character field containing the name to be used for the autoinstalled
IPCONN connection. The user program must supply the name.
Chapter 13. Writing a program to control autoinstall of IPIC connections
Function code (X'F0' for Install)
Response code
Reserved
Name for the autoinstalled IPCONN
The applid of remote system
Suggested applid, if isaic_applid
is blank
Network ID of remote system
Name of the TCPIPSERVICE on which
this connect flow arrived
Name of the template IPCONN
Host name of remote system
Call back port number of remote system
Number of receive sessions wanted by
remote system
555