CALL FUNCTION func STARTING NEW TASK task [DESTINATION {dest|{IN GROUP {group|DEFAULT}}}] [{CALLING meth}|{PERFORMING subr} ON END OF TASK] parameter_list.
Asynchronous call (aRFC) of a remote-enabled function module specified in func using the
RFC interface. The addition DESTINATION is used to specify a single
destination in dest or use IN GROUP to specify a group of
application servers.
The latter supports parallel processing of multiple function modules. The calling program is continued
using the statement CALL FUNCTION, as soon as the remotely called function
has been started in the target system, without having to wait for its processing to be finished.
CALLING and PERFORMING can be used to specify callback routines for
the takeover of events when the remotely called function is terminated. func and dest expect character-like data objects.
If the destination is not specified and also not defined in a callback routine using the addition
KEEPING TASK of the statement RECEIVE,
the destination "NONE" is used implicitly. The asynchronous RFC does not support communication with external systems or programs written in other programming languages.
A character-like data object must be specified for task. This object must
contain a freely definable task ID with a maximum of 32 digits for the remotely called function module.
This task ID is passed to the callback routines to identify the function. Each task ID defines a separate RFC connection with a dedicated
RFC session.
If a callback routine is specified, it must be ended before another function module is called with the same task ID and destination.
A repeated function call with the same task ID and destination uses the same RFC session in which the
global data of the associated function group can be accessed (if the connection still exists). This only applies in the following case:
If the PERFORMING addition or the CALLING addition are used and
The addition KEEPING TASK of the statement RECEIVE is specified in the callback routine.
In all other cases, a new RFC session is usually opened for function modules called more than once. This applies in the following cases:
If the task ID or destination is different (even if the connection still exists) and
If no callback routine is specified using the PERFORMING addition or
the CALLING addition or if the statement
RECEIVE is used without the addition KEEPING TASK in a callback routine. In these cases, the RFC connection is closed again directly after the call.
If a callback routine is specified, it must be ended before another function module is called with the same task ID and destination. If not, the call raises an exception.
More Information
More information about aRFC can be found in the RFC documentation on SAP Help Portal.
Notes
As with every RFC, an asynchronous RFC opens a
user session. If a calling program raises multiple consecutive asynchronous RFCs with different
destinations or task IDs or if a connection no longer exists, the called function modules are processed
in parallel in different user sessions automatically. This property can be exploited when running applications
in parallel. Since the associated management tool can cause resource bottlenecks on both the client
and the server, this kind of parallel processing is only recommended using the addition DESTINATION IN GROUP.
If an asynchronous RFC is executed without a specified destination, the logon data user name, client, and logon language from the calling session are applied to the RFC session implicitly. The
text environment language of the calling session must be used for the
logon language (and
not the logon language of the session). The text environment language can be set using the statement SET LOCALE LANGUAGE.
If a function module is started multiple times in a row using asynchronous RFC, the order of execution is not fixed; instead it depends in the system availability.
When dynpros are called in aRFC processing, additional
ABAP sessions are opened in the RFC client (see also
RFC Dialog Interactions. The maximum number of ABAP sessions
cannot be exceeded and if there are more, an error message is displayed. The maximum number of sessions
is defined in the profile parameter rdisp/max_alt_modes and cannot be greater than 16.
Asynchronous RFC triggers a database commit in the calling program. An sRFC in
updates is an exception to this.
Calls using STARTING NEW TASK are always executed using the RFC interface and a destination specified as dest is always interpreted accordingly. This is why, unlike in
synchronous RFC, an initial string or text field containing only blanks cannot be specified for dest.
The task ID passed as task does not need to be unique for each call. Unique tasks IDs can, however, help to identify calls within a callback routine.
If by mistake the statement RECEIVE
is not used in a callback routine specified using the PERFORMING addition
or the CALLING addition, the connection is persisted as when RECEIVE is specified using the addition KEEPING TASK.
Addition 1
... DESTINATION IN GROUP {group|DEFAULT}
Effect
If IN GROUP is specified as the
RFC destination, this supports parallel execution of multiple function modules on a predefined group of application servers of the current
AS ABAP. This variant of aRFC is also known as parallel remote function call (pRFC).
group expects a data object of the type RZLLI_APCL from ABAP Dictionary,
either an initial objects or one that includes the name of an RFC server group created in transaction
RZ12. If DEFAULT is specified or if group
is initial, all currently available application servers of the current AS ABAP are used as the group.
Only one RFC server group may be used within a program. The first asynchronous RFC using the addition
IN GROUP initializes the specified RFC server group. For each asynchronous
RFC where the group is specified, the most suitable application server is determined automatically, and the called function module is executed on this.
If the function module cannot be executed on any of the application servers, because not enough resources are available at present, a predefined exception RESOURCE_FAILURE is raised, to which, in addition to the other
RFC exceptions, a return code can be assigned. If this exception is raised, the addition MESSAGE is not permitted.
Notes
The parallel processing of function modules with the addition IN GROUP makes
optimal use of the available resources and is preferable to self-programmed parallel processing with explicitly specified destinations.
An application server that is used as part of an RFC server group for parallel processing must have
at least three dialog work processes, of which one is currently free. Other resources, such as requests in the queue, the number of system messages and so on, are also respected and must not exceed certain
threshold values.
To ensure that only those application servers that have enough resources are accessed, it is preferable
work with explicitly defined RFC server groups instead of working with the addition DEFAULT.
The function modules of the function group SPBT provide service functions for parallel processing, for
example, initialization of RFC server groups, determining the used destination, or temporarily removing an application server from an RFC server group.
Addition 2
... {CALLING meth}|{PERFORMING subr} ON END OF TASK
Effect
This addition is used to specify either a method meth or a subroutine
subr as the callback routine registered to be executed after terminating the asynchronously called function module. The same information can be specified for meth as for the general
method call, in particular dynamic information. subr expects a subroutine of the same program to be specified statically.
The method meth must be
public, and can have only one non-optional input parameter p_task of type clike. The specified
subroutinesubr can have exactly
one USING parameter of the type clike. In the
call, the RFC interface fills this parameter with the task ID of the remotely called function specified in the call in task.
In the method meth or in the subroutine subr,
the statement RECEIVE must be
used to receive the results of the remote function. In the callback routine, no statements can be executed that interrupt the routine or that trigger an implicit
database commit. Class-based exceptions must be handled within the callback routine. Statements for
list output are not executed.
A prerequisite for the execution of a registered callback routine is that the calling program still exists in its
internal session when the remote function is terminated. It is then executed here at the next change of the
work process in a roll-in. If the program was terminated or is located on the stack as part of a
call sequence, the callback routine is not executed.
If multiple callback routines are registered during a program section, they are executed in an undefined
order when the work process changes in a roll-in. The statement
WAIT FOR ASYNCHRONOUS TASKS can be used to stop the program execution until certain or all callback routines have been executed.
Notes
If no RECEIVE statement is executed in the callback routine to receive the
result of the remote function, the connection remains intact and implicitly behaves like the statement
RECEIVE with the addition
KEEPING TASK. This implicit behavior is usually unwanted and a callback routine without a RECEIVE statement must be viewed as a programming error.
The time when the callback routines are executed can be programmed explicitly or be reached implicitly:
The statement WAIT FOR ASYNCHRONOUS
TASKS is used for explicit programming. As specified by a condition, this statement changes
the work process and hence executes the callback routines registered up to this time. It waits for as
many registered routines to end until the condition is met (the maximum wait time can be restricted).
Explicit programming is recommended whenever the results of the remote function are required in the current program.
If the results of the remote function are not required in the current program, the time at which the callback routines are executed can also be determined by an implicit change of the work process (for example, at the end of a
dialog step). This can
be a good idea, for example, in GUI scenarios in which uses of WAIT are not
wanted. In this case, it must be ensured that the work process changes before the program is ended.
There is also a risk that, if the work process is changed implicitly, not all callback routines are registered in time.