Name	Value
NAME	MENTAL HEALTH
PREFIX	YS
DEVELOPER (PERSON/SITE)	Mark Devlin - Dallas ISC
*LOWEST FILE NUMBER	90
*HIGHEST FILE NUMBER	628
DEVELOPMENT ISC	Dallas ISC
CLASS	National
ADDITIONAL PREFIXES	RUCL
SHORT DESCRIPTION	Version 5.01 of Mental Health
VERSION	5.01 DATE DISTRIBUTED: 2005-11-19 00:00:00 PATCH APPLICATION HISTORY: 21 SEQ #20 DATE APPLIED: 1996-09-03 00:00:00 APPLIED BY: USER,ONE 32 SEQ #29 DATE APPLIED: 1997-09-22 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch is being released to correct problems with YS5.0130. 172 SEQ #130 DATE APPLIED: 2021-04-05 09:44:23 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Add Personal Health Inventory (PHI) as a new mental health instrument. 173b DATE APPLIED: 2021-04-09 00:00:00 DESCRIPTION: Backup of YS5.01173 on Apr 09, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 173 SEQ #131 DATE APPLIED: 2021-04-09 10:26:47 APPLIED BY: USER,SEVENTEEN DESCRIPTION: This build inactivates the "I9" instruments, as they have been superseded by the C-SSRS screener. The C-SSRS has been set so that it must be completed in one session. New versions of the PROMIS29 are added. 175b DATE APPLIED: 2021-04-20 00:00:00 DESCRIPTION: Backup of YS5.01175 on Apr 20, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 175 SEQ #132 DATE APPLIED: 2021-04-20 15:05:28 APPLIED BY: USER,SEVENTEEN DESCRIPTION: See FORUM Patch Description. 171b DATE APPLIED: 2021-04-22 00:00:00 DESCRIPTION: Backup of YS5.01171 on Apr 22, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 171 SEQ #133 DATE APPLIED: 2021-04-22 12:32:56 APPLIED BY: USER,SEVENTEEN DESCRIPTION: This patch addresses the following issues: 1. If a user elects to produce an XML Export by location, validation is not referencing the correct location file. 2. The user is not allowed to gracefully exit various prompts by entering "^" or return. 158b DATE APPLIED: 2021-05-12 00:00:00 DESCRIPTION: Backup of YS5.01158 on May 12, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 158 SEQ #134 DATE APPLIED: 2021-05-12 15:16:15 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Mental Health web application support 174b DATE APPLIED: 2021-06-10 00:00:00 DESCRIPTION: Backup of YS5.01174 on Jun 10, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 33 SEQ #30 DATE APPLIED: 1997-11-27 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This enhancement patch will introduce the Global Assessment of Functioning (GAF) to the Mental Health software. This patch introduces two alternate ways of entering a GAF score (Axis 5) and two new reports. The existing Diagnostic software has been modified to now accept the GAF score from 100-1. 174 SEQ #135 DATE APPLIED: 2021-06-10 10:02:37 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Add Case Mix Index as an instrument. 170 DATE APPLIED: 2021-07-01 11:28:00 APPLIED BY: USER,SEVENTEEN DESCRIPTION: See the patch description for more detailed information. This build updates the DLL version for the YS BROKER1 option. 177b DATE APPLIED: 2021-07-01 00:00:00 DESCRIPTION: Backup of YS5.01177 on Jul 01, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. 177 SEQ #138 DATE APPLIED: 2021-07-01 11:30:33 APPLIED BY: USER,SEVENTEEN DESCRIPTION: New Instruments: SRCS, NPO-Q, B-IPF 178 SEQ #141 DATE APPLIED: 2021-09-20 13:14:46 APPLIED BY: USER,SEVENTEEN DESCRIPTION: MHA WEB STAFF ENTRY UDPATE 182 SEQ #144 DATE APPLIED: 2021-10-21 15:18:34 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Adds Computer Adaptive Testing (CAT) capability to MHA-Web. 181 SEQ #145 DATE APPLIED: 2021-11-29 09:59:24 APPLIED BY: USER,SEVENTEEN DESCRIPTION: MHA WEB STAFF ENTRY UDPATE Features added include: - Improved Consult UI on the front end - VistA RPCs to Save and Get User Instrument Battery definitions - VistA RPCs to Save MH Administration Comments - Update to C-SSRS to not allow partial completion - 508 Defect fixes - Backwards compatibility patch for YS5.01182 187 SEQ #148 DATE APPLIED: 2022-02-16 12:21:17 APPLIED BY: USER,EIGHTYFOUR DESCRIPTION: MHA WEB PATIENT ENTRY UDPATE 193 SEQ #150 DATE APPLIED: 2022-03-21 19:27:01 APPLIED BY: USER,EIGHTYSIX DESCRIPTION: This patch resolves the following issue: 1) INC19506614 - Cannot create Lab test using YSCL TEST LINK--Clozapine Test Link. Every time you try to add the Neutrophil Count it gives a Z error. 199 SEQ #153 DATE APPLIED: 2022-05-19 13:13:50 APPLIED BY: USER,EIGHTYSIX DESCRIPTION: Update for MHA Web WHODAS2.0-12 Barthel Index changed to Staff Entry Only Instrument Authors updated for: BASIS-24 PSYCHOSIS BBHI-2 C-SSRS I9+C-SSRS PSS-3 PSS-3 2ND 29 SEQ #31 DATE APPLIED: 1997-11-27 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: The Mental Health protocol YS PATIENT MOVEMENT, which is part of the DGPM MOVEMENT EVENTS protocol, has been modified to run silent when invoked by Order Entry/Results Reporting. 207 SEQ #155 DATE APPLIED: 2022-07-06 15:55:12 APPLIED BY: USER,EIGHTYSIX DESCRIPTION: Emergency patch to YS5.01199 any progress notes aggregated in that data entry session was lost. Update NUDESC instrument in MH TEST/SURVEY SPEC file - Instrument Name changes from NuDESC to NUDESC Fix bug where if the last instrument in an Assignment is a Restricted Instrument, then any progress notes aggregated in that data entry session was lost. Fix bug where if the last instrument in an Assignment is Deleted, then 211 DATE APPLIED: 2022-10-05 14:55:08 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Please see the patch description for the full information regarding this patch/build. 202 DATE APPLIED: 2022-10-12 09:38:56 APPLIED BY: USER,NINETY DESCRIPTION: MHA Web update Version. -Update BASIS-24 instrument for blank fields. -Update FAST instrument scoring. -Update FOCI skip logic. -Update MCMI4 to allow skipped questions and not allow >13 skipped. -Update SLUMS and GDS DEMENTIA to add story text to JSON in the MH TEST/SURVEY SPEC file. -Add Instrument Interpretive Text data to MH TESTS AND SURVEYS file. -Add RPC to get Interpretive Text for instruments. -Update Instrument Exchange to transport INTERPRETIVE TEXT for -Add Print Title to individual instruments for printing. instruments, ROUTINE FOR SUICIDE RISK and TAG FOR SUICIDE RISK. -Update PHI question text. -Update Location input box to search for both clinics and wards. -Update Location input to allow locations starting with numbers and if entered text is exact match to a location. -Update Ordered By, Interviewer, and Location input box to allow / and ~ -Add CAT-PSYCHOSIS, EHS-14, PEBS-20, PEBS-27, WBS, ASRS, and DAR-5 instruments. -Update Print Title for PCL-5, PCL-5 Weekly, CAD-PTSD-DX, and CSI Partner 217 SEQ #161 DATE APPLIED: 2023-01-18 16:14:11 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: NEW AND UPDATES TO INSTRUMENTS Add Elapsed Time to CAT/CAD. Save active user with and administration. Update MCMI4 to fix negative and >115 Adjusted Base Rate scores. Add EDE-Q and CIA instruments. Update CESD graph scale. Update instrument categories for instruments. Change Pain instrument category to Pain/Health. Change Instrument name from ASRS to ASRS-6. Use incremental locks to save responses and results. Raise limit of administrations and result records allowed. Add answer and result records to Administration Detail option. 204 SEQ #162 DATE APPLIED: 2023-03-13 15:30:02 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: MHA Web integration with MHC. SIP-AD-START - Addiction-SUD SWEMWBS - Cognitive Update instrument name of ASRS to ASRS-6 Add new instruments for MHA: EDE-Q CIA Update locking of answer and result files. Add answer and result display to YTQR ADMINISTRATION DETAIL. Instrument Categories added for: NUDESC - Cognitive SIP-AD-30 - Addiction-SUD 218 SEQ #165 DATE APPLIED: 2023-03-30 11:49:37 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: New instruments: PROMIS10, SBAF, SBAF-PTSD, MIOS+B-IPF, MIDAS, HIT6 Updated instruments: PCL-5, PCL-5 Weekly, Morse Falls Scale Reports changed to use self-identified gender Set instruments to staff-entry only: CASE MIX, PSS-3 2ND, AD8 Set instrument to patient-entry and staff-entry: COPD Fix bug with Instrument Exchange when using HTTPS 228 SEQ #166 DATE APPLIED: 2023-05-23 09:39:15 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Patch to update non-legacy instrument score retrieval for graphing results. 208 SEQ #168 DATE APPLIED: 2023-07-06 17:39:02 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: MHA Web Updates New Instruments: GASS Updated Instruments: FAST Add RPC for Patient Entry Cosigner validation Update Dashboard High Risk with error trap Update MHA Web user name lookup to handle exact matches 235 SEQ #169 DATE APPLIED: 2023-07-21 09:50:39 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Fix locking issue that was allowing responses from one administration to occasionally overwrite responses from another administration. 221 SEQ #170 DATE APPLIED: 2023-09-19 11:17:27 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: MHA Web Updates -MHC integration -Overdue Assignment functionality -Scheduled Assignment Edit functionality Instrument updates -MHLA, MHLB, MHLC-C non-restricted -MCMI4 Fix scale graphing results 99+ 37 SEQ #32 DATE APPLIED: 1998-04-17 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch has all changes for Mental Health V. 5.01 to be Year 2000 compliant. 233 SEQ #172 DATE APPLIED: 2023-09-28 10:28:19 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: The patch releases new instruments used with long COVID. 241 SEQ #173 DATE APPLIED: 2023-10-16 14:29:59 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Emergency patch for WBS_V2. 223 SEQ #174 DATE APPLIED: 2023-10-26 10:56:06 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Back-end updates to support using web-based staff-entry of MHA inside the CPRS Mental Health DLL. The older Windows-based DLL is called YS_MHA_A_XE10.dll The newer Web-based version is called YS_MHA_A_WEB.dll 234 SEQ #175 DATE APPLIED: 2023-12-27 11:57:19 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: New Instruments and Instrument Updates. PEG LVVFQ MINICOG PSEQ-2 NPI-Q EAT-26 AUDC D.ERS - Fix IMPULSE scale, remove Complex Instrument from report. MCMI4 - Fix spelling Childhood Abuse. BSI18 - Fix to use biological sex for scoring. MDQ BAM-C-CBT-SUD BAM-R-CSG-SUD BAM-IOP-CSG-SUD CMAI 238 SEQ #176 DATE APPLIED: 2024-02-21 10:17:28 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Instrument patch Fix error in legacy instrument scoring with self-identified gender R PRIV report update. Additional check for instruments that have an administration ID is added before allowing an assignment to be edited. Addition of Time/Timezone information to patient identifier RPC. Modify user timeout to check user level first. BBGS, SODU, SDSQ, G-SAS Update COVID category to Long COVID Update Print Title to add acronym for BAM-C-CBT-SUD, BAM-IOP-CSG-SUD, BAM-R-CSG-SUD Deactivate MIOS+B-IPF and add MIOS+B-IPF V2 Update Case Mix scoring. Fix spelling error in PAI instrument Fix spelling error in GDS instrument 244 SEQ #177 DATE APPLIED: 2024-03-04 10:11:47 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: See patch description. 239 SEQ #178 DATE APPLIED: 2024-03-25 09:57:39 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Add RPC calls for cloud database. Update BAM-R-CSG-SUD, BAM-IOP-CSG-SUD, BAM-C-CBT-SUD for date picker field. New instruments. CDSS PCL-5 DAILY WURS-25 ASRS LEC Update instrument ASRS-6 Update WHYMPI instrument 227 SEQ #179 DATE APPLIED: 2024-05-06 12:06:14 APPLIED BY: USER,EIGHTYNINE 224 SEQ #180 DATE APPLIED: 2024-06-11 11:15:01 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Updates to MHA Web including enhanced backend database functionality. Fix IJSS instrument scoring routine for compatibility. Fix MH TEST/SURVEY SPEC for EDE-Q to fix blank instrument print. Fix scale group name for MBMD. Add SIP-AD-START_V2 and SIP-AD-30_V2 Deactivate SIP-AD-START and SIP-AD-30 Deactivate SCL90R 249 SEQ #183 DATE APPLIED: 2024-09-03 10:37:51 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Update instrument PEBS-20. Add new instrument YMRS Add new instruments MOCA_8.1, MOCA_8.2, MOCA_8.3, MOCA BLIND Drop instruments CEMI, GPCOG, ISMI, COPD, STAI, STMS, ATQ, IJSS, BBHI-2, MOCA, MOCA ALT 1, MOCA ALT 2, and CESD. Add unlocking to MH ADMINISTRATIONS file in YTQAPI1. Add new RPC for Reviewed Administration status. This will remain dormant until patch YS5.01250 is released. Update instrument MH REPORT for BRADEN SCALE. Update MINICOG scoring. Update BOMC scoring. Update MIDAS instrument to add Long COVID category. Update instrument Q-LES-Q-SF scoring routine to fix display. Add field 19, REVIEWED, to MH ADMINISTRATIONS. Add call to update instrument High Risk/Positive response in GET assignment list. 38 SEQ #33 DATE APPLIED: 1998-07-25 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch will introduce the following changes to the Addiction Survey Index software. Three new options have been included: ASI Case Finder [YSAS CASE FINDER], ASI Followup Finder [YSAS FOLLOWUP FINDER] and Site Report by Date [YSAS MANAGEMENT REPORT]. The ASI software will now produce a narrative report for the followup ASI. The addition of a signature block has been added to the narrative reports. Also included in this patch are numerous NOIS fixes. See patch description for a complete list. 237 DATE APPLIED: 2024-09-03 10:47:29 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Please see the patch description for complete details. 252 SEQ #184 DATE APPLIED: 2024-10-04 10:19:26 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: See patch description. 240 SEQ #185 DATE APPLIED: 2024-11-04 13:47:11 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: This patch adds protocol event points to MHA to allow subscribers to receive events when MHA administrations change. 250 SEQ #187 DATE APPLIED: 2024-12-23 10:37:19 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Updates to MHA Functionality. Fix YMRS response item number. Add AAQ-II-7 Add ALSFRS-R Add ALSSQOL-SF Reactivate BBHI-2 Add Parameter YS MHA LOG APPLICATION ERRORS to control error trapping for administrations. It is implemented turned off by default, deactivating error trapping for administration double click errors. Double clicking is Update for User Preference Parameters to validate Last Assignment. deactivated in the web application itself. Update MH REPORT to have new message if restricted instrument. Update Instrument Exchange to handle Orlando progress note titles of MH DIAGNOSTIC STUDY NOTE and MH CONSULT NOTE Update BOMC report. Update PSS-3-2ND report. Fix EAT-26 scoring for zero height. Fix CCSA-DSM5 skipped question error in scoring. 254 SEQ #188 DATE APPLIED: 2025-01-29 09:57:50 APPLIED BY: USER,EIGHTYNINE DESCRIPTION: Deactivate HIT-6. 40 SEQ #34 DATE APPLIED: 1998-09-23 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: See National Patch Module YS5.0140 for details of this patch. 41 SEQ #35 DATE APPLIED: 1998-09-23 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: See National Patch Module YS5.0141 for details of this patch. 44 SEQ #36 DATE APPLIED: 1998-09-23 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: See National Patch Module patch YS5.0144 for details. 45 SEQ #37 DATE APPLIED: 1998-10-07 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: The new Case Finder routine ^YSASCF introduced by patch YS5.0138 obtains OP diagnosis information from the Outpatient Diagnosis file (#409.43). Scheduling patch SD5.3132, released shortly after the Mental Health patch, begins storing this data in the V POV file (#9000010.07). Therefore, after sites install SD5.3132, the case finder (^YSASCF) will no longer find outpatients because file #409.43 is no longer being updated. Routine YSASCF as released with patch YS5.0138 will be modified in this patch to pull the information from the new file. 46 SEQ #38 DATE APPLIED: 1998-10-16 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Some sites are getting errors while trying to install Mental Health patches This is caused by old entries in the PACKAGE (#9.4) file confusing the install. During installation of a Mental Health patch, the install looks at the PREFIX field (#1) of the PACAKAGE file (#9.4). If it contains "YS", it then refers to the history for that package to verify that the required patches have been installed. Any entries that contain the "YS" prefix but do not contain "Version 5.01 of Mental Health" in the SHORT DESCRIPTION field (#2), cause the install to look at the wrong history. The install aborts because it does not find the required patches. when required mental health builds exist in the REQUIRED BUILDS field (#11) of This patch corrects the problem by executing routine YSPOS46 to "clean up" the PACKAGE file. This routine is included as a post installation routine for this patch. During the installation, the user is asked if they would like to 'Delete old package file entries?' If the user says 'Yes', all but the current version 5.01 Mental Health entry is deleted. If the user answers 'No', the old "YS" prefix entries in the "C" cross reference of the PACKAGE file (^DIC(9.4,"C","YS",0)) are renamed to YS1, YS2, YS3, etc. Only the current version 5.01 entry is left unchanged. PLEASE NOTE THAT NOTHING IS INSTALLED WITH THIS PATCH. IT CONSISTS ONLY OF the Kids BUILD file (#9.6). The install will abort stating that a required THE USER QUESTION DURING INSTALLATION AND EXECUTION OF POST INSTALLATION ROUTINE YSPOS46. patch is missing. However, when the site checks on the missing patch, they discover that the patch IS installed. This became evident when test sites were attempting to install YS5.0144 which required patch YS5.0138 to be installed. The install would abort saying that patch 38 is not installed even though it was. (This same error occurred when test sites were attempting to install YS5.0145.) 22 SEQ #21 DATE APPLIED: 1996-10-02 00:00:00 APPLIED BY: USER,ONE 42 SEQ #39 DATE APPLIED: 1998-10-16 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: VHA Directive, 97-059, dated November 25, 1997, "Instituting Global of GAF score data in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). The API's are described as follows: API entry point RET^YSGAF(YSX) retrieves GAF score information from the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). It returns the latest GAF score and diagnosis date/time for the patient based on the internal entry number (variable YSX) passed into the API. The score/date is returned in the form of a concatenated string. If no GAF data is found, -1 is returned. API entry point UPD^YSGAF(YSPN,YSGN,YSGD,YSGC,YSPT) is designed to store Assessment of Function (GAF) Scores in Axis V Mental Health Patients", has patient GAF score information in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). The following information is passed into this call: YSPN Patient name - Pointer to the PATIENT file (#2) YSGN GAF score (Axis 5) YSGD Date/Time of diagnosis YSGC Diagnosis by - Pointer to the NEW PERSON file (#200) YSPT Patient type - 'I'npatient or 'O'utpatient This API updates new field PATIENT TYPE (#66) in the DIAGNOSTIC RESULTS - been released. This directive provides guidelines for collection of GAF MENTAL HEALTH file (#627.8) which was created to store the patient type of the GAF record. It is a set of codes consisting of 'I' for inpatient and 'O' for outpatient. This API routine call creates a new record with the above information in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8) in order to maintain a historical record of GAF scores for an individual patient. Associated NOIS: None Scores for outpatients and inpatients. Inpatient Axis V (GAF) scores have Test Site(s): Canandaigua, NY Tuscaloosa, AL ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values been collected for several years, but up to now there has been no provision Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YS42ENV N/A 2916949 42 YSGAF 12321822 13001186 33,37,40,42 Installation Instructions: ========================== for collection of GAF Scores for outpatients. Storage will be in the VISTA 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: Mental Health software package. Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0142' and proceed with install. 6. Delete routine YS42ENV. This patch contains two new API's that are used for the storage/retrieval 43 SEQ #40 DATE APPLIED: 1999-01-19 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: VHA Directive, 97-059, dated November 25, 1997, "Instituting Global The GAF initiative is using the VISTA HL7 software to transport the GAF YSDX3B 11950549 11117228 33,43 YSGAF 13001186 13161211 33,37,40,42,43 YSGAFHL7 N/A 5831582 43 YSGAFOBX N/A 3398570 43 YSGAFTR N/A 2685760 43 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your score data onto the Austin Automation Center (AAC) system. An A08 HL7 system. 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global message will be used to transmit GAF Scores to the National Patient 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0143' and proceed with install. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Care Database (NPCD). This message contains the MSH, EVN, PID and OBX 8. Follow the HL LOGICAL LINK [YS GAF-SND] set up example below. 9. WARNING!!! This part should be done at off peak hours. Execute the call point EN^YSGAFTR. An example of the running the call point is below. 10. Delete YS43POST. Example of the HL Logical Link [YS GAF-SND] set up -------------------------------------------------- VAH,DEV>D ^XUP segments. Setting up programmer environment Terminal Type set to: C-VT320 Select OPTION NAME: EVE --- 1 EVE Systems Manager Menu 2 EVENT CAPTURE DATA ENTRY ECENTER Event Capture Data Entry 3 EVENT CAPTURE EXTRACT ECXEC Event Capture Extract 4 EVENT CAPTURE MANAGEMENT MENU ECMGR Event Capture Management Menu 5 EVENT CAPTURE MENU ECMENU Event Capture Menu CHOOSE 1-5: EVE Systems Manager Menu --- Core Applications ... Device Management ... FM VA FileMan ... Manage Mailman ... Menu Management ... This patch will allow the sites to transmit GAF scores to the National Programmer Options ... Operations Management ... Spool Management ... System Security ... Taskman Management ... User Management ... Application Utilities ... Capacity Management ... HL7 Main Menu ... Patient Care Database (NPCD) at the AAC. Sites will be able to transmit GAF Select Systems Manager Menu Option: HL7 Main Menu ------------- 1 V1.5 OPTIONS ... 2 V1.6 OPTIONS ... 3 Activate/Inactivate Application 4 Print/Display Menu ... 5 Purge Message Text File Entries Select HL7 Main Menu Option: 2 V1.6 OPTIONS scores in a batch mode using the call point EN^YSGAFTR. EN^YSGAFTR will - 1 Communications Server ... 2 Interface Workbench 3 Message Requeuer Select V1.6 OPTIONS Option: 1 Communications Server - 1 Edit Communication Server parameters prompt the user for a date range, this date range will be the selection 2 Manage incoming & outgoing filers ... 3 Monitor incoming & outgoing filers 4 Start LLP 5 Stop LLP 6 Systems Link Monitor 7 Logical Link Queue Management ... 8 Report Select Communications Server Option: 4 Start LLP - Assessment of Function (GAF) Scores in Axis V Mental Health Patients", has criteria that is used when determining the GAF scores to be transmitted to This option is used to launch the lower level protocol for the appropriate device. Please select the node with which you want to communicate Select HL LOGICAL LINK NODE: YS GAF-SND ---------- Select one of the following: F FOREGROUND the NPCD at the AAC. The batch processing will allow sites to initially B BACKGROUND Q QUIT Method for running the receiver: B// ACKGROUND --------- Job was queued as 229301. Select Communications Server Option: <CR> -- populate GAF Scores at the NPCD. Example of GAF Batch Transmission --------------------------------- >D EN^YSGAFTR [At the prompt, enter the start date, this] [date will be the beginning date range ] [used in the selection criteria. ] >Enter start date : (10/1/97 - 12/31/99): 10/1/97 (OCT 01, 1997) ------- [At the prompt, enter the stop date, this ] [date will be the ending date range ] [used in the selection criteria. ] >Enter stop date : (10/1/97 - 12/31/99): 12/31/99 (DEC 31, 1999) After the running of the batch transmission of GAF scores, all GAF scores entered will be dynamically sent to the NPCD at the AAC. The new Q-NPT.DOMAIN.EXT domain, which receives the HL7 messages, implementation instructions are released by MailMan XMDBA119 informational patch. been released. This directive provides guidelines for collection of GAF The (G)lobal (A)ssessment of (F)unction Transmission patch components are: - 4 New routines, YS43POST, YSGAFHL7, YSGAFOBX, YSGAFTR - 2 Patched routines, YSDX3B, YSGAF - 2 New mail groups, YS GAF TO NPCD, YS GAF TRANSMISSION ACK - 2 New Protocols, YS GAF, YS GAF A08 CLIENT - 1 New HL7 Application Parameter, YS GAF - 1 New HL Lower Level Protocol Parameter, YS GAF SEND - 1 New HL Logical Link, YS GAF-SND Scores for outpatients and inpatients. Inpatient Axis V (GAF) scores have GAF Mail Groups --------------- YS GAF TO NPCD: This mail group is used for transmission of HL7 messages derived from the parameters defined in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8) to the AAC. YS GAF TRANSMISSION ACK: This mail group is used to receive Confirmation and Processing Report Messages from Austin. Protocols been collected for several years, but up to now there has been no provision --------- YS GAF: This event driver protocol defines the associated parameters needed to build the HL7 message used to send the GAF data to Austin. YS GAF A08 CLIENT: This subscriber protocol defines the parameter needed by HL7 package to determine where to send the HL7 formatted message containing the GAF information. Changes to routine YSGAF (YS5.0142) ------------------------------------- for collection of GAF Scores for outpatients. Storage and collection of GAF The API RET^YSGAF was changed to use the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8) "C" cross-reference to look up the latest patient GAF score. This corrected performance issues that were reported after the loading of SD5.3149 and YS5.0142. (WPB-1298-31096 BAY-1298-30934 CHS-1298-40830 EKH-1298-40379 NTH-1198-72024) The API UPD^YSGAF was changed to kill all necessary variables set within the API upon exiting. (BHH-1298-41082) scores will be in the VISTA Mental Health software package file Associated NOIS: WPB-1298-31096 BAY-1298-30934 CHS-1298-40830 EKH-1298-40379 NTH-1198-72024 BHH-1298-41082 Test Site(s): Canandaigua, NY DIAGNOSTIC RESULTS - MENTAL HEALTH (#627.8). Chicago HCS, IL Dallas, TX Miami, FL Salt Lake City, UT Tuscaloosa, AL ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YS43POST N/A 237811 43 47 SEQ #41 DATE APPLIED: 1999-02-01 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch updates the Clozapine reporting software as required by the 2. Update Site Number reporting to comply with integrated site requirements. References to the DEFAULT INSTITUTION (#217) field in the KERNEL SITE PARAMETERS (#4.3) are no longer supported. These references were changed to the supported call $$SITE^VASITE referenced in DBIA#10112. 3. Extend reporting time for White Blood Count to six months. Changes are also included to improve the reporting of the White Blood Count. The CLOZAPINE LAB TEST (#603.02) file has been created to facilitate this report. The White Blood Count (#.01) field in the CLOZAPINE CLOZAPINE PATIENT MANAGEMENT PROTOCOL (CPMP). LAB TEST (#603.02) file indicates the proper White Blood Count test to be used. These changes include: 1. Reporting Absolute Neutrophil Count (Calculated from percentage reported at the site). The CLOZAPINE LAB TEST (#603.02) file has been created to facilitate this report. The Neutrophil Count (#1) field in the CLOZAPINE LAB TEST (#603.02) file indicates the proper Neutrophil Count test to be used. 39 SEQ #42 DATE APPLIED: 1999-02-23 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch will now allow a progress note to be built using TIU V. 1.0. This patch can only be installed if TIU V. 1.0 has been installed at your site. 50 SEQ #43 DATE APPLIED: 1999-03-29 00:00:00 APPLIED BY: USER,ONE 48 SEQ #44 DATE APPLIED: 1999-06-02 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch enhances the management report, Global Assessment of Functioning The following is an example of the generated report: GAF Case Finder Begining Date: DEC 1,1998 Ending Date: MAR 18,1999 Facility: Dallas CIOFO The following is a list of all patients who had a Mental Health Outpatient Encounter between the above dates but do not have a GAF score WITHIN 90 (GAF). The new option GAF Case Finder [YSGAF CASE FINDER] has been added as DAYS. Last MH (non-telephonic) Outpatient Encounter in date range is listed. Name SSN Date Location Provider 0 MH patients without a GAF. 0 MH patients had a GAF. NOIS calls: none Test Site(s): Dallas, TX Salt Lake City, UT an item to the MENU Global Assessment of Functioning [YSGAF MAIN]. ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSGAF3 N/A 12209534 48 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. The GAF report now lists all patients that have not been given a GAF score 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. The transport global will remain on the system until installed or manually deleted. 3. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System within the last 90 days. The user is given the option to sort the report Verify Checksums in Transport Global Backup a Transport Global 4. Installation of this patch should be at off peak hours. 5. Users may remain on the system. 6. Installation will take less than five minutes and requires no additional memory space. by patient name or by provider. The results of this report are sent to the 7. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0148' and proceed with install. 8. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//', respond NO. However, it is advised that menus be rebuilt at a later time. 9. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. MAILMAN system and are returned the user as a MAILMAN message. It is also recommended to queue the report during non-peak or after-hours. 31 DATE APPLIED: 1999-06-22 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: 1. Patch YS5.0131 releases several new psychological tests/interviews to IRM FIELD OFFICE FTP ADDRESS DIRECTORY ================ =========== ========= ALBANY 152.127.1.5 [ANONYMOUS.SOFTWARE] HINES 152.129.1.110 [ANONYMOUS.SOFTWARE] SALT LAKE 152.131.2.1 [ANONYMOUS.SOFTWARE] The software can be found in a file named MH_501_31.KID. Installation Instructions: b. Test Name: AUDIT ========================== 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. START UP KIDS From the KERNEL Installation and Distribution Systems (KIDS) Menu, select the Installation menu [XPD INSTALLATION MENU]: Installation Edits and Distribution ... Utilities ... Description: Alcohol Use Disorders Identification Test Installation ... 2. SELECT INSTALLATION OPTION Select Installation Option: Load a Distribution Enter a Host File: MH_501_31.KID This Distribution contains Transport Globals for the following Package(s): YS5.0131 Use INSTALL NAME: YS5.0131 to install the Distribution. Number of Questions: 10 NOTE: The following are OPTIONAL: a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes, such as DDs or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). Number of Scales: 1 c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 3. SELECT INSTALLATION OPTION: Install Package(s) Select KIDS OPTION: INSTALL PACKAGE(S) Select INSTALL NAME: YS5.0131 4. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//, respond NO 5. Delete routines YS31POST and YS31ENV. c. Test Name: SMAST Description: Short Michigan Alcoholism Screening Test Number of Questions: 13 Number of Scales: 1 the Mental Health package. These tests are accessed via menu item d. Test Name: DOM80 Description: Depression Outcome Module: Patient Screen 8.0 Number of Questions: 4 e. Test Name: DOM81 Description: Depression Outcome Module: Patient Baseline 8.1 Number of Questions: 69 f. Test Name: DOM82 'Psychological tests/interviews (administer) [YSADMTEST].' The new Description: Depression Outcome Module: Clinician Baseline 8.2 Number of Questions: 23 g. Test Name: DOMG Description: Depression Outcome Module: Geriatric Screen Number of Questions: 5 Number of Scales: 1 h. Test Name: SAI Description: Spiritual Assessment Inventory tests are as follows: Number of Questions: 14 These tests are stored as new entries in the MH INSTRUMENT FILE (#601). 2. Patch YS5.0131 also includes six additional scales added to the test MMPI2 - Minnesota Multiphasic Personality Inventory-2. The new scales are as follows: MDS - Marital Distress Scale APS - Addiction Potential Scale AAS - Addiction Admission Scale S - Superlative Self-Presentation Fp - Infrequency-Psychopathology Ho - Hostility 3. Five new routines are included in patch YS5.0131. They are: YS31ENV - YS5.0131 Patch Environment Check Routine YS31POST - YS5.0131 Patch Post Routine YTALUSE - Test-Audit Alcohol Screen a. Test Name: CAGE YTDOMR - Depression Outcome Module Report YTDOMR1 - Extended Interview Reporter 4. One edited routine: YTMMPI2B - MMPI2 Harris:Lingos,Crit,OS Test Site(s): Dallas, TX Cleveland, OH Minneapolis, MN Description: A quick alcohol screening measure. Asheville, NC Portland, OR Canadaigua, NY Little Rock, AR ROUTINE SUMMARY: ================ The second line of the routine now looks like: Number of Questions: 4 <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YS31ENV N/A 2399932 31 YS31POST N/A 133706 31 YTALUSE N/A 744349 31 YTDOMR N/A 11177067 31 Number of Scales: 1 YTDOMR1 N/A 4728910 31 YTMMPI2B 14737364 15991750 10,31 SOFTWARE RETRIEVAL: =================== The software files are available on one of the following CIO Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. 51 SEQ #46 DATE APPLIED: 1999-08-03 00:00:00 APPLIED BY: USER,ONE 52 SEQ #47 DATE APPLIED: 1999-09-14 00:00:00 APPLIED BY: USER,ONE 49 SEQ #48 DATE APPLIED: 1999-10-03 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Patch YS5.0149 has been created to perform the following functions: 4) Correct problem with the PATSTAT^YSDX3B call that returns the patient status (In-patient or Out-patient.) 5) Correct an undefined error occurring in menu option GAF CASE FINDER [YSGAF CASE FINDER]. 1) Evaluate all Global Assessment of Functioning (GAF) data for fiscal years 1998 & 1999, and verify that all necessary pieces of information exist for each record. 2) Retransmit all GAF scores for Fiscal Years 1998 & 1999 to the National Patient Care Database (NPCD) at the Austin Automated Center (AAC). 3) Correct a filing error in the Mental Health ENTER DIAGNOSE [YSDIAGE] menu option. 19 SEQ #22 DATE APPLIED: 1996-11-08 00:00:00 APPLIED BY: USER,ONE 56 DATE APPLIED: 1999-12-13 00:00:00 APPLIED BY: USER,ONE 53 SEQ #49 DATE APPLIED: 2000-02-04 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Seven new Psychological Testing APIs/RPCs have been developed to allow reading one new file MH MULTIPLE SCORING (#601.6). This file allows the Array(6)=S1^Scale Name^Raw Score^Transformed Score Array(7)=S2^ Scale Name^Raw Score^Transformed Score And onward as needed. Example: Input ----- YS("DFN")=83 YS("CODE")=MMPI2 YS("ADATE")=05/09/1994 user to score multiple instruments. Output ------ YSDATA(1)=[DATA] YSDATA(2)=CAPP,ANDY W^MMPI2^--- Minnesota Multiphasic Personality Inventory-2 -- -^2940509^05/09/1994^CAULFIELD,MARY A YSDATA(3)=R1^TTTFTTFTTTFTTFFFFFFTTFFFFFFFTFFFFFFFFFFFFFFFFFFFFFFTFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFTTTTTTFFFFFFFFFFFFFFFFFFFFFFFFFFFFFTTTTFFFTTFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF YSDATA(4)=R2^FFFFFFFFFFFFFFFFFFFFFFFFFTTTTTTTTTTTTTTTTFFFFFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFTTT YSDATA(5)=R3^TTTTTTTTTTTTTTTTTTTTTTTFFFFFFFFFFFFFFFFFFFFTTFFFTFTFTFTFTFTFTFTFTFF FTFTFTFTFTFTFTFTFTFTFTFTTFTFTFTFFFFTFFTFTFTFTFTFTFFTFTFTFTFTFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFF YSDATA(6)=S1^L Lie^12^87 YSDATA(7)=S2^F Infrequency^19^95 . . . eleven new routines YSGAFAPI, YSMTI, YSMTI0, YSMTI1, YSMTI3 YSDATA(89)=S84^Ma-S Hypomania, Subtle^10^50 4. SAVEIT RPC: YTAPI SAVEIT M: SAVEIT^YTAPI1 This API allows saving of patient responses to a test or interview in the PSYCH INSTRUMENT PATIENT file (#601.2). The patient ien, the test code, and administration date is required along with the responses. All responses are checked for validity. No scoring is returned but successful addition YSMTI4, YSMTI5, YTAPI, YTAPI1, YTAPI2 and YTAPI3. to the PSYCH INSTRUMENT PATIENT file (#601.2) is indicated. 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 Example: Input ----- YS("DFN")=6 YS("ADATE")="T" YS("CODE")="ZUNG" one new option Multiple Psych Testing [YT MTI] displays history of YS("STAFF")=67 YS("R1")="12121212121212121212" Output ------ YSDATA(1)=[DATA] YSDATA(2)=saved 5. SHOWIT psychological testing for an individual patient. RPC: YTAPI SHOWIT M: SHOWIT^YTAPI3 This API returns the text, bottom, introduction and possible correct responses for a specified test item in MH INSTRUMENT file (#601). It will work only for tests as opposed to interviews or batteries. The ASI is not supported. Input: CODE: Test code from in the MH INSTRUMENT 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 item: 1 ;SECOND LINE IS TEST CODE AND ITEM NUMBER Array(3)=[BEGIN ITEM]; BEGINS EACH ITEM Array(4)=MMPI2^1 ;CODE^ITEM NUMBER Array(5)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(12)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(14)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(18)=[RESPONSE];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(21)=[END ITEM]; ENDS EACH ITEM Example: Input ----- YS("CODE")="MMPI2" YS("ITEM")=1 and saving of psychological testing data. This data normally resides in the Documentation for APIs and RPCs Output ------ YSDATA(1)=[DATA] YSDATA(2)=[BEGIN ITEM] YSDATA(3)=MMPI2^1 YSDATA(4)=[INTRO] YSDATA(5)=Please read each statement carefully and decide whether it is true YSDATA(6)=as applied to you or false as applied to you. YSDATA(7)= YSDATA(8)=If a statement is true or mostly true, as applied to you, answer 'T'. ------------------------------- YSDATA(9)=If a statement is false or not usually true, as applied to you, answer YSDATA(10)='F'. YSDATA(11)= YSDATA(12)=Remember to give your own opinion of yourself. YSDATA(13)=[TEXT] YSDATA(14)=I like mechanics magazines. YSDATA(15)=[BOTTOM] YSDATA(16)=T= True YSDATA(17)=F= False 1. LISTALL YSDATA(18)=Answer= YSDATA(19)=[RESPONSE] YSDATA(20)=TFX YSDATA(21)=[END ITEM] 6. SHOWALL RPC: YTAPI SHOWALL M: SHOWALL^YTAPI3 RPC: YTAPI LISTALL This API returns the text, bottom, introduction and possible correct responses for all items in a test in the MH INSTRUMENT file (#601). It will work only for tests as opposed to interviews or batteries. The ASI is not supported. Input: CODE: Test code from the MH INSTRUMENT file (#601). e.g. "CAGE", "BDI" Output: Array(1)=[DATA] ;indicates successful call M: LISTALL^YTAPI Array(2)=MMPI2 item: 1 ;SECOND LINE IS TEST CODE AND ITEM NUMBER Array(3)=[BEGIN ITEM]; BEGINS EACH ITEM Array(4)=MMPI2^1 ;CODE^ITEM NUMBER Array(5)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(12)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(14)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(18)=[RESPONSE];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(21)=[END ITEM]; ENDS EACH ITEM . . This API returns all psychological test administrations for a specified . Array(1003)=[BEGIN ITEM]; BEGINS EACH ITEM Array(1004)=MMPI2^567 ;CODE^ITEM NUMBER Array(1005)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(1012)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(1014)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT Array(1018)=[RESPONSE];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT Array(1021)=[END ITEM];ENDS EACH ITEM Example: patient during a specified time period. No scoring is returned. Input ----- YS("CODE")="MMPI2" YS("ITEM")=1 Output ------ YSDATA(1)=[DATA] YSDATA(2)=[BEGIN ITEM] YSDATA(3)=MMPI2^1 YSDATA(4)=[INTRO] YSDATA(5)=Please read each statement carefully and decide whether it is true YSDATA(6)=as applied to you or false as applied to you. YSDATA(7)= YSDATA(8)=If a statement is true or mostly true, as applied to you, answer 'T'. YSDATA(9)=If a statement is false or not usually true, as applied to you, answer YSDATA(10)='F'. YSDATA(11)= Input: YSDATA(12)=Remember to give your own opinion of yourself. YSDATA(13)=[TEXT] YSDATA(14)=I like mechanics magazines. YSDATA(15)=[BOTTOM] YSDATA(16)=T= True YSDATA(17)=F= False YSDATA(18)=Answer= YSDATA(19)=[RESPONSE] YSDATA(20)=TFX YSDATA(21)=[END ITEM] DFN : Patient internal identifier . . . YSDATA(6950)=[BEGIN ITEM] YSDATA(6951)=MMPI2^567 YSDATA(6952)=[INTRO] YSDATA(6953)=[TEXT] YSDATA(6954)=Most married couples don't show much affection for each other. YSDATA(6955)=[BOTTOM] YSDATA(6956)=T= True PSYCH INSTRUMENT PATIENT file (#601.2) for patient responses and the BEGIN: Inclusive date in %DT acceptable format (11/11/2011) YSDATA(6957)=F= False YSDATA(6958)=Answer= YSDATA(6959)=[RESPONSE] YSDATA(6960)=TFX YSDATA(6961)=[END ITEM] 7. GAFHX RPC: YS GAF API M: GAFHX^YSGAFAPI to begin search [optional] This API returns the GAF scores for a specified patient. It can be constrained by both date range and occurrence limit. Please note that data for this API comes from the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). 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) END: Inclusive date in %DT acceptable format (11/11/2011) to end search [optional] LIMIT: Constrains to the last N diagnoses [optional] Output: Array(1)=[DATA] ;indicates successful call Array(1)=GAF Score^Internal Date^External Date^Provider^Comment . . Array(N)=GAF Score^Internal Date^External Date^Provider^Comment to end search [optional] Example: Input ----- YS("DFN")=29601 YS("LIMIT")=3 Output ------ YSDATA(1)=[DATA] YSDATA(2)=100^2981209.1105^12/09/1998@11:05^DEVLIN,MARK^ YSDATA(3)=99^2981209.092^12/09/1998@09:20^DEVLIN,MARK^ YSDATA(4)=66^2981124.1406^11/24/1998@14:06^DEVLIN,MARK^ Associated NOIS: None Test Site(s): Bay Pines Test LAB Tuscaloosa, AL West Palm Beach, FL Output: ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List Array= internal administration date^external administration date^test code ------------ ------------ ----------- ---------- YSGAFAPI N/A 1326501 53 YSMTI N/A 9401597 53 YSMTI0 N/A 3775566 53 YSMTI1 N/A 8825610 53 YSMTI3 N/A 6387181 53 YSMTI4 N/A 13759340 53 YSMTI5 N/A 8420657 53 YTAPI N/A 9153058 53 YTAPI1 N/A 3410744 53 Data is sorted in order of most recent administration to the oldest YTAPI2 N/A 6279046 53 YTAPI3 N/A 4047466 53 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your administration. If no administrations are f,ound Array(2) will not be system. 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global returned. If patient has no PSYCH INSTRUMENT PATIENT file (#601.2) data, Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0153' and proceed with install. MH INSTRUMENT file (#601) for test and interviews. In addition, the an error will be returned. 6. If you do not intend to queue the installation to run after normal business hours, then answer "NO" to the following prompt: Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO If you answer "YES", then the installation will require much more than 5 minutes to run due to the menu rebuild process. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Example: Input ----- YS("DFN")=6 YS("BEGIN")="10/01/89" YS("END")="06/08/1999" Output APIs/RPCs retrieve ADDICTION SEVERITY INDEX data found in the ADDICTION ------ YSDATA(1)=[DATA] YSDATA(2)=2901120^11/20/1990^AOR YSDATA(3)=2900730^07/30/1990^ALCO YSDATA(4)=2900730^07/30/1990^HX2 YSDATA(5)=2900730^07/30/1990^MROS YSDATA(6)=2900730^07/30/1990^PSOC YSDATA(7)=2900730^07/30/1990^TRMT SEVERITY INDEX file (#604) and Global Assessment of Functioning (GAF) data 2. LISTONE RPC: YTAPI LISTONE M: LISTONE^YTAPI an error will be returned. Example: Input ----- YS("DFN")=83 YS("CODE")=MMPI2 found in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). YS("SCALE")=2 Output ------ YSDATA(1)=[DATA] YSDATA(2)=2940509^05/09/1994^MMPI2^F Infrequency^19^95 YSDATA(3)=2920925^09/25/1992^MMPI2^F Infrequency^26^116 YSDATA(4)=2920924^09/24/1992^MMPI2^F Infrequency^25^113 3. SCOREIT RPC: YTAPI SCOREIT M: SCOREIT^YTAPI2 This API returns all scoring information for a specified patient given a specified administration date for a specified test or instrument. User must have adequate privileges to receive this information (i.e. often the YSP KEY). Input: DFN : Patient internal identifier This patch contains: CODE: Test code from MH INSTRUMENT 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 58 SEQ #51 DATE APPLIED: 2000-02-29 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch corrects an error that occurs in menu option "Identify Potential Merge Problems [XDR VALID CHECK]". Although it originally appeared to be a FILEMAN error, it was later determined to be a data dictionary problem with the MEDICAL RECORDS file (#90) of the MENTAL HEALTH Version 5.01 software application. 54 SEQ #52 DATE APPLIED: 2000-02-29 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: The following items are addressed in patch YS5.0154: Number of Questions: 12 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 7. Routine YS54POST will be deleted by KIDS after successful patch installation. Number of Scales: 1 b. Test Name: AUDC Description: Alcohol Use Disorders Identification Test Condensed Number of Questions: 3 Number of Scales: 1 These tests are stored as new entries in the MH INSTRUMENT FILE (#601). 2. Two new routines are included in patch YS5.0154. They are: YTAIMS - Abnormal Involuntary Movement Scale YTALUSEC - Test-Audit Alcohol Screen Condensed 3. When the user selects option Psychological tests/interviews (administer) [YSADMTEST] and chooses the instrument "MMPI" a message is displayed on the screen "You have selected the "MMPI" instrument, the "MMPI2" instrument will be administered in its place.". Routines YTAR and YTS have been modified to display this message. 1. Patch YS5.0154 releases two new psychological tests/interviews to 4. The file MH INSTRUMENT (#601) field OPERATIONAL (#32) will be populated with a value of "N" for the instrument MMPI when the post routine YS54POST is executed. 5. Patch YS5.0154 also includes updates to the instruments AUDIT, CAGE, DOM80, DOM81, DOM82, DOMG, and the SMAST. These instruments were sent out in patch YS5.0131 as NON-EXEMPT, when they should have been sent out as EXEMPT. The file MH INSTRUMENT (#601) field EXEMPT TEST (#21) for the instruments mentioned will be populated with a value of "Y" when the post routine YS54POST is executed. the Mental Health package. These tests are accessed via menu item 6. Patch YS5.0154 also includes 2 additional entries in the MH INSTRUMENT FILE (#601). The Addiction Survey Index (ASI) and the Global Assessment of Functioning (GAF) are placeholders to be used in retrieving ASI and GAF data used by APIs and RPCs released in patch YS5.0153. These entries are non operational when accessed via menu item Psychological tests/interviews (administer) [YSADMTEST]. Test Site(s): North Texas HCS, TX Palo Alto HCS, CA Psychological tests/interviews (administer) [YSADMTEST]. The new Puget Sound HCS, WA Salt Lake City, NV ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 tests are as follows: Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YS54POST N/A 183160 54 YTAIMS N/A 3709923 54 YTALUSEC N/A 2558679 54 YTAR 16901184 17157520 37,54 YTDP 13752098 13773021 37,41,54 YTS 9209637 9650076 37,54 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. a. Test Name: AIMS 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global Description: Abnormal Involuntary Movement Scale 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option five 'Install Package(s)' Select the package 'YS5.0154' and proceed with install. 55 SEQ #53 DATE APPLIED: 2000-04-05 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch addresses the following problems associated with the Mental 2. Problem: $ZE= PTFLP+4^YSASCF:1, %DSM-E-UNDEF, undefined variable. Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- -------------------- YSASCF 16798624 15199657 38,45,55 YSASFM 4829194 4829236 24,30,32,37,38,55 YSASFUR 14346228 14504166 38,55 YSASNAR 11476987 11561066 24,30,37,38,44,55 YSASRU 11199368 11203518 24,30,32,38,55 Installation Instructions: ========================== The option ASI Case finder [YSAS CASE FINDER] will error out at 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: PTFLP+4^YSASCF when it encounters A missing node in the PTF file (#45) Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation multiple field 501 (#50). The code in routine YSASCF has been of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0155' and proceed with install. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 8. When prompted 'Want to DISABLE Scheduled Options, Menu corrected. Options, and Protocols? YES//', respond NO. 3. Problem: $ZE= OE+3^YSASCF:1, %DSM-E-UNDEF, undefined variable The option ASI Case Finder [YSAS CASE FINDER] will error out at OE+3^YSASCF when the "B" cross reference was created for The Outpatient Encounter file (#409.68) but did not contain the zero node for that Health ADDICTION SURVEY INDEX software. entry. The routine YSASCF has been modified to check if the entry exists. 4. The option ASI Follow-up Finder [YSAS FOLLOWUP FINDER] generates a mail message that splits the results into separate mail messages for every 1000 lines. The subject of each mail message displays which page of how many pages there are for the report generated. Such as below: ASI Follow-up Reminder (1 OF 2),(2 of 2) etc. The page counter in the subject of the mail message created in routine YSASFUR has been corrected. 5. The routine YSASCF has been corrected to retrieve the correct institution station number. This error would only occur at Anchorage, Honolulu, Las Vegas, San Juan and West Palm Beach. 6. The option Activate/Inactivate ASI Program Types [YSAS ASI PROGRAM ACTIVATION] allows the user to edit the TITLE field (#1) instead of 1. Problem: $ZE= <UNDEFINED>PUTWP+9^DIEFW. the ACTIVE field (#3) in the ASI PROGRAM TYPE file (#604.26). This has been corrected in routine YSASFM. 7. When the narrative report prints, the employee who administers (interviewer) the Addiction Severity Index has a title that contains Roman Numerals. When converting the text from upper case to lower case the second Roman numeral in the interviewers title is printed in lower case. This has been corrected in routine YSASNAR. NOIS List: HON-0200-62334 The option ASI National Roll Up [YSAS NATIONAL ROLL UP] gets the HOU-0100-70481 FAV-1299-70811 OKL-1199-72479 BHH-1199-40801 CMO-1099-41317 NCH-1099-41338 WIM-1099-20530 BRX-1099-11552 BUT-0999-22160 MUS-0999-70276 undefined error because of the change to the temporary data gathering ELP-0999-70673 CON-0999-10634 GNH-0999-40125 WRJ-0999-11438 DUB-0999-31427 TAM-0899-32628 FNC-0899-32323 ALX-0899-71889 MON-0899-50727 MAD-0799-40048 global structure after the installation of Mailman Patch 50 & FILEMAN WNY-0299-12238 BRK-0299-11957 NCH-0199-41750 PAL-0199-61534 LAS-1198-60407 BRK-0798-11348 LAS-0798-62572 MAD-1097-40552 STL-0797-41652 V. 22. The code in routine ^YSASRU has been corrected. Test Site(s): Albany, NY Ann Arbor, MI Charleston, SC Honolulu, HI Madison, WI Montana HCS, MT Salt Lake City, UT VA Palo Alto HCS, CA ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values 63 SEQ #54 DATE APPLIED: 2000-04-05 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Patch YS5.0163 corrects the print problem in option "Graph of Patients NOIS call(s): DAY-0300-40087 Test Site(s): Dayton, OH ROUTINE SUMMARY: ================ Remaining" [YSCENREM]. Date entry is limited to month and year and results The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ----------- YSCEN81 10985668 10940348 63 are graphed for each day in the month. Each day of the month's data is Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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 calculated from the CENSUS file (#41.9) for the specified ward. the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. This file contains the statistical data necessary for each ward 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0163' and proceed with install. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. to create the daily G&L and bed status reports. The report did not work, 8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. when the month/year entered are greater than 12/99. 61 SEQ #55 DATE APPLIED: 2000-04-17 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch adds the NDC (National Drug Code) from the NDC field (#27) in ALT-0799-21661 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 2. Review your mapped set. If the routines are mapped, they should be removed from the mapped set at this time. 3. The patch has now been loaded into a Transport global on your system. You now need to use KIDS to install the Transport CHS-1099-40369 global. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global These NOIS calls reported an undefined variable (YSCLR) that was 4. Users may remain on the system, installation may be done at any time except during the time scheduled for the Clozapine roll-up. 5. No options need to be placed out of service. 6. Installation time is less than 2 minutes during off peak hours and less than 5 minutes during peak hours. 7. Installation of this patch requires no additional memory causing problems with the weekly transmissions, measures have space. 8. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0161' and proceed with the install. 9. If any routines were unmapped as part of step 2, they should be returned to the mapped set once the installation has run to completion. been taken to prevent this error. 10. The routine YSCLPRE will be automatically deleted after the installation has run to completion. 2. PRO-0399-12547 CLE-0799-41665 PRO-0799-12531 These NOIS calls reported a problem with the confirmation message the PRESCRIPTION file (#52) to the Clozapine reporting software and clears that is sent to the site to report the number of patient data records transmitted to the national database and any errors. Errors were being reported in these messages, but the details were omitted. A sequence was established to ensure that the details will be included. 3. SYR-0799-10193 LEX-0899-41770 These NOIS calls reported a problem with the patients registration in the CLOZAPINE PATIENT LIST file (#603.01). Patients were being the problems listed in the associated NOIS's. dropped from the file and could not be reregistered. Changes were made to allow the NCCC to reregister the patients. 4. SUX-0899-41033 PRO-1099-11959 ALN-0300-10936 These NOIS calls reported a problem with the patients status changing from "Active" to "discontinued" each week. A more accurate method of determining active prescriptions has been implemented. Requesting Site: Washington, DC Test Site(s): Sioux Falls Chicago Lexington Biloxi Reference NOIS: BIL-0299-32473 1. BIL-0299-32473 PUG-0399-52312 PRO-0399-12547 GNH-0699-42000 SYR-0799-10193 BOS-0799-10563 CLE-0799-41665 PRO-0799-12531 SUX-0899-41033 LEX-0899-41770 PRO-1099-11959 PUG-0399-52312 ALT-1099-22157 ALT-0799-21661 CHS-1099-40369 ALN-0300-10936 ROUTINE SUMMARY: ================ The second line of the routine now looks like: GNH-0699-42000 <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30,1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSCLPRE NEW 4869409 61 YSCLSERV 27353057 33969291 18,22,26,47,61 YSCLSRV1 NEW 1286296 61 BOS-0799-10563 YSCLTEST 8757130 9052437 18,22,26,47,61 YSCLTST1 12256509 12553719 18,22,25,26,47,61 YSCLTST2 11047742 11500297 18,22,26,47,61 YSCLTST3 11776458 12171877 18,22,25,26,47,61 Installation Instructions: ========================== NOTE: This KIDS install does not place any options out of service during the install and no user options are affected. ALT-1099-22157 If KIDS prompts: "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO" "Want KIDS to INHIBIT LOGONs during the install? YES// NO" "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO" The site should answer "NO" to all three questions. Note: You may not receive all three prompts at your site. 62 SEQ #56 DATE APPLIED: 2000-06-26 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Two new Psychological Testing APIs/RPCs have been developed to allow reading Four new fields have been added to file MH MULTIPLE SCORING (#601.6). 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 Example: -------- The new fields are OUTCOMES (#5) and RESULTS (#6) a multiple containing Input ----- YSDATA(1)=[DATA] YSDATA(2)=CAPP,ANDY W^MMPI2^--- ZUNG ---^2940509^05/09/1994^CAULFIELD,MARY A YSDATA(3)="12121212121212121212" YSDATA(4)=R2^ YSDATA(5)=R3^ YSDATA(6)=S1^Total^12^ YSDATA("ON")= A mood disorder screening test (ZUNG) was in the low range (score = 12). sub-fields RESULTS NUMBER (#.01), RESULTS DESCRIPTION (#1) and RESULTS The text and decision criteria is stored in MH MULTIPLE SCORING file (#601.6) field RESULTS (#6), sub-field RESULTS TEXT (#2). Example of text to be stored: Test Code Score Text --------- ----- ----- AUDIT <8 An alcohol screening test (AUDIT) was negative (score =\|SCORE\|). >7 An alcohol screening test (AUDIT) was positive (score =\|SCORE\|). TEXT (#2). AUDC <4 An alcohol screening test (AUDIT-C) was negative (score =\|SCORE\|). >3 An alcohol screening test (AUDIT-C) was positive (score =\|SCORE\|). BDI <10 The Beck Depression Inventory suggests minimal mood disorder (score =\|SCORE\|). 10-16 The Beck Depression Inventory suggests mild mood disorder (score =\|SCORE\|). 17-29 The Beck Depression Inventory suggests moderate mood disorder (score =\|SCORE\|). Four new routines YSMTI2, YSMTI6, YTAPI4 and YTAPI5. >29 The Beck Depression Inventory suggests severe mood disorder (score =\|SCORE\|). CAGE <2 An alcohol screening test (CAGE) was negative (score =\|SCORE\|). >1 An alcohol screening test (CAGE) was positive (score =\|SCORE\|). DOM80 A mood disorder screening test (DOM80) was negative. A mood disorder screening test (DOM80) was positive. 1. The DOM80 does not have a cut-off score. Rather, the algorithm is: One modified routine YTAPI2. a. If Q1 returned = Y, then the test is positive. b. If Q2 returned = Y and Q3 = Y and Q4 > 1, then the test is positive. c. If neither a nor b (above) is true, then the test is negative. DOMG <4 A mood disorder screening test (DOMG) was negative (score =\|SCORE\|). >3 A mood disorder screening test (DOMG) was positive (score =\|SCORE\|). MISS <107 This patient endorsed a significant number of items Two new APIs and Remote Procedures YTAPI PREVIEW and YTAPI OUTNOTE. associated with PTSD (MISS score =\|SCORE\|). >106 This patient endorsed fewer items associated with PTSD than is commonly found in Vietnam veterans diagnosed with PTSD (MISS score =\|SCORE\|). SMAST >2 Positive screen for alcoholism. 6 or 10 or 11 Previous treatment for alcoholism reported. <3 Negative screen for alcoholism. ZUNG <33 A mood disorder screening test (ZUNG) was in the low range (score =\|SCORE\|). 33-50 A mood disorder screening test (ZUNG) was in the medium range (score =\|SCORE\|). >50 A mood disorder screening test (ZUNG) was in the high range (score =\|SCORE\|). Additional Information ---------------------- 1. The AIMS progress note should have each item and each item response included in the progress note. Below is an example progress note created using an AIMS test from file MH INSTRUMENTS (#601). Note that the items are separated by headings that are not in the item text, and that the first Documentation for APIs and RPCs 5 lines contain the total score and the number of items rated mild, moderate and severe. Example of an AIMS note ----------------------- The patient was evaluated for symptoms of tardive dyskinesia using the AIMS. Total score for items 1-7: 8 Number of items 1-7 rated "mild": 1 Number of items 1-7 rated "moderate": 1 ------------------------------- Number of items 1-7 rated "severe": 1 Facial and oral movements: Muscles of facial expression Minimal Lips and perioral area Minimal Jaw None Tongue Moderate Extremity movements: Upper (arms, wrists, hands, fingers) Mild and saving of psychological testing data. This data normally resides in the 1. PREVIEW Lower (legs, knees, ankles, toes) None Trunk movements: Neck, shoulders, hips Minimal Global judgments: Severity of abnormal movements Mild RPC: YTAPI PREVIEW NOIS Call(s): AMA-0200-70550 Test Site(s): Amarillo, TX El Paso, TX Fargo, ND Grand Junction, CO Huntington, WV Miami, FL Sheridan, WY South Texas HCS M: PREVIEW^YTAPI4 ST Louis, MO Tampa, FL West Palm Beach, FL White River Junction, VT ROUTINE SUMMARY: ================ The second line of the routine now looks like: This API allows scoring of patient responses to a test or interview without <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ----------- YSMTI2 N/A 7197346 62 YSMTI6 N/A 550933 62 YTAPI2 6279046 6291220 53,62 making changes in the M database. The patient ien, the test code, and YTAPI4 N/A 2425764 62 YTAPI5 N/A 3665995 62 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. administration date is required along with the responses. All responses are 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global checked for validity. Scoring is returned in the output documented in the 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0162' and proceed with install. SCOREIT API. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Input: PSYCH INSTRUMENT PATIENT file (#601.2) for patient responses and the ------ 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: MH INSTRUMENT file (#601) for test and interviews. In addition, the ------- 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 . . APIs/RPCs retrieve ADDICTION SEVERITY INDEX data found in the ADDICTION And onward as needed Example: -------- Input ----- YS("DFN")=6 YS("ADATE")="T" YS("CODE")="ZUNG" SEVERITY INDEX file (#604) and Global Assessment of Functioning (GAF) data YS("STAFF")=67 YS("R1")="12121212121212121212" Output ------ YSDATA(1)=[DATA] YSDATA(2)=CAPP,ANDY W^MMPI2^--- ZUNG ---^2940509^05/09/1994^CAULFIELD,MARY A YSDATA(3)="12121212121212121212" YSDATA(4)=R2^ YSDATA(5)=R3^ found in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). YSDATA(6)=S1^Total^12^ 2. OUTNOTE RPC: YTAPI OUTNOTE M: OUTNOTE^YTAPI5 This API returns text to be entered in a progress note based on the outcome of a test administration. Input is the output of SCOREIT or PREVIEW API. Output adds this text to the output YSDATA. 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 This patch contains: . . 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) 64 SEQ #57 DATE APPLIED: 2000-06-26 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch releases a new Mental Health API named YSGAFAP1. This API will Fargo, ND Grand Junction, CO Huntington, WV Miami, FL Sheridan, WY South Texas HCS ST Louis, MO Tampa, FL West Palm Beach, FL White River Junction, VT allow the calling routine to store the Global Assessment of Functioning (GAF) ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values data in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8). The fields Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSGAFAP1 N/A 1639398 64 Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto that will store the GAF data are PATIENT NAME (#.02), DATE/TIME OF your system. 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global DIAGNOSIS (#.03), DIAGNOSIS BY (#.04), TRANSCRIBER (#.05), AXIS 5 (#65) Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option and PATIENT TYPE (#66). 'Install Package(s)' Select the package 'YS5.0164' and proceed with install. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Test Site(s): El Paso, TX 59 SEQ #58 DATE APPLIED: 2000-08-16 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch addresses the following issues in the Mental Health GAF software. subject 'NPT/XXX #XXXXXXXXXXXX' from the NPCD at the AAC. The 'XXXs' Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. in the subject are random alphanumerics produced by the AAC system. The 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0159' and proceed with install. 7. When prompted 'Enter the Coordinator for Mail Group 'YS GAF TRANSMISSION ACK':', respond with the name of the user responsible for monitoring the GAF performance measure. 8. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion report will contain the number of messages received, number of messages of Install? YES//', respond YES. 9. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 10. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. processed and number of messages processed in error. The report will also contain a detail line for each type of error. The detail error line of the report will contain the reject message ID number, Error Code, Event Date-Time, Social Security Number, Last Name of Patient, Date of Birth and the Inpatient/Outpatient Status. A document, YS_501_59.PDF, describing the error codes provided by NPCD is available on one of the following OI Field Offices' ANONYMOUS.SOFTWARE directories in Albany, Hines or Salt Lake City. 2. The routine YSGAFOBX was setting the Mail Group to use 'YS GAF TO NPCD', therefore sending a MAILMAN message containing text to be processed by NPCD at the AAC. These messages should have been sent locally to the members of Mail Group 'YS GAF TRANSMISSION ACK' who are responsible for the Global Assessment of Function monitoring. The subjects of these messages are 'GAF Score Sent' and 'GAF Score Transmission Problem'. The message 'GAF Score Sent' contains the patients name, date of observation the GAF score was assessed and the HL7 message number 1. The description of Mail Group 'YS GAF TRANSMISSION ACK' has been edited. transmitted to NPCD at the AAC. The message 'GAF Score Transmission Problem' contains the reason why the message was not transmitted, user who entered the GAF score, patient name, observation date and file entry date. 3. A new option 'GAF Transmission' [YS GAF TRANSMISSION] will be used to retransmit GAF data for a given date range to the National Patient Care Database at the Austin Automated Center in Austin, TX. This mail group will receive a message with the subject of 'GAF Score NOIS call(s): BOS-0399-12563 TUA-0199-31948 Test Site(s): Connecticut HCS, CT Gulf Coast HCS, MS Iowa City, IA Muskogee, OK Tampa, FL Portland, OR Sent' when a GAF score is transmitted to the National Patient Care West Palm Beach, FL DOCUMENTATION RETRIEVAL: ======================== The documentation file is available on one of the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain this file. OI FIELD OFFICE FTP ADDRESS DIRECTORY Database (NPCD) at the Austin Automation Center (AAC) in Austin, Texas. ================ =========== ========= ALBANY 152.127.1.5 [ANONYMOUS.SOFTWARE] HINES 152.129.1.110 [ANONYMOUS.SOFTWARE] SALT LAKE 152.131.2.1 [ANONYMOUS.SOFTWARE] The documentation can be found in a file named YS_501_59_EC.PDF. ROUTINE SUMMARY: If an error in the transmission has occurred the subject of the message ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ----------- YSGAFOBX 3380035 3468829 43,50,59 will be 'GAF Score Transmission Problem'. This mail group will also be YSGAFTR 5664313 4952427 43,49,59 * PLEASE NOTE THAT ROUTINE YSGAFOBX BEFORE PATCH CHECKSUM * * IS DIFFERENT FROM THE AFTER PATCH CHECKSUM IN THE * *** RELEASED PATCH YS5.0150. *** Installation Instructions: ========================== used to receive a transmission report, GAF Facility Report, with the 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: Print Transport Global 23 SEQ #23 DATE APPLIED: 1996-12-24 00:00:00 APPLIED BY: USER,ONE 66 SEQ #59 DATE APPLIED: 2001-02-28 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: The following items are addressed in patch YS5.0166: DAY-0200-42682 Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0166' and proceed with install. 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 2. The test (STAI), 'STATE-TRAIT ANXIETY SCALE', a general test of anxiety as a mood (state) and as a personality characteristic (trait) was scored directly. The Scale #2 Trait Anxiety (Item #34) has been changed to score indirectly. 3. The test 'Personality Assessment Inventory' (PAI) scoring routine YTPAI has been edited to correct an indexing problem at ADDIT+5^YTPAI. 4. The RESPONSE PROMPT field (#4), of the multiple ITEM NUMBER field (#1), of the MH INSTRUMENT file (#601) for the entry 'Personality Assessment Inventory' (PAI) has been changed to a semicolon following the word "false" so parsing of the response can be done. 5. The RESPONSE PROMPT field (#4), of the multiple ITEM NUMBER field (#1), of the MH INSTRUMENT file (#601) for the entry 'Beck Anxiety Index' (BAI) has been changed to a semicolon following the word "unpleasant" so parsing of the response can be done. 1. When selecting the option 'Psychological tests/interviews (administer)' 6. The test 'Depression Outcomes Module' (DOM) scoring routine YSMTI1 was modified to allow multiple test scoring. 7. The following fields were found setting %DT(0) to some value, with no corresponding Kill of %DT(0) in the Input Transform. Leaving %DT(0) defined can have an adverse impact on the end user. This patch places the KILL of %DT(0) after the call of ^%DT in the Input transform. ISF-1100-60368 The following PSYCH INSTRUMENT PATIENT (#601.2) and SECLUSION/RESTRAINT [YSADMTEST] to administer the instrument 'Abnormal Involuntary Movement (#615.2) file/subfile fields Input Transforms have been edited: File/Sub-file# Field# Field Name 601.2/601.22 .01 COMPLETION DATE 4 ADMINISTRATION DATE 14 DATE BEGUN 601.2/601.2213 1 DATE OF COMMENT 5 DATE/TIME SIGNED 8 DATE/TIME COSIGNED 615.2 .01 FILE ENTRY DATE Scale' (AIMS) the user is instructed to enter the key letter "E" to view .03 DATE/TIME APPLIED 42 TIME REMOVED 54 REVIEW FILED 615.2/615.3 .01 CHECK TIME NOIS Call(s): ISF-1100-60368 DAY-0200-42682 examination procedures and then to enter any key in order to progress. Test Site(s): Dayton, OH Eastern Kansas HCS, KA Little Rock, AR Salt Lake City, UT VA Health Care Network Upstate New York System, NY ROUTINE SUMMARY: ================ At the end of the instructions, any key will not work. The user has to The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSMTI1 8825610 8854657 53,66 use the ENTER key to exit the instructions. This has been corrected to YTAIMS 3709923 3711230 54,66 YTALUSR N/A 2954815 66 YTPAI 7779058 7863323 10,66 YTPCL N/A 4037903 66 Installation Instructions: ========================== accept any key entered as instructed. 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: 69 SEQ #60 DATE APPLIED: 2001-07-10 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: 1. The YSCL WEEKLY TRANSMISSION [Weekly Clozapine Report] option should is no longer necessary and its associated task should be deleted (see item 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 2. Review your mapped set. If the routines are mapped, they should be removed from the mapped set at this time. 3. The patch has now been loaded into a Transport global on your system. You now need to use KIDS to install the Transport global. 10 in the installation instructions below). The demographics data will On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 4. Users may remain on the system, installation may be done at any time except during the time scheduled for the Clozapine now be collected during the regular roll-up. No error will occur and no roll-up. 5. No options need to be placed out of service. 6. Installation time is less than 2 minutes during off peak hours and less than 5 minutes during peak hours. 7. Installation of this patch requires no additional memory space. harm will be done if this task remains active. 8. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0169 and proceed with the install. 9. If any routines were unmapped as part of step 2, they should be returned to the mapped set once the installation has run to completion. 10. Historically, the option YSCL TRANSMIT DEMOGRAPHICS [Transmit Clozapine Demographics] had been queued to run before the start of business every Tuesday. This function has been incorporated into the Clozapine Data Collection and this option is no longer used. This task should be deleted. This is accomplished using the XUTM SCHEDULE [Schedule/Unschedule Options] option. The following screen capture will closely resemble the display from your system. To delete the task, enter the @ sign in the Option Name field and press the Enter key. You will then be asked if you want to delete this record. Answer YES and press the Enter key. 3. The CLOZAPINE LAB TEST file (#603.02) is no longer used for the Schedule/Unschedule Options Select OPTION to schedule or reschedule: YSCL TRANSMIT DEMOGRAPHICS (R) Edit Option Schedule Option Name: YSCL TRANSMIT DEMOGRAPHICS Menu Text: Transmit Clozapine Demographics TASK ID: 526664 ____________________________________________________________________ QUEUED TO RUN AT WHAT TIME: DEC 19,2000@02:00 roll-up. The roll-up software will now use the CLOZAPINE LAB TEST field DEVICE FOR QUEUED JOB OUTPUT: QUEUED TO RUN ON VOLUME SET: RESCHEDULING FREQUENCY: 7D TASK PARAMETERS: SPECIAL QUEUEING: (#17.7) in the DRUG file (#50) to determine the WBC and ANC tests used for ______________________________________________________________________ 11. The YSCL WEEKLY TRANSMISSION [Weekly Clozapine Report] option has been queued to run prior to the start of business one day a week. It has been recommended that the transmission occur on Tuesday, but transmission dates vary. The software has been modified to determine the correct day of the week to run. The option should now be tasked to run each drug. Using this method will ensure a common element between the daily prior to the start of business. The XUTM SCHEDULE [Schedule/Unschedule Options] option should be used to set the QUEUED TO RUN AT WHAT TIME: entry to tomorrows date at a time prior to the start of business and the RESCHEDULING FREQUENCY entry to "1D" (once daily). The following is an example of the display from the XUTM SCHEDULE option. Edit Option Schedule Option Name: YSCL WEEKLY TRANSMISSION Menu Text: Weekly Clozapine Report TASK ID: 518605 dispensing and tracking of the prescription. ____________________________________________________________________ QUEUED TO RUN AT WHAT TIME: T+1@0200 DEVICE FOR QUEUED JOB OUTPUT: QUEUED TO RUN ON VOLUME SET: RESCHEDULING FREQUENCY: 1D now be queued to run daily instead of weekly (see item 11 in the TASK PARAMETERS: SPECIAL QUEUEING: ______________________________________________________________________ 4. The Weekly Clozapine Report [YSCL WEEKLY TRANSMISSION] option has been modified to respond to the Kernel Stop Task Manager [XUTM STOP] option. This provides a graceful way to terminate processing of the roll-up. Requesting Site: National Clozapine Coordinating Center Test Site(s): Battle Creek Canandaigua Western New York installation instructions below). A new file CLOZAPINE PARAMETERS Pittsburgh Reference NOIS: BHS-0900-11492 CLOZAPINE DEMOGRAPHICS MESSAGE The message generated for the transmission of data to the national database indicates certain demographic data is missing for a patient, including the patient's name. STC-0500-40272 CLOZAPINE MONITOR shows No RX for several pts (#603.03) has been created to maintain site configuration and transmission ALN-0400-11672 CLOZAPINE MONITOR MESSAGE INCORRECT The message generated for the transmission of patient data to the national database incorrectly reported that some patients' had no prescription data. This was due to the method used to collect and compare the date of the prescription to the current date. SDC-0896-62071 CLOZAPINE MONITOR ILLEGALLY WANTS data to be reported back to the National Clozapine Coordinating Center RACE Some sites were concerned because the Clozapine roll-up software requires that the patient's race be entered into the database. This is clinically relevant data and is required by both the manufacturer and the Food and Drug Administration (FDA). Race may be entered as long as permission to report this data is obtained on the consent to release document. See VHA Directive 99-035. NCCC in Dallas. This file also contains an entry indicating the day of ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30,1994 Checksum Values the week the roll-up should occur. Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSCLSERV 33969291 24479509 18,22,26,47,61,69 YSCLSRV1 1286296 1579043 61,69 YSCLSRV2 NEW 16840829 69 YSCLTEST 9052437 12420746 18,22,26,47,61,69 YSCLTST1 12553719 15378976 18,22,25,26,47, 61,69 YSCLTST2 11500297 11122299 18,22,26,47,61,69 YSCLTST3 12171877 13878933 18,22,25,26,47, 61,69 Installation Instructions: ========================== NOTE: This KIDS install does not place any options out of service during the install and no user options are affected. The site should answer "NO" to all three questions. 2. The YSCL TRANSMIT DEMOGRAPHICS [Transmit Clozapine Demographics] option Note: You may not receive all three prompts at your site. "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO" "Want KIDS to INHIBIT LOGONs during the install? YES// NO" "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO" 72 DATE APPLIED: 2001-10-16 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch addresses the following issue in the Mental Health software. 5. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//, respond "NO". Test Site(s): Salt Lake City, UT ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ----------- NO ROUTINES EXPORTED WITH THIS PATCH SOFTWARE RETRIEVAL: =================== 1. In the MH INSTRUMENT file (#601) field OPERATIONAL (#32), data value The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_72.KID YS5.0172 KIDS build ASCII The software files are available on one of the following OI Field Offices' ANONYMOUS.SOFTWARE directories. has been changed from null to "N" in the following instruments CES, All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] FES, GES, WES, CPI, FIRO, SII, MYER, MCMI, MMPR and the M168. This Installation Instructions: ========================== 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. START UP KIDS From the KERNEL Installation and Distribution Systems (KIDS) field when SET to "N" indicates that the instrument is NOT operational. Menu, select the Installation menu [XPD INSTALLATION MENU]: Edits and Distribution ... Utilities ... Installation ... 2. SELECT INSTALLATION OPTION Select Installation Option: Load a Distribution Enter a Host File: YS_501_72.KID This allows the instrument to remain in the data base but can NOT be This Distribution contains Transport Globals for the following Package(s): YS5.0172 Use INSTALL NAME: YS5.0172 to install the Distribution. NOTE: The following are OPTIONAL: a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes, such as DDs or templates. USED. b. Compare Transport Global to Current System - This option will a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes, such as DDs or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 3. SELECT INSTALLATION OPTION: Install Package(s) Select KIDS OPTION: INSTALL PACKAGE(S) Select INSTALL NAME: YS5.0172 4. When asked "Want KIDS to INHIBIT LOGONS during the install? Yes//", respond "NO". 67 DATE APPLIED: 2001-11-06 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Patch YS5.0167 COTS ASI-MV introduces the required components necessary to and the patient interact with the ASI-MV. The clinician logs on to VistA, OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] Installation Instructions: ========================== initializes program parameters, and enters patient demographic info. The 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. START UP KIDS From the KERNEL Installation and Distribution Systems (KIDS) Menu, select the Installation menu [XPD INSTALLATION MENU]: Installation Edits and Distribution ... Utilities ... Installation ... patient then responds to questions presented by the multimedia interface. 2. SELECT INSTALLATION OPTION Select Installation Option: Load a Distribution Enter a Host File: YS_501_67.KID This Distribution contains Transport Globals for the following Package(s): YS5.0167 Use INSTALL NAME: YS5.0167 to install the Distribution. The clinician needs not be present during the time when the patient is NOTE: The following are OPTIONAL: a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes, such as DDs or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow responding to questions. After the patient completes the interview, the you to ensure the integrity of the routines that are in the transport global. 3. SELECT INSTALLATION OPTION: Install Package(s) Select KIDS OPTION: INSTALL PACKAGE(S) Select INSTALL NAME: YS5.0167 4. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? Yes//", respond "NO". clinician starts the interface (YSASIMV) again, to upload the interview 5. When asked "Want KIDS to INHIBIT LOGONS during the install? Yes//", respond "NO". 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//, respond YES. When prompted to select the options you would like to place out of order, enter the following: Addiction Severity Index [YSAS ASI USER MENU] data to VistA. 7. Retrieve and open the file: YS_501_67.ZIP 8. Place the MENTAL HEALTH ADDICTION SEVERITY INDEX MULTIMEDIA VERSION (ASI-MV) INSTALLATION AND USER GUIDE in a location that can be accessed by ASI-MV users. 9. Please refer to the POST INSTALLATION INSTRUCTIONS section of the MENTAL HEALTH ADDICTION SEVERITY INDEX MULTIMEDIA VERSION (ASI-MV) INSTALLATION AND USER GUIDE to install the COTS ASI-MV software, YS50167_ASIMV.EXE, YS50167_SecureDesktop.EXE and YS50167_KeyboardHook.DLL. 10. Place the option YS BROKER [YS BROKER] on the Mental Health users secondary menu. 11. Routine YS67 will be deleted after successful patch installation. SecureDesktop is a software module that restricts user (patient) access to the Windows desktop, to task-switching functions, and to other programs on install and run the Commercial Off the Shelf (COTS) Addiction Severity Index the workstation, while the patient responds to the interview. This module implements the bulk of security countermeasures for the ASI-MV system. The patch contains the following additions and modifications to the VistA Mental Health software: Data in the ASI QUICK FORM file (#604.66), REQUIRED field (#11) has been changed from '1' to a Null value making the following questions to be non-required for scoring the ASI: M10, M11, E23, E24, L31, L32, F37, F38, P21 and P22. This process will be performed by the post routine YS67. Multimedia Version (ASI-MV) software product. The ADDICTION SEVERITY INDEX file (#604) fields CLASS (#.04) and CONTACT CODE (#.07) have a new selection code, "For ASI-MV". The ADDICTION SEVERITY INDEX file (#604) fields ELECTRONICALLY SIGNED (#.51) and E SIGNATURE INTERVIEWER (#.52) data attributes have been changed to allow these fields data to be edited. Two new entries have been added to the ASI NARRATIVE file (#604.68). The two new narrative reports are the ASI-MV ITEM REPORT and the ASI-MV NARRATIVE. The routine YSASNAR has been modified to produce the ASI-MV ITEM REPORT and the ASI-MV NARRATIVE. The new option YS BROKER [YS BROKER] contains the context necessary to interface the ASI-MV to VistA. A Remote Procedure YTAPI NEW ASI has been created. The Mental Health ASI-MV, Vista version, is a software product that is the The new routine YTAPI8 allows silent additions to the ADDICTION SEVERITY INDEX file (#604). Test Site(s): Boston Health Care System, MA Puget Sound Health Care System, WA Salt Lake City, UT VA Health Care Network Upstate New York System, NY White City, OR result of the combination of a commercial (COTS) multimedia application Routine Summary =============== The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values (ASIMV) and a VA-developed interface to the VistA database (YSASIMV). The Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YS67 N/A 182239 67 (Deleted by Kids) YSASNAR 11561066 11815417 24,30,37,38,44 55,67 YTAPI8 N/A 3139609 67 SOFTWARE RETRIEVAL: =================== ASI-MV is a patient self-administered psychological instrument that can be The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_67.KID YS5.0167 KIDS build ASCII YS_501_67.ZIP BINARY - YS50167_ASIMV.EXE ASI-MV Interface Executable - YS50167_SecureDesktop.EXE Secure Desktop Executable - YS50167_KeyboardHook.DLL Keyboard Hook DLL used by Secure Desktop used to gather patient data directly from the patient. Both the clinician - YSASIMV_IGUM.PDF YS5.0167 ASI-MV Installation Guide User Manual The software files are available on one of the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. 73 SEQ #63 DATE APPLIED: 2002-03-27 00:00:00 APPLIED BY: USER,ONE 71 DATE APPLIED: 2002-06-26 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Associated patches: (v)SD5.3262 install with patch `YS5.0171' viz., psychological testing, the Addiction Severity Index (ASI), and SOFTWARE RETRIEVAL: =================== The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_71.KID DG5.3447 ASCII SD5.3262 the Global Assessment of Functioning (GAF). XU8234 YS5.0171 Note: Please refer to the DG, SD, and XU informational patch descriptions for details on second line, checksums, and patch information. YS50171_Setup_123.EXE Mental Health Assistant BINARY This file is the complete install for the Mental Health Assistant GUI client. YS50171_MHA_IG.PDF YS5.0171 MHA Installation Guide YS50171_MHA_IG.DOC YS5.0171 MHA Installation Guide YS50171_MHA_UM.PDF YS5.0171 MHA User Manual YS50171_MHA_UM.DOC YS5.0171 MHA User Manual The software files are available on the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All previous tests completed by the selected patient are listed on the All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] Test Results tab. A text report is shown for the selected test, and Installation Instructions: ========================== 1. Use the 'LOAD A DISTRIBUTION' option on the PackMan menu. The Host File name is YS_501_71.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 graphs of numeric scores are available across all instances of a given system. You now need to install the Transport global. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global test. 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'MHA GUI YS5.0171' and proceed with install. 6. If you do not intend to queue the installation to run after normal business hours, then answer "NO" to the following prompt: Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO If you answer "YES", then the installation will require much more than 5 minutes to run due to the menu rebuild process. The Order Tests tab enables the user to specify the staff person 7. 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. 8. Retrieve and execute the file YS50171_Setup_123.EXE ordering the test and to select from among the tests available to the 9. Place the MENTAL HEALTH ASSISTANT USER MANUAL in a location that can be accessed by MHA users. 10. Please refer to the POST INSTALLATION INSTRUCTIONS section of the MENTAL HEALTH ASSISTANT INSTALLATION GUIDE to install the MHA software. 11. Place the option YS BROKER1 [YS BROKER1] on the Mental Health users secondary menu. (v)XU8234 install with patch `YS5.0171' person who ordered the test. Three data entry modes are available: (1) Staff entry is optimized for the entry of staff rating data (e.g., the AIMS), which requires the user to see the test questions and answers. (2) Clerk entry is optimized for transcribing test data from paper answer sheets. (3) Patient entry is optimized for on-line testing of patients. The patient entry option contains security features to prevent unattended patients from using the PC in unauthorized ways. (v)DG5.3447 install with patch `YS5.0171' The ASI tab lists all previous ASI interviews and makes it easy to view either the item report or narrative report for a selected interview. To help with ASI performance measure compliance, the interval since the last interview is displayed. New views of ASI data are the "Domain Scores" and "Item Trends" buttons, which present graphical and tabular data across multiple interviews. The Domain Scores button gives the user the opportunity to see either problem severity ratings or evaluation factor scores. The Item Trends button displays responses to selected individual items. It is hoped that these data views will help with treatment planning and treatment outcome monitoring. A user- friendly interface for entering interview data is provided. This tab enables staff to quickly enter data, to easily jump from one item to another, and to enter free text comments at any time. This tab should greatly reduce data entry time, whether transcribing interview results from a paper form or entering them on-line during an interview. The GAF tab affords the user an easy way to enter GAF ratings and to see previous ratings, which are graphed to indicate trends. When entering a new rating, the rating is associated with the GAF rating criteria. It is hoped this association will increase the reliability Patch YS5.0171 introduces the Mental Health Assistant Graphical User of ratings and reduce inter-rater variability in the assignment of GAF ratings. The patch contains one option, a data change to the PAI entry in the MH MULTIPLE SCORING (#601.6) file, a data change to the MMPI2, AUDC and the DOMG entries in the MH INSTRUMENT (#601) file, 16 routines and 28 Remote Procedures. The new non-menu option YS BROKER1 [YS BROKER1] contains the context necessary to interface the MHA GUI to VistA. Interface to VISTA. E3R#: 16712 Associated NOIS: None Test Site(s): Minneapolis VAMC, MN Salt Lake City HCS, UT VA Health Care Network Upstate New York VA N. Florida/S. Georgia Veterans HCS VA North Texas HCS ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values The Mental Health Assistant (MHA) is a graphical user interface for the Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSASFS N/A 7192558 71 YSASFS1 N/A 5234287 71 YSASRPWP N/A 1197798 71 YSGAFAPI 1326501 1400361 53,71 YSMTI1 8854657 9272666 53,66,71 YSMTI3 6387181 7243669 53,71 YSMTI6 550933 3259607 62,71 YSMTI7 N/A 1484572 71 most frequently used options within the VistA Mental Health Package, YTAPI 9153058 9597980 53,71 YTAPI1 3410744 3829862 53,71 YTAPI6 N/A 4909093 71 YTAPI7 N/A 6440201 71 YTAPI8 3139609 6353687 67,71 YTAPI9 N/A 4471729 71 YTRPEXT N/A 3203374 71 YTRPWRP N/A 3186347 71 74 SEQ #65 DATE APPLIED: 2003-02-04 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: The Clozapine reporting software will automatically discontinue a "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO" "Want KIDS to INHIBIT LOGONs during the install? YES// NO" "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO" Clozapine data is transmitted to the field offices in Hines and Dallas. 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 2. Review your mapped set. If the routines are mapped, they should be removed from the mapped set at this time. 3. The patch has now been loaded into a Transport global on your system. You now need to use KIDS to install the Transport global. The domain names have been changed from ISC-DALLAS.DOMAIN.EXT and On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 4. Users may remain on the system, installation may be done at any time except during the time scheduled for the Clozapine ISC-CHICAGO.DOMAIN.EXT to FO-DALLAS.DOMAIN.EXT and FO-HINES.DOMAIN.EXT. roll-up. 5. No options need to be placed out of service. 6. Installation time is less than 2 minutes during off peak hours and less than 5 minutes during peak hours. 7. Installation of this patch requires no additional memory space. 8. From the 'Installation Menu' of the KIDS menu, run the option: 'Install Package(s)' Select the package 'YS5.0174 and proceed with the install. 9. If any routines were unmapped as part of step 2, they should be returned to the mapped set once the installation has run to completion. THIS PATCH WILL REPORT THE NEW RACE AND ETHNICITY ENTRIES TO THE NATIONAL CLOZAPINE DATABASE. INSTALLATION TIME FRAME : VA DIRECTIVE 2001-023 REQUIRES INSTALLATION OF THIS PATCH WITHIN 30 DAYS FROM THE TIME OF INITIAL RELEASE. patient if the patient's prescription is over 28 days old. This prevents Requesting Site: National Clozapine Coordinating Center Test Site(s): Coatesville Boston Madison Portland Reference NOIS: COA-0901-21209 CLOZAPINE PATIENTS INACTIVATED I've been informed by Pharmacy service that we a patient from being issued medication on an expired prescription. The continue to have Clozapine patients being automatically inactivated (details can be provided). We have previously worked with Stephanie Todd from Dallas on specific problems, however, NOIS BAC-0701-40194 notes in response #22 that a patch is forthcoming. BAC-0701-40194 Random inactivation of clozapine pts Our pharmacy ADPAC has been reporting for awhile Clozapine protocol requires a new prescription each time the medication about Clozapine patients being inactivated. I initially held off reporting this via NOIS because I knew that PSO756 was going to address these problem previously reported by other sites. We installed it in March, but it's happened again randomly. This time I had the adpac report the patients name to me so that I can begin to look at it. BHS-0302-12595 Cloz trans failed is dispensed. Clozapine patients are being discontinued whose MAD-0402-41028 Clozapine transmission failed Both NOIS calls report an undefined error during data transmission. The reporting mechanism has been modified to prevent this error. UNY-0402-11524 CLOZARIL PATIENTS STILL BEING INACTIVATED I still have complaints of patients being inactivated for some reason and the pharmacy needs to activate each time before entering clozaril scripts. The local site has contacted prescriptions are current. This happens when the roll-up occurs between the NCCC and they just tell them to re-activate and there is nothing wrong on their end. ROUTINE SUMMARY: ================ The following routines are included in this patch. The second line of each of these routines now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30,1994 the time when the prescription is entered into the system and when it is Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSCLSERV 24479509 25083145 18,22,26,47, 61,69,74 YSCLSRV1 1579043 1605367 61,69,74 YSCLSRV3 N/A 7345805 74 dispensed. This patch will prevent the patient from being discontinued YSCLTEST 12420746 12047382 18,22,26,47, 61,69,74 YSCLTST1 15378976 15450428 18,22,25,26, 47,61,69,74 YSCLTST2 11122299 11178871 18,22,26,47, 61,69,74 YSCLTST3 13878933 15031797 18,22,25,26, 47,61,69,74 List of preceding patches: 18,22,25,26,47,61,69 until the prescription is 28 days past the fill date. Sites should use CHECK^XTSUMBLD to verify checksums. Installation Instructions: ========================== NOTE: This KIDS install does not place any options out of service during the install and no user options are affected. The site should answer "NO" to all three questions. Note: You may not receive all three prompts at your site. 76 DATE APPLIED: 2003-06-28 00:00:00 APPLIED BY: USER,ONE 70 DATE APPLIED: 2003-11-21 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch addresses the following issues in the Mental Health software. properly. This has been corrected in MHA 1.0.2.10. ISM-0702-90939 EKH-0698-41771 Test Site(s): Battle Creek VAMC, MI Miami VAMC, FL Minneapolis VAMC, MN Portland VAMC, OR VA Central Texas HCS CLE-0303-41699 VA Health Care Network Upstate New York VA N. Florida/S. Georgia Veterans HCS VA NORTHERN CALIFORNIA HCS ROUTINE SUMMARY: ================ The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ----------- YSPOS70 N/A 137198 70 YSPRE70 N/A 401194 70 YSLOCN 1357796 1317415 70 YSMTI3 7694272 7918553 53,71,76,70 YTALUSEC 2558679 3281368 54,70 YTCESD N/A 2054143 70 2. New scales have been added to the Minnesota Multiphasic Personality YTLCTD 2849688 2159359 70 YTMMPI2B 17200069 18391657 10,31,76,70 YTPHQ9 N/A 2995455 70 Sites should use CHECK^XTSUMBLD to verify checksums. SOFTWARE RETRIEVAL: =================== The following software and documentation files are exported as part Inventory-2 (MMPI2). The new scales are the Restructured Clinical of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_70.KID YS5.0170 ASCII YS_501_70.ZIP Mental Health Assistant BINARY This file is the complete install for the Mental Health Assistant GUI version 1.0.2.10 client. (RC) Scales for the MMPI2. The RC scales are based on recent factor - YS_MHA.EXE MHA2 Executable YS50170_Setup_125.EXE Mental Health Assistant BINARY This file is the complete install for the Mental Health Assistant GUI version 1.0.2.10 client. - YS_MHA.exe MHA2 Executable - YS_MHA_SD.exe Secure Desktop Executable analyses of the existing Clinical Scales, and are intended to be used - YS_MHA_KH.DLL Keyboard Hook DLL used by Secure Desktop - YS_MHA.Hlp Online Help file - YS_MHA.GID Online Help configuration file The software files are available on the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the as aids in the interpretation of the Clinical Scale profile. The names quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] of the 9 RC scales are as follows (note that there is no RC5 scale): Installation Instructions: ========================== 1. Use the 'LOAD A DISTRIBUTION' option on the Installation menu of the KIDS menu. The Host File name is YS_501_70.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 install the Transport global. On the KIDS menu, under the 'Installation' menu, use the RCd: Demoralization following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. RC1: Somatic Complaints 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0170' and proceed with install. RC2: Low Positive Emotions 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. Routines YSPRE70 and YSPOS70 are deleted after the installation has successfully completed. RC3: Cynicism RC4: Antisocial Behavior RC6: Ideas of Persecution RC7: Dysfunctional Negative Emotions RC8: Aberrant Experiences RC9: Hypomanic Activation Note: 1. Patients who take the BECK SCALE FOR SUICIDAL IDEATION (BSI) test on The set of MMPI2 scales that are scored and the order in which they are presented has been changed to be consistent with the recommendations of the test authors and publisher. The PTSD-Schlenger scale is no longer scored. 3. Three new psychological tests have been added to the MH INSTRUMENT (#601) file. The new depression measures include the 20-item version Center for Epidemiologic Studies Depression Scale (CESD), the Center the Mental Health Assistant are presented with questions that do not For Epidemiological Studies Depression Scale 5 Items (CESD5) and the Prime-MD Patient Health Questionnaire (PHQ9). The PHQ9 is based on the 9 DSM-IV criteria for Major Depressive Episode, and test results include both the number of criteria met as well as indication of whether the criteria for MDE are met. All can now be administered using the Mental Health Assistant. 4. The Alcohol Use Disorders Identification Test Condensed (AUDC) has been revised to meet the new Alcohol Screening Performance Measure issued by the Office of Quality and Performance. make sense when compared to their previous answers. For example, the 5. The Alcohol Use Disorders Identification Test Condensed Revised (AUDCR) has been made non-operational by setting the value to "N" in the MH INSTRUMENT file (#601) OPERATIONAL field (#32). 6. An entry to the COPYRIGHT HOLDER file (#601.3) has been made for the new psychological test PHQ9. 7. The instrument Revised NEO Personality Inventory (NEOPI) in the MH MULTIPLE SCORING file (#601.6), which allows the user to score patient says that he/she is not suicidal but the test asks him/her multiple instruments, has been edited to correctly return scale scores to be displayed on the Test Results in the Mental Health Assistant (MHA). Also corrected within the NEOPI is item #86 which read "When I'm under a great deal of stress, sometimes I fell like I'm going to pieces.". Item #86 now reads as "When I'm under a great deal of stress, sometimes I feel like I'm going to pieces." detailed questions about the last attempt and possible future attempts 8. When running option List Test and Interviews [YSMLST] from programmer prompt...%DSM-E-ENDOFILE, end of file encountered. This error has been corrected. EKH-0698-41771 9. The instrument Millon Clinical Multiaxial Inventory-III (MCMI3) in the MH INSTRUMENT file (#601) ITEM NUMBER field (#1) entry #41 which read "I've done a number of stupid things on impulse that needed up causing me great trouble.". Item Number #41 now reads as "I've done a number of at suicide. The skip logic for the BSI was not included in MHA. stupid things on impulse that ended up causing me great trouble." CTX-1003-71717 Also within the MCMI3 the TEST SCALE NUMBER field (#16) SCALE NAME sub-field (#.05) for entries 12, 14 and 15 which read: 6B Aggressive/Sadistic 8A Passive-Aggressive 8B Self-Defeating The skip logic for the BSI using the List Manager software worked SCALE NAME entries 12, 14 and 15 now read as: 6B Sadistic 8A Negativistic 8B Masochistic NOIS call(s): CTX-1003-71717 CLE-0303-41699 83 SEQ #68 DATE APPLIED: 2004-03-30 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch fixes problems with scoring of the MBMD instrument. 20 SEQ #24 DATE APPLIED: 1996-12-27 00:00:00 APPLIED BY: USER,ONE 81 SEQ #69 DATE APPLIED: 2004-04-27 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch contains routine YSGAFHL7 which has been modified to send the Test Site(s): HEARTLAND-WEST HCS Miami VAMC, FL Minneapolis VAMC, MN New York HCS, NY ROUTINE SUMMARY: ================ The second line of the routine now looks like: new race and ethnicity data to the National Patient Care Database (NPCD) in <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSGAFHL7 5831582 5842715 43,81 Austin, TX. Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0181' and proceed with install. 7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Associated E3R: N/A Associated NOIS: N/A 87 SEQ #70 DATE APPLIED: 2004-10-15 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch replaces the Mental Health option Usage Statistics [YSMUSE] with Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSTUSE N/A 1776923 87 YTSTAT 5120372 N/A - Deleted during the install Installation Instructions: ========================== The server option Mental Health Test Usage Server [YS TEST USAGE] is 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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: activated by a mail message. The mail message invokes the routine YSTUSE Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation which returns the results of the psychological test instrument usage at the of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0187' and proceed with install. 7. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//', respond YES. Responding with a yes, will add considerable time to the installation. site the mail message is sent to. 8. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 9. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. NOTE: Routine YTSTAT is deleted during the patch installation. This is an example to invoke the server to create the mail message. Select OPTION NAME: XMUSER MailMan Menu a new Mental Health option Mental Health Test Usage Server [YS TEST USAGE]. VA MailMan 8.0 service for XXXX.XXXX_X@MHCVSS.FO-ALBANY.DOMAIN.EXT You last used MailMan: 09/14/04@17:01 You have 2 new messages. NML New Messages and Responses RML Read/Manage Messages SML Send a Message Query/Search for Messages AML Become a Surrogate (SHARED,MAIL or Other) This is a server option to be used only by the members of the National Mental Personal Preferences ... Other MailMan Functions ... Help (User/Group Info., etc.) ... Select MailMan Menu Option: S Send a Message Subject: YS TEST USAGE You may enter the text of the message... Input file does not exist [EOB] Health Strategic Healthcare Group (MHSHG) to determine the annual C 3031001^3040930 <--------- The dates requested to do the search must be in VA FILEMAN's conventional [EOB] internal format. The first date is the start date and the second date is the end date for the request. psychological test instrument usage at a site. EX USER$:[XXXXXXX]DIWE$545444715.TMP;1 1 line Send mail to: XXXXXX,XXXX X// S.YS TEST USAGE Mental Health Test Usage Server --------------- And Send to: The form of the mail message is identical to any other mail message except that it is addressed to S.<option name>. The "S." routes the message to the server request software. The output from the server request is returned in the form of a MAILMAN message. This is an example of the server request to S.YS TEST USAGE. --------------- Subj: MH testing Statictics: YS TEST USAGE [#79130] 09/15/04@14:39 14 lines From: MH AUTOMATED TESTING REPLY In 'IN' basket. Page 1 New ------------------------------------------------------------------------------- 377^Dallas OIFO^377 This patch contains one new server option Mental Health Test Usage Server [YS From: 3031001 To: 3040930 AUIR^7^2 CRS^19^3 ZUNG^87^1 MMPI2^202^1 MISS^205^3 PAI^216^1 BDI^223^1 CAGE^226^2 TEST USAGE] and one new routine YSTUSE. Option Usage Statistics [YSMUSE] AIMS^234^1 BDI2^245^4 MCMI3^246^1 Nois call(s): None Test Site(s): Minneapolis VAMC, MN and routine YTSTAT are deleted during installation of the patch. Salt Lake City VAMC, UT VA Health Care Network Upstate New York, NY E3Rs: None ROUTINE SUMMARY =============== The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[Patch List];Dec 30, 1994 78 SEQ #71 DATE APPLIED: 2004-11-11 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: **************************************************************************** Professional Version 2002 Service Pack 1. global. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0178' and proceed with install. 7. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion This patch also deletes option YS BROKER [YS BROKER] from the OPTION file of Install? YES//', respond YES. Responding with a yes, will add considerable time to the installation. 8. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 9. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 10. Retrieve and open the file: YS_501_78.ZIP (#19). 11. Place the MENTAL HEALTH ADDICTION SEVERITY INDEX MULTIMEDIA VERSION (ASI-MV) INSTALLATION AND USER GUIDE in a location that can be accessed by ASI-MV users. 12. Please refer to the POST INSTALLATION INSTRUCTIONS section of the MENTAL HEALTH ADDICTION SEVERITY INDEX MULTIMEDIA VERSION (ASI-MV) INSTALLATION AND USER GUIDE to install the COTS ASI-MV software, YS_ASIMV.EXE, YS_ASIMV_SD.EXE and YS_ASIMV_KH.DLL. 13. Place the option YS BROKER1 [YS BROKER1] on the Mental Health users secondary menu if it does not already exist. Nois call(s): PRO-1103-12097 LIT-1103-71512 GRJ-1103-51290 ANC-1003-52367 IMPORTANT NOTE TO IRM THIS PATCH MUST BE INSTALLED. ALTHOUGH NO ROUTINES SBY-1003-32313 FGH-1003-31033 MAC-1003-60102 CHY-0903-52052 NOL-0903-71215 NTH-0903-71179 HWH-0903-41110 ALT-0402-20514 BHS-0102-11169 ARE INCLUDED IN THIS PATCH KIDS DELETES THE OPTION YS BROKER [YS BROKER] Test Site(s): Atlanta VAMC, GA Cheyenne VAMC, WY Grand Junction VAMC, CO Little Rock VAMC, AR Houston VAMC, TX New Orleans VAMC, LA Oklahoma City VAMC Salisbury VAMC, NC Salt Lake City, UT WHEN THE PATCH IS INSTALLED. Topeka VAMC, KA VA Health Care Network Upstate New York System, NY VA Puget Sound Healthcare System, WA ROUTINE SUMMARY =============== The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[Patch List];Dec 30, 1994 Checksum Values **************************************************************************** Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- N/A The following software and documentation files are exported as part of - YSASIMV_IGUM.PDF YS5.0178 ASI-MV Installation Guide this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_78.ZIP BINARY - YS_501_78_SETUP_1_0_3_10.EXE ASI-MV complete install for version 1.0.3.10 of the ASI-MV - YS_ASIMV.EXE ASI-MV Interface Executable - YS_ASIMV_SD.EXE Secure Desktop Executable - YS_ASIMV_KH.DLL Keyboard Hook DLL used by Secure Desktop - YS_ASIMV.EXE ASI-MV Interface Executable - YS_ASIMV_SD.EXE Secure Desktop Executable - YS_ASIMV_KH.DLL Keyboard Hook DLL used by Secure Desktop Patch YS5.0178 updates the file YS_ASIMV.EXE to be invoked from the - YSASIMV_IGUM.PDF YS5.0178 ASI-MV Installation Guide User Manual - YSASIMV_IGUM.DOC YS5.0178 ASI-MV Installation Guide User Manual The software files are available on one of the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the Computerized Patient Record System (CPRS) GUI Tool Bar. YS_ASIMV.EXE now quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] supports Windows 2000 (W2K) operating system and Microsoft Windows XP Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 2. The patch has now been loaded into a Transport global on your system. You now need to use KIDS to install the Transport 77 DATE APPLIED: 2004-12-28 00:00:00 APPLIED BY: USER,ONE 84 SEQ #73 DATE APPLIED: 2005-02-04 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: ============================================================================= (#2) for the entry the Beck Depression Inventory-II (BDI2) a period has ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] Installation Instructions: ========================== 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto been added to the end of each response number. This will allow a reminder your system. 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: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global to be built by the Clinical Reminder software. Here is an example of the Backup a Transport Global 3. Installation of this patch should be at off peak hours. 4. Users may remain on the system. 5. Installation will take less than five minutes. Installation of this patch requires no additional memory space. 6. From the 'Installation Menu' of the KIDS menu, run the option edit made to ITEM NUMBER 2 of the BDI2 instrument using a FILEMAN inquiry: 'Install Package(s)' Select the package 'YS5.0184' and proceed with install. 7. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//', respond NO. Responding with a yes, will add considerable time to the installation. 8. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 9. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 10. Please refer to the POST INSTALLATION INSTRUCTIONS section of the MENTAL HEALTH ASSISTANT VERSION 2 INSTALLATION GUIDE to install the MHA software. Before patch: ITEM NUMBER: 2 VALID RESPONSE SET: 0123X TEXT: PESSIMISM IMPORTANT NOTE TO IRM THIS PATCH MUST BE INSTALLED. ALTHOUGH NO ROUTINES 0 I am not discouraged about my future. 1 I feel more discouraged about my future than I used to be. 2 I do not expect things to work out for me. 3 I feel my future is hopeless and will only get worse. After patch: ITEM NUMBER: 2 VALID RESPONSE SET: 0123X TEXT: PESSIMISM ARE INCLUDED IN THIS PATCH KIDS UPDATES THE MH INSTRUMENT file (#601) WITH 0. I am not discouraged about my future. 1. I feel more discouraged about my future than I used to be. 2. I do not expect things to work out for me. 3. I feel my future is hopeless and will only get worse. 2. In the Mental Health Assistant GUI version 1.0.2.9 when using the mouse scroll button in the left-hand pane, the pane freezes at times. Returning to the desktop the mouse arrow suddenly becomes unresponsive to mouse movements and begins performing the movements that should have occurred in DATA WHEN THE PATCH IS INSTALLED. the Mental Health Assistant - in the same area of the screen where the lists of tests was. This has been corrected in MHA 1.0.2.10 to properly navigate the large amounts of patient psychological test data users may have. 3. The instrument ANALYSIS OF RELATIONSHIPS (AOR) has been made non-operational by setting the value to "N" in the MH INSTRUMENT file (#601) OPERATIONAL field (#32). Nois call(s): None ============================================================================= Test Site(s): New Orleans VAMC, LA Portland VAMC, OR Salt Lake City VAMC, UT VA Health Care Network Upstate New York ROUTINE SUMMARY =============== The second line of the routine now looks like: <tab> ;;5.01;MENTAL HEALTH;[Patch List];Dec 30, 1994 Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- N/A Patch YS5.0184 addresses three issues within the Mental Health software. The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_MHA.exe Mental Health Assistant Binary Executable GUI version 1.0.2.10 client. YS50184_Setup_123.EXE Mental Health Assistant BINARY This file is the complete install for the Mental Health Assistant GUI version 1.0.2.10 client. - YS_MHA.exe MHA Executable - YS_MHA_SD.exe Secure Desktop Executable - YS_MHA_KH.DLL Keyboard Hook DLL used by Secure Desktop - YS_MHA.Hlp Online Help file - YS_MHA.GID Online Help configuration file The software files are available on one of the following OI Field 1. In the MH INSTRUMENT file (#601), ITEM NUMBER field (#1), TEXT sub-field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= 88 SEQ #74 DATE APPLIED: 2005-09-24 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Under certain coditions when entering an Outpatient ASI the message Progress Note Created will display when it has not been created. 90 SEQ #75 DATE APPLIED: 2006-09-23 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Recent changes in the Clozapine protocol require changes to the Clozapine in the past. Enter the type of the test for Clozapine: WHITE BLOOD COUNT Enter the reporting method of the test for Clozapine: ? Enter a code from the list. Select one of the following: 0 uL 1 K/uL 2 Percent Enter the reporting method of the test for Clozapine: 2 Percent Enter the name of the test for Clozapine: The FDA (Food and Drug Administration) uses White Blood Cell Count and Absolute Neutrophil Count as the definitive tests to verify for Clozapine use, however your lab may report your data under any of the names you enter into these lists. If the WBC and ANC are not directly available, The weekly roll-up creates a report that is sent to the local G.PSOCLOZ ANC will be calculated from the other data available and presented to Pharmacy (and CPRS (Computerized Patient Record System) during a later revision) at the time of dispense and used to evaluate the safety under FDA limits. Only the most recent WBC will be accepted, and the date and time stamp of the Neutrophil count must match the date and time stamp of the WBC. WHITE BLOOD CELL (WBC) mail group. This report lists the patients reported to the national For reference "White Blood Cell Count" is a portion of the total blood content and the sum total of two different kinds of cells - AGRANULOCYTES - those cells which do not have granules that absorb a stain. These cells are subdivided into Lymphocytes and Monocytes. GRANULOCYTES -- those cells which contain granules that absorb a stain. These cells are subdivided into Neutrophils, Basophils, and Eosinophils. database along with an indicator showing whether or not Lab and RX data Both Agranulocytes and Granulocytes are part of the Total White Blood Cell Count. Therefore, the total WBC is the sum of five different types of cells. WBC as well as its five components are usually expressed as the total number of cells in a cubic centimeter of blood (cc) or cubic millimeter (cu mm or mm-3)or milliliters (mL). WBC usually falls with a range between 4000 and 11,000 but fluctuates for were transmitted. This report has been updated to show the date of the a number of medical reasons. For brevity, WBC results may be divided by 1000 and presented as K/cc or K/cu mm or K/mm-3 or K/mL The five components are similarly expressed as number of the same type OR as a percentage of the total WBC. The sum of counts of the five components of should equal the total WBC OR the sum of the percentages of the five components should equal 100% most recent WBC (White Blood Count) and Neutrophil Count along with the This test is sometimes also referred to as "Leukocyte Count" Absolute Neutrophil Count (ANC) The Absolute Neutrophil Count is the total number of Neutrophil cells in the total WBC count. The other GRANULOCYTE cells - Basophils and Eosinophils (see White Blood Cell Count above) - are not included in this number. Therefore - a test titled GRANULOCYTES - may not produce the desired result as it may include Basophils and Eosinophils. date of the most recent Clozapine prescription. Mental Health and Since the ANC is a portion of the WBC, it is only valid if it is traceable to the WBC sample drawn at the same date and time. ANC is a count and not a percentage - expressed as WBC with the total number of cells in a cubic centimeter of blood (cc) or cubic millimeter (cu mm or mm-3)or milliliters (mL). Again, this number may be divided by a thousand for brevity. The Absolute Neutrophil Count generally ranges from 1600 to 7700 / but it Pharmacy personnel responsible for prescribing and dispensing Clozapine can ever exceed the WBC count. This test can also be knows as polymorphonuclear cells or PMN's. Neutrophil Percent (Neut%) The Neutrophil Percent is the portion of the total WBC and that is composed of Neutrophil cells, excluding all agranulocytes and other granulocytes. This number is usually between 40% and 70%, but fluctuates should be made aware of this mail group and given the opportunity to join. for many medical reasons. Since it is reported as a portion of the total WBC, it is only valid if it is traceable to the WBC sample drawn at the same date and time. Neut% is commonly obtained by automatic testing equipment to represent the Neutrophil content in the blood. Neut% is a percentage and not a count - reported in the portion of the WBC. It can be converted into an Absolute Neutrophil Count in the Roll Up software. Originally, all Clozapine prescriptions were limited following formula (Neutrophil% / 100) X WBC count). The Neutrophil Percent generally ranges from 37% to 80% and should never exceed 90% of the total WBC count unless special medical conditions are present. SEGS & BANDS The WBC/Granulocyte/Neutrophil cell type can be further subdivided into NEW OPTION: two types. Mature neutrophils are called SEGS. Immature neutrophils called BANDS also circulate in the blood until they mature into SEGS. The sum of SEGS and BANDS is equal to the ANC of a give WBC count. SEGS and BANDS may be reported as a count, expressed in cc, mm-3, cu mm, or mL. A preceding K indicates the number has been divided by 1000. When SEGS and BANDS are reported as a number, the sum total of SEGS and BANDS equals the total Neutrophil Count (ANC) NOTE that the program needs an identifying test for both SEGS and BANDS. Reporting SEGS ========== without a parallel result from BANDS will result in an error condition that may prevent Pharmacy dispense. This number generally ranges between 1600 and 7700 / cu mm. It should never exceed 90% of the total WBC except under special circumstances. SEGS and BANDS may be reported as a PERCENTAGE of the total WBC. Therefore the total number of neutrophils (ANC) in a give WBC is = total WBC X (% Segs + % Bands). This calculation will be performed by the Pharmacy patch to obtain and ANC when necessary The Link Multiple Tests to Clozapine [CLOZAPINE MULTI TEST LINK] option The sum total of SEGS% and BANDS% can never exceed 100. DATA DICTIONARY: =============== CLOZAPINE PATIENT LIST File (#603.01), OVERRIDE DATE field (#3) - This field was added to allow the NCCC more control over the overrides performed at the site. CLOZAPINE PARAMETERS File (#603.03), LOCK DOWN field (#7) - This field must be assigned to the person or persons responsible for ensuring that was added to allow the NCCC to prevent the dispensing of any Clozapine prescription at a site. CLOZAPINE TESTS file (#603.04) - This file was added to allow the sites to select multiple tests for the WBC and Neutrophil count. Field Field Name Description 603.04,.01 NAME 0;1 FREE TEXT (Required) 603.04,1 TEST NAME 1;0 POINTER Multiple #603.41 the appropriate data is in place to validate Clozapine testing data. 603.41,.01 TEST NAME 0;1 POINTER TO LABORATORY TEST FILE (#60) 603.41,1 TEST TYPE 0;2 SET (Required) 'W' FOR WHITE BLOOD COUNT; 'A' FOR ABSOLUTE NEUTROPHIL COUNT; 'N' FOR NEUTROPHIL PERCENT; 'S' FOR SEGS %; 'B' FOR BANDS %; 'T' FOR BANDS ABSOLUTE; 'C' FOR SEGS ABSOLUTE; This is usually the Laboratory ADPAC. 603.41,2 REPORTING FORMAT 0;3 SET (Required) '0' FOR Units; '1' FOR K/units; '2' FOR Percentage; INSTALLATION TIME FRAME: ======================= VA DIRECTIVE 2001-023 REQUIRES INSTALLATION OF THIS PATCH WITHIN 30 DAYS FROM THE TIME OF INITIAL RELEASE. REQUESTING SITE: =============== National Clozapine Coordinating Center Test Site(s): ============ West LA Oklahoma Louisville This option will ask for the local laboratory name that equates to the Reference NOIS: ============== NA a ASSOCIATED E3Rs: =============== NA ASSOCIATED REMEDY TICKETS: following seven common test names ========================= NA ROUTINE SUMMARY: ================ The following routines are included in this patch. The second line of each of these routines now looks like: <tab> ;;5.01;MENTAL HEALTH;[patch list];Dec 30,1994 to 7 days. Renewals and refills were not allowed. In addition, the Checksum Values Routine Name Before Patch After Patch Patch List ------------ ------------ ----------- ---------- YSCLSERV 25083145 25564583 18,22,26,47, 61,69,74,90 YSCLSRV1 1605367 1606233 61,69,74,90 YSCLSRV2 16840829 24723007 69,90 YSCLSRV3 7345805 24872037 74,90 White Blood Cell Count YSCLTEST 12047382 12378003 18,22,26,47, 61,69,74,90 YSCLTST1 15450428 11839450 18,22,25,26, 47,61,69,74,90 YSCLTST2 11178871 32098862 18,22,26,47 61,69,74,90 YSCLTST3 15031797 25645207 18,22,25,26 47,61,69,74,90 Absolute Neutrophil Count List of preceding patches: 18,22,25,26,47,61,69,74 Sites should use CHECK^XTSUMBLD to verify checksums. Installation Instructions: ========================== NOTE: This KIDS install does not place any options out of service during the install and no existing user options are affected. The site should answer "NO" to all three questions. Neutrophil % Note: You may not receive all three prompts at your site. "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// NO" "Want KIDS to INHIBIT LOGONs during the install? YES// NO" "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO" Segs (Percent) 1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package in this message onto your system. 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 Bands (Percent) following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Users may remain on the system, installation may be done at any time except during the time scheduled for the Clozapine roll-up. Segs (Absolute Count) 4. No options need to be placed out of service. 5. Installation time is less than 2 minutes during off peak hours and less than 5 minutes during peak hours. 6. Installation of this patch requires no additional memory space. 7. From the 'Installation Menu' of the KIDS menu, run the option: Bands (Absolute Count) 'Install Package(s)' Select the package 'YS5.0190 and proceed with the install. You will also be asked to fill in the reporting format for each test. Clozapine reporting software automatically discontinued any patient if Most sites report WBC and Neutrophil results in K/unit format (K/cc or K/cu mm or K/mm-3 or K/mL). For example, WBC equals 5.1. However, some report results as discrete units. For example, WBC equals 5100. This field will allow the site to specify how results are reported. Entries that report in a percentage (such as Neutrophil %, Segs %, and Bands %) should use "Percentage". You may input as many names from the local laboratory definition for each of these tests as needed. Remember that the laboratory may have designed special names for specific test equipment, specific test locations, or the patient's prescription was over 28 days old. This was to prevent a specific test conditions, such as manual counts. In fact, if your facility has Clozapine patients with blood samples drawn and tested on a fee-basis at other CLIA (Clinical Laboratory Improvement Amendments) approved labs, it is extremely important for your Laboratory have tests to accept manual input of these tests. Therefore, you should involve laboratory managers or ADPAC (Automated Data Processing Application Coordinator) in selection of these names - both to define the test names currently in use and to create the patient from being issued medication on an expired prescription. The provision for manual entry of data. Please be certain every possible local laboratory name that represents these tests is entered that relates to each of the seven test names above. Pharmacy dispense will be prevented unless the program can find the needed test results under one of names you identify as an equivalent for each of the seven tests. Security Key: The YSCL AUTHORIZED Security Key is new with this patch. This key must be assigned to each provider authorized to dispense Clozapine. revised Clozapine protocol allows for a monthly prescription as well as EXAMPLE: CLOZAPINE MULTI TEST LINK [Link Multiple Tests to Clozapine] option Select OPTION NAME: CLOZ 1 CLOZAPINE MULTI TEST LINK Link Multiple Tests to Clozapine 2 CLOZAPINE DATA SERVER YSCLSERVER Clozapine Data Server 3 CLOZAPINE PHARMACY MANAGER PSOL MANAGER Clozapine Pharmacy Manager 4 CLOZAPINE TEST LINK YSCL TEST LINK Clozapine Test Link CHOOSE 1-4: 1 CLOZAPINE MULTI TEST LINK Link Multiple Tests to weekly and bi-weekly. The patient is now automatically discontinued if Clozapine Link Multiple Tests to Clozapine Currently linked Tests: NEUTROPHIL MATURITY, MEAN represents WHITE BLOOD COUNT SEGS represents BANDS % Enter the name of the test for Clozapine: WBC WBC Enter the type of the test for Clozapine: ? Enter a code from the list. the issue date for the most recent prescription is greater than 56 days Select one of the following: W WHITE BLOOD COUNT A ABSOLUTE NEUTROPHIL COUNT N NEUTROPHIL PERCENT S SEGS % B BANDS % T BANDS ABSOLUTE C SEGS ABSOLUTE 82 SEQ #76 DATE APPLIED: 2007-09-04 23:37:44 APPLIED BY: USER,ONE DESCRIPTION: This patch fixes the problem with undefined errors occurring when displaying incomplete Seclusion/Restraint (S/R) record Information via YSSR ENTRY and YSSR RELEASE options and removes leftover nodes from a previous restructuring of file 604. It also corrects a problem whereby GAF scores are not always seen in the Encounter dialogue of CPRS. 85 DATE APPLIED: 2008-02-03 22:17:17 APPLIED BY: USER,ONE DESCRIPTION: Further, the integration should make appropriate Mental Health assessment 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. Entries may be made through the provided Mental Health Authoring software. Direct entry through Fileman or the programmer prompt is prohibited. MH QUESTIONS file (#601.72) --------------------------- This file contains a listing of all questions for all Psychological tools available to clinicians outside Mental Health (e.g., depression and Interviews, Surveys and Tests. This allows usage of questions by multiple instruments. Each question can also linked to an entry in the MH INTRODUCTIONS file (#601.73), the MH CHOICES file (#601.75), the MH CHOICETYPES file (#601.751) and the Hint field (#8) in the MH QUESTIONS file (#601.72). MH INTRODUCTIONS file (#601.73) ------------------------------- This file contains the introductory information given at the beginning of each instrument or at the beginning of a new section of an instrument. The alcohol screening instruments should be made available to primary care introduction text motivates, gives instructions and sets the frame for the task the patient must complete. The same introduction text can be used by multiple instruments. MH RESPONSE TYPES file (#601.74) -------------------------------- This file contains what type of response from the user is required for a question. Response types contained in the file include MCHOICE (multiple choice), Integers, Strings, Dates, Memos and Currency. These entries are pointed to the MH QUESTIONS file (#601.72). clinicians)." MH CHOICES file (#601.75) ------------------------- This file contains the individual selections possible in a multiple choice question. Examples are Yes or No, True or False, 1. Abraham Lincoln, 2. George Washington, 3. George W. Bush or 4. Richard Nixon. For instruments first defined in the legacy system MH INSTRUMENT file (#601), a single character is specified for a multiple choice answer. If George Washington was the choice selected the legacy value would be 2. Choices are pointed to by the MH CHOICETYPES file (#601.751) which is a collection of choices. Choices are referenced in the MH ANSWERS file (#601.85) as a pointer to the full response. MH CHOICETYPES file (#601.751) ------------------------------ This file contains a collection of choices from MH CHOICES file (#601.75) and their display sequence. This allows sets of choices to be specified by the MH QUESTIONS file (#601.72). An example of an entry would be: 1. True 2. False 3. Undecided Each multiple choice question must specify a This revision of MHA creates a closer integration with CPRS, by placing the MHA ChoiceType. In this way a ChoiceType can be used by multiple instruments and multiple questions. MH INSTRUMENT CONTENT file (#601.76) ------------------------------------ This file specifies which entries from the MH QUESTIONS file (#601.72) are parts of which instrument in the MH TESTS AND SURVEYS file (#601.71). It is the "table of contents" for an interview, survey or test. Also specified are the sequence of questions and display attributes for the introductions, questions and choices. Display attributes can be bold, underlined and font GUI on the CPRS Tools Menu. Additionally, functionality was created to allow size for the introductions, questions and choices. MH BATTERIES file (#601.77) --------------------------- This file contains a list of interview, survey and test order sets. MH BATTERY CONTENTS file (#601.78) ---------------------------------- Ties the entries in the MH BATTERY CONTENTS file (#601.78) to the instruments in the MH TESTS AND SURVEYS file (#601.71). a site to place an individual instrument on the Tools menu, allowing widespread MH BATTERY USERS file (#601.781) -------------------------------- This file contains a list of all interviews, surveys and tests associated with an entry in the MH BATTERIES file (#601.77). The order of presentation of the interviews, surveys and tests within a battery and which battery belongs to which user in the NEW PERSON file (#200) is also specified. MH SKIPPED QUESTIONS file (#601.79) ----------------------------------- access to that specific instrument without having to issue the menu for the MHP This file specifies the questions to be skipped (by question IEN) if a rule is met for a given question in a given instrument. MH SECTIONS file (#601.81) -------------------------- This file specifies sections within an interview, survey and test. The first MH QUESTIONS file (#601.72) is specified along with captions (tab and overall). Display characteristics can also be set. MH RULES file (#601.82) to all clinicians. ----------------------- This file contains the rules used in administering an interview, survey or test. A rule is an action that is performed when a specified question is answered in a specified manner. An example of a rule would be to enter 'Not applicable' to the Question, "Are you pregnant?" if the patient has had a hysterectomy. Rules are complex logic based entries that enables the user to create complex scripts. MH INSTRUMENTRULES file (#601.83) --------------------------------- The Veterans Health Administration (VHA) Action Agenda for implementing the This file ties together an instrument in the MH TESTS AND SURVEYS file (#601.71), a question in the MH QUESTIONS file (#601.72) and a rule in the MH RULES file (#601.82). This allows a rule to be used in multiple instruments and for different questions. MH ADMINISTRATIONS file (#601.84) --------------------------------- The MH ADMINISTRATIONS file (#601.84) contains the data collected during the administration of a specified instrument from the MH TESTS AND SURVEYS file (#601.71) given to a patient at a specific date and time. For each Additional functionality that strengthens the tie to the patient's medical administration of a specified instrument from the MH TESTS AND SURVEYS file (#601.71) there will be an entry in this file. An entry in this file does not store the results of the instrument's administration but is an index to the instrument's administration. The entry indicates whether the instrument has been completed, who ordered the instrument, how many questions were answered and if the test has been electronically signed. MH ANSWERS file (#601.85) record is the creation of a progress note in CPRS when an instrument is ------------------------- When a patient answers a question, the results are stored in this file. An entry for each question answered, in each administration is stored. Each entry has an MH ADMINISTRATON ID field(#.01) of the MH ADMINISTRATION file (#601.84), a Question NUMBER field (#.01) of the MH QUESTIONS file (601.72) and the response. MH SCALEGROUPS file (#601.86) ----------------------------- ScaleGroups are collections of MH SCALES file (#601.87) that are logically completed through MHA. displayed together. Information needed to graph the scales are stored here. This includes the ordinate title, minimum and maximum values, graph increments and grid lines. All scales need to be associated with a MH SCALEGROUP to be displayed. MH SCALEGROUPS file (#601.86) and MH SCALES file (#601.87) allow multiple scoring possibilities within a single instrument. MH SCALES file (#601.87) ------------------------ A MH SCALE is one dimension of measurement in an instrument. An example may simply be a TOTAL as in a spelling test or multiple scales in a personality disorder instrument (depression, anxiety, thought disorder etc.). Each scale has at least one associated entry in the MH SCALEGROUP file (#601.86) and an entry in the MH SCORING KEYS file (#601.91). MH DISPLAY file (#601.88) ------------------------- This file contains the entries to set the Windows display attributes for the MH QUESTIONS file (#601.72), MH INTRODUCTIONS file (#601.73) and the Furthermore, MHA maintains and strengthens its ties to the Clinical Reminders MH RESPONSE TYPES file (#601.74). Windows display attributes include fonts, bolding, underline, colors and columns. MH CHOICEIDENTIFIERS file (#601.89) ----------------------------------- This file specifies the displayed numeric options that go along with a multiple choice item. Choice type identifiers can be numbered starting from one, from zero or remain unnumbered. MH SCORING KEYS file (#601.91) program, which allows for the presentation of specific instruments through ------------------------------ This file contains the scoring keys. The scoring keys are the "answer sheet" for the specified scale entry in the MH SCALES file (#601.87). When an answer the matches the Target value (ie, is correct) a specified value is added to the score. An example would be: if the question is "How much is 5 plus 3", the target value would be 8 and 10 points would be added to the total score (grade) in a ten question test to make a possible score of 1 MH RESULTS file(#601.92) ______________________________ reminder dialogs to all clinicians who resolve reminders. This file contains results of the scored output of completed instruments. MH REPORT file (#601.93) ------------------------------ This file contains the reporting format for a specified instrument. Input into this file must be entered only through the Mental Health Editor software. E3R#: None Associated NOIS: HD68109/BAC-0704-40498 ASI e-sign while editing HD68006/CLE-0504-40649 Interviewer cannot sign ASI in GUI HD67955/COA-0404-20702 Cannot sign ASI using MHA HD67709/BHS-0304-10794 Error - Null subscript at QTEP+6^YSASNAR HD67885/MAC-0204-61794 Mental Health Assistant - can't get to old tests HD67881/COA-0204-21407 MHA freezes during cross checks Clinical reminders has also developed a new patch, PXRM2.06 that allows HD67870/TNV-0204-30263 Co-signer ignored within ASI HD67841/OKL-0104-71087 MH Assistant accessible w/o keys Test Site(s): Upstate New York HCS, NY VA Pacific Island HCS, HI Northern California HCS, CA Puget Sound HSC, WA Atlanta VAMC, GA President's New Freedom Commission on Mental Health recommendations regarding reminders to work with the new MHA file structure. YS5.0185 should be Routine Summary Checksums shown are NEW Checksums The following routines are included in this patch. The second line of each of these routines now looks like: ;;5.01;MENTAL HEALTH;[Patch List];Dec 30, 1994 Checksums Routine Old New Patch List YS85POST 2059692 2059560 85 installed just before PXRM26. If YS5.0185 is installed without YS85PRE 813879 813879 85 YTAPI5 n/a 12417658 62,85 YTAUIRR n/a 14880327 37,85 YTDOMR n/a 26438095 31,85 YTKIL n/a 8970368 37,85 YTPCL n/a 7363737 66,85 YTQAPI 15475641 15475641 85 YTQAPI1 27189337 27189337 85 YTQAPI10 24613112 24613112 85 YTQAPI11 22157825 22157825 85 PXRM26, reminders will not be able to recognize MHA instruments YTQAPI12 20141561 20141561 85 YTQAPI13 19997427 19997427 85 YTQAPI14 6830812 6830812 85 YTQAPI15 25671527 25671527 85 YTQAPI16 13185422 13185422 85 YTQAPI2 21244483 21244483 85 YTQAPI3 23768089 23768089 85 YTQAPI4 28692651 28692651 85 YTQAPI5 23263110 23263110 85 YTQAPI6 5268725 5268725 85 administered after the file structure changes with YS5.0185. YTQAPI7 18902958 18902958 85 YTQAPI8 32413314 32771511 85 YTQAPI9 22741073 22741073 85 YTQHL7 31149138 31149138 85 YTQKIL n/a 5269849 85 YTQLIB 8410129 8410129 85 YTQPRT 25124936 25124936 85 YTQPXRM 4498627 4498627 85 YTQPXRM1 12743110 12743110 85 YTQPXRM2 14658221 14658221 85 YTQPXRM3 16585590 16585590 85 YTQPXRM4 21974840 21974840 85 YTQPXRM5 19969917 19969917 85 YTQPXRM6 16689405 17034666 85 YTQPXRM7 21919160 21919160 85 YTQQI001 16371213 16371213 85 YTQQI002 110963388 110963388 85 YTQQI003 107420027 107420027 85 YTQQI004 105189787 105189787 85 YTQQI005 104556455 104556455 85 Additionally, the files of the MHP have been restructured to initiate the YTQQI006 104012683 104012683 85 YTQQI007 103468973 103468973 85 YTQQI008 100582283 100582283 85 YTQQI009 99865202 99888363 85 YTQQI00A 99888363 99132958 85 YTQQI00B 101279645 101279645 85 YTQQI00C 102188832 102188832 85 YTQQI00D 98549063 98549063 85 YTQQI00E 96890307 96890307 85 YTQQI00F 97231174 97231174 85 migration toward re-engineering and placing MHA as a component of HealtheVet YTQQI00G 96151494 96151494 85 YTQQI00H 96468871 96468871 85 YTQQI00I 100432284 100432284 85 YTQQI00J 95575288 95575288 85 YTQQI00K 25448044 25448044 85 YTQTIU 11026585 11026585 85 List of preceding patches: 31, 37, 62, 66 Sites should use CHECK1^XTSUMBLD to verify checksums. Desktop when it is implemented. SOFTWARE RETRIEVAL: =================== The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_85.KID MHA Server Components ASCII YS50185_SETUP_1_0_3_1.exe Mental Health Assistant BINARY This file is the complete install for the Mental Health Assistant GUI Version 1.0.3.1, client. - YS_MHA.exe MHA 3 Executable - YS_MHA_SD_INSTALLGINA.exe Activate Secure Desktop Executable - dwlGina2.dll DLL used by Secure Desktop - YS_MHA_SD_UNINSTALLGINA.exe Deactivate Secure Desktop Executable - YS_MHA_VASD.exe Secure Desktop's main executable To better meet the needs of clinicians and patients in different programs, - YS_MHA.HLP Online help file for the ASI - ANSWER file folder Offline records that have not been uploaded - INSTRUMENT file folder MH Instruments for Offline administration YS50185_MHA 3_IG.PDF YS_MHA 3 Installation Guide BINARY YS50185_MHA 3_IG.DOC YS_MHA 3 Installation Guide BINARY YS50185_MHA 3_UM.PDF YS_MHA 3 User Manual BINARY YS50185_MHA 3_UM.DOC YS_MHA 3 User Manual BINARY the use of information technology to enhance the care of Mental Health patients particularly non-traditional settings, MHA can now run in a standalone mode to The software files are available on the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= administer instruments offline for later uploading to VistA. ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] Installation Instructions: ========================== 1. Use the 'LOAD A DISTRIBUTION' option on the PackMan menu. The Host File name is YS_501_85.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 install the Transport global. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global VistA Mental Health Assistant NEW features in MHA3: Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. During testing, it was noted that if a user had a reminder dialog open when the install took place, the reminder dialog would not load and work properly until CPRS was rebooted. 4. Installation will take less than five minutes. --------------------------------------------------- 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0185' 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 3 USER MANUAL in a 1. M: Completely re-organized VistA Mental Health database files to location that can be accessed by MHA users. 8. Please refer to the POST INSTALLATION INSTRUCTIONS section of the MENTAL HEALTH ASSISTANT VERSION 3 INSTALLATION GUIDE to install the MHA software. 9. The Secure Desktop feature in the MHA software is a security feature that locks down computers when patients are completing assessments directly in MHA. Because it locks down all other applications on the computer when activated, it must be loaded directly on the PC where it will be used. It should only be loaded simplify migration to HDR. on machines that will be used for patient administered assessments. It should not be pushed out to all machines on the network. More detailed information is found in the MHA VERSION 3 INSTALLATION GUIDE. 10. Place the option YS BROKER1 [YS BROKER1] on the Mental Health users secondary menu. 11. Enter appropriate members into the Mail Group YS MHA-MHNDB to the system, but installation should be done at off peak hours. 12. Place the MHA application on the CPRS Tools menu. 13. Create progress note title of "Mental Health Diagnostic Study Note" in the progress note hierarchy. This is needed for MHA to automatically pass a note to CPRS from instrument administrations completed within MHA. 14. A new entry is created in File 771, the HL7 Application Parameter File: YS MHA. It is exported as Inactive and should be set to 2. GUI: MHA3 must be invoked from the CPRS Tools menu, for interaction with Active after install. 15. A new entry is also created in File 870, the HL Logical Link file. This entry is YS MHAT. The logical link named YS MHAT is used by the HL7 package to send VistA ADT HL7 messages containing patient demographics, patient administration and patient answers. secondary menu. VistA and patient selection. Patient-selection is done entirely by states, "VHA should make the integration of MHA and HealtheVet Desktop (HeVD) interaction with CPRS. 3. GUI: MHA3 can run in standalone mode, but only for administering offline tests-which later must be uploaded to VistA. 4. GUI: MHA3 allows the CPRS Tools menu to invoke any number of single types of instruments, without the need to go directly to the MHA3 Main form. For instance, a CAGE menu item can be added to the Tools menu, which would invoke only a CAGE data entry form. an explicit goal and should provide the OI with sufficient resources to 5. GUI: Major functionality (GAF, ASI, Results, etc.) is now presented on individual forms, as opposed to as tabs on one main form. 6. GUI: MHA3 now provides a new Battery Wizard form to simplify creating batteries of instruments. 7. There is a new & improved SecureDesktop component that now uses stronger code to prevent hacking. 8. "Clerk entry" data-entry-mode form for psych tests has been removed. accomplish this goal in collaboration with the Mental Health Strategic 9. All completed administrations now automatically generate a progress note for review in CPRS. 10. All test scores are now saved in VistA, instead of calculated on-the-fly. 11. There is now a hospital Location associated with an administered instrument, for progress notes purposes. 12. The accompanying MHA3 help file is supplied only for describing the Healthcare Group (MHSHG) Informatics Section. The integration should functions of the ASI Manager forms. All other tests and interview have built-in help that is retrieved directly from the MHP when using the "Description" pop-up menu function in the Instrument Manager. 13. MHA3 now recreates a debug log file named "mha3_debug.log" for each MHA3 session. This file can be emailed to developers to assist in remote debugging. No patient-identifying data is collected in this file. This patch contains 23 new Mental Health files, 58 new Mental Health eliminate the need for Mental Health clinicians to change applications. Remote Procedures, 57 new Mental Health routines, 1 option, 2 Protocols, 1 HL7 application parameter and 1 HL logical link. 23 New Mental Health files to be released in this patch: -------------------------------------------------------- MH TESTS AND SURVEYS file (#601.71) ----------------------------------- This file defines the interviews, surveys and tests available in the Mental Health Assistant. Attributes of the instruments include authoring credits, 93 SEQ #78 DATE APPLIED: 2008-05-26 19:04:52 APPLIED BY: USER,ONE DESCRIPTION: This patch is intended to stop HL7 message generation. With the release of YS5.0185, HL7 errors are occurring because it was the intent of the development team to release that patch with messaging turned off. Unfortunately, this was not the case. 25 DATE APPLIED: 1997-01-22 00:00:00 APPLIED BY: USER,ONE 92 SEQ #79 DATE APPLIED: 2009-04-20 15:51:54 APPLIED BY: USER,ONE DESCRIPTION: A problem was found with one of the Clozapine API's during the testing of % Neutrophil ASSOCIATED TEST SITES: ====================== Alexandria, VA Charleston, WV Cleveland, OH Hudson Valley HCS Loma Linda, CA Computerized Patient Record System (CPRS V27) patch OR3243. The Palo Alto HCS Philadelphia, PA San Diego, CA Puget Sound HCS Tampa, FL REMEDY TICKET OVERIVEW: ======================= routines in this patch have been modified to correctly handle the Problem: -------- A problem was found with one of the Clozapine API's during the testing of Computerized Patient Record System (CPRS V27) patch OR3243. Solution: --------- Modified routines to correctly handle the situation. Routines: situation. --------- YSCLSERV, YSCLSRV2,YSCLSRV3, YSCLTST2, YSCLTST4 (new) INSTALLATION INSTRUCTIONS: ========================== The install time for this patch is less than 2 minutes. This patch can be installed with users on the system. Installation may be done at any time except during the time scheduled for the Clozapine roll-up. 1. Use the 'INSTALL/CHECK MESSAGE' option of the PackMan menu. This option will load the KIDS patch onto your system. 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. 3. On the 'Kernel Installation & Distribution System' Menu (KIDS), select the 'Installation' menu. 4. Use the 'Verify Checksum in Transport Global' option and verify that all routines have the correct checksums. 5. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Backup a Transport Global If you wish to preserve a copy of the routines exported in this ASSOCIATED REMEDY TICKET: patch prior to installation, you should use the 'Backup a Transport Global' option at this time. You may also compare the routines in your production account to the routines in the patch by using the 'Compare a Transport Global to Current System' option. 6. Use the 'Install Package(s)' option under the 'Installation' menu and select the package 'YS5.0192'. If prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//, choose 'NO'. ========================= If prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', choose 'NO'. HD195784 - Clozapine--Incorrect Value for OC calculation for ANC from 102 SEQ #80 DATE APPLIED: 2009-06-30 11:20:16 APPLIED BY: USER,SEVENTEEN DESCRIPTION: When multiple instruments are administered for the same encounter through CPRS GUI Clinical Reminders, only the results of the last instrument display in the Mental Health Assistant 3 GUI. This patch will correct this defect. 100 SEQ #81 DATE APPLIED: 2009-07-23 15:12:08 APPLIED BY: USER,SEVENTEEN DESCRIPTION: This patch removes some cross-references to field .53 (Progress Note Pointer) of file # 604 (Addiction Severity Index) that remained after the elimination of field .53 due to file restructuring. A post-init routine (YS501P99) is used to remove these cross-references. This patch also replaces the term MHA3 in some prompts with the phrase "MH administration/test". 98 DATE APPLIED: 2009-08-28 10:15:11 APPLIED BY: USER,SEVENTEEN DESCRIPTION: This patch corrects a defect in the Mental Health Assistant, Dynamic-Link not aware of this new storage arrangement while using CPRS and the MHA DLL. 2. The patch has now been loaded into a Transport global on your system. You now need to install the Transport global. On the KIDS menu, under the 'Installation' menu, use the following options: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 3. Users may remain on the system, but installation should be done at off peak hours. 4. Installation will take less than five minutes. 5. From the 'Installation Menu' of the KIDS menu, run the option 'Install Package(s)' Select the package 'YS5.0198' and proceed with install. 6. When prompted 'Want KIDS to INHIBIT LOGONs during the There are no changes to existing files and no changes from the user's install//', respond NO. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO 8. Download YS_501_98_Setup.exe in binary mode and run the YS_501_98_Setup. exe file to install Clinical Reminders MHA DLL. Please install the DLL in the default folders. The install program requires two dialogs of the user (to start and to signify finished). To avoid the user/install interaction, the file YS_MHA_A.dll can be copied directly to the perspective. C:\Programs Files\Vista\Common Files directory. This may be the more desirable way to push the dll to many workstations. This patch contains three new Remote Procedure Calls (RPCs): 1) YTQ GET SCRATCH: Returns data from the scratch file for the MHA DLL. Input: DFN, test CODE and GIU HANDLE. Library, (MHA DLL). The MHA DLL is called from Computerized Patient Records 2) YTQ KILL SCRATCH: Delete entries from the scratch file when a clinical reminder is saved. Input: DFN, test CODE and GIU HANDLE. 3) YTQ SET SCRATCH: API is designed to set data to a scratch file for the MHA DLL. Input: DFN, test CODE and GIU HANDLE. This patch introduces a new file called, MH CR SCRATCH FILE (#601.94). This file is used as temporary storage space for the interface between the MHA DLL and Clinical Reminders. System (CPRS) version 27N when a Clinical Reminder note is filled in by the A new routine, YTQPXRM8, is also included. Associated Remedy Tickets: ============================= HD0000000233026, HD0000000240965, HD0000000232542, HD0000000247135, HD0000000240965, HD0000000232427, and HD0000000233367. Clinical reminders: Completed mental health instruments are incorrectly identified as having missing answers. user. Associated E3R: =============== N/A Test Site List: =============== Loma Linda, CA - Large Palo Alto, CA - Integrated, Large Philadelphia, PA - Large This is a sub set of sites used by CPRS GUI v27.n (OR3296) and were determined by that team. (The CPRS test sites do not include any medium or small sites.) Routine Summary: ================ Checksums shown are NEW Checksums The following routine is included in this patch. The second line of this routine now looks like: The essential problem concerned the use a temporary file on the user's hard ;;5.01;MENTAL HEALTH;[Patch List];Dec 30, 1994 Checksums Routine Old New Patch List YTQPXRM8 n/a 15837966 98 Sites should use CHECK1^XTSUMBLD to verify checksums. SOFTWARE RETRIEVAL: =================== drive to store user's responses before saving to Veterans Health Information The following software and documentation files are exported as part of this patch: File Name Contents Retrieval Format --------- -------- ---------------- YS_501_98.KID MHA Clinical Reminders APIs ASCII YS_501_98_SETUP.EXE Installs DLL Binary YS_MHA_A.dll DLL support for Clinical Reminders Binary Systems and Technology Architecture (VistA). This patch provides the means The software files are available on the following OI Field Offices' ANONYMOUS.SOFTWARE directories. All sites are encouraged to use their FTP capability to obtain these files. Use the FTP address "download.vista.domain.ext" (without the quotes) to connect to the first available FTP server where the files are located. OI FIELD OFFICE FTP ADDRESS DIRECTORY =============== =========== ========= for that temporary information to be stored in VistA instead. The user is ALBANY ftp.fo-albany.domain.ext [ANONYMOUS.SOFTWARE] HINES ftp.fo-hines.domain.ext [ANONYMOUS.SOFTWARE] SALT LAKE ftp.fo-slc.domain.ext [ANONYMOUS.SOFTWARE] Installation Instructions: ========================== 1. Use the 'LOAD A DISTRIBUTION' option on the PackMan menu. The Host File name is YS_501_98.KID. Answer YES to the question: "Want to Continue with Load? YES//" 97 DATE APPLIED: 2010-07-08 16:09:33 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Please refer to YS5.0197 in the National Patch Module for a description of this patch. 96 DATE APPLIED: 2011-03-11 10:10:21 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Please refer to YS5.0196 in the National Patch Module for a description of this patch. 103 DATE APPLIED: 2012-04-19 10:22:05 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Please refer to YS5.01103 in the National Patch Module for a description of this patch. 106 SEQ #87 DATE APPLIED: 2012-08-29 11:13:07 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Please refer to YS5.01106 in the National Patch Module for a description of this patch. 60 DATE APPLIED: 2012-10-15 15:20:53 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Patch YS5.0160 addresses the retirement of Mental Health Options, Files, Data Dictionaries, patient data associated with these files, and associated templates determined by the Mental Health Strategic Healthcare Group to be obsolete and are no longer supported by Health Systems Design and Development. All the software, files, options, and templates were designated as obsolete in 2004 or earlier. A complete description of this patch can be found on Forum. 105 DATE APPLIED: 2013-10-03 15:25:16 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Please refer to YS5.01105 in the National Patch Module for a description of this patch. 24 DATE APPLIED: 1997-04-14 00:00:00 APPLIED BY: USER,ONE 107 SEQ #92 DATE APPLIED: 2014-09-02 12:53:55 APPLIED BY: USER,SEVENTEEN 113 SEQ #94 DATE APPLIED: 2015-05-27 15:54:39 APPLIED BY: USER,SEVENTEEN DESCRIPTION: This patch will address the following issues: 1. Two of the Barthel Index MH SCORING KEYS have incorrect score values. 2. Scoring issues with AAQ-2 116 DATE APPLIED: 2016-03-10 15:52:09 APPLIED BY: USER,FIFTYFOUR 119 DATE APPLIED: 2016-10-28 15:04:47 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: This patch will modify some of the prompts in the PCL-5 instrument to be scores in Clinical Reminders and Health Summary. A filter is added that File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the following OI Field Offices: Albany: fo-albany.domain.ext Hines: fo-hines.domain.ext Salt Lake City: fo-slc.domain.ext The Install Guide is also available on the above servers. It is available as .PDF format. This file should be downloaded in BINARY format. will prevent selection of these instruments in Clinical Reminders and File Name: Description: Protocol ========== ============ ========= YS_PCL5_UPDATE.PDF PCL-5 Update Install Guide BINARY YS_PCL5_UPDATE.KID PCL-5 Update Host File ASCII Documentation can also be found on the VA Software Documentation Library at: http://www4.domain.ext/vdl/ Installation: Health Summary until a VistA based scoring algorithm can be deployed. ============= This patch can be loaded with users on the system. Installation will take five minutes. Refer to the Install Guide, YS_PCL5_UPDATE.PDF, for complete details. 1. Use the "Load a Distribution" option on the KIDS installation menu. When prompted to enter a host file, type in YS_PCL5_UPDATE.KID 2. On the KIDS menu under the 'INSTALLATION' menu, use the following options, as desired: Print Transport Global Compare Transport Global to Current System Verify checksums in Transport Global Backup a Transport Global 3. On the KIDS menu under the 'INSTALLATION' menu, use the following option to install the patch: Install Package(s) When prompted for INSTALL NAME, use YS_PCL5_UPDATE 4. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' enter NO. 5. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' enter NO. 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' enter NO. Patch Components: 7. If prompted 'Delay Install (Minutes): (0 - 60): 0//' respond 0. Post-Installation Instructions: ------------------------------- N/A ----------------- Files & Fields Associated: consistent with the current wording of PCL-5. The PCL-5 instrument will File Name (Number) Field Name (Number) New/Mod/Del ------------------ ------------------- --- MH TESTS AND SURVEYS (#601.71) TAG FOR SCORING (#91) NEW MH TESTS AND SURVEYS (#601.71) ROUTINE FOR SCORING (#92) NEW Forms Associated: N/A Mail Groups Associated: N/A be activated so that it is available for selection in the Mental Health Options Associated: N/A Protocols Associated: N/A Security Keys Associated: N/A Templates Associated: N/A New Service Requests (NSRs): ---------------------------- Assistant (MHA). Also, possible scoring errors for the following NSR #20150509: Posttraumatic Stress Disorder (PTSD) Checklist 5 (PCL-5) and Mental Health Assistant Stabilization (MHAS) Patient Safety Issues (PSIs): ----------------------------- PSPO 2497: Mental health instruments that use a complex scoring algorithm display an incorrect score when used in Health Summary and Clinical Reminders. Remedy Ticket(s) & Overview: instruments have been corrected: MMCI3, MMPI-2-RF, MOCA, MOCA Alt 1, and ---------------------------- HD0000000391317 - Error Evaluating Clinical Reminder - local GAF reminder Problem: In some instances, a utility in the YTQPXRM2 routine errors out when evaluating a GAF clinical reminder because the time portion of the date/time lookup value has trailing zeros. Solution: The patch modifies the routine to strip off the trailing zeros . HD0000000807935 - Mental Health - MH Tests (excluding ASI) Problem: The scoring criteria for the MCMI3 instrument changed since it was first released. MOCA Alt 2. NEOPI is inactivated. Solution: The scoring criteria are updated. HD0000000922629 - Mental Health - Mental Health Assistant: scoring error MoCA, MoCA Alt1, and MoCA Alt2 HD0000000938421 - Mental Health - Mental Health Assistant HD0000000964555 - MOCA calculation is off Problem: There is an error in the way three instruments, MOCA, MOCA ALT1 and MOCA ALT 2 are scored. Solution: The scoring error is fixed for all three instruments . HD0000000939794 - Mental Health - Mental Health Assistant Problem: There is a scoring error in the BAI instrument. There is a MH SCALES (#601.87) file entry associated with this instrument that should not be. Solution: That entry is no longer associated with the instrument. INC000000616128 - Mental Health - Error Generating Report Problem: There is an error when generating a report for an administration that doesn't exist. Solution: Quit before generating the report if an instrument Additionally, the patch provides an interim solution for the problem administration is not found. Test Sites: ---------- TBD Software and Documentation Retrieval Instructions: ---------------------------------------------------- This patch is being distributed as a host file. The name of the host file is YS_PCL5_UPDATE.KID. This file should be downloaded in ASCII where instruments with complex scoring algorithms display inaccurate format. The preferred method is to retrieve files from: download.vista.domain.ext. This transmits the files from the first available server. Sites may also elect to retrieve files directly from a specific server. Sites may retrieve the software and install guide directly using Secure 131 SEQ #98 DATE APPLIED: 2017-10-05 14:04:55 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: PATCH YS5.01131 ADDRESSES THE FOLLOWING: 1. R14616270FY17 - CIWA question number 11 for headache not totaling. 128 DATE APPLIED: 2017-11-27 13:55:26 APPLIED BY: USER,FIFTYFOUR 121 SEQ #100 DATE APPLIED: 2018-06-01 13:47:59 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build ASSIST is renamed to ASSIST-WHOv3. INDEX OF ASL is renamed to KATZ-ADL-18pt. PHQ9 has an updated report. WAI-SR has corrections to scoring. makes the following changes for Mental Health Assistant. The following new tests are added: ASSIST-NIDA, BRS, CCSA-DSM5, CEMI, CIWA-AR-, CSI, CSI-4, CSI PARTNER VERSION, CSI-4 PARTNER VERSION, GAI, ISI, KTAZ-ADL-6pt, PSOCQ, PSS, RLS, SMEQ, SNQ, STOP. The following tests are retired: CIWA-AR, AUIR, CESD5, DOM80, DOMG, ERS, HLOC, IEQ, RLOC, SAI, SDES, SMAST, VALD, WAS. 129 SEQ #101 DATE APPLIED: 2018-06-01 13:51:41 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build to XE8. The following tests were retired: AUIR, CESD5, DOM80, DOMG, ERS, HLOC, IEQ, RLOC, SAI, SDES, SMAST, VALD, WAS. Data validation was implemented for the Instrument Date of Administration to prevent dates more than 1 year in the past from being entered. The PCL-5 was modified so that it can be used on the Special Results tab in the Instrument Results module. makes the following changes for the Mental Health Assistant (MHA). Several deficiencies and Remedy tickets were addressed. The Two Factor Authentication is implemented. The Global Assessment of Functioning Manager (GAF) functionality is removed. Modifications were made to the Delphi code to migrate MHA from Delphi 7 117 SEQ #102 DATE APPLIED: 2018-07-06 12:41:55 APPLIED BY: USER,FIFTYFOUR 134 SEQ #103 DATE APPLIED: 2018-09-07 12:17:20 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build makes the following changes for Mental Health Assistant. 26 SEQ #27 DATE APPLIED: 1997-05-28 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: Mental Health Treatment Planner 136 SEQ #104 DATE APPLIED: 2018-12-06 16:03:35 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build MHRM makes the following changes for Mental Health Assistant. This patch contains 6 new instruments: BPRS-A PSS-3 2ND PCL-5 Weekly WEMWBS HSI 123 SEQ #105 DATE APPLIED: 2019-03-05 14:46:42 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build MHA now stores scale scores for all instruments in the MH RESULTS file. Additionally, should an instrument need to be rescored for any reason, there has been functionality added to maintain an audit for previous scores. The BSI was renamed to the BSS. Additional modifications were made and can be found in the patch. The responses for Question 7 in the VR-12 were corrected. makes the following changes for Mental Health Assistant (MHA). The Progress Note was modified to remove extra linefeeds when multiple instruments were administered. The "skip" question logic in the Administer one item at a time for an instrument was corrected. MHA is moving the scoring logic for instruments from the YS_MHA_AUX.dll to the M server side. This patch converts the following instruments from scoring in the DLL to M: AUDC, BAI, BAM-C, BAM-R, BASIS-24, BDI2, BHS, BSS (formerly BSI), CDR, CEMI, FAST, ISMI, MINICOG, MMPI-2-RF, NEOP-I-3, PC PTSD, PHQ-2, POQ, QOLI, STMS, VR-12, WHODAS 2, and WHYMPI. 137 SEQ #106 DATE APPLIED: 2019-04-02 16:45:51 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: See the patch description for more detailed information. This build makes changes to the Mental Health Assistant. 143 SEQ #107 DATE APPLIED: 2019-05-01 14:59:19 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: The patch addresses one (1) issues: 1. When using the SCL9R instrument in the Mental Health Assistant, only four (4) answer choices are offered when there should be five (5). 148 SEQ #108 DATE APPLIED: 2019-05-01 15:54:34 APPLIED BY: USER,FIFTYFOUR DESCRIPTION: This patch will rebuild the "AC" indexes in the MH RESULTS (601.92) file and in the MH ANSWERS (601.85) file. 147 SEQ #109 DATE APPLIED: 2019-07-08 16:57:09 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: See the patch description for more detailed information. This build makes changes to the Mental Health Assistant. 138 SEQ #111 DATE APPLIED: 2019-07-22 17:15:06 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: This patch will add 8 new instruments. 139 SEQ #113 DATE APPLIED: 2019-09-12 12:08:29 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: This patch will address the following issues 8 new instruments. 122 DATE APPLIED: 2019-09-30 10:36:46 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: MENTAL HEALTH NCC PROJECT 5.01 151 SEQ #116 DATE APPLIED: 2019-10-16 16:26:57 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: This patch will add 8 new instruments. 30 DATE APPLIED: 1997-09-22 00:00:00 APPLIED BY: USER,ONE DESCRIPTION: This patch addresses issues with the Addiction Severity Index software. 142 SEQ #117 DATE APPLIED: 2019-11-01 16:25:18 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: This patch updates the following Mental Health instruments: T-Score now calculates correctly for the EID scale. Score for PSYC-r is now correct when question 216 is true. QOLI A scoring error introduced by YS5.01139 has been corrected. If an instrument with many scales preceded and instrument with a few scales during a session, some additional scales were carried over to the instrument with fewer scales. This was visible in the Health Summary component and TIU objects. It also sometimes affected the display in the Special Reports Wizard. This is corrected with this patch. Additionally, the patch checks previous administrations to make sure each administration has only the correct scales associated. Additional record locks were added to reduce the likelihood of errors when generating a report for a legacy instrument. AIMS The disclaimer is no longer added to the progress note text. C-SSRS A Key Indicator is now added if Question 3 response is 'Yes'. MMPI-2-RF 130 SEQ #119 DATE APPLIED: 2020-01-22 15:44:04 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: Add assignment capablity to MHA and calls for MHA Web app that allows patient entry. 150 SEQ #123 DATE APPLIED: 2020-04-02 17:33:33 APPLIED BY: USER,SEVENTY DESCRIPTION: This patch will address the following issues 11 new instruments: SHORT INVENTORY OF PROBLEMS - AD (SIP-AD-30) SHORT INVENTORY OF PROBLEMS - AD (SIP-AD-Start) Short Warwick-Edinburgh Mental Well-being Scale(SWEMWBS) Ascertain Dementia 8 -item Informant Questionnair(AD8) Adverse Childhood Experiences (ACE) Borderline Symptom List 23 - (BSL-23) Composite Morningness Questionnaire (CMQ) Eating Attitudes Test- 26 Item (EAT-26) The Florida Obsessive Compulsive Inventory (FOCI Mental Health Recovery Measure-10 (MHRM-10) Nursing Delirium Screening Scale - (NuDESC) 154 DATE APPLIED: 2020-04-10 15:41:18 APPLIED BY: USER,SEVENTY DESCRIPTION: The MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build is a warranty Risk Evaluation and Mitigation Strategy (REMS), which is mandated by the A server command being sent from Forum to the YSCLSERVER MailMan server at the sites wasn't being handled correctly by the server routines. Resolution: ----------- Routine YSCLSERV was modified to put the correct DISPENSE FREQUENCY (field #2) in the CLOZAPINE PATIENT LIST file (#603.01); this routine was also modified for defect 1132342 (see below). Routine YSCLTST5 was changed to remove code that was overwriting data written in ^XTMP. Food and Drug Administration (FDA) for tracking clozapine patients. 4. Nightly transmission missing required data. Defect 1132355 Problem: -------- The YSCL DAILY TRANSMISSION option may not have sent all the necessary data to the Forum Mail Group. Resolution: ----------- Routines YSCLSERV, YSCLSRV1, YSCLSRV2, and YSCLSRV3 were modified to ensure that all the needed data are returned. The call to the MailMan Application Programmer Interface (API) was updated. 5. Discontinue Message not sent Defect 1132342 Problem: -------- Patients are discontinued without a message being sent to the NCCC The multi-build contains the Mental Health patch YS5.01154 and the alerting them that a patient was discontinued. Resolution: ----------- Routine YSCLSERV was modified to ensure that the discontinue message is sent); this routine was also modified for defect 1132355 (see above). 6. The option Daily Clozapine Transmission [YSCL DAILY TRANSMISSION] was not always sending demographic data to the RUCL files in Hines. Defect 1155009. Outpatient Pharmacy patch PSO7.0574. The list of defects and their Problem: -------- The Daily Clozapine Transmission option was not sending demographic data to the CLOZARIL REPORTS file (#1900) in the FOURWORD server that resides in the Hines data center. Resolution: ----------- This is not directly testable at sites. resolution is below. Data are now sent to the FOURWORD server which contains the legacy Clozapine registration database. Routines YSCLDIS, YSCLSERV, and YSCLTST5 were modified. Routine YSCLTST9 was created. * * * * * * Test Sites: ---------- - West Los Angeles VAMC (691) - N. Florida /S. Georgia VAMC (573) - VA Connecticut Healthcare System - West Haven Division (689) There are no documentation updates associated with this patch. Patch Installation: Pre/Post Installation Overview: ------------------------------- Defect Tracking System Ticket(s) & Overview: There are no tasks to be performed before the installation of this multi-build. Note that the routines should be backed up to a PackMan message before installing the build. Pre-Installation Instructions: ------------------------------ This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. It should not be installed when the YSCL DAILY TRANSMISION -------------------------------------------- option is running. If unsure when that is check the OPTION SCHEDULING file (#19.2) using FileMan: Select VA FileMan Option: Inquire to File Entries Output from what File: OPTION SCHEDULING// (17 entries) Select OPTION SCHEDULING NAME: YSCL DAILY TRANSMISSION Another one: Standard Captioned Output? Yes// (Yes) Include COMPUTED fields: (N/Y/R/B): NO// - No record number (IEN), no Computed Fields NAME: YSCL DAILY TRANSMISSION QUEUED TO RUN AT WHAT TIME: OCT 05, 2019@01:30 RESCHEDULING FREQUENCY: 1D TASK ID: 2577736 Installation Instructions: -------------------------- 1. The KIDS multi-build can be found in the VistA software repository at download.vista.domain.ext release for the National Clozapine Registry (NCR) software. This release * * * * * * ANON$:[ANONYMOUS.ANONYMOUS]MH_NCC_WARRANTY_5_01_T06.KID Place the KIDS multi-build file into a local directory and use the KIDS option Load a Distribution option to load it into the transport global. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter: MENTAL HEALTH NCC WARRANTY RELEASE 5.01 a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. b. Compare Transport Global to Current System - This option will (allow you to view all changes that will be made when this patch is installed. It compares all components of this patch routines, DDs, templates, etc.). Patch YS5.01154 contains the following fixes: c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install (MENTAL HEALTH NCC WARRANTY RELEASE 5.01). 5. Accept the default when prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' 6. Accept the default when prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' 7. Accept the default when prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' 8. If prompted 'Delay Install (Minutes): (0 - 60): 0// enter 0 (zero). Backout /Rollback Strategy: --------------------------- Backout will be done only with the concurrence and participation of 1. Patients who are actively receiving clozapine (e.g. had a prescription development team and appropriate VA site/region personnel. The decision to backout the software will be a joint decision between development team, VA site and regional personnel, and other appropriate VA personnel. Rollback applies to data only and is not applicable to this multi-build. Prior to installing the KIDS multi-build, the site/region should have saved a backup of the routines in a PackMan message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up routines can be loaded with last month) are discontinued. the "Xtract PackMan" function at the Message Action prompt. The PackMan function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. Validation of Backout Procedure ------------------------------- The backout Procedure can be verified by printing the first 2 lines of the PSO* and YS* Routines contained in the MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the old routines listed in the multi-build patch Defect 1132329 have been restored, the first two lines of the Routines will no longer contain the designation of patch 574 (for Outpatient Pharmacy PSO* routines) and patch 154 (for Mental Health YS* routines) in the patch list section on line 2 of the routines. Problem: -------- will fix the defects and incidents reported by the sites to the The YSCL DAILY TRANSMISSION option checks for clozapine patients who should be discontinued. The logic was erroneously discontinuing patients. Resolution: ----------- The YSCLDIS and YSCLTST5 routines were modified to correct issues with clozapine patients being discontinued erroneously when the YSCL DAILY TRANSMISSION runs at the site. The fixes also ensure that information about patients that were discontinued is stored in ^XTMP("YSCLDIS") as a log. A discontinued patient is one who has the CLOZAPINE STATUS field developers of the National Clozapine Coordination (NCC) Project. The (#54) in the PHARMACY PATIENT FILE (#55) set to "DISCONTINUED". The YSCL154P pre-init routine was created to ensure that the YSCL DAILY TRANSMISSION option is scheduled in the OPTION SCHEDULING FILE (#19.2). If the option is scheduled the installer will see a message like this: YSCL DAILY TRANSMISSION information in file #19.2: QUEUED TO RUN AT WHAT TIME: OCT 02, 2019@01:30 RESCHEDULING FREQUENCY: 1D TASK ID: 2576362 project is also referred to as the Clozapine Modernization (ClozMod) No issues found for the YSCL DAILY TRANSMISSION option. If the YSCL154P routine detects an issue the installer will see messages that look like the two examples shown below. If a message like this is shown then the site will need to take corrective action to schedule the YSCL DAILY TRANSMISSION using TaskMan options. If there are any questions about how to schedule the option please contact the ClozMod team. Error message example 1 from the YSCL154P routine: Project. YSCL DAILY TRANSMISSION information in file #19.2: * WARNING * The option is NOT scheduled. The YSCL DAILY TRANSMISSION Option should be scheduled to be run daily, in the early AM hours with no DEVICE. Error message example 2 from the YSCL154P routine: YSCL DAILY TRANSMISSION information in file #19.2: QUEUED TO RUN AT WHAT TIME: * Time not found! * RESCHEDULING FREQUENCY: 1D TASK ID: * Task not found! * The YSCL DAILY TRANSMISSION Option should be scheduled to be run daily, in the early AM hours with no DEVICE. Note: There are routines in the PSO7.0574 patch that also address this defect. The NCR is maintained by the National Clozapine Coordinating Center 2. Registered clozapine patients who have not received a clozapine prescription in more than 56 days may not be discontinued. Defect 1132404 Problem: -------- A patient who had not received Clozapine for more than 56 days did not have their status changed to DSCONTINUED during the nightly scan. (NCCC). The NCCC is responsible for VA's compliance with the clozapine Resolution: ----------- Logic in routine YSCLDIS was changed to fix the problem. 3. Newly Registered clozapine patients were only getting a dispense frequency of WEEKLY in file #603.01. Defect 1132352 Problem: -------- 132 SEQ #125 DATE APPLIED: 2020-06-01 15:16:21 APPLIED BY: USER,SEVENTY DESCRIPTION: The Mobile Application Phase 2 (MAP2) Mental Health Checkup project requires access to certain Remote Procedure Calls (RPCs) that are part of the MENTAL HEALTH package. The purpose of this patch is to publish those RPCs allowing access for use by Mental Health Checkup by setting the field APP PROXY ALLOWED field (#.11) of the REMOTE PROCEDURE file (#8994) to YES. 165 SEQ #126 DATE APPLIED: 2020-07-13 17:22:45 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: This patch addresses the following issue: 1. When adding new entries to the CLOZAPINE PATIENT LIST (#603.01) file patient lookups running in the background can return erroneous results, which in turn leads to incorrect entries in the file. This issue is being tracked in SNOW on INC10558263 and is also being tracked on Rational Defect #1263669. 166 DATE APPLIED: 2020-09-23 15:25:17 APPLIED BY: USER,SIXTYFIVE DESCRIPTION: The Health Integration & Modernization (HI&M) CLOZAPINE NCCC OVRD patient's prescription limited to 4 days. Problem: -------- A Patient initially receives a 4-day emergency authorization, and later an NCCC Authorization and an NCCC Override Date. While the NCCC Override Date is still active, the Day Supply (for Outpatient Pharmacy) or Order Duration (for Inpatient Medications) continues to be limited to 4 days. Inpatient Medications Order Duration is defined as the number of days between the order's Start Date/Time and Stop Date/Time. The multi-build contains the Mental Health patch YS5.01166 and the Resolution: ----------- If a NCCC Authorized National Override Date is in effect following an initial local override, the system shall process an active clozapine patient's clozapine prescription under national override processes allowing the patient to be provided with the approved quantity associated with their individual dispensing frequency from the DISPENSE FREQUENCY field (#2) in the CLOZAPINE PATIENT LIST file (#603.01). The approved quantity is determined by the order's Days Supply for Outpatient Pharmacy Outpatient Pharmacy patch PSO7.0612. The list of defects and their orders, and the Order Duration (days between Start Date/Time and Stop Date/Time) for Inpatient Medications orders. Technical Resolution: --------------------- The correct patient dispense frequency is now retrieved by changing CL1^YSCLTST4 to find the dispense frequency associated with the patient's registered clozapine authorization number. resolution is below. 4. Requirement 2 Defect 2 - Patient with NCCC Authorization receives a Special Condition Fill, and later an NCCC Authorization and Override Date, but day supply limited to 4. INC9951972: COVID-19 VistA PSO defect - Clozapine National Override patient's prescription limited to 4 days Problem: -------- A patient with an initial NCCC Authorization receives a Special Condition override, followed by an NCCC override, is limited to a Day Supply (Outpatient Pharmacy orders) or an Order Duration (Inpatient Medications orders) limited to 4 for clozapine orders. The NCCC national clozapine override and the patient's regular clozapine dispense frequency are ignored. Resolution: ----------- A patient with an initial NCCC clozapine authorization receiving a Special Condition override, followed by an NCCC override, shall be This patch is also being released with informational patch PSJ5403 that processed under national override rules allowing the patient to be provided with the approved quantity associated with their individual dispensing frequency from the DISPENSE FREQUENCY field (#2) in the CLOZAPINE PATIENT LIST file (#603.01). The approved quantity is reflected in the order's Days Supply for Outpatient Pharmacy orders, and the Order Duration (days between Start Date/Time and Stop Date/Time) for Inpatient Medications orders. Technical Resolution: --------------------- documents changes to Inpatient Medications' processing of clozapine Routine OVRRID^YSCLTST2 changed to kill ^XTMP("PSJ4D-"_DFN) and ^XTMP("PSO4D-"_DFN) after an NCCC override is successfully filed. This removes a patient's local clozapine override information when it is replaced by an NCCC override. Patch Components ================ Files & Fields Associated: overrides that are a result of the defect fixes in PSO7.0612 and File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ---------------------- -------------------- CLOZAPINE PATIENT CLOZAPINE REGISTRATION Modified* (Mumps X-Ref) LIST (#603.01) NUMBER (#.01) CLOZAPINE PATIEN T(#1) Modified* (Mumps X-Ref) New style "AC" mumps cross reference added to these two fields in file 603.01. New routine TRGR^PSOCLADD(DFN,PSOCLZNW) is invoked when a new entry is filed. New Integration Control Registration (ICR) #7175 has been created to document the new cross application interaction. YS5.01166. Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A COVID-19 multi-build is an emergency patch to the National Clozapine Security Keys Associated: Security Key Name New/Modified/Deleted ---------------------- -------------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Defect Tracking System Ticket(s) & Overview: * * * * * Test Sites: ---------- New Jersey Health Care System (561) VA Connecticut Health Care System (689) Boise VA Medication Center (531) -------------------------------------------- Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released as a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/PSO_YS_CLOZ_COVID.KID Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ * Defect and Enhancement ID's listed below are internal identifiers and ------------------------------------------------------------------------- Title File Name ------------------------------------------------------------------------- MHA Security Technical YS_MHS_TM.pdf Manual/Guide Deployment Installation Back-Out pso_7_p612_ys_501_p166_dibr.docx and Rollback Guide - HI&M pso_7_p612_ys_501_p166_dibr.pdf Clozapine Overrides do not map to any external system. Release Notes - HI&M Clozapine pso_7_p612_ys_501_p166_rn.docx Overrides pso_7_p612_ys_501_p166_rn.pdf Patch Installation: Pre/Post Installation Overview: ------------------------------- There are no tasks to be performed before the installation of this multi-build. Note that the routines should be backed up to a PackMan message before installing the build. Pre-Installation Instructions: ------------------------------ This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. It should not be installed when the YSCL DAILY Patch YS5.01166 contains the following changes: TRANSMISION option is running. If unsure when that is check the OPTION SCHEDULING file (#19.2) using FileMan: Select VA FileMan Option: Inquire to File Entries Output from what File: OPTION SCHEDULING// (17 entries) Select OPTION SCHEDULING NAME: YSCL DAILY TRANSMISSION Another one: Standard Captioned Output? Yes// (Yes) Include COMPUTED fields: (N/Y/R/B): NO// - No record number (IEN), no Computed Fields NAME: YSCL DAILY TRANSMISSION QUEUED TO RUN AT WHAT TIME: OCT 05, 2019@01:30 RESCHEDULING FREQUENCY: 1D TASK ID: 2577736 Installation Instructions: -------------------------- 1. Place the KIDS multi-build file PSO_YS_CLOZ_COVID.KID into a local directory and use the KIDS option Load a Distribution option to load it into the transport global. 1. Requirement 1 Enhancement - Automate the Pharmacy 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter: PSO7.0612 a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. Registration of NCCC Clozapine Authorizations. b. Compare Transport Global to Current System - This option will (allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option allows you to ensure the integrity of the routines that are in the transport global. Registry (NCR) software to correct defects to Clozapine National 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install (PSO7612). 5. Accept the default when prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' 6. Accept the default when prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' 7. Accept the default when prompted 'Want to DISABLE Scheduled Options, Problem: Menu Options, and Protocols? NO//' 8. If prompted 'Delay Install (Minutes): (0 - 60): 0// enter 0 (zero). Backout/Rollback Strategy: --------------------------- Backout will be done only with the concurrence and participation of development team and appropriate VA site/region personnel. The decision to backout the software will be a joint decision between development team, VA site and regional personnel, and other appropriate VA personnel. -------- Rollback applies to data only and is not applicable to this multi-build. Prior to installing the KIDS multi-build, the site/region should have saved a backup of the routines in a PackMan message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. Currently, national clozapine authorization numbers are sent by the The new "AC" mumps cross reference for the CLOZAPINE PATIENT LIST file (#603.01) must be manually deleted via FileMan prior to restoring the backed up routines. The steps to delete the cross reference: 1. Access VA FileMan option Cross-Reference A Field via the VA FileMan Utility Functions [DIUTILITY] menu. 2. At the prompt, "What type of cross-reference (Traditional or New)?" enter NEW. 3. At the prompt, "Modify What File:" enter 603.01. National Clozapine Coordinating Center (NCCC) and filed into the 4. The new "AC" cross reference should be selected by default. 5. At the prompt "Choose E (Edit)/D (Delete)/C (Create):" enter DELETE. 6. At the prompt "Are you sure you want to delete the index definition? NO// YES" Example deletion of new "AC" index if backout is required: VA FileMan 22.2 Select OPTION: UTILITY FUNCTIONS CLOZAPINE PATIENT LIST file (#603.01). Later, a pharmacy user Select UTILITY OPTION: CROSS-REFERENCE A FIELD OR FILE What type of cross-reference (Traditional or New)? Traditional// NEW Modify what File: REMOTE PROCEDURE// 603.01 CLOZAPINE PATIENT LIST (74 entries) Current Indexes on file #603.01: 1589 'AC' index Choose E (Edit)/D (Delete)/C (Create): DELETE Which Index do you wish to delete? 1589// AC Are you sure you want to delete the index definition? NO// YES must manually execute Vista option Register Clozapine Patient [PSOL Index definition deleted. Validation of Backout Procedure ------------------------------- The backout Procedure can be verified by printing the first 2 lines of the PSO* routines contained in the PSO7612 build using the option REGISTER PATIENT] (for new patients), or Edit Data for a Patient in the First Line Routine Print [XU FIRST LINE PRINT]. Once the old routines listed in the multi-build patch have been restored, the first two lines of the Routines will no longer contain the designation of patch 612 in the patch list section on line 2 of the routines. The backout of the new "AC" cross reference on the CLOZAPINE PATIENT LIST file (#603.01) can be verified by repeating the backout steps and verifying that there is no longer a selectable "AC" cross reference to delete. Clozapine Program PSOL [EDIT] (for previously registered patients). Clozapine Coordinating Center (NCCC) Override functionality. Resolution: ---------- Automate the clozapine registration process by automatically updating the patient's clozapine registration number and status when a new National Clozapine number is received from the NCCC, Technical Resolution: --------------------- A new Pharmacy API has been created that accepts Patient DFN and NCCC Clozapine Authorization number as input and files the number into the CLOZAPINE REGISTRATION NUMBER field (#53) in the PHARAMCY PATIENT file (#55), and updates the CLOZAPINE STATUS field (#54) to 'A' for Active. This API is executed when a new clozapine authorization is filed into the CLOZAPINE PATIENT LIST (#603.01) file via a mumps action cross reference. 2. Requirement 1 Defect 2 - National Override Date update fails for patient with more than one clozapine authorization. The NCR is maintained by the NCCC. The NCCC is responsible for VA's Problem: ----------- When a National Override is requested for a patient that has more than one entry in 603.01, the YSCL Server code performs a defective lookup into 603.01. If the patient has more than one entry in 603.01, the server code retrieves the older clozapine number and compares it to the clozapine number in the incoming override. Since the override is usually (if not always) performed on the most recent clozapine number, the override fails and generates the error message, "SSN (PATIENT,NAME) has multiple Clozapine Numbers at nnn". compliance with the clozapine Risk Evaluation and Mitigation Strategy Resolution: ----------- The Mental Health Clozapine Server's NCCC Override patient lookup into file 603.01 shall be corrected when processing an incoming NCCC Override so that it looks in file 603.01 for the specific patient and NCCC Clozapine number from the incoming message. Only the file 603.01 entry matching the incoming NCCC clozapine number and patient shall be updated with the incoming NCCC Override Date. (REMS), which is mandated by the Food and Drug Administration (FDA) for Technical Resolution: --------------------- Correct routine YSCLSRV2 from failing to find a match in the CLOZAPINE PATIENT LIST file (#603.01) for the incoming clozapine authorization number and patient when attempting to file an NCCC Override Date in the OVERRIDE field (#3). Prior to the patch, the code compared clozapine number associated with the incoming NCCC override with the first (earliest) clozapine authorization number on file for the patient. If the patient had only one clozapine number on file, the match was successful. If the patient had more than one clozapine number on file, tracking clozapine patients. the match failed as the most recent clozapine number was ignored. Routine OVVRID^YSCLSRV2 was changed to look through all clozapine authorization numbers associated with the patient to find a match for the clozapine number associated with the incoming NCCC override. 3. Requirement 2 Defect 1 - Patient with Temp Registration and an NCCC Authorization and NCCC Override Date, but day supply limited to 4. INC9951972: COVID-19 VistA PSO defect - Clozapine National Override 141 DATE APPLIED: 2020-11-16 12:13:12 APPLIED BY: USER,SEVENTEEN DESCRIPTION: The purpose of this patch is to add updates and correct defects in both the MHA Windows executable and in the web-based MHA Patient Entry application. 149 SEQ #129 DATE APPLIED: 2020-12-08 08:29:23 APPLIED BY: USER,SEVENTEEN DESCRIPTION: Information Systems and Technology Architecture (VistA) side software for Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A this effort. The other components are web-based and will be installed on Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): servers outside of VistA and in the VA cloud services. The purpose of N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. Rational ID Defect 1262531 Sites Not Able to Transmit Clozapine Prescription Data Phase 2 is to provide enhancements for the National Clozapine Registry Problem: -------- Some sites were not transmitting data via the OPTION Daily Clozapine Transmission [YSCL DAILY TRANSMISSION]. The cause was a missing FileMan date in the log that is stored in the zero node of ^XTMP("YSCLTRN"). Resolution: ----------- The YSCLTST5 routine was modified to prevent this problem. The code now (NCR). forces the initial loop value to zero and the logic proceeds. Test Sites: ----------- N. FLORIDA/S. GEORGIA VHS (573) VA NORTH FLORIDA/SOUTH GEORGIA HEALTH SYSTEM - GAINESVILLE DIVISION Gainesville, FL WEST LA VAMC (691) VA GREATER LOS ANGELES HEALTHCARE SYSTEM - WEST LOS ANGELES Los Angeles, CA CONNECTICUT HCS (689) CONNECTICUT HEALTH CARE SYSTEM - WEST HAVEN DIVISION West Haven, CT Software and Documentation Retrieval Instructions: -------------------------------------------------- YS5.01149 will add new VistA options and a new file, CLOZAPINE HL7 The software for this patch is being released in a PackMan message. Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Clinical >> Mental Health Documentation Title File TRANSMISSION (#603.05) to track the Health Level 7 (HL7) messages. This Name National Clozapine Coordination Project VistA User Guide VistA Clozapine User Guide YS149 Updates.docx Patch Installation: ------------------- Pre/Post-Installation Overview: file can be read by users who have FileMan access and a "Y" in their FILE After the patch is installed the new option Transmit Clozapine Rx HL7 Messages [YSCL HL7 CLOZ TRANSMISSION] needs to be scheduled in TaskMan. Instructions are listed below. Also, after installing the patch the coordinator for the YSCLHL7 LOGS Mail Group should be notified that the patch was installed and that users can be added to the Mail Group. MailMan messages with information about the HL7 message transmissions will be sent to that group. This is an example: MANAGER ACCESS CODE, which is field #3 in the NEW PERSON file (#200). Subj: Clozapine HL7 report ST ELIGIUS HOSPITAL (999) [#30896] 11/29/19@16:42 22 lines From: HRUBOVCAK,JC In 'IN' basket. Page 1 -------------------------------------------------------------- HL7 transmission report Nov 29, 2019@16:42:04 Site: ST ELIGIUS HOSPITAL (999) Total messages sent: 12 The purpose of this software package is for the Department of Veterans This patch also contains HL7 message components and their associated Message ID Type Prescription 999 550 ADT^A28 900042 999 551 RDE^O11 900042 999 552 ADT^A28 900218 999 553 RDE^O11 900218 999 554 ADT^A28 900285 999 555 RDE^O11 900285 999 556 ADT^A28 900217 subscriptions, plus a logical link to VistA. Most of these components 999 557 RDE^O11 900217 999 558 ADT^A28 900281 999 559 RDE^O11 900281 999 560 ADT^A28 900223 999 561 RDE^O11 900223 Sent to: G.YSCLHL7 LOGS * END OF REPORT * will not be visible to VistA users. The HL7 messages will be sent as a Pre-Installation Instructions: The only pre-installation step is to decide who will be the coordinator for the new YSCLHL7 LOGS Mail Group; the installer will be prompted for that name during the installation. This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 3 minutes to install. batch to track specific VistA activities such as registering a new The menu rebuild may take a few minutes after the patch is installed. No options or protocols need to be disabled before installation. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. clozapine patient for treatment. HL7 messages will be sent to an 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter YS5.01149. B. Select the Backup a Transport Global option to create a backup message of any routines exported with this patch. external system and VistA will receive HL7 acknowledgements, where needed. It will not backup any other changes such as DDs or templates. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' answer <YES>. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' answer <NO>. A new HL LOGICAL ENTRY is named YSCL-NCCC and will connect to the NCR iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' answer <NO>. iv. When prompted 'Enter options you wish to mark as 'Out Of Order':' press <ENTER>. v. When prompted 'Enter protocols you wish to mark as 'Out Of Order':' press <ENTER>. servers. vi. When prompted 'Delay Install (Minutes): (0 - 60): 0//', press <ENTER> for zero seconds. Post-Installation Instructions: After the patch is installed the installer should notify the coordinator of the YSCLHL7 LOGS mail group (see notes above) and schedule the new transmission option. The new option Transmit Clozapine Rx HL7 Messages [YSCL HL7 CLOZ TRANSMISSION] should be scheduled in TaskMan to run daily in off-hours, typically between 10:00 PM and 2:00 AM. The option can be scheduled using the TaskMan option Schedule/Unschedule Options [XUTM SCHEDULE]. The option will not have a DEVICE FOR QUEUED JOB OUTPUT. That is, the device field should be null. This is an example: * * * * * * * * * * * * * * Affairs (VA) to maintain compliance with federal mandates for tracking A complete list of the patch components can be generated using KIDS Edit Option Schedule Option Name: YSCL HL7 CLOZ TRANSMISSION Menu Text: Transmit Clozapine Rx HL7 Messag TASK ID: 8798880 ___________________________________________________________ QUEUED TO RUN AT WHAT TIME: DEC 5,2019@23:00 DEVICE FOR QUEUED JOB OUTPUT: options. QUEUED TO RUN ON VOLUME SET: RESCHEDULING FREQUENCY: 1D TASK PARAMETERS: SPECIAL QUEUEING: ______________________________________________________________ Exit Save Next Page Refresh Quit * * * * * * * * * * * * * * Back-Out/Roll Back Plan: ------------------------ The routines can be restored from the backup message created in Except for routine YSCLTST5, the VistA components in this patch are all installation step B above. The new options can be placed out-of-order or deleted. The new routines can be deleted manually without affecting other VistA packages. No data will need conversion to restore the system. The data dictionary components of this patch can be removed using standard VA FileMan options. new and do not modify existing software. The types of HL7 messages to be transmitted: ADT^A05 (Pre-admit a Patient) RDE^O11 (Pharmacy/Treatment Encoded Order) Clozapine prescriptions and dispensing. Patch Components: ----------------- File #603.03 was already at sites; it has two new fields. Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- This is an existing file. CLOZAPINE PARAMETERS (#603.03) Modified (#603.03) HL7 TRANSMISSION START (#20.01) New (#603.03) HL7 TRANSMISSION END (#20.02) New This is a new file. CLOZAPINE HL7 TRANSMISSION (#603.05) New (#603.05) POINTER TO PATIENT FILE (#2) (#.01) New (#603.05) RX TRANSMISSION (#1, sub-file #603.51) New (#603.51) DATE/TIME OF TRANSMISSION (#.01) New (#603.51) HLO MESSAGE (#.02) New (#603.51) MESSAGE TYPE (#.03) New This patch will add enhancements to the Mental Health package for the (#603.51) PRESCRIPTION # (#.04) New Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: National Clozapine Coordination (NCC) Project. It is also referred to as Mail Group Name New/Modified/Deleted --------------- -------------------- YSCLHL7 LOGS New Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- YSCL HL7 CLOZ RETRANSMIT run routine New YSCL HL7 CLOZ TRANSMISSION run routine New the Clozapine Modernization (ClozMod) Project. YS5.01149 is part of YSCL HL7 LIST CLOZAPINE RXS run routine New YSCL HL7 MAIN menu New YSCL HL7 QUEUE TRANSMISSION run routine New YSCL HL7 REPORT BY DATE run routine New YSCL HL7 STATUS REPORT run routine New Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- Phase 2 of the MENTAL HEALTH NCC PROJECT and is the Veterans Health N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: 172b DATE APPLIED: 2021-04-05 00:00:00 DESCRIPTION: Backup of YS5.01172 on Apr 05, 2021 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. DATE INSTALLED AT THIS SITE: 1996-08-21 00:00:00
DESCRIPTION	Mental Health belongs to the CORE+8 group of DHCP packages. This package includes modules to assist Psychologists, Psychiatrists, Nurses, Social Workers, and other health-care professionals in the care of Mental Health patients. Major clinical entities include various clinical modules and options, an inpatient module, a psychologic testing module, and various supervisory options.
FILE	UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: MERGE UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: MERGE UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: MERGE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: MERGE UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: MERGE UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO FIELD: DXLS UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: NO MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: NO UPDATE THE DATA DICTIONARY: YES ASSIGN A VERSION NUMBER: YES MAY USER OVERRIDE DD UPDATE: NO DATA COMES WITH FILE: YES MERGE OR OVERWRITE SITE'S DATA: OVERWRITE MAY USER OVERRIDE DATA UPDATE: NO
POST-INITIALIZATION ROUTINE	YSD4POST
POST-INIT COMPLETION DATE	1996-08-21 13:56:48
PRE-INIT AFTER USER COMMIT	YSD4PRE
PRE-INIT COMPLETION DATE	1996-08-21 13:50:54

MENTAL HEALTH (100) PACKAGE (9.4)