The autoinstall control program at delete – IBM SC34-6814-04 User Manual

Page 597

Advertising
background image

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.

INSTALL_BRFAC_TERMID_PTR

A fullword pointer to a 4-character input field containing the TERMID passed to
the CICS autoinstall function (that is, the supplied name).

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.

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’FC’

Delete virtual terminal

DELETE_SHIPPED_EXIT_COMPONENT

DS

CL2

Component ID ’ZC’

DS

CL1

Reserved

DELETE_SHIPPED_TERMID

DS

CL4

TERMID

DELETE_SHIPPED_APPLID

DS

CL8

Applid of Client workstation

DELETE_SHIPPED_LTERMID

DS

CL4

TERMID in this region

DELETE_SHIPPED_NETNAME

DS

CL8

Netname of Client workstation

Figure 55. Autoinstall control program’s communications area at DELETE. For Client virtual terminals.

Chapter 15. Writing a program to control autoinstall of virtual terminals

575

Advertising