STANDARD DATA DICTIONARY #601.71 -- MH TESTS AND SURVEYS FILE 3/24/25 PAGE 1
STORED IN ^YTT(601.71, (320 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 5.01)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file defines the interviews, surveys and tests available in the Mental Health Assistant. Attributes of the instruments include
authoring credits, target populations, normative samples and copyright information. Actions available including privileging,
reporting of full item content and transmission to the Mental Health National Database are also specified.
Direct entry via FileMan is prohibited.
FILE SCREEN (SCR-node) : I $D(YTTLKUP)!($G(DUZ(0))="@")!($P($G(^(9)),"^",1,2)'="DLL^YTSCORE")
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
APPLICATION GROUP(S): GMTS
POINTED TO BY: SELECTION ITEM field (#.01) of the SELECTION ITEM sub-field (#142.14) of the STRUCTURE sub-field (#142.01) of the
HEALTH SUMMARY TYPE File (#142)
INSTRUMENT field (#.01) of the MH TEST/SURVEY SPEC File (#601.712)
INSTRUMENT field (#1) of the MH INSTRUMENT CONTENT File (#601.76)
INSTRUMENT field (#3) of the MH BATTERY CONTENTS File (#601.78)
INSTRUMENT field (#1) of the MH SKIPPED QUESTIONS File (#601.79)
INSTRUMENT field (#1) of the MH SECTIONS File (#601.81)
InstrumentID field (#1) of the MH INSTRUMENTRULES File (#601.83)
INSTRUMENT NAME field (#2) of the MH ADMINISTRATIONS File (#601.84)
INSTRUMENT ID field (#1) of the MH SCALEGROUPS File (#601.86)
INSTRUMENT field (#1) of the MH REPORT File (#601.93)
INSTRUMENT field (#3) of the MH CR SCRATCH File (#601.94)
INSTRUMENTS field (#.01) of the INSTRUMENTS sub-field (#605.13) of the MH DASHBOARD WIDGET File (#605.1)
FINDING ITEM field (#15) of the REMINDER DIALOG File (#801.41)
MH TEST field (#119) of the REMINDER DIALOG File (#801.41)
FINDING ITEM field (#.01) of the FINDINGS sub-field (#811.52) of the REMINDER TERM File (#811.5)
FINDING ITEM field (#.01) of the FINDINGS sub-field (#811.902) of the REMINDER DEFINITION File (#811.9)
CROSS
REFERENCED BY: NAME(B)
LAST MODIFIED: OCT 12,2022@09:38:50
601.71,.01 NAME 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>50!($L(X)<3)!'(X'?1P.E) X
LAST EDITED: JUN 26, 2012
HELP-PROMPT: Answer must be 3-50 characters in length.
DESCRIPTION: Name of the interview, survey or test. Often its abbreviation is used here, e.g. "BDI2" instead of
"Beck Depression Inventory-2". Each entry has a unique name.
CROSS-REFERENCE: 601.71^B^MUMPS
1)= S ^YTT(601.71,"B",X,DA)=""
2)= K ^YTT(601.71,"B",X,DA)
601.71,2 PRINT TITLE 0;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>100!($L(X)<3) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 3-100 characters in length.
DESCRIPTION:
This is the full formal name of the interview, survey or test. It is used on printed reports.
601.71,3 VERSION 1;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>50!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-50 characters in length.
DESCRIPTION: Test publishers often give a version number to a published test. This field does not imply VA
software versioning.
601.71,4 AUTHOR 1;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>100!($L(X)<1) X
LAST EDITED: SEP 18, 2006
HELP-PROMPT: Answer must be 1-100 characters in length.
DESCRIPTION: This field indicates the author of the interview, survey or test. It is meant to credit the test
author and not the software author or the person who entered this description. Aaron Beck is the
Author of the BDI.
601.71,5 PUBLISHER 1;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>50!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-50 characters in length.
DESCRIPTION: This is the name of the publisher of the test. Psychological Corporation is the publisher of the
WAIS-R.
601.71,7 PUBLICATION DATE 1;5 DATE
INPUT TRANSFORM: S %DT="E" D ^%DT S X=Y K:Y<1 X
LAST EDITED: DEC 13, 2002
DESCRIPTION:
Date of formal publication; often the copyright date
601.71,7.5 REFERENCE 8;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>1000!($L(X)<1) X
MAXIMUM LENGTH: 1000
LAST EDITED: OCT 24, 2018
HELP-PROMPT: Answer must be 1-1000 characters in length.
DESCRIPTION:
This is the primary journal citation for the test.
601.71,8 A PRIVILEGE 1;6 POINTER TO SECURITY KEY FILE (#19.1)
LAST EDITED: JUN 28, 2010
HELP-PROMPT: Select a security key.
DESCRIPTION:
If not null, only those users holding the specified key can administer the instrument.
601.71,8.5 STAFF ENTRY ONLY 1;7 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: MAR 14, 2019
HELP-PROMPT: Enter "Yes" if this instrument should not be entered by the patient.
DESCRIPTION: This field controls whether patient entry of the instrument is allowed. The field should be set to
"Yes" if the instrument should only be used by staff and not patients.
601.71,9 R PRIVILEGE 2;1 FREE TEXT
REPORT PRIVILEGE
INPUT TRANSFORM: K:$L(X)>27!($L(X)<3) X
LAST EDITED: MAR 30, 2012
HELP-PROMPT: Answer must be 3-27 characters.
DESCRIPTION: A key name from the SECURITY KEY file (#19.1). Only those users holding the specified key can
produce a report of the instrument.
TECHNICAL DESCR:
A free text name that must match a SECURITY KEY entry.
601.71,10 OPERATIONAL 2;2 SET
'Y' FOR Yes;
'N' FOR No;
'U' FOR Under Development;
'C' FOR Clinical Reminder;
'D' FOR Dropped;
LAST EDITED: NOV 01, 2006
DESCRIPTION: This field allows an instrument to be "taken out of service". If set to 'N' this instrument can no
longer be administered and will not show on selection lists. Reports of old administrations remain
available. If set to U instrument will be tagged Under Development.
601.71,10.5 HAS BEEN OPERATIONAL 2;5 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: SEP 03, 2004
DESCRIPTION: Used to define editing privileges, this field is set to yes when test is first used to collect
patient data.
601.71,11 REQUIRES LICENSE 2;3 SET (Required)
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: JAN 27, 2004
HELP-PROMPT: Indicate whether rights need to be granted by a copyright holder.
DESCRIPTION: This indicates whether a copyright holder must grant the rights to use this Mental Health
instrument.
601.71,12 PURPOSE 3;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>200!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-200 characters in length.
DESCRIPTION:
Description of what the test measures.
601.71,13 NORM SAMPLE 4;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>200!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-200 characters in length.
DESCRIPTION:
On what population was the normative data gathered ;ie. prisoners, inpatients, college students.
601.71,14 TARGET POPULATION 5;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>200!($L(X)<1) X
LAST EDITED: MAY 01, 2003
HELP-PROMPT: Answer must be 1-200 characters in length.
DESCRIPTION:
Which population is appropriate for measuring, ie vocational job seekers, combat veterans, etc
601.71,15 ENTERED BY 6;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>50!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-50 characters in length.
DESCRIPTION:
User who entered the information about the instrument.
601.71,16 ENTRY DATE 6;2 DATE
INPUT TRANSFORM: S %DT="E" D ^%DT S X=Y K:Y<1 X
LAST EDITED: DEC 13, 2002
DESCRIPTION:
Date instrument was added to the system.
601.71,17 LAST EDITED BY 6;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>50!($L(X)<1) X
LAST EDITED: DEC 13, 2002
HELP-PROMPT: Answer must be 1-50 characters in length.
DESCRIPTION:
User who last edited this record.
601.71,18 LAST EDIT DATE 6;4 DATE (Required)
INPUT TRANSFORM: S %DT="ET" D ^%DT S X=Y K:Y<1 X
LAST EDITED: APR 29, 2003
DESCRIPTION:
Date and time of last change to this record.
601.71,19 IS NATIONAL TEST 6;5 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: JAN 27, 2004
DESCRIPTION: Specifies if instrument supported and distributed by the MHSHG informatics section as opposed to
those locally developed.
601.71,20 LICENSE CURRENT 2;4 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: JAN 27, 2004
DESCRIPTION:
If set to N indicates there is no longer an agreement with the publisher to use this test.
601.71,21 COPYRIGHT TEXT 7;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>250!($L(X)<2) X
LAST EDITED: MAR 17, 2004
HELP-PROMPT: Answer must be 2-250 characters in length.
DESCRIPTION:
Text to display copyright information on the screen and printed report.
601.71,22 REQUIRES SIGNATURE 8;2 SET (Required)
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: JAN 27, 2004
DESCRIPTION:
Boolean if test requires signature before full release.
601.71,23 IS LEGACY 8;3 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: FEB 23, 2005
DESCRIPTION:
Boolean to specify whether test was in the MH Instruments file (#601).
601.71,24 SUBMIT TO NATIONAL DB 8;4 SET
SUBMIT TO NATIONAL DATABASE
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: MAR 27, 2012
HELP-PROMPT: Indicate if the results are to be sent to a national database.
DESCRIPTION:
Boolean indicating to send results to the national MHSHG database. Set only by MHSHG.
TECHNICAL DESCR:
If Yes, the results are to be transmitted to a national database.
601.71,25 IS COPYRIGHTED 8;5 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: MAR 17, 2004
DESCRIPTION:
Boolean specifying whether the instrument is copyrighted.
601.71,26 WRITE FULL TEXT 8;6 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: MAR 17, 2004
DESCRIPTION:
Boolean, if set to true, actual question text is shown on reports.
601.71,27 DAYS TO RESTART 8;7 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999)!(X<-1)!(X?.E1"."1N.N) X
LAST EDITED: OCT 08, 2008
HELP-PROMPT: Type a Number between -1 and 999, 0 Decimal Digits
DESCRIPTION: This field sets a limit on finishing a previously started instrument. Set to zero if re-start is
not allowed. Set to minus 1 if instrument can be completed at any time.
601.71,28 GENERATE PNOTE 8;8 SET
GENERATE PROGRESS NOTE
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: MAR 21, 2012
HELP-PROMPT: Should the TIU note be created?
DESCRIPTION: Select No (or leave null) to stop MHA3 from generating a TIU note. Clinical Reminders do not read
this flag. TIU notes are never generated for a test that has an R_Privilege set.
601.71,29 TIU TITLE 8;9 POINTER TO TIU DOCUMENT DEFINITION FILE (#8925.1)
LAST EDITED: JUN 28, 2010
HELP-PROMPT: Select the progress note title.
DESCRIPTION:
Title of the TIU note used to identify the progress note for this instrument.
TECHNICAL DESCR: MENTAL HEALTH DIAGNOSTIC STUDY NOTE is the approved title for additional instruments. Other titles
need approval by the Standards Group before they can be used.
601.71,30 CONSULT NOTE TITLE 8;10 POINTER TO TIU DOCUMENT DEFINITION FILE (#8925.1)
LAST EDITED: MAR 22, 2010
HELP-PROMPT: Select Consult Note Title.
DESCRIPTION:
This is the Consult Note Title associated with this instrument.
601.71,91 TAG FOR SCORING 9;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>16!($L(X)<1) X
LAST EDITED: SEP 09, 2015
HELP-PROMPT: Enter the entry point (TAG) for the scoring algorithm, 1 to 16 characters.
DESCRIPTION: This contains the name of the entry point for a special scoring algorithm if the instrument
requires special code for scoring the test. If the entry point is "DLL", there is not an M-based
algorithm available.
601.71,92 ROUTINE FOR SCORING 9;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>16!($L(X)<1) X
LAST EDITED: SEP 09, 2015
HELP-PROMPT: Enter the ROUTINE NAME for the special scoring algorithm, 1 to 16 characters.
DESCRIPTION:
This contains the name of a routine that contains a special scoring algorithm for this instrument.
601.71,93 SCORING REVISION 9;3 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999)!(X<0)!(X?.E1"."1N.N) X
LAST EDITED: SEP 26, 2017
HELP-PROMPT: Type a number between 0 and 999, 0 decimal digits.
DESCRIPTION: This field indicates the revision level for scoring. If there are changes made to an instrument
(updates, bug fixes) that modify the computation of a score, this field should be incremented.
That will cause instruments with a lower scoring revision to be re-scored. An audit trail of
earlier revision scores is kept with the results.
601.71,94 STAFF ENTRY ONLY 9;4 SET
'Y' FOR Yes;
'N' FOR No;
LAST EDITED: APR 04, 2019
HELP-PROMPT: Enter "Yes" if this instrument should not be entered by the patient.
DESCRIPTION: This field controls whether patient entry of the instrument is allowed. The field should be set to
"Yes" if the instrument should only be used by staff and not patients.
601.71,95 ROUTINE FOR SUICIDE RISK 9;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>16!($L(X)<3)!'(X?1U1.15UN) X
MAXIMUM LENGTH: 16
LAST EDITED: DEC 06, 2021
HELP-PROMPT: Enter the ROUTINE NAME for the suicide risk algorithm, 3 to 16 uppercase characters and numbers.
DESCRIPTION: This field contains the name of a routine that contains the suicide risk assessment algorithm for
this instrument.
601.71,96 TAG FOR SUICIDE RISK 9;6 FREE TEXT
INPUT TRANSFORM: K:$L(X)>16!($L(X)<1)!'(X>16!X<1) X
MAXIMUM LENGTH: 16
LAST EDITED: JUL 07, 2020
HELP-PROMPT: Enter the entry point (TAG) for the Suicide Risk algorithm, 1 to 16 characters
DESCRIPTION: This contains the name of the entry point for an algorithm to determine the potential risk for
patient suicide based on variying criterion by instrument. If no tag is present then the instrument
Is not used for suicide risk calculation.
601.71,100.01 YS_MHA_B.DLL VERSION VER;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>12!($L(X)<7)!'(X?1.2N1"."1.2N1"."1.2N1"."1.3N) X
LAST EDITED: MAR 16, 2012
HELP-PROMPT: Answer must be 7-12 characters in length.
DESCRIPTION: Version number of YS_MHA_B.DLL from the Host File System (HFS). It is used to verify the software
configuration on a user's workstation. It should only be edited by Mental Health software.
TECHNICAL DESCR:
File Version Number in the format "nn.nn.nn.nnn"
601.71,100.02 YS_MHA_B.DLL DATE/TIME VER;2 DATE
INPUT TRANSFORM: S %DT="ESTX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 16, 2012
HELP-PROMPT: Enter the date/time the file was modified (time is optional).
DESCRIPTION: Modified date/time of YS_MHA_B.DLL from the Host File System (HFS). It is used to verify the
software configuration on a user's workstation. It should only be edited by Mental Health
software.
TECHNICAL DESCR:
File Modified date/time from the Host File System. Time is optional.
601.71,100.03 YS_MHA_AUX.DLL VERSION VER;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>12!($L(X)<7)!'(X?1.2N1"."1.2N1"."1.2N1"."1.3N) X
LAST EDITED: MAR 16, 2012
HELP-PROMPT: Answer must be 7-12 characters in length.
DESCRIPTION: Version number of YS_MHA_AUX.DLL from the Host File System (HFS). It is used to verify the
software configuration on a user's workstation. It should only be edited by Mental Health
software.
TECHNICAL DESCR:
File Version Number in the format "nn.nn.nn.nnn"
601.71,100.04 YS_MHA_AUX.DLL DATE/TIME VER;4 DATE
INPUT TRANSFORM: S %DT="ESTX" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAR 16, 2012
HELP-PROMPT: Enter the date/time the file was modified (time is optional).
DESCRIPTION: Modified date/time of YYS_MHA_AUX.DLL from the Host File System (HFS). It is used to verify the
software configuration on a user's workstation. It should only be edited by Mental Health
software.
TECHNICAL DESCR:
File Modified date/time from the Host File System. Time is optional.
601.71,101 CATEGORY 10;0 POINTER Multiple #601.71101
DESCRIPTION: This multiple contains the categories to which an instrument belongs. This allows an instrument to
be organized as a member of one or more sub-groups.
601.71101,.01 CATEGORY 0;1 POINTER TO MH INSTRUMENT CATEGORY FILE (#601.97) (Multiply asked)
LAST EDITED: JUN 17, 2019
HELP-PROMPT: Select the category for this instrument from the list of possible categories.
DESCRIPTION: This points to a pre-determined list of categories. The instrument will appear under each
selected category.
CROSS-REFERENCE: 601.71101^B
1)= S ^YTT(601.71,DA(1),10,"B",$E(X,1,30),DA)=""
2)= K ^YTT(601.71,DA(1),10,"B",$E(X,1,30),DA)
601.71,110 INTERPRETIVE TEXT 11;0 WORD-PROCESSING #601.711 (NOWRAP) (IGNORE "|")
LAST EDITED: APR 18, 2022
DESCRIPTION: This field contains text that assists clinicians interpret the results of an instrument
administration.
LAST EDITED: APR 18, 2022
HELP-PROMPT: Enter text for instrument result interpretation.
DESCRIPTION:
This field contains the text that assists clinicians interpret the results for an instrument.
FILES POINTED TO FIELDS
MH INSTRUMENT CATEGORY (#601.97) CATEGORY:CATEGORY (#.01)
SECURITY KEY (#19.1) A PRIVILEGE (#8)
TIU DOCUMENT DEFINITION (#8925.1) TIU TITLE (#29)
CONSULT NOTE TITLE (#30)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):