Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_thread_session_set (3)

Name

tt_thread_session_set - rently active thread

Synopsis

#include <Tt/tt_c.h>
Tt_status tt_thread_session_set ( const char *sessid );

Description

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)