Print Page as PDF
Treating Facility List ICR (2990)

Treating Facility List    ICR (2990)

Name Value
NUMBER 2990
IA # 2990
DATE CREATED 1999/11/23
CUSTODIAL PACKAGE REGISTRATION
CUSTODIAL ISC Albany
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE VAFCTFU1
NAME Treating Facility List
GENERAL DESCRIPTION 
As part of the initative to share clinical information
among VA facilities, a VA facility will have information about patients that
were seen at other locations for health care.

This routine will return (given an Integration Control Number or a DFN) a list
of facilities the patient was seen for care.
STATUS Active
KEYWORDS VAFCTFU1
DURATION Till Otherwise Agreed
ID VAFCTFU1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT VARIABLES
$$QUERYTF(ICN,.ARRAY,INDX)
VARIABLES TYPE VARIABLES DESCRIPTION
ICN Input 
Patient Integration Control Number.
ARRAY Both 
This variable is an array variable that the function
uses to store the results of the treating facility list.

It will be in the structure of x(1), x(2), etc.
E.g., X(1)=500^2960101
Where the first peice is the IEN of the institution and the second piece is
the current date on record for that institution.
INDX Input 
The cross-reference to $O through.  'APAT' for
patient information linked to treating facilities, 'AEVN' for patient info
linked with an event reason.  INDX will equal one if 'AEVN' is used, else
'APAT' is used.
$$QUERYTF Output 

0 - If no error
1^error description - If error or no data in the array
TFL(.LIST,DFN)
VARIABLES TYPE VARIABLES DESCRIPTION
LIST Both 
LIST(1)=-1^error message Example error messages:
parameter missing, no treating facility, missing DFN, missing ICN, etc.  The
only time LIST(1) will always be defined is if there is an error; the first
piece will be a -1.

OR an array of treating facilities; they may or may not be VAMCs:
LIST(1)=500^ALBANY^3020513.092^3^VAMC LIST(2)=662^SAN
FRANCISCO^3020311.14^3^VAMC LIST(3)=200^AUSTIN^^^DPC

OR an array of treating facilities; may or may not be sequential:
LIST(2)=500^ALBANY^3020513.092^3^VAMC LIST(3)=662^SAN
FRANCISCO^3020311.14^3^VAMC
DFN Input 
DFN - required second input parameter equals the IEN
in the PATIENT (#2) file.