The Autoinstall Control Program At Delete; When Autoinstalled Appc Connections Are Deleted - IBM SC34-6814-04 Customization Manual

The autoinstall control program at DELETE

To provide symmetry of control over the autoinstall process, the autoinstall control
program is also invoked when an autoinstalled APPC connection is deleted.
Invoking the control program at DELETE enables you to reverse the processes
carried out at the INSTALL event. For example, if the control program at INSTALL
incremented a count of the total number of automatically installed resources, then
the control program at DELETE would decrement that count.
Input to the program is by a communication area, addressed by DFHEICAP. The
layout of the communication area is shown in Figure 48.
Fullword 1 Standard Header
Byte 1 Function Code
Bytes 2 - 3 Component Code
Byte 4 Reserved
Fullword 2 SYSID of deleted connection
Fullword 3 NETNAME of deleted connection
Bytes 1-2 NETNAME length
Bytes 3-10 NETNAME
Figure 48. Autoinstall control program's communication area at DELETE. For APPC connections initiated by BIND
requests.
The Function Code byte (byte 1 of fullword 1) indicates why the user program has
been invoked:
X'F5'
X'F6'
Note: The value X'F1' represents the deletion of a local terminal, or an APPC

When autoinstalled APPC connections are deleted

Any autoinstalled APPC connection entry is deleted if the connection is discarded
(using the CEMT DISCARD command). In addition, connection entries can be
deleted when the terminal or system logs off, or is disconnected from CICS. This
kind of "implicit deletion" occurs for the following types of APPC autoinstalled
connection:
Single-session connections installed via a CINIT
These are deleted when the terminal user logs off, after the expiry of the AILDELAY
system initialization value.
(X'F5' or X'F6')
Always "ZC"
Always X'00'
After deletion of a parallel-session APPC connection that was initiated by a
BIND.
After deletion of a single-session APPC connection that was initiated by a
BIND.
single-session device that was autoinstalled via a CINIT request—see page
"The autoinstall control program at DELETE" on page 525. The value X'FA'
or X'FB' represents the deletion of a shipped terminal or connection—see
page "The autoinstall control program at DELETE" on page 564. The value
X'FC' represents the deletion of a Client virtual terminal—see page "The
autoinstall control program at DELETE" on page 575.
Chapter 12. Writing a program to control autoinstall of APPC connections
549