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.
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:
- 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.
- 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.
- Indicate that a selection has been made by setting the return code to
RETURN_OK.
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)
[[ Contents Previous Page | Next Page Index ]]