C0Q Quality Reporting 1.0

From VistApedia
Revision as of 15:18, 21 March 2012 by RGrimm (talk | contribs) (Installation and Configuration)
Jump to: navigation, search

What is C0Q Quality Reporting?

back: VistA_Meaningful_Use_Enhancements

The C0Q Quality Reporting Package is a mumps-based addition to VistA for reporting Meaningful Use and Quality Measurements. The package supports both inpatient and outpatient reporting, and computes the Meaningful Use measures from patient records. For Quality Measurements, the reporting package relies on the VistA Reminders Patient Lists as the source for its reporting.

PQRI xml sample file


Licensing

Installing C0Q Quality Reporting

System Requirements

Infrastructure Dependencies

VistA Package Dependencies

Downloading the Software

Installation and Configuration

C0Q PACKAGE - INSTALL INSTRUCTIONS

ASSUMPTIONS:

- The install guide applies to VistA systems running on Linux/GT.M
- The install steps assume the VistA software is already installed and the environment variables/aliases are defined in your system.
- These instructions assume you are logged into VistA as a user who has access to load and install KIDS.

INSTRUCTIONS:

1. Download Build
Download the latest C0Q build bundle (kid) from WorldVistA’s trac server (e.g. C0Q_1_0_1_T16.KID):

https://trac.opensourcevista.net/browser/qrda/C0Q/trunk/kids

2. Load C0Q Module
Load the C0Q KID. From the gtm prompt, log in as user (user must have security to install KIDS) and perform the following these steps (unless otherwise specified each command should be followed by the Enter key. At times, after the Enter key is entered the system will respond with other messages as well (e.g. detailed description of a chosen menu or list of choices)):
GTM>D ^XUP     -- enter the programmer environment
Select OPTION NAME: XPD MAIN    -- enter Kernel Installation & Distribution System
Select Kernel Installation & Distribution System Option: INSTALLATION
Select Installation Option: LOAD 
Enter a Host File: /home/xxx/C0Q_x_x_x_TXX.KID  -- enter the location and the name of the file downloaded in step 1

Want to Continue with Load? YES// YES

If the load was successful the following message should be displayed. 

Loading Distribution...

   C0Q*1.0*1
Use INSTALL NAME: C0Q*1.0*1 to install this Distribution.
3. Install C0Q module
Now Install the C0Q Distribution. At the completion of the previous step you should see the following menu:
   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
          Checksum/2nd Line Lists
          Directory Listing to MailMan
          Find/Delete File in Download Directory


Select Installation Option: INSTALL
Select INSTALL NAME: C0Q*1.0*1         -- type in the name of the distribution package received in step 2
Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//  -- Hit Enter to accept the default answer
Want KIDS to INHIBIT LOGONs during the install? NO//      -- Hit Enter to accept the default answer
Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//   -- Hit Enter to accept the default answer
DEVICE: HOME//       -- Hit Enter to accept the default answer. The output messages from the install will be displayed to the terminal.

Wait until the progress bar shows complete for all the steps displayed during the install.

