1. INSTALLATION NOTES FOR THE NATIONAL DRUG FILE V3.18 PATCH 1 ========================================================================== PREFIX: PSN CURRENT VERSION: 3.18 PATCH 1 ****NOTE****NOTE****NOTE****NOTE****NOTE****NOTE****NOTE****NOTE****NOTE** ************************************************************************** READ THE ENTIRE NOTES FILE PRIOR TO ATTEMPTING ANY INSTALLATION ************************************************************************** ***IMPORTANT*** Note: The VA National Drug File version 3.18 is year 2000 compliant. The National Drug File (NDF) software package allows pertinent information from the National Drug File to be merged into your production DRUG file (#50) This is a method of non-intrusive standardization of the production Drug File in all IHS medical facilities. ALL SITE MANAGERS MUST INFORM PHARMACY MANAGERS THAT THIS PATCH WILL BE INSTALLED AND ALL PHARMACY USERS MUST BE OFF THE SYSTEM DURING INSTALLATION!! This patch was exported using the Kernel Installations and Distribution System (KIDS) instead of the VA FileMan DIFROM utility. You will use KIDS to install this patch. If necessary, Please read the KIDS documentation located in Part 5 of the Kernel v8.0 Systems manual and familiarize yourself with KIDS before you install this patch file. This IHS patch file contains 6 VA National Drug File Patches. NOTE: INSTALLATION OF THIS PATCH COULD TAKE 1 1/2 - 2 HOURS !!!! Here are the VA Patch Names, Sequence Numbers, Subjects and Descriptions for each patch: Patch Name: PSN*3.18*1 Seq #: 1 Subject: CORRECT 'ND' NODES Description: ============ This patch contains a post installation routine that has functionality to loop through the NATIONAL DRUG file (#50.6) and delete unnecessary "ND" nodes. Also, it will update any missing "ND" nodes and corrects the corresponding "AQ1" cross references in the DRUG file (#50). Patch Name: PSN*3.18*2 Seq #: 2 Subject: ADDITIONAL VA PRODUCTS Description: ============ This patch adds three new VA products: PRECISION Q-I-D (GLUCOSE) TEST STRIP, PRECISION LINK, and PRECISION Q-I-D SENSOR,HAND HELD to the NATIONAL DRUG file (#50.6). National Drug Codes (NDCs) associated with these products are also added to the file. This patch also updates the DRUG INGREDIENTS file (#50.416) to reflect these additional products. After installation, pharmacy staff should match appropriate items in the DRUG file (#50) to these new products. Patch Name: PSN*3.18*5 Seq #: 4 Subject: NATIONAL DRUG FILE APIS Description: ============ This patch consists of a single routine PSNAPIS which contains several Application Programmer Interfaces (APIs) for the NATIONAL DRUG file (#50.6). This file is being redesigned and these APIs are intended to allow a transition to the new structure. Patch Name: PSN*3.18*8 Seq #: 5 Subject: FIX UNDEFINED IN PSNAPIS Description: ============ This patch prevents the undefined error reported in VA NOIS PHI-0998-21757 and TUA-0998-31850. Patch Name: PSN*3.18*4 Seq #: 6 Subject: MISSING VA PRODUCT NAME Description: ============ PSN*3.18*4 serves two purposes. 1. It will put back a VA Product Name in the VA PRODUCT NAMES multiple (#50.68) of NATIONAL DRUG file (#50.6) which was inadvertently missing in National Drug File (NDF) V. 3.18. It will put two entries in the DRUG INGREDIENTS file (#50.416) and will re-index the appropriate entries in files NATIONAL DRUG (#50.6), DRUG INGREDIENTS (#50.416), and DRUG INTERACTION (#56). 2. It will reset the third and fourth pieces of each multiple level in File #50.6 to prevent possible matching errors. **Please Note** Drug interactions that contain the ingredients DEXTROMETHORPHAN or GUAIFENESIN may not be checked for Drug-Drug Interactions during the installation of this patch. Patch Name: PSN*3.18*7 Seq #: 7 Subject: CHANGES TO API Description: ============ This patch consists of a single routine PSNAPIS which contains several Application Programmer Interfaces (APIs) for the NATIONAL DRUG file (#50.6). This file is being redesigned and these APIs are intended to allow a transition to the new structure. Descriptions of these APIs are contained in VA DBIAs #2531 and #2574. 1.1 GENERAL INFORMATION It is recommended that the terminal output during the installation be captured using an auxport printer attached to the terminal. This will insure a printed audit trail if any problems should arise. 1.2 CONTENTS OF DISTRIBUTION psn_0318.01n - This notes file psn_0318.01k - KIDS Installation File 1.3 REQUIREMENTS 1. Kernel v8.0 or later 2. Fileman v21 or later 3. Outpatient Pharmacy v6.0 4. National Drug File v3.18 1.4 INSTALLATION INSTRUCTIONS Before Installing All Pharmacy users should be off the system when the Install is run and, all National Drug File package activity should be idle. Journaling should be disabled on the ^PSNDF global while running the installation. See attachment 'A' for an example of how to stop journaling on your system. DUZ must be defined and DUZ(0) must be "@" before running the install. Once you begin the install, you must let it run to completion. If the install is not allowed to run to completion, you can lose certain files. INSTALLATION EXAMPLE -------------------- [prd,prd]> D ^XUP Setting up programmer environment Access Code: Terminal Type set to: C-WYSE 85 Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Edit 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 Select Installation Option: 1 Load a Distribution Enter a Host File: Directory path name/psn_0318.01k (example: /usr/spool/uucppublic/psn_0318.01k) KIDS Distribution saved on Apr 18, 2000@09:31;34 Comment: PSN V3.18 VA PATCHES 1,2,4,5,7,8 This Distribution contains Transport Globals for the following Package(s): PSN*3.18*1 PSN*3.18*2 PSN*3.18*5 PSN*3.18*8 PSN*3.18*4 PSN*3.18*7 Want to Continue with Load? YES// Loading Distribution... PSN*3.18*1 PSN*3.18*2 PSN*3.18*5 PSN*3.18*8 PSN*3.18*4 PSN*3.18*7 Use INSTALL NAME: PSN*3.18*1 to install this Distribution. 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 Select Installation Option: 6 Install Package(s) Select INSTALL NAME: PSN*3.18*1 Loaded from Distribution 4/18/00@9:35:24 => PSN V3.18 VA PATCHES 1,2,4,5,7,8 ;Created on April 18, 2000@09:31:45 This Distribution was loaded on Apr 18, 2000@09:35:24 with header of PSN V3.18 VA PATCHES 1,2,4,5,7,8 ;Created on April 18, 2000@09:31:45 It consisted of the following Installation(s): PSN*3.18*1 PSN*3.18*2 PSN*3.18*5 PSN*3.18*8 PSN*3.18*4 PSN*3.18*7 PSN*3.18*1 Install Questions for PSN*3.18*1 PSN*3.18*2 Install Questions for PSN*3.18*2 PSN*3.18*5 Install Questions for PSN*3.18*5 PSN*3.18*8 Install Questions for PSN*3.18*8 PSN*3.18*4 Install Questions for psn*3.18*4 PSN*3.18*7 Install Questions for psn*3.18*7 Want to DISABLE Scheduled Options, Menu Options, and Protocols? Load? YES// NO Enter the Device you want to print the Install messages. You can queue the install by entering a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// Install Started for PSN*3.18*1 Apr 18, 2000@09:38:04 Installing Routines:.. Apr 18, 2000@09:38:04 Running Post-Install Routine: ^PSN5ND. Updating Routine file...... Updating KIDS files...... PSN*3.18*1 Installed. Apr 18, 2000@09:38:19 Not a VA primary domain No Install Message sent. Install Started for PSN*3.18*2 Apr 18, 2000@09:38:19 Installing Routines:.. Apr 18, 2000@09:38:19 Running Post-Install Routine: ^PSN3182P. Updating Routine file...... Updating KIDS files...... PSN*3.18*2 Installed. Apr 18, 2000@09:38:19 Not a VA primary domain No Install Message sent Install Started for PSN*3.18*5 Installing Routines:.. Apr 18, 2000@09:38:20 Updating Routine file...... Updating KIDS files...... PSN*3.18*5 Installed. Apr 18, 2000@09:38:20 Not a VA primary domain No Install Message sent Install Started for PSN*3.18*8 Apr 18, 2000@09:38:20 Installing Routines:.. Apr 18, 2000@09:38:20 Updating Routine file...... Updating KIDS files...... PSN*3.18*8 Installed. Apr 18, 2000@09:38:20 Not a VA primary domain No Install Message sent Install Started for psn*3.18*4 Apr 18, 2000@09:38:20 Installing Routines:.. Apr 18, 2000@09:38:20 Running Post-Install Routine: ^PSNPCH4. Updating Routine file...... NOTE: Your system will PAUSE here for 1 1/2 to 2 hours while post routine runs!!! Updating KIDS files...... PSN*3.18*4 Installed. Apr 18, 2000@11:01:58 Not a VA primary domain No Install Message sent Install Started for psn*3.18*7 Apr 18, 2000@11:01:58 Installing Routines:.. Apr 18, 2000@11:01:58 Updating Routine file...... Updating KIDS files...... PSN*3.18*7 Installed. Apr 18, 2000@11:01:58 Not a VA primary domain No Install Message sent INSTALL COMPLETE! Note: Patch installation done!! If you disabled journaling before running the installation, you should resume journaling. See Attachment 'A'. 1.5 POINT OF CONTACT The point of contact for this package is Edgar Moore, ITSC/ASDST/Albuquerque Development Center (505) 248-4357. =========================================================================== ATTACHMENT A: ============ Journaling: HOW TO STOP AND RE-START DURING THE INSTALLATION PROCESS NOTE: Journaling Utilities may vary depending on the type of system your RPMS software is installed on! The following instruct- ions are for sites running on IBM RISC Systems. Stopping and Re-Starting journaling in a UCI involves running two different utilities (JRNL and UCIMGR). CAUTION!!! BE CAREFUL when you select these options and DO NOT modify other parameters!!! To STOP the journaling process on your system, do the following: A. Switch to your Manager UCI from your production UCI by entering the following code: 1. D ^%ZUCI 2. SWITCH TO NEW UCI You are now in PRD,IHS. Note: Your production UCI name may be different. 3. Enter new UCI: MGR You have switched to MGR,IHS B. Enter the Journal Utility: 1. [MGR,SMA]>D ^JRNL MSM - Journal Utility 18-APR-2000 9:38AM Journaling is enabled, $J=3, name=J2970827.001, block=392 #SETs(48,753), #KILLs(15,229), #TSTARTs(0), #TCOMMITs(0), #TABORTs(0) %Full=2.6 Select Journal Option: 1 - Activate (Start) Journaling 2 - Deactivate (Stop) Journaling 3 - Show (Display) Journal Spaces 4 - Configure Journaling 5 - Mark Journal Space as Reusable 6 - Switch to New Journal Space 7 - Restore (Dejournal) From Journal Space 8 - Print a Journal 9 - Cross-System Journaling Options Select Option: 2 - Deactivate (Stop) Journaling Ok to stop journaling? YES Note: Be sure to restart journaling after all Installs are done!!! C. Enter the UCI Management Utility: [MGR,SMA]>D ^UCIMGR MSM - UCI Management Utility Available Functions: 1 - Create New UCI 2 - Rename Existing UCI 3 - List UCI Status 4 - Edit UCI Parameters 5 - Delete Existing UCI 6 - User Logon Identifier Edit 7 - Edit UCI Routine Search Paths Select Option: 4 - Edit UCI Parameters Select volume group <0> : ^L Currently mounted volume groups: (0) SMA (1) DSD (2) APD (3) VAH Select volume group <0> : 3 Enter name of UCI: ^L Volume group index : 3 Volume group name : VAH UCI UCI Global Routine Rtn Exp/Data Exp/Ptr exp/ Jrnl stat/ Indx Name Directory Directory Exp Lim Exp Lim Exp Lim Pword/Lib ---- ---- --------- --------- ------- -------- ------ -------- 1 MGR 0:2 0:3 1/NONE 1/NONE 1/NONE NO//1 R G 2 VAH 0:14848 0:6656 14/NONE 30/NONE 30/NONE NO//1 R G Enter name of UCI: VAH Enter map number for global data expansion area <0:30>: Global Data Expansion Limit : Enter map number for global pointer expansion area <0:30>: Global Pointer Expansion Limit : Enter map number for routine expansion area <0:14>: Routine Expansion Limit : Journal entire UCI : NO --> Remember to re-set this field to 'YES' after patch install. Password <>: Library UCI <1>: =============================================================================