DitsGetPath - Gets a path to a task.

Function

Gets a path to a task.

Description

Initiates a Get Path operation to the specified task. We have to initiate a transaction to get the path, the action which invoked this command will be rescheduled when the response occurs and the id of the transaction initiated is returned.

Call

DitsGetPath taskname [options]

Parameters

>	taskname	string	The name of the task to get a path too. You can specify the node using the task@node format or using the -node option.

Options

-node node: Specify the node the task is on.
-buffers buf_sizes: Specify a list of 4 integers being the buffer sizes to use. These will default to the values specified by the Dtcl global buffer variables (MessageBytes/MaxMessages/ReplyBytes/MaxReplies)
-wait: Wait for the operation to complete, using DitsActionWait to block this action. In this case there is no outstanding transaction id on return so null is returned.
-waittimeout timeout: If -wait is specified, a timeout to be applied to the wait. Floating point seconds.
-flowcontrol: Enable flow control on this connection.

Return value

Transaction id.

Language

Tcl

Prior requirements

Can only be invoked by Tcl commands executing in the context of a DRAMA action. Otherwise the obey/kick/pget/pset/control/monitor/ TaskRunning commands should be used.

Support

Tony Farrell, AAO

Click here for the DRAMA home page and here for the AAO home page.

For more information, contact tjf@aaoepp.aao.gov.au