SNAX/HLS Application Programming Manual
PREPARETOCLOSE Verb
Application Prototyping and Simulation (APS) System
104707 Tandem Computers Incorporated 6–35
PC:
PREPARE-TO-CLOSE
Verb
The PREPARE-TO-CLOSE verb is used to terminate a session in an orderly fashion.
Use of this verb is encouraged to ensure that both session partners are aware that a
session is about to be terminated, thus allowing each to perform clean-up processing.
This verb has no parameters. Select the verb by pressing function key F2 and execute
the verb by pressing SEND (F12).
If the user is a Primary Logical Unit (PLU), issue PREPARE-TO-CLOSE when ready to
terminate. The session partner receives the request but can still send and receive data
on the session. When the session partner has agreed to terminate the session, a special
message is placed on your message queue with DATA-TYPE-RECEIVED is
PREPARED-TO-CLOSE. Once this message is received, PLU can send data but must
realize that the session partner has prepared for session termination. The expected
response to this situation is for you to issue a CLOSE-SESSION verb.
If the user is a Secondary Logical Unit (SLU), issue PREPARE-TO-CLOSE when ready
to terminate. The SNAX/HLS server process might deliver a message to the receive
queue with DATA-TYPE-RECEIVED is PREPARED-TO-CLOSE, but this is not a usual
event. At the completion of this verb, you can expect that once you have retrieved all
current messages on your message queue, the session is terminated, and all
subsequent verbs are rejected with RETURN-CODE is RC-SESSION-TERMINATED or
RC-SESSION-NOT-ALLOCATED.