C0Q*1.0*1 Installed. 
               Mar xx, 20xx@0x:xx:xx
 
 No link to PACKAGE file
 
 NO Install Message sent  [1;24r [3;1H [1;1H [J [2J [H

Install Completed
Once the install is completed a summary of the distribution components, the install questions and answers and menu updates is displayed. An “Install Completed” text at the end means the install was successful.


Exit the GTM prompt and exit to the UNIX shell type H and then Enter at the GTM prompt.


C0Q PACKAGE - CONFIGURATION of MEANINGFUL USE (MU) MEASURES

ASSUMPTIONS:

- The install guide applies to VistA systems running on Linux/GT.M
- The install steps assume the VistA software is already installed and the environment variables/aliases are defined in your system.
- These instructions assume you are logged into VistA as a user who has access to configure the C0Q package.

INSTRUCTIONS:

1. Set-up MU Measure Parameters
Log into VistA (user must have access to C0Q package). From GTM prompt:
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module
     1   C0Q QUALITY MEASURE DEFINITION       QUALITY MEASURE DEFINITION
     2   C0Q QUALITY MEASUREMENT MENU       QUALITY MEASUREMENT MENU
CHOOSE 1-2: 2  C0Q QUALITY MEASUREMENT MENU     QUALITY MEASUREMENT MENU	
Select QUALITY MEASUREMENT MENU Option: SETUP QUALITY REPORTING	-- menu for C0Q set-up


          DISPLAY QUALITY MEASURES
          EDIT SUPERUSERS
          EP EDIT PARMS
          INP EDIT PARMS
          MEASURE SET EDIT
          MU MEASURE EDIT
          QUALITY MEASURE EDIT

Select SETUP QUALITY REPORTING Option: EP EDIT PARMS
Prior to building measures and measure sets, we must establish the parameters. If you’re building outpatient MU measures, “EP EDIT PARMS” should be selected (as seen above). If you’re building, inpatient MU measure, “INP EDIT PARMS” should be selected.
Select C0Q PARAMETER NAME: MU2012 Clinic Reporting	-- Enter Name of Parameter
  Are you adding 'MU2012 Clinic Reporting' as 
    a new C0Q PARAMETER (the 1ST)? No// y  (Yes)
NAME: MU2012 Clinic Reporting  Replace 
MEASUREMENT PERIOD KEY: MU12	-- Period Key groups measures and lists so easy to locate and search
PARAMETER TYPE:  OUTPATIENT		-- defines criteria for MU Measure data
EP MU MEASUREMENT SET: 		-- To be left empty for now.  Will come back to add measure set.
EP QUALITY MEASUREMENT SET: 		
Select CLINIC: DR OFFICE       DOCTOR,FOUR	--defines visit criteria.  To ONLY look for visits in a specific clinic, ward, etc.
  Are you adding 'DR OFFICE' as a new CLINIC (the 1ST for this C0Q PARAMETER)? 
No// y  (Yes)
Select CLINIC: 				-- You may add a second clinic/location if you wish
PATIENT LIST LABEL: 
Select SUBSCRIBER: 
End of MU Measure Parameter Set-up. [Enter] out of the menu until you reach the QUALITY MEASUREMENT MENU (C0Q Q menu as seen below):


2. Update MU Measures
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module

 COPY OVER PATIENT LISTS
          ED-1 COMPUTATION
          ED-2 COMPUTATION
          EP UPDATE MU MEASURES
          INP UPDATE MU MEASURES
          PQRI MENU ...
          PQRI PRINT XML
 PRINT C0Q MEASURES
          SETUP QUALITY REPORTING ...

Select QUALITY MEASUREMENT MENU Option: EP UPDATE MU MEASURES	
Jul 25, 2011@98:87:94
Jul 25, 2011@87:88:53
Jun 27, 2011@97:94:70
Jun 27, 2011@97:89:96
BAD HEALTH FACTOR: Non-Smoker (PMH)
BAD HEALTH FACTOR: Non-Tobacco User
BAD HEALTH FACTOR: Current Smoker - No
BAD HEALTH FACTOR: Current Smoker - Yes
CREATING MU12-EP-ALL-PATIENTS
CREATING MU12-EP-DR OFFICE-Patient
CREATING MU12-EP-FailedDemographics
CREATING MU12-EP-HasAllergy
If you are building Inpatient MU Measures, select INP UPDATE MU MEASURES instead of EP UPDATE MU MEASURES (as selected above). Once you select “UPDATE MU MEASURE” you should see several lines of text (a small subset of this text can be seen above). When selecting the UPDATE MU MEASURES option, the parameters for Clinics or Inpatient facilities for the Meaningful Use measures are being computed. The parameters then update the patient lists associated with the MU measures, creating new lists (lists are auto-generated for MU measures) only if none exist. They then look for MU Measurement Sets that are in the parameters, and update them, copying over numerator and denominator patient lists, counting them, and computing the percentage. A final update should be performed to ensure the most up-to date data is reported for your MU measure/measure set (see step 6).


3. Create MU Measures
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module
     1   C0Q QUALITY MEASURE DEFINITION       QUALITY MEASURE DEFINITION
     2   C0Q QUALITY MEASUREMENT MENU       QUALITY MEASUREMENT MENU
CHOOSE 1-2: 2  C0Q QUALITY MEASUREMENT MENU     QUALITY MEASUREMENT MENU

          COPY OVER PATIENT LISTS
          ED-1 COMPUTATION
          ED-2 COMPUTATION
          EP UPDATE MU MEASURES
          INP UPDATE MU MEASURES
          PQRI MENU ...
          PQRI PRINT XML
          PRINT C0Q MEASURES
          SETUP QUALITY REPORTING ...

Select QUALITY MEASUREMENT MENU Option: SETUP QUALITY REPORTING


          DISPLAY QUALITY MEASURES
          EDIT SUPERUSERS
          EP EDIT PARMS
          INP EDIT PARMS
          MEASURE SET EDIT
          MU MEASURE EDIT
          QUALITY MEASURE EDIT

Select SETUP QUALITY REPORTING Option: MU MEASURE EDIT

Select C0Q QUALITY MEASURE NAME: MU12 Allergy			-- MU12 Allergy is name of my measure
  Are you adding 'MU12 Allergy' as a new C0Q QUALITY MEASURE (the 103RD)? No// 
y  (Yes)
   C0Q QUALITY MEASURE DISPLAY NAME: Allergy List 			-- Allergy List is my display name
NAME: MU12 Allergy// 		-- Hit Enter to accept the default answer (same as name given)
MU YEAR KEY: MU12		-- Hit Enter to accept the default answer
TITLE: 			-- Hit Enter to bypass (optional)
VERY LONG DESCRIPTION:	-- Hit Enter to bypass (optional)
  1>
DISPLAY NAME: Allergy List // 	-- Hit Enter to accept the default answer
REPORTING NAME: 		    
ALTERNATIVE NUMERATOR LIST: MU12 	-- list used as the numerator to calculate measure percentage
     1   MU12-EP-ALL-PATIENTS       MU12-EP-ALL-PATIENTS
     2   MU12-EP-DR OFFICE-Patient       MU12-EP-DR OFFICE-Patient
     3   MU12-EP-FailedDemographics       MU12-EP-FailedDemographics
     4   MU12-EP-HasAllergy       MU12-EP-HasAllergy
     5   MU12-EP-HasDemographics       MU12-EP-HasDemographics
Press <RETURN> to see more, '^' to exit this list, OR
CHOOSE 1-5: 4  MU12-EP-HasAllergy     MU12-EP-HasAllergy
ALTERNATIVE DENOMINATOR LIST: MU12	-- list used as the denominator to calculate measure percentage
     1   MU12-EP-ALL-PATIENTS       MU12-EP-ALL-PATIENTS
     2   MU12-EP-DR OFFICE-Patient       MU12-EP-DR OFFICE-Patient
     3   MU12-EP-FailedDemographics       MU12-EP-FailedDemographics
     4   MU12-EP-HasAllergy       MU12-EP-HasAllergy
     5   MU12-EP-HasDemographics       MU12-EP-HasDemographics
Press <RETURN> to see more, '^' to exit this list, OR
CHOOSE 1-5: 1  MU12-EP-ALL-PATIENTS     MU12-EP-ALL-PATIENTS

Select C0Q QUALITY MEASURE NAME: 
From year to year some MU measures may use the same numerator and dominator lists. If this applies to you, you can simply re-use and rename a measure instead of building a new measure from scratch. Also, in this example we only created one measure to be included in our MU measure set. If you would like multiple measures to be included, you would create additional measures and name accordingly. Please note: Consistent naming is crucial for keeping measures organized.


4. Create MU Measure SET and add MU Measure(s)
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module
     1   C0Q QUALITY MEASURE DEFINITION       QUALITY MEASURE DEFINITION
     2   C0Q QUALITY MEASUREMENT MENU       QUALITY MEASUREMENT MENU
CHOOSE 1-2: 2  C0Q QUALITY MEASUREMENT MENU     QUALITY MEASUREMENT MENU

          COPY OVER PATIENT LISTS
          ED-1 COMPUTATION
          ED-2 COMPUTATION
          EP UPDATE MU MEASURES
          INP UPDATE MU MEASURES
          PQRI MENU ...
          PQRI PRINT XML
          PRINT C0Q MEASURES
          SETUP QUALITY REPORTING ...

Select QUALITY MEASUREMENT MENU Option: SETUP QUALITY REPORTING
Select SETUP QUALITY REPORTING Option: MEASURE SET EDIT

Select C0Q MEASUREMENTS SET NAME: MU12 Measure Set 	-- MU12 Measure set is name of my measure set
  Are you adding 'MU12 EP Measure Set' as 
    a new C0Q MEASUREMENTS (the 10TH)? No// y  (Yes)
SET NAME: MU12 EP Measure Set// 	-- Hit Enter to accept the default answer
BEGIN DATE: 1-1-2012  (JAN 01, 2012)	-- Beginning Date of visits to be included in the measure set
END DATE: 12-31-2012  (DEC 31, 2012)	-- Ending Date of visits to be included in the measure set
LOCKED: 				-- Can Lock the Measure Set once completed
MU YEAR KEY: MU12			-- Key is same as period Key used above
Select MEASURE: MU12			-- Add the MU measures created in step 3 to create your measure set
     1   MU12 Allergy       Allergy List 
CHOOSE 1-3: 1  MU12 Allergy     Allergy List 
  Are you adding 'MU12 Allergy' as a new MEASURE (the 1ST for this C0Q MEASUREM
ENTS)? No// y  (Yes)
  NUMERATOR FILTER LIST: 
  DENOMINATOR FILTER LIST: 
Select MEASURE: 

Select C0Q MEASUREMENTS SET NAME: 
All applicable MU Measures created in Step 3 should be added to your Measure Set.


5. Link Measure Set to Parameter
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module
     1   C0Q QUALITY MEASURE DEFINITION       QUALITY MEASURE DEFINITION
     2   C0Q QUALITY MEASUREMENT MENU       QUALITY MEASUREMENT MENU
CHOOSE 1-2: 2  C0Q QUALITY MEASUREMENT MENU     QUALITY MEASUREMENT MENU

         COPY OVER PATIENT LISTS
          ED-1 COMPUTATION
          ED-2 COMPUTATION
          EP UPDATE MU MEASURES
          INP UPDATE MU MEASURES
          PQRI MENU ...
          PQRI PRINT XML
          PRINT C0Q MEASURES
          SETUP QUALITY REPORTING ...

Select QUALITY MEASUREMENT MENU Option: SET-UP QUALITY REPORTING

          DISPLAY QUALITY MEASURES
          EDIT SUPERUSERS
          EP EDIT PARMS
          INP EDIT PARMS
          MEASURE SET EDIT
          MU MEASURE EDIT
          QUALITY MEASURE EDIT

Select SETUP QUALITY REPORTING Option: EP EDIT PARMS		-- or INP EDIT PARMS depending on INP or OP
Select C0Q PARAMETER NAME: MU12  MU2012 Clinic Reporting	-- Parameter created in Step 1
NAME: MU2012 Clinic Reporting  Replace 				-- Hit Enter to accept the default answer
MEASUREMENT PERIOD KEY: MU12// 				-- Hit Enter to accept the default answer
PARAMETER TYPE: OUTPATIENT// 				-- Hit Enter to accept the default answer
EP MU MEASUREMENT SET: MU12 EP Measure Set  			-- Add MU Measure Set created in Step 5
EP QUALITY MEASUREMENT SET: 					-- Hit Enter to accept the default answer
Select CLINIC: DR OFFICE// 					-- Hit Enter to accept the default answer
PATIENT LIST LABEL: 						-- Hit Enter to accept the default answer
Select SUBSCRIBER: 						-- Hit Enter to accept the default answer

Select C0Q PARAMETER NAME:
Your MU Measure Set (which includes MU Measures and visit time frame) is now linked to your parameter. **MU MEASURE BUILD IS COMPLETE**


6. Update MU Measure(s)
Prior to printing or displaying MU Measure perform an UPDATE MU MEASURE. This will ensure we are printing or displaying the most up to date data in the system. To complete this task, follow the instructions outlined in Step 2.


7. Print C0Q Measures
GTM>D ^XUP	-- enter the programmer environment
Select OPTION NAME: COQ Q	-- enter C0Q module
     1   C0Q QUALITY MEASURE DEFINITION       QUALITY MEASURE DEFINITION
     2   C0Q QUALITY MEASUREMENT MENU       QUALITY MEASUREMENT MENU
CHOOSE 1-2: 2  C0Q QUALITY MEASUREMENT MENU     QUALITY MEASUREMENT MENU

COPY OVER PATIENT LISTS
          ED-1 COMPUTATION
          ED-2 COMPUTATION
          EP UPDATE MU MEASURES
          INP UPDATE MU MEASURES
          PQRI MENU ...
          PQRI PRINT XML
          PRINT C0Q MEASURES
          SETUP QUALITY REPORTING ...

Select QUALITY MEASUREMENT MENU Option: Print C0Q MEASURES
Select C0Q MEASUREMENTS SET NAME: MU12 EP Measure Set  

DEVICE:   TELNET
C0Q MEASUREMENTS LIST                          MAR  7,2012  08:20    PAGE 1
MEASURE:DISPLAY NAME      DENOMINATOR    NUMERATOR           PERCENTAGE
--------------------------------------------------------------------------------


Allergy List                      55            23             42.00
Following Build, the above steps will allow you to view (validate the build) and print the MU Measure build created.

Verifying the Installation

Contributors

Future Development