CALLRPC MPIFDNL ICR (5270)

Name

Value

NUMBER

5270

IA #

5270

DATE CREATED

2008/10/09

CUSTODIAL PACKAGE

MASTER PATIENT INDEX VISTA

USAGE

Private

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

MPIFDNL

NAME

CALLRPC MPIFDNL

GENERAL DESCRIPTION

CALLRPC^MPIFDNL calls Remote Procedure MPIF DNL ADD UPD
to add a record with a pair of patient DFNs to the MPI DO NOT LINK file on the
MPI Server.  This file is used to prevent users from attempting to LINK
patients who have been determined to not be duplicates.

DNLCHK^MPIFDNL calls Remote Procedure MPI EVENT LIST, which returns (among
other things) a list of DFNs for those patients that are marked as "Do Not
Link" with the passed in DFN. From this list, DNLCHK^MPIFDNL determines
whether to allow the selected pair of patients to be added to the DUPLICATE
RESOLUTION file.

STATUS

Active

KEYWORDS

MPIFDNL
DUPLICATE
RESOLUTION
MPI DO NOT LINK
DO NOT LINK
XDRDEDT
XDRDPICK
MPIF DNL ADD UPD

DURATION

Till Otherwise Agreed

MPIFDNL

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

CALLRPC

D
CALLRPC^MPIFDNL(DUZ,DUZ(2),DFN1,DFN2,INACTIVATION_FLAG)

If an error occurs, it is logged to the CIRN HL7 EXCEPTION LOG file (#991.1)

VARIABLES	TYPE	VARIABLES DESCRIPTION
MPIFDUZ	Input	1) DUZ of current user (REQUIRED)
MPIFSITE	Input	2) Station IEN (from file #4 INSTITUTION) of the current users institution (from DUZ(2)) - REQUIRED.
MPIFFR	Input	3) IEN (DFN) of first patient from file #2 PATIENT at the VistA site (REQUIRED).
MPIFTO	Input	4) IEN (DFN) of second patient from file #2 PATIENT at the VistA site (REQUIRED).
MPIFINAC	Input	5) If set to 1, entry in MPI DO NOT LINK file will be inactivated (OPTIONAL).

DNLCHK

Checks whether patient records with DFNs MPIFREC1 and
MPIFREC2 are verified as not duplicates in the MPI DO NOT LINK file. Returns 0
if the there were no problems making the Remote Procedure call and the pair is
not in the MPI DO NOT LINK file; otherwise, returns -1^error message.

VARIABLES	TYPE	VARIABLES DESCRIPTION
MPIFREC1	Input	1) DFN of a record in the Patient file.
MPIFREC2	Input	2) DFN of another record in the Patient file.

SUBSCRIBING PACKAGE

SUBSCRIBING DETAILS

TOOLKIT

When a user sets the status of a pair of patients in
the DUPLICATE RECORD file to VERIFIED, NOT A DUPLICATE, CALLRPC^MPIRPC is
called to add the patient pair record to the MPI DO NOT LINK file. (routine
^XDRDPICK)

When a user resets the status of a pair of patients in the DUPLICATE RECORD
file from VERIFIED, NOT A DUPLICATE back to POTENTIAL DUPLICATE, UNVERIFIED,
CALLRPC^MPIRPC is called to set the status on the record in the MPI DO NOT
LINK file to INACTIVE. (routine ^XDRDEDT)

When a user attempts to add a pair of patients to the DUPLICATE RECORD file
via the "Add Verified Duplicate Pair" option [XDR ADD VERIFIED DUPS], routine
^XDRMADD calls DNLCHK^MPIFDNL, which makes a direct RPC call to check that the
selected pair does not exist on the MPI DO NO LINK file (#985.28). (routine
^XDRMADD)

DATE ACTIVATED

2010/08/04