Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Info |  Desc |  Directly Accessed By Routines |  Pointer To FileMan Files |  Fields |  External References |  Global Variables Directly Accessed |  Local Variables  | All
Print Page as PDF
Global: ^ECX(727.808

Package: DSS Extracts

Global: ^ECX(727.808


Information

FileMan FileNo FileMan Filename Package
727.808 PHYSICAL MOVEMENT EXTRACT DSS Extracts

Description

Directly Accessed By Routines, Total: 5

Package Total Routines
DSS Extracts 5 ^ECX(727.808    ECX8082    ^ECX(729    ECX8081    ECXAMOV    

Pointer To FileMan Files, Total: 7

Package Total FileMan Files
Registration 4 MEDICAL CENTER DIVISION(#40.8)[3]    MAS MOVEMENT TYPE(#405.2)[18]    PATIENT MOVEMENT(#405)[12]    PATIENT(#2)[4]    
Scheduling 2 HOSPITAL LOCATION(#44)[14, 20]    TEAM(#404.51)[30]    
DSS Extracts 1 DSS EXTRACT LOG(#727)[2]    

Fields, Total: 42

Field # Name Loc Type Details
.01 SEQUENCE NUMBER 0;1 NUMBER
************************REQUIRED FIELD************************

  • INPUT TRANSFORM:  K:+X'=X!(X>999999999)!(X<1)!(X?.E1"."1N.N) X S:$D(X) DINUM=X
  • LAST EDITED:  AUG 12, 1998
  • HELP-PROMPT:  Enter a number between 1 and 999999999, 0 decimal digits.
  • DESCRIPTION:  
    The record number for this extract entry.
  • TECHNICAL DESCR:  
    The internal entry number (IEN) for this record. This entry is DINUMed.
  • NOTES:  XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
1 YEAR MONTH 0;2 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>6!($L(X)<6)!'(X?6N) X
  • OUTPUT TRANSFORM:  S Y=$$ECXYMX^ECXUTL(Y)
  • LAST EDITED:  SEP 24, 1997
  • HELP-PROMPT:  Answer must be 6 characters in length.
  • DESCRIPTION:  
    A six character string representing the year and the month for which this extract was performed.
  • TECHNICAL DESCR:  YEAR MONTH is derived by parsing the fileman format end date of the extract. The month is determined by taking the 4th and 5th characters of the end date, the year by taking the 2nd and 3rd characters, and the century is
    then calculated by taking the 1st character of the end date, and adding 17 to it. The Century is then concatenated with the year and month, giving the results in YYYYMM format.
2 EXTRACT NUMBER 0;3 POINTER TO DSS EXTRACT LOG FILE (#727) DSS EXTRACT LOG(#727)

  • LAST EDITED:  SEP 10, 1996
  • HELP-PROMPT:  Enter the extract number for this extract.
  • DESCRIPTION:  
    The corresponding entry in the DSS EXTRACT LOG file (#727) for this extract.
  • TECHNICAL DESCR:  
    A pointer to the DSS EXTRACT LOG file (#727). The primary purpose is to pick up the header for the mail message.
  • CROSS-REFERENCE:  727.808^AC
    1)= S ^ECX(727.808,"AC",$E(X,1,30),DA)=""
    2)= K ^ECX(727.808,"AC",$E(X,1,30),DA)
    3)= DO NOT DELETE.
    This cross reference is essential for managing and purging data in this file.
3 FACILITY 0;4 POINTER TO MEDICAL CENTER DIVISION FILE (#40.8) MEDICAL CENTER DIVISION(#40.8)

  • LAST EDITED:  MAY 29, 2012
  • HELP-PROMPT:  Enter the medical center division associated with this movement.
  • DESCRIPTION:  
    This is the facility/division where the extract was performed.
  • TECHNICAL DESCR:  
    An indicator of the division where this event happened. It is derived from the DIVISION field (#.015) of the WARD LOCATION file (#42) which points to the MEDICAL CENTER DIVISION file (#40.8).
4 PATIENT NO. - DFN 0;5 POINTER TO PATIENT FILE (#2) PATIENT(#2)

  • LAST EDITED:  OCT 14, 1996
  • HELP-PROMPT:  Enter the name of the patient for this extract record.
  • DESCRIPTION:  
    An identifying number for the patient at the local site.
  • TECHNICAL DESCR:  
    Pointer to the PATIENT file (#2). This data represents the patient DFN. Using the "ATT2" or "ATT3" cross reference on the PATIENT MOVEMENT file (#405), the PATIENT NO. - DFN data is derived from the PATIENT field (.03).
5 SSN 0;6 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>10!($L(X)<9)!'(X?9N!X?9N1"P") X
  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Your answer must be 9 to 10 characters in length.
  • DESCRIPTION:  
    The patient's social security number.
  • TECHNICAL DESCR:  Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the PHYSICAL MOVEMENT EXTRACT file (#727.808), SSN data is derived from the SOCIAL SECURITY NUMBER field (#.09) in the PATIENT file (#2).
    "Test" patient status is determined in PAT^ECXUTL3. Any patient with an SSN beginning with "00000" will not be included in the extract.
6 NAME 0;7 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>4!($L(X)<4) X
  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Your answer must be 4 characters in length.
  • DESCRIPTION:  
    The first four characters of the patient's last name.
  • TECHNICAL DESCR:  Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the PHYSICAL MOVEMENT EXTRACT file (#727.808), NAME data is derived from the NAME field (#.01) in the PATIENT file (#2). The first four
    characters of the first "," piece are used, padded with trailing spaces if necessary.
    The name value is returned by the supported call DEM^VADPT.
7 IN OUT PATIENT INDICATOR 0;8 SET
  • 'I' FOR INPATIENT;
  • 'O' FOR OUTPATIENT;
  • 'A' FOR ASIH (OTHER FACILITY);

  • LAST EDITED:  JUN 26, 2018
  • HELP-PROMPT:  Enter the patient's status for this extract entry.
  • DESCRIPTION:  
    Indicates the patient's status for this extract entry.
  • TECHNICAL DESCR:  To determine the value of this field a call is made to $$PATDEM^ECXUTL2. Within this call, $$INP^ECXUTL2 is called to determine patient status. If the patient is an outpatient, processing stops and the field is set to O.
    If the patient is an inpatient then $$INOUTP^ECXUTL4 is called to look at the treating specialty. If the patient's treating specialty exists in the DSS TREATING SPECIALTY TRANSLATION file (#727.831) then the value of the
    INPAT/OUTPAT CODE field (#5) of the DSS TREATING SPECIALTY TRANSLATION file (#727.831) is used. If the treating specialty is not found in the DSS TREATING SPECIALTY TRANSLATION file (#727.831) then the indicator is set to
    I.
    If the patient is ASIH to another facility at the date/time in question then the indicator is set to A.
8 DAY 0;9 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>8!($L(X)<8) X
  • OUTPUT TRANSFORM:  S Y=$$ECXDATEX^ECXUTL(Y)
  • LAST EDITED:  SEP 24, 1997
  • HELP-PROMPT:  Answer must be 8 characters in length.
  • DESCRIPTION:  
    This 8-character numeric string represents the date of the physical movement.
  • TECHNICAL DESCR:  Data source:
    PATIENT MOVEMENT file (#405); DATE/TIME field (#.01)
    This field is always exactly 8 numeric characters in length. The format is YYYYMMDD; for example, 19970923. If the date cannot be determined, then a default is used. The default date value is the value of the YEAR MONTH
    field (#1) concatenated with "01" for the day (DD) portion. Year 2000 compliant per vendor.
9 PRODUCT 0;10 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>1!($L(X)<1) X
  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Your answer must be 1 character in length.
  • DESCRIPTION:  
    The product or feeder key for this extract as defined by the DSS Program Office.
  • TECHNICAL DESCR:  
    For the Physical Movement extract, the PRODUCT field is null.
10 ADMISSION DATE 0;11 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>8!($L(X)<8) X
    MAXIMUM LENGTH: 8
  • OUTPUT TRANSFORM:  S Y=$$ECXDATEX^ECXUTL(Y)
  • LAST EDITED:  AUG 22, 2018
  • HELP-PROMPT:  Answer must be 8 characters in length (YYYYMMDD).
  • DESCRIPTION:  
    This 8-character string represents the date on which the admission associated with this physical movement occurred.
  • TECHNICAL DESCR:  A call is made to $$INP^ECXUTL2 using the patient's DFN and the date/time of the patient movement (transfer or discharge). The call will return the admission date/time associated with this episode of care.
    In the case of a patient who is ASIH OTHER FACILITY, the admission date/time will be the date/time of the movement that put the patient into ASIH OTHER FACILITY status.
    The date portion of the DATE/TIME field (#.01) of the PATIENT MOVEMENT file (#405) is used to populate this field.
    This field is always exactly 8 numeric characters in length. The format is YYYYMMDD; for example, 19970923. If the date cannot be determined, then a default is used. The default date value is the value of the YEAR MONTH
    field (#1) concatenated with "01" for the day (DD) portion.
11 DISCHARGE DATE 0;12 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>8!($L(X)<8) X
    MAXIMUM LENGTH: 8
  • OUTPUT TRANSFORM:  S Y=$$ECXDATEX^ECXUTL(Y)
  • LAST EDITED:  AUG 22, 2018
  • HELP-PROMPT:  Answer must be 8 characters in length (YYYYMMDD).
  • DESCRIPTION:  
    This 8-character string represents the date on which the Discharge occurred for discharge-type movements.
  • TECHNICAL DESCR:  A call is made to $$INP^ECXUTL2 using the patient's DFN and the date/time of the patient movement (transfer or discharge). The call will return the discharge date/time associated with this episode of care.
    In the case of a patient who is ASIH OTHER FACILITY, the discharge date/time will be the date/time of the movement that ended the patient's ASIH OTHER FACILITY status.
    The date portion of the DATE/TIME field (#.01) of the PATIENT MOVEMENT file (#405) is used to populate this field.
    This field is always exactly 8 numeric characters in length. The format is YYYYMMDD; for example, 19970923. If the date cannot be determined, then a default is used. The default date value is the value of the YEAR MONTH
    field (#1) concatenated with "01" for the day (DD) portion.
12 MOVEMENT FILE # 0;13 POINTER TO PATIENT MOVEMENT FILE (#405) PATIENT MOVEMENT(#405)

  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Enter the patient movement number associated with this extract record.
  • DESCRIPTION:  
    Current patient movement record associated with this extract record.
  • TECHNICAL DESCR:  
    The ^DGPM("ATT2" or "ATT3",DATE,D0) cross reference is used to obtain the current movement number associated with this patient. It is a pointer to the PATIENT MOVEMENT file (#405).
13 PLACEHOLD TYPE 0;14 SET
  • '2' FOR TRANSFER;
  • '3' FOR DISCHARGE;

  • LAST EDITED:  JAN 30, 2019
  • HELP-PROMPT:  Enter the type of movement associated with this record.
  • DESCRIPTION:  
    This field, previously known as TYPE, is no longer needed. The name has been changed to PLACEHOLD TYPE and its value will be set to null.
  • TECHNICAL DESCR:  
    This field is no longer in use as of patch ECX*3*174.
14 LOSING WARD 0;15 POINTER TO HOSPITAL LOCATION FILE (#44) HOSPITAL LOCATION(#44)

  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Enter the ward from which this patient was transferred.
  • DESCRIPTION:  
    Indicates the ward the patient is moving from.
  • TECHNICAL DESCR:  
    LOSING WARD is derived from HOSPITAL LOCATION FILE POINTER field (#44) of the WARD LOCATION file (#42) as pointed to by the WARD AT DISCHARGE field (#200) of the PATIENT MOVEMENT file (#405).
15 TREATING SPECIALTY 0;16 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>3!($L(X)<1) X
    MAXIMUM LENGTH: 3
  • LAST EDITED:  JAN 29, 2019
  • HELP-PROMPT:  Answer must be 1-3 characters in length.
  • DESCRIPTION:  
    The PTF CODE of the treating specialty associated with this extract record.
  • TECHNICAL DESCR:  This field is derived by using the treating specialty value returned by a call to $$INP^ECXUTL2. The treating specialty is then used to obtain the PTF CODE field (#7) of the SPECIALTY file (#42.4) as pointed to by the
    SPECIALTY field (#1) in the FACILITY TREATING SPECIALTY file (#45.7).
    This field will only have a value for regular discharge movements. ASIH other facility discharge movements and transfers will not have a value in this field.
16 LOSING WARD LOS 0;17 NUMBER

  • INPUT TRANSFORM:  K:+X'=X!(X>9999)!(X<0)!(X?.E1"."1N.N) X
  • LAST EDITED:  JAN 20, 1998
  • HELP-PROMPT:  Type a Number between 0 and 9999, 0 Decimal Digits
  • DESCRIPTION:  
    Length of stay on losing ward.
  • TECHNICAL DESCR:  Calculated as current movement date minus the date (DATE/TIME field (#.01) of the PATIENT MOVEMENT file (#405)) of the previous physical movement. OR Calculated as current movement date minus the date (DATE/TIME field
    (#.01) of the PATIENT MOVEMENT file (#405) record pointed to by the ADMISSION/CHECK-IN MOVEMENT field (#.14) of the current movement record.
17 PLACEHOLDER1 0;18 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>11!($L(X)<1) X
  • LAST EDITED:  JAN 20, 1998
  • DESCRIPTION:  
    A placeholder.
  • TECHNICAL DESCR:  
    For future development; always set to null.
18 MOVEMENT TYPE 0;19 POINTER TO MAS MOVEMENT TYPE FILE (#405.2) MAS MOVEMENT TYPE(#405.2)

  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Enter the patient movement type associated with this extract record.
  • DESCRIPTION:  
    THE MAS movement type for this movement.
  • TECHNICAL DESCR:  
    MOVEMENT TYPE is derived from the MAS MOVEMENT TYPE field (.18) of the PATIENT MOVEMENT file (#405). It is a pointer to the MAS MOVEMENT TYPE file (#405.2).
19 MOV TIME 0;20 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>6!($L(X)<6)!'(X?6N) X
  • OUTPUT TRANSFORM:  S Y=$$ECXTIMEX^ECXUTL(Y,0)
  • LAST EDITED:  SEP 24, 1997
  • HELP-PROMPT:  Answer must be 6 characters in length.
  • DESCRIPTION:  
    Time when this patient moved from the losing ward to the gaining ward.
  • TECHNICAL DESCR:  Data source:
    PATIENT MOVEMENT file (#405); DATE/TIME field (#.01)
    This field is always exactly 6 numeric characters (HHMMSS) in length; if time cannot be determined, then "000300" is used as default.
20 GAINING WARD 0;21 POINTER TO HOSPITAL LOCATION FILE (#44) HOSPITAL LOCATION(#44)

  • LAST EDITED:  SEP 11, 1996
  • HELP-PROMPT:  Enter the ward to which this patient was moved.
  • DESCRIPTION:  
    Indicates the ward the patient moved to.
  • TECHNICAL DESCR:  
    GAINING WARD is derived from the HOSPITAL LOCATION FILE POINTER field (#44) of the WARD LOCATION file (#42) as pointed to by the WARD LOCATION field (#.06) of the PATIENT MOVEMENT file (#405).
21 ADMISSION TIME 0;22 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>6!($L(X)<6)!'(X?6N) X
    MAXIMUM LENGTH: 6
  • OUTPUT TRANSFORM:  S Y=$$ECXTIMEX^ECXUTL(Y,0)
  • LAST EDITED:  AUG 22, 2018
  • HELP-PROMPT:  Answer must be 6 characters in length (HHMMSS).
  • DESCRIPTION:  
    The time of day at which the patient admission occurred.
  • TECHNICAL DESCR:  A call is made to $$INP^ECXUTL2 using the patient's DFN and the date/time of the patient movement (transfer or discharge). The call will return the admission date/time associated with this episode of care.
    In the case of a patient who is ASIH OTHER FACILITY, the admission date/time will be the date/time of the movement that put the patient into ASIH OTHER FACILITY status.
    The time portion of the DATE/TIME field (#.01) of the PATIENT MOVEMENT file (#405) is used to populate this field.
    This field is always exactly 6 numeric characters (HHMMSS) in length; if time cannot be determined, then "000300" is used as default.
22 PLACEHOLDER2 0;23 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>11!($L(X)<1) X
  • LAST EDITED:  JAN 20, 1998
  • HELP-PROMPT:  Answer must be 1-11 characters in length.
  • DESCRIPTION:  
    A placeholder.
  • TECHNICAL DESCR:  
    For future development; always set to null.
23 PLACEHOLDER3 0;24 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>11!($L(X)<1) X
  • LAST EDITED:  JAN 20, 1998
  • HELP-PROMPT:  Answer must be 1-11 characters in length.
  • DESCRIPTION:  
    To be used for future development; currently set to null.
  • TECHNICAL DESCR:  
    For future development; always set to null.
24 PLACEHOLD MPI 1;1 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>10!($L(X)<1) X
  • LAST EDITED:  APR 29, 2022
  • HELP-PROMPT:  Answer must be 1-10 characters in length.
  • DESCRIPTION:  
    This field, previously known as MASTER PATIENT INDEX, is no longer needed. The name has been changed to PLACEHOLD MPI and its value will be set to null.
  • TECHNICAL DESCR:  
    This field is no longer in use as of patch ECX*3*184.
25 PLACEHOLDER 1;2 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>7!($L(X)<4) X
  • LAST EDITED:  APR 19, 2016
  • HELP-PROMPT:  Answer must be 4-7 characters in length.
  • DESCRIPTION:  
    This field, previously known as DSS DEPT., is no longer needed. The name has been changed to PLACEHOLDER and its value will be set to null.
  • TECHNICAL DESCR:  
    This field is no longer in use as of patch ECX*3*161.
26 DOM,PRRTP AND SAARTP INDICATOR 1;3 SET
  • 'P' FOR GEN. PRRTP;
  • 'T' FOR PTSD PRRTP;
  • 'S' FOR DOM. PRRTP;
  • 'H' FOR HOMELESS CWT/TR;
  • 'A' FOR SA CWT/TR;
  • 'D' FOR DOMICILIARY;
  • 'B' FOR PTSD CWT/TR;
  • 'C' FOR GEN. CET/TR;

  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Enter the indicator associated with the treating specialty assigned to this record.
  • DESCRIPTION:  
    Indicates if the patient is admitted to either a RRTP, PRRTP, or SARRTP at the time care is provided.
  • TECHNICAL DESCR:  If the patient's treating specialty exists in the DSS TREATING SPECIALTY TRANSLATION file (#727.831), data is derived from the DOM/PRRTP/SARRTP CODE field (#2) of the DSS TREATING SPECIALTY TRANSLATION file (#727.831).
    Else, the value is null.
27 OBSERVATION PATIENT INDICATOR 1;4 SET
  • 'NO' FOR NO;
  • 'YES' FOR YES;

  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Enter observation patient status for this record.
  • DESCRIPTION:  
    Indicate if patient is considered to be an observation patient.
  • TECHNICAL DESCR:  Data (YES, NO) is retrieved from API call $$OBSPAT^ECXUTL4:
    If the patient's treating specialty exists in the DSS TREATING SPECIALTY TRANSLATION file (#727.831), data is derived from the OBSERVATION PAT INDICATOR field (#4) of the DSS TREATING SPECIALTY TRANSLATION file (#727.831).
    If patient is outpatient and treating specialty not in file, AND Feeder Key (CLI) or DSS ID (MTL,IVP,ECQ,NOS,SUR) is 290-297, Observation Patient Ind=YES. Else, Observation Patient Ind=NO.
    Otherwise, Observation Patient Ind=NO.
28 ENCOUNTER NUMBER 1;5 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>18!($L(X)<1) X
  • LAST EDITED:  MAY 14, 2001
  • HELP-PROMPT:  Answer must be 1-18 characters in length.
  • DESCRIPTION:  
    The unique number assigned for DSS.
  • TECHNICAL DESCR:  This field is determined by a call to $$ENCNUM^ECXUTL4. Within this call the inpatient/outpatient status, SSN, admit/visit date, treating specialty, observation patient indicator, and DSS Identifier or feeder key values
    of the record are used to create a unique encounter number.
29 DISCHARGE PC PROVIDER 1;6 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>11!($L(X)<2) X
  • LAST EDITED:  MAY 14, 2001
  • HELP-PROMPT:  Answer must be 2-11 characters in length.
  • DESCRIPTION:  
    Patient's primary care provider from the losing ward.
  • TECHNICAL DESCR:  Using the DATE/TIME field (#.01) from the PATIENT MOVEMENT file (#405) and the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the PHYSICAL MOVEMENT EXTRACT file (#727.808), a call is made to the
    Scheduling API, OUTPTPR^SDUTL3. The API returns the provider's internal entry number and name from the NEW PERSON file (#200).
    A "2" is prefixed to the pointer value to indicate that the source is file #200. For example, if the IEN of the provider in file #200 is 98765, the value that will be stored is 298765.
30 DISCHARGE PC TEAM 1;7 POINTER TO TEAM FILE (#404.51) TEAM(#404.51)

  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Enter the primary care team associated with this event.
  • DESCRIPTION:  
    Patient's primary care team from the losing ward.
  • TECHNICAL DESCR:  Using the DATE/TIME field (#.01) from the PATIENT MOVEMENT file (#405) and the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the PHYSICAL MOVEMENT EXTRACT file (#727.808), a call is made to the
    Scheduling API, OUTPTTM^SDUTL3. The API returns the team's internal entry number and name from the TEAM file (#404.51) and the IEN is used to populate this field.
31 DISCHARGE ASSOC PC PROVIDER 1;8 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>11!($L(X)<2) X
  • LAST EDITED:  MAY 14, 2001
  • HELP-PROMPT:  Answer must be 2-11 characters in length.
  • DESCRIPTION:  
    This field contains the associate primary care provider at the time of discharge.
  • TECHNICAL DESCR:  Derived by a call to the Scheduling API, OUTPTAP^SDUTL3. The API returns the associate provider's internal entry number and name from the NEW PERSON file (#200). The ASSOCIATE PC PROVIDER is the value of a "2" prefixed to
    the pointer value to indicate that the source file is "200". For example, if the IEN of the provider in file #200 is 98765, the value that will be stored is 298765.
32 PRODUCTION DIVISION CODE 1;9 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>7!($L(X)<3) X
  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Answer must be 3-7 characters in length.
  • DESCRIPTION:  
    Identifies the division/facility where the patient is located.
  • TECHNICAL DESCR:  Data comes from the WARD AT DISCHARGE field (#200) in the PATIENT MOVEMENT file (#405). This value is then used to get the NAME field (#.01) in the WARD LOCATION file (#42) which in turn is used to get the DIVISION field
    (#.015) in the WARD LOCATION file (#42) which is a pointer to the MEDICAL CENTER DIVISION file (#40.8). This value is then used to call the API GETDIV^ECXDEPT to get the STATION NUMBER field (#99) from the INSTITUTION file
    (#4).
33 DISCHARGE PC PROV PERSON CLASS 1;10 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>7!($L(X)<7) X
  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Answer must be 7 characters in length.
  • DESCRIPTION:  
    The VA Code of the Person Class of the patient's primary care provider from the losing ward.
  • TECHNICAL DESCR:  Active Person Class is determined by the supported call $$GET^XUA4A72(PERS,DATE), where PERS is the IEN from file #200 and DATE is the date of the event. The VA CODE is determined by the 7th piece of the returned value
    string.
34 DISCH ASSOC PC PROVIDER PC 1;11 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>7!($L(X)<7) X
  • LAST EDITED:  MAY 30, 2012
  • HELP-PROMPT:  Answer must be 7 characters in length.
  • DESCRIPTION:  
    The VA Code of the Person Class of the associate primary care provider associated with this record.
  • TECHNICAL DESCR:  Active Person Class is determined by the supported call $$GET^XUA4A72(PERS,DATE), where PERS is the IEN from file #200 and DATE is the date of the event. The VA CODE is determined by the 7th piece of the returned value
    string.
35 DISCH ASSOC PC PROV NPI 1;12 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>15!($L(X)<1) X
  • LAST EDITED:  MAY 04, 2007
  • HELP-PROMPT:  Answer must be 1-15 characters in length.
  • DESCRIPTION:  
    A standard unique life-long identifier of the patient's associate primary care provider from the losing ward. This field has a length of fifteen characters.
  • TECHNICAL DESCR:  DISCHARGE ASSOC PC PROV. NPI is a standard unique life-long identifier of the patient's associate primary care provider from the losing ward. The qualified identifier shall be retrieved via the supporting Kernel
    API:$$NPI^XUSNPI.
36 DISCHARGE PC PROVIDER NPI 1;13 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>15!($L(X)<1) X
  • LAST EDITED:  MAY 04, 2007
  • HELP-PROMPT:  Answer must be 1-15 characters in length.
  • DESCRIPTION:  
    A standard unique life-long identifier of the patient's primary care provider from the losing ward. This field has a length of fifteen characters.
  • TECHNICAL DESCR:  
    DISCHARGE PC PROVIDER NPI is a standard unique life-long identifier of the patient's primary care provider from the losing ward. The qualified identifier shall be retrieved via the supporting Kernel API:$$NPI^XUSNPI.
37 PATCAT 1;14 SET
  • 'AD' FOR Active Duty;
  • 'ADD' FOR Active Duty Dependent;
  • 'FNRS' FOR Former Non-Remarried Spouse;
  • 'RET' FOR Retired;
  • 'RETD' FOR Retiree Dependent;
  • 'RES' FOR Reservist;
  • 'REC' FOR Recruit;
  • 'TDRL' FOR Temporary Disability;
  • 'TFL' FOR TRICARE for Life;

  • LAST EDITED:  SEP 03, 2010
  • HELP-PROMPT:  Select the Patient's Category for the FHCC Reconciliation process.
  • DESCRIPTION:  This is the Patient's category which will be used for FHCC (Federal Health Care Center) Reconciliation. DSS must capture and report DoD patients so that the FHCC reconciliation process can function as designed.
    "Reconciliation" is the process used within the new FHCC to determine which patients DoD pays for and which VA pays for.
  • TECHNICAL DESCR:  If the VistA Patient Type Code (TYPE (#391) field of the Patient (#2) file) = Active Duty, Military Retiree, or TRICARE, then the value(s) in the VistA Other Eligibility multiple (PATIENT ELIGIBILITIES (#361) field of the
    PATIENT (#2) file), which points to locally modifiable ELIGIBILITY CODE (#8) file should be evaluated. If the value in the ELIGIBILITY CODE is equal to any entry in the set of codes in this field, the value should be
    placed in this field.
38 PATIENT DIVISION 1;15 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>7!($L(X)<3) X
    MAXIMUM LENGTH: 7
  • LAST EDITED:  JUN 29, 2017
  • HELP-PROMPT:  For transfers, enter the 3 to 7 character Station Number of the gaining ward. For discharges, enter the 3 to 7 character Station Number of the losing ward.
  • DESCRIPTION:  
    This field is the Station Number of the gaining ward (for transfers) or the losing ward (for discharges).
  • TECHNICAL DESCR:  For transfer patients, the input parameter for the RADDIV^ECXDEPT API is the gaining ward.
    For discharge patients, the input parameter for the RADDIV^ECXDEPT API is the losing ward.
    Either returns the STATION NUMBER field (#99) from the INSTITUTION file (#4).
39 PLACEHOLD CERNER 2;1 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>194!($L(X)<1) X
    MAXIMUM LENGTH: 194
  • LAST EDITED:  JUN 22, 2022
  • HELP-PROMPT:  Answer must be 1-194 characters in length.
  • DESCRIPTION:  
    Placeholder for Cerner fields. Reserved for EHRM conversion.
  • TECHNICAL DESCR:  
    This field is reserved for CERNER extract data.
40 NEW MPI 3;1 FREE TEXT

  • INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
    MAXIMUM LENGTH: 20
  • LAST EDITED:  APR 29, 2022
  • HELP-PROMPT:  Answer must be 1-20 characters in length.
  • DESCRIPTION:  A national VA system identifier which uniquely identifies a patient.
    Commonly called "Patient ICN" or "Patient IEN"; not to be confused with the IEN from the VistA PATIENT file.
  • TECHNICAL DESCR:  
    Derived by calling API $$GETICN^MPIF001 (supported DBIA #2701) that returns the Integration Control Number (ICN) for the given patient in the PATIENT file (#2).
41 *SELF IDENTIFIED GENDER 3;2 SET
  • 'M' FOR Male;
  • 'F' FOR Female;
  • 'TM' FOR Transgender Male;
  • 'TF' FOR Transgender Female;
  • 'O' FOR Other;
  • 'N' FOR Does not wish to disclose;
  • 'B' FOR Non-Binary;

  • LAST EDITED:  MAY 09, 2025
  • HELP-PROMPT:  This field has been deprecated and should no longer be used.
  • DESCRIPTION:  The SELF IDENTIFIED GENDER value indicates the patient's personal sense of their gender identity (if they choose to provide it).
    Self-identified gender may be the same or different as the sex assigned at birth.
    This field has been deprecated as of patch ECX*3*196 and should no longer be used.
  • TECHNICAL DESCR:  
    This field is no longer in use as of patch ECX*3*196.

External References

Name Field # of Occurrence
$$ECXDATEX^ECXUTL 8OT+1, 10OT+1, 11OT+1
$$ECXTIMEX^ECXUTL 19OT+1, 21OT+1
$$ECXYMX^ECXUTL 1OT+1

Global Variables Directly Accessed

Name Line Occurrences  (* Changed,  ! Killed)
^ECX(727.808 - [#727.808] 2(XREF 1S), 2(XREF 1K)

Local Variables

Legend:

>> Not killed explicitly
* Changed
! Killed
~ Newed

Name Field # of Occurrence
>> DA 2(XREF 1S), 2(XREF 1K)
>> DINUM .01+1*
X .01+1!, 1+1!, 2(XREF 1S), 2(XREF 1K), 5+1!, 6+1!, 8+1!, 9+1!, 10+1!, 11+1!
, 15+1!, 16+1!, 17+1!, 19+1!, 21+1!, 22+1!, 23+1!, 24+1!, 25+1!, 28+1!
, 29+1!, 31+1!, 32+1!, 33+1!, 34+1!, 35+1!, 36+1!, 38+1!, 39+1!, 40+1!
>> Y 1OT+1*, 8OT+1*, 10OT+1*, 11OT+1*, 19OT+1*, 21OT+1*
>> Y(0 1OT+1*, 8OT+1*, 10OT+1*, 11OT+1*, 19OT+1*, 21OT+1*
Info |  Desc |  Directly Accessed By Routines |  Pointer To FileMan Files |  Fields |  External References |  Global Variables Directly Accessed |  Local Variables  | All