Status(special file)

NAME
Status — a tool has some status information to announce

SYNOPSIS

Status(in string status,
        in string vendor,
        in string toolName,
        in string toolVersion
        [in messageID commission]);

DESCRIPTION

The Status notice indicates that a tool has status information to announce.

The status argument is the status being announced.

The vendor argument is the vendor of the sending tool.

The toolName argument is the name of the sending tool.

The toolVersion argument is the version of the sending tool.

The commission argument is the ID of the request, if any, that initiated the operation the status of which is being announced.

APPLICATION USAGE

The ttdt_subcontract_manage(3), function can be used to register for, and help process, the Status request.

The Status request can be sent with ttdt_message_accept(3).

The Status notice can be used by handlers of requests invoking protracted operations to provide periodic point-to-point status reports to the requester. Doing so has the nice side effect of identifying the handler to the requester, so that the requester can issue a Quit request if it wants to.

SEE ALSO

ttdt_message_accept(3), ttdt_subcontract_manage(3); Quit request.