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

PARENT^XUAF4(): Parent Institution Lookup

Reference Type: Supported, Category: Institution File, Integration Agreement: 2171


This API returns a list of all institutions that make up a given Veterans Integrated Service Network (VISN), parent institution entered in the "lookup" input parameter.



Input Parameters


(required) $NAME reference to store the list of the parent (VISN) institution for the "lookup" input parameter institution.


(required) Parent (VISN) institution lookup value, any of the following:

  • Internal Entry Number (IEN), will have the ` in front of it.

  • Station Number

  • Station Name

(optional) Type of institution from the INSTITUTION ASSOCIATION TYPES file (#4.05, default is VISN).



Returns the array populated with the list of parent (VISN) institutions.

  Variable array

NOTE: With the business rule that institutions can only have one parent per type, if you specify the input parameter type, you will get an array that will only have one PIEN in it. If the type parameter is left blank, it finds all parents for the institution and lists then in the array.


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.