Print Page as PDF
MPIQ(DFN) in MPIFAPI ICR (2748)

MPIQ(DFN) in MPIFAPI    ICR (2748)

Name Value
NUMBER 2748
IA # 2748
DATE CREATED 1999/02/04
CUSTODIAL PACKAGE MASTER PATIENT INDEX VISTA
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE MPIFAPI
NAME MPIQ(DFN) in MPIFAPI
GENERAL DESCRIPTION 
MPI is providing support for the Registration package
to provide real-time queries to the MPI for assignment of an ICN and CMOR.  If
the MPI is not available, a local ICN will be assigned instead.  If the MPI
does not already know of this patient, the patient will be added and assigned
an ICN.

The call to accomplish this task is MPIQ^MPIFAPI(DFN), where DFN is the IEN of
the patient in the Patient file.  This code is to be inserted after all the
required data has been collected on a new patient (new to the Patient file
(#2)).  If the patient is already known, this code should be inserted after
the patient has been selected.  Interaction will only occur with the MPI if
the patient does not have an ICN assignment.

This API is NOT a silent one.  It can be made silent by setting the variable
MPIFS=1 prior to calling this API.  The variable shouldn't be new'd prior to
calling MPIQ^MPIFAPI but should be killed after the call has been made.

NOTE:  The following fields will be updated in the Patient file (#2) when a
successful interaction with the MPI has occurred: INTEGRATION CONTROL NUMBER
(#991.01), ICN CHECKSUM (#991.02), and CIRN MASTER OF RECORD (#991.03).

If the MPI was unavailable, in addition to the fields noted above, the LOCALLY
ASSIGNED ICN (#991.04) would be set to yes.
STATUS Active
ID MPIFAPI
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
MPIFQ 
MPIQ^MPIFAPI(DFN) is a procedure call that allows a
real-time connection with the MPI to request/query for an Integration Control
Number (ICN).  DFN is passed as the IEN for the patient in the Patient file
(#2).

the following is the suggested coding for this API:

N X S X="MPIFAPI" X ^%ZOSF("TEST") Q:'$T
D MPIQ^MPIFAPI(DFN)
K MPIFRTN

If the call should be silent, MPIFS should be set to 1 prior to calling
MPIQ^MPIFAPI and killed afterwards.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input 
DFN is the IEN of the patient in the Patient file
(#2).
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
REGISTRATION
MYHEALTHEVET
AUTOMATED MED INFO EXCHANGE 
RPC - DVBAB MPI ASSIGN ICN from CAPRI GUI -- a silent
call to the MPIQ entry point.