tt_default_session_set(3)

NAME
     tt_default_session_set - set the current default session identifier

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

DESCRIPTION
     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
     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
     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(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 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(3)
          tt_default_session(3)

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

SEE ALSO
     Tttt_c(5), tt_open(3), tt_default_procid(3), tt_default_session(3).