Index Index for Section 3
Index Alphabetical listing for T 

tt_orequest_create(3)


CDE




NAME

  tt_orequest_create - create a request message


SYNOPSIS

  #include <Tt/tt_c.h>
  Tt_message tt_orequest_create(const char *objid,
				const char *op);


DESCRIPTION

  The tt_orequest_create function creates a message.  The created message
  contains the following:

	Tt_address = TT_OBJECT
	Tt_class = TT_REQUEST

  The application can use the returned handle to add arguments and other
  attributes, and to send the message.

  The objid argument is the identifier of the specified object.	 The op
  argument is the operation to be performed by the receiving process.


RETURN VALUE

  Upon successful completion, the tt_orequest_create function returns the
  unique handle that identifies the message.  The application can use
  tt_ptr_error3 to extract one of the following Tt_status values from the
  returned handle: The operation completed successfully.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  The specified process identifier is out of date or invalid.


APPLICATION USAGE

  The application should use tt_free3 to free any data stored in the address
  returned by the ToolTalk API.


SEE ALSO

  Tt/tt_c.h5, tt_ptr_error3, tt_free3.