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 LUs.
    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 LUs.
    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 5 Release 5 .
    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.