Print Page as PDF
DIRECT RPC CALL ICR (3144)

DIRECT RPC CALL    ICR (3144)

Name Value
NUMBER 3144
IA # 3144
DATE CREATED 2000/10/27
CUSTODIAL PACKAGE RPC BROKER
CUSTODIAL ISC San Francisco
USAGE Controlled Subscription
TYPE Routine
ROUTINE XWB2HL7
NAME DIRECT RPC CALL
GENERAL DESCRIPTION
This call is to make a RPC call on a remote facility.
Users of this API should be prepared to modifiy their calls to support support
strong authentication when made available by Infrastructure.
STATUS Active
DURATION Till Otherwise Agreed
ID XWB2HL7
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
DIRECT(RET,LOC,RPC,RPCVER,P1,P2,P3,P4,P5,P6,P7,P8,P9,P10)
Use of the DIRECT connect whether it is done through
DIRECT^XWB2HL7 or with DIRECT^HLMA is susceptible to encountering network
errors.  This was first noticed with the Institution File Redesign patch and
the Integrated Billing patch(RX Copay).  Susequently, HL7 issued patches
HL*1.6*76 and HL*1.6*77 to address these network errors and return the status
of failure back to the calling application.  With the DIRECT connect, VistA
HL7 only tries to send the message once.  If it encounters an network error
while attepting to send a message, it does not attempt to resend.

When using this API, you should check the returned value of subscript zero of
the first parameter.  This parameter is passed by reference.  For example, if
you made a call like D DIRECT^XWB2HL7(.MYRET,...

You should check the value of MYRET(0).  If there was a problem with sending
the message or receiving a response, MYRET(0) will have a value of -1^error
message

The -1 is both MYRET and MYRET(0), so one can use:

I $P(MYRET(0),"^")=-1!(-1=+MYRET) S ERROR=1 Q

See code below:


DIRECT(RET,LOC,RPC,RPCVER,P1,P2,P3,P4,P5,P6,P7,P8,P9,P10)        ;Call a
remote


RPC

N X,I,INX,N,XWBHL7,XWBPAR,XWBPCNT,XWBDVER,XWBESSO,XWBHDL,PMAX

N XWBMSG,XWBSEC,RPCIEN

;Protect caller from HL7

N HLMTIEN,HLDOM,HLECH,HLFS,HLINSTN,HLNEXT,HLNODE,HLPARAM,HLQ,HLQUIT

D SETUP(1) I $G(RET(1))'="" Q

;(procedurename, query tag, error return, destination, Parameter
array)

D DIRECT^XWB2HL7A("ZREMOTE RPC",XWBHDL,.XWBMSG,LOC,.XWBPAR)

I $P(XWBMSG,U,2) S RET(0)="-1^"_$P(XWBMSG,"^",3) Q

I 'HLMTIEN S RET(0)="-1^No Message returned" Q

D RETURN,RTNDATA^XWBDRPC(.RET,XWBHDL)

Q
VARIABLES TYPE VARIABLES DESCRIPTION
RET Output
This is the return value.
LOC Input
This is the Institution name or VISN name or ien of
where to send the RPC call to.
RPC Input
This is the name of the RPC to run on the remote
system.
RPCVER Input
version number in Remote Procedure file. (optional)
P1 Input
1st RPC paramater on remote system.
P2 Input
2nd RPC paramater on remote system.
P3 Input
3rd RPC paramater on remote system.
P4 Input
4th RPC paramater on remote system.
P5 Input
5th RPC paramater on remote system.
P6 Input
6th RPC paramater on remote system.
P7 Input
7th RPC paramater on remote system.
P8 Input
8th RPC paramater on remote system.
P9 Input
9th RPC paramater on remote system.
P10 Input
10th RPC paramater on remote system.
EN1(RET,LOC,RPC,RPCVER,P1,P2,P3,P4,P5,P6,P7,P8,P9,P10)
This entry point is used by CPRS Remote Data Views.
It places the HL7 message into the HL7 message queue for deferred transfer.
See the DIRECT entry for parameter descriptions.  The return from this call is
a HANDLE that is used in the follow-up calls.
VARIABLES TYPE VARIABLES DESCRIPTION
RET Output
This variable is passed by reference.  If RET(0) is
empty, then RET(1) will have some error text.  Otherwise RET(0) will have the
HANDLE that is used in follow-up calls.
RPCCHK(RET,HDL)
This entry point is used after a call to EN1^XWB2HL7
to check the status of the call.  When it returns "1^Done" a call can be made
to RTNDATA^XWBDRPC to get the data.  When it returns "-1^text" there is a
problem with the call.
VARIABLES TYPE VARIABLES DESCRIPTION
HDL Input
This is the Handle that was returned from the
EN1^XWB2HL7 call.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
INTEGRATED BILLING
Integrated Billing is to call ONLY IB RPCs to view
patient data and to send insurance data between VA sites.
REGISTRATION
For use with the Smart Card.
MASTER PATIENT INDEX
MPI is to call ONLY its own RPCs, with the following
exceptions allowed:

MPIF ACK CHECK
MPIF EXP PDAT REMOTE
MPIF INACTIVATE
MPIF REMOTE SPI
MPIF REMOTE ICN UPDATE
MPIF CHANGE CMOR
RG REM ACTIVITY
RG REMOTE HL7 TASK
MPIF SSN DUPS
CONSULT/REQUEST TRACKING
Consult/Request Tracking is to call ONLY its own RPCs.
CLINICAL INFO RESOURCE NETWORK
CIRN is to call ONLY its own RPCs.
MASTER PATIENT INDEX VISTA
Master Patient Index VistA is to call ONLY its own
RPCs.
CORBA SERVICES
INCOME VERIFICATION MATCH
BENEFICIARY TRAVEL
DBA Comments
1/18/13-MM:  Added Beneficiary Travel as a subscriber.
Associated patch is DGBT*1.0*20.  Bene Travel RPC is DGBT CLAIM DEDUCTIBLE
PAID and will be using HL7 to access the RPC.  Justification from developer:
"They will be using them to access Beneficiary Claim Information at any site
the patient has been to in the current month. A single array node is being
returned with number of trips, amount of deductible paid, if any etc."

5/12/15-DT: Added Shavkat as editor and deactivated ICR for changes

5/28/15-MM:  Updated the Subscribing Package details for Integrated Billing to
include the additional text as requested by the developer for IB*2.0*528.
Subscribing Package details for IB now reads as:

Integrated Billing is to call ONLY IB RPCs to view patient data and to send
insurance data between VA sites.

Developer provided the following reason for the ICR update:

Our intent is to update each VistA system (where one of the divisions/stations
on that VistA system has seen the patient).    We are using the originating
Treating Facilities to determine where the patient had other visits in order
to send update patient insurance information to those facilities.

Removed Shavkat as an editor.
MAIL MESSAGE 33227631
DATE/TIME EDITED
DATE/TIME EDITED ACTION AT THE REQUEST OF WITH CONCURRENCE OF
2007/01/24 00:08 SUBSCRIBER ADDED HARTLEY,PETER FORT,WALLY
2007/01/24 00:14 SUBSCRIBER ADDED HARTLEY,PETER FORT,WALLY
2013/01/18 16:50 SUBSCRIBER ADDED DELLINGER,BARRY WESTRA,HERLAN
2015/05/12 16:26 DEACTIVATED FOR EDITS SHAMUKHAMEDOV,SHAVKAT
2015/05/28 17:28 CONTENT CORRECTED SHAMUKHAMEDOV,SHAVKAT WESTRA,HERLAN
Generated from AUG 12, 2020@ IA Listing Descriptions