STANDARD DATA DICTIONARY #727.808 -- PHYSICAL MOVEMENT EXTRACT FILE                                               3/24/25    PAGE 1
STORED IN ^ECX(727.808,  *** NO DATA STORED YET ***   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                     (VERSION 3.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains data elements as specified by the Decision Support System (DSS) Program Office for the MAS Physical Movement
(Transfer and Discharge) extract from existing DHCP files. Entries into this file are made by extracting data from several files.
Once approved by the DSS site manager, entries in this file are loaded into an electronic mail message and sent to the commercial
vendor. This file is intended to be used for validation purposes only. Entries should be made only by the extract load routine.  
  
Since validation techniques will be determined by the local site, it is intended that the site add whatever cross references deemed
necessary.  However, this file contains one nationally determined cross reference, the "AC" cross reference on the EXTRACT NUMBER
field (#2).  This cross reference is used by the DSS Extracts software package as an essential feature for managing and purging
data in this file and should not be modified.  
  
This file should NOT be modified directly using VA FileMan.  


COMPILED CROSS-REFERENCE ROUTINE: ECX808

CROSS
REFERENCED BY: EXTRACT NUMBER(AC)

    LAST MODIFIED: NOV 10,2022@09:15:09

727.808,.01   SEQUENCE NUMBER        0;1 NUMBER (Required)

              Sequence Number   
              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


727.808,1     YEAR MONTH             0;2 FREE TEXT

              Year/Month   
              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.  


727.808,2     EXTRACT NUMBER         0;3 POINTER TO DSS EXTRACT LOG FILE (#727)

              Extract Number   
              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.  



727.808,3     FACILITY               0;4 POINTER TO MEDICAL CENTER DIVISION FILE (#40.8)

              Facility   
              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).  


727.808,4     PATIENT NO. - DFN      0;5 POINTER TO PATIENT FILE (#2)

              Patient No. - DFN   
              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).  


727.808,5     SSN                    0;6 FREE TEXT

              Social Security Number   
              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.  


727.808,6     NAME                   0;7 FREE TEXT

              Name   
              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.  


727.808,7     IN OUT PATIENT INDICATOR 0;8 SET

              In Out Patient Indicator   
                                '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.  


727.808,8     DAY                    0;9 FREE TEXT

              Day   
              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.  


727.808,9     PRODUCT                0;10 FREE TEXT

              Product   
              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.  


727.808,10    ADMISSION DATE         0;11 FREE TEXT

              Admission Date   
              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.  


727.808,11    DISCHARGE DATE         0;12 FREE TEXT

              Discharge Date   
              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.  


727.808,12    MOVEMENT FILE #        0;13 POINTER TO PATIENT MOVEMENT FILE (#405)

              Movement File Number   
              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).  


727.808,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.  


727.808,14    LOSING WARD            0;15 POINTER TO HOSPITAL LOCATION FILE (#44)

              Losing Ward   
              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).  


727.808,15    TREATING SPECIALTY     0;16 FREE TEXT

              Treating Specialty   
              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.  


727.808,16    LOSING WARD LOS        0;17 NUMBER

              Losing Ward LOS   
              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.  


727.808,17    PLACEHOLDER1           0;18 FREE TEXT

              Placeholder1   
              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.  


727.808,18    MOVEMENT TYPE          0;19 POINTER TO MAS MOVEMENT TYPE FILE (#405.2)

              Movement Type   
              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).  


727.808,19    MOV TIME               0;20 FREE TEXT

              MOV Time   
              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.  


727.808,20    GAINING WARD           0;21 POINTER TO HOSPITAL LOCATION FILE (#44)

              Gaining Ward   
              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).  


727.808,21    ADMISSION TIME         0;22 FREE TEXT

              Admission Time   
              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.  


727.808,22    PLACEHOLDER2           0;23 FREE TEXT

              Placeholder2   
              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.  


727.808,23    PLACEHOLDER3           0;24 FREE TEXT

              Placeholder3   
              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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,30    DISCHARGE PC TEAM      1;7 POINTER TO TEAM FILE (#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.  


727.808,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.  


727.808,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).  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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.  


727.808,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).  


727.808,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.  


727.808,40    NEW MPI                3;1 FREE TEXT

              New MPI   
              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). 


727.808,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 02, 2022 
              HELP-PROMPT:      Answer must be 1-2 characters in length. 
              DESCRIPTION:      This 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.  

              TECHNICAL DESCR:  Using the patient pointer (DFN) stored in the PATIENT NO. - DFN field (#4) in the PHYSICAL MOVEMENT
                                EXTRACT file (#727.808), this data is derived from the SELF IDENTIFIED GENDER field (#.024) in the
                                PATIENT file (#2).  



      FILES POINTED TO                      FIELDS

DSS EXTRACT LOG (#727)            EXTRACT NUMBER (#2)

HOSPITAL LOCATION (#44)           LOSING WARD (#14)
                                  GAINING WARD (#20)

MAS MOVEMENT TYPE (#405.2)        MOVEMENT TYPE (#18)

MEDICAL CENTER DIVISION (#40.8)   FACILITY (#3)

PATIENT (#2)                      PATIENT NO. - DFN (#4)

PATIENT MOVEMENT (#405)           MOVEMENT FILE # (#12)

TEAM (#404.51)                    DISCHARGE PC TEAM (#30)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):