Index for Section 4

Alphabetical listing for P

Bottom of page

Pause(4)
CDE
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 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 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.

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

Index for Section 4

Alphabetical listing for P

Top of page