The autoinstall control program at delete – IBM SC33-1683-02 User Manual

Page 551

Advertising
background image

partner. This field is set whenever the local CICS is registered as a generic
resource. At all other times it has a value of 0.

INSTALL_APPC_GR_TYPE_PTR

A fullword pointer to a 1-byte input field indicating whether this is a connection
between generic resources and, if so, whether the NETNAME passed on the
BIND is the partner’s generic resource name or its member name. The equated
values are:

G

NETNAME is the partner’s generic resource name and
APPC_NETNAME2 is its member name (applid).

M

NETNAME is the partner’s member name (applid) and
APPC_NETNAME2 is its generic resource name.

Blank This CICS is not registered as a generic resource or the partner is not

registered.

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 38.

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
495. The value X'FA' or X'FB' represents the deletion of a shipped terminal
or connection—see page 528. The value X'FC' represents the deletion of a
Client virtual terminal—see page 536.

Fullword 1

Standard Header

Byte 1

Function Code

(X'F5' or X'F6')

Bytes 2 - 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 38. Autoinstall control program’s communication area at DELETE. For APPC
connections initiated by BIND requests.

autoinstall control program at INSTALL

Chapter 12. Writing a program to control autoinstall of APPC connections

519

Advertising