Kdtop: Created page with " RPC Broker Help Home

XWB REMOTE RPC

Example Use this RPC to request that an RPC be run on a remote system. T..."

2015-07-06T23:10:33Z

Created page with " RPC Broker Help Home <h2>XWB REMOTE RPC</h2> Example Use this RPC to request that an RPC be run on a remote system. T..."

New page

[[RPC_Broker_Help| RPC Broker Help Home]]
<h2>XWB REMOTE RPC</h2>
[[RPC_HELP_XWB_REMOTE_RPC_Example|Example]]

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 [[RPC_HELP_XWB_DIRECT_RPC|XWB DIRECT RPC]] to block all other Broker activity while the remote RPC runs. See [[RPC_HELP_XWB_REMOTE_Options_for_Running_RPCs_on_a_Remote_Server|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 [[RPC_HELP_XWB_DEFERRED_HANDLE|HANDLE]] that is used to check status and retrieve data. The following RPCs must be used to complete the transaction
* [[RPC_HELP_XWB_REMOTE_STATUS CHECK|XWB REMOTE STATUS CHECK]]
* [[RPC_HELP_XWB_REMOTE_GETDATA|XWB REMOTE GETDATA]]
* [[RPC_HELP_XWB_REMOTE_CLEAR|XWB REMOTE CLEAR]]

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

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

'''RPC VERSION PARAMETER''' (Optional): Pass minimum version of RPC to be run in [[RPC_HELP_TRPCBroker_Param|Param]][2].[[RPC_HELP_TParamRecord_Value_Property|Value]], and the type (literal) in [[RPC_HELP_TRPCBroker_Param|Param]][2].[[RPC_HELP_TParamRecord_PType_Property|PType]]. It will be checked against the value in the [[RPC_HELP_M_Entry_In_RP_File_RPC_Version|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 [[RPC_HELP_TRPCBroker_Param|Param]][3] through [[RPC_HELP_TRPCBroker_Param|Param]][9].

'''RETURN VALUE''': An array. The first node is equal to a string that serves as a [[RPC_HELP_XWB_DEFERRED_HANDLE|HANDLE]]. This [[RPC_HELP_XWB_DEFERRED_HANDLE|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.

RPC HELP XWB REMOTE RPC - Revision history

Kdtop: Created page with " RPC Broker Help Home

XWB REMOTE RPC