******************************************************************************* ORIGINAL VA PATCH TEXT FOLLOWS FOR THE PATCHES INCLUDED IN APSP 1009 ******************************************************************************* Drug Accountability patches VA Patch seq # 41-56 ******************************************************************************* ============================================================================= Run Date: JUN 15, 2006 Designation: PSA*3*51 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #41 Status: Released Compliance Date: JUL 16, 2006 ============================================================================= Subject: OUTDATED MEDICATIONS Category: - Enhancement (Mandatory) - Routine Description: ============ This option gives the user the ability to select and store drugs that are to be returned to the manufacturer. The new OUTDATED MEDICATIONS option is located within the PHARMACY LOCATION MAINTENANCE menu and locked with the PSAMGR key. Associated Remedy Tickets: ========================== N/A Test Sites: =========== GREATER LOS ANGELES HCS TUSCALOOSA, AL MILWAUKEE, WI Installation Instructions: ========================== This patch must be loaded with users off the system. Installation will take less than 5 minutes. Suggested time to install: non-peak requirement hours 1. Use the INSTALL/CHECK MESSAGE option in the PackMan function. 2. From the Kernel Installation & Distribution System Option, select the Installation Option. 3. From this option, you may select to use the following items: (when prompted for INSTALL NAME, enter PSA*3.0*51). a. Backup a Transport Global - this option will create a backup message of any routines exported with the 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 the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - this option will ensure the integrity of the routines that are in the transport global. 4. Use the Install Package(s) option and select the package PSA*3.0*51. 5. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//" respond NO. 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. Documentation Retrieval: ======================== Sites may retrieve documentation in one of the following ways: (1) The preferred method is to FTP the files from download.vista.med.va.gov, which will transmit the files from the first available FTP server. (2) Sites may also elect to retrieve documentation directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The documentation distribution includes: FILE NAMES DESCRIPTION ========== ============ PSA_3_UM_R0606.pdf Drug Accountability User Manual PSA_3_P51_UM_CP.pdf Drug Accountability User Manual Change pages PSA_3_TM_R0606.pdf Drug Accountability Technical Manual PSA_3_P51_TM_CP.pdf Drug Accountability Technical Manual Change pages (3) Once released, documentation may be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl Routine Summary: ================ The second line now reads as follows: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[PATCH LIST]**; 10/24/97 CHECK^XTSUMBLD results: Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PSAOUT N/A 25435530 51 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAOUT Before: n/a After: B52711368 **51** ============================================================================= User Information: Entered By : BLOCKER,DAVE Date Entered : NOV 19, 2004 Completed By: DAVIS,DOUG Date Completed: JUN 15, 2006 Released By : WASHINGTON,JANET P Date Released : JUN 15, 2006 ============================================================================= ============================================================================= Run Date: JUL 12, 2006 Designation: PSA*3*50 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #42 Status: Released Compliance Date: AUG 12, 2006 ============================================================================= Associated patches: (v)PSA*3*34 <<= must be installed BEFORE `PSA*3*50' Subject: UNDEFINED ERROR IN PSAPROC1 AND FALSE PROCESSING MESSAGE Category: - Routine Description: ============ This patch addresses the following problems: 1. HD 68113 Invoice select prompt (1-0) The software is not properly detecting when all invoices being worked with have been processed. It is asking the user to make a selection when there are no invoices left to select from. The software errors out with an undefined if the user continues. 2. HD 93067 A faulty message 'The invoice has not been placed in a Processed status!' is presented. Processing invoices currently does not evaluate the status of the invoice being processed and displays an inaccurate message at the end of processing. 3. HD 91604 An undefined error occurs when the selection list of invoices to send on to verification has a missed node in the display numbering sequence of the invoices. The user is able to put in a range from the beginning of the list to the last number in the list and the processing tries to work on all numbers in between. It hits the number of the missing node and it breaks. ASSOCIATED NOIS/REMEDY: ======================= 68113 LEX-0704-40589 null subscript error when processing invoice Duplicate 68665 NJH-0105-20925 Experiencing Problems with Invoice Processing 126683 SUBSCRIPT ERROR 142448 Option PSA PROCESS PRIME VENDOR DATA aborts 142670 Process CS Invoice, errored out, no record of the invoice 93067 Faulty Message: ** The invoice has not been placed in a Processed status! 91604 INVSEL+1^PSAPROC1 Missing node in PSAOK array breaks the software. Duplicates 132934 INVSEL+1^PSAPROC1 137490 Error -- SETINV+3^PSAPROC2 135507 GETTING ERROR WHEN USING PSA PROCESS PRIME VENDOR DATA 143203 INVSEL+1^PSAPROC1 ASSOCIATED E3R(s): ================== N/A PARTICIPATING TEST SITES: ========================= PORTLAND OR HUNTINGTON WV MARYLAND HCS RENO FAYETTEVILLE NOIS/REMEDY OVERVIEW: ==================== 1. HD 68113 Invoice select prompt (1-0) PROBLEM: ======== The software is not properly detecting when all invoices being worked with have been processed. It is asking the user to make a selection when there are no invoices left to select from. The software errors out with an undefined if the user continues. RESOLUTION: =========== Two variables exists that do present the count of invoices left to be processed. Tests for both of those variables have been coded and the software will bypass the inappropriate prompts. TECHNICAL: ========== Routine PSAPROC2 has been modified to test for the variable that holds the count of invoices left to process. If there are none it skips the inappropriate prompts for further editing/processing and the subsequent prompt for selection of invoices. 2. HD 93607 A faulty message 'The invoice has not been placed in a Processed status!' is presented. PROBLEM: ======== Processing invoices currently does not evaluate the status of the invoice being processed and displays an inaccurate message at the end of processing. Resolution: =========== The processing application has been modified to correctly evaluate the status of the invoice before displaying the end of processing message. TECHNICAL: ========== The routine PSAPROC1 has added code that restores the processed condition logic state prior to testing for whether the 'not processed ' message needs to be printed. 3. HD 91604 An undefined error occurs when the selection list of invoices to send on to verification has a missed node in the display numbering sequence of the invoices. PROBLEM: ======== The user is able to put in a range from the beginning of the list to the last number in the list and the processing tries to work on all numbers in between. It hits the number of the missing node and it breaks. Resolution: =========== Protective code has been inserted to detect that a node in the array listing invoices is missing and it skips that number if it is not present. TECHNICAL: The routine PSAPROC1 has been modified with a 'I '$D(PSAOK(PSA)) Q' statement to skip any missing nodes in the listing of invoices ready for processing to verification. INSTALLATION INSTRUCTIONS ========================= This patch should be loaded with NO Drug Accountability users on the system. Installation time is less than one minute. 1. Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 3. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*50): 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 DD's or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when patch (routines, DD's, 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. 4. Use the Install Package(s) option and select the package PSA*3.0*50. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. INSTALLATION EXAMPLE: ===================== It consisted of the following Install(s): PSA*3.0*50 Checking Install for Package PSA*3.0*50 Install Questions for PSA*3.0*50 Want KIDS to INHIBIT LOGONs during the install? YES// NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO Install Started for PSA*3.0*50 : Jan 12, 2006@20:39:48 Build Distribution Date: Jan 12, 2006 Installing Routines: Updating Routine file... Updating KIDS files... PSA*3.0*50 Installed. Jan 12, 2006@20:39:48 PSA*3.0*50 Install Completed ROUTINE SUMMARY =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== =========== PSAPROC1 21541873 21679292 **12,21,50** PSAPROC2 36375020 36119155 **34,50** PSAPROC6 29791842 30254006 **3,21,34,50** Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAPROC1 Before: B38965265 After: B40499741 **12,21,50** Routine Name: PSAPROC2 Before: B69077641 After: B70245487 **34,50** Routine Name: PSAPROC6 Before: B71811767 After: B76371787 **3,21,34,50** ============================================================================= User Information: Entered By : WESLEY,PAUL Date Entered : NOV 12, 2004 Completed By: HEFFERNAN,COREY Date Completed: JUL 12, 2006 Released By : VECE,VIRGINIA Date Released : JUL 12, 2006 ============================================================================= ============================================================================= Run Date: JUL 19, 2006 Designation: PSA*3*57 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #43 Status: Released Compliance Date: AUG 19, 2006 ============================================================================= Associated patches: (v)PSA*3*53 <<= must be installed BEFORE `PSA*3*57' Subject: POST VERIFY E-MAIL NOT RECEIVED Category: - Routine Description: ============ This patch will correct the problem of the Post Verify e-mail not sent when changes are made to the invoice. ASSOCIATED REMEDY/NOIS: ======================= HD0000000120170 Post Verify e-mail not received ASSOCIATED E3RS: ================ N/A PARTICIPATING TEST SITES ======================== SAN FRANCISCO CA NEW JERSEY CENTRAL TEXAS REMEDY/NOIS OVERVIEW: ===================== HD0000000120170 Post Verify e-mail not received Problem: -------- User reports that the Post Verify e-mail is not being received after installing PSA*3*53 on 11/8. When changes did occur in the drug file such as (change NDC, price/order unit, price/dispense unit, & dispense unit/order unit) and is in the pre-verify e-mail. Currently PSAVER6 routine executes the e-mail logic after the invoice updates have been applied. This results on no variances being found and no e-mail being sent. Resolution: ----------- PSAVER6 routine will be modified to execute the Post Verify variance e-mail logic before performing any updates. This will ensure that the changes to the invoice are reported accurately. Technical: ---------- PSAVER6 routine will be modified to run the Post Verify variance e-mail logic before making any updates. PSAVER6 routine lines STRAT+17 thru START+22 will be moved to START+3. INSTALLATION INSTRUCTIONS ========================= This patch can be installed at any time. Users do not need to be off the system. Installation will take less than 1 minute. 1. Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: INStallation Load a Distribution Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Install Package(s) Restart Install of Package(s) Unload a Distribution Backup a Transport Global 3. From this menu, you may elect to use the following options (when prompted for the INSTALL NAME, enter PSA*3.0*57): 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 DD's 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, DD's, 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. 4. Use the Install Package(s) option and select the package PSA*3.0*57. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', answer NO. ROUTINE SUMMARY: ================ The following is a list of the routine(s) included in this patch. The second line of each of these routine(s) will look like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== =========== PSAVER6 20061125 20321277 1,3,21,42, 53,57 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAVER6 Before: B55845889 After: B56721641 **1,3,21,42,53,57** ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : DEC 30, 2005 Completed By: HEFFERNAN,COREY Date Completed: JUL 17, 2006 Released By : WASHINGTON,JANET P Date Released : JUL 19, 2006 ============================================================================= ============================================================================= Run Date: OCT 24, 2006 Designation: PSA*3*58 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #44 Status: Released Compliance Date: NOV 24, 2006 ============================================================================= Associated patches: (v)PSA*3*11 <<= must be installed BEFORE `PSA*3*58' Subject: 12 DIGIT NDC, FORCED DRUG SELECTION Category: - Routine Description: ============ This patch addresses the following problems: 1. HD 67762 - NYH-1003-12255 12-DIGIT NDC # The emerging standard is becoming 11 digits for the National Drug Code (NDC). The code had previously been set to create/require 12 digits by adding leading zeros. It is now set to create/require 11 digit NDCs. 2. HD 68340 - Forced acceptance of selected drug CLE-1004-40882 The software is completing the selection of a unique drug name without giving the user the chance to verify the selection. The drug name is unique and the few characters input by the user is enough to select the drug. Once the drug is selected it is not easy to navigate the software to a place where the drug can be reselected if the selection completed by the software is not what the user wanted. ASSOCIATED NOIS/REMEDY: ======================= HD67762 - NYH-1003-12255 12-DIGIT NDC # Duplicate: HD86748 DA does not update price. HD68340 - Forced acceptance of selected drug CLE-1004-40882 ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= Charleston, SC Oklahoma City, OK Alexandria, LA NOIS/REMEDY OVERVIEW: ==================== 1.HD67762 PSANDF 12 digit NDC PROBLEM ======= The emerging standard is becoming 11 digits for the National Drug Code (NDC). The code had previously been set to create/require 12 digits by adding leading zeros. It is now set to create/require 11 digit NDCs. RESOLUTION ========== User screens now are altered to present 11 digit NDC codes and user prompts. TECHNICAL: ========== Modify PSANDF and PSANDF1 to check for eleven digit NDC codes. If the user attempts to enter more then eleven digits the system will display the message "You must enter exactly eleven numbers." If the user attempts to enter less then eleven digits the system will display the message "Enter the 11-digit National Drug Code. Do not enter dashes." When the user enters ?? the help message The NDC must be 11-digits. If the NDC does not contain 11 numbers, zero fill the section of the NDC that is missing. The NDC contains three sections separated by dashes. It contains 5 digits, a dash, 4 digits, a dash, then 2 digits. For Example: If the NDC is 12345-123-1, enter 12345012301. If the NDC is 12345-123-12, enter 12345012312. 2. HD68340 Forced selection of unique drug names. PROBLEM: ======== The software is completing the selection of a unique drug name without giving the user the chance to verify the selection. The drug name is unique and the few characters input by the user is enough to select the drug. Once the drug is selected it is not easy to navigate the software to a place where the drug can be reselected if the selection completed by the software is not what the user wanted. RESOLUTION: =========== The request for selection of a drug is now followed by a prompt showing the drug selected and a 'Yes/No' question 'Is this correct'. If the user answers no then it returns to the select drug prompt. TECHNICAL: ========== Routine PSANDF has been modified to provide user verification of the drug being selected. INSTALLATION INSTRUCTIONS ========================= This patch can be loaded with users in the system. Installation time is less than one minute. 1. Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 3. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*58): 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 DD's 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, DD's, 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. 4. Use the Install Package(s) option and select the package PSA*3.0*58. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. Options and Protocols? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. INSTALLATION EXAMPLE: ===================== It consisted of the following Install(s): PSA*3.0*58 Checking Install for Package PSA*3.0*58 Install Questions for PSA*3.0*58 Want KIDS to INHIBIT LOGONs during the install? YES// NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO Install Started for PSA*3.0*58 : Jan 12, 2006@20:39:48 Build Distribution Date: Jan 12, 2006 Installing Routines: Jan 12, 2006@20:39:48 Updating Routine file... Updating KIDS files... PSA*3.0*58 Installed. Jan 12, 2006@20:39:48 PSA*3.0*58 Install Completed ROUTINE SUMMARY =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0;DRUG ACCOUNTABILITY;**[PATCH LIST]**;10-24-97 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== =========== PSANDF 27467314 27966322 **8,11,58** PSANDF1 8060935 8039023 **58** Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSANDF Before: B52669098 After: B55378261 **8,11,58** Routine Name: PSANDF1 Before: B9896545 After: B9873366 **58** ============================================================================= User Information: Entered By : WESLEY,PAUL Date Entered : JAN 13, 2006 Completed By: TSAIMEUCHONG,BRENDA Date Completed: OCT 20, 2006 Released By : WASHINGTON,JANET P Date Released : OCT 24, 2006 ============================================================================= ============================================================================= Run Date: OCT 26, 2006 Designation: PSA*3*54 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #45 Status: Released Compliance Date: NOV 26, 2006 ============================================================================= Associated patches: (v)PSA*3*48 <<= must be installed BEFORE `PSA*3*54' (v)PSA*3*49 <<= must be installed BEFORE `PSA*3*54' Subject: MCKESSON VSN MATCHING AND DRUG DESCRIPTIONS Category: - Routine - Enhancement (Mandatory) Description: ============ This patch is addressing the following problems: Dispense Unit per Order Unit (DUOU) during processing. PSA*3*48 initiated a temporary plan to aid sites in starting Drug Accountability by shipping in a side file from the vendor and display DUOU for matching drugs when possible during processing. It has been requested that the vendor drug description also be included to aid in matching items to drugs. 2. HD 118133. The sites have requested that the verification screens also display the vendor DUOU and drug description. Both processing and verification screens will have the following information line displayed. The information displayed depends on the availability of vendor information uploaded. ========================= SAMPLE OF THE ADDED LINE: ========================= There are two versions of the display line added. 1) The line if the drug information is available PV-Drug-Descrip: ACETAM? TB #4 ROX RN4X25 PV-DUOU: 100 2) The line if the drug information is not available. PV-Drug-Descrip: Not available. Item is OTC or new after May 2006. =========================== SAMPLE of modified screen: =========================== The same line of information is presented in both processing and verifying screens. Order#: C563685000 Invoice#: 7246433050 Invoice Date: Sep 07, 2005 -------------------------------------------------------------------------- 1 ACETAMINOPHEN, CODEINE 60MG TAB (Controlled Substance) Qty Invoiced: 10 UPC: 300054802324 Order Unit : TU NDC: 00054-8023-24 Unit Price : $9.60 VSN: 1334150 PV-Drug-Descrip: ACETAM? TB #4 ROX RN4X25 PV-DUOU: 100 Dispense Units: TAB Dispense Units Per Order Unit: 2000 ASSOCIATED REMEDY: ================== 1. HD112456 Reinstate XTMP VSN-DUOU display and include drug description. 2. HD118133 Provide vendor drug description and DUOU on verification screens. ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= HEARTLAND EAST HUNTINGTON OKLAHOMA CITY REMEDY OVERVIEW: ================ 1. HD112456 Reinstate XTMP VSN-DUOU display and include drug description. Problem: -------- The same drug is being ordered by divisions but in different quantities. PSA 3 48 enabled a temporary mapping of Mckesson VSNs to DUOUs using a temporary global. It was to aid sites getting drug accountability setup. The temporary mapping timed out after six months and sites are requesting a newer longer lasting mapping be established. Resolution: ----------- A new mapping ^XTMP global will be built by postinit routines. The global will remain on the system and provide mapping capability for one year. 2. HD118133 Provide vendor drug description and DUOU on verification screens. Problem: ------- The verifying screens need the same additional information that will be displayed in the processing screens regarding vendor drug description and DUOU. Resolution: ----------- The software will now provide the vendor's drug description and DUOU if the item is not an over the counter (OTC) item or newer to the vendor than May 2006 when the update table was provided for this patch. The item verifying screens will have the same information added as illustrated by the processing screens in problem 1. Technical: ========== 1. HD112456 Reinstate Mckesson Vendor Stock Number (VSN) to Dispense Units per Order Unit (DUOU) mapping. a) The routine PSAP54 will read the MCKESSON_UPDATE.DAT file and create the ^XTMP("PSAVSN" global. b) The routine PSAUTL1 has been modified to also display the vendor drug description. The postinit routine PSAP54* will establish the ^XTMP("PSAVSN",VSN)=DUOU^DRUG DESCRIPTION global as it had been used previously. The global holds all Mckesson inventory items as of May 2006. 2. HD118133 The display of vendor drug description and DUOU are needed when verifying invoice items. The routine PSAUTL4 has been modified to take the item's VSN and look into the new ^XTMP("PSAVSN") global as established by #1 above for vendor information. It will display appropriate information in accordance with the presence of the vendor's information. SOFTWARE DISTRIBUTION: ====================== The software for this patch is being distributed via a host file. Two files are required for this installation: PSA_3_54.KID MCKESSON_UPDATE.DAT Sites may retrieve the KIDS build and .dat file in one of the following ways: (1) The preferred method is to FTP the files using ASCII mode from download.vista.med.va.gov which will transmit the files from the first available FTP server. (2) Sites may elect to retrieve the files directly by using FTP from the ANONYMOUS.SOFTWARE directory from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov DOCUMENTATION DISTRIBUTION: =========================== The revised Drug Accountability User Manual and the Change Pages document are available on the ANONYMOUS.SOFTWARE directory at one of the following Office of Information (OI) Field Offices. Sites may retrieve documentation in one of the following ways: (1) The preferred method is to FTP (using BIN mode) the files from download.vista.med.va.gov, which will transmit the files from the first available FTP server. (2) Sites may also elect to retrieve documentation directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The documentation distribution includes: FILE NAMES DESCRIPTION ---------- ----------- PSA_3_UM_R1006.PDF User Manual PSA_3_P54_UM_CP.PDF Change Pages (3) The documentation can also be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl. INSTALLATION INSTRUCTIONS: ========================== This patch can be loaded with users in the system. Installation should not be done while users are processing or verifying invoices in Drug Accountability. Installation time is less than one minute. 1. Obtain the files PSA_3_54.KID and MCKESSON_UPDATE.DAT as instructed under the Software Distribution section. 2. This install should NOT be queued because user interaction is required. 3. From the Kernel Installation & Distribution System menu, select the Installation menu. 4. Use Load a Distribution using PSA_3_54.KID when prompted to Enter a Host File name. You may need to enter the full directory path where you saved the host file PSA_3_54.KID (e.g., SYS$SYSDEVICE:[ANONYMOUS]PSA_3_54.KID). When prompted for "OK to continue with load? NO//", enter "YES". The following will display" Loading distribution... PSA*3.0*54 Use INSTALL NAME: PSA*3.0*54 to install this Distribution. 5. From the Installation menu, you may select to use the following options (when prompted for INSTALL NAME, enter PSA*3.0*54): (a) Backup a Transport Global - this option will create a backup message of any routines exported with the 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 the patch is (c) Verify Checksums in Transport Global - this option will allow you to ensure the integrity of the routines that are in the transport global. (d) Print Transport Global - this option will allow you to view the components of the KIDS build. 6. Use the Install Package(s) option and when prompted for "Select Install Name" enter "PSA*3.0*54". a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. INSTALLATION EXAMPLES: ====================== There are 4 scenarios you may encounter during this install. Action required in each scenario is detailed below. During the installation process, you will recieve one of these messages. You may need to scroll back in order to read the message to see if additional action is required to complete the updating of the ^XTMP("PSAVSN" global. Scenario 1) Normal: The patch install successful. You will see thefollowing messaging: PROCESSING COMPLETE. The ^XTMP("PSAVSN" global has been updated Scenario 2) INVALID DIRECTORY NAME/FILENAME OR FILE DOES NOT EXIST: The MCKESSON_UPDATE.DAT file was not found. Scenario 3) INSTALL WITH BINARY FILE DOWNLOAD: The MCKESSON_UPDATE.DAT file was downloaded using BINARY format. Scenario 4) INSTALL WHEN FILE DATE IS SAME AS PREVIOUS FILE LOADED The MCKESSON_UPDATE.DAT file has already been loaded. The McKesson Update for May 2006 has already been installed During this installation if you see this message, this indicates that the MCKESSON_UPDATE.DAT file is already on your system. You do not need to take further action at this time. Select INSTALL NAME:PSA*3.0*54 Loaded from Distribution 3/16/06@12:54:14 => PSA*3.0*54 ;Created on Mar 16, 2006@12:48:21 This Distribution was loaded on Mar 16, 2006@12:54:14 with header of PSA*3.0*54 ;Created on Mar 16, 2006@12:48:21 It consisted of the following Install(s): PSA*3.0*54 Checking Install for Package PSA*3.0*54 Install Questions for PSA*3.0*54 Build McKesson VSN to Dispense Units Per Order Unit and Drug Description Data This Utility is used to build the ^XTMP(""PSAVSN"" global with then McKesson VSN DUOU & Description. Please follow these steps prior to running this utility: 1) Retrieve the MCKESSON_UPDATE.DAT in ASCII format directly from one of these FTP servers: The preferred FTP server retrieve the file from download.vista.med.va.gov which will transmit the files from the first available FTP server Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov 2) At the HOST DIRECTORY: prompt enter the name of the directory that you placed the file in. i.e. USER$:[TEMP] If you enter an invalid directory this utility will return you to the HOST DIRECTORY: prompt: Enter ^ to Quit: HOST DIRECTORY: USER$:[username] HOST FILENAME: MCKESSON_UPDATE.DAT// Want KIDS to INHIBIT LOGONs during the install? YES// NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// NO Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// UCX/TELNET Scenario 1)**************** Normal Completion ************************* Install Started for PSA*3.0*54 : Mar 16, 2006@12:54:38 PSA*3.0*54 -------------------------------------------------------------------------------- Build Distribution Date: Mar 16, 2006 Installing Routines: Mar 16, 2006@12:54:38 Running Post-Install Routine: POSINIT^PSAP54 PROCESSING PLEASE WAIT PROCESSING COMPLETE. The ^XTMP("PSAVSN" global has been updated Updating Routine file... Updating KIDS files... PSA*3.0*54 Installed. Mar 16, 2006@12:54:39 Install Message sent #2017734 -------------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Scenario 2)** INVALID DIRECTORY NAME/FILENAME OR FILE DOES NOT EXIST *** PSA*3.0*54 -------------------------------------------------------------------------------- Running Post-Install Routine: POSINIT^PSAP54 DIRECTORY = USER$:[username] FILENAME = MCKESSON_UPDATE.DAT INVALID DIRECTORY NAME/FILENAME OR FILE DOES NOT EXIST Please verify that the DIRECTORY is correct and that the MCKESSON_UPDATE.DAT file is present Once you have verified that the DIRECTORY name is correct and/or the file is present, Please run ^PSAP54 from the programmers prompt. Updating Routine file... Updating KIDS files... PSA*3.0*54 Installed. Mar 16, 2006@12:50:11 Install Message sent #2017729 -------------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Scenario 3)************ INSTALL WITH BINARY FILE DOWNLOAD ************ PSA*3.0*54 -------------------------------------------------------------------------------- Installing Routines: Mar 16, 2006@12:52:40 Running Post-Install Routine: POSINIT^PSAP54 There was a problem with the MCKESSON_UPDATE.DAT file Please download it again using ASCII format and run ^PSAP54 from the programmers prompt Updating Routine file... Updating KIDS files... PSA*3.0*54 Installed. Mar 16, 2006@12:52:41 Install Message sent #2017732 -------------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Scenario 4) *** INSTALL WHEN FILE DATE IS SAME AS PREVIOUS FILE LOADED *** PSA*3.0*54 -------------------------------------------------------------------------------- Installing Routines: Mar 16, 2006@13:05:27 Running Post-Install Routine: POSINIT^PSAP54 The McKesson Update for May 2006 has already been installed Please try downloading the file again. Then run ^PSAP54 from the programmers prompt. Updating Routine file... Updating KIDS files... PSA*3.0*54 Installed. Mar 16, 2006@13:05:28 Install Message sent #2017843 -------------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed ROUTINE SUMMARY =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0;DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[PATCH LIST]**;21-MAR-94 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ ========== =========== PSAP54 n/a 13412998 54 PSAUTL1 25341189 26485892 3,12,15,21, 48,49,54 PSAUTL4 13922526 14470458 3,21,48,54 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAP54 Before: n/a After: B24435101 **54** Routine Name: PSAUTL1 Before: B50572615 After: B58194382 **3,12,15,21,48,49,54** Routine Name: PSAUTL4 Before: B24499007 After: B26771267 **3,21,48,54** ============================================================================= User Information: Entered By : WESLEY,PAUL Date Entered : SEP 15, 2005 Completed By: HEFFERNAN,COREY Date Completed: OCT 26, 2006 Released By : VECE,VIRGINIA Date Released : OCT 26, 2006 ============================================================================= ============================================================================= Run Date: JAN 31, 2007 Designation: PSA*3*61 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #46 Status: Released Compliance Date: MAR 03, 2007 ============================================================================= Associated patches: (v)PSA*3*21 <<= must be installed BEFORE `PSA*3*61' (v)PSA*3*54 <<= must be installed BEFORE `PSA*3*61' (v)PSA*3*57 <<= must be installed BEFORE `PSA*3*61' Subject: SUPPLY ITEM AND UNDEFINED ERRORS Category: - Routine Description: ============ This patch addresses two instances where an undefined error may occur, and also addresses the problem with a leading numeric entry for a supply item. Associated Remedy Tickets: -------------------------------------------------------------- HD129689 Undefined N1+3 DICNO Unable to Process Invoice HD132335 (duplicate) Thrown out of Vista when uploading HD154114 (duplicate) Error Processing Invoice HD158264 (duplicate) N1+3^DICN0 Unable to verify order HD171497 (duplicate) Can't access invoice N1+3^DICN0 HD92886 Leading Numeric items; Reporting problem with edit/verify invoices of drug/supply items HD121076 (duplicate) Free text field starting with numeric HD68635 PUG-0105-50501 ASKDRUG+17 HD128204 (duplicate) ASKDRUG+17^PSAVER2 HD166759 (duplicate) ASKDRUG+17^PSAVER2 Error Remedy Ticket Overview: ======================= 1. Problem HD129689 - Undefined error while processing invoice -------------------------------------------------------------- During the processing of an invoice, it is possible to receive the following error: Undefined N1+3 DICNO This error is caused by the system not properly cleaning up variables used by the program DICN0. Resolution HD129689 - Undefined error while processing invoice -------------------------------------------------------------- The program PSAPROC7 will be modified to clean up the variables prior to the call to DICN0. 2. Problem HD92886 - Leading zero's in supply item description -------------------------------------------------------------- If a line item on an invoice is edited to be a supply item and the supply item description starts with a numeric (Example: 16 dram vial, or 10x10 sponge) the system interprets the leading numeric's as an internal entry number to the Drug File. This will cause the software to erroneously select the wrong drug. Resolution HD92886 - Leading zero's in supply item description -------------------------------------------------------------- The code has been modified to ignore the fact that the supply item description starts with a leading numeric. 3. Problem HD68635 - Undefined error while editing invoices -------------------------------------------------------------- In rare cases, the UPC and/or the NDC code in an invoice has no value. If this is the case, the software will error out with an undefined error while editing an invoice to be verified. Resolution HD68635 - Undefined error while editing invoices -------------------------------------------------------------- The code in question will be strengthened to not error out when this scenario occurs. Test Sites: ----------- PUGET SOUND FARGO LOUISVILLE ================INSTALLATION INSTRUCTIONS ================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes 1. LOAD TRANSPORT GLOBAL --------------------- Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. START UP KIDS ------------- Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: INStallation --- Load a Distribution Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Install Package(s) Restart Install of Package(s) Unload a Distribution Backup a Transport Global Select Installation Option: 3. Select Installation Option: --------------------------- NOTE: The following are OPTIONAL - (When prompted for the INSTALL NAME, enter PSA*3.0*61): 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 DD's 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, DD's, 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. 4. Select Installation Option: Install Package(s) ------------------ **This is the step to start the installation of this KIDS patch: a. Choose the Install Package(s) option to start the patch install. b. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//' answer NO c. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//' answer NO Routine Summary =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0;DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[PATCH LIST]**;21-MAR-94 CHECK^XTSUMBLD results Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PSAORDP1 29506902 29506856 3,12,21,61 PSAPROC7 17947479 18400679 3,12,24,27,21,42,61 PSAUTL4 14470458 14488780 3,21,48,54,61 PSAVER6 20321277 20321231 1,3,21,42,53,57,61 PSAVERA1 13428166 13428120 21,61 Total number of routines - 5 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAORDP1 Before: B72112204 After: B72112158 **3,12,21,61** Routine Name: PSAPROC7 Before: B50647267 After: B51614865 **3,12,24,27,21,42,61** Routine Name: PSAUTL4 Before: B26771267 After: B26805479 **3,21,48,54,61** Routine Name: PSAVER6 Before: B56721641 After: B56721595 **1,3,21,42,53,57,61** Routine Name: PSAVERA1 Before: B25758027 After: B25757981 **21,61** ============================================================================= User Information: Entered By : WILLIAMS,BRIAN Date Entered : JUL 02, 2006 Completed By: HEFFERNAN,COREY Date Completed: JAN 31, 2007 Released By : VECE,VIRGINIA Date Released : JAN 31, 2007 ============================================================================= ============================================================================= Run Date: MAR 27, 2007 Designation: PSA*3*60 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #47 Status: Released Compliance Date: APR 27, 2007 ============================================================================= Associated patches: (v)PSA*3*15 <<= must be installed BEFORE `PSA*3*60' (v)PSA*3*21 <<= must be installed BEFORE `PSA*3*60' (v)PSA*3*33 <<= must be installed BEFORE `PSA*3*60' (v)PSA*3*50 <<= must be installed BEFORE `PSA*3*60' Subject: MISC FIXES TO PREVENT DUPLICATE PROCESSING AND ERRORS Category: - Routine - Data Dictionary Description: ============ This patch addresses the following problems: 1. 67941 PSAPROC1 undefined in PSAPROC1 If a Controlled Substance (CS) drug has not been assigned to a master vault, the subsequent code path is killing variables it will be needing later when it returns from the call to perform vault selection. 2. 68039 PSAPROC3 default date The data element in invoices that represents the receive date, under terms of the McKesson contract, is the date they deposit the invoice into their output directories for sites to access. The default date in VistA DA terms had been and is, the received at site date. Management has determined it is best to require the users to manually enter the receive date than to present a default date which is never correct and should not be accepted. 3. 68532 PSADRUGP DISP~PSADRUGP The "Enter/Edit a Drug" [PSA PV DRUG ENTER/EDIT] option errors when the drug's inactivation date is less than the day of the data entry. 4. 131384 PSAVER2 Error using Verify Invoice [PSA VERIFY INVOICES] When verifying invoices, the application errors if the data in the processed invoice contains a semicolon. 5. 134108 PSAVER, PSAVER1, PSAVER4 Invoice approved twice During Invoice Verification, multiple users are allowed to select the same invoice and verify it. The quantities in the DRUG file (#50) are updated each time the invoice is verified. 6. 154985 PSAVER1 Invoice not verified, but message appears Invoices are being marked as verified at the line item level when using the Verify Invoices [PSA VERIFY INVOICES] option and selecting an invoice from the <<< EDIT INVOICES TO BE VERIFIED SCREEN >>> ASSOCIATED NOIS/REMEDY: ======================= 67941 68039 68532 DUPLICATE 118106 131384 134108 DUPLICATE 147662 154985 DUPLICATE 162506 ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= VA Central TX Phoenix Hampton VA NOIS/REMEDY OVERVIEW: ==================== 1. 67941 PSAPROC1 undefined in PSAPROC PROBLEM ======= If a Controlled Substance (CS) drug has not been assigned to a master vault, the subsequent code path is killing variables it will be needing later when it returns from the call to perform vault selection. RESOLUTION ========== The killing of the variable has been removed. 2. 68039 PSAPROC3 default date PROBLEM ======= The data element in invoices that represents the receive date, under terms of the McKesson contract, is the date they deposit the invoice into their output directories for sites to access. The default date in VistA DA terms had been and is, the received at site date. Management has determined it is best to require the users to manually enter the receive date than to present a default date which is never correct and should not be accepted. RESOLUTION ========== The presenting of a date as a default has been removed. 3. 68532 PSADRUGP DISP~PSADRUGP PROBLEM ======= The "Enter/Edit a Drug" [PSA PV DRUG ENTER/EDIT] option errors when the drug's inactivation date is less than the day of the data entry. RESOLUTION ========== PSADRUGP routine will be modified at the DISP tag to test for the variable PSA660. If it does not exist, PSA660 variable will be set with the data from the global ^PSDRUG(drug#,660 4. 131384 PSAVER2 Error using Verify Invoice [PSA VERIFY INVOICES] PROBLEM ======= When verifying invoices, the application errors if the data in the processed invoice contains a semicolon. Some of the invoice processing fields are free text with no screening and are filed individually. When the invoice is verified, that data is then concatenated together in the DR variable used by the FileMan API ^DIE. This API uses the semicolon as a field separator. If the data in the individual fields contain a semicolon, the ^DIE API errors. RESOLUTION ========== PSAVER2 routine will be modified to set the variable DR="5///^S X=PSADJ" instead of DR="5///"_PSADJ. This will allow the ^DIE API to file the data correctly, even when it contains characters that control its functionality. 5. 134108 PSAVER, PSAVER4 Invoice approved twice PROBLEM ======= During Invoice Verification, multiple users are allowed to select the same invoice and verify it. The quantities in the DRUG file (#50) are updated each time the invoice is verified. RESOLUTION ========== Correcting this problem is a two step process. a. INVOICE STATUS field (#2) in the INVOICE DATA sub-file (#58.8112) of the DRUG ACCOUNTABILITY ORDER file (58.811) will have the value 'L' LOCKED VERIFYING added to the data dictionary. b. Routines PSAVER & PSAVER4 will be modified to set the INVOICE STATUS to 'L' LOCKED VERIFYING for each invoice prior to the start of the verification process. At the end of the verification process, the INVOICE STATUS will be changed to 'V' VERIFIED. If the INVOICE STATUS of the selected invoice is 'L' or 'V' the routine will move on to the next invoice selected for processing. 6. 154985 PSAVER1 Invoice not verified, but message appears PROBLEM ======= Invoices are being marked as verified at the line item level when using the "Verify Invoices" [PSA VERIFY INVOICES] option and selecting an invoice from the <<< EDIT INVOICES TO BE VERIFIED SCREEN >>>. This occurs once the user enters a date at the Date Received prompt and then answers NO to the "Do you want to change the invoice's status to Verified?" prompt. RESOLUTION ========== The prompt "Do you want to change the invoice's status to Verified?" at CHG^PSAVER1 will be moved to FIELDS+8^PSAVER1 to stop the verification process when the user answers NO. DATA DICTIONARY: =============== BEFORE ====== 58.8112,2 INVOICE STATUS 0;3 SET Invoice Status 'P' FOR PROCESSED; 'V' FOR VERIFIED; 'C' FOR COMPLETED; LAST EDITED: NOV 29, 1996 HELP-PROMPT: Enter the status of the invoice. DESCRIPTION: The INVOICE STATUS field contains the status of the invoice. When the invoice is completed, the drug balances are incremented with the quantities received on the invoice. CROSS-REFERENCE: 58.811^ASTAT 1)= S ^PSD(58.811,"ASTAT",$E(X,1,30),DA(1),DA)= "" 2)= K ^PSD(58.811,"ASTAT",$E(X,1,30),DA(1),DA) 3)= DO NOT DELETE! This cross-reference is used to locate all invoices with a specific status. AFTER ===== 58.8112,2 INVOICE STATUS 0;3 SET Invoice Status 'P' FOR PROCESSED; 'V' FOR VERIFIED; 'C' FOR COMPLETED; 'L' FOR LOCKED VERIFYING; LAST EDITED: MAR 21, 2006 HELP-PROMPT: Enter the status of the invoice. DESCRIPTION: The INVOICE STATUS field contains the status of the invoice. When the invoice is completed, the drug balances are incremented with the quantities received on the invoice. CROSS-REFERENCE: 58.811^ASTAT 1)= S ^PSD(58.811,"ASTAT",$E(X,1,30),DA(1),DA)= "" 2)= K ^PSD(58.811,"ASTAT",$E(X,1,30),DA(1),DA) 3)= DO NOT DELETE! This cross-reference is used to locate all invoices with a specific status. INSTALLATION INSTRUCTIONS: ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Installation can be queued. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*60): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*60. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. ROUTINE SUMMARY: =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[PATCH LIST]**; 10/24/97 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== =========== PSADRUGP 13010759 13063692 3,21,60 PSAPROC1 21679292 21671542 12,21,50,60 PSAPROC3 27987674 28029174 3,60 PSAVER 34809088 35746412 60 PSAVER1 21304024 24070316 33,60 PSAVER2 20761451 20814752 3,12,21,60 PSAVER4 6254747 9889646 15,60 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSADRUGP Before: B22313421 After: B22701616 **3,21,60** Routine Name: PSAPROC1 Before: B40499741 After: B40487833 **12,21,50,60** Routine Name: PSAPROC3 Before: B51547340 After: B51608562 **3,60** Routine Name: PSAVER Before: B73058041 After: B76434485 **60** Routine Name: PSAVER1 Before: B45709811 After: B53904582 **33,60** Routine Name: PSAVER2 Before: B48083431 After: B48168766 **3,12,21,60** Routine Name: PSAVER4 Before: B8379472 After: B15659954 **15,60** ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : MAR 22, 2006 Completed By: HEFFERNAN,COREY Date Completed: MAR 23, 2007 Released By : VECE,VIRGINIA Date Released : MAR 27, 2007 ============================================================================= ============================================================================= Run Date: JUL 19, 2007 Designation: PSA*3*64 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #48 Status: Released Compliance Date: AUG 19, 2007 ============================================================================= Associated patches: (v)PSA*3*25 <<= must be installed BEFORE `PSA*3*64' (v)PSA*3*37 <<= must be installed BEFORE `PSA*3*64' (v)PSA*3*51 <<= must be installed BEFORE `PSA*3*64' (v)PSA*3*56 <<= must be installed BEFORE `PSA*3*64' (v)PSA*3*60 <<= must be installed BEFORE `PSA*3*64' (v)PSA*3*61 <<= must be installed BEFORE `PSA*3*64' Subject: LOCK TIMEOUT (Q3 ENHANCEMENTS) Category: - Routine - Enhancement (Mandatory) Description: ============ With the deployment of Cache version 5, it was discovered that the short lock timeout values could generate a lock failure. Patch DI*22*147, which has already been released, provided a solution to resolve this issue and future lock issues. This patch instituted a new default lock timeout of three seconds based on a global node setting of ^DD("DILOCKTM")=3. In order to avoid the lock issue in Drug Accountability, this patch modifies all routines that currently use a lock timeout value of less than 3 seconds to check for the node ^DD("DILOCKTM") and to use the value defined there, otherwise the lock timeout value is set to a default value of 3 seconds. Associated Remedy Ticket(s): ============================ N/A Test Sites: =========== DURHAM, NC IRON MOUNTAIN, MI LOUISVILLE, KY MONTANA HCS NEW YORK HARBOR HCS OKLAHOMA CITY, OK Installation Instructions: ========================== This patch can be loaded with users on the system. Installation will take less than 5 minutes. Suggested time to install: non-peak requirement hours 1. Use the INSTALL/CHECK MESSAGE option in the PackMan function. 2. From the Kernel Installation & Distribution System Option, select the Installation Option. 3. From this option, you may select to use the following items: (when prompted for INSTALL NAME, enter PSA*3.0*64). a. Backup a Transport Global - this option will create a backup message of any routines exported with the 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 the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - this option will ensure the integrity of the routines that are in the transport global. 4. Use the Install Package(s) option and select the package PSA*3.0*64. 5. When prompted "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 NO. Routine Summary: ================ The second line now reads as follows: ;;3.0; DRUG ACCOUNTABILITY ;**[PATCH LIST]**;24 OCT 97 CHECK^XTSUMBLD results: Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PSAAOP 10885786 10976195 21,64 PSABRKU4 22100300 22227825 26,64 PSACREDR 14737181 14854302 3,64 PSADJ 26944807 27144705 3,12,64 PSADJI 7697016 7896914 64 PSADRUG 14852917 15041367 64 PSADRUGP 13063692 13359723 3,21,60,64 PSAGIP 13097195 13181880 8,64 PSANAC 18616464 18699241 15,64 PSAOP1 9894343 10278875 64 PSAOUT 25435530 25514491 51,64 PSAPOST 3085256 3173757 64 PSAPROC7 18400679 18483456 3,12,27,21,42,61,64 PSAPROC8 24719890 24981577 3,64 PSAPSI1 6627356 6815806 64 PSAREC1 13531219 14406689 21,37,64 PSARWS 11036019 11222561 3,64 PSATRAN1 10464836 10826472 64 PSAUDP 10459969 10550378 6,3,12,14,25,64 PSAVER2 20814752 21267972 3,12,21,60,64 PSAVER3 28853622 29080232 3,19,21,64 PSAVER6 20321231 20521129 1,3,21,42,53,57,61,64 PSAVER7 10279861 10964973 12,21,42,56,64 Note: Patch PSA*3*24 was entered in error, so the 2nd line of the routine PSAPROC7 was modified to remove that patch number. Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAAOP Before: B15006908 After: B15158373 **21,64** Routine Name: PSABRKU4 Before: B39501736 After: B39640697 **26,64** Routine Name: PSACREDR Before: B30767974 After: B31030103 **3,64** Routine Name: PSADJ Before: B54165345 After: B54586571 **3,12,64** Routine Name: PSADJI Before: B10851547 After: B11144937 **64** Routine Name: PSADRUG Before: B21853949 After: B22959232 **64** Routine Name: PSADRUGP Before: B22701616 After: B23255227 **3,21,60,64** Routine Name: PSAGIP Before: B22177455 After: B22355632 **8,64** Routine Name: PSANAC Before: B28314130 After: B28480859 **15,64** Routine Name: PSAOP1 Before: B17931264 After: B18529492 **64** Routine Name: PSAOUT Before: B52711368 After: B52860925 **51,64** Routine Name: PSAPOST Before: B3787169 After: B3906198 **64** Routine Name: PSAPROC7 Before: B51614865 After: B51722446 **3,12,27,21,42,61,64** Routine Name: PSAPROC8 Before: B42292090 After: B42624373 **3,64** Routine Name: PSAPSI1 Before: B9513101 After: B9754975 **64** Routine Name: PSAREC1 Before: B25736843 After: B27528153 **21,37,64** Routine Name: PSARWS Before: B16948588 After: B17261058 **3,64** Routine Name: PSATRAN1 Before: B20498296 After: B21031652 **64** Routine Name: PSAUDP Before: B16331334 After: B16486615 **6,3,12,14,25,64** Routine Name: PSAVER2 Before: B48168766 After: B49116158 **3,12,21,60,64** Routine Name: PSAVER3 Before: B70683191 After: B71438317 **3,19,21,64** Routine Name: PSAVER6 Before: B56721595 After: B57278289 **1,3,21,42,53,57,61,64** Routine Name: PSAVER7 Before: B21998515 After: B23378139 **12,21,42,56,64** Routine list of preceding patches: 8, 15, 25, 26, 37, 51, 56, 60, 61 ============================================================================= User Information: Entered By : ALSAHHAR,SAMI Date Entered : APR 03, 2007 Completed By: LEONARD,KEN Date Completed: JUL 17, 2007 Released By : WASHINGTON,JANET P Date Released : JUL 19, 2007 ============================================================================= ============================================================================= Run Date: AUG 28, 2007 Designation: PSA*3*65 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #49 Status: Released Compliance Date: SEP 28, 2007 ============================================================================= Associated patches: (v)PSA*3*60 <<= must be installed BEFORE `PSA*3*65' (v)PSA*3*61 <<= must be installed BEFORE `PSA*3*65' Subject: FIX LOCK, UNKNOWN STATUS AND EDIT VERIFY QUITTING EARLY Category: - Routine Description: ============ This patch addresses the following problems: 1. 186350 DA INVOICES UNKNOWN STATUS There are two separate issues a. The invoice remains in a LOCKED VERIFYING status when there are errors in the invoice. This LOCKED VERIFYING status does not allow any further action until the invoice status has been reset to PROCESSED or VERIFIED. b. When an invoice is in a LOCKED VERIFYING status, the Print Orders report shows the status as UNKNOWN. 2. 187185 Can only verify one invoice at a time after PSA*3*60 When using the EDIT INVOICES TO BE VERIFIED SCREEN and the user selects multiple invoices to edit, the application quits after editing the first invoice. ASSOCIATED REMEDY: ================== 186350 DUPLICATE 186988 188517 188915 190593 191066 192470 193223 187185 ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= OKLAHOMA CITY LEBANON NY HARBOR REMEDY OVERVIEW: ================ 1. 186350 DA INVOICES UNKNOWN STATUS PROBLEM ======= There are two separate issues a. The invoice remains in a LOCKED VERIFYING status when there are errors in the invoice. This LOCKED VERIFYING status does not allow any further action until the invoice status has been reset to PROCESSED or VERIFIED. b. When an invoice is in a LOCKED VERIFYING status, the Print Orders report shows the status as UNKNOWN. RESOLUTION ========== a. The PSAVER routine will be modified to call VERUNLCK^PSAVER4 after printing the error report. This will set the invoice status back to a processed status and allow the user to access the invoice for further processing or edits. b. The PSAORDP1 routine will be modified to include the LOCKED VERIFYING status when printing the Print Orders report. 2. 187185 Can only verify one invoice at a time after PSA*3*60 PROBLEM ======= When using the EDIT INVOICES TO BE VERIFIED SCREEN and the user selects multiple invoices to edit, the application quits after editing the first invoice. RESOLUTION ========== The PSAVER1 routine will be modified to NEW the PSASEL and PSASEL1 variables before they are set to a new value. INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*65): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*65. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. ROUTINE SUMMARY =============== The following is a list of the routines included in this patch. The second line of each of these routines now looks like: ;;3.0;DRUG ACCOUNTABILITY;**[PATCH LIST]**;10-24-97 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== ============= PSAORDP1 29506856 29948168 3,12,21,61,65 PSAVER 35746412 35851577 60,65 PSAVER1 24070316 24287451 33,60,65 Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAORDP1 Before: B72112158 After: B72593730 **3,12,21,61,65** Routine Name: PSAVER Before: B76434485 After: B77677006 **60,65** Routine Name: PSAVER1 Before: B53904582 After: B56200919 **33,60,65** Routine list of preceding patches: 60, 61 ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : MAY 09, 2007 Completed By: HEFFERNAN,COREY Date Completed: AUG 28, 2007 Released By : LYTTLE,KIM M Date Released : AUG 28, 2007 ============================================================================= ============================================================================= Run Date: FEB 28, 2008 Designation: PSA*3*63 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #50 Status: Released Compliance Date: MAR 30, 2008 ============================================================================= Associated patches: (v)PSA*3*21 <<= must be installed BEFORE `PSA*3*63' (v)PSA*3*43 <<= must be installed BEFORE `PSA*3*63' (v)PSA*3*53 <<= must be installed BEFORE `PSA*3*63' (v)PSA*3*61 <<= must be installed BEFORE `PSA*3*63' Subject: NDC SELECT, TIMEOUT ISSUE & EDIT VERIFIED INV ISSUES Category: - Routine Description: ============ This patch addresses the following problems: 1. 68175 PSAENTO Time Out Issue User reported that the "Set Up/Edit a Pharmacy Location" [PSA LOCATION EDIT] option does not quit properly when the application times out at the OUTPATIENT SITE prompt. 2. 98252 PSAVERA Daily Activity Log does not record change on CS invoice When using the "Edit Verified Invoices" [PSA EDIT VERIFIED INVOICE] option, the application does not remove the correct quantity which results in inaccurate quantities being recorded. 3. 119930 PSAPROC4 Multiple NDC match selection needs DUOU displayed When using the "Process Uploaded Prime Vendor Invoice Data" [PSA PROCESS PRIME VENDOR DATA] option, the user is presented with a list of drugs and related information if multiple synonyms exist. Currently the Dose Unit Order Unit (DUOU) is not displayed in that information. The lack of this information can result in the wrong drug being selected during invoice processing. 4. 191994 PSAVERA Duplicate receipt issue When using the Edit Verified Invoices [PSA EDIT VERIFIED INVOICE] option to edit an invoice that has not been verified, the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) is updated. Then when the user verifies the invoice the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) is updated again causing duplicate transactions for the invoice item(s) that the edit was done on. ASSOCIATED NOIS/REMEDY: ======================= 68175 98252 DUPLICATE 68748 68802 88112 118783 124286 164972 172223 211961 222426 119930 DUPLICATE 119469 119945 191994 ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= Hampton Oklahoma City Pittsburgh NOIS/REMEDY OVERVIEW: ==================== 1. 68175 PSAENTO Time Out Issue PROBLEM ======= User reported that the "Set Up/Edit a Pharmacy Location" [PSALOCATION EDIT] option does not quit properly when the application times out at the INPATIENT SITE NAME prompt RESOLUTION ========== Modify PSAENTO routine to check the DTOUT timeout variable. If it exists the routine will quit. 2. 98252 PSAVERA Daily Activity Log does not record change on CS invoice PROBLEM ======= When using the "Edit Verified Invoices" [PSA EDIT VERIFIED INVOICE] option, the application does not remove the correct quantity which results in inaccurate quantities being recorded. RESOLUTION ========== PSAVERA routine will be modified to check the original transaction and use that data to calculate the quantity to be removed. The adjustments will be stored in EDIT VERIFIED ORDER DATE/TIME field (#48), PHARMACIST EDITING field (#49), NEW QUANTITY field (#50), ADJUSTED BY QUANTITY field (#51), REASON EDITED field (#53) and BAL FWD EDIT VERIFIED ORDER field (#54) of the DRUG ACCOUNTABILITY TRANSACTION file (#58.81). 3. 119930 PSAPROC4 Multiple NDC match selection needs DUOU displayed PROBLEM ======= When using the "Process Uploaded Prime Vendor Invoice Data" [PSA PROCESS PRIME VENDOR DATA] option, the user is presented with a list of drugs and related information if multiple synonyms exist. Currently the Dose Unit Order Unit (DUOU) is not displayed in that information. The lack of this information can result in the wrong drug being selected during invoice processing. RESOLUTION ========== PSAPROC4 routine will be modified to include the DUOU in the synonym information that is displayed. 4. 191994 PSAVERA Duplicate receipt issue PROBLEM ======= When using the Edit Verified Invoices [PSA EDIT VERIFIED INVOICE] option to edit an invoice that has not been verified, the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) is updated. Then when the user verifies the invoice the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) is updated again causing duplicate transactions for the invoice item(s) that the edit was done on. RESOLUTION ========== PSAVERA routine will be modified to check the status of the invoice prior to making any updates to the DRUG ACCOUNTABILITY TRANSACTION file (#58.81). INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*63): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*63. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? YES//', answer NO. Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAENTO Before: B54461822 After: B54892451 **12,21,43,63** Routine Name: PSAPROC4 Before: B49665782 After: B51651053 **3,21,63** Routine Name: PSAVERA Before: B64109668 After: B44372640 **21,36,40,53,63** Routine Name: PSAVERA1 Before: B25757981 After: B59601347 **21,61,63** Routine list of preceding patches: 43, 53, 61 ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : NOV 16, 2006 Completed By: HEFFERNAN,COREY Date Completed: FEB 26, 2008 Released By : WASHINGTON,JANET P Date Released : FEB 28, 2008 ============================================================================= ============================================================================= Run Date: APR 14, 2008 Designation: PSA*3*67 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #51 Status: Released Compliance Date: MAY 15, 2008 ============================================================================= Associated patches: (v)PSA*3*47 <<= must be installed BEFORE `PSA*3*67' (v)PSA*3*65 <<= must be installed BEFORE `PSA*3*67' Subject: NEW VENDOR FILE STRUCTURE Category: - Enhancement (Mandatory) - Routine - Data Dictionary Description: ============ This patch modifies the screens within the processing and verification processes within Drug Accountability. Additional drug information is now being included in the invoice files received from the prime vendor. The additional fields are: Generic Description displayed as PV-Drug-Generic Name Item Description displayed as PV-Drug-Description Prime Vendor Units displayed as PV-Units Inner Pack displayed as PV-DUOU The following is a list of the fields added to the DRUG ACCOUNTABILITY ORDER (#58.811). These fields are included in this patch: Field Name Sub-file Number (Field Number) ------------------- ------------------------------ GENERIC DESCRIPTION 58.81125 (18) ITEM DESCRIPTION 58.81125 (19) PRIME VENDOR UNITS 58.81125 (20) INNER PACK 58.81125 (21) Currently, the Item Description and the inner pack fields are stored in a temporary global which was setup in patch PSA*3*54. This global is no longer used. The addition of the four fields is intended to assist the user with the matching of incoming invoice items to the Drug (#50) file. Below is an example of what the screens look like prior to installation of this patch. <<< PROCESS LINE ITEM SCREEN >>> Order#: 3TC01 Invoice#: 7289249573 Invoice Date: Oct 05, 2007 6 HYDROCORTISONE Qty Invoiced: 1 UPC: 30472034356 Order Unit : EA NDC: 00472-0343-56 Unit Price : $0.67 VSN: 1279124 PV-Drug-Descrip: Not Available. Item is OTC or new after February 2006 After patch installation: <<< PROCESS LINE ITEM SCREEN >>> Order#: 3TC01 Invoice#: 7289249573 Invoice Date: Oct 05, 2007 6 HYDROCORTISONE Qty Invoiced: 1 UPC: 30472034356 Order Unit : EA NDC: 00472-0343-56 Unit Price : $0.67 VSN: 1279124 PV-Drug-Description : HYDROCORT AC CRM 1% ALP 30GM@ PV-DUOU : 28.4 PV-Drug-Generic Name : HYDROCORTISONE PV-Units: 1 Associated Remedy Tickets: ========================== N/A Test Sites: =========== DURHAM, SC OKLAHOMA CITY, OK NEW JERSEY HCS, NJ Installation Instructions: ========================== Installation will take less than 5 minutes. The installation may be queued if desired. Suggested time to install: non-peak requirement hours 1. Use the INSTALL/CHECK MESSAGE option in the PackMan function. 2. From the Kernel Installation & Distribution System Option, select the Installation Option. 3. From this option, you may select to use the following items: (when prompted for INSTALL NAME, enter PSA*3.0*67). a. Backup a Transport Global - this option will create a backup message of any routines exported with the 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 the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - this option will ensure the integrity of the routines that are in the transport global. 4. Use the Install Package(s) option and select the package PSA*3.0*67. 5. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//" respond NO. 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. Documentation Retrieval: ======================== Sites may retrieve documentation in one of the following ways: (1) The preferred method is to FTP the files from download.vista.med.va.gov, which will transmit the files from the first available FTP server. (2) Sites may also elect to retrieve documentation directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The documentation distribution includes: FILE NAMES DESCRIPTION ========== ============ PSA_3_UM_R0408.pdf Drug Accountability User Manual PSA_3_P67_UM_CP.pdf Drug Accountability User Manual Change pages PSA_3_TM_R0408.pdf Drug Accountability Technical Manual PSA_3_P67_TM_CP.pdf Drug Accountability Technical Manual Change pages (3) Once released, documentation may be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl Routine Summary: ================ The second line now reads as follows: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[PATCH LIST]**; 10/24/97 CHECK^XTSUMBLD results: Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PSABRKU3 8302157 10518133 26,41,47,67 PSABRKU5 1241570 1328558 26,67 PSAORDP1 29948168 29962609 3,12,21,61,65,67 PSAP67 N/A 1714256 67 PSAPROC7 18483456 19618800 3,12,27,21,42,61,64,67 PSAUP4 26128564 26251338 3,12,20,21,67 PSAUTL1 26485892 27244055 3,12,15,21,48,49,54,67 PSAUTL4 14488780 14847936 3,21,48,54,61,67 Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 15 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSABRKU3 Before: B20933321 After: B26272833 **26,41,47,67** Routine Name: PSABRKU5 Before: B2524103 After: B2166774 **26,67** Routine Name: PSAORDP1 Before: B72593730 After: B73055637 **3,12,21,61,65,67** Routine Name: PSAP67 Before: n/a After: B2116360 **67** Routine Name: PSAPROC7 Before: B51722446 After: B56573649 **3,12,27,21,42,61,64,67** Routine Name: PSAUP4 Before: B72473581 After: B72871098 **3,12,20,21,67** Routine Name: PSAUTL1 Before: B58194382 After: B58704156 **3,12,15,21,48,49,54,67** Routine Name: PSAUTL4 Before: B26805479 After: B27358372 **3,21,48,54,61,67** ============================================================================= User Information: Entered By : BLOCKER,DAVE Date Entered : SEP 27, 2007 Completed By: LEONARD,KEN Date Completed: APR 08, 2008 Released By : VECE,VIRGINIA Date Released : APR 14, 2008 ============================================================================= ============================================================================= Run Date: JUN 04, 2008 Designation: PSA*3*66 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #52 Status: Released Compliance Date: JUL 05, 2008 ============================================================================= Associated patches: (v)PSA*3*64 <<= must be installed BEFORE `PSA*3*66' Subject: LOCK ISSUE Category: - Routine Description: ============ This patch addresses the following problems: 1. HD0000000167457 Non CS drugs appear on narcotic dispensing/receiving report The PSA IV ALL LOCATIONS [PSA IV ALL LOCATIONS] background job colliding with CS dispensing. 2. HD0000000205861 ^PSDRUG LOCKS PSA Verify Invoice processing is not unlocking the drug when finished. ASSOCIATED REMEDY: ================== 1) HD0000000167457 HD0000000182293 (d) 2) HD0000000205861 HD0000000203613 (d) HD0000000245122 (d) HD0000000244690 (d) ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= Upstate New York Oklahoma Ann Arbor REMEDY OVERVIEW: ================ 1. HD0000000167457 Non CS drugs appear on narcotic dispensing/receiving report PROBLEM ======= The PSA IV ALL LOCATIONS [PSA IV ALL LOCATIONS] background job colliding with CS dispensing. This is caused by the lack of a lock in the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) at the time the transaction number is acquired. RESOLUTION ========== PSAUDP routine will be modified to lock the DRUG ACCOUNTABILITY TRANSACTION file (#58.81) prior to acquiring the next transaction number. 2. HD0000000205861 ^PSDRUG LOCKS PROBLEM ======= PSA Verify Invoice processing is not unlocking the drug when finished. Preventing other users to access the drug that is locked. This is caused by a quit in the PSAVER7 routine before the record is unlocked. RESOLUTION ========== All incremental locks in PSAVER7 routine will be accounted for with a matching unlock. INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*66): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*66. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//', answer NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAUDP Before: B16486615 After: B17006589 **6,3,12,14,25,64,66** Routine Name: PSAVER7 Before: B23378139 After: B23883307 **12,21,42,56,64,66** Routine list of preceding patches: 64 ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : SEP 05, 2007 Completed By: HULET,LEE ANN Date Completed: JUN 03, 2008 Released By : WASHINGTON,JANET P Date Released : JUN 04, 2008 ============================================================================= ============================================================================= Run Date: SEP 03, 2008 Designation: PSA*3*68 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #53 Status: Released Compliance Date: OCT 04, 2008 ============================================================================= Associated patches: (v)PSA*3*48 <<= must be installed BEFORE `PSA*3*68' (v)PSA*3*67 <<= must be installed BEFORE `PSA*3*68' Subject: OUTDATED MEDICATIONS OPTION Category: - Routine Description: ============ This patch addresses the following problems: 1. The Outdated Medication [PSA OUTDATED MEDICATIONS] option, which allows for documentation of the return of non-controlled substances, uses the CS Destruction file (#58.86). This file will not allow the user's name to be recorded in the PHARMACIST DESTROYED DRUG field (#9) if they do not have the PSDMGR or PSJ RPHARM security key assigned. 2. The Items to Be Returned Report does not differentiate between returned drug entries made for different divisions/sites. Entries need to be entered and listed by division. 3. Drug accountability invoice processing is changing the NDC field from numeric to alpha characters. 4. The PRE Verify and POST Verify Variance Reports inaccurately report changes for supply items that have been entered with leading numerics in the supply item name (i.e. 60 dram vials). 5. The Outdated Medications [PSA OUTDATED MEDICATIONS] option does not display all possible matches for a drug if the DRUG file (#50) index "C" is a match to the information entered at the "Scan Drug barcode or enter a drug name" prompt. ASSOCIATED REMEDY TICKETS: ========================== 1. HD0000000180658 - Outdated Medications Option Not Working 2. HD0000000172859 - Outdated drug list for integrated sites Duplicate: HD0000000176452 - Non-controlled subs reported will not print in PSA 3. HD0000000184524 - ndc changed from numbers to letters 4. HD0000000222558 - Supply item match to drug file 5. HD0000000229658 - Outdated Medications PARTICIPATING TEST SITES: ========================= Ann Arbor VAMC Fayetteville VAMC N. Indiana HCS REMEDY OVERVIEW: ================ 1. HD0000000180658 - Outdated Medications Option Not Working PROBLEM ------- The problem occurs when a user that does not have the PSDMGR or PSJ RPHARM security key attempts to return outdated medication back to manufacturer through the Outdated Medications [PSA OUTDATED MEDICATIONS] option. The issue will be resolved by bypassing the screen in the CS DESTRUCTION file (#58.86), PHARMACIST DESTROYED DRUG field (#9) when using this option. It will now allow for the user's name to be filed for this field without having to assign additional security keys. RESOLUTION ---------- Routine PSAOUT will be modified to record the user's name in the CS Destruction file (#58.86). It will no longer look at the screen on the Pharmacist Destroyed Drug field (#9). 2. HD0000000172859 - Outdated drug list for integrated sites PROBLEM ------- The Items to Be Returned Report lists all entries under one division. RESOLUTION ---------- PSAOUT routine will be modified to display a list of available sites for selection of pharmacy location during drug entry in the Outdated Medications option. This will allow for outdated medication to be entered under a particular pharmacy location. The Items to be Returned Report will now also be printed by pharmacy location, which will be displayed in the header. 3. HD0000000184524 NDC changed from numbers to letters PROBLEM ------- When an invoice line item contains a null value for the NDC, the Drug Accountability application uses the VSN # to attempt to match to the correct drug. The .01 field of the drug's SYNONYM that contains the VSN # is then used to populate the NDC field for that synonym. Synonyms created through the Drug Accountability application will have the NDC in the .01 field of the synonym. There may exists some DA type synonyms that the site has entered manually that contain alpha characters in the .01 field. This results in the NDC field populated with drug names, etc. RESOLUTION ---------- Routine PSABRKU6 will be modified to check the SYNONYM field #.01 of the SYNONYM sub-file #50.1 of the DRUG file #50 for alpha numerics. If the value in that field is not all numeric, the NDC CODE field 2 of the SYNONYM sub-file will be checked against the NDC field #31 of the DRUG file #50 for a match. If there is no match, the user will be forced to enter the correct NDC during invoice processing. HD0000000222558 - Supply item match to drug file PROBLEM ------- When an invoice that contains supply items is processed and supply item names are entered that contain leading numerics (i.e. 60 dram vials), the PRE Verify and POST Verify Variance reports reference the leading number as a drug IEN and incorrectly display the NDC from the corresponding drug file entry as the "OLD NDC" on the PRE and POST Verify reports. RESOLUTION ---------- PSAPROC7 routine will be modified to not create the PRE Verify or the POST Verify Variance Reports when a supply item name begins a number. 5. HD0000000229658 - Outdated Medications PROBLEM ------- The Outdated Medications [PSA OUTDATED MEDICATIONS] option does not display all possible matches for a drug if the DRUG file #50 index "C" is a match to the information entered at the "Scan Drug barcode or enter a drug name" prompt. RESOLUTION ---------- Routine PSAOUT will be modified to look up any drug that may have multiple entries in the "NDC" and "C" indexes of the DRUG file #50. It will also allow users to look up a drug with a partial drug name. INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. The installation may be queued. Install Time - less than 5 minutes 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*68): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*68. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//', answer NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 7 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSABRKU6 Before: B64278664 After: B72265371 **26,48,68** Routine Name: PSAOUT Before: B52860925 After: B72887272 **51,64,68** Routine Name: PSAPROC7 Before: B56573649 After: B57726362 **3,12,27,21,42,61,64,67,68** Routine list of preceding patches: 48, 67 ============================================================================= User Information: Entered By : CROSSMAN,PAM Date Entered : JAN 17, 2008 Completed By: WERNER,GARY Date Completed: SEP 02, 2008 Released By : VECE,VIRGINIA Date Released : SEP 03, 2008 ============================================================================= ============================================================================= Run Date: APR 07, 2009 Designation: PSA*3*70 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #54 Status: Released Compliance Date: MAY 08, 2009 ============================================================================= Associated patches: (v)PSA*3*42 <<= must be installed BEFORE `PSA*3*70' (v)PSA*3*60 <<= must be installed BEFORE `PSA*3*70' (v)PSA*3*63 <<= must be installed BEFORE `PSA*3*70' (v)PSA*3*64 <<= must be installed BEFORE `PSA*3*70' (v)PSA*3*68 <<= must be installed BEFORE `PSA*3*70' Subject: UNDEFINED ERRORS, OUTDATED MEDS RPT, INCORRECT COST CALCULATION Category: - Routine Description: ============ This patch addresses the following problems: 1. HD0000000257764 - UNDEF ERROR When editing the ORDER UNIT for a Supply Item of a verified order, the application errors with an undefined error. 2. HD0000000255967 - UNDEF ERROR EDIT1+36^PSAUTL1 During Order Processing, if 2 users attempt to edit the same order at the same time, the application will error. 3. HD0000000266899 - When running the Outdated Medications [PSA OUTDATED MEDICATIONS] report and the user quits unexpectedly to exit, the ^TMP("PSA",$J global is left behind causing the All Location Dispense/Purge [PSA IV ALL LOCATIONS]option to error. 4. HD0000000265183 - When an invoice contains a blank Order Unit and a zero quantity, it appears on an error report. When this error condition occurs, all supply items that follow are included in the error report. 5. HD0000000273421 - The cost on the Items To Be Returned report should be calculated based on the number of Dispense Units returned multiplied by Price Per Dispense Unit from the DRUG file (#50). Instead, it is multiplying the number of containers by the Price Per Dispense Unit. ASSOCIATED REMEDY TICKETS: ========================== 1. HD0000000257764 - UNDEF ERROR 2. HD0000000255967 - UNDEF ERROR EDIT1+36^PSAUTL1 Duplicate: HD0000000255975 - INVOICE+4^PSAPROC7 3. HD0000000266899 - Error when running PSA IV ALL LOCATIONS 4. HD0000000265183 - Blank Order Unit on zero qty received causes supplies to appear on error report 5. HD0000000273421 - Cost Calculated Incorrectly on Outdated Meds ASSOCIATED NSR(s): ================== N/A PARTICIPATING TEST SITES: ========================= Bronx, NY Chillicothe, OH Palo Alto, CA REMEDY OVERVIEW: ================ 1. HD0000000257764 - UNDEF ERROR PROBLEM ======= When editing the ORDER UNIT for a Supply Item of a verified order, the application errors with an undefined error. RESOLUTION ========== PSAVER3 routine will be modified to test for the PSAERR variable within the supply item section and quit that section if PSAERR & PSASUP variables contain a value other than 0. 2. HD0000000255967 - UNDEF ERROR EDIT1+36^PSAUTL1 PROBLEM ======= During Order Processing, if 2 users attempt to edit the same order at the same time, the application will error. RESOLUTION ========== PSAPROC8 routine will be modified to set the ^XTMP("PSAPVL" global with the ^XTMP("PSAPV",psacrtl# and the users DUZ. This will be used to indicate that the invoice is currently being processed by another user. Routines PSAPROC1 & PSAPROC2 will be modified to call PSAPROC8 to verify that no other user is processing the invoice. If the invoice is currently being processed, the user will received a message identifying who is processing that invoice. 3. HD0000000266899 - Error when running PSA IV ALL LOCATIONS PROBLEM ======= When running the Outdated Medications [PSA OUTDATED MEDICATIONS] report and the user quits unexpectedly to exit, the ^TMP("PSA",$J global is left behind causing the All Location Dispense/Purge [PSA IV ALL LOCATIONS] option to error. The error is caused when the $J value left behind in the ^TMP("PSA",$J global from the failed Outdated Medications [PSA OUTDATED MEDICATIONS] report and is used as the IEN for PHARMACY LOCATION field (#.01) of the DRUG ACCOUNTABILITY STATS file (#58.8). RESOLUTION ========== PSAOP3 routine will be modified to test the validity of the value returned by the PHARMACY LOCATION field (#.01) of the DRUG ACCOUNTABILITY STATS file (#58.8) lookup while looping through the ^XTMP("PSA" global. If the lookup returns a false value, the loop will quit that iteration. Routines PSAOUT will also be modified to use ^XTMP("PSAOUT" instead of ^XTMP("PSA". 4. HD0000000265183 - Blank Order Unit on zero qty received causes supplies to appear on error report PROBLEM ======= When an invoice contains a blank Order Unit and a zero quantity, it appears on an error report. When this error condition occurs, all supply items that follow are included in the error report. RESOLUTION ========== PSAVER3 routine will be modified to check for the PSASUP & PSAERR variables within the SUPPLY section. If both of these variables exist, the routine will quit and continue on with the next line item. 5. HD0000000273421 - Cost Calculated Incorrectly on Outdated Meds PROBLEM ======= The cost on the Items To Be Returned report should be calculated based on the number of Dispense Units returned multiplied by Price Per Dispense Unit from the DRUG file (#50). Instead, it is multiplying the number of containers by the Price Per Dispense Unit. RESOLUTION ========== PSAOUT routine will be modified to use the number of Dispense Units returned by the Price Per Dispense Unit. INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*70): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*70. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//', answer NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 12 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAOP3 Before: B2157207 After: B2325842 **21,70** Routine Name: PSAOUT Before: B72887272 After: B73425251 **51,64,68,70** Routine Name: PSAPROC Before: B76150646 After: B77154032 **3,12,21,70** Routine Name: PSAPROC1 Before: B40487833 After: B41172320 **12,21,50,60,70** Routine Name: PSAPROC2 Before: B70245487 After: B71381092 **34,50,70** Routine Name: PSAPROC8 Before: B42624373 After: B67886786 **3,64,70** Routine Name: PSAVER3 Before: B71438317 After: B72006337 **3,19,21,64,70** Routine Name: PSAVERA Before: B44372640 After: B44615569 **21,36,40,53,63,70** Routine Name: PSAVERA1 Before: B59601347 After: B60705765 **21,61,63,70** Routine Name: PSAVERA3 Before: B8881546 After: B13969445 **21,42,70** Routine list of preceding patches: 42, 60, 63, 68 ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : AUG 06, 2008 Completed By: SESSLER,APRIL Date Completed: MAR 13, 2009 Released By : WASHINGTON,JANET P Date Released : APR 07, 2009 ============================================================================= ============================================================================= Run Date: JUL 06, 2009 Designation: PSA*3*69 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #55 Status: Released Compliance Date: AUG 06, 2009 ============================================================================= Associated patches: (v)PSA*3*15 <<= must be installed BEFORE `PSA*3*69' Subject: FY08-Q4 ENHANCEMENTS Category: - Enhancement (Mandatory) - Routine - Data Dictionary - Other Description: ============ The FY08 Q4 Enhancement Release includes the following enhancement in the Drug Accountability V. 3.0 application. A new module is being added to the Drug Accountability application to address one of the findings in the GAO Report GAO-04-755 dated July 2004 related to implementing a better control over Return Drug Credits. The new module is called Return Drug Credit Menu and contains the following 4 options. 1 Batch Work List [PSA RET DRG BATCH WORKLIST] 2 Batch Complete List [PSA RET DRG BAT COMPLETE LIST] 3 View/Update Batch [PSA RET DRG VIEW/UPDATE BATCH] 4 Return Drug Credit Report [PSA RET DRG REPORT] The Batch Work List [PSA RET DRG BATCH WORKLIST] option will be used to process open return batches, which are assigned a status of either 'AWAITING PICKUP' or 'PICKED UP'. The Batch Complete List [PSA RET DRG BAT COMPLETE LIST] option allows users to access and update batches with any status. The View/Update Batch [PSA RET DRG VIEW/UPDATE BATCH] option is used for single batch processing, independent of its status. The Return Drug Credit Report [PSA RET DRG REPORT] option provides the users with summary and detailed reports of all return batches. Security Keys: ------------- In order to have access to the new options, a user must have the PSORPH or PSARET security key. The PSORPH key is an existing key in the Outpatient Pharmacy V. 7.0 application. The PSARET key is a new security key in the Drug Accountability application that will be transported in this patch and should be assigned to users who will be responsible for returning drugs to the contractor. New Files: --------- The following two new files are being added to the Drug Accountability V. 3.0 application to support the functionality delivered by this patch. UP SEND DATA USER DATE SEC. COMES SITE RSLV OVER FILE # FILE NAME DD CODE W/FILE DATA PTRS RIDE -------------------------------------------------------------------- 58.35 RETURN DRUG YES YES NO 58.36 RETURN DRUG CONTRACTOR YES YES NO The RETURN DRUG file (#58.35) is used to store all the information about drugs being returned to the manufacturer while the RETURN DRUG CONTRACTOR file (#58.36) is used to store the list of contractors that the VA Medical Center (VAMC) uses for returning drugs for credit. Most likely there will be only one contractor active at a time for most, if not all, VAMCs. Associated Patient Safety Issues: ================================= N/A Associated New Service Request (NSR): ===================================== N/A Associated Remedy Tickets: ========================== N/A Test Sites: =========== DURHAM, NC MONTANA HCS NEW JERSEY HCS OKLAHOMA CITY, OK PUGET SOUND HCS Documentation Retrieval: ======================== Sites may retrieve documentation in one of the following ways: (1) The preferred method is to FTP the files from download.vista.med.va.gov, which will transmit the files from the first available FTP server. (2) Sites may also elect to retrieve documentation directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov The documentation distribution includes: FILE NAMES DESCRIPTION ========== ============ PSA_3_UM_R0509.pdf Drug Accountability V. 3.0 User Manual PSA_3_TM_R0509.pdf Drug Accountability V. 3.0 Technical Manual/Security Guide PSA_3_P69_TM_CP.pdf Drug Accountability V. 3.0 Technical Manual/Security Guide Change pages PSA_3_P69_RN.pdf Drug Accountability/Inventory Interface V. 3.0 Release Notes (3) Once released, documentation may be retrieved from VISTA Documentation Library (VDL) on the Internet at the following address, http://www.va.gov/vdl Installation Instructions: ========================== Installation will take less than 5 minutes. Note: After the patch has been installed, please assign the PSARET security key to the appropriate personnel. The installation may be queued if desired. Suggested time to install: non-peak requirement hours 1. Use the INSTALL/CHECK MESSAGE option in the PackMan function. 2. From the Kernel Installation & Distribution System Option, select the Installation Option. 3. From this option, you may select to use the following items: (when prompted for INSTALL NAME, enter PSA*3.0*69). a. Backup a Transport Global - this option will create a backup message of any routines exported with the 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 the patch is installed. It compares all components of the patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - this option will ensure the integrity of the routines that are in the transport global. 4. Use the Install Package(s) option and select the package PSA*3.0*69. 5. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES//" respond YES unless your system does this in a nightly TaskMan process. 6. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//" respond NO. 7. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" respond NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAHIS1 Before: B38528696 After: B40519187 **3,69** Routine Name: PSANDCUT Before: n/a After: B5415723 *69* Routine Name: PSARDCBA Before: n/a After:B209116804 *69* Routine Name: PSARDCBL Before: n/a After: B49662167 *69* Routine Name: PSARDCIT Before: n/a After: B55946073 **69** Routine Name: PSARDCRD Before: n/a After: B55308953 **69** Routine Name: PSARDCRP Before: n/a After: B6160079 **69** Routine Name: PSARDCRS Before: n/a After: B61210107 **69** Routine Name: PSARDCU1 Before: n/a After: B95984942 *69* Routine Name: PSARDCUT Before: n/a After: B94123614 *69* ============================================================================= User Information: Entered By : ANWER,MOHAMED Date Entered : JUN 06, 2008 Completed By: GREER,MIKE Date Completed: JUN 23, 2009 Released By : VECE,VIRGINIA Date Released : JUL 06, 2009 ============================================================================= ============================================================================= Run Date: JAN 28, 2010 Designation: PSA*3*72 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #56 Status: Released Compliance Date: FEB 28, 2010 ============================================================================= Associated patches: (v)PSA*3*69 <<= must be installed BEFORE `PSA*3*72' Subject: FIX DRUG HISTORY REPORT AND PATCH PSA*3*69 LINE 2 CORRECTIONS Category: - Routine Description: ============ This patch addresses the following 2 problems: 1. The Drug Transaction History [PSA DRUG DISPLAY] report is not correctly calculating the drug balance for dispensed drugs. Currently the report is adding the dispensed quantity instead of deducting it. 2. When PSA*3*69 was released, there were five new routines introduced. The format of the second line of those routines does not meet the Standards and Conventions guidelines. ASSOCIATED NSR(S): =================== N/A ASSOCIATED REMEDY TICKETS: ========================== 1. HD0000000342000 - Dispensed units not automatically subtracting from inventory Duplicate: ----------- HD0000000339593 - Dispensed drugs not subtracted but added to daily inventory 2. HD0000000335328 - Routine patch list needs editing PARTICIPATING TEST SITES: ========================= Ann Arbor VAMC Manila OPC Maryland HCS Spokane VAMC REMEDY OVERVIEW: ================ 1. HD000000342000 - Dispensed units not automatically subtracting from inventory PROBLEM ======= The Drug Transaction History [PSA DRUG DISPLAY] report is not correctly calculating the drug balance for dispensed drugs. Currently the report is adding the dispensed quantity instead of deducting it. The logic used to calculate the balance has a typo in the syntax which is causing the program to add the dispensed amount. RESOLUTION ========== The typo in routine that creates the Drug Transaction History report will be corrected so it subtracts the dispensed units from the balance rather than adding it. 2. HD0000000335328 - Routine patch list needs editing PROBLEM ======= When PSA*3*69 was released, there were five new routines introduced. The format of the second line of those routines does not meet the Standards and Conventions guidelines of 2 asterisks (**) before and after the patch number. These 5 routines currently have only 1 asterisk (*) before and after the patch number. RESOLUTION ========== The single leading and trailing asterisk (*) of the patch number in the second line of PSANDCUT, PSARDCBA, PSARDCBL, PSARDCU1 and PSARDCUT routines will be replaced with **. This will bring these routines in alignment with the Standards and Conventions guidelines. Because this is just an update to a comment section and no code has been changed, the post-install checksum values should match the pre-install checksum values. Note: During the Installation Compare if the user selects the "Second line of Routines only" compare option, they will receive the following warning message, '*** WARNING, you are missing one or more Patches ***'. This is due to the previous version that used a single leading and trailing * for the patch version. TECHNICAL ========= 1. HD0000000342000 - Dispensed units not automatically subtracting from inventory PSAHIS1 routine will be modified at TRANS+11 to include opening and closing parenthesis within the $Select statement that sets the PSABAL variable. Before: I $P(PSATR0,"^",2)'=24 S PSABAL=$S(",1,10,11,19,"[","_$P(PSATR0,"^",2) _",":PSABAL+$P(PSATR0,"^",6),1:PSABAL-$P(PSATR0,"^",6)) After: I $P(PSATR0,"^",2)'=24 S PSABAL=$S(",1,10,11,19,"[(","_$P(PSATR0,"^",2) _","):PSABAL+$P(PSATR0,"^",6),1:PSABAL-$P(PSATR0,"^",6)) 2. HD0000000335328 - Routine patch list needs editing The patch number in line 2 of PSANDCUT, PSARDCBA, PSARDCBL, PSARDCU1 and PSARDCUT routines will be modified to meet SAC guidelines of 2 asterisks (**) leading and trailing the patch number. PROGRAMMING STANDARDS AND CONVENTIONS (SAC) 2.2.2 The second line of a routine must be in the following format: LABEL-optional);;version number; package name; **pm,...pn**; version date;Build n Before: PSANDCUT ;BIRM/MFR - NDC Utility ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;*69*;10/24/97;Build 9 PSARDCBA ;BIRM/MFR - Return Drug Batch - ListMan ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;*69*;10/24/97;Build 9 PSARDCBL ;BIRM/MHA - Return Drug Batch Work List - ListMan ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;*69*;10/24/97;Build 9 PSARDCU1 ;BIRM/MFR - Return Drug - Utilities (Cont.) ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;*69*;10/24/97;Build 9 PSARDCUT ;BIRM/MFR - Return Drug - Utilities ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;*69*;10/24/97;Build 9 After: PSANDCUT ;BIRM/MFR - NDC Utility ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**69,72**;10/24/97;Build 1 PSARDCBA ;BIRM/MFR - Return Drug Batch - ListMan ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**69,72**;10/24/97;Build 1 PSARDCBL ;BIRM/MHA - Return Drug Batch Work List - ListMan ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**69,72**;10/24/97;Build 1 PSARDCU1 ;BIRM/MFR - Return Drug - Utilities (Cont.) ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**69,72**;10/24/97;Build 1 PSARDCUT ;BIRM/MFR - Return Drug - Utilities ;07/01/08 ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**69,72**;10/24/97;Build 1 INSTALLATION INSTRUCTIONS ========================= Suggested time to install: non-peak requirement hours. The patch should be installed when NO Drug Accountability users are on the system. Install Time - less than 5 minutes (unless otherwise indicated) 1. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation --- 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 2. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter PSA*3.0*72): 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 DD's 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, DD's, 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. Use the Install Package(s) option and select the package PSA*3.0*72. a. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. b. When prompted 'Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//', answer NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0; DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAHIS1 Before: B40519187 After: B41022189 **3,69,72** Routine Name: PSANDCUT Before: B5415723 After: B5415723 **69,72** Routine Name: PSARDCBA Before:B209116804 After:B209116804 **69,72** Routine Name: PSARDCBL Before: B49662167 After: B49662167 **69,72** Routine Name: PSARDCU1 Before: B95984942 After: B95984942 **69,72** Routine Name: PSARDCUT Before: B94123614 After: B94123614 **69,72** Routine list of preceding patches: 69 ============================================================================= User Information: Entered By : SMITH,ROBERT J Date Entered : AUG 12, 2009 Completed By: WERNER,GARY Date Completed: JAN 28, 2010 Released By : VECE,VIRGINIA Date Released : JAN 28, 2010 =============================================================================