Problems Loading or Using Grammars

When a grammar fails to load or activate, the logs are the fastest path to the cause. Grammar load failures are written to the Media Server log, each as a negative result code paired with a descriptive error string. If you are not seeing enough detail, raise the log verbosity and reproduce the problem so the full error string is captured.

The codes below identify the distinct failure classes you are most likely to encounter. Each entry explains what triggered the error and how to resolve it.

Syntax and compilation

  • -23 LV_GRAMMAR_SYNTAX_WARNING — A non-fatal syntax issue that did not prevent the grammar from compiling. Open the grammar in the Grammar Tester to see the specific warning.
  • -24 LV_GRAMMAR_SYNTAX_ERROR — A syntax error that prevented the grammar from compiling. Use the Grammar Tester to locate and correct it.
  • -25 LV_GRAMMAR_LOADING_ERROR — A generic load failure. Confirm the speech engine is running and that the grammar is valid and reachable.

Licensing and capacity limits

  • -33 LV_ACTIVE_GRAMMAR_VOCAB_SIZE_EXCEEDS_LIMIT — Tier 1 and Tier 2 licenses cap the total number of words allowed across all simultaneously active grammars. Either reduce the active vocabulary or move to a Tier 3 (or higher) license. Contact Technical Support or your account manager for details on licensing limits.
  • -41 LV_LICENSES_EXPIRED — Your software maintenance has expired, so the version of the ASR you are attempting to use is no longer licensed. Renew maintenance to restore access.

Language and acoustic models

  • -35 LV_ACTIVE_GRAMMAR_LANGUAGE_CONFLICT — More than one language is specified across your active grammars. The ASR can only use one language at a time, so ensure all active grammars share a single language.
  • -36 LV_ACTIVE_GRAMMAR_INVALID_LANGUAGE — A grammar specifies a language whose acoustic model is not installed, or for which no acoustic model exists. Install the required language model, or correct the language declared in the grammar.

Load timeouts and activation

  • -37 LV_LOAD_GRAMMAR_TIMEOUT — The grammar load exceeded the timeout configured in client_property.conf (default 20 seconds). Only the largest and most complex grammars should trigger this; if it recurs, consider using precompiled grammars to avoid repeated compilation cost.
  • -44 LV_INVALID_GRAMMAR_LABEL — When activating a grammar, the label you specified does not match any loaded grammar. Verify that the activation label exactly matches the label the grammar was loaded under.

For codes that point to a grammar's contents — syntax warnings and errors in particular — the Grammar Tester in the Deployment Portal is the quickest way to reproduce the failure and pinpoint the offending line. It parses a grammar against the platform's ASR engine and reports warnings and errors directly. See the Portal Help Guide for a walkthrough.

Related Articles


Was this article helpful?