Capturing RA Oracle E-Business Suite Agent Jobs

Create one or more OEBSAGENT CAPTURE Jobs to mark OEBS programs for capture. Then execute the CAPTURE Job to see marked OEBS programs initiated from Concurrent Manager monitored through the Automation Engine.

The RA Oracle E-Business Suite Agent can capture and manage OEBS programs initiated directly from Concurrent Manager. To do this create one or more OEBSAGENT > CAPTURE Jobs to define the capture criteria. In the CAPTURE Job, from the Oracle E-Business Suite tab you specify capture settings on the General sub-tab and mark OEBS programs for capture on the Jobs sub-tab. Once you have the criteria defined execute the CAPTURE Job and the RA Oracle E-Business Suite Agent will capture all specified programs until the CAPTURE Job is canceled or the RA Oracle E-Business Suite Agent is stopped.

Only one CAPTURE Job can be Active at any one time. To switch between different CAPTURE Jobs, and institute the different defined capture criteria, just cancel one and submit another.

When the specified OEBS programs are initiated by whatever mechanism you normally use to get them into Concurrent Manager (e.g. a Foundation screen, CONCSUB command, or Windows application), the programs are monitored through the Automation Engine. You can then use all the features of the Automation Engine to control the Jobs running on the system.

Specifying General Capture Settings

Fields for the General sub-tab are described below.

  • Capture Mode

    • Determines what programs to capture.

    • Only Includes: When this option is selected, the RA Oracle E-Business Suite Agent will capture programs selected on the Jobs sub-tab marked with an Include capture mode.
    • All but Excludes: When this option is selected, the RA Oracle E-Business Suite Agent will capture all programs unless they are selected on the Jobs sub-tab marked with an Exclude capture mode.
    • None: When this option is selected, the RA Oracle E-Business Suite Agent will not capture any programs.
  • Capture Template

    • If you haven't defined a Job for a program, this template Job will be used when the program runs.

  • Capture Jobs only when Agent is Active

    • When this box is checked, Jobs are prevented from being captured when the Agent is down and they run in Concurrent Manager

Marking Programs for Capture

To mark OEBS programs as included or excluded on the Job Capture tab:

  1. Select the Include or Exclude radio button in the Capture Mode box at the bottom of the tab to specify the mode for either including or excluding the programs you select.
  2. Select the programs.

    3. You can type the first few letters of a search in the Search field, and Automation Engine will filter the results. The Search field also supports UNIX regular expressions and the Oracle % wildcard for multiple characters.

To change the include/exclude mode a selected Job, click that the Mode column for that Job's row and select Include or Exclude.

Note: Not all captured jobs might be shown in the Process Monitoring perspective at one time.

Suggested Excludes

When managing OEBS programs through Automation Engine, we recommend that you start with a short list. For example, selecting the All but Excluded processing option but no excludes are defined will intercept all OEBS programs, to manage through Automation Engine. It would be better to start with a small subset by using the Included Only processing option and include only a few OEBS programs. You can include additional OEBS programs at any time.

If you choose to use the All but Excludes option, you should be aware certain OEBS programs can exercise control over Concurrent Manager itself. The suggested excludes include the following FND programs:

  • ABORT
  • ACTIVATE
  • DEACTIVATE
  • FDRSTE
  • FNDCPBWV
  • FNDREPRINT
  • RESTART
  • SHUTDOWN
  • STARTUP
  • VERIFY

Turning Capture On

To turn on capture with the includes and excludes you have defined, run the CAPTURE Job you created. To turn off capture, cancel the Job. Only one Capture Job can run at any given time, but you can define as many as you want and run the one you want active at any given time.

Job Capture Behavior when the Agent is Shut Down

Job capture behavior is different depending on whether the Agent is intentionally or unexpectedly shut down.

If the Oracle E-Business Suite Agent: And the Agent Must be Active for Capture box is: Then:
Is intentionally shut down Checked or unchecked Job capture is turned off and programs will run through Concurrent Manager without being processed by the RA Oracle E-Business Suite Agent.

Goes down unexpectedly and there is an active CAPTURE Job

 Checked Marked programs are not captured when the Agent is down, and they run through Concurrent Manager without being processed by the RA Oracle E-Business Suite Agent.
Unchecked (default) Job capture remains on, and marked programs are prevented from running through Concurrent Manager. Instead they will stay in pending status until the RA Oracle E-Business Suite Agent is restarted, at which time they will be processed normally through the Automation Engine.