Pause - pause a tool, operation or data performance
Pause([in messageID operation]);
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)