Default actions of the sample program, Resource definitions – IBM SC34-6814-04 User Manual

Page 580

Advertising
background image

Default actions of the sample program

The role of the autoinstall user program in installing IPCONNs is to choose the
IPCONN template to be used and to supply the name of the new connection.
Optionally, the program can modify the values of the APPLID, HOST, and PORT
attributes of the new connection from those supplied on the connect flow. All other
attributes of the new IPCONN are taken from the template or the CICS-supplied
default values and cannot be modified by the user program.

At INSTALL

When invoked to install an IPCONN definition, the actions taken by the supplied
version of the user program are to:

1. Specify a name for the new connection by setting the isaic_ipconn field equal

to the last 4 non-blank characters of the connecting system’s applid in the
isaic_applid

field.

If the isaic_applid field is blank, set its value, and the connection name, to the
“suggested applid” in the isaic_suggested_applid field.

2. Leave all other connection attributes to assume their default values, and return.

At DELETE

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

Resource definitions

CICS supplies a resource definition group called DFHISCIP that defines the
supplied, default, autoinstall program, DFHISAIP.This is included in the default CICS
startup grouplist, DFHLIST. If you use a different CICS startup grouplist, ensure that
you append the DFHISCIP group to it.

If you customize DFHISAIP, you may need to create your own resource definitions.
When you do, ensure that you append your resource definition group to your CICS
startup grouplist.

558

Customization Guide

Advertising