Default actions of the sample programs – IBM SC33-1683-02 User Manual

Page 561

Advertising
background image

DELETE_SHIPPED_EXIT_FUNCTION

A 1-byte field that indicates the type of resource being deleted. The equated
values are:

DELETE_SHIPPED_TERM (X'FA')

A shipped terminal

DELETE_SHIPPED_RSE (X'FB')

A shipped connection (remote system entry).

Note: A value of 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. A value of X'FC' represents the deletion of a Client virtual
terminal—see page 536. A value of X'F5' or X'F6' represents the deletion
of an APPC connection that was installed by a BIND request—see page
519.

DELETE_SHIPPED_TERMID

A 4-character field containing the identifier (TERMID) of the terminal or
connection in the TOR.

DELETE_SHIPPED_APPLID

An 8-character field containing the netname (applid) of the TOR.

DELETE_SHIPPED_LTERMID

A 4-character field containing the name by which the terminal or connection is
known in the AOR. This may or may not be the same as
DELETE_SHIPPED_TERMID, depending on whether an alias has been used in
the AOR.

DELETE_SHIPPED_NETNAME

An 8-character field containing the netname of the terminal being deleted.

Default actions of the sample programs

When DFHZATDX or DFHZATDY is invoked at INSTALL of a shipped terminal or
connection, it:

1. Updates, if necessary, the SELECTED_SHIPPED_TERMID field, so that it

contains the name by which the terminal or connection is known in the TOR.

Notes:

a. If CICS detected a conflict with a currently-installed remote TERMID, on

invocation of the sample programs SELECTED_SHIPPED_TERMID
contains a CICS-generated alias. The sample programs overwrite this value.

b. If CICS detected no conflict with a currently-installed remote TERMID, on

invocation of the sample programs SELECTED_SHIPPED_TERMID
contains the value of the TERMINAL attribute on the shipped definition (the
value pointed to by INSTALL_SHIPPED_TERMID_PTR). The sample
programs accept this value.

2. Permits the remote definition to be installed by setting the return code field to

RETURN_OK, and returning.

When DFHZATDX or DFHZATDY is invoked at DELETE of a shipped terminal or
connection, it takes no action and returns.

the autoinstall control program for shipped terminals

Chapter 13. Writing a program to control autoinstall of shipped terminals

529

|
|

Advertising