Troubleshoot QCMM Entitlement and Scheduled Task Health

Troubleshoot QCMM Entitlement Revalidation task health, authoritative Basic results, bounded communication grace, exit-code meaning, and Super User repair behavior.

Healthy Structure Is Required Above Basic

QCMM requires the Entitlement Revalidation task plugin to be installed, enabled, and present on disk, Joomla Scheduled Tasks to be available, exactly one canonical Entitlement Revalidation task to be enabled, and its cadence to be no slower than every 60 minutes. A missing, disabled, unpublished, duplicated, or too-slow task forces effective access to Basic until health is restored.

Check the Status Card First

The QCMM Status tab reports plugin state, number of published canonical tasks, validation cadence, last execution, last exit code, next execution, and detected issues. An overdue next execution points to the Joomla scheduler runner even when the task row itself is structurally correct.

Do Not Treat Authoritative Basic as a Task Failure

The 2.0.21 task treats a completed authoritative response as a successful scheduler execution even when QuantaCade resolves the entitlement to Basic, invalid, or expired. Exit code 5 is reserved for incomplete/local execution faults. Historical assumptions that any Basic/invalid result should produce exit code 5 are therefore wrong for current QCMM.

Communication Failure Has Bounded Continuity

A temporary entitlement-server communication failure can retain a previously confirmed paid or preview entitlement only inside QCMM's bounded 24-hour grace window, and never beyond a known preview/access expiration. Authoritative Basic/invalid/expired results do not receive transport grace merely because an older premium cache exists.

Repair Actions

A Super User can use Repair Entitlement Task when repair is possible. Repair enables the plugin, creates the canonical task if missing, restores its identity/publication and hourly execution rules, and disables duplicate candidate tasks while keeping the lowest-ID canonical task enabled. Missing plugin registration/files require reinstalling the current package.

Community Discussion

Want to compare QCMM workflows or share practical tips? Visit the QC Memberships & Meetings Community. For private support, bug reports, account-specific entitlement or billing problems, or feature requests, use the QuantaCade support system.