| GENERAL DESCRIPTION |
This DBIA describes the Broker RPCs that provide the
capability of running any application RPC on a remote system. They were
developed to support the CPRS Remote Data Views project.
NOTE: This 'Server to Server RPC' functionality is currently limited to sites
that have implemented CIRN. CIRN makes it possible for an application to know
a patient's current list of treating facilities. Furthermore, CIRN has
assumed responsibility for supervising the proper configuration and activation
of the VA network nodes that will be used for HL7 message exchange.
XWB REMOTE RPC
This is the RPC that is called to request that an application RPC
be run on a remote system. The data is passed by HL7 to the remote system
as is the return value.
This RPC will return a HANDLE that can be used to check if the data has
been sent back from the remote system. The HANDLE can be used in another
RPC to check the status of the RPC.
Parameters:
(location<station #>,rpc name,[rpc version],[1 to 10 params to the RPC))
Return:
The return value is always an array. The first node of the array is equal to
a string that serves as a HANDLE. This is used to check the status of a RPC
request and to retrieve the results of the RPC.
In the case of an error condition, the first node of the array is equal to a
string with the syntax "-1^error text".
XWB REMOTE STATUS CHECK
This RPC will return the status of a remote RPC.
Parameters:
The HANDLE from the XWB REMOTE RPC.
Return:
The return value is always an array. The first node of the array is
equal to one of the following values:
"-1^Bad Handle" - An invalid handle has been passed.
"0^New" - The request has been sent.
"0^Running" - HL7 indicates that the message is being processed.
"1^Done" - RPC has completed and the data has returned to the local
server. The data is not returned by this RPC. Use the XWB REMOTE
GETDATA RPC to retrieve the data.
The second node of the array is the status from the HL7 package.
XWB REMOTE GETDATA
This RPC will return an ARRAY with what ever data has been sent back from
the remote site.
Parameters:
The HANDLE from the XWB REMOTE RPC. It is used to link the call to the
data.
Return:
The return value is the array of data. In the event of an error condition,
the first node of the array is equal to a string with the syntax "-1^error
text".
XWB REMOTE CLEAR
This RPC is used to CLEAR the data under the HANDLE in the ^XTMP global.
Parameters:
The HANDLE from the XWB REMOTE RPC.
Return:
The return value is always an array. The first node of the array is equal to
1
|