STANDARD DATA DICTIONARY #211.4 -- NURS LOCATION FILE 3/24/25 PAGE 1
STORED IN ^NURSF(211.4, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 4.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains nursing information on all patient care areas and office locations specific to Nursing Service.
SPECIAL LOOKUP ROUTINE : NURSAFLL
DD ACCESS: @
RD ACCESS:
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
APPLICATION GROUP(S): NURS
IDENTIFIED BY:
"WRITE": N NUR S NUR=$G(^("I")) D:NUR="I" EN^DDIOL("**INACTIVE**"_$E(@(DIC_"Y,0)"),0),"","?$X+2")
POINTED TO BY: WARD field (#.13) of the BCMA REPORT REQUEST File (#53.69)
NURS LOCATION field (#1) of the PATIENT sub-field (#213.51) of the NURS AMIS DAILY EXCEPTION REPORT File (#213.5)
LOCATION field (#4) of the STAFF EMPLOYEE sub-field (#213.52) of the NURS AMIS DAILY EXCEPTION REPORT File (#213.5)
NURS LOCATION field (#2) of the NURS PATIENT File (#214)
NURS LOCATION field (#6) of the NURS CLASSIFICATION File (#214.6)
NURSE LOCATION field (#5) of the VA NURSE sub-field (#451.09) of the POC DAILY TIME RECORDS File (#451)
POC NURSE LOCATION field (#10) of the POC DAILY ACTIVITY EXTRACTION File (#451.7)
POINT OF CARE field (#4) of the TIME SEGMENT sub-field (#451.9999) of the VERSION # sub-field (#451.999) of the DAY
# sub-field (#451.99) of the VA NURSE sub-field (#451.09) of the POC DAILY TIME RECORDS File (#451)
NURSE LOCATION field (#12) of the NURSING EXTRACT File (#727.805)
CROSS
REFERENCED BY: AMIS BED SECTION(ABS), AMIS BED SECTION(ABS1), INACTIVE FLAG(AC), NAME(B), MAS WARD(C), PATIENT CARE FLAG(D),
PRODUCT LINE(P)
INDEXED BY: POC DATA APPROVAL PERSONNEL (AA), POC DATA ENTRY PERSONNEL (AE)
211.4,.01 NAME 0;1 POINTER TO HOSPITAL LOCATION FILE (#44) (Required)
INPUT TRANSFORM: S DIC("S")="I $P(^(0),U,22)=$O(^DIC(40.9,""C"",""NU"",0))" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
OUTPUT TRANSFORM: S Y=$S(+Y'>0:"",'$D(^SC(+Y,0)):"",$P(^(0),U)?1"NUR ".E:$P($P(^(0),U),"NUR ",2),1:$P(^(0),U))
LAST EDITED: AUG 18, 1988
DESCRIPTION:
Name of the nursing location.
SCREEN: S DIC("S")="I $P(^(0),U,22)=$O(^DIC(40.9,""C"",""NU"",0))"
EXPLANATION: Only nursing type locations may be selected from the Hospital Location file. Editing the name of th
is location must be done through the Hospital Location file.
EXECUTABLE HELP: S MSG(1)="NOTE: The letters NUR may be in front of the location name.",MSG(1,"F")="!!",MSG(2)="Thi
s is not to be corrected under any circumstance.",MSG(2,"F")="!?7" D EN^DDIOL(.MSG) K MSG
DELETE TEST: 1,0)= I 1 D EN^DDIOL($C(7),"","?0") S XQH="NURS-LOCATION-DELETE" D EN^XQH D EN^DDIOL("","","!?5")
CROSS-REFERENCE: 211.4^B
1)= S ^NURSF(211.4,"B",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,"B",$E(X,1,30),DA)
This is the main index on the name field of the NURS Location file.
211.4,.02 FACILITY ; COMPUTED
MUMPS CODE: S X=$$GET1^DIQ(4,+$$GET1^DIQ(44,+$G(^NURSF(211.4,D0,0)),3,"I"),.01,"I")
ALGORITHM: S X=$$GET1^DIQ(4,+$$GET1^DIQ(44,+$G(^NURSF(211.4,D0,0)),3,"I"),.01,"I")
LAST EDITED: APR 16, 1996
DESCRIPTION:
This field associates a nursing unit/location with a division of a medical center or facility.
211.4,.03 PRODUCT LINE 1;4 POINTER TO NURS PRODUCT LINE FILE (#212.7)
LAST EDITED: JUL 10, 1996
DESCRIPTION:
This field associates a service/programs/product line with this Nursing Location.
CROSS-REFERENCE: 211.4^P
1)= S ^NURSF(211.4,"P",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,"P",$E(X,1,30),DA)
This is a regular cross-reference on the Product Line field.
211.4,.5 CARE SETTING 1;5 SET (Required)
'I' FOR Inpatient;
'O' FOR Other;
LAST EDITED: JUL 09, 2009
HELP-PROMPT: Enter an "I" if this is an inpatient location or an "O" for other.
DESCRIPTION: This is a set of codes used to define the CARE SETTING of the nursing location as inpatient or
other.
211.4,.6 UNIT TYPE 1;6 POINTER TO VANOD UNIT TYPES FILE (#212.8)
Primary Patient Population Served
LAST EDITED: JUL 09, 2009
HELP-PROMPT: Enter a VANOD UNIT TYPE
DESCRIPTION:
This field defines the VANOD UNIT TYPE associated with the nursing location.
211.4,.7 INPATIENT DSS DEPARTMENT 1;7 FREE TEXT
INPUT TRANSFORM: K:$L(X)>45!($L(X)<3) X
LAST EDITED: JUN 08, 2009
HELP-PROMPT: Answer must be 3-45 characters in length
DESCRIPTION:
This identifies the Inpatient DSS Department.
211.4,1 PATIENT CARE FLAG 1;1 SET (Required)
PATIENT CARE STATUS
'A' FOR ACTIVE;
'I' FOR INACTIVE;
LAST EDITED: MAY 26, 1987
DESCRIPTION: This field determines if this location is for patient care. ACTIVE denotes that this is a patient
care location, and INACTIVE denotes that this is not a patient care location.
EXECUTABLE HELP: S:X?1"??".E X="?" S XQH="NURS-PATIENT FLAG" D EN^XQH K XQH Q
CROSS-REFERENCE: 211.4^D
1)= S ^NURSF(211.4,"D",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,"D",$E(X,1,30),DA)
This is an index on the 'Patient Care Status' field and indicates the active or inactive patient
care status of the nursing location.
211.4,1.5 INACTIVE FLAG I;1 SET (Required)
WARD STATUS
'A' FOR ACTIVE;
'I' FOR **INACTIVE**;
INPUT TRANSFORM: D CHKSTAT^NURSUT1 K:$G(NURSTAT) X K NURSTAT,NURACTV
LAST EDITED: AUG 18, 2011
DESCRIPTION:
This field flags whether this location is associated with active FTEE in the Nursing Package.
EXECUTABLE HELP: S:X?1"??".E X="?" S XQH="NURS-INACTIVE FLAG" D EN^XQH K XQH Q
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER
CROSS-REFERENCE: 211.4^AC^MUMPS
1)= D SERVICE^NURSUT6
2)= Q
This cross reference acts as a trigger to add an entry to the Service Dates multiple field (# 16)
in this file (# 211.4), when the Ward Status field (# 1.5) changes. The entries added to the
Service Dates multiple, by this cross reference, record the history of when this Nursing Location
was active or inactive, by storing the date of the change and what the Ward Status was changed to
(Active or Inactive).
Note that if a location is changed back and forth between active and inactive on the same day, then
this cross reference will only record the status corresponding to the last action on that date in
the new Service Dates multiple.
211.4,2 MAS WARD 3;0 POINTER Multiple #211.41
DESCRIPTION:
Pointer to the WARD LOCATION (#42) file represents the MAS equivalent of a NURSING LOCATION.
IDENTIFIED BY: AMIS BED SECTION(#1)
211.41,.01 MAS WARD 0;1 POINTER TO WARD LOCATION FILE (#42) (Multiply asked)
LAST EDITED: APR 16, 1987
DESCRIPTION:
Pointer to WARD LOCATION (#42) file represents the MAS equivalent of a NURSING LOCATION.
CROSS-REFERENCE: 211.4^C
1)= S ^NURSF(211.4,"C",$E(X,1,30),DA(1),DA)=""
2)= K ^NURSF(211.4,"C",$E(X,1,30),DA(1),DA)
This is an index on the 'MAS Ward' field which lists ward locations that are associated with the
nursing location.
211.41,1 AMIS BED SECTION 0;2 POINTER TO NURS AMIS WARD FILE (#213.3)
MAS BED SECTION
INPUT TRANSFORM: S DIC("S")="I $D(^NURSF(211.4,""ABS"",+Y,DA(1),4))" D ^DIC K DIC S DIC=DIE,X=+Y K:Y<0 X
LAST EDITED: NOV 07, 1989
DESCRIPTION:
The nursing AMIS bedsection that corresponds to this MAS ward for this nursing location.
SCREEN: S DIC("S")="I $D(^NURSF(211.4,""ABS"",+Y,DA(1),4))"
EXPLANATION: Select AMIS bed sections that are only in the AMIS bed section multiple for this location.
DELETE AUTHORITY: ^
WRITE AUTHORITY: ^
CROSS-REFERENCE: 211.4^ABS^MUMPS
1)= S ^NURSF(211.4,"ABS",X,DA(1),3,DA)=""
2)= K ^NURSF(211.4,"ABS",X,DA(1),3,DA)
This mumps index identifies the nursing AMIS bedsection that has been associated with this MAS
ward location.
211.4,4 AMIS BED SECTION 4;0 POINTER Multiple #211.43 (Add New Entry without Asking)
DESCRIPTION:
Pointer to the #213.3 file. This field assigns one or more bed sections per NURS LOCATION.
211.43,.01 AMIS BED SECTION 0;1 POINTER TO NURS AMIS WARD FILE (#213.3) (Multiply asked)
LAST EDITED: OCT 21, 1988
DESCRIPTION: Name of the Nursing 'AMIS bed section' to which a ward/unit is assigned. Points to NURS AMIS
WARD FILE (213.3).
CROSS-REFERENCE: 211.4^ABS1^MUMPS
1)= S ^NURSF(211.4,"ABS",X,DA(1),4,DA)=""
2)= K ^NURSF(211.4,"ABS",X,DA(1),4,DA)
This mumps index indicates the nursing AMIS bedsection that has been associated with this nursing
location.
211.4,11 PROFESSIONAL PERCENTAGE 1;2 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>100)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JUN 18, 1990
HELP-PROMPT: Type a Number between 1 and 100, 0 Decimal Digits
DESCRIPTION:
This number indicates the percentage of professional nursing personnel assigned to a unit.
211.4,12 UNIT EXPERIENCE 1;3 POINTER TO NURS CLINICAL BACKGROUND FILE (#211.5)
LAST EDITED: APR 16, 1996
DESCRIPTION: This field contains the clinical background that is associated with this location. The data in
this field is used by the Nursing Acuity/Separation- Activation Run to update the professional
experience field of the NURS Staff (#210) file.
211.4,14 POC DATA ENTRY PERSONNEL 5;0 POINTER Multiple #211.414
211.414,.01 POC DATA ENTRY PERSONNEL 0;1 POINTER TO NEW PERSON FILE (#200) (Multiply asked)
LAST EDITED: JUL 10, 2009
HELP-PROMPT: Enter POC Data Entry Personnel.
DESCRIPTION: A pointer to the NEW PERSON file (#200) that identifies the personnel responsible for entering
Nurse POC Daily Time records.
CROSS-REFERENCE: 211.414^B
1)= S ^NURSF(211.4,DA(1),5,"B",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,DA(1),5,"B",$E(X,1,30),DA)
FIELD INDEX: AE (#1001) REGULAR IR SORTING ONLY WHOLE FILE (#211.4)
Short Descr: POC DATA ENTRY PERSONNEL
Description: This is an index for POC DATA ENTRY PERSONNEL and the nursing locations for which they do data
entry.
Set Logic: S ^NURSF(211.4,"AE",X,DA(1),DA)=""
Kill Logic: K ^NURSF(211.4,"AE",X,DA(1),DA)
Whole Kill: K ^NURSF(211.4,"AE")
X(1): POC DATA ENTRY PERSONNEL (211.414,.01) (Subscr 1) (forwards)
211.4,15 POC DATA APPROVAL PERSONNEL 6;0 POINTER Multiple #211.415
211.415,.01 POC DATA APPROVAL PERSONNEL 0;1 POINTER TO NEW PERSON FILE (#200) (Multiply asked)
LAST EDITED: JUL 10, 2009
HELP-PROMPT: Enter POC Data Approval Personnel
DESCRIPTION: A pointer to the NEW PERSON file (#200) that identifies the personnel responsible for approving
Nurse POC Daily Time records.
CROSS-REFERENCE: 211.415^B
1)= S ^NURSF(211.4,DA(1),6,"B",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,DA(1),6,"B",$E(X,1,30),DA)
FIELD INDEX: AA (#1000) REGULAR IR SORTING ONLY WHOLE FILE (#211.4)
Short Descr: POC Data Approval Personnel
Description: This is an index of POC Data approval personnel and the nursing locations for which they are
responsible.
Set Logic: S ^NURSF(211.4,"AA",X,DA(1),DA)=""
Kill Logic: K ^NURSF(211.4,"AA",X,DA(1),DA)
Whole Kill: K ^NURSF(211.4,"AA")
X(1): POC DATA APPROVAL PERSONNEL (211.415,.01) (Subscr 1) (forwards)
211.4,16 SERVICE DATES 7;0 DATE Multiple #211.416
DESCRIPTION: Entries to the SERVICE DATES multiple field (#16) are added when the INACTIVE FLAG field (#1.5) is
changed. This is accomplished by using MUMPS code in the "AC" cross reference of the INACTIVE FLAG
field as a trigger to set the values for the SERVICE DATE field (#.01) and the STATUS field (#1) in
the SERVICE DATES multiple.
INDEXED BY: SERVICE DATE & STATUS (C)
211.416,.01 SERVICE DATE 0;1 DATE
INPUT TRANSFORM: S %DT="E" D ^%DT S X=Y K:X<1 X
LAST EDITED: JUL 09, 2009
HELP-PROMPT: (No range limit on date)
DESCRIPTION:
The date on which this nursing location was put into or taken out of service.
CROSS-REFERENCE: 211.416^B
1)= S ^NURSF(211.4,DA(1),7,"B",$E(X,1,30),DA)=""
2)= K ^NURSF(211.4,DA(1),7,"B",$E(X,1,30),DA)
RECORD INDEXES: C (#1002)
211.416,1 STATUS 0;2 SET
'A' FOR ACTIVE;
'I' FOR INACTIVE;
LAST EDITED: JUL 09, 2009
HELP-PROMPT: Select a status for this nursing location.
DESCRIPTION:
This is the status associated with the SERVICE DATE.
RECORD INDEXES: C (#1002)
211.4,37 STAFF FLAG ; COMPUTED
MUMPS CODE: S Y=+$G(^NURSF(211.4,D0,0)),X=$S(+$$LOCSTAT^NURSUT1(Y):"YES",1:"NO")
ALGORITHM: S Y=+$G(^NURSF(211.4,D0,0)),X=$S(+$$LOCSTAT^NURSUT1(Y):"YES",1:"NO")
DESCRIPTION:
This field indicates weather or not active staff members are assigned to the nursing location.
FILES POINTED TO FIELDS
HOSPITAL LOCATION (#44) NAME (#.01)
NEW PERSON (#200) POC DATA ENTRY PERSONNEL:POC DATA ENTRY PERSONNEL (#.01)
POC DATA APPROVAL PERSONNEL:POC DATA APPROVAL PERSONNEL (#.01)
NURS AMIS WARD (#213.3) MAS WARD:AMIS BED SECTION (#1)
AMIS BED SECTION:AMIS BED SECTION (#.01)
NURS CLINICAL BACKGROUND
(#211.5) UNIT EXPERIENCE (#12)
NURS PRODUCT LINE (#212.7) PRODUCT LINE (#.03)
VANOD UNIT TYPES (#212.8) UNIT TYPE (#.6)
WARD LOCATION (#42) MAS WARD:MAS WARD (#.01)
Subfile #211.416
Record Indexes:
C (#1002) RECORD REGULAR IR LOOKUP & SORTING
Short Descr: Index on service date and status
Description: This index contains the service date and status. It can be used to determine the status of a nursing location
for a given date.
Set Logic: S ^NURSF(211.4,DA(1),7,"C",X(1),X(2),DA)=""
Kill Logic: K ^NURSF(211.4,DA(1),7,"C",X(1),X(2),DA)
Whole Kill: K ^NURSF(211.4,DA(1),7,"C")
X(1): SERVICE DATE (211.416,.01) (Subscr 1) (forwards)
X(2): STATUS (211.416,1) (Subscr 2) (forwards)
INPUT TEMPLATE(S):
NURS-I-PRIORITY 1A JUN 08, 2009@16:04 USER #0
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):