Go to main content

man pages section 4: Device and Network Interfaces

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Pause (4)

Name

Pause - pause a tool, operation or data performance

Synopsis

Pause([in messageID operation]);

Description

Desktop Services Message Sets                                         Pause(4)



NAME
       Pause - pause a tool, operation or data performance

SYNOPSIS
       Pause([in messageID operation]);

DESCRIPTION
       The  Pause request pauses the specified tool, operation or data perfor-
       mance.

       If the optional operation argument  is  included,  the  handler  should
       pause the operation that was invoked by the specified request.

       The  operation  argument  is  the request that should be paused.  For a
       request to be eligible for pausing, the handler must have sent a Status
       notice   back   to  the  requester  (thus  identifying  itself  to  the
       requester).

ERRORS
       The ToolTalk service may return the following error in  processing  the
       Pause request:

          TT_DESKTOP_ENOMSG
                The operation argument does not refer to any message currently
                known by the handler.

APPLICATION USAGE
       The ttdt_session_join(3), and ttdt_message_accept(3), functions can  be
       used to register for, and help process, the Pause request.

EXAMPLES
       The Pause message can be sent as in the following example:

            Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
                        the_recipient_procid, TTDT_PAUSE,
                        my_callback);
            tt_message_send(msg);

WARNINGS
       Pause  can also be sent as a multicast notice, as an edict to all tools
       in the scope of the message.  The  consequences  of  doing  so  can  be
       severe and unexpected.


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


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

SEE ALSO
       tt_message_send(3), ttdt_message_accept(3), ttdt_session_join(3);
       Resume request.




ToolTalk 1.3                     1 March 1996                         Pause(4)