You can set Microsoft Dynamics AX to allow debugging on an Application Object Server (AOS), or on a client that is running the .NET Business Connector or COM Business Connector. For more information about debugging code for an application that uses Business Connector, see Debugging a Business Connector Application Running Under a Non-Interactive Account.

Allow debugging on an Application Object Server instance

Note Note

This option is set in the Microsoft Dynamics AX Server Configuration Utility.


  1. Open the Server Configuration utility ( Start> Administrative Tools> Microsoft Dynamics AX Server Configuration Utility).

  2. Verify that the currently selected AOS instance and configuration are the ones you want to modify.

  3. On the Application Object Servertab, click Enable breakpoints to debug X++ code running on this server, and then click OK.

Allow debugging of a Business Connector or Client

The following options in the Microsoft Dynamics AX Configuration Utility can used to enable breakpoints for a Business Connector instance or a client:

  • Enable user breakpoints to debug code running in the Business Connector

    For sessions owned by users for whom debug is enabled within Microsoft Dynamics AX, allow X++ code running in the Business Connector to be interrupted by breakpoints

  • Enable global breakpoints to debug code running in the Business Connector or client

    For all users, allow X++ code running in the Business Connector or client to be interrupted by global breakpoints.

    Note Note

    When this option is set, you will see all breakpoints for currently active clients.


To debug Business Connector, you must set both debug options. To debug the client, set only the second option.

Enable breakpoints for a Business Connector instance

  1. Open the Configuration utility ( Start> Control Panel> Administrative Tools> Microsoft Dynamics AX Configuration Utility).

  2. On the Developertab, select Enable user breakpoints to debug code running in the Business Connector.

  3. Select Enable global breakpoints to debug code running in the Business Connector or client, and then click OK.

Enable breakpoints for a client

  1. Open the Configuration utility ( Start> Control Panel> Administrative Tools> Microsoft Dynamics AX Configuration Utility).

  2. On the Developertab, select Enable global breakpoints to debug code running in the Business Connector or client, and then click OK.

See Also