MAIN^XUMFI(): HL7 Master File Message Builder

Reference Type: Controlled Subscription, Category: Institution File, ICR#: 2171

Description

The MAIN^XUMFI API implements an HL7 Master File Message Builder Interface that dynamically maps a VA FileMan field to an HL7 Master File sequence within a segment. The interface implements functionality to build the following segments:

• Master File Notification (MFN)
  
  
• Master File Query (MFQ)
  
  
• Master File Response (MFR)

The interface calls applicable VISTA HL7 GENERATE and GENACK interfaces to send/reply/broadcast an appropriate HL7 Master File message.

Format

     MAIN^XUMFI(ifn,ien,type,param,error)

Input Parameters

Output Parameters and Output

Details

This interface should be called after the Master File Parameter API. The Master File Parameter API sets up the required parameters in the PARAM array.

The Institution File Redesign (IFR) patch (i.e., XU*8.0*206) implemented several Application Programming Interfaces (APIs). After the IFR patch was installed and the cleanup performed, the STATION NUMBER (#99) field was a unique key to the INSTITUTION (#4) file.

Example

>D MAIN^XUMFI(4,18723,1,.PARAM,.ERROR)

From the HL7 MESSAGE TEXT (#772) file, you would see the following:

DATE/TIME ENTERED: JAN 12, 2001@09:17:29
 SERVER APPLICATION: XUMF MFN          TRANSMISSION TYPE: OUTGOING
 MESSAGE ID: 0259                      PARENT MESSAGE: JAN 12, 2001@09:17:29
 PRIORITY: DEFERRED                    RELATED EVENT PROTOCOL: XUMF MFN
 MESSAGE TYPE: SINGLE MESSAGE
MESSAGE TEXT:  
MFI^Z04^MFS^REP^20010112091729^20010112091729^NE
MFE^MUP^^19001011^631GD~STATION NUMBER~D
ZIN^GREENFIELD^631GD^National^CBOC~FACILITY TYPE~VA^^^MASSACHUSETTS^^^^^^
 STATUS: SUCCESSFULLY COMPLETED
 DATE/TIME PROCESSED: JAN 12, 2001@09:17:29
 NO. OF CHARACTERS IN MESSAGE: 161     NO. OF EVENTS IN MESSAGE: 1