The Autoinstall Control Program At Delete; The Communications Area At Delete For Client Virtual Terminals - IBM SC34-6814-04 Customization Manual

INSTALL_BRFAC_TERMID_PTR

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 571.) 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 shipped definitions is described on page "The autoinstall
control program at DELETE" on page 564. This section describes DELETE of Client
virtual terminals at "The communications area at DELETE for Client virtual
terminals" and bridge facility virtual terminals at "The communications area at
DELETE for bridge facility virtual terminals" on page 576.
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.

The communications area at DELETE for Client virtual terminals

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_EXIT_COMPONENT
DELETE_SHIPPED_TERMID
DELETE_SHIPPED_APPLID
DELETE_SHIPPED_LTERMID
DELETE_SHIPPED_NETNAME
Figure 55. Autoinstall control program's communications area at DELETE. For Client virtual terminals.
At DELETE, all fields in the communications area are input only. Fields not listed
below are as described for INSTALL.
RETURN_OK (X'00')
Install the virtual terminal. This is the default value. Your user
program must return this value if the resource is to be
autoinstalled.
REJECT (X'01')
Do not install the virtual terminal.
SELECTED_BRFAC_NETNAME
An 8-character field used to specify the netname of the bridge facility. If
the name is less than 8 characters long, it must be padded with trailing
blanks. You can copy the name in INSTALL_BRFAC_NETNAME_PTR,
or set a new value.
A fullword pointer to a 4-character input field containing the TERMID passed to
the CICS autoinstall function (that is, the supplied name).
DSECT , Delete parameter list
DS F Standard field
DS XL1 Delete type
EQU X'FC' Delete virtual terminal
DS CL2 Component ID 'ZC'
DS CL1 Reserved
DS CL4 TERMID
DS CL8 Applid of Client workstation
DS CL4 TERMID in this region
DS CL8 Netname of Client workstation
Chapter 15. Writing a program to control autoinstall of virtual terminals
575