TRANSFER Programming Manual

Session Control
TRANSFER Services
5–2 40970 Tandem Computers Incorporated
Session Control Before a process can transmit requests, the process must establish communication with
TISERV by initiating a session with the START-SESSION UOW. When interaction
with TISERV is no longer required, the process terminates this communication by
issuing an END-SESSION UOW.
Item Handling Item handling involves four general types of operations:
Defining individual items (whole item operations)
Managing named instances of items in folders (named item operations)
Appending records to and deleting records from items (record handling
operations)
Attaching and detaching items as components of other items (item tree operations)
Whole Item Operations Each item consists of an item descriptor and one or more data records. These data
records can contain text or other kinds of application data. The item descriptor
contains:
A network-unique ID of the item
A count of the number of component items pointed to by the first item (If the
number is zero, a list of component items does not exist.)
A list of item IDs for the component items
Various fields indicating the current status of the given item
The current update control count for the item, the creation date, and the name of
the correspondent who created the item
An item type, which is a numeric value defined by the application (The item type
should not be confused with the record type, as used in record handling
operations.)
If the item is a package, the item descriptor also contains:
The date that the package was submitted for delivery
The earliest and latest delivery dates that define the delivery window
An optional expiration date for the package
The package priority and delivery control information
To create an item, issue a CREATE-ITEM UOW. In response, TISERV assigns the item
ID and records the creation date and the correspondent name, item type, and other
information related specifically to this item in the item descriptor.
To access the information in the item descriptor, issue a GET-ITEM-DESCR UOW. To
make a duplicate copy of the item, with its own unique item ID, issue a COPY-ITEM
UOW. You might want to do this to add records to an item if the original item is
unalterable.