ttdt_Save(3)

ttdt_Save(3)	       C LIBRARY FUNCTIONS	     ttdt_Save(3)

NAME
     ttdt_Save - request a ToolTalk client to save a file

SYNOPSIS
     #include <Tt/tttk.h>

     Tt_status ttdt_Save(Tt_message context,
			 const char *pathname,
			 Tt_scope the_scope,
			 XtAppContext app2run,
			 int ms_timeout);

DESCRIPTION
     The  ttdt_Save()  function	 sends	a  Save	 request  in  the
     the_scope	argument and waits for the reply.  A Save request
     asks the handling ToolTalk	client to save any changes  pend-
     ing on pathname.

     The context argument describes the	environment to	use.   If
     context is	not zero, messages created by ttdt_Save() inherit
     from context all contexts whose  slotname	begins	with  the
     characters	ENV_.

     The the_scope argument identifies the scope of the	 request.
     If	 the_scope  is	TT_SCOPE_NONE, ttdt_Save() tries TT_BOTH,
     and falls back to TT_FILE_IN_SESSION if,  for  example,  the
     ToolTalk database server is not installed on the file server
     that owns pathname.

     The ttdt_Save() function passes app2run  and  ms_timeout  to
     tttk_block_while(3),  blocking  on	 the  reply  to	 the Save
     request it	sends.

RETURN VALUE
     Upon successful completion, the ttdt_Save() function returns
     the  status  of  the  operation  as  one  of  the	following
     Tt_status values:

	TT_OK	The sent request received  an  affirmative  reply
		within ms_timeout milliseconds.

	TT_DESKTOP_ETIMEDOUT
		No reply  was  received	 within	 ms_timeout  mil-
		liseconds.

	TT_DESKTOP_EPROTO
		The request was	failed,	but the	handler	 set  the
		tt_message_status()   of  the  failure	reply  to
		TT_OK, instead of a specific error status.

	TT_ERR_DBAVAIL
		The ToolTalk service could not access  the  Tool-
		Talk database needed for this operation.

Unix System LaboratorLast change: 11 May 1994			1

ttdt_Save(3)	       C LIBRARY FUNCTIONS	     ttdt_Save(3)

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied ToolTalk database in the expected place.

	TT_ERR_NOMEM
		There is insufficient memory available to perform
		the function.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_OVERFLOW
		The ToolTalk service  has  more	 active	 messages
		than  it  can  handle.	 (The  maximum	number of
		active messages	is implementation  specific,  but
		is at least 2000.)

	TT_ERR_POINTER
		The pathname argument was NULL or was a	 ToolTalk
		error pointer.

	TT_ERR_PROCID
		The specified process identifier is out	 of  date
		or invalid.

SEE ALSO
     Tttttk(5),	ttdt_Revert(3),	ttdt_file_join(3),
     ttdt_file_event(3), tttk_block_while(3).

Unix System LaboratorLast change: 11 May 1994			2