Professional Documents
Culture Documents
VERSION 2 (MHA 2)
INSTALLATION GUIDE
PATCH YS*5.01*76
Version 5.01
June 2003
NOTE: The Veterans Health Administration (VHA) fully supports Section 508 of The
Rehabilitation Act and is committed to equal access for all users. While every effort has been
made to ensure Section 508 compliance, we realize that there may be other issues. If you have
questions or would like to see a copy of the Compliance Action Plan for future releases, please
contact:
In MHA Version 1, on the Order Tests tab the only way to move a test from the list of available
tests to the list of selected tests (or back) without using the mouse was to use options under the
Actions option on the main menu. In MHA Version 2, it is now also possible to tab to the select,
delete, or delete all buttons; and select, delete, and delete all menu options have been added to
the pop-up menu.
The Veterans Health Information Systems and Architecture (VistA) Mental Health Assistant
Version 2 (MHA 2), Installation Guide Patch YS*5.01*76, provides detailed instructions and
requirements for installing and implementing the Graphical User Interface (GUI) software
application.
NOTE: The screen captures examples text is written in support of Section 508 compliance.
Commands to utilize options are bolded.
Introduction: This section includes an overview of the major functions, purposes, and how the
GUI software application accomplishes the objectives.
Enhancements and Modifications: This section contains software changes exported by MHA 2,
Patch YS*5.01*76.
Security Information: This section addresses any unique legal requirements and responsibilities
pertaining to the Mental Health Assistant Version 2, software application and necessary security
measures to protect the integrity of the software and its data.
Pre-installation Information: This section provides information needed prior to installing MHA
Version 2, patch YS*5.01*76.
Installation Instructions: This section contains instructions and examples of MHA Version 2,
patch YS*5.01*76 installation process.
Post Installation Instruction: This provides directions for implementing the VistA Mental
Health Package enhancements to interact with the MHA Version 2, software application.
NOTE: All sites are encouraged to use the File Transfer Protocol (FTP) capability. Use the FTP
address “download.vista.med.va.gov” (without the quotes) to connect to the first available FTP
server where the files are located.
VistA Mental Health Assistant Version 2 Patch YS*5.01*76 files, Installation Guide (i.e.,
YS50176_MHA2_IG.DOC and YS50176_MHA2_IG.PDF), and User Manual (i.e.,
YS50176_MHA2_UM.DOC and YS50176_MHA2_UM.PDF) are available on the Office of
Information Field Offices (OIFOs) ANONYMOUS SOFTWARE directory FTP addresses listed
below:
http://VistA.med.va.gov/ClinicalSpecialties/menthlth/Index.html
http://www.va.gov/vdl/
PREFACE------------------------------------------------------------------------------------------------------------------------------I
SECTION 508 OF THE REHABILITATION ACT----------------------------------------------------------------------------------- I
VistA Mental Health Assistant Version 2, (MHA 2) 508 Compliance---------------------------------------------------i
MHA 2 SOFTWARE APPLICATION----------------------------------------------------------------------------------------------- II
MHA 2 Installation Guide Orientation:------------------------------------------------------------------------------------ii
SOFTWARE AND DOCUMENTATION RETRIEVAL INFORMATION------------------------------------------------------------- III
Anonymous Software Directory---------------------------------------------------------------------------------------------iii
MHA 2 Software and Documentation Files Retrieval Format----------------------------------------------------------iii
VistA Mental Health Version 5.01 Home Page:--------------------------------------------------------------------------iv
VistA Documentation Library (VDL):--------------------------------------------------------------------------------------iv
INTRODUCTION-------------------------------------------------------------------------------------------------------------------7
OVERVIEW-------------------------------------------------------------------------------------------------------------------------7
VistA Mental Health Assistant Version 2, Software Features------------------------------------------------------------7
ASI – Addiction Severity Index:-------------------------------------------------------------------------------------------------------7
GAF – Global Assessment of Functioning:-------------------------------------------------------------------------------------------7
Psychological Tests and Interviews:---------------------------------------------------------------------------------------------------7
VISTA MHA 2, FUNCTIONALITY------------------------------------------------------------------------------------------------8
Addiction Severity Index (ASI):----------------------------------------------------------------------------------------------8
Global Assessment of Functioning (GAF)----------------------------------------------------------------------------------9
Psychological Tests and Interviews:-----------------------------------------------------------------------------------------9
Test Results Tab:-------------------------------------------------------------------------------------------------------------------------9
Order Tests Tab:--------------------------------------------------------------------------------------------------------------------------9
Patient Demographics-------------------------------------------------------------------------------------------------------------------9
SECURE DESKTOP INFORMATION----------------------------------------------------------------------------------------------10
Patient Entry Window--------------------------------------------------------------------------------------------------------11
First Warning Dialog Box-------------------------------------------------------------------------------------------------------------12
Second Warning Dialog Box----------------------------------------------------------------------------------------------------------12
Unauthorized Keystrokes----------------------------------------------------------------------------------------------------13
Excessive Use of Unauthorized Keystrokes-------------------------------------------------------------------------------13
Termination of Mental Health Assistant-----------------------------------------------------------------------------------13
ENHANCEMENTS AND MODIFICATIONS-------------------------------------------------------------------------------15
ENHANCEMENTS:----------------------------------------------------------------------------------------------------------------15
MODIFICATIONS-----------------------------------------------------------------------------------------------------------------17
SECURITY INFORMATION----------------------------------------------------------------------------------------------------21
SECURITY MANAGEMENT------------------------------------------------------------------------------------------------------21
Security Features:------------------------------------------------------------------------------------------------------------21
Secure Desktop-------------------------------------------------------------------------------------------------------------------------21
Mail Groups:----------------------------------------------------------------------------------------------------------------------------21
Alerts:------------------------------------------------------------------------------------------------------------------------------------21
Remote Systems:--------------------------------------------------------------------------------------------------------------22
MH YT and YS RPCs------------------------------------------------------------------------------------------------------------------22
Registration DG RPCs-----------------------------------------------------------------------------------------------------------------23
Archiving/Purging:-----------------------------------------------------------------------------------------------------------24
Contingency Planning:------------------------------------------------------------------------------------------------------24
Interfacing:--------------------------------------------------------------------------------------------------------------------24
Electronic Signatures:-------------------------------------------------------------------------------------------------------24
Menus---------------------------------------------------------------------------------------------------------------------------24
Security Keys:-----------------------------------------------------------------------------------------------------------------24
File Security:------------------------------------------------------------------------------------------------------------------25
References:--------------------------------------------------------------------------------------------------------------------25
Official Policies:--------------------------------------------------------------------------------------------------------------25
PRE-INSTALLATION INFORMATION-------------------------------------------------------------------------------------27
RECOMMENDED USERS:--------------------------------------------------------------------------------------------------------27
Information Resources Management (IRM) Staff------------------------------------------------------------------------27
Mental Health Clinicians----------------------------------------------------------------------------------------------------27
TEST SITES-----------------------------------------------------------------------------------------------------------------------27
WINDOWS CONVENTIONS------------------------------------------------------------------------------------------------------28
VISTA OPERATING SYSTEM----------------------------------------------------------------------------------------------------28
VISTA OPERATING SYSTEM PERFORMANCE CAPACITY---------------------------------------------------------------------28
MHA CENTRAL PROCESSING UNIT (CPU) REQUIREMENT----------------------------------------------------------------28
MHA SOFTWARE APPLICATION INSTALLATION TIME-----------------------------------------------------------------------28
USERS ON THE SYSTEM---------------------------------------------------------------------------------------------------------28
BACKUP ROUTINES-------------------------------------------------------------------------------------------------------------29
KERNEL INSTALLATION AND DISTRIBUTION SYSTEM (KIDS)-------------------------------------------------------------29
NAMESPACE----------------------------------------------------------------------------------------------------------------------29
MHA 2 SOFTWARE APPLICATION REQUIREMENTS--------------------------------------------------------------------------29
Software Applications Versions---------------------------------------------------------------------------------------------------29
REQUIRED PATCHES-------------------------------------------------------------------------------------------------------------29
Software Applications Patches----------------------------------------------------------------------------------------------------29
MHA 2 MENU/OPTIONS CHANGES-------------------------------------------------------------------------------------------30
YS Broker1 [YS BROKER1] Option---------------------------------------------------------------------------------------30
DATABASE INTEGRATION AGREEMENTS (DBIAS)--------------------------------------------------------------------------30
DATA DICTIONARY CHANGES--------------------------------------------------------------------------------------------------31
MH INSTRUMENT file (#601):--------------------------------------------------------------------------------------------31
COPYRIGHT HOLDER file (#601.3):-------------------------------------------------------------------------------------31
ASI NARRATIVE file (#604.68):-------------------------------------------------------------------------------------------31
REMOTE PROCEDURES----------------------------------------------------------------------------------------------------------32
MHA New YT RPCs----------------------------------------------------------------------------------------------------------32
New Registration DG RPCs-------------------------------------------------------------------------------------------------43
ROUTINE SUMMARY------------------------------------------------------------------------------------------------------------44
INSTALLATION INSTRUCTIONS--------------------------------------------------------------------------------------------45
SERVER:--------------------------------------------------------------------------------------------------------------------------45
MHA INSTALLATION EXAMPLE:-----------------------------------------------------------------------------------------------47
POST INSTALLATION INSTRUCTIONS-----------------------------------------------------------------------------------51
CLIENT SOFTWARE:-------------------------------------------------------------------------------------------------------------51
IRM STAFF:----------------------------------------------------------------------------------------------------------------------51
VISTA MHA 2 FILES RETRIEVAL LOCATIONS AND FORMATS-------------------------------------------------------------51
VISTA MHA 2 Files Retrieval Formats-----------------------------------------------------------------------------------52
MENTAL HEALTH ASSISTANT INSTALL WINDOWS ILLUSTRATIONS-------------------------------------------------------53
Installing Mental Health Assistant on your Computer------------------------------------------------------------------53
Setup complete----------------------------------------------------------------------------------------------------------------55
Overview
The primary goal is to make the VistA Mental Health Package (MHP) V. 5.01 an effective, more
efficient tool for use by mental health clinicians and their patients with the creation of a windows
based application for the most commonly used options in the MHP. Currently the MHP is
administered through VistA’s roll-and-scroll technology. Interviews are generally recorded on
paper and entered later by the clinician or clerk because the roll and scroll technology is not
conducive to following the natural flow of conversation. The development of a windows based
software application to enter and display the Global Assessment of Functioning (GAF) score, the
Addiction Severity Index (ASI), and 60 psychological tests will make the MHP more user-
friendly. This will provide a Graphical User Interface (GUI) format for the entry of GAF, ASI
assessments, display of reports and results of psychological tests and interviews.
MHA Version 2 exports the Graphical User Interface (GUI) to the MHP most frequently used
functionality (i.e., Addiction Severity Index (ASI), Global Assessment of Functioning (GAF),
and Psychological testing).
Patient Demographics
Displays patient demographics data, which can be printed, copied to the Windows clipboard,
or saved to a text file.
NOTE: The Patient Entry window is the only test data entry method that activates the Secure
Desktop features. Therefore, neither Staff Entry nor Clerk Entry should be used for the on-line
testing of patients.
The Secure Desktop is a set of security features intended to prevent unattended patients taking
on-line tests from using the PC for other purposes. Secure Desktop commands the Patient
Entry window to cover the entire PC desktop. Non-alphanumeric keys are trapped to keep the
patient from using the task bar and operating system functions (such as Task Manager).
The following security features cannot be defeated once the Patient Entry window becomes
active, so it is essential that all other applications be closed and data saved before Patient Entry
begins:
Example: The following Patient Entry window activates the secured desktop features when
the Patient Entry is selected. After the Patient Entry selection is made, two Warning dialog
boxes are displayed.
Example: The first Warning Dialog Box states “After this programs ends, it is going to
automatically log you off from the Windows NT Network.” Click on the YES command button
to proceed. The YES command button response displays a second Warning dialog box. Click
Cancel to return to the Windows NT Network.
Example: The second Warning dialog box states, “Use ONLY Alpha-Numeric Keys on the
keyboard from this point on.” Click on the OK command button to continue the Patient Entry
functions.
Authorized Keystrokes
Authorized keystrokes are entered in response to the on-screen questions. Authorized keys are
A..Z, a..z, 0..9, ENTER and SHIFT key. Keystrokes trigger the next question to be displayed.
Unauthorized Keystrokes
Strike 5-10 unauthorized keystrokes. Windows shuts down all active programs and logs off the
current user, forcing a user to log on again.
Complete a test window shuts down all active programs and logs off the current user, forcing a
user to log onto the system again.
Enhancements:
1. Four new psychological tests, the Millon Behavioral Medicine Diagnostic (MBMD), the Beck
Depression Inventory-II (BDI2), the Millon Clinical Multiaxial Inventory-III (MCMI3) and the
Brief Symptom Inventory 18 (BSI18) have been added to the MH INSTRUMENT file (#601).
All can now be administered using MHA. The results of the MCMI3, the BSI18, and MBMD
can be viewed using the multi-scale graph window (the BDI2 is a single scale instrument).
Context sensitive descriptions of the new tests were added to the Help file.
2. Entries to the COPYRIGHT HOLDER file (#601.3) have been made for the new
psychological tests MBMD, BDI2, MCMI3, and BSI18.
3. For the psychological test Minnesota Multiphasic Personality Inventory-2 (MMPI2), several
changes have been made in the scales that are scored and displayed. Five new scales are now
scored (the PSY-5 Personality Psychopathology Five). The Subtle-Obvious and Non-K Corrected
scales are no longer scored or displayed. The user can choose to display all validity scales at
once (Expanded Validity) or just the L, F, K scales (Basic Validity). In MHA Version 2 the multi-
scale graph option has been revised to display the new scales.
4. On the main window of Test Results, Order Tests, ASI or GAF tabs, a right mouse click brings
up a pop-up menu with options for each of the enabled buttons on the active tab.
5. A pop-up menu was added to the window used for graphically displaying the results of both
multi-scale tests and ASI domain scores. The pop-up menu, which is activated by a right-click,
permits the user to copy, print or save either a graph or a table.
6. If MHA is launched from the CPRS Tools menu, MHA accepts parameters (such as Patient
DFN) passed by CPRS. This eliminates the need to select a patient a second time and ensures
that the same patient is always selected by both applications if both are open. When CPRS is
closed, MHA will be closed automatically.
7. MHA can be launched from the CPRS Tools menu without having to sign on a second time if
the RPC Broker workstation client software is installed on the PC and single sign-on is enabled
on VistA.
8. Upon closing the Staff Entry window, the user is given the option of saving the test results to
VistA. Previously, the option of saving results were given only if all the test questions had not
been answered. Completed tests were automatically saved. The change gives the user control
over whether the data are saved and makes the exit process the same whether the test was
completed or not.
9. To make the patient selection key sequence the same as that used in CPRS, the Select Patient
menu caption was changed from “Select New Patient” to “Select New Patient”.
10. If a patient is deceased, the user is notified of that and asked if they want to proceed before
allowing entry of a new GAF rating, psychological test, or ASI. If the user proceeds, the GAF
rating date or ASI admission/interview dates cannot be greater than the date of death.
Constraining the date of psychological test data for staff and clerk entry will require a
modification to the MH INSTRUMENT file (#601).
11. ASI comment fields were saved to VistA in a way that caused word wrap problems. The
comments fields now are formatted correctly.
12. In MHA Version 1, the ASI data-entry form, when clicking on an up or down arrow in a spin-
edit item, the spin-edit item with focus was increased or decreased. Any up or down arrow click
would have its impact on the field with focus, even arrows for other items. The current version
allows only the up and down arrows associated with that spin-edit item to have any effect.
13. In MHA Version 1, the executable was named YS50171_MHA.exe to reflect both the
associated VistA Patch YS*5.01*71 and the Delphi application build number (123). However,
this method of naming the executable will require a new name with each release, which will
increase the difficulty of installing future releases. In MHA Version 2, the executable is named
YS_MHA.exe, which will be used for all future MHA software releases.
Modifications
1. In MHA Version 1, some windows were closed by a button captioned “Close” and others were
closed by a button captioned “Return”. All such buttons are now captioned “Close”.
2. On the Staff Entry window, the button that returns the user to a previously answered question
was captioned “Back Up.” Because this caption could be misunderstood as meaning data would
be saved to a backup archive, the caption was changed to “Previous.”
3. By convention, “OK” buttons appear to the left of “Cancel” buttons, but on some MHA
windows their positions were reversed. These two buttons now appear in conventional order on
all windows.
4. To make them more readable, the “>” captions on the buttons on the Order Tests tab were
changed to bold font.
5. The MMP2S is a short form of the MMPI2. In MHA Version 1, scores from the two forms of
the test could not be compared on the multi-scale graph window. The user is now given that
option.
6. When printed, graphs did not include the patient name and yellow lines were not visible on
monochrome printers. Patient name is now a footer on all printed graphs, and the yellow lines
have been made black.
7. The following instruments in the MH INSTRUMENT (#601) file: 16PF, MMPI, M168,
MCMI, CES, CPI, FES, FIRO, GES, MYER, WES, and SII are copyrighted tests that VACO
does not have a license to use. When the user selects one of these instruments they receive the
message “USER,MARK is NOT AUTHORIZED to order Instrument GES.” Now, when the user
selects one of these instruments the message returned is “[VACO currently does not have a
license to use this test].” This message is only displayed on the list manager version of Mental
Health V. 5.01. In the MHA GUI non-copyrighted tests that VACO does not have a license to use
are not viewable from Available Lists box.
8.The ASI NARRATIVE file (#604.68) data has been edited to correct problems with the logic
and executable code to produce a report for the Addiction Severity Index that reads like a
clinician's written report. The entries modified are GENERAL, FULL ITEM REPORT, LITE
ITEM REPORT, FOLLOWUP ITEM REPORT, FOLLOWUP NARRATIVE, ASI-MV ITEM
REPORT and the ASI-MV NARRATIVE.
9. During initialization of the main window of the Test Results tab, the appropriate notice did not
appear if the user did not have the YSP key and the first test in the list of previous tests was non-
exempt.
10. An error occurred if the Domain Scores button on the main window of the ASI tab was
clicked for a patient for whom there were no complete ASI records to display. This problem was
corrected by disabling the button if the patient did not have at least one signed ASI with all
questions answered (i.e., not a G-12 record).
11. Short-cut keys were working on the main, staff entry and clerk entry windows even though
the Alt key was not pressed. This has now been corrected to work only when the Alt key has
been pressed.
12. Signing an ASI-MV was not possible without first loading the data into the ASI data entry
window. Because there are some differences between the ASI-MV and a regular ASI, loading the
ASI-MV into the ASI data entry window caused data validation errors when the record was
saved to VistA. Signing an ASI-MV is now possible without loading the results into the data
entry window.
13. Incorrect source code was used to determine whether the user was the ASI interviewer, who
is the only person who can sign the interview. Consequently, a new ASI could not be signed
without first saving it to VistA and then reloading it into the data entry window.
14. On the main window of the Order Tests tab, if either the list box containing test choices or
the list box containing tests that had been selected had focus, context sensitive help was not
available for the selected test in the list box. The context ID of the selected test now is set on the
list box click event.
15. In MHA Version 1, ASI comments were not saved for Spiritual Status and Leisure Time
Status. In MHA Version 2, these comments are now saved.
16. Sometimes, when MHA Version 1, is run as a server application, the Help file could not be
found. In MHA Version 2, the help file path is now dynamically set.
17. When using option, Delete unsigned ASI [YSAS ASI DATA DELETION] the user received
an error %DSM-E-STRLEN, string too long, DSM-I-ATLABEL, TLD+11^YSASSEL:1. This
error occurred on a test patient. An initial ASI is administered to a patient once they enter the
substance abuse program. A follow-up ASI is then administered every six months the patient is in
the program. This error has been corrected by lowering the $PIECE field position TO from 40 to
20.
18. When a user selects the multi-graph button for multi-graph tests (i.e., MMPI2) undefined
variable error occurs. This error has been corrected.
19. When a user selects the multi-graph button for multi-graph tests for the SF36 and the score
equals 100, they received an “invalid integer” message. On the multiscale window, the table now
lists the correct scale scores (i.e., real numbers, not integers). This has been corrected in the
MHA GUI source.
20. The instruction text for patient administered tests in MHA Version 1, is too small and did not
contrast well with the grey background. In MHA Version 2, the font size has been increased to 10
points and the background color has been changed to white.
Security Management
There are no unique legal requirements pertaining to Mental Health Assistant software
application with the exception that some of the psychological tests are copyrighted. Copyrighted
tests are used by permission of the copyright holders. Use of these tests must be consistent with
contracts between VHA and copyright holders.
Security Features:
Secure Desktop
Secure Desktop is a set of security features intended to prevent unattended patients taking on-line
tests from using the Personal Computer (PC) for other purposes. The Secure Desktop features
construct the Patient Entry window to cover the entire PC desktop. Non-alphanumeric keys are
trapped to keep the patient from using the task bar and operating system functions (such as Task
Manager). The Patient Entry function is the only test data entry method that activates the Secure
Desktop features. Therefore, neither Staff Entry nor Clerk Entry should be used for the on-line
testing of patients. The Secure Desktop security features cannot be defeated once the Patient
Entry window becomes active. Excessive non-alphanumeric keystrokes are interpreted as
“hacking” efforts and MHA is terminated. At the end of the testing session, MHA is terminated.
Upon termination the Windows NT session is logged off, which means the user has to enter their
NT user name and password to log back on to the desktop.
Mail Groups:
No mail groups are required for MHA Version 2 software release.
Alerts:
No alerts are required for MHA Version 2.
Remote Systems:
All GAF scores entered through the Mental Health Assistant GAF tab are dynamically sent to the
National Patient Care Database (NPCD) at the Austin Automation Center (AAC).
MH YT and YS RPCs
Registration DG RPCs
Archiving/Purging:
Contingency Planning:
Each facility using the MHA software application must develop a local contingency plan to be
used in the event of application problems in a live environment. The facility contingency plan
must identify procedures used for maintaining the functionality provided by the software in the
event of a system outage.
Interfacing:
The non-menu option, YS BROKER1 [YS BROKER1] contains the context necessary to
interface MHA Version 2, software application to the VistA database.
Electronic Signatures:
MHA Version 2, Addiction Severity Index (ASI) software component utilizes the electronic
signature functionality.
Menus
MHA 2 software does not contain any menu options of particular interest to Information Security
Officers (ISOs).
Security Keys:
MHA 2, software application did not release any new security keys. However, the YSP security
key is required to control access to the results of “non-exempt” tests. Holders of the YSP security
key are controlled (i.e., given out by the Chief of Psychology or a senior psychologist) at a
facility that does not have a Chief of Psychology. The Chief of Psychology or senior
psychologist also determines which tests are “exempt” (i.e., the results can be seen by anyone),
and which are “non-exempt” (i.e., require the YSP key to see the results).
File Security:
There is no file security associated with the release of MHA Version 2 software application.
References:
Official Policies:
There is no official policy unique to the MHA Version 2 software application regarding the
modification of the software and distribution of the product.
Recommended Users:
IRM staff is recommended for installing and supporting MHA 2, Patch YS*5.01*76
requirements.
It is recommended that Mental Health clinicians enter the MH patient demographics data and
define the MH interviews parameters.
Test Sites
Test Sites Hardware Platform
Miami VAMC, FL DEC Alpha VMS/DSM
Windows Conventions
MHA 2 software application uses a Graphical User Interface (GUI) for the startup, setup, and
assignment functions.
Mental Health V. 5.01 Package currently runs on the standard hardware platforms used by the
Department of Veterans Affairs Health Care System facilities. These hardware platforms consist
of standard or upgraded Alpha AXP clusters, and run either VMS or NT and the Open M product.
All current 486 sites are being converted to Alpha 1000A AXP Cluster, NT and Open M
platforms.
There are no significant changes in the performance capacity of the VistA operating system once
the Mental Health Assistant Version 2 Patch YS*5.01*76 is installed. The software application
should not create any appreciable global growth or network transmission problems. There are no
memory constraints.
MHA 2 software application for Windows 2000 or NT Operating System CPU requirement is a
minimum of 133 MHz.
MHA 2 Patch YS*5.01*76 installation time is less than 5 minutes during off peak
hours.
MHA users may remain on the system. However, installation of Patch YS*5.01*76, should be
done during off peak hours.
Backup Routines
It is highly recommended that a backup of the transport global be performed before installing the
VistA Mental Health Assistant Version 2, Patch YS*5.01*76.
NOTE: For further instructions on using KIDS, please refer to the Kernel Version 8.0 Systems
Manual.
Namespace
The following software MUST be installed prior to installing MHA 2, patch YS*5.01*76:
Required Patches
The following patches MUST be installed prior to installing MHA 2 Patch YS*5.01*76:
The non-menu option, YS BROKER1 [YS BROKER1] contains the context necessary to
interface the VistA Mental Health Assistant Version 2 software application to the VistA database.
The following DBIAs were approved for the release of VistA MHA software application:
DBIA #418 - Mental Health is also a subscriber to IA #418. This agreement is written more
specifically than IA #564 and outlines the fields and cross-references access by the application.
IA #564 gives the access by nodes rather than field names. Requested the additional cross-
reference be added to #418.
DBIA #564 - Mental Health has subscribed to IA #564, but we also need to do a Global Read of
^DGPT("AF".
DBIA #1024 - Health Summary accesses file ^DIC(40.7, to display the Name of the Clinic Stop
in one of its components.
DBIA #1649 - ORQPT DEFAULT PATIENT LISTS: This remote procedure returns the current
user's default patient list wards to be used in the Mental Health Assistant GUI.
DBIA #1676 - ORQPT WARDS: This remote procedure returns a list of wards to be used in the
Mental Health Assistant GUI.
DBIA #3371 - ORWU HASKEY: This remote procedure returns 1 if a user holds a security key,
otherwise 0 to be used in the Mental Health Assistant GUI.
The following files changes were created for the MHA GUI Version II:
The MH INSTRUMENT file (#601) was edited to add the following four new psychological
tests:
Millon Behavioral Medicine Diagnostic (MBMD)
Beck Depression Inventory-II (BDI2)
Millon Clinical Multiaxial Inventory-III (MCMI3)
Brief Symptom Inventory 18 (BSI18)
MH INSTRUMENT file (#601) message text was changed from “BLOW, JOE is NOT
AUTHORIZED to order Instrument GES” to “[VACO currently does not have a license to use
this test]” because the following instruments stored in this file are copyrighted tests and VA
Central Office (VACO) does not have a license to use: 16PF, MMPI, M168, MCMI, CES, CPI,
FES, FIRO, GES, MYER, WES, and SII.
NOTE: This message is only displayed on the roll ‘n’ scroll version of Mental Health V. 5.01.
The Minnesota Multiphasic Personality Inventory-2 (MMPI2) psychological test contains several
changes in the scales that are scored and displayed. Five new scales are now scored (i.e., PSY-5
Personality Psychopathology Five). The Subtle-Obvious and Non-K Corrected scales are no
longer scored or displayed. The user can choose to display all validity scales at once (Expanded
Validity) or just the L, F, K scales (Basic Validity).
This file was edited to add three of the four new psychological tests (i.e., MBMD, MCMI3 and
BSI18). The new psychological test BDI2 is non-copyrighted and does not need to be added to
the COPYRIGHT HOLDER file (#601.3).
ASI NARRATIVE file (#604.68) was modified to correct problems with the logic and
executable code that produces the Addiction Severity Index Report that reads like a clinician's
written report. The entries modified are GENERAL, FULL ITEM REPORT, LITE ITEM
REPORT, FOLLOWUP ITEM REPORT, FOLLOWUP NARRATIVE, ASI-MV ITEM REPORT
and the ASI-MV NARRATIVE.
Remote Procedures
VISTA MHA Patch YS*5.01*76, uses the following Remote Procedures (RPCs):
YSDATA(1)=[DATA]
YSDATA(2)=ALCOHOL^FACTOR SCORE^T SCORE
YSDATA(1)=[DATA]
YSDATA(2)= IEN^DATE OF INTERVIEW^CLASS^SPECIAL^ESIGNED
0 RETURNED IF NO ADMINS
YSDATA(1)=[DATA]/[ERROR]
YSDATA(2)=OK Progress Note created/No Pnote entered
YSDATA(1)=[DATA]
YSDATA(2)=OK ASI SAVE YSIEN
Input Required:
CODE: electronic signature code
IEN: ien of ASI in file 604
Output: YSDATA(1)=[DATA]
YSDATA(x)= Field #^Question name^is it Required^Answer
Input:
DFN : patient internal identifier
BEGIN: inclusive date in %DT acceptable format (11/11/2011)
to begin search [optional]
END: inclusive date in %DT acceptable format (11/11/2011)
to end search [optional]
CODE: YS("CODE")="GAF" set to optionally return GAF
administrations
Output:
YSDATA(1)=[DATA]
YSDATA(x)= internal administration date^external administration
date^test code
Input:
DFN : patient internal identifier
CODE: Test code from file 601 including "ASI" and "GAF" e.g.
"CAGE", "BDI"
BEGIN: inclusive date in %DT acceptable format (11/11/2011) to begin
search [optional]
END: inclusive date in %DT acceptable format (11/11/2011) to end
search [optional]
LIMIT: constrains to the last N administrations [optional]
Scale: scale number from file 601 or 1-7 on ASI [optional]
Output:
YSDATA(1)=[DATA]
YSDATA(x)= internal administration date ^ external administration
date^test code [^scale name^raw score^transformed score]
Input Required:
DFN - Patient IEN
GAF - GAF Score (Axis 5)
DATE - Date/Time of Diagnosis
STAFF - Diagnosis By DUZ
Output: only reports success vs. error
YSDATA(1)=[DATA] VS. YSDATA(1)=[ERROR]
Input:
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
And onward as needed
Output:
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
And onward as needed
Array("ON")= output text
Input:
DFN: patient internal identifier
CODE: Test code from file 601 or "ASI" e.g. "CAGE", "BDI"
ADATE: inclusive administration date in %DT acceptable format
(11/11/2011)
Staff: DUZ of professional ordering the test
R1: string of patient responses 1-200
R2: string of patient responses 201-400 [as needed]
R3: string of patient responses 401-600 [as needed]
Output:
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
And onward as needed
Input:
CODE: Test code from file 601 e.g. "CAGE", "BDI"
Output:
Array(1)=[DATA] ;indicates successful call
Array(2)=MMPI2 ;SECOND LINE IS TEST Code
Array(x)=first item number^I^introductory text
Array(x)=first item number^T^text of question
Array(x)=first item number^A^allowed responses
Array(x)= first item number^R^response cues
Input:
DFN ;ien of file 2 Patient
YSCODE: code of test in file 604
YSNEXT: next item number to be answered
YSORDER: DUZ of staff ordering test
R1: array of answers 1-200
R2: array of answers 201-400
R3: array of answers 401-600
Output:
YSDATA(1)=[DATA]
YSDATA(2)=saved ok
RESULT(1)="[DATA]",RESULT(2)="Save ok"
Input:
DFN : patient internal identifier
CODE: Test code from file 601 or "ASI" e.g. "CAGE", "BDI"
ADATE: inclusive administration date in %DT acceptable format (11/11/2011)
Staff: DUZ of professional ordering the test
R1: string of patient responses 1-200
R2: string of patient responses 201-400 [as needed]
R3: string of patient responses 401-600 [as needed]
Output:
Array(1)=[DATA] indicates successful call
Input:
DFN : patient internal identifier
CODE: Test code from file 601 or "ASI" e.g. "CAGE", "BDI"
ADATE: inclusive administration date in %DT acceptable format (11/11/2011)
Output:
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
And onward as needed
Input:
CODE: Test code from file 601 e.g. "CAGE", "BDI"
Output:
Array(1)=[DATA] ;indicates successful call
Array(2)=MMPI2 ;SECOND LINE IS TEST Code
Array(item number,"I",line number)=introductory text
Array(item number,"T", line number)=text of question
Array(item number,"R",0)=allowed responses
Array(item number,"R",line number)= response cues
Input:
CODE: Test code from file 601 e.g. "CAGE", "BDI" ITEM: a positive
whole number between 1 and the highest item number for the
specified test.
Output:
Array(1)=[DATA] ;indicates successful call
Array(2)=MMPI2^1 ;SECOND LINE IS TEST Code^ item number
Array(item number,"I",line number)=introductory text
Array(item number,"T", line number)=text of question
Array(item number,"R",0)=allowed responses
Array(item number,"R",line number)= response cues
Input: none
Output:
YSDATA(1)=[DATA]
YSADAT(x)=battery name^test1^test2^test3^test4
Output:
only success vs. error is reported.
YSDATA(1)=[DATA]
Routine Summary
The second line of the routine now looks like: <tab> 5.01;; MENTAL HEALTH;**[patch
list]**; Dec 30, 1994
NOTE: VISTA Mental Health Assistant Patch YS*5.01*76, uses the Kernel Installation and
Distribution System (KIDS). For further instructions on using KIDS, please refer to the Kernel V.
8.0 Systems Manual.
Server:
NOTE: This patch should be installed during ‘OFF PEAK’ hours when few or no users are on
the system. Installation of the patch will take less than 5 minutes.
1. Use the ‘LOAD A DISTRIBUTION’ option on the PackMan menu. The Host File name is
YS_501_76.KID. Answer YES to the question:
“Want to Continue with Load? YES//”
2. The patch has now been loaded into a Transport global on your system. You now need to use
KIDS to install the Transport global. On the KIDS menu, under the ‘Installation’ menu, use
the following options:
3. Users may remain on the system, but installation should be done at off peak hours.
5. From the ‘Installation Menu’ of the KIDS menu, run the option ‘Install Package(s)’ Select the
package ‘YS*5.01*76’ and proceed with install.
6. When prompted “Want KIDS to INHIBIT LOGONs during the install//” respond NO.
When prompted “Want to DISABLE Scheduled Options, Menu Options, and Protocols?
YES//” respond NO.
7. Place the MENTAL HEALTH ASSISTANT VERSION 2 USER MANUAL in a location that
can be accessed by MHA users.
9. Place the option YS BROKER1 [YS BROKER1] on the Mental Health users secondary menu.
1 Load a Distribution
2 Verify Checksums in Transport Global
3 Print Transport Global
4 Compare Transport Global to Current System
5 Backup a Transport Global
6 Install Package(s)
Restart Install of Package(s)
Unload a Distribution
PU Patch Update
Distribution OK!
Loading Distribution...
YS*5.01*76
1 Load a Distribution
2 Verify Checksums in Transport Global
3 Print Transport Global
4 Compare Transport Global to Current System
5 Backup a Transport Global
6 Install Package(s)
Restart Install of Package(s)
Unload a Distribution
PU Patch Update
Incoming Files:
Installing Routines:
Mar 18, 2003@17:42:32
Installing Data:
Mar 18, 2003@17:42:55
YS*5.01*76 Installed.
Mar 18, 2003@17:42:56
Client Software:
NOTE: This version of the client software can be installed as either a patch to the existing client
software or as a new installation.
IRM Staff:
NOTE: In MHA Version 1, the executable was named YS50171_MHA.exe to reflect both the
associated VistA Patch YS*5.01*71 and the Delphi application build number (123). However,
this method of naming the executable will require a new name with each release, which will
increase the difficulty of installing future releases. In MHA Version 2, the executable is named
YS_MHA.exe, which will be used for all future MHA software releases.
MHA Version 2, software files are available on the following OIFOs ANONYMOUS.
SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files.
Use the FTP address “download.vista.med.va.gov” (without the quotes) to connect to the first
available FTP server where the files are located.
3. Run the YS50176_Setup_124.EXE file (i.e., double click on it). This starts the MHA 2,
installation process. (See the Mental Health Assistant Version 2 software Installation process
illustrations on the following pages).
The following illustrates the Mental Health Assistant Install windows. When the default
responses are accepted, MHA 2 is installed into the appropriate VistA directory on the user’s
workstation.
Example: From the Mental Health Assistant Welcome dialog box, click on the Next command
button (located at the bottom of the window) to continue with the install. The Choose
Destination Location dialog box will appear next stating, “Which drive do you want to install
this program into?”
Example: The Choose Destination Location dialog box text asks “Which directory do you
want to install this program into? We strongly recommend that while the drive can be modified,
the default directory be used (Drive:\Program Files\Vista\YSMHA).
Which directory do you want to install this program into?
Setup complete
Example: The Setup complete dialog box text states that, “The Mental Health Assistant has
been properly installed. You may start the software by clicking on the icon on your desktop.”
Click on the Finish command button (located within the dialog box bottom right side) and the
MHA software application setup is complete.