tt_default_session_set(3)

tt_default_session_set(C)LIBRARY FUNCTIOtt_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)

Unix System LaboratorLast change: 11 May 1994			1

tt_default_session_set(C)LIBRARY FUNCTIOtt_default_session_set(3)

     The tt_open(3) may	create another ToolTalk	procid,	the  con-
     nection  to which is identified by	a procid.  Only	one Tool-
     Talk session per procid is	allowed.  (However, multiple pro-
     cids  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).

Unix System LaboratorLast change: 11 May 1994			2