]]>
]]>
Pause
special file
Pause
pause a tool, operation or data performance
Pause([in messageID operation]);
DESCRIPTION
The
Pause request
pauses the specified tool, operation or data performance.
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
&cdeman.ttdt.session.join;, and
&cdeman.ttdt.message.accept;, 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.
]]>
SEE ALSO
&cdeman.tt.message.send;, &cdeman.ttdt.message.accept;, &cdeman.ttdt.session.join;; Resume request.