Page tree
Skip to end of metadata
Go to start of metadata

CPRS Lab Monitoring
Patch OR*3.0*420
Release Notes

March 2017
Department of Veterans Affairs
Office of Information and Technology (OI&T)
.Table of Contents
1. Introduction
2. Purpose
3. Audience
4. This Release
4.1. New Features and Functions Added
4.2. Enhancements and Modifications to Existing
4.3. Known Issues
5. Product Documentation


This patch modifies the existing Pharmacy package in VistA to display the most recent associated lab results when a clinician is ordering medication using the Computerized Patient Record System (CPRS) Inpatient or Outpatient Medication Order dialogs.
This modification to VistA originated as a field-developed enhancement for local use at a VA facility. It was determined that the modification would be of benefit to the wider VistA user community, and so it is now being deployed nationally.
The following New Service Request (NSR) is resolved with this patch:

  • NSR20100311 – CPRS Lab Monitoring


The purpose of this document is to communicate changes to the VistA system resulting from implementation of OR*3.0*420.


This document targets users of the Pharmacy package in VistA and CPRS.

This Release

The following sections provide a summary of the new features and enhancements introduced by this patch, as well as any known issues.

New Features and Functions Added

This patch adds no new VistA or CPRS features.

Enhancements and Modifications to Existing

This enhancement will not work properly for multi-divisional facilities or any sites that use different lab test names at different sites, as only one lab test name can be associated with each drug. To successfully implement this solution, all facilities/divisions that share a VistA system must use the same name for each monitored lab test. If this is not feasible or desired, then do not populate lab tests in the LAB TEST MONITOR field after installing this patch.
Example: If all divisions of your facility use a single laboratory test named CREATININE, then the software will work as intended. If individual divisions use specifically named lab tests such as KAN-CREATININE and WIC-CREATININE, then do not use those lab tests with this software enhancement.
Patch OR*3.0*420 modifies the existing Pharmacy package in VistA to display the most recent associated lab results when a clinician is ordering medication using the CPRS Inpatient or Outpatient Medication Order dialogs. Without this modification, the clinician must look in numerous locations for this information. The information is important for safe and effective medication management.
The lab results for the most recent lab test associated with an Orderable Item will be displayed in the Information field in the Medication Order dialog after an Orderable Item is selected. When a dispense drug is chosen (by selecting a dosage in the order dialog), the lab test information will be replaced by the National Standard Drug Information found in the MESSAGE (#101) field of the DRUG (#50) file. This message currently shows in CPRS when ordering a dispense drug and is not changed by this modification. Note: Follow-on work to allow persistence of the lab test information in the Medication Order dialog is expected to be addressed in CPRS v32.
In order to monitor lab results, lab tests are associated with an Orderable Item using the PSS DRUG ENTER/EDIT option in VistA by entering a lab test in the LAB TEST MONITOR (#17.2) field of the DRUG (#50) file.
To apply this functionality to Quick Orders, routine ORWDPLM2 can be used as a TIU OBJECT that can be added to a Quick Order. A site may use this optionally to add to a Quick Order to allow the functionality to be added to the comment section of the order. This is done by creating the OBJECT using the TIU Document Definitions option and inserting it into the comments field of the Quick Order. Upon selection of the Quick Order in CPRS, the monitored LAB results will appear on the Ordering screen. If assistance is needed for setting up TIU Objects inside Quick Orders, contact your Clinical Application Coordinator (CAC) or refer to the TIU User Manual for instructions. Note: The TIU OBJECT method will work for generalized Quick Orders only (orders assigned to Order Menus). It is not currently implemented for personal Quick Orders.
A new KERNEL system parameter (OR CPRS LAB DISPLAY ENABLED) is added by this patch to turn the functionality On/Off. Initially, this parameter is set to OFF (NO). A Clinical Application Coordinator (CAC) or Pharmacy Automated Data Processing Application Coordinator (ADPAC) at each site will need to set this parameter to the ON value (YES) to activate this functionality at the site.
The following new routines were added to implement this enhancement:

  • ORWDPLM1 – displays LAB TEST MONITOR results for Lab tests.
  • ORWDPLM2 – TIU Object calculations and displays.

The following routine was modified to implement this enhancement:

  • ORWDPS2 – modified to call LAB TEST MONITOR results display modules in new routines ORWDPLM1 and ORWDPLM2

Known Issues


Product Documentation

Additional end-user documentation available for this patch includes:

  • CPRS Technical Manual: GUI Version – cprsguitm.pdf
  • CPRS User Guide: GUI Version – cprsguium.pdf
  • Pharmacy Data Management User Manual – pss_1_um_r0317.pdf
  • Text Integration Utility (TIU) Clinical Coordinator & User Manual – tiuum.pdf

These documents can be found in the VA Software Document Library (VDL).

  • No labels