Index for Section 3

Alphabetical listing for T

tt_message_disposition(3)
CDE


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 disposition 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 following Tt_disposition
  values:
  There is no receiver for this message.  The message will be returned to the
  sender with the Tt_status field containing TT_FAILED.
  Queue the message until a process of the proper ptype receives the message.
  Attempt to start a process of the proper ptype if none is running.
  Queue the message and attempt to start a process of the proper ptype if
  none is running.

  The application can use tt_int_error3 to extract one of the following
  Tt_status values from the Tt_disposition integer: The operation completed
  successfully.
  The ttsession1 process is not running and the ToolTalk service cannot
  restart it.
  The pointer passed does not point to an object of the correct type for this
  operation.

SEE ALSO
  Tt/tt_c.h5, tt_int_error3.