Print Page as PDF
CALLRPC MPIFDNL ICR (5270)

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
ID MPIFDNL
COMPONENT/ENTRY POINT
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 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