Purpose
The bgRFC (Background Remote Function Call) monitor enables you todisplay individual bgRFC units. A unit consists of one or more functionmodules that need to be processed as an indivisible unit.
The units are stored on the database until they are processed. You canuse the monitor to view the state of the unit, from when it is firstrecorded until it has been processed.
The units have the following general properties; the structure of themonitor is based on these properties.

• Units can be processed transactionally or, additionally, in logical
queues. In a queue, units are processed according to the FIFO principle(first in, first out).

• Units can be recorded before they are passed to a remote system. This
procedure is known as the outbound procedure. Units can, however, alsobe recorded for processing in the same system (that is, the execution ofthe recorded function modules). This procedure is known as the inboundprocedure and is generally used for load balancing within a system.

Prerequisites
bgRFC is a functional alternative to tRFC and qRFC. Each application candecide for itself whether to switch from tRFC or qRFC to bgRFC. ThebgRFC only traces those units recorded for bgRFC.

Features
bgRFC displays the recorded units.
As well as displaying units, the monitor provides you with functionsthat let you intervene in their processing. Authorizations protect theuse of these intervention functions. For information about whichinterventions are possible, see "Activities".
The monitor aims to interfere with the actual processing of the units aslittle as possible. This means you may experience slight delays when youdisplay the status of a unit. For example, units are deleted once theyare processed, and cannot be displayed. This deletion actually occurs inthe background, which means that individual units may still be visible,despite having already been deleted. You can switch the display to showdeleted but not yet executed units (choose "Edit" -> "Show DeletedUnits").

Selection
Initially, you can restrict your selection using the properties"Transactional" and "Queued". If you select by transactional units, youcan specify additional restrictions under "Options for TransactionalUnits". If you select by queued units, you can specify additionalrestrictions under "Destination/Queue".
You can also restrict your selection to inbound or outbound procedures.If you choose inbound, you display those units whose function modulesare to be executed in the local system. If you choose outbound, youdisplay those units that are to be passed from the local system to aremote system (to be executed there).
Under "Status of Queues/Units" you can restrict the display to queuesand units with errors or locked queues and units. If any queues or unitshave errors, processing is stopped due to an unexpected situation;locked queues or units have been stopped intentionally by the generatingapplication or by the monitor.
Under "Destination/Queue" you can restrict your selection to specificdestinations or business processes. This area of the screen changes ifyou selected "Queued" under "Unit Type".
Under "Options for Transactional Units" you can select units by theirproperties. They are: The name of the user under which the unit isrecorded. The name of the program or SAP transaction code with which theunit was created. You can also select by time recorded. Note that youneed to enter the time recorded as a UTC time stamp(JJJJMMTThhmmssmmmuuun). Use the value help to help you enter the timestamp. You see this section of the screen only if you selected"Transactional" under "Unit Type".

Output
The selection is displayed in a two-part screen.
The left half of the screen shows a hierarchy tree. The top level issplit into inbound and outbound. Each procedure is divided furtheraccording to destination and unit type, transactional or queued. Queuedunits are split again into the individual queues.
The right half of the screen shows the list of the units that match theitem chosen on the left.

Activities
You can perform activities for destinations and queues or for individualunits.
You perform activities for single units from the right half of thescreen by positioning the cursor on the unit. The other activities areperformed on the left half of the screen.
Activities for units:


• Delete unit


• Debug unit


• Lock unit for analysis


• Display function module (source code in source system)


• Display queues for unit (type Q only)


• Display list of function modules (by double-clicking function module)

Activities for destinations:

• Lock/unlock destinations


• Maintain destinations (goes to maintenance transactions of the
destinations)
Activities for queues (for type Q only):

• Create/remove queue locks


• Delete queue (deletes all units for the queue)