Index Index for
Section 3
Index Alphabetical
listing for T
Bottom of page Bottom of
page		 

tt_default_session_set(3)


CDE


NAME

  tt_default_session_set - set the current default session identifier


SYNOPSIS

  #include <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_session_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

  tt_c.h(5), tt_open(3), tt_default_procid(3), tt_default_session(3)

Index Index for
Section 3
Index Alphabetical
listing for T
Top of page Top of
page