tt_thread_session_set - rently active thread
#include <Tt/tt_c.h> Tt_status tt_thread_session_set ( const char *sessid );
tt_thread_session_set(3) ToolTalk Functions tt_thread_session_set(3)
NAME
tt_thread_session_set - set the default session identifier for the cur-
rently active thread
SYNOPSIS
#include <Tt/tt_c.h>
Tt_status tt_thread_session_set ( const char *sessid );
DESCRIPTION
The tt_thread_session_set() function sets the default session identi-
fier for the currently active thread.
The ToolTalk service uses the initial user session as the default
session and supports one session per procid. The application can make
this call before it calls tt_open(3) to specify the session to which it
wants to connect in the active thread.
The sessid argument is a pointer to the unique identifier for the ses-
sion in which the procid is interested.
RETURN VALUE
Upon successful completion, the tt_thread_session_set() function
returns the status of the operation as one of the following Tt_status
values:
TT_OK The operation completed successfully.
TT_WRN_NOT_ENABLED
The feature has not yet been enabled.
TT_ERR_NOMP
The ttsession(1) process is not running and the ToolTalk ser-
vice cannot restart it.
TT_ERR_PROCID
The current default process identifier is out of date or
invalid.
TT_ERR_SESSION
The specified ToolTalk session is out of date or invalid.
APPLICATION USAGE
To change to another opened session, the application must use either
tt_thread_procid_set(3) or .BR tt_default_procid_set (3).
To join other sessions, the procid must first set the new session as
the default session, and then initialize and register with the
ToolTalk service. The calls required must be in the following order:
tt_thread_session_set() or tt_default_session_set(3) tt_open(3)
The tt_open(3) may create another ToolTalk procid, the connection to
which is identified by a procid. Only one ToolTalk session per procid
is allowed. (However, multiple procids are allowed in a client.)
There are no API calls to determine to which session a particular pro-
cid is connected. If it is important for the application to know the
session to which it is connected. It must make the following calls in
the indicated order:
tt_open(3) tt_thread_session(3)
The application can then store the information by indexing it by the
procid returned by the tt_open(3) call.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tt_c(5), tt_open(3), tt_default_procid(3), tt_thread_procid(3),
tt_default_session(3), tt_thread_session(3).
ToolTalk 1.3 1 March 1996 tt_thread_session_set(3)