The Autoinstall Control Program At Delete - IBM SC34-6814-04 Customization Manual

The autoinstall control program at DELETE

The autoinstall control program is reinvoked when an autoinstalled resource is
deleted. (The resources that can be autoinstalled are listed under "The autoinstall
control program at INSTALL" on page 561.) Invoking the user program at DELETE
enables you to reverse the processes carried out at INSTALL.
The parameter list passed to your user program at DELETE of local terminals is
described on page "The autoinstall control program at DELETE" on page 525. The
parameter list passed at DELETE of local APPC connections is described on page
"The autoinstall control program at DELETE" on page 549. The parameter list
passed at DELETE of Client virtual terminals is described on page "The autoinstall
control program at DELETE" on page 575. This section describes only DELETE of
shipped terminals and connections.
Shipped terminal and connection definitions are deleted by the CICS Transaction
Server for z/OS, Version 3 Release 2 timeout delete mechanism. For details of the
timeout delete mechanism, see Efficient deletion of shipped terminal definitions, in
the CICS Intercommunication Guide.
Figure 52 shows the communications area passed to the autoinstall user program at
DELETE.
DELETE_SHIPPED_COMMAREA
DELETE_SHIPPED_STANDARD
DELETE_SHIPPED_EXIT_FUNCTION
DELETE_SHIPPED_TERM
DELETE_SHIPPED_RSE
DELETE_SHIPPED_EXIT_COMPONENT
DELETE_SHIPPED_TERMID
DELETE_SHIPPED_APPLID
DELETE_SHIPPED_LTERMID
DELETE_SHIPPED_NETNAME
Figure 52. Autoinstall control program's communications area at DELETE. For shipped terminals and connections.
At DELETE, all fields in the communications area are input only. Fields not listed
below are as described for INSTALL.
DELETE_SHIPPED_EXIT_FUNCTION
564
Customization Guide
installed, and stored within the definition. Thus, if the definition is shipped to
another region, the value of the token is shipped too. The correlation ID is used
by CICS during attach processing, to check whether existing shipped definitions
in an AOR are up-to-date, or whether they need to be deleted and reshipped
because the terminal has been re-installed in the TOR. For further information
about instance tokens, see Efficient deletion of shipped terminal definitions, in
the CICS Intercommunication Guide.
If your control program maps TOR-allocated TERMIDs to the aliases that it
assigns in the AOR, by recording correlation IDs it could check whether a
terminal has been re-installed in the TOR. If the terminal has been re-installed,
it is possible that the TOR-allocated TERMID relates to a different physical
device from that last installed under this TERMID.
DSECT , Delete parameter list
DS F Standard field
DS XL1 Delete type
EQU X'FA' Delete terminal
EQU X'FB' Delete remote system entry
DS CL2 Component ID 'ZC'
DS CL1 Reserved
DS CL4 TERMID in TOR
DS CL8 Applid of TOR
DS CL4 TERMID in AOR
DS CL8 Netname of terminal
A 1-byte field that indicates the type of resource being deleted. The equated
values are: