TRANSFER Reference Manual

GET-CONFIG-NAME
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–235
GET-CONFIG-NAME Operation
GET-CONFIG-NAME retrieves the configured name for the entity identified by
ENTITY-NAME. This name is returned in the CONFIGURED-NAME field. The
TRANSFER delivery system stores this information as follows:
The B40 version of the TRANSFER delivery system maintains the names of the
special TRANSFER folders (INBOX-FOLDER, OUTLOG-FOLDER, and
WASTEBASKET- FOLDER) as part of site-supported text. The system trigger
character is configured in the same way as the name character set. The entities
allowed in this field are described in Appendix C. Other entries, though legal,
should not be used in this field; they are intended for internal Tandem use only.
C30 and later versions of the TRANSFER delivery system support entity names
with the GET-CONFIG-NAME UOW. Appendix C lists all configured names for
TRANSFER entities.
Note This UOW does not require establishment of a session for its execution.
Names in the TRANSFER name directory must correspond to real entities so that the
TRANSFER delivery system can operate properly. This directory contains the names
of all entities required by the TRANSFER delivery system in its running environment.
If names do not correspond, problems can result; some of these problems are not
immediately obvious. For example, if PATHMON is running with a process name
other than the one specified in the name directory, your application might not discover
this until it tries (and fails) to transmit packages across the network. These names are
established during TRANSFER initialization, as described in the TRANSFER
Installation and Management Guide.
The configured name for TISERV-SERVER-CLASS is usually TISERV. If you are using
a server class name other than TISERV, you must still have a TISERV server class
defined. The application can then perform the following:
1. At initialization time, send a GET-CONFIG-NAME request to the server class
named TISERV, asking for the name of the TISERV-SERVER-CLASS.
2. Send all future TISERV requests to the server class whose name was returned in
step 1.
All names in the CONFIGURED-NAME field are returned in the English language and
as US ASCII characters except for the following four names:
The configured names of the three TRANSFER special folders: INBOX-FOLDER,
OUTLOG-FOLDER, and WASTEBASKET-FOLDER.
The configured system trigger character (recorded in the SYSTEM-TRIGGER-
CHAR entity).