Kontakt

Ansicht
Dokumentation

OAFR_PP_RUN_AGENTS - Execute Agent

OAFR_PP_RUN_AGENTS - Execute Agent

BAL Application Log Documentation   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
This documentation is copyright by SAP AG.
SAP E-Book

Purpose

You can use this report to execute the agents of the agent framework with a time delay from the event that occurred. In combination with the automatic immediate execution, you can start this report to restart agents that the agent framework was unable to automatically execute immediately due to errors. For more information about automatic immediate execution, see the Agent Framework documentation in SAP Library, in the section Execute Agents.

Integration

You can execute the report in the following ways:

  • Scheduled Execution
  • Simplified Execution

To use the simplified execution of this report in the agent framework, from the SAP Easy Access menu, choose Financial Services → Foundation → Agent Framework → Agent Scheduling and Planning → Plan Agent Execution and run the transaction. For more information, see the documentation there.
  • Standard Scheduling

To schedule the report in an SAP-defined job network, run the transactions SM36 and SM37. For more information, see the documentation Configuring and Starting Job Networks in SAP Library.
  • Scheduling with SAP Central Process Scheduling by Redwood

  • Execution from the Dialog
To start the report from the dialog, from the SAP menu for cross-application components, run the transaction Execute Agents.

Parallel Processing

For package formation, the report supports an equally distributed hash value.

Check the Customizing settings under Financial Services → Foundation → Parallel Processing and Job Control → Define Job Networks and Define Confirmation for Mass Runs.
For more information about parallel processing, see the section Framework for Parallel Processing in SAP Library.

Change Notification Service (CA-GTF-TS-CNS)

The report uses the change notification service. For more information, see the Agent Framework documentation in SAP Library.

Prerequisites

Since the agent framework is based on the functionality of the change notification service, you need to have configured its use and the receiving applications in such a way that they can use the change notification service. For this, you need to have made all settings for all applications involved in SAP Customizing, under Cross-Application Components → General Application Functions → Change Notification Service.

Features

The report divides the worklist of events for the individual export objects into work packages and transfers these packages to the agent framework. This uses the change notification service to read the events for the individual export objects of the work package and then makes the event-related change pointer available to the agents for further processing.

If error messages are raised during the execution of the report, it is recommended that you resolve the errors and then restart the report.

Selection

Input Parameters

The Agent IDis a required parameter. To be able to enter the agent ID, you need to have selected it previously in the Customizing activities Declare Recipients as Agents and Configure Agents. You need to have executed all change notification service Customizing activities prior to this.

The following input parameters are optional:

  • This indicator is set in the standard system. If the indicator is active, the system terminates processing and thus prevents you from being able to start an update run inadvertently.

  • If you deactivate the indicator, the system starts the update run automatically.

  • Number of objects
  • If you enter an application-specific criterion, the report processes only those events for the export objects of an agent ID to which this criterion applies (for example, limit changes for accounts of a specific bank posting area).

  • If you do not enter an application-specific criterion, the report processes all events for all export objects that belong to the specified agent ID (for example, limit changes for all accounts, irrespective of the bank posting area).

If, for example, you run the report for test purposes for events of a specific export object for the agents specified above, you need to make the following entries:

Authorization Checks for the Report

While the report is running, it checks only the standard authorization objects (such as S_PROGRAM, F_EODP_ACT).

Locks

The agent framework uses the locks of the change notification service for this report. You can override the latter using the Suppress Locks indicator. For more information, see the field help there.

Postprocessing

The report does not generate any postprocessing orders.

Standard Variants

Output

Return values

The report returns one of the following values to job control:

0: (Completed successfully)

The system completed the execution without any issues.

2: (Completed with warning)

The system determined that there are no events for the agents specified in the input parameters and the application-specific criterion. Therefore, it did not start mass processing.

4: (Completed with individual errors)

The system was not able to execute all agents successfully. Errors occurred when executing individual agents, which the system has recorded in the log. It is recommended that you analyze and resolve these errors. However, you can continue with the execution of the other agents. After resolving the errors, it is recommended that you schedule the execution of the relevant agents again.

8: (Terminated)

Serious errors occurred during the execution of the agents. The system terminates processing. It is recommended that you analyze the errors, resolve them, and once you have resolved the errors, schedule the execution of the relevant agents again.

You can use numerators to specify under which conditions individual errors (4) result in termination (8). You can make the settings mentions in Customizing, under Define Confirmation for Mass Runs.

Application log

You can access the application log from the SAP Easy Access screen, under Financial Services → Foundation → Agent Framework → Execute Application Log Agents.

Example

The Account Management (FS-AM) application uses this report to distribute master data changes made to accounts to external systems when the Account Management system (FS-AM) generates or updates this data.

For more information, see SAP Help Portal at https://help.sap.com/trbks4. Open Product Assistance for SAP Transactional Banking for SAP S/4HANA, choose Transactional Banking, and look for Agent Framework (FS-FND-AF).






TXBHW - Original Tax Base Amount in Local Currency   General Material Data  
This documentation is copyright by SAP AG.

Length: 9808 Date: 20240520 Time: 095041     sap01-206 ( 134 ms )