TRANSFER Programming Manual

Folder Manipulation
TRANSFER Services
40970 Tandem Computers Incorporated 5–7
You can perform the following operations:
Access information in the item descriptor (GET-ITEM-DESCR UOW)
Update fields in the item descriptor (ALTER-ITEM-DESCR UOW)
Recipient List Definition The recipient list contains the names of correspondents and distribution lists that are
to receive the package. You can perform the following operations for these lists:
Add names to a recipient list (ADD-RECIP UOW)
Obtain the names of currently defined recipients (GET-RECIP-REC UOW)
Delete recipients from a recipient list (DELETE-RECIP UOW)
Package Delivery You send a package by issuing a SUBMIT-PKG UOW. You cancel the delivery of a
package by issuing a CANCEL-PKG UOW.
Package Receiving A client acknowledges receipt of a package by issuing an ACK-RECEIPT UOW. This
operation is recommended whenever a client retrieves a package from the INBOX
folder.
Folder Manipulation Folder manipulation involves the following operations:
Save items in folders according to the ordering criteria established for the folder
(SAVE-ITEM, SAVE-ITEM-B00, and SAVE-ITEM-BY-KEY UOWs)
Establish or modify the ordering criteria for folders so that items and packages can
be stored and retrieved in a specific sequence (ALTER-FOLDER-ORDER UOW)
Establish or modify the item retention time for folders, which is a default for the
length of time that an item is saved in a folder. When the retention time for an
item expires, the TRANSFER delivery system automatically deletes (unsaves) the
item (ALTER-FOLDER-DESCR UOW)
Scan the contents of a folder (SCAN-FOLDER, SCAN-FOLDER-B00, SCAN-
FOLDER-BY-KEY, and SCAN-FOLDER-DETAIL UOWs)
Remove an item from a folder (UNSAVE-ITEM UOW)
Determine the folders in which a particular item is saved (WHERE-SAVED UOW)
Determine the ordering criteria for a folder (GET-FOLDER-ORDER UOW).
Determine the item retention time and ordering criteria for a folder (GET-
FOLDER-DESCR UOW)
You can also use the ADMIN application to perform many of the above operations.
A folder can contain both packages and individual items. Conversely, the same item
or package can reside in more than one folder. An item cannot be stored in one folder
more than once.
In addition to the special INBOX, OUTLOG, and WASTEBASKET folders, you can
define other folders for a depot. Folders can be used only by the depot owner.