Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

MAIN^XUMFI(): HL7 Master File Message Builder

Reference Type: Controlled Subscription, Category: Institution File, Integration Agreement: 2171

Description

This 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 Master File Notification (MFN), Master File Query (MFQ), and Master File Response (MFR) segments. 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

NOTE: For a description of the Input parameters for this API, please refer to the "MAIN^XUMFP: Master File Parameters" API.

Output Parameters and Output

NOTE: For a description of the Output Parameters and Output for this API, please refer to the "MAIN^XUMFP: Master File Parameters" API.

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) implements several new Application Programmer Interfaces (APIs). After the IFR patch has been installed and the Cleanup performed, the STATION NUMBER field (#99) will be a unique key to the INSTITUTION file (#4).

Example

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

From the HL7 MESSAGE TEXT file (#772), 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

 


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.