Resource definitions – IBM SC33-1683-02 User Manual

Page 553

Advertising
background image

The actions taken by the supplied version of the program are to:

1. Examine the request type passed in the INSTALL_APPC_EXIT_FUNCTION

field:

X'F0'

An incoming CINIT for a terminal or APPC single-session device.
Proceed as for DFHZATDX. See “Chapter 10. Writing a program to
control autoinstall of terminals” on page 485.

X'F1'

A delete request for a terminal or APPC single-session device. Proceed
as for DFHZATDX. See “Chapter 10. Writing a program to control
autoinstall of terminals” on page 485.

INSTALL_APPC_PS_CINIT (X'F2')

An incoming CINIT for an APPC parallel-session connection. Specify a
template by setting the field pointed to by
INSTALL_APPC_TEMPLATE_SYSID to 'CCPS'.

Note: This type of request cannot be received by CICS Transaction

Server for OS/390 Release 3.

INSTALL_APPC_PS_BIND (X'F3')

An incoming BIND for an APPC parallel-session connection. Specify a
template. This is done in one of two ways:

v

For connections between two generic resources, by accepting the
suggested template (the generic resource name connection) whose
NETNAME is passed in TEMPLATE_NETNAME. If there is no
generic resource name connection, set TEMPLATE_SYSID to
'CBPS'.

v

In all other cases, by setting TEMPLATE_SYSID to 'CBPS'.

INSTALL_APPC_SS_BIND (X'F4')

An incoming BIND for an APPC single-session connection. Specify a
template by setting the field pointed to by
INSTALL_APPC_TEMPLATE_SYSID to 'CBSS'.

X'F5'

A delete request for an APPC parallel-session connection installed by a
BIND. Establish addressability to the COMMAREA and return.

X'F6'

A delete request for an APPC single-session connection installed by a
BIND. Establish addressability to the COMMAREA and return.

2. Specify a name for the new connection by copying the last 4 non-blank

characters of the input NETNAME pointed to by
INSTALL_APPPC_NETNAME_PTR to the field pointed to by
INSTALL_APPC_SYSID_PTR.

3. Indicate that a selection has been made by setting the return code to

RETURN_OK.

Resource definitions

CICS supplies a resource definition group called DFHAI62, which defines
DFHZATDY, and contains CONNECTION definitions for CCPS, CBPS, and CBSS. If
you want to use the supplied version of DFHZATDY, you should append DFHAI62
to your CICS startup grouplist. However, if you customize DFHZATDY you will
probably need to create your own definitions.

sample autoinstall programs

Chapter 12. Writing a program to control autoinstall of APPC connections

521

Advertising