$TXT Created by USER_EMAIL_RMVD at YOUR__SERVER.DOMAIN.EXT  (KIDS) on Monday, 03/14/16 at 17:20
=============================================================================
Run Date: MAR 14, 2016                     Designation: PX*1*215
Package : PX - PCE PATIENT CARE ENCOUNTER     Priority: Mandatory
Version : 1                                     Status: Under Development
=============================================================================

Associated patches: (v)PX*1*186    <<= must be installed BEFORE `PX*1*215'
                    (v)PX*1*195    <<= must be installed BEFORE `PX*1*215'
                    (v)PX*1*210    <<= must be installed BEFORE `PX*1*215'
                    (u)PSN*4*448   <<= must be installed BEFORE `PX*1*215'

Subject: PCE IMMUNIZATION ENHANCEMENTS - INCREMENT 3

Category: 
  - Data Dictionary
  - Enhancement (Mandatory)
  - Other
  - Routine

Description:
============

 Note: Patch PSN*4*448 must be installed before installing patch PX*1*215.
  
 The Veterans Health Information Systems and Technology Architecture
 (VistA) Immunizations Enhancements (VIMM) 2.0 project, Increment 3, builds
 upon the file structures and standardized data introduced in Increments 1
 and 2 by adding functional enhancements to the existing VistA Patient Care
 Encounter (PCE) package.
  
 This patch provides the following new features:
  
 1) This patch creates Remote Procedure Calls (RPCs) for use by the
    Enterprise Health Management Platform (eHMP) project, the 
    Computerized Patient Record System (CPRS) software, Data Access Service
    (DAS) and others. These RPCs retrieve immunization information from the
    following files:
    - VACCINE INFORMATION STATEMENT (#920)
    - IMMUNIZATION INFO SOURCE (#920.1)
    - IMM ADMINISTRATION ROUTE (#920.2)
    - IMM ADMINISTRATION SITE (BODY) (#920.3)
    - IMM CONTRAINDICATION REASONS (#920.4)
    - IMM REFUSAL REASONS (#920.5)
    - V IMM CONTRA/REFUSAL EVENTS (#9000010.707)
    - IMM MANUFACTURER (#9999999.04)
    - IMMUNIZATION (#9999999.14)
    - IMMUNIZATION LOT (#9999999.41)
  
 2) This patch introduces functionality for capturing the reason(s) an 
    immunization was not given by documenting immunization 
    contraindications and/or refusal events. This functionality includes 
    the following:
    - Creation of the V IMM CONTRA/REFUSAL EVENTS file (#9000010.707)
    - A WARNING UNTIL DATE may be stored for temporary 
    contraindications/refusals. This is the date until which the 
    contraindication/refusal is valid.
    - When an immunization for a patient is associated with valid 
    contraindications/refusals (WARNING UNTIL DATE is not a past date), 
    the software will display a warning and the user will be required to 
    acknowledge the warning and enter a justification reason before 
    continuing with administration.
  
 3) This patch inactivates the PCE CODE MAPPING file (#811.1). The file
    will still exist, but the mappings in the file will no longer be used
    to determine which related entries in the V IMMUNIZATION (#9000010.11),
    V SKIN TEST (#9000010.12), and V CPT (#9000010.18) files need to
    reflexively be recorded. From now on, the mappings in the CODING SYSTEM
    multiple of the IMMUNIZATION (#9999999.14) and SKIN TEST (#9999999.28)
    files will be used for this purpose. There are a few differences with
    this new approach:
      a) The PCE CODE MAPPING file was managed locally, while the CODING
         SYSTEM multiple of the IMMUNIZATION and SKIN TEST files are
         standardized and managed nationally. 
      b) We will now support mappings to ICD-10 codes. If an immunization
         or skin test is mapped to an ICD-10 code, when that immunization
         or skin test is documented, we will reflexively file the mapped
         ICD-10 code to the V POV file (#9000010.07). 
      c) We will stop the practice of reflexively recording an immunization
         or skin test when a corresponding CPT code is filed. The mappings
         will only be used to reflexively file the corresponding codes (CPT
         and ICD-10) when an immunization or skin test is documented.
         However, in the reverse scenario, when a CPT code is documented,
         we will not reflexively record the corresponding immunization or
         skin test.
      d) Codes will only reflexively be filed when a VA-administered
         (non-historical) immunization or skin test is documented.
  
 4) This patch includes functionality to enable a documenting provider to 
    view some immunization prompts with default values to accept and to 
    edit the responses if need be. This functionality includes:
    - Creation of the IMM DEFAULT RESPONSES file (#920.05) to store 
    facility specific default values by immunization type for ROUTE OF 
    ADMINISTRATION, SITE OF ADMINISTRATION, DOSE, DOSE UNITS, and COMMENTS.
    - Creation of the Immunization Default Responses Enter/Edit menu option
    [PXV EDIT DEFAULT RESPONSES] to allow authorized users to enter or 
    update information in the IMM DEFAULT RESPONSES file (#920.05).
  
 5) This patch updates the NDC CODE (VA) field (#.18) in the IMMUNIZATION
    LOT file (#9999999.41) so that access to information in the NDC/UPN
    file (#50.67) is controlled by application programmer interfaces
    (APIs).
    
  
 Patch Components:
 -----------------
  
  
 APIs Associated:
  
 API                                   New/Modified/Deleted
 -----------                           --------------------
 DATA2PCE^PXAPI (ICR #1889)            Modified
 GETENC^PXAPI (ICR #1894)              Modified
 ENCEVENT^PXKENC (ICR #1894)           Modified
 VICR^PXPXRM (ICR #4250)               New
 VICR^PXPXRMI1 (ICR #4519)             New
 DQSAVE^PXRPC (ICR #6386)              New
 IMMSTAT^PXAPIIM (ICR #6387)           New
  
  
 Files & Fields Associated:
  
 File Name (Number)        Field Name (Number)        New/Modified/Deleted
 ------------------        -------------------        --------------------
 IMM DEFAULT RESPONSES
    (#920.05)              FACILITY (#.01)                  New
                           IMMUNIZATION (multiple 
                              field #1, sub-file  
                              #920.051)                     New
                             IMMUNIZATION (#.01) of 
                               the IMMUNIZATION 
                               sub-file (#920.051)          New
                             ROUTE OF ADMINISTRATION
                               (#1302) of the
                               IMMUNIZATION sub-file
                               (#920.051)                   New
                             SITE OF ADMINISTRATION
                               (#1303) of the
                               IMMUNIZATION sub-file
                               (#920.051)                   New
                             DOSE (#1312) of the
                               IMMUNIZATION sub-file
                               (#920.051)                   New
                             DOSE UNITS (#1313) of the
                               IMMUNIZATION sub-file
                               (#920.051)                   New
                             COMMENTS (#81101) of the 
                               IMMUNIZATION sub-file
                               (#920.051)                   New
  
 IMM CONTRAINDICATION
    REASONS (#920.4)       CONCEPT CODING SYSTEM (#.05)   Modified
  
 IMM ROUTES TO SITES
    (#920.6)               ROUTE (#.01)                     New
                           SITES (multiple field #1, 
                              sub-file #920.61)             New
                             SITES (#.01) of the SITES 
                              sub-file (#920.61)            New
  
 V IMMUNIZATION 
    (#9000010.11)          WARNING ACKNOWLEDGED (#1220)     New
                           WARNING OVERRIDE REASON
                              (#1601)                       New
  
 V IMM CONTRA/REFUSAL 
    EVENTS (#9000010.707)  CONTRAINDICATION/REFUSAL
                              (#.01)                        New
                           PATIENT NAME (#.02)              New
                           VISIT (#.03)                     New
                           IMMUNIZATION (#.04)              New
                           WARN UNTIL DATE (#.05)           New
                           DATE/TIME RECORDED (#.06)        New
                           EVENT DATE AND TIME (#1201)      New
                           ENCOUNTER PROVIDER (#1204)       New
                           EDITED FLAG (#80101)             New
                           AUDIT TRAIL (#80102)             New
                           COMMENTS (#81101)                New
                           VERIFIED (#81201)                New
                           PACKAGE (#81202)                 New
                           DATA SOURCE (#81203)             New
  
 IMMUNIZATION LOT 
    (#9999999.41)          NDC CODE (VA) (#.18)           Modified
  
 PCE CODE MAPPING          N/A                            Modified
    (#811.1)
  
  
 Forms Associated:
  
 Form Name                    File #               New/Modified/Deleted
 ---------                    ------               --------------------
 N/A
  
  
 Mail Groups Associated:
  
 Mail Group Name          New/Modified/Deleted
 ---------------          --------------------
 N/A
  
  
 Options Associated:
  
 Option Name                      Type        New/Modified/Deleted
 -----------                      ----        -------------------- 
 PXV EDIT DEFAULT RESPONSES    Run Routine           New
 PX PCE CODE MAPPING LIST      Print               Modified
  
  
 Protocols Associated:
  
 Protocol Name        New/Modified/Deleted
 -------------        -------------------- 
 PXCE ADD/EDIT MENU       Modified
 PXCE ICR ADD               New
  
  
 RPCs Associated:
  
 RPC                 New/Modified/Deleted
 -------------       --------------------
 PX SAVE DATA             Modified
 PXVIMM ADMIN CODES          New
 PXVIMM ADMIN ROUTE          New
 PXVIMM ADMIN SITE           New
 PXVIMM ICR LIST             New
 PXVIMM IMM DETAILED         New
 PXVIMM IMM LOT              New
 PXVIMM IMM MAN              New
 PXVIMM IMM SHORT LIST       New
 PXVIMM IMMDATA              New
 PXVIMM INFO SOURCE          New
 PXVIMM VICR EVENTS          New
 PXVIMM VIS                  New
  
  
 Security Keys Associated:
  
 Security Key Name
 -----------------
 N/A
  
  
 Templates Associated:
  
 Template Name      Type      File Name (Number)  New/Modified/Deleted 
 -------------      ----      ------------------  --------------------
 N/A
  
  
 Additional Information:
 -----------------------  
 N/A 
  
  
 New Service Requests (NSRs):
 ----------------------------  
 N/A
  
  
 Patient Safety Issues (PSIs):
 -----------------------------
 PSPO #2995
 PSPO #3069
  
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 1. INC000001294271
    R4956462FY15
    R6300645FY16
    
    Related Patient Safety Issues:
    ------------------------------
    PSPO #2995
    PSPO #3069
  
    Problem:
    --------
    PCE CODE MAPPING issues are causing duplicate or incorrect entries to 
    be documented to the V IMMUNIZATION file. 
   
    Resolution:
    -----------
    The PCE CODE MAPPING file will be deprecated. Instead we will use the 
    CODING SYSTEM multiple of the IMMUNIZATION and SKIN TEST files.
  
  
 Test Sites:
 ----------
 Cleveland, OH
 Heartland-East HCS, MO
 San Antonio, TX
  
  
 Software and Documentation Retrieval Instructions:
 ---------------------------------------------------- 
 Software being released as a host file and/or documentation describing 
 the new functionality introduced by this patch are available.
  
 The preferred method is to retrieve files from download.vista.domain.ext.
 This transmits the files from the first available server. Sites may 
 also elect to retrieve files directly from a specific server. 
  
 Sites may retrieve the software and/or documentation directly using Secure
 File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the
 following OI Field Offices:
    
 Albany:                 ftpserver.domain.ext
 Hines:                  ftpserve.domain.ext    
 Salt Lake City:         ftpsrv.domain.ext
    
 Documentation can also be found on the VA Software Documentation Library 
 at:
 http://www4.domain/vdl/
  
 Title                          File Name                FTP Mode
 ------------------------------------------------------------------
 Patient Care Encounter (PCE)   PX_1_UM_R0816.PDF        (binary)
    V. 1.0 User Manual
 Patient Care Encounter (PCE)   PX_1_TM_R0816.PDF        (binary)
    V.1.0 Technical Manual
 Clinical Reminders (PXRM)      PXRM_INDEX_TM.PDF        (binary)
    Index Technical Manual
  
  
 Patch Installation:
  
 Pre/Post Installation Overview:
 -------------------------------
 The post-installation process will generate a report from the PCE CODE 
 MAPPING file (#811.1) for review. The report will contain all active
 mappings where either a) an inactive immunization was mapped to a CPT
 code; or b) a CPT code was mapped to an immunization or skin test. The
 report will be emailed to the user who installed the patch and to the mail
 group specified in the REMINDER MANAGEMENT MAILGROUP field (#3) of the 
 CLINICAL REMINDER PARAMETERS file (#800). The report will also be sent to
 the VHA National Center for Health Promotion and Disease Prevention (NCP)
 for review. If it is determined that patient charts may have been affected
 with erroneous data prior to the inactivating of the PCE CODE MAPPING file
 with this patch, the site will be contacted and instructed to submit a
 help desk ticket for resolution.
  
  
 Pre-Installation Instructions:
 ------------------------------
 Patch PSN*4*448 must be installed before installing patch PX*1*215.
  
  
 Installation Instructions:
 --------------------------
 This patch should be installed during a period of minimal system activity,
 preferably with users off the system. Installation time is expected to be
 approximately 10 minutes.
  
 1.  Choose the PackMan message containing this patch.
  
 2.  Choose the INSTALL/CHECK MESSAGE PackMan option.  
  
 3.  From the Kernel Installation and Distribution System Menu, select
     the Installation Menu. From this menu, you may elect to use the
     following options. When prompted for the INSTALL NAME enter the patch 
     # (PX*1.0*215):
     a.  Backup a Transport Global - This option will create a backup
         message of any routines exported with this patch. It will not
         backup any other changes such as DDs or templates.
     b.  Compare Transport Global to Current System - This option will
         allow you to view all changes that will be made when this patch
         is installed.  It compares all components of this patch
         (routines, DDs, templates, etc.).
     c.  Verify Checksums in Transport Global - This option will allow
         you to ensure the integrity of the routines that are in the
         transport global.
     d. Print Transport Global - This option will allow you to view the
        components of the KIDS build.
      
 4.  From the Installation Menu, select the Install Package(s) option and
     choose the patch to install. Enter PX*1.0*215.
  
 5.  When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of 
     Install? YES//'
     Answer YES.
  
 6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install?
     NO//'
     Answer NO.
  
 7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, 
     and Protocols? NO//' 
     Answer NO.
  
  
 Post-Installation Instructions:
 -------------------------------
 N/A

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;1.0;PCE PATIENT CARE ENCOUNTER;**[Patch List]**;Aug 12, 1996;Build 6

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: PXAI
    Before: B40979532   After: B42819168  **15,74,69,102,111,112,130,164,
                                           168,215**
Routine Name: PXAIICR
    Before:       n/a   After:  B5253575  **215**
Routine Name: PXAIICRV
    Before:       n/a   After: B12775865  **215**
Routine Name: PXAIIMM
    Before: B14255138   After: B16045767  **45,124,209,210,215**
Routine Name: PXAPIIM
    Before:  B2741056   After: B71572750  **210,215**
Routine Name: PXCEAE
    Before: B32867509   After: B33109650  **37,67,99,147,156,172,195,215**
Routine Name: PXCEAE1
    Before: B29168014   After: B29262597  **22,73,199,201,210,215**
Routine Name: PXCEICR
    Before:       n/a   After: B18593217  **215**
Routine Name: PXCEVFI1
    Before: B23924796   After: B31566267  **23,73,112,136,143,124,184,
                                           185,210,215**
Routine Name: PXCEVFI2
    Before: B34344095   After: B37818294  **22,73,95,96,124,158,184,215**
Routine Name: PXCEVFIL
    Before: B43615497   After: B44185519  **9,30,22,73,88,89,104,147,124,
                                           169,210,215**
Routine Name: PXCEVIMM
    Before: B83423957   After: B85247952  **27,124,199,201,210,215**
Routine Name: PXKENC
    Before: B29230371   After: B29334197  **15,22,73,108,143,183,210,215**
Routine Name: PXKFCPT1
    Before: B23838795   After: B24656697  **11,73,124,194,209,215**
Routine Name: PXKFICR
    Before:       n/a   After:  B1725753  **215**
Routine Name: PXKFIMM
    Before:  B4427968   After:  B5142444  **22,124,201,209,210,215**
Routine Name: PXKFPOV1
    Before:       n/a   After:  B9458058  **215**
Routine Name: PXKMAIN
    Before: B55417967   After: B55424847  **22,59,73,88,69,117,130,124,
                                           174,164,210,215**
Routine Name: PXKMAIN2
    Before: B10938982   After: B25599936  **69,186,215**
Routine Name: PXPXRM
    Before: B88904295   After:B119717537  **119,199,210,215**
Routine Name: PXPXRMI1
    Before: B55159505   After:B104225670  **119,194,210,215**
Routine Name: PXRPC
    Before:B109684381   After:B155861488  **200,209,210,215**
Routine Name: PXVNDC
    Before:       n/a   After:  B1277332  **215**
Routine Name: PXVP215
    Before:       n/a   After: B44574293  **215**
Routine Name: PXVRESP
    Before:       n/a   After:  B3798384  **215**
Routine Name: PXVRPC1
    Before:       n/a   After: B70359613  **215**
Routine Name: PXVRPC2
    Before:       n/a   After: B29476719  **215**
Routine Name: PXVRPC3
    Before:       n/a   After: B28618741  **215**
Routine Name: PXVRPC4
    Before:       n/a   After:B131321819  **215**
Routine Name: PXVRPC5
    Before:       n/a   After: B35105697  **215**
Routine Name: PXVUTIL
    Before: B10006565   After: B13284181  **201,210,215**
Routine Name: PXVZRT
    Before: B71159926   After: B82546869  **206,215**
 
Routine list of preceding patches: 168, 186, 195, 206, 210

=============================================================================
User Information:
Entered By  :                               Date Entered  : OCT 26, 2015
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


Packman Mail Message:
=====================

$END TXT
