DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Get_Status(4)




Get_Status(4)	 DEVICES AND NETWORK INTERFACES	    Get_Status(4)

NAME
     Get_Status	request	- retrieve a tool's current status

SYNOPSIS
     Get_Status(out string status,
		out string vendor,
		out string toolName,
		out string toolVersion
		[in messageID operation2Query]);

DESCRIPTION
     The Get_Status request retrieves the  current  status  of	a
     tool  (or,	 optionally,  of  a specific operation being per-
     formed by a tool).

     The status	argument is the	status retrieved.

     The vendor	argument is the	name of	the vendor  of	the  han-
     dling tool.

     The toolName argument is the name of the handling tool.

     The toolVersion argument is  the  version	of  the	 handling
     tool.

OPTIONAL ARGUMENTS
     The operation2Query argument is the ID of the  request  that
     initiated	the  operation	the  status  of	 which	is  being
     requested.

APPLICATION USAGE
     The ttdt_session_join(3), and ttdt_message_accept(3),  func-
     tions  can	 be  used  to register for, and	help process, the
     Get_Status	request.

EXAMPLES
     After  sending  a	TT_REQUEST  and	 storing  its  handle  in
     Tt_message	 request_I_sent, if the	handler	identifies itself
     with    a	  Status    notice    saved	in     Tt_message
     status_msg_from_handler,  then  the status	of request_I_sent
     can be queried as in the following	example:

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		  tt_message_sender(status_msg_from_handler),
		  TTDT_GET_STATUS, my_callback);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
	  tt_message_arg_add(msg, TT_IN, Tttk_string,
		      tt_message_id(request_I_sent));
	  tt_message_send(msg);

Unix System LaboratorLast change: 13 May 1994			1

Get_Status(4)	 DEVICES AND NETWORK INTERFACES	    Get_Status(4)

SEE ALSO
     tt_message_arg_add(3), tt_message_id(3), tt_message_send(3),
     ttdt_message_accept(3), tt_message_sender(3),
     ttdt_session_join(3).

Unix System LaboratorLast change: 13 May 1994			2


Man(1) output converted with man2html