Start and stop the asynchronous Application Integration Framework (AIF) services

Start and stop the asynchronous Application Integration Framework (AIF) services

Dynamics AX 4.0

In order for the Application Integration Framework (AIF) to begin sending and receiving documents with adapters, four services must be running as batch jobs within Microsoft Dynamics AX:

  • AIFOutboundProcessingService

  • AIFInboundProcessingService

  • GatewaySendService

  • GatewayReceiveService

Until these batch jobs are started, no documents can be processed in adapter-based exchanges. Inbound documents do not enter your Microsoft Dynamics AX system and outbound documents accumulate in the AIF outbound processing queue.

All the services are implemented as Microsoft Dynamics AX batch jobs. See Processing batch jobs.

You can create a single batch job to support both inbound and outbound processing, or you can create multiple batch jobs to run on one or more computers, depending on your processing needs.

To start the services and allow AIF to begin processing documents from the queues, you perform the following steps:

  • Create a batch group.

    See Create a batch group.

  • Create a batch journal type using the form.

    Add the AIF services (the classes in the Application Object Tree) to the batch journal type. See Create a batch journal type.

  • Create a batch journal using the form.

    See Create a batch journal.

  • Set parameters for the batch job on the form.

  • Start batch job execution using the form.

    See Run batch jobs.

NoteNote

You must keep the batch window open while the batch jobs are running. To stop the services, click on the form.


These steps create one batch group for as many of the AIF services as you need to set up. For more information, see Processing batch jobs.

1. Create a batch group

  1. Click > > > .

  2. Press CTRL+N to create a new batch group.

  3. In the field, type an identification for the batch group, for example AIF.

  4. In the field, type a name for the batch group that is unique in the system, for example AIF Group.

2. Create a new batch journal type

For the AIF services you want to run, complete the following:

  1. Click > > > .

  2. Press CTRL+N to create a new batch journal type.

  3. In the field, type an identification for the new journal type.

  4. In the field, type a descriptive name for the new journal type.

  5. Click the tab.

  6. Press CTRL+N to add a new job to the journal type.

  7. Add some or all of the AIF document processing components (called AifInboundProcessingService, AifOutboundProcessingService, GatewaySendService, and GatewayReceiveService) by clicking the drop-down icon under and pressing CTRL+N for each new entry.

3. Create a batch journal

  1. Click > > > .

  2. Click CTRL+N to create the batch journal.

  3. Type a unique identifier for the journal in the field.

  4. Select the journal type you created in Step 2.

  5. Type a unique descriptive name for the journal in the field.

4. Create the processing rules for the journal

In the form, complete the following:

  1. Click > > > .

  2. Select a batch journal.

  3. Click .

  4. On the tab, select the checkbox.

  5. In the field, select the batch group that you created above.

  6. To set the recurrence fields, click .

    One minute is a good value for testing, but a longer time between execution of batch jobs would probably be more efficient in production. The most efficient timing depends on your installation.

  7. Click OK.

  8. Click OK again to exit the form.

    After a short processing time, you should see a message of this form in the Infolog: "The 'Batch journal execution' job is added to the batch queue."

  9. On the form, click .

  10. On the form, press CTRL+N to add the AIF services in the field.

NoteNote

Keep the batch window open while the batch jobs are running. To stop the services, click on the form.


  1. Click > > > .

  2. In the field, select the AIF batch group you created above or any batch group available from the lookup field.

  3. Click OK.

  4. View the Infolog message informing you that the status is Waiting before the batch job is executed.

  5. View the Infolog messages each time the batch job is executed.

To stop processing, on the form, click . This form appears when you start processing by clicking OK on the form.

Show:
© 2016 Microsoft