Default actions of the sample programs – IBM SC34-6814-04 User Manual

Page 587

Advertising
background image

DELETE_SHIPPED_TERM (X'FA')

A shipped terminal

DELETE_SHIPPED_RSE (X'FB')

A shipped connection (remote system entry).

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.

Note:

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.

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

565

Advertising