YS*5.01*67 (3894)    BUILD (9.6)

Name Value
NAME YS*5.01*67
DATE DISTRIBUTED 2001-10-31 00:00:00
PACKAGE FILE LINK MENTAL HEALTH
REQUIRED BUILD
  • YS*5.01*55
    ACTION:   Don't install, leave global
TYPE SINGLE PACKAGE
DESCRIPTION OF ENHANCEMENTS
Patch YS*5.01*67 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):         YS*5.01*67

       Use INSTALL NAME: YS*5.01*67 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: YS*5.01*67
 
   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           YS*5.01*67 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     YS*5.01*67 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.
TRACK PACKAGE NATIONALLY YES
FILE
  • UPDATE THE DATA DICTIONARY:   YES
    SEND SECURITY CODE:   YES
    SEND FULL OR PARTIAL DD:   FULL
    RESOLVE POINTERS:   NO
    DATA COMES WITH FILE:   NO
    SITE'S DATA:   OVERWRITE
    MAY USER OVERRIDE DATA UPDATE:   NO
  • UPDATE THE DATA DICTIONARY:   NO
    SEND SECURITY CODE:   NO
    SEND FULL OR PARTIAL DD:   FULL
    RESOLVE POINTERS:   NO
    DATA COMES WITH FILE:   YES
    SITE'S DATA:   OVERWRITE
    MAY USER OVERRIDE DATA UPDATE:   NO
    SCREEN TO SELECT DATA:   I (Y=26)!(Y=27)
BUILD COMPONENTS
  • ENTRIES:
    • YS BROKER
      ACTION:   SEND TO SITE
  • ENTRIES:
    • YTAPI NEW ASI
      ACTION:   SEND TO SITE
  • ENTRIES:
    • YTAPI8
      ACTION:   SEND TO SITE
      CHECKSUM:   B5111873
    • YSASNAR
      ACTION:   SEND TO SITE
      CHECKSUM:   B39272942
ENVIRONMENT CHECK ROUTINE YS67
DELETE ENV ROUTINE Yes
POST-INSTALL ROUTINE POST^YS67