ADD^VAFCPTAD(RETURN,PARAM) allows Master Patient Index to add
a patient to the local VistA PATIENT (#2) file, passing the
data known in the PARAM array. The data may include the
following fields: (R - required; O - optional)
R .01 NAME
R .02 SEX
R .03 DATE OF BIRTH
R .09 SOCIAL SECURITY NUMBER
.0906 PSEUDO SSN REASON (if SSN is passed in as
null, the .0906 value is automatically set
to SSN UNKNOWN/FOLLOW-UP REQUIRED)
O .092 PLACE OF BIRTH [CITY]
O .093 PLACE OF BIRTH [STATE]
O .2403 MOTHER'S MAIDEN NAME
R .301 SERVICE CONNECTED?
R 27.02 PREFERRED FACILITY
R 391 TYPE
R 1901 VETERAN (Y/N)?
R 991.01 INTEGRATION CONTROL NUMBER
R 991.02 ICN CHECKSUM
O 1 ALIAS
The list will be passed with the following variable names
and values. Some values are specified in the VHA Standard
Data Service tables. Most input values are checked on VistA
(using CHK^DIE) to ensure that the required fields will
pass the input transform for that field. The SERVICE
CONNECTED? (#.301) and VETERAN Y/N? (#1901) fields do not
call CHK^DIE, as the input transform is expecting the DFN
variable which is not yet defined. If a required field
fails the CHK^DIE call, the entry is not created. In that
case, the RPC returns an error message to the MPI indicating
why the call failed. If all fields pass the CHK^DIE call,
then FILE^DICN is called to create the entry in the PATIENT
PARAM("PRFCLTY")= Preferred Facility Station number.
Station Number from the Institution List
in the VHA Standard Data Service table.
Facility Type must be VA MEDICAL CENTER.
PARAM("NAME")= Last Name^First Name^Middle Name^Suffix
input is converted to: Last Name<comma>
First Name<space>Middle Name<space>Suffix
PARAM("GENDER")= Code from the Gender List in the VHA
Standard Data Service table: M for MALE
OR F for FEMALE
2 digit MONTH followed by "/" delimiter
followed by 2 digit DAY followed by "/"
delimiter followed by 4 digit YEAR.
Month and/or day alone, without year
is not allowed.
PARAM("SSN")= nine numbers / no dashes, OR a NULL value.
If SSN is sent with a null value, then on
VistA, the patient is given a PSEUDO SSN
number and the PSEUDO SSN REASON field is
automatically set to SSN UNKNOWN/FOLLOW-UP
PARAM("SRVCNCTD")= SERVICE CONNECTED? Y for YES OR N
PARAM("TYPE")= Patient TYPE. Code from the Patient Type
List in the VHA Standard Data Service
1 for ACTIVE DUTY,
2 for ALLIED VETERAN,
3 for COLLATERAL,
4 for EMPLOYEE,
5 for MILITARY RETIREE,
6 for NON-VETERAN (OTHER),
7 for NSC VETERAN,
8 for SC VETERAN, OR
9 for TRICARE.
PARAM("VET")= VETERAN YES/NO? Y for YES OR N for NO.
PARAM("FULLICN")= A 10 digit NUMBER, followed by V
(delimiter), followed by a 6 digit
PARAM("POBCTY")= PLACE OF BIRTH [CITY].
PARAM("POBST")= 2 character STATE ABBREVIATION.
PARAM("MMN")= MOTHER'S MAIDEN NAME.
PARAM("ALIAS",#)= ALIAS NAME
The IEN of the entry created in the PATIENT (#2) file
PARAM - is a list of the values passed in. This
data is used to create the patient in the PATIENT
DFN (if successful)
DFN is returned as the IEN of the PATIENT (#2)
file entry that was created in the session.
ERROR TEXT (if unsuccessful)