TRANSFER Programming Manual

Sample Client Functional Description
Designing and Writing a Client
9–24 069138, Update 1 to 040970 Tandem Computers Incorporated
Step 8: Save the recipient name the sender specified.
In another IPC, the client issues an ADD-ITEM-REC UOW (as ADD-RECIP-TEXT) to
send the TRANSFER delivery system a text version of the recipient name that was
returned in the ACCEPTED-NAME field of the original ADD-RECIP reply. This saves
the recipient name the sender originally specified so that Tandem mail clients can later
display the name. It is necessary to save the original recipient name because the
TRANSFER delivery system modifies recipient records during delivery—for example,
by expanding a distribution list name into the names of all the recipients in the list.
Step 9: Submit the package for delivery.
To submit the package, the client issues the SUBMIT-PKG UOW in the same IPC as
Step 8.
At this point, the client executes an END-TRANSACTION operation to terminate the
transaction, and the TRANSFER delivery system assumes control of the package to
deliver it asynchronously.
Step 10: Display the Function Menu screen and branch to a new function.
Next, the correspondent decides to read incoming mail. Through the Function Menu
screen, the correspondent selects this operation by pressing the F3 function key.
Step 11: Scan the INBOX folder.
The client issues an IPC containing the SCAN-FOLDER UOW, referencing the
correspondent's INBOX folder. This UOW returns the IDs of the items in the folder to
the client, reading them in sequential order. Notice that since this IPC did not involve
changes to the TRANSFER database (and thus, did not involve possible inconsistencies
in the event of an error), this IPC was not issued within the framework of a TMF
transaction.
Step 12: Retrieve a message from the INBOX.
For the first package in the list of item IDs, the client executes a
BEGIN-TRANSACTION operation and sends an IPC containing the following UOWs:
GET-ITEM-DESCR—to obtain the item's descriptor fields
GET-ITEM-REC—to obtain the subject record from the item
GET-ITEM-REC—to obtain the recipient for the package
GET-ITEM-REC—to obtain the text records
ACK-RECEIPT—to acknowledge that the package was received at the recipient's
depot
Next, the client executes an END-TRANSACTION operation. Note that the presence
of the ACK-RECEIPT UOW required that the IPC be contained within its own
transaction.