$TXT Created by MONOSKY,ALAN at CINP.FO-BIRM.MED.VA.GOV  (KIDS) on Thursday, 07/14/16 at 15:36
=============================================================================
Run Date: JUL 14, 2016                     Designation: PX*1*216
Package : PX - PCE PATIENT CARE ENCOUNTER     Priority: Mandatory
Version : 1                                     Status: Under Development
=============================================================================

Associated patches: (v)PX*1*197    <<= must be installed BEFORE `PX*1*216'
                    (u)PX*1*215    <<= must be installed BEFORE `PX*1*216'

Subject: PCE IMMUNIZATION ENHANCEMENTS - INCREMENT 4

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

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

 The Veterans Health Information Systems and Technology Architecture
 (VistA) Immunizations Enhancements (VIMM) 2.0 project, Increment 4, builds
 upon the file structures and standardized data introduced in Increments 1,
 2 and 3 by adding functional enhancements to the existing VistA Patient
 Care Encounter (PCE) package.
  
 This patch provides the following new features:
  
 1) This patch introduces a new file, V IMMUNIZATION DELETED (#9000080.11),
    that will contain entries that were deleted out of the V IMMUNIZATION
    file (#9000010.11). Immediately prior to deleting an entry from the V
    IMMUNIZATION file, a copy of the record will be made and filed to the V
    IMMUNIZATION DELETED file. The date/time of deletion and the user that
    deleted the record will be recorded.
  
 2) This patch creates Remote Procedure Calls (RPCs) for use by the
    Enterprise Health Management Platform (eHMP) project, the Computerized
    Patient Record System (CPRS) software and others. These RPCs retrieve
    skin test information from the following files:
    - V SKIN TEST (#9000010.12)
    - SKIN TEST (#9999999.28) 
    - IMM ADMINISTRATION SITE (BODY) (#920.3)
  
 3) This patch created an RPC to retrieve immunization data from the V
    IMMUNIZATION (#9000010.11) file. This data will be used in the future
    to retrieve patient immunization data and transmit it, using the Health
    Level 7 (HL7) standard protocol, to external agencies (e.g., State
    Immunization Information Registries). As part of this effort, a new
    option will be introduced with this patch, Accounting Of Immunization
    Disclosures Report [PXV IMM DISCLOSURE REPORT], that can be run from
    the PCE Coordinator Menu [PX PCE COORDINATOR MENU]. This option can be
    used to generate a list of immunization records transmitted to external
    agencies. This option allows for a date range selection as well as one,
    multiple or all agencies and one, multiple or all patients.
  
 4) Previously, auditing has been turned on for all fields of the V 
    IMMUNIZATION (#9000010.11) file. This patch adds additional safe guards
    to ensure that auditing is not turned off and that the data audits
    cannot be purged for the V IMMUNIZATION file.
  
 5) The existing immunization inventory functionality is updated to 
    include multi-divisional features:
     - Inventory items may be linked to an associated facility.
     - Inventory reports are facility specific 
    
 6) The immunization entry process is updated to require the entry of 
    Dose, Dose Units, Route of Administration and Site of Administration. 
    (Note: If route is ORAL, site is not required.)
    
 7) The PX SAVE DATA remote procedure call (RPC) has been modified to 
    provide support for the following fields in the V SKIN TEST file
    (#9000010.12):
     - READER (#.07)
     - ORDERING PROVIDER (#1202)
     - ANATOMIC LOCATION OF PLACEMENT (#1212)
     - READING COMMENTS (#1301)
    
 8) The functionality for the Health Summary component PCE IMMUNIZATIONS
    (IM) is modified to ignore time and occurrence limits, basically
    restoring pre-patch PX*1*210 behavior.
  
 9) This patch provides an alert whenever specific allergy-type 
    contraindications are recorded as a reason for not giving an
    immunization in the V IMM CONTRA/REFUSAL EVENTS file (#9000010.707).
    The specific allergy subset consists of: LATEX ALLERGY, SEVERE ALLERGY
    EGGS, SEVERE NEOMYCIN ALLERGY, SEVERE POLYMYXIN B ALLERGY, SEVERE
    REACTION PREVIOUS DOSE, and SEVERE STREPTOMYCIN ALLERGY. The alert text
    reads: "You have recorded an allergy/adverse reaction contraindication
    reason. This information should also be recorded in the Adverse
    Reaction Tracking package if it is not already present there."
  
 10) This patch creates Remote Procedure Calls (RPCs) for use by the
     Enterprise Health Management Platform (eHMP) project and the
     Computerized Patient Record System (CPRS) software to support Clinical
     Decision Support (CDS) by making calls to the Immunization Calculation
     Engine (ICE) server. ICE server definitions are stored in a new file,
     PX ICE WEB SERVER (#920.75). 
     
     NOTE: The ICE associated functionality will not be available until the
     implementation of CPRS Graphical User Interface (GUI) v32.
     
  
 Patch Components:
 -----------------
  
 APIs Associated:
  
 API                                   New/Modified/Deleted
 -----------                           --------------------
 VSKIN^PXPXRM (ICR #4250)              Modified              
  
  
 Files & Fields Associated:
  
 File Name (Number)      Field Name (Number)           New/Modified/Deleted
 ------------------      -------------------           --------------------
 IMM EXTERNAL AGENCY     AGENCY NAME (#.01)                   New
 (#920.71)
  
 PX ICE WEB SERVER       NAME (#.01)                          New
 (#920.75)               PROTOCOL (#1)                        New
                         SERVER (#2)                          New
                         PORT (#3)                            New
                         SERVICE NAME (#4)                    New
                         VERSION (#5)                         New
                         SUFFIX (#6)                          New
                         METHOD (#7)                          New
                         URL (#8) [Computed]                  New
  
 V IMMUNIZATION          IMMUNIZATION (#.01)                Modified
 (#9000010.11)           EVENT DATE AND TIME                Modified
                            (#1201)
                         DATE/TIME RECORDED                 Modified
                            (#1205)
                         TIMESTAMP (#1221)                    New
                         EVENT INFORMATION                  Modified
                            SOURCE (#1301)
                         DISCLOSED TO (multiple               New
                            (field #820, sub-file
                            #9000010.1182)
                         AGENCY (#.01) of the                 New
                            DISCLOSED TO sub-file
                            (#9000010.1182)
                         DISCLOSURE DATE/TIME                 New
                            (#.02) of the       
                            DISCLOSED TO sub-file 
                            (#9000010.1182)
  
 IMMUNIZATION LOT        LOT NUMBER (#.01)                  Modified
 (#9999999.41)           MANUFACTURER (#.02)                Modified
                         VACCINE (#.04)                     Modified
                         ASSOCIATED VA FACILITY               New
                            (#.1)
  
 V IMMUNIZATION
 DELETED (#9000080.11)   IMMUNIZATION (#.01)                  New
                         PATIENT NAME (#.02)                  New
                         VISIT (#.03)                         New
                         SERIES (#.04)                        New
                         LOT (#.05) )                         New
                         REACTION (#.06)                      New
                         CONTRAINDICATED (#.07)               New
                         DOSE OVERRIDE (#.08)                 New
                         INJECTION SITE (#.09)                New
                         VOLUME (#.11)                        New
                         DATE OF VAC INFO STATEMENT (#.12)    New
                         CREATED BY V CPT ENTRY (#.13)        New
                         VAC ELIGIBILITY (#.14)               New
                         IMPORT FROM OUTSIDE REGISTRY         New
                            (#.15)
                         NDC (#.16)                           New
                         ADMINISTRATIVE NOTES (#1)            New
                         VIS OFFERED/GIVEN TO PATIENT
                            (multiple field #2, sub-file 
                            #9000080.112)                     New
                         VIS OFFERED/GIVEN TO PATIENT 
                            (#.01) of the VIS OFFERED/GIVEN 
                            TO PATIENT sub-file 
                            (#9000080.112)                    New
                         DATE VIS OFFERED/GIVEN (#.02) of 
                            the VIS OFFERED/GIVEN TO PATIENT
                            sub-file (#9000080.112)           New
                         OTHER DIAGNOSIS (multiple field #3,
                            sub-file #9000080.113)            New
                         OTHER DIAGNOSIS (#.01) of the
                            OTHER DIAGNOSIS sub-file 
                            (#9000080.113)                    New
                         REMARKS (#1101)                      New
                         EVENT DATE AND TIME (#1201)          New
                         ORDERING PROVIDER (#1202)            New
                         CLINIC (#1203)                       New
                         ENCOUNTER PROVIDER (#1204)           New
                         DATE/TIME RECORDED (#1205)           New
                         IMMUNIZATION DOCUMENTER (#1206)      New
                         LOT NUMBER (#1207)                   New
                         PARENT (#1208)                       New
                         EXTERNAL KEY (#1209)                 New
                         OUTSIDE PROVIDER NAME (#1210)        New
                         ANCILLARY POV (#1213)                New
                         USER LAST UPDATE (#1214)             New
                         ORDERING LOCATION (#1215)            New
                         DATE/TIME ENTERED (#1216)            New
                         ENTERED BY (#1217)                   New
                         DATE/TIME LAST MODIFIED (#1218)      New
                         LAST MODIFIED BY (#1219)             New
                         WARNING ACKNOWLEDGED (#1220)         New
                         EVENT INFORMATION SOURCE (#1301)     New
                         ROUTE OF ADMINISTRATION (#1302)      New
                         SITE OF ADMINISTRATION (BODY) 
                            (#1303)                           New
                         PRIMARY DIAGNOSIS (#1304)            New
                         DOSE (#1312)                         New
                         DOSAGE (#1312.5)                     New
                         DOSE UNITS (#1313)                   New
                         SNOMED CT (multiple field #2601,
                            sub-file #9000080.1126)           New
                         SNOMED CT (#.01) of the SNOMED CT
                            sub-file (#9000080.1126)          New
                         SNOMED PREFERRED TERM (#.019) of
                            the SNOMED CT sub-file 
                            (#9000080.1126)                   New
                         LOINC CODES (multiple field #2701,
                            sub-file #9000080.1127)           New
                         LOINC CODES (#.01) of the LOINC
                            CODES sub-file (#9000080.1127)    New
                         LOINC TEXT (#.019) of the LOINC 
                            CODES sub-file (#9000080.1127)    New 
                         RESULTS (#1401)                      New
                         READING (#1402)                      New
                         DATE/TIME READ (#1403)               New
                         READER (#1404)                       New
                         READING RECORDED (#1405)             New
                         HOURS READ POST-INOCULATION
                            (#1406)                           New
                         READING COMMENT (#1501)              New
                         WARNING OVERRIDE REASON
                            (#1601)                           New
                         EDITED FLAG (#80101)                 New
                         AUDIT TRAIL (#80102)                 New
                         COMMENTS (#81101)                    New
                         VERIFIED (#81201)                    New
                         PACKAGE (#81202)                     New
                         DATA SOURCE (#81203)                 New
                         DISCLOSED TO (multiple               New
                            (field #820, sub-file
                            #9000080.1182)
                         AGENCY (#.01) of the                 New
                            DISCLOSED TO sub-file
                            (#9000080.1182)
                         DISCLOSURE DATE/TIME                 New
                            (#.02) of the       
                            DISCLOSED TO sub-file 
                            (#9000080.1182)
                         DELETED BY (#88001)                  New
                         DATE/TIME DELETED (#88002)           New
  
  
 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 IMM DISCLOSURE REPORT        Run Routine     New
  
  
 Parameters Associated:
  
 Parameter Definition Name        New/Modified/Deleted
 -------------------------        --------------------
 PX ICE WEB DEFAULT SERVER        New
 PXV SK DAYS BACK                 New
  
  
 Protocols Associated:
  
 Protocol Name        New/Modified/Deleted
 -------------        --------------------
  
  
 RPCs Associated:
  
 RPC                      New/Modified/Deleted
 -------------            --------------------
 PXVIMM IMM DETAILED      Modified
 PXVIMM IMM DISCLOSURE    New
 PXVIMM VIMM DATA         New
 PXVSK DEF SITES          New
 PXVSK SKIN SHORT LIST    New
 PXVSK V SKIN TEST LIST   New
 PX ICE WEB               New
 PX SAVE DATA             Modified
  
  
 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):
 -----------------------------
 N/A 
  
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 N/A
  
  
 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.med.va.gov.
 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:                 fo-albany.med.va.gov
 Hines:                  fo-hines.med.va.gov    
 Salt Lake City:         fo-slc.med.va.gov
    
 Documentation can also be found on the VA Software Documentation Library 
 at:
 http://www4.va.gov/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
  
  
 Patch Installation:
  
 Pre/Post Installation Overview:
 -------------------------------
 The pre-installation process deletes the trigger cross-reference from the
 EVENT DATE AND TIME (#1201) field of the V IMMUNIZATION (#9000010.11)
 file. The trigger will be moved to the IMMUNIZATION (#.01) field. The
 trigger sets the DATE/TIME RECORDED (#1205) field.
  
 The post-installation process sets a node in the V IMMUNIZATION data
 dictionary (DD) that prevents a user from being able to purge data audits
 for the V IMMUNIZATION file.
  
  
 Pre-Installation Instructions:
 ------------------------------
 N/A
  
  
 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
 less than 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*216):
     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*216.
  
 5.  When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of 
     Install? YES//'
     Answer NO.
  
 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 4

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

Routine Name: PXAPIDEL
    Before: B56745766   After: B57912132  **1,9,22,130,168,197,216**
Routine Name: PXCEVFI1
    Before: B23924796   After: B71158821  **23,73,112,136,143,124,184,
                                           185,210,215,216**
Routine Name: PXKFIMM
    Before:  B4427968   After:  B5574555  **22,124,201,209,210,215,216**
Routine Name: PXKMAIN
    Before: B55417967   After: B56711884  **22,59,73,88,69,117,130,124,
                                           174,164,210,215,216**
Routine Name: PXKMAIN1
    Before: B41644781   After: B56560479  **22,73,124,178,210,216**
Routine Name: PXPXRM
    Before: B88904295   After:B156738878  **119,199,210,215,216**
Routine Name: PXRHS03
    Before: B56157465   After: B59630785  **13,210,216**
Routine Name: PXRPC
    Before:B109684381   After:B167038742  **200,209,210,215,216**
Routine Name: PXVDIS
    Before:       n/a   After: B48092848  **216**
Routine Name: PXVEDIT
    Before:  B3872063   After: B16872011  **210,216**
Routine Name: PXVINV
    Before: B25607408   After: B28488077  **210,216**
Routine Name: PXVP216
    Before:       n/a   After:  B1234583  **216**
Routine Name: PXVRPC4
    Before:       n/a   After:B131727625  **215,216**
Routine Name: PXVRPC7
    Before:       n/a   After:B131688794  **216**
Routine Name: PXVRPC7A
    Before:       n/a   After: B60762590  **216**
Routine Name: PXVRPC8
    Before:       n/a   After: B30970984  **216**
Routine Name: PXVRPC9
    Before:       n/a   After:  B7189011  **216**
Routine Name: PXVWEXTR
    Before:       n/a   After: B38471794  **216**
Routine Name: PXVWICE
    Before:       n/a   After:B136323304  **216**
Routine Name: PXVWPXRM
    Before:       n/a   After: B33864886  **216**
Routine Name: PXVWSOAP
    Before:       n/a   After: B83872774  **216**
Routine Name: PXVWUTIL
    Before:       n/a   After:B151126755  **216**
Routine Name: PXVWVMR
    Before:       n/a   After:B197782155  **216**
Routine Name: PXVWXML1
    Before:       n/a   After: B66315918  **216**
Routine Name: PXVWXMLL
    Before:       n/a   After:B113235733  **216**
Routine Name: PXVXR
    Before: B13167191   After: B20307149  **210,216**
Routine Name: PXVZRT
    Before: B71159926   After: B84727294  **206,215,216**
 
Routine list of preceding patches: 197, 215

=============================================================================
User Information:
Entered By  : MONOSKY,ALAN                  Date Entered  : APR 21, 2016
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


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

$END TXT
