Pause(4)

Pause(4)	 DEVICES AND NETWORK INTERFACES		 Pause(4)

NAME
     Pause request - 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  iden-
     tifying itself to the requester).

ERRORS
     The ToolTalk service may return the following error in  pro-
     cessing the Pause request:

	TT_DESKTOP_ENOMSG
	      The operation argument does not refer to	any  mes-
	      sage currently known by the handler.

APPLICATION USAGE
     The ttdt_session_join(3), and ttdt_message_accept(3),  func-
     tions  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.

Unix System LaboratorLast change: 13 May 1994			1