Clinical Quality Language Specification
2.0.0-ballot - R2 STU 1 (Ballot)

Clinical Quality Language Specification, published by Clinical Decision Support WG. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cql/ and changes regularly. See the Directory of published versions

## : CQL Message Codes - XML Representation

Page standards status: Trial-use | Maturity Level: 2

Raw xml | Download

    <CodeSystem xmlns="http://hl7.org/fhir">
      <id value="cql-message-codes"/>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem cql-message-codes</b></p><a name="cql-message-codes"> </a><a name="hccql-message-codes"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td><td><b>Value Set</b></td></tr><tr><td>Category</td><td>category</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#category</td><td>code</td><td>The language area, possible values are codes in the [CQL Message Category Codes](CodeSystem-cql-message-category-codes.html) code system</td><td><a href="ValueSet-cql-message-category.html">CQL Message Category</a></td></tr><tr><td>Severity</td><td>severity</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#severity</td><td>code</td><td>Severity of the issue, possible values are codes in the [CQL Message Severity Codes](CodeSystem-cql-message-severity-codes.html) code system</td><td><a href="ValueSet-cql-message-severity.html">CQL Message Severity</a></td></tr><tr><td>Source</td><td>source</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#source</td><td>code</td><td>The source of the issue, providing information about where the issue is originating and how it might be addressed, possible values are codes in the [CQL Message Source Codes](CodeSystem-cql-message-source-codes.html) code system</td><td><a href="ValueSet-cql-message-source.html">CQL Message Source</a></td></tr><tr><td>Example Message</td><td>example</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#example</td><td>string</td><td>An example message providing a sample of what kinds of actual messages will be returned with this code.</td><td/></tr><tr><td>Notes</td><td>notes</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#notes</td><td>string</td><td>Notes about the message, especially how to address the issue being identified</td><td/></tr><tr><td>Specification Link</td><td>spec-link</td><td>http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#spec-link</td><td>string</td><td>A URL to the point in the specification where this message is defined</td><td/></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://cql.hl7.org/CodeSystem/cql-message-codes</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>Category</b></td><td><b>Severity</b></td><td><b>Source</b></td><td><b>Example Message</b></td><td><b>Notes</b></td><td><b>Specification Link</b></td></tr><tr><td style="white-space:nowrap">000-00000<a name="cql-message-codes-000-00000"> </a></td><td>Internal</td><td>Internal translator error</td><td>compile-time</td><td>error</td><td>content</td><td>Internal translator error</td><td>This message code typically indicates an unexpected error was encountered while attempting to compile CQL.</td><td>20-m-messages.html#messages</td></tr><tr><td style="white-space:nowrap">001-00000<a name="cql-message-codes-001-00000"> </a></td><td>Lexical</td><td>Lexical error</td><td>lexical</td><td>error</td><td>content</td><td>Lexical error</td><td>This is a general message code for lexical errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it.</td><td>20-m-messages.html#messages</td></tr><tr><td style="white-space:nowrap">002-00000<a name="cql-message-codes-002-00000"> </a></td><td>Syntax</td><td>Syntax error</td><td>syntax</td><td>error</td><td>content</td><td>Syntax error</td><td>This is a general message code for syntax errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it.</td><td>20-m-messages.html#messages</td></tr><tr><td style="white-space:nowrap">003-00000<a name="cql-message-codes-003-00000"> </a></td><td>Semantic</td><td>Semantic error</td><td>semantic</td><td>error</td><td>content</td><td>Semantic error</td><td>This is a general message code for semantic errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it.</td><td>20-m-messages.html#messages</td></tr><tr><td style="white-space:nowrap">003-10000<a name="cql-message-codes-003-10000"> </a></td><td>Conditional expression resulted in a choice type</td><td>Indicates that a conditional expression resulted in a choice type when none of the branches of the conditional were choice types. This can indicate a mistake and should be reviewed.</td><td>semantic</td><td>warning</td><td>content</td><td>Conditional expression resulted in a choice type `Choice&lt;Boolean, List&lt;Integer&gt;`</td><td>This message may be suppressed with the @suppressWarning tag</td><td>03-developersguide.html#type-inference-of-conditional-expressions</td></tr><tr><td style="white-space:nowrap">100-00000<a name="cql-message-codes-100-00000"> </a></td><td>Run-time</td><td>Runtime error</td><td>run-time</td><td>error</td><td>content</td><td>Run-time error</td><td>This is a general message code for run-time errors encountered while attempting to evaluate CQL. The actual message will typically contain more detailed information about the issue and how to address it.</td><td>20-m-messages.html#messages</td></tr></table></div>
      </text>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
        <valueCode value="cds"/>
      </extension>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
        <valueCode value="trial-use"/>
      </extension>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
        <valueInteger value="2"/>
      </extension>
      <url value="http://cql.hl7.org/CodeSystem/cql-message-codes"/>
      <version value="2.0.0-ballot"/>
      <name value="CQLMessageCodes"/>
      <title value="CQL Message Codes"/>
      <status value="active"/>
      <experimental value="false"/>
      <date value="2025-10-24T16:45:25+00:00"/>
      <publisher value="Clinical Decision Support WG"/>
      <contact>
        <telecom>
          <system value="url"/>
          <value value="http://www.hl7.org/Special/committees/dss/index.cfm"/>
        </telecom>
      </contact>
      <description
                   value="Codes for messages returned by applications that process Clinical Quality Language, whether as part of authoring or evaluating. This code system is intended to be a place to identify codes for messages that are indicated by the specification itself. Implementation-specific, application-specific, and content-specific codes may be provided with codes from other code systems, but should ideally map to some code (possibly a more general code) in this code system."/>
      <caseSensitive value="true"/>
      <valueSet value="http://cql.hl7.org/ValueSet/cql-message-code"/>
      <content value="complete"/>
      <property>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/codesystem-property-valueset">
          <valueCanonical
                          value="http://cql.hl7.org/ValueSet/cql-message-category"/>
        </extension>
        <code value="category"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#category"/>
        <description
                     value="The language area, possible values are codes in the [CQL Message Category Codes](CodeSystem-cql-message-category-codes.html) code system"/>
        <type value="code"/>
      </property>
      <property>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/codesystem-property-valueset">
          <valueCanonical
                          value="http://cql.hl7.org/ValueSet/cql-message-severity"/>
        </extension>
        <code value="severity"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#severity"/>
        <description
                     value="Severity of the issue, possible values are codes in the [CQL Message Severity Codes](CodeSystem-cql-message-severity-codes.html) code system"/>
        <type value="code"/>
      </property>
      <property>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/codesystem-property-valueset">
          <valueCanonical value="http://cql.hl7.org/ValueSet/cql-message-source"/>
        </extension>
        <code value="source"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#source"/>
        <description
                     value="The source of the issue, providing information about where the issue is originating and how it might be addressed, possible values are codes in the [CQL Message Source Codes](CodeSystem-cql-message-source-codes.html) code system"/>
        <type value="code"/>
      </property>
      <property>
        <code value="example"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#example"/>
        <description
                     value="An example message providing a sample of what kinds of actual messages will be returned with this code."/>
        <type value="string"/>
      </property>
      <property>
        <code value="notes"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#notes"/>
        <description
                     value="Notes about the message, especially how to address the issue being identified"/>
        <type value="string"/>
      </property>
      <property>
        <code value="spec-link"/>
        <uri
             value="http://cql.hl7.org/CodeSystem/cql-message-characteristic-codes#spec-link"/>
        <description
                     value="A URL to the point in the specification where this message is defined"/>
        <type value="string"/>
      </property>
      <concept>
        <code value="000-00000"/>
        <display value="Internal"/>
        <definition value="Internal translator error"/>
        <property>
          <code value="category"/>
          <valueCode value="compile-time"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="error"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString value="Internal translator error"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This message code typically indicates an unexpected error was encountered while attempting to compile CQL."/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString value="20-m-messages.html#messages"/>
        </property>
      </concept>
      <concept>
        <code value="001-00000"/>
        <display value="Lexical"/>
        <definition value="Lexical error"/>
        <property>
          <code value="category"/>
          <valueCode value="lexical"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="error"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString value="Lexical error"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This is a general message code for lexical errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it."/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString value="20-m-messages.html#messages"/>
        </property>
      </concept>
      <concept>
        <code value="002-00000"/>
        <display value="Syntax"/>
        <definition value="Syntax error"/>
        <property>
          <code value="category"/>
          <valueCode value="syntax"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="error"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString value="Syntax error"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This is a general message code for syntax errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it."/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString value="20-m-messages.html#messages"/>
        </property>
      </concept>
      <concept>
        <code value="003-00000"/>
        <display value="Semantic"/>
        <definition value="Semantic error"/>
        <property>
          <code value="category"/>
          <valueCode value="semantic"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="error"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString value="Semantic error"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This is a general message code for semantic errors encountered while processing CQL. The actual message will typically contain more detailed information about the issue and how to address it."/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString value="20-m-messages.html#messages"/>
        </property>
      </concept>
      <concept>
        <code value="003-10000"/>
        <display value="Conditional expression resulted in a choice type"/>
        <definition
                    value="Indicates that a conditional expression resulted in a choice type when none of the branches of the conditional were choice types. This can indicate a mistake and should be reviewed."/>
        <property>
          <code value="category"/>
          <valueCode value="semantic"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="warning"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString
                       value="Conditional expression resulted in a choice type `Choice&lt;Boolean, List&lt;Integer&gt;`"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This message may be suppressed with the @suppressWarning tag"/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString
                       value="03-developersguide.html#type-inference-of-conditional-expressions"/>
        </property>
      </concept>
      <concept>
        <code value="100-00000"/>
        <display value="Run-time"/>
        <definition value="Runtime error"/>
        <property>
          <code value="category"/>
          <valueCode value="run-time"/>
        </property>
        <property>
          <code value="severity"/>
          <valueCode value="error"/>
        </property>
        <property>
          <code value="source"/>
          <valueCode value="content"/>
        </property>
        <property>
          <code value="example"/>
          <valueString value="Run-time error"/>
        </property>
        <property>
          <code value="notes"/>
          <valueString
                       value="This is a general message code for run-time errors encountered while attempting to evaluate CQL. The actual message will typically contain more detailed information about the issue and how to address it."/>
        </property>
        <property>
          <code value="spec-link"/>
          <valueString value="20-m-messages.html#messages"/>
        </property>
      </concept>
    </CodeSystem>