Clean up processed and canceled message processor messages (preview)

2025-07-29

[This article is prerelease documentation and is subject to change.]

The message processor is a framework that processes messages in the system, such as those related to inventory transactions, sales orders, and more. Over time, processed and canceled messages, that are no longer needed, can accumulate in the system, potentially affecting performance and data management. Therefore, you should periodically clean up these messages to maintain system efficiency.

Important

This is a preview feature.
Preview features aren’t meant for production use and might have restricted functionality. These features are subject to supplemental terms of use, and are available before an official release so that customers can get early access and provide feedback.

Prerequisites

To use the cleanup functionality described in this article, you must be running Microsoft Dynamics 365 Supply Chain Management version 10.0.45 or later. No feature management settings are required.

Set up message cleanup for each message processor queue

You set up message cleanup using the Message queue setup page, which allows you to specify how long processed and canceled messages should be retained for each queue before they're deleted.

To configure message cleanup, follow these steps:

Go to System administration > Message processor > Message queue setup.
Follow one of these steps:
- To edit an existing queue, select Edit on the Action Pane, and then select the target queue in the grid.
- To add a new configuration, select Add on the Action Pane to add a new row to the grid. Then, in the Message queue field for the new row, select the name of the queue that you want to configure.
For the new or selected row, make the following settings:
- Number of processor tasks – Specify the number of processor tasks that should be dedicated to the specified queue. The maximum value is 8. The minimum value depends on the minimum number of batch threads that are configured for your system (typically 2). This setting isn't related to the cleanup job, but ensures that the queue can process messages efficiently.
- Days before processed message deletion – Specify the number of days to retain processed messages before deletion. To turn off processed message cleanup, set this field to 0.
- Days before canceled message deletion – Specify the number of days to retain cancelled messages before deletion. To turn off cleanup, set this field to 0.
On the Action Pane, select Save. The system automatically creates a background process to run the cleanup job. By default, the process runs daily, but you can modify this schedule in the Process automation workspace, as described in the next section.

Review and manage cleanup jobs

Whenever you have at least one message queue set to be cleaned up, the system automatically creates a background process to run the cleanup operation regularly. Follow these steps to review, schedule, and manage this process in the Process automation workspace:

Go to System administration > Setup > Process automation.
Open the Background processes tab to view the list of background processes.
Use the Filter field to search for the process that has a Name of Cleanup job for the message processor.
Select the process in the grid and then select Edit from the toolbar.
The Edit background process dialog opens. Use the settings here to view and modify the schedule and other settings for the cleanup job.
Select OK when you're done.

Optimization advisor

The Optimization advisor can remind you to manage outdated messages when they exist in the message processor. It includes a diagnostic rule called Check for aged processed or canceled messages, which identifies messages older than 30 days and creates an optimisation opportunity for them. You can take action directly from the Optimization advisor workspace. By default, this rule runs monthly.

To turn the rule on or off, or to change the frequency of the rule, follow these steps:

Go to System administration > Periodic tasks > Maintain diagnostic validation rules.
Find the row where Rule name is Check for aged processed or canceled messages.
Make the following settings for the rule as needed:
- Status – Set to Active or Inactive.
- Run frequency – Choose how often to run the check (Daily, Weekly, Monthly, or Unscheduled).

To view and act on your optimization opportunities, including those related to cleaning up aged messages, follow these steps.

Go to System administration > Workspaces > Optimization advisor. Here, you can see a list of optimization opportunities that the system has identified, including those related to message processor cleanup.
Select the row where Area is SCM and Optimization opportunity is Cleanup job for message processor.
From the toolbar, select More information to learn more about the opportunity and recommended actions.
If you want to act on the opportunity, select Take action from the toolbar to open the Message queue setup page, and configure the cleanup settings as described previously in this article.