*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> tt_thread_session_set (3)              


 tt_thread_session_set(library call)     tt_thread_session_set(library call)

 NAME    [Toc]    [Back]
      tt_thread_session_set - set the default session identifier for the
      current thread

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      Tt_status tt_thread_session_set(
      const char *sessid);

 DESCRIPTION    [Toc]    [Back]
      The tt_thread_session_set function sets the default session identifier
      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 to
      specify which session it wants to connect to in the active thread.

      To change to another opened session, the application must use either
      tt_thread_procid_set or tt_default_procid_set.

      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 and then tt_open.

      The tt_open call 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 the session to which a procid 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 and then tt_thread_session.

 ARGUMENTS    [Toc]    [Back]
      sessid    Specifies a pointer to the unique identifier string for the
                session that is to be the default session for the current

 RETURN VALUE    [Toc]    [Back]
      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_ERR_NOMP    [Toc]    [Back]
                The ttsession process is not running and the ToolTalk
                service cannot start it.

      TT_ERR_PROCID    [Toc]    [Back]
                The current default process identifier is out of date or

                                    - 1 -       Formatted:  January 24, 2005

 tt_thread_session_set(library call)     tt_thread_session_set(library call)

      TT_ERR_SESSION    [Toc]    [Back]
                The specified ToolTalk session is out of date or invalid.

      TT_ERR_UNIMP    [Toc]    [Back]
                The ToolTalk implementation does not support multithreading.

      TT_ERR_TOOLATE    [Toc]    [Back]
                The multithreading feature has not been enabled.

 APPLICATION USAGE    [Toc]    [Back]
      Some ToolTalk API calls implicitly depend on the current default
      session. Setting the default session for the specific thread prevents
      race conditions caused by other threads changing the global default

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5), tt_default_procid(3), tt_default_session(3),
      tt_feature_required(3), tt_thread_procid(3), tt_thread_session(3)

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
tt_thread_session HP-UX retrieve the default session identifier for the currently active thread
tt_default_session_set HP-UX set the current default session identifier
tt_default_session HP-UX retrieve the current default session identifier
pthread_equal Tru64 Compares one thread identifier to another thread identifier
tt_initial_session HP-UX return the initial session identifier
pthread_setspecific Tru64 Sets the thread-specific data value associated with the specified key for the current thread
pthread_getsequence_np Tru64 Obtains the unique identifier for the specified thread
pthread_self Tru64 Obtains the identifier of the calling thread
tis_self Tru64 Obtains the identifier of the calling thread
SSL_get_default_timeout NetBSD get default session timeout value
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service