*******************************************************************************
   ORIGINAL VA PATCH TEXT FOLLOWS FOR THE PATCHES INCLUDED IN PSN 1011

*******************************************************************************
National Drug File patches
VA Patch seq # 167-170

*******************************************************************************

=============================================================================
Run Date: OCT 02, 2008                      Designation: PSN*4*182
Package : NATIONAL DRUG FILE                Priority   : MANDATORY
Version : 4 SEQ #167                        Status     : RELEASED
                         Compliance Date: OCT 09, 2008 
=============================================================================

Associated patches: (v)PSN*4*179   <<= must be installed BEFORE `PSN*4*182'


Subject:  DATA UPDATES

Category:  ROUTINE

Description:
===========



NOTE: This patch is part of NDF Data Update FY09 #1, which is comprised of two
patches, PSN*4*182 and PSN*4*183.

This patch provides updates to data in several of the files associated with the
 National Drug File (NDF) application.  This patch generates four mail 
messages.  All are sent from NDF MANAGER to members of the NDF DATA mail group,
holders of the PSNMGR security key, and the person installing the patch.  The 
first message, with the subject DATA UPDATE FOR NDF, lists new products, CMOP 
ID (if one exists), dispense units, and associated NDCs, products for which
the national formulary indicator has changed, products that have been unmatched
 from CMOP, and products for which the national formulary restriction has 
changed.  The second, with the subject UPDATED INTERACTIONS, lists interactions
 that have been added, edited, or inactivated. The third, with the subject 
DRUGS UNMATCHED FROM NATIONAL DRUG FILE, lists entries in the DRUG file (#50)
which have been unmatched from NDF.  The fourth, with the subject INTERACTIONS
and ALLERGIES UPDATED, lists interactions and allergies which have been changed
 because they were created with ingredients that are no longer primary 
ingredients.

                     **ATTENTION: CMOP SITES ONLY**

Do not load and install or queue to install this patch while Consolidated Mail
Outpatient Pharmacy (CMOP) prescriptions are being transmitted. If 
transmissions are in progress, incorrect prescription information may be sent
to the CMOP. To determine if a CMOP transmission is in progress, examine 
TaskMan for jobs entitled "CMOP Data Transmission".

Associated Remedy Tickets:
==========================
HD266046

Test Sites:
===========
Chillicothe, OH
Martinsburg, WV
North Chicago, IL
Palo Alto HCS, CA
Puget Sound HCS, WA
New York HCS
West Palm Beach, FL


Installation Instructions and Software Retrieval:
=================================================

This patch can be obtained from the ANONYMOUS.SOFTWARE directory at one of 
the OI Field Offices.  The preferred method is to FTP the file from 
DOWNLOAD.VISTA.MED.VA.GOV, which will transmit the file from the first 
available server.  Alternatively, sites may elect to retrieve the file from
a specific OI Field Office.

   OI FIELD OFFICE     FTP ADDRESS                    DIRECTORY
   Albany              FTP.FO-ALBANY.MED.VA.GOV       anonymous.software
   Hines               FTP.FO-HINES.MED.VA.GOV        anonymous.software
   Salt Lake City      FTP.FO-SLC.MED.VA.GOV          anonymous.software

The software distribution includes:

 FILE NAME             DESCRIPTION            BLOCK SIZE

NDF4P182.KID            KIDS Build           2809 blocks


National Drug File (NDF) and Pharmacy Data Management (PDM) users should be
off the system when this patch is installed.  Installation takes less than
 ten minutes.  This patch should be installed during non-peak requirement
hours.

The environment check routine for this patch checks that the installing
person is a valid user, and that the patch has not been installed.

1.  Retrieve the file NDF4P182.KID using one of the methods described
    above.

2.  From the Kernel Installation & Distribution System menu, select
    the Installation menu.

3.  From this menu, select the option Load a Distribution and select
    NDF4P182.KID.

4.  From this menu, you may choose to use the option Verify Checksums in
    Transport Global.  When prompted, select PSN*4.0*182. All components of
    this patch are new, so the option Backup a Transport Global and
    the option Compare Transport Global to Current System do not have
    to be invoked.

5.  Use the Install Package(s) option and select PSN*4.0*182.

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.

8.  Note: The environment check routine PSN182E and the post-install routine
    PSN182D will be automatically deleted from your system upon completion of
    the installation.


Routine Information:
====================


The checksums below are new checksums, and  can be checked with 
CHECK1^XTSUMBLD.

Routine Name: PSN182D
    Before:       n/a   After: B72498117  **182**
Routine Name: PSN182E
    Before:       n/a   After:   B582670  **182**


=============================================================================
User Information:
  Entered By  :   ALEXANDER,DAVID      Date Entered  :   AUG 20,2008
  Completed By:   LEONARD,KEN          Date Completed:   OCT  1,2008
  Released By :   CAMPBELL,THOMAS      Date Released :   OCT  2,2008
=============================================================================


=============================================================================
Run Date: OCT 02, 2008                      Designation: PSN*4*183
Package : NATIONAL DRUG FILE                Priority   : MANDATORY
Version : 4 SEQ #168                        Status     : RELEASED
                         Compliance Date: OCT 09, 2008 
=============================================================================

Associated patches: (v)PSN*4*182   <<= must be installed BEFORE `PSN*4*183'


