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