dp_RDO

Syntax

dp_RDO rdoChan ?-events evtList? ?-onerror errScript? ?-callback callScript? rdoCmd ?args ...?

Comments

RDO is akin to an RPC except there is no return value. Since there is no return value, dp_RDO does not wait for a response and therefore there is no need for the timeout code that dp_RPC requires.

RDOs can be hard to debug because they generate no response at all, even if something catastrophic happens. Therefore, one can track errors by using errScript; the RDO sender's errorInfo will be set to the RDO executer's errorInfo and errScript will be called with the error message generated by the RDO as an argument.

In the same vein, callScript will be evaluted when the RDO has finished evaluting on the remote machine.

If both -onerror and -callback are specified, callScript will be called unless the RDO generated an error.

Examples

dp_RDO $myChan -events all puts stdout foobar
dp_RDO $myChan -onerror WhatError wackyProc