tt_message_disposition(3)

tt_message_disposition(C)LIBRARY FUNCTIOtt_message_disposition(3)

NAME
     tt_message_disposition - retrieve the disposition	attribute
     from a message

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_disposition tt_message_disposition(Tt_message m);

DESCRIPTION
     The tt_message_disposition() function retrieves the disposi-
     tion attribute from the specified message.

     The m argument is the opaque handle for the message involved
     in	this operation.

RETURN VALUE
     Upon  successful  completion,  the	 tt_message_disposition()
     function  returns a value that indicates whether an instance
     of	the receiving process should be	started	 to  receive  the
     message  immediately, or whether the message is to	be queued
     until the receiving process is started at a later time.  The
     tt_message_disposition() function returns one of the follow-
     ing Tt_disposition	values:

	TT_DISCARD
		There is no receiver for this message.	The  mes-
		sage  will  be	returned  to  the sender with the
		Tt_status field	containing TT_FAILED.

	TT_QUEUE
		Queue the message until	a process of  the  proper
		ptype receives the message.

	TT_START
		Attempt	to start a process of the proper ptype if
		none is	running.

	TT_QUEUE+TT_START
		Queue the message and attempt to start a  process
		of the proper ptype if none is running.

     The application can use tt_int_error(3) to	 extract  one  of
     the  following  Tt_status	values	from  the  Tt_disposition
     integer:

	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_POINTER

Unix System LaboratorLast change: 11 May 1994			1

tt_message_disposition(C)LIBRARY FUNCTIOtt_message_disposition(3)

		The pointer passed does	not point to an	object of
		the correct type for this operation.

SEE ALSO
     Tttt_c(5),	tt_int_error(3).

Unix System LaboratorLast change: 11 May 1994			2