TRANSFER Reference Manual

GET-NEXT-SESSION
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–317
RETN-CODE
is the return code. TISERV returns a code in this field to indicate one of the
following entries:
0 OK
-4001 W-EOF
4010 E-BAD-TRANSACTION
4093 E-SECURITY-VIOLATION
4904 E-ERR-SESSION-FILE
RETN-CODE-DETAIL
is an error number returned by a subsystem other than the TRANSFER delivery
system or is a further qualification of an error detected by the TRANSFER delivery
system.
NUM-RETURNED
is the number of sessions for which the TRANSFER delivery system actually
returns information.
SESSION-DATA
contains the correspondent name (CORR-NAME) and session ID (SESSION-ID)
for the selected sessions. If the correspondent represented by your process has
only read security privilege (and not write privilege), TISERV returns 0 to the
session ID field.
GET-NEXT-SESSION Operation
GET-NEXT-SESSION returns the names of correspondents with active sessions.
If the number of elements remaining in the list is less than or equal to the number
requested or if no active sessions were found, the warning W-EOF is returned in the
RETN-CODE field.
A system administrator with write privilege at a node can terminate any session at that
node by following these steps:
1. Obtain the session ID through the GET-NEXT-SESSION UOW.
2. Use this session ID in the IPC header and transmit the END-SESSION UOW in the
IPC message.