RPC HELP XWB DIRECT RPC

From VistApedia
Jump to: navigation, search

RPC Broker Help Home

XWB DIRECT RPC

Example

Use this RPC to request that an RPC be run on a remote system. This RPC blocks all other Broker calls until the results of the remote RPC are returned. Use XWB REMOTE RPC to allow other Broker activity while the remote RPC runs. See Options for Running RPCs on a Remote Server for a comparison of the two methods.

LOCATION PARAMETER: Pass the station number of the remote VistA M Server in Param[0].Value, and the type (literal) in Param[0].PType.

RPC PARAMETER: Pass the name of the RPC to be run in Param[1].Value, and the type (literal) in Param[1].PType.

RPC VERSION PARAMETER (Optional): Pass minimum version of RPC to be run in Param[2].Value, and the type (literal) in Param[2].PType. It will be checked against the value in the RPC Version in the Remote Procedure File on the remote VistA M Server.

PARAMETERS TO THE REMOTE RPC: Pass up to seven parameters for the remote RPC in Param[3] through Param[9].

RETURN VALUE: An array with whatever data has been sent back from the remote site. In the case of an error condition the first node of the array is equal to a string with the syntax "-1^error text".

NOTE: XWB DIRECT RPC is available only on a controlled subscription basis.