tt_bcontext_join(3)

tt_bcontext_join(3)    C LIBRARY FUNCTIONS    tt_bcontext_join(3)

NAME
     tt_bcontext_join -	add a byte-array value	to  the	 list  of
     values

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_bcontext_join(const char *slotname,
				const unsigned char *value,
				int length);

DESCRIPTION
     The tt_bcontext_join() function adds  the	given  byte-array
     value  to	the  list of values for	the named contexts of all
     patterns.	The context is compared	to  currently  registered
     patterns  for  the	procid.	 If a pattern has a slot with the
     specified name, the given byte-array value	is added  to  the
     list of values for	that slot.

     The slotname argument is the name of the context.	The value
     argument  is  the value to	be added.  The length argument is
     the length	in bytes of the	value.

RETURN VALUE
     Upon successful completion, the tt_bcontext_join()	 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_SLOTNAME
		The specified slotname is syntactically	invalid.

SEE ALSO
     Tttt_c(5).

Unix System LaboratorLast change: 11 May 1994			1