tttk_message_create(3)

tttk_message_create(3) C LIBRARY FUNCTIONS tttk_message_create(3)

NAME
     tttk_message_create - create a message conforming to the CDE
     conventions

SYNOPSIS
     #include <Tt/tttk.h>

     Tt_message	tttk_message_create(Tt_message context,
				    Tt_class the_class,
				    Tt_scope the_scope,
				    const char *handler,
				    const char *op,
				    Tt_message_callback	callback);

DESCRIPTION
     The tttk_message_create() function	creates	 a  message  that
     propagates	 inherited  contexts from one message to another.
     The tttk_message_create() function	 creates  a  message  and
     copies  onto  it  all  the	 context slots from context whose
     slotname begins with the  characters  ENV_.   It  gives  the
     created  message  a  Tt_class of the_class	and a Tt_scope of
     the_scope.	    If	  handler    is	   not	   NULL,     then
     tttk_message_create()  addresses the message as a TT_HANDLER
     to	that procid; otherwise,	it gives the message a Tt_address
     of	 TT_PROCEDURE.	 It  sets the message's	op to op if op is
     not NULL.	If callback is	not  NULL,  tttk_message_create()
     adds it to	the message as a message callback.

RETURN VALUE
     Upon successful completion, the tttk_message_create()  func-
     tion returns the created Tt_message , which can be	modified,
     sent, and destroyed like any other	Tt_message  ;  otherwise,
     it	 returns  an  error  pointer.	The  application  can use
     tt_ptr_error(3) to	extract	one of	the  following	Tt_status
     values from the returned handle:

	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_PROCID
		The specified process identifier is out	 of  date
		or invalid.

SEE ALSO
     Tttttk(5),	tt_message_create(3), tttk_message_create(3),
     ttdt_file_notice(3), ttdt_file_request(3).

Unix System LaboratorLast change: 11 May 1994			1