MPIQ(DFN) in MPIFAPI    ICR (2748)

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.