TRANSFER Programming Manual

Item Tree Operations
TRANSFER Services
40970 Tandem Computers Incorporated 5–3
Named Item Operations You can assign, remove, or modify a name for any instance of an item that exists in a
folder. To make this assignment, the process issues the ALTER-ITEM-NAME UOW.
The process can also retrieve one or more named items from a specific folder by using
the SCAN-BY-ITEM-NAME UOW. This UOW allows the process to select one or
more item instances by folder and item name or name pattern rather than by item ID.
It also lets the process scan a folder by item name only, starting at or immediately after
a particular named item.
When you do not know the name of a particular named item, you can obtain that
name by supplying the folder name and item ID in a GET-ITEM-NAME UOW.
Where item name information is used by the TRANSFER delivery system, a value of
spaces for an item name indicates that the item has no name.
In addition to assigning a name to an item, you can change an existing name for an
item or remove the name from an item.
Named instances of items are subject to these restrictions:
Different instances of the same item can have the same name or different names,
as long as both instances are stored in different folders.
An instance of one item can have the same name as an instance of a different item,
as long as both instances are stored in different folders.
Multiple instances of the same item cannot exist in the same folder, even if
different names are assigned. Within a folder, each item name and item ID must
be unique.
Item names cannot be used to access items in folders not owned by the current
correspondent or in folders on remote nodes.
Record Handling
Operations
You can perform the following record handling operations:
Define and add records of various types to an item (ADD-ITEM-REC UOW)
Access existing records in an item (GET-ITEM-REC UOW)
Delete records (DELETE-ITEM-REC UOW)
Item Tree Operations You can attach one item to another in a parent-component relationship. In fact, a
process can arrange for a component item to have components, each of which in turn
can have components, so that an entire tree of items can be created. The number of
levels of nesting, however, can affect the performance of your application.
You can perform the following item tree operations:
Attach one item to another (ATTACH-COMPNT-A01 UOW)
Obtain the item IDs of component items belonging to a parent (GET-ITEM-
COMPNT-A01 UOW)
Detach a component from a parent (DETACH-COMPNT UOW)