Loading

Resolving XOMOrchestrationRetryPolicyBatchJob Halts Due to Flex Queue Limits in Vlocity XOM

Publish Date: May 11, 2026
Description

In Vlocity Order Management, the XOMOrchestrationRetryPolicyBatchJob is responsible for processing integration retries. It is designed to run in a continuous cycle where the finish() method of the batch execution automatically schedules the next iteration of the job.

Administrators may observe this job halting or stopping automatically at frequent intervals. This interruption occurs when the Salesforce environment breaches the following Apex Governor Limit:

You've exceeded the limit of 100 jobs in the flex queue.

When the system hits this flex queue limit, the current job execution fails. Consequently, the finish() method cannot successfully enqueue the subsequent batch job, breaking the scheduling cycle and causing all retry job processing to stop completely.

Resolution

    To resolve this issue and prevent future occurrences, administrators should increase the interval between retry jobs to reduce the load on the flex queue, and then manually restart the stopped job.

    Step 1: Adjust the Retry Job Interval

    To prevent the flex queue from accumulating 100 jobs and breaching the governor limit, increase the time interval between job executions.

    1. Navigate to Vlocity XOM Administration (or XOM Setup).
    2. Locate the OrchestrationRetryJobIntervalMins setting.
    3. If the value is currently set to 1 (minute), increase this interval to 2 or 5 minutes. This reduces the frequency of scheduled Apex jobs, allowing the system sufficient time to clear the flex queue.

    Step 2: Restart the Batch Job

    Once the interval has been adjusted, the broken scheduling cycle must be manually reinitiated.

    1. Navigate to XOM Administration.
    2. Locate the Schedule Integration Retry Job section.
    3. Click Start to resume the retry job processing cycle.

    Step 3: Proactive Monitoring (Best Practice)

    To ensure immediate awareness if the job fails again, verify that Apex exception emails are properly configured for the organization. Salesforce sends an automated email notification whenever a batch job fails due to an unhandled exception or limit breach. If these notifications are not currently being received, administrators should configure them by following the official Salesforce guidelines for Apex Exception Email Notifications.

    Knowledge Article Number

    005321983

     
    Loading
    Salesforce Help | Article