TRANSFER Programming Manual

Sample Client Functional Description
Designing and Writing a Client
069138, Update 1 to 040970 Tandem Computers Incorporated 9–21
Sample Client Functional
Description
The following pages describe a sample session with the client.
Step 1: Display the Base screen and the Logon screen.
The Logon screen looks like this:
E L E C - M A I L CLIENT
-- LOGON SCREEN --
Please enter Name and Password:
Name:
Password:
F1 = Logon SF16 = Exit
The user enters a correspondent name and a password.
After entering these fields, the user presses the F1 function key to transmit the
information to the client. The SF16 function key allows the user to exit the program.
Step 2: Accept the logon and start the session.
The client passes the information from the Logon screen to the input buffer for the
START-SESSION UOW, executes a BEGIN-TRANSACTION operation to denote the
beginning of a TMF transaction, and then issues an IPC containing the
START-SESSION UOW to TISERV. If the UOW is successful, TISERV assigns a
session ID and begins a session for the correspondent; the client now executes an
END-TRANSACTION operation to terminate the transaction and displays its Function
Menu screen. If the UOW fails, TISERV reports the failure to the client, which aborts
the transaction and displays an error message on the Logon screen.
When creating the session, TISERV returns the session ID in the SESSION-ID field of
the IPC header. (Previously, this field contained binary zeros.) A client must enter this
same session ID value in the headers for all subsequent IPCs associated with this
session.