TRANSFER Reference Manual

START-SESSION
TISERV UOW Descriptions
2–494 069139, Update 1 to 40969 Tandem Computers Incorporated
The same transformations are applied to any stored time zone differences. The
sender time zone difference stored in a package header is initially set to the session
(server-requester) time zone difference when the package is submitted. Whenever
the package is transferred from one node to another, the following adjustments are
made at the receiving node: the difference in local times between the receiving
node and the transferring node is added to all timestamps (except the delivered
timestamp) and to the time zone difference field.
RESOLVED-NAME
is the resolved name of the correspondent, returned by the TRANSFER delivery
system. If this is a remote name, the session is not established; however, you can
use the returned name to contact the remote server.
START-SESSION Operation
START-SESSION validates the correspondent’s 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.
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 UOW in an IPC request to initiate a session, set
the SESSION-ID field of the IPC header to binary zeros.
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. 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. TWORK uses a parameter in the PATHWAY
configuration file, IDLESESSIONDELAY, to determine how long to wait before ending
an idle session. IDLESESSIONDELAY has a default of 24 hours.
To terminate the session, issue an END-SESSION UOW.