Sample autoinstall user program to support predefined connection templates

The supplied source of the user-replaceable program is a sample to illustrate a technique of customizing autoinstall of an IPCONN, such that the IPCONN name and APPLID are generated according to a template IPCONN that is previously installed.

The source of the additional IPCONN autoinstall user replaceable program is supplied in the SDFHSAMP library. The code is supplied in assembler as module DFH$ISAI and COBOL as module DFH0ISAI. The executable load modules are supplied in the CICSTS SDFHLOAD library.

The sample is for illustrative purposes and can be tailored to suit particular requirements. The program is appropriate for use when you are connecting multiple clients from the same system, for example using WebSphere® Application Server for z/OS® that is running in local mode with CICS® Transaction Gateway.

When the user-replaceable program is deployed, all IPIC installation requests are based on a template IPCONN that must match the name of the network ID of the partner (for CICS Transaction Gateway clients, this is the APPLID qualifier). Connection requests are accepted only if the APPLID of the partner matches the APPLID value that is specified in the template IPCONN.

INSTALL

The user-replaceable program provides the following function at INSTALL.

Connection requests are rejected in the following circumstances:
  • The network ID of the partner does not match the name of an installed IPCONN template.
  • The APPLID of the partner is a different length to the APPLID value supplied in the IPCONN template.
  • The APPLID of the partner does not match the APPLID characters that are supplied in the IPCONN template.
  • The IP address of the partner does not match the HOST value, if it is defined in the IPCONN template.
  • The maximum number of autoinstalled IPCONN names, which are composed of the partner APPLID followed by the count suffix, is exceeded.

If the connection request is accepted, the value of the autoinstalled IPCONN, and the APPLID it specifies, are dynamically generated using the partner APPLID followed by a unique integer suffix. The suffix is generated from the value of a count that the sample user replaceable module maintains for each template IPCONN. The current value of the count is recorded in a CICS temporary storage element. For example, if the APPLID supplied is seven characters long (for example CTGSYST), a one-character count is appended to provide the full eight character IPCONN name (CTGSYST1). In this way, a maximum of nine clients are allowed to connect from the same partner.

DELETE

The user-replaceable program provides the following function at DELETE.

When invoked to delete an IPCONN definition, the supplied version of the user program takes no action and returns immediately.



dfha3ipk.html | Timestamp icon Last updated: Sunday, 4 June 2017