RPC HELP Deferred RPC Overview

From VistApedia
Jump to: navigation, search

RPC Broker Help Home

Overview of Deferred RPCs

Remote Procedure Calls can now be run in the background with XWB DEFERRED RPC.


USING XWB DEFERRED RPC

XWB DEFERRED RPC is used to pass the name of the RPC to be run in deferred mode and any parameters associated with the deferred RPC. In response to this RPC the VistA M Server returns a HANDLE to the user application. At this point other Broker calls can commence while the job runs in the background.

XWB DEFERRED STATUS allows the application to check the local VistA M Server for the presence of results from the deferred RPC. This RPC passes the HANDLE to the local server and receives back the status of the remote RPC.

XWB DEFERRED 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 returned by the deferred RPC.

XWB DEFERRED CLEAR must be used to clear the data under the HANDLE in the ^XTMP Global.

Applications using XWB DEFERRED RPC should use XWB DEFERRED CLEARALL on application close to clear all known data associated with the job on the VistA M Server.