Pats 0 Systems Management Guide

4.7 VistA Integration Agreements

4.7.1 Supported

Integration Agreement	Description
2171 – Routine XUAF4	LKUP^XUAF4 is used to retrieve the station IEN from file 4, from the station number portion of the ROC number. PARENT^XUAF4 is used to retrieve the VISN name and STA^XUAF4 to return the parent station number, based on the station in the QAC SITE PARAMTERS file 740. (Used in routines ^QACI1* and ^QACI2*, data migration from Patient Rep into PATS. Also Used in ^QACVEMPX, called by the RPC "QACV KEY HOLDERS VLH". In both cases, used to find the station number for the VistA server in order to build the KAAJEE user key for the pats_user table).
2701 – Routine MPIF001	$$GETICN^MPIF001 is used to retrieve the Integration Control Number of patients. This is used when migrating legacy data into PATS (routine QACI2B).
2918 – $$PRIORITY^DGENA	See 2462 in Section 4.7.2 for details.
3065 – Routine XLFNAME	$$HLNAME^XLFNAME is used to return the name components from the PATIENT file during data migration to load data into the pats_patient table (routine ^QACI2B). It is also used to retrieve the name components from the NEW PERSON file while entering or editing the Employee Involved or Information Taker data on a Report of Contact (routine ^QACVEMPX called by both the RPC "QACV PERSON LOOKUP VLH" and “QACV KEY HOLDERS VLH”) and during data migration to load data into the pats_user table (routine ^QACI2B).
3799 – Routine DGUTL4	$$INACTIVE is used to determine whether a Patient’s Race or Ethnicity code are currently inactive. We use $$PTR2CODE to use the pointer value for a patient’s race to retrieve the HL7 VALUE field, and the pointer value for a patient’s ethnicity to retrieve the ABBREVIATION field. A Standard Data Services programmer suggested that these two fields should be used to match a race or ethnicity in the VistA files against the std_race and std_ethnicity tables that are part of the Standard Data Service. (Used in routine QACVDEM that returns patient demographics for data migration from Patient Rep to PATS.)

Integration Agreement	Description
10060 – Access fields in NEW PERSON file (200)	LIST^DIC and GETS^DIQ is used on file 200 to retrieve field .01 NAME, 8 TITLE and 28 MAIL CODE. This is done when retrieving Employee Involved data or Information Taker data while entering or editing a Report of contact (routine ^QACVEMPX called by both the RPC "QACV PERSON LOOKUP VLH" and “QACV KEY HOLDERS VLH”, and during data migration to load data into the pats_user table (routine ^QACI2B). We also use FIND^DIC with the "AB" index (on the KEYS multiple) to return a list of users who own one or more keys (Used in ^QACVKHLD, which is called by ^QACVEMPX, called by the RPC "QACV KEY HOLDERS VLH").
10061 – Routine VADPT	Calls DEM^VADPT and ELIG^VADPT are used to retrieve patient demographics and eligibility data. This is done during data migration to load data into the pats_patient table (routine ^QACI2B).

4.7.2 Controlled Subscription

Integration Agreement	Description
1518 – KERNEL SITE PARAMETERS file (8989.3) DEFAULT INSTITUTION field (217)	$$GET1^DIQ is used to return the pointer to the INSTITUTION file from the DEFAULT INSTITUTION file. PATS (Patient Rep) was added to the list of subscribers on 12/05/2003. (This is used in ^QACVEMPX, called by the RPC "QACV KEY HOLDERS VLH", and in data migration code ^QACI2. In both cases, it is used to find the station number for the VistA server in order to build the KAAJEE user key for the pats_user table).
2462 – Access to PATIENT ENROLLMENT file 27.11	(See also 2918 in the list of supported calls above) The supported call $$PRIORITY^DGENA is used to retrieve the internal value of the users Enrollment Priority (a set of codes) based on the patient’s current enrollment. Then, we use a FileMan call $$EXTERNAL^DILFD to find the external value of the Enrollment Priority from the DD (File 27.11, field .07). (Used from routine ^QACVDEM). We are displaying this to users of the PATS system along with other patient data related to a patient complaint or compliment. This call is used during data migration of legacy Patient Rep data into PATS.
2689 – Reference to ALERT file 8992	We look in ^XTV(8992,"AXQAN" to find all entries that begin with "QAC-". From these entries, we extract the "sent to" and "date sent" from the cross-reference, then we use the 0 node of the ALERT DATE/TIME multiple, based on the date sent, in order to get the "sent from" person. For both the "sent to" and "sent from" persons, we’re getting the .01 field from the NEW PERSON file. PATS (Patient Rep) was added as a subscriber in April, 2004. (Used during data migration to create a report of outstanding notifications, routine ^QACI5).