tt_default_session_set(library call)   tt_default_session_set(library call)




 NAME    [Toc]    [Back]
      tt_default_session_set - set the current default session identifier

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

 DESCRIPTION    [Toc]    [Back]
      The tt_default_session_set function sets the current default session
      identifier.

      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.

      The sessid argument is a pointer to the unique identifier for the
      session in which the procid is interested.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, the tt_default_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
                The ttsession(1) process is not running and the ToolTalk
                service 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    [Toc]    [Back]
      To change to another opened session, the application must use the
      tt_default_procid_set function.

      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_default_session_set
      tt_open

      The tt_open(3) may create another ToolTalk procid, the connection to
      which is identified by a procid.  Only one ToolTalk session per procid



                                    - 1 -       Formatted:  January 24, 2005






 tt_default_session_set(library call)   tt_default_session_set(library call)




      is allowed.  (However, multiple procids are allowed in a client.)
      There are no API calls to determine to which session a particular
      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
      tt_default_session

      The application can then store the information by indexing it by the
      procid returned by the tt_open(3) call.

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


                                    - 2 -       Formatted:  January 24, 2005