Subject:  PMI UPDATES

Category:  ROUTINE
           OTHER

Description:
===========



NOTE: This patch is part of NDF Data Update FY09 #1, which is comprised of
two patches PSN*4*182 and PSN*4*183.

This patch provides updates to data in several of the files associated with
the Patient Medication Instruction Sheet (PMI) portion of the National Drug
File (NDF) application.  The seven files are:
   50.621        PMI-ENGLISH
   50.622        PMI-SPANISH
   50.623        PMI MAP-ENGLISH
   50.624        PMI MAP-SPANISH
   50.625        WARNING LABEL-ENGLISH
   50.626        WARNING LABEL-SPANISH
   50.627        WARNING LABEL MAP

The environment check routine for this patch checks to see that the installer
is a valid user.
The post-install routine for this patch deletes existing entries in these
files, loads the new data, and rematches entries in the VA PRODUCT file
(#50.68) to the proper PMIs.
The source of the data for the PMIs is First Data Bank.
Medication instruction sheets contained in this patch were created from the
First Data Bank release dated 09/03/2008.


Associated Remedy Tickets:
==========================
None

Test Sites:
===========
Chillicothe, OH
Martinsburg, WV
North Chicago, IL
Palo Alto HCS, CA
Puget Sound HCS, WA
New York HCS
West Palm Beach, FL

Installation Instructions and Software Retrieval:
=================================================

This patch can be obtained from the ANONYMOUS.SOFTWARE directory at one of
the OI Field Offices.  The preferred method is to FTP the file from 
DOWNLOAD.VISTA.MED.VA.GOV, which will transmit the file from the first
available server.  Alternatively, sites may elect to retrieve the file from
a specific OI Field Office.

   OI FIELD OFFICE     FTP ADDRESS                    DIRECTORY
   Albany              FTP.FO-ALBANY.MED.VA.GOV       anonymous.software
   Hines               FTP.FO-HINES.MED.VA.GOV        anonymous.software
   Salt Lake City      FTP.FO-SLC.MED.VA.GOV          anonymous.software

The software distribution includes:

 FILE NAME             DESCRIPTION           BLOCK SIZE

NDF4P183.KID            KIDS Build          156473 blocks


Users may remain on the system while this patch is installed.  Installation
(excluding the time required to download the file to your system) takes less
than ten minutes.  This patch should be installed during non-peak requirement
hours.  The Print a PMI Sheet [PSNPMIS PRINT], Patient Prescription Processing
[PSO LM BACKDOOR ORDERS], Release Medication [PSO RELEASE], and Reprint an
Outpatient Rx Label [PSO RXRPT] options should be placed out of order during
the installation.

1.  Retrieve the file NDF4P183.KID using one of the methods described
    above.

2.  From the Kernel Installation & Distribution System menu, select
    the Installation menu.

3.  From this menu, select the option Load a Distribution and select
    NDF4P183.KID.

4.  From this menu, you may choose to use the option Verify Checksums in
    Transport Global.  When prompted, select PSN*4.0*183. All components of
    this patch are new, so the option Backup a Transport Global and
    the option Compare Transport Global to Current System do not have
    to be invoked.

5.  Use the Install Package(s) option and select PSN*4.0*183.

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? YES//" respond YES.  Select the following options
    to disable.

           Option Name                Menu Text
           -----------------------    ------------------------------
           PSNPMIS PRINT              Print a PMI Sheet
           PSO LM BACKDOOR ORDERS     Patient Prescription Processing
           PSO RELEASE                Release Medication
           PSO RXRPT                  Reprint an Outpatient Rx Label

8.  Note:The environment check routine PSN183E and the post-install routine
    PSN183P will be automatically deleted from your system upon completion of
    the installation.


Routine Information:
====================


The checksums below are new checksums, and  can be checked with CHECK1^XTSUMBLD.

Routine Name: PSN183E
    Before:       n/a   After:   B217649  **183**
Routine Name: PSN183P
    Before:       n/a   After:  B1382786  **183**


=============================================================================
User Information:
  Entered By  :   ALEXANDER,DAVID      Date Entered  :   AUG 20,2008
  Completed By:   LEONARD,KEN          Date Completed:   OCT  1,2008
  Released By :   CAMPBELL,THOMAS      Date Released :   OCT  2,2008
=============================================================================


=============================================================================
Run Date: OCT 15, 2008                     Designation: PSN*4*176
Package : PSN - NATIONAL DRUG FILE            Priority: Mandatory
Version : 4       SEQ #169                      Status: Released
                  Compliance Date: NOV 15, 2008 
=============================================================================


Subject: UPDATE VA DRUG CLASS

Category:
  - Routine
  - Enhancement (Mandatory)
  - Other

Description:
============

 This patch creates a protocol, PSN NEW CLASS, which will be invoked during
 a  data update if any entries in the VA PRODUCT file (#50.68) have  been 
 assigned a new VA DRUG CLASS.

 The protocol will be used to update ancillary applications when a change 
 is made to the VA Drug Class assigned to a VA Product.

 The protocol also sends a message titled "Products with changed classes" to 
 holders of the PSNMGR key, members of the NDF DATA mail group, and the  
 installer of the update.

 Associated Remedy Tickets:
 ==========================
 N/A

 Associated E3Rs:
 ================
 N/A

 Associated New Service Requests (NSR):
 ======================================
 20061202

 Associated Patient Safety Issues:
 =================================
 N/A

 Test Sites:
 ===========
 Chillicothe, OH
 Martinsburg, WV
 New York HCS, NY
 North Chicago, IL
 Palo Alto HCS, CA
 Puget Sound HCS, WA

 Installation Instructions:
 ==========================

 Users may remain on the system.  Installation takes less than a minute.

 1.  Use the INSTALL/CHECK MESSAGE on the PackMan menu.

 2.  From the Kernel Installation & Distribution System menu, select
     the Installation menu.  When prompted, select PSN*4.0*176.

 3.  From this menu, you may choose to use the option Verify Checksums in
     Transport Global, Backup a Transport Global, and Compare Transport
     Global to Current System.  When prompted, select PSN*4.0*176.

 4.  Use the Install Package(s) option and select PSN*4.0*176.

 5.  When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//",
     respond NO.

 6.  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:
 ;;4.0; NATIONAL DRUG FILE;**[Patch List]**; 3O Oct 98;Build 14

The checksums below are new checksums, and  can be checked with 
CHECK1^XTSUMBLD.

Routine Name: PSNCLEAN
    Before: B35528399   After: B38230094  **117,176**
Routine Name: PSNEWCLS
    Before:       n/a   After:  B6567182  **176**
 Description of Changes:



=============================================================================
User Information:
Entered By  : ANWER,MOHAMED                 Date Entered  : JUN 06, 2008
Completed By: LEONARD,KEN                   Date Completed: OCT 09, 2008
Released By : CAMPBELL,THOMAS               Date Released : OCT 15, 2008
=============================================================================



=============================================================================
Run Date: OCT 21, 2008                      Designation: PSN*4*157
Package : NATIONAL DRUG FILE                Priority   : MANDATORY
Version : 4 SEQ #170                        Status     : RELEASED
                         Compliance Date: NOV 20, 2008 
=============================================================================

Associated patches: (v)PSN*4*109   <<= must be installed BEFORE `PSN*4*157'


Subject:  ENCAPSULATION FOLLOW-UP

Category:  ENHANCEMENT
           ROUTINE

Description:
===========

This patch enhances the functionality of two components (DIC and IX) in the 
PSNDI routine.

PSNDI is an existing API (Application Programmer Interface) for replicating 
FileMan calls.  Prior to this patch, these APIs supported these files:

         DRUG INGREDIENTS (#50.416)
         DRUG INTERACTION (#56)
         VA DRUG CLASS (#50.605)

This patch adds these two files to the supported file list.

         NDC/UPN (#50.67)
         VA GENERIC (#50.6)

Inactivation date screening logic for the standardized files (DRUG INGREDIENTS
(#50.416), VA GENERIC (#50.6), and VA DRUG CLASS (#50.605)) will now use the 
SCREEN^XTID call, which utilizes the VUID (VHA Unique
Identifier) inactivation date.  The inactivation date screening for the 
non-standardized files (NDC/UPN (#50.67) and DRUG INTERACTION (#56)) will be
based on their VistA inactivation date fields. Prior to this patch, the 
screening for the DRUG INGREDIENTS (#50.416) file was based on the VistA 
inactivation date field, and prior to this patch there was no inactivation
date screening for the VA DRUG CLASS (#50.605) file.

For further information regarding this API, please see FORUM DBIA (Data Base
Integration Agreement) 4554.

**NOTE** These APIs kill DIC("S") upon entry. If the calling application 
passes in an inactivation date using the PSNDATE parameter, the API will 
set DIC("S") by utilizing that date, and DIC("S") will remain defined after
exiting this call.


Associated Remedy Tickets:
==========================
N/A

Associated E3Rs:
================
N/A

Test Sites:
===========
DURHAM, NC
MONTANA HCS
OKLAHOMA CITY, OK

Installation Instructions:
==========================
This patch exports a routine that is a supported reference, so any other 
Vista application can make a call to this routine. For that reason, it is
recommended that this patch be installed when Vista activity is at a minimum.

Installation of this patch should take no longer than 5 minutes.

   1. Use the INSTALL/CHECK MESSAGE option on the PackMan menu to load
      the patch.

   2. From the Kernel Installation & Distribution System menu, select the
      Installation menu.

   3. From this menu, you may select to use the following options:
      (when prompted for INSTALL NAME, enter PSN*4.0*157)

       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
      PSN*4.0*157.

   5. When prompted "Want KIDS to INHIBIT LOGONs during the install?
      NO//" respond NO.

   6. When prompted "Want to DISABLE Scheduled Options, Menu Options, and
      Protocols? NO//" 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 includes:

    FILE NAME                        DESCRIPTION
    PHAR_1_API_R1008.PDF             Pharmacy Re-Engineering API Manual

   Documentation may be retrieved from VISTA Documentation Library (VDL)
   on the Internet at the following address, http://www.va.gov/vdl


Routine Information:
====================


The second line of each of these routines now looks like:
 ;;4.0; NATIONAL DRUG FILE;**[Patch List]**; 30 Oct 98;Build 9

The checksums below are new checksums, and  can be checked with 
CHECK1^XTSUMBLD.

Routine Name: PSNDI
    Before:  B7794023   After:  B9494997  **80,109,157**


=============================================================================
User Information:
  Entered By  :   VARGAS,ALBERTO       Date Entered  :   OCT 16,2007
  Completed By:   LEONARD,KEN          Date Completed:   OCT 16,2008
  Released By :   CAMPBELL,THOMAS      Date Released :   OCT 20,2008
=============================================================================



