IBM SC33-1683-02 - Manual (Page 560)

INSTALL_SHIPPED_CORRID_PTR
A fullword pointer to an 8-character input field containing the shipped definition’s
correlation identifier. A correlation identifier is a unique “instance token” that is
created when a CICS/ESA 4.1 or later terminal or connection definition is
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 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.
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 525.) 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 495. The parameter list passed at DELETE of local APPC
connections is described on page 519. The parameter list passed at DELETE of
Client virtual terminals is described on page 536. This section describes only
DELETE of shipped terminals and connections.
Shipped terminal and connection definitions are deleted by the CICS Transaction
Server for OS/390 Release 3 timeout delete mechanism. For details of the timeout
delete mechanism, see the
CICS Intercommunication Guide.
Figure 40 shows the communications area passed to the autoinstall user program at
DELETE.
At DELETE, all fields in the communications area are input only. Fields not listed
below are as described for INSTALL.
DELETE_SHIPPED_COMMAREA DSECT , Delete parameter list
DELETE_SHIPPED_STANDARD DS F Standard field
DELETE_SHIPPED_EXIT_FUNCTION DS XL1 Delete type
DELETE_SHIPPED_TERM EQU X'FA' Delete terminal
DELETE_SHIPPED_RSE EQU X'FB' Delete remote system entry
DELETE_SHIPPED_EXIT_COMPONENT DS CL2 Component ID 'ZC'
DS CL1 Reserved
DELETE_SHIPPED_TERMID DS CL4 TERMID in TOR
DELETE_SHIPPED_APPLID DS CL8 Applid of TOR
DELETE_SHIPPED_LTERMID DS CL4 TERMID in AOR
DELETE_SHIPPED_NETNAME DS CL8 Netname of terminal
Figure 40. Autoinstall control program’s communications area at DELETE. For shipped
terminals and connections.
the autoinstall control program for shipped terminals
528 CICS TS for OS/390: CICS Customization Guide