RPC HELP XWB REMOTE RPC
XWB REMOTE RPC
Use this RPC to request that an RPC be run on a remote system. This RPC allows other Broker activity while the remote RPC runs. Use XWB DIRECT RPC to block all other Broker activity while the remote RPC runs. See Options for Running RPCs on a Remote Server for a comparison of the two methods.
XWB REMOTE RPC requests the remote RPC. The return value is a HANDLE that is used to check status and retrieve data. The following RPCs must be used to complete the transaction
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 VERSION field of 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. The first node is equal to a string that serves as a HANDLE. This HANDLE should be stored by the application and used to check the status and retrieve the data. 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 REMOTE RPC is available only on a controlled subscription basis.
