TRANSFER Programming Manual

Name Validation
Naming TRANSFER Objects
069138, Update 1 to 040970 Tandem Computers Incorporated 4–11
TRANSFER Name Directory The names of all correspondents, folders, and distribution lists in a TRANSFER
application are defined in the TRANSFER name directory. This directory exists at
each node and identifies all named objects (except instances of items in folders)
defined at the node. At node \NY, for example, the directory contains the names of all
correspondents defined at the New York node.
The recommended name for identifying the name directory is $T.CORR, which is also
the default name supplied by Tandem. This same name must be used for the name
directory at each node in the network. Differing names would imply more than one
directory, but a TRANSFER system cannot communicate across directories.
For application development, you can establish and use an additional TRANSFER
system with a different name directory and PATHWAY control file. This additional
system could run in parallel with your production TRANSFER system; its name
directory would be assigned a name other than $T.CORR by the system administrator.
A TRANSFER system using one name directory name cannot send packages to, or
otherwise communicate with, another TRANSFER system using a different name
directory name.
Name Validation When a process references a correspondent, distribution list, or folder, the TRANSFER
delivery system checks that the process supplied a valid object name.
Note The following discussion applies to names for correspondents, distribution lists, and folders, but not to
names for named items.
Two levels of objects are defined in the TRANSFER name directory. Correspondents
are at the higher level. Folders and distribution lists are at the lower level. This
structure means that folders and distribution lists effectively exist only within depots.
Within a depot, names must be unique; a folder and a distribution list within the same
depot cannot have the same name.
The TRANSFER delivery system performs name validation under the following
circumstances:
When a user process registers (adds) a new correspondent to the local TRANSFER
system. The TRANSFER delivery system ensures that the name is unique within
the directory before it is added; if it is unique, the TRANSFER delivery system
places the name of the correspondent in the name directory. Once a
correspondent is registered, any TRANSFER application can access it.
When a user process tries to initiate communication between a correspondent and
the TRANSFER delivery system (called beginning a session). The TRANSFER
delivery system validates the correspondent name and password before starting
the session.