TRANSFER Programming Manual

Sample Client Functional Description
Designing and Writing a Client
069138, Update 1 to 040970 Tandem Computers Incorporated 9–23
Step 4: Display the Mail Posting screen.
The client next displays the Mail Posting screen:
-- MAIL POSTING SCREEN --
To:
Subject:
Text
F6 -- Send F16 -- Quit and Return SF16 -- Logoff
This screen allows the correspondent to enter the name of the recipient of the package,
a subject line, and up to five lines of text. After entering this information, the
correspondent presses the F6 key to send the package. The F16 function key would
allow the correspondent to stop composing the package and return to the function
menu screen.
Step 5: Create an item for the new package.
To handle the package, the client executes a BEGIN-TRANSACTION operation and
issues an IPC containing a CREATE-ITEM UOW to establish a package header item.
This package header item is characterized by the data in the ITEM-TYPE and IS-PKG-
HDR fields of the UOW. In the reply to this UOW, TISERV returns a unique item ID
for the new item.
Step 6: Specify the recipient.
To specify the recipient, the client issues the ADD-RECIP UOW.
Step 7: Add the subject and text lines to the package.
To add the subject and text lines, the client issues a group of ADD-ITEM-REC UOWs.
This group can include from 0 to 1 ADD-ITEM-REC UOWs for the subject line, and
from 0 to 5 ADD-ITEM-REC UOWs for the text line. (See the ADD-SUBJECT-REC and
ADD-TEXT-REC definitions in the code at the end of this section.)