Quality Measure Implementation Guide
2.0.0-ballot - STU 2 Ballot

Quality Measure Implementation Guide - Downloaded Version null See the Directory of published versions

## Library: PVS Component Library (Experimental)

Official URL: http://hl7.org/fhir/uv/cqm/Library/PVSComponent | Version: 0.0.001 | Highlight text changes?
Standards status: Informative Active as of 2026-04-07 | Computable Name: PVSComponent
Other Identifiers: OID:2.16.840.1.113883.4.642.40.61.28.30

Pneumococcal Vaccination Status for Older Adults

Metadata
Title | PVS Component Library
Version | 0.0.001
Identifier | urn:oid:2.16.840.1.113883.4.642.40.61.28.30
Experimental | true
Jurisdiction | 001 from http://unstats.un.org/unsd/methods/m49/m49.htm
Steward (Publisher) | HL7 International / Clinical Quality Information
Description | Pneumococcal Vaccination Status for Older Adults
Type | logic-library from http://terminology.hl7.org/CodeSystem/library-type
Dependency | Description: Library FHIRHelpers Resource: http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1 Canonical URL: `http://hl7.org/fhir/uv/cql/Library/FHIRHelpers|4.0.1`
Dependency | Description: Library SDE Resource: Supplemental Data Elementsversion: null2.0.000) Canonical URL: `http://hl7.org/fhir/uv/cqm/Library/SupplementalDataElements|2.0.000`
Dependency | Description: Library Global Resource: MAT Global Common Functions FHIR Libraryversion: null5.0.000) Canonical URL: `http://hl7.org/fhir/uv/cqm/Library/MATGlobalCommonFunctions|5.0.000`
Dependency | Description: Library Hospice Resource: Hospice FHIR Libraryversion: null2.0.000) Canonical URL: `http://hl7.org/fhir/uv/cqm/Library/Hospice|2.0.000`
Dependency | Description: Code System LOINC Resource: Logical Observation Identifiers, Names and Codes (LOINC) Canonical URL: `http://loinc.org`
Dependency | Description: Value Set Annual Wellness Visit Resource: Annual Wellness Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.526.3.1240`
Dependency | Description: Value Set Care Services in Long-Term Residential Facility Resource: Care Services in Long Term Residential Facility Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1014`
Dependency | Description: Value Set Discharge Services - Nursing Facility Resource: Discharge Services Nursing Facility Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.11.1065`
Dependency | Description: Value Set Discharged to Health Care Facility for Hospice Care Resource: Discharged to Health Care Facility for Hospice Care Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.207`
Dependency | Description: Value Set Discharged to Home for Hospice Care Resource: Discharged to Home for Hospice Care Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.209`
Dependency | Description: Value Set Encounter Inpatient Resource: Encounter Inpatient Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307`
Dependency | Description: Value Set Home Healthcare Services Resource: Home Healthcare Services Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1016`
Dependency | Description: Value Set Hospice care ambulatory Resource: Hospice Care Ambulatory Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1108.15`
Dependency | Description: Value Set Nursing Facility Visit Resource: Nursing Facility Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1012`
Dependency | Description: Value Set Office Visit Resource: Office Visit Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1001`
Dependency | Description: Value Set Pneumococcal Vaccine Resource: Pneumococcal Vaccine Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.110.12.1027`
Dependency | Description: Value Set Pneumococcal Vaccine Administered Resource: Pneumococcal Vaccine Administered Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.110.12.1034`
Dependency | Description: Value Set Preventive Care Services - Established Office Visit, 18 and Up Resource: Preventive Care Services Established Office Visit, 18 and Up Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1025`
Dependency | Description: Value Set Preventive Care Services-Initial Office Visit, 18 and Up Resource: Preventive Care Services Initial Office Visit, 18 and Up Canonical URL: `http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1023`
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Office Visit
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Annual Wellness Visit
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Preventive Care Services Established Office Visit, 18 and Up
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Preventive Care Services Initial Office Visit, 18 and Up
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Home Healthcare Services
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Discharge Services Nursing Facility
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Nursing Facility Visit
Data Requirement | Type: Encounter Profile(s): Encounter Code Filter(s): Path: type ValueSet: Care Services in Long Term Residential Facility
Data Requirement | Type: Immunization Profile(s): Immunization Code Filter(s): Path: vaccineCode ValueSet: Pneumococcal Vaccine
Data Requirement | Type: Procedure Profile(s): Procedure Code Filter(s): Path: code ValueSet: Pneumococcal Vaccine Administered
Parameters
Name | Use | Card. | Type | Documentation
Measurement Period | In | 0..1 | Period |
Patient | Out | 0..1 | Patient |
SDE Ethnicity | Out | 0..* | Coding |
SDE Payer | Out | 0..* | Resource |
SDE Race | Out | 0..* | Coding |
SDE Sex | Out | 0..1 | Coding |
Qualifying Encounters | Out | 0..* | Encounter |
Initial Population | Out | 0..1 | boolean |
Denominator | Out | 0..1 | boolean |
Denominator Exclusions | Out | 0..1 | boolean |
Numerator | Out | 0..1 | boolean |
Library Content
CQL Content |
    /*
    This example is a work in progress and should not be considered a final specification
    or recommendation for guidance. This example will help guide and direct the process
    of finding conventions and usage patterns that meet the needs of the various stakeholders
    in the measure development community.
    */
    library PVSComponent version '0.0.001'

    using FHIR version '4.0.1'

    include hl7.fhir.uv.cql.FHIRHelpers version '4.0.1' called FHIRHelpers

    include SupplementalDataElements version '2.0.000' called SDE
    include MATGlobalCommonFunctions version '5.0.000' called Global
    include Hospice version '2.0.000' called Hospice

    codesystem "LOINC": 'http://loinc.org'

    valueset "Annual Wellness Visit": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.526.3.1240'
    valueset "Care Services in Long-Term Residential Facility": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1014'
    valueset "Discharge Services - Nursing Facility": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.11.1065'
    valueset "Discharged to Health Care Facility for Hospice Care": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.207'
    valueset "Discharged to Home for Hospice Care": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.117.1.7.1.209'
    valueset "Encounter Inpatient": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.666.5.307'
    valueset "Home Healthcare Services": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1016'
    valueset "Hospice care ambulatory": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1108.15'
    valueset "Nursing Facility Visit": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1012'
    valueset "Office Visit": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1001'
    valueset "Pneumococcal Vaccine": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.110.12.1027'
    valueset "Pneumococcal Vaccine Administered": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.110.12.1034'
    valueset "Preventive Care Services - Established Office Visit, 18 and Up": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1025'
    valueset "Preventive Care Services-Initial Office Visit, 18 and Up": 'http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.3.464.1003.101.12.1023'

    code "Birth date": '21112-8' from "LOINC" display 'Birth date'

    parameter "Measurement Period" Interval<DateTime>

    context Patient

    define "SDE Ethnicity":
      SDE."SDE Ethnicity"

    define "SDE Payer":
      SDE."SDE Payer"

    define "SDE Race":
      SDE."SDE Race"

    define "SDE Sex":
      SDE."SDE Sex"

    define "Initial Population":
      Global."CalendarAgeInYearsAt" ( FHIRHelpers.ToDate ( Patient.birthDate ), start of "Measurement Period" ) >= 65
          and exists "Qualifying Encounters"

    define "Qualifying Encounters":
      ( [Encounter: "Office Visit"]
          union [Encounter: "Annual Wellness Visit"]
          union [Encounter: "Preventive Care Services - Established Office Visit, 18 and Up"]
          union [Encounter: "Preventive Care Services-Initial Office Visit, 18 and Up"]
          union [Encounter: "Home Healthcare Services"]
          union [Encounter: "Discharge Services - Nursing Facility"]
          union [Encounter: "Nursing Facility Visit"]
          union [Encounter: "Care Services in Long-Term Residential Facility"] ) ValidEncounter
          where ValidEncounter.period during "Measurement Period"
            and ValidEncounter.status = 'finished'

    define "Denominator":
      "Initial Population"

    define "Denominator Exclusions":
      Hospice."Has Hospice"

    define "Numerator":
      exists ( [Immunization: "Pneumococcal Vaccine"] PneumococcalVaccine
            where PneumococcalVaccine.status = 'completed'
              and PneumococcalVaccine.occurrence as dateTime on or before
              end of "Measurement Period"
        )
          or exists ( [Procedure: "Pneumococcal Vaccine Administered"] PneumococcalVaccineGiven
              where PneumococcalVaccineGiven.status = 'completed'
                and PneumococcalVaccineGiven.performed as Period on or before
                end of "Measurement Period"
          )
ELM XML Content |
    Encoded data
ELM JSON Content |
    Encoded data
Generated using version 0.5.4 of the sample-content-ig Liquid templates