RPC HELP XWB REMOTE Options for Running RPCs on a Remote Server
Options For Running RPCs on a Remote Server
The RPC Broker can be used to facilitate invocation of Remote Procedure Calls on a remote VistA M Server. Applications can use either XWB DIRECT RPC or XWB REMOTE RPC to pass:
- The desired remote VistA M Server.
- The desired remote RPC.
- Any parameters for the remote RPC.
The RPC Broker on the local VistA M Server uses VistA HL7 as a vehicle to pass the remote RPC name and parameters to the remote VistA M Server. VistA HL7 is used to send any results from the remote server back to the local server. The RPC Broker on the local VistA M Server then passes the results back to the client application.
NOTE: The local VistA M Server is the server the user is logged into. The remote VistA M Server is any server the user is not logged into.
USING XWB DIRECT RPC
XWB DIRECT RPC blocks all other Broker calls until the results of the remote RPC are returned. The data is passed and the user waits for the results to return from the remote system.
USING XWB REMOTE RPC
XWB REMOTE RPC is set up to allow other activity while the remote RPC is in process. In response to XWB REMOTE RPC the local VistA M Server returns a HANDLE to the user application. At this point other Broker calls may commence while the server-to-server communication continues in the background.
XWB REMOTE STATUS CHECK allows the application to check the local VistA M Server for the presence of results from the remote RPC. This RPC passes the HANDLE to the local server and receives back the status of the remote RPC.
XWB REMOTE GETDATA is the vehicle for retrieving the results from the remote RPC after the status check indicates that the data has returned to the local VistA M Server. The RPC passes the HANDLE and receives back an array with whatever data has been sent back from the remote site.
XWB REMOTE CLEAR must be used to clear the data under the HANDLE in the ^XTMP Global.
Applications using XWB REMOTE XWB should use XWB DEFERRED CLEARALL on application close to clear all known data associated with the job on the VistA M Server.
NOTE: XWB DIRECT RPC and XWB REMOTE RPC are available only on a controlled subscription basis.
