Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tt_prequest_create (3)

Name

tt_prequest_create - create a procedure request message

Synopsis

#include <Tt/tt_c.h>
Tt_message tt_prequest_create(Tt_scope scope,
const char *op);

Description

tt_prequest_create(3)         ToolTalk Functions         tt_prequest_create(3)



NAME
       tt_prequest_create - create a procedure request message

SYNOPSIS
       #include <Tt/tt_c.h>
       Tt_message tt_prequest_create(Tt_scope scope,
                                     const char *op);

DESCRIPTION
       The  tt_prequest_create() function creates a message.  The created mes-
       sage created contains the following:

             Tt_address = TT_PROCEDURE
             Tt_class = TT_REQUEST

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

       The  scope  argument determines which processes are eligible to receive
       the message.  The following values are defined:

          TT_SESSION
                  All processes joined to the indicated session are eligible.

          TT_FILE
                  All processes joined to the indicated file are eligible.

          TT_BOTH
                  All processes joined to either indicated file or  the  indi-
                  cated session are eligible.

          TT_FILE_IN_SESSION
                  All  processes  joined  to  both  the indicated file and the
                  indicated session are eligible.

       The op argument is the operation  to  be  performed  by  the  receiving
       process.

RETURN VALUE
       Upon  successful  completion, the tt_prequest_create() function returns
       the unique handle that identifies this message.   The  application  can
       use  tt_ptr_error(3)  to  extract one of the following Tt_status values
       from the returned handle:

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

APPLICATION USAGE
       The  application  should  use tt_free(3) to free any data stored in the
       address returned by the ToolTalk API.

       If the ToolTalk service is unable to create a message  when  requested,
       tt_prequest_create()  returns  an invalid handle.  When the application
       attempts to  use  this  handle  with  another  ToolTalk  function,  the
       ToolTalk service will return TT_ERR_POINTER.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+

SEE ALSO
       tt_c(5), tt_ptr_error(3), tt_free(3).




ToolTalk 1.3                     1 March 1996            tt_prequest_create(3)