The sample autoinstall control program for APPC connections

The sample control program for autoinstall of APPC connections is DFHZATDY. The source code, in assembler-language only, is in library CICSTS31.CICS.SDFHSAMP.

As well as providing function to autoinstall APPC connections initiated by BIND requests, DFHZATDY provides the same function for terminal autoinstall as the DFHZATDX program described in Writing a program to control autoinstall of terminals. Thus, you can use a customized version of DFHZATDY to autoinstall both terminals and APPC connections.

Default actions of the sample program

The role of DFHZATDY in installing APPC connections is to choose the template to be used (by supplying its NETNAME or SYSID), and to supply the name (SYSID) of the new connection.

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 Writing a program to control autoinstall of terminals.
    X'F1'
    A delete request for a terminal or APPC single-session device. Proceed as for DFHZATDX. See Writing a program to control autoinstall of terminals.
    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 z/OS®, Version 3 Release 1.
    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:
    • 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'.
    • 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.

DFHZATDY is defined as follows in DFHAI62:

DEFINE PROGRAM(DFHZATDY)
DESCRIPTION(Assembler definition for sessions autoinstall control program)
GROUP(DFHAI62)
LANGUAGE(ASSEMBLER) RELOAD(NO)          RESIDENT(NO)
USAGE(NORMAL)       STATUS(ENABLED)     CEDF(NO)
DATALOCATION(ANY)   EXECKEY(CICS)       EXECUTIONSET(FULLAPI)

Related concepts
Autoinstalling APPC connections--preliminary considerations
Related tasks
Rewriting user-replaceable programs
Assembling and link-editing user-replaceable programs
Related reference
The autoinstall control program at INSTALL
The autoinstall control program at DELETE
[[ Contents Previous Page | Next Page Index ]]