Filter
Top Products
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.
The Function Code byte (byte 1 of fullword 1) indicates why the user program has
been invoked:
X'F5' After deletion of a parallel-session APPC connection that was initiated by a
BIND.
X'F6' After deletion of a single-session APPC connection that was initiated by a
BIND.
Note: The value X'F1' represents the deletion of a local terminal, or an APPC
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.
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.
Fullword 1 Standard Header
Byte 1 Function Code (X’F5’ or X’F6’)
Bytes2-3 Component Code Always "ZC"
Byte 4 Reserved Always X’00’
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.
Chapter 12. Writing a program to control autoinstall of APPC connections 549