TRANSFER Reference Manual

START-SESSION-B40
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–501
START-SESSION-B40 Operation
START-SESSION-B40 validates the correspondent identity and right to communicate
with the TRANSFER delivery system at the local node, and establishes the running
environment for a new session. This UOW cannot be issued from within an
established session; the TRANSFER delivery system performs work for only one
session within a single IPC request. If present in a request, this UOW can be preceded
only by NOOP or GET-CONFIG-NAME UOWs. The START-SESSION-B40 UOW
allows you to select the preferred language and character map for the session; the
START-SESSION UOW does not provide such capability.
Note See the discussion of the ACK-RECEIPT UOW earlier in this section for the effect of correspondent name
suffixes when starting a session.
If the depot is a group, an attempt to start a session results in an
E-LOGON-DISALLOWED error.
When inserting the START-SESSION-B40 UOW in an IPC request to initiate a session,
you should set the SESSION-ID field of the IPC header to binary zeros; as a result, the
TRANSFER delivery system does not use this field for session validation.
If the session is successfully established, it is effective for all later UOWs in the same
request; the TRANSFER delivery system returns the ID for the newly created session
in the reply IPC header for that request. You must then set the SESSION-ID field to
this value in the IPC header for all subsequent requests associated with that session.
This value uniquely identifies your session at the node. The contents of the SESSION-
ID field are unprintable and any attempt to display them produces unpredictable
results. When the process ends the session, it relinquishes the session ID.
The TRANSFER delivery system automatically eliminates a session that remains idle
for an extended period of time. The controlling parameter, IDLESESSIONDELAY, is
in the PATHWAY configuration file and has a default value of 24 hours.
To terminate the session, issue the END-SESSION UOW.
In COBOL or SCREEN COBOL, you can use the following code sequence to set the
local time field of this UOW:
01 COBOL-TIME.
05 TRANSFER-TIME PIC 9(6).
05 FILLER PIC 9(2).
...
PROCEDURE DIVISION.
MOVE 19 TO UOW SS-CENTURY.
ACCEPT ACCEPT-DATE FROM DATE.
ACCEPT COBOL-TIME FROM TIME.
MOVE ACCEPT-TIME TO TRANSFER-TIME.