Scribd Logo
Upload

Welcome to Scribd!

  • 105 views

    Batch - Debugging Batch Jobs

    Uploaded by

    Jordi Reig Sais
    This document provides a step-by-step checklist for debugging batch jobs in Dynamics AX by: 1) Enabling global breakpoints in the client and server configurations. 2) Configuring the AOS instance to run under the credentials of the debugging user. 3) Setting breakpoints in the code and scheduling a batch job to trigger the breakpoints.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOCX, PDF, TXT or read online from Scribd

    Batch - Debugging Batch Jobs

    Uploaded by

    Jordi Reig Sais
    105 views5 pages
    This document provides a step-by-step checklist for debugging batch jobs in Dynamics AX by: 1) Enabling global breakpoints in the client and server configurations. 2) Configuring the AOS instance to run under the credentials of the debugging user. 3) Setting breakpoints in the code and scheduling a batch job to trigger the breakpoints.

    Copyright

    © Attribution Non-Commercial (BY-NC)

    Available Formats

    DOCX, PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    This document provides a step-by-step checklist for debugging batch jobs in Dynamics AX by: 1) Enabling global breakpoints in the client and server configurations. 2) Configuring the AOS instance to run under the credentials of the debugging user. 3) Setting breakpoints in the code and scheduling a batch job to trigger the breakpoints.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOCX, PDF, TXT or read online from Scribd
    Download as docx, pdf, or txt
    105 views5 pages

    Batch - Debugging Batch Jobs

    Uploaded by

    Jordi Reig Sais
    This document provides a step-by-step checklist for debugging batch jobs in Dynamics AX by: 1) Enabling global breakpoints in the client and server configurations. 2) Configuring the AOS instance to run under the credentials of the debugging user. 3) Setting breakpoints in the code and scheduling a batch job to trigger the breakpoints.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as DOCX, PDF, TXT or read online from Scribd
    Download as docx, pdf, or txt
    of 5

    Step-by-Step Checklist for Debugging Batch Jobs in Dynamics Ax

    [email protected] 25 Jun 2009 12:19 PM

    4 This post applies to Microsoft Dynamics Ax 2009 (see version note below).

    A. Enable Global Breakpoints


    When debugging in the client, you want to set breakpoints that can be caught by the debugger. The following steps show how. 1. Launch the Microsoft Dynamics AX Configuration tool from the Start >Administrative Tools menu on your client computer. The first time this tool opens, you will be on the Original configuration. Create a new configuration named Debug. Click Manage and choose the Create Configuration menu option. 2. Enter a new name such as Debug, and choose copy from Original configuration and click Ok. 3. A new configuration is created and shown in the configuration tool. Click theDeveloper tab. 4. Choose the following options: Enable global breakpoints to debug code running in the Business Connector or client (required for this scenario) Enable user breakpoints to debug code in the Business Connector (optional for this scenario) Note: Take special care that the Configuration Target remains set to Local Client since this is the only client you can set global breakpoints from.

    B. Configure Your AOS to Run Under Your User Credentials


    1. Launch the Services utility on your AOS server machine, and choose the AOS instance that you are configuring for debugging. 2. Right-click on your chosen AOS instance name and choose Properties. On the properties window, choose the Logon tab. Select This account for the Logon As option. Enter your full Domain account {e.g. contoso\YourName } and password credentials. This account must be the same user account as the account used for debugging batch code. 3. Click Apply once you have modified the user account. 4. You will be prompted to restart the service. Choose yes to restart the service (note: ensure other users are not working on this service before restarting it).

    C. Configure the Dynamics AX Server to Enable Debugging


    1. From your Start > Administrative Tools menu, open the Microsoft Dynamics AX Server Configuration tool. This tool has the same option to Manageconfigurations that you saw earlier in the client configuration tool. 2. Choose the Manage and Create Configuration option to create a new server configuration. As before, copy from the original configuration and choose Debug as the name. 3. Verify the AOS instance matches the instance you want to use for debugging. 4. Choose the following options: Enable breakpoints to debug X++ code running on this server (required for this scenario) Enable global breakpoints to debug X++ code running in batch jobs (required for this scenario) Note: When you click Apply, you will be prompted to restart the service, and you should choose Yes.

    D. Set breakpoints and start debugging.


    1. Launch the Dynamics AX Client from the Start menu, and open the developer workspace. 2. Open the class you would like to debug from the AOT and set breakpoints at desired locations. 3. Launch the Dynamics Ax Debugger from the Start menu. The debugger must be opened directly in order to find and catch global breakpoints. 4. Schedule the batch job to run. Example: To schedule work calendar delete to run in batch; launch the WorkCalendarDelete class in the AOT, click Batch tab, check Batch Processing check box and click Ok. 5. Wait for the debugger to catch the breakpoints.

    E. Version information.
    Batch debugging on Windows Server 2003 works with Dynamics Ax 2009. However, ahot fix (from partners site) is needed for Windows Server 2008. The next release of Dynamics Ax will include a fix for both operating systems (2003 and 2008).

    Comments

    Lobbi 23 Mar 2010 11:13 AM

    B.2 "Right-click on your chosen AOS instance name and choose Properties. On the properties window, choose the Logon tab. Select This account for the Logon As option. Enter your full Domain account {e.g. contoso\YourName } and password credentials. This account must be the same user account as the account used for debugging batch code." As i understand this regarding step B.2, only one user can debug, am i understanding this correctly? According to this "This account must be the same user account as the account used for debugging batch code."

    Craig 7 Jul 2010 10:23 AM My apologies for the late response. Lobbi says: "As i understand this regarding step B.2, only one user can debug?" For clarity, I would like to note that any number of users can debug their X++ code outside of batch jobs. It is also possible to modify code that typically runs in batch mode and instead call it directly from a job although state could be different when code is executing on the client. In some rare cases, debugging a batch job on the server is the only way to reproduce errors with the proper state (application data, configuration settings, etc...) and in those rare situations, then only one account can be used to debug the batch code running on the server.

    Rama 23 Sep 2010 7:19 AM Hi, I was in assumption that we can't debug the code running under batch process. As per my experience, i worked on so many batch job related tasks, and i solved the issues by trail and error. Anyways, after going through the above explanation, I came to conclusion that we can debug the batch job as well provided the AOS account logon credentials to be given as the one who is logging into the AX. I tried the above scenario in my local machine. But in the production environment, if two or more developers are working to solve the batch job issues, is it possible for them to debug the batch jobs? Right now in my machine, i am the only person who logs into the AX and i can play changing the AOS account to my credentials. Do we need to change each and every time as per the user who is going to debug the batch job?

    Praveen 4 Mar 2011 6:55 AM I am trying to run an import job in the background. When I run the job, there is a 'Batch processing' checkbox. If enable this option and accept the job, it is added to the user batch list with a status of 'Waiting', but is never processed. The following is from the documentation: 'First of all, a job can not start before an Axapta is started as a batch executer (processing).' What does this mean? Does the AOS have to be started with certain settings, or does a client have to be started with some or other settings? Can more than one job be run at once (rather than waiting for each job to finish)? Thanks.

    You might also like