Creating an Oracle RA Oracle Retail Agent Solution Agent Object

Agent runtime values specify configuration settings for the Agent and defaults for the Agent integration.

Creating an RA Oracle Retail Agent Solution Agent

To create an RA Oracle Retail Agent solution Agent:

  1. Create an AGENT > ORACLERETAILAGENT object in client 0 as described in your Automation Engine help. Make sure you set Read, Write, and Execute authorizations on the Authorizations tab of the AGENT object.
  2. Start processes for the Agent from the Automic ServiceManager utility. For information on starting AGENT objects, see your Automation Engine help.

Specifying Agent Runtime Values

When you create an RA Oracle Retail Agent solution Agent object in the Automation Engine, it includes a special Oracle Retail Agent tab. Agent runtime values specify configuration settings for the Agent and defaults for the Agent integration.

Agent runtime settings are described below.

Field Description

JDBC Connection

The RA Oracle Retail Agent JDBC Connection object this Agent will use to connect to the Oracle Retail database. For more information, see topic Creating RA Oracle Retail Agent JDBC and Program Connection Objects.

Environment Source File

A pathed file that sets the environment variables required for Oracle Retail. This field allows you to type in command line parameters if they are required for the source file script. For example, if the script is run from the command line like the following:

/home/retek/internal/bin/chgenv.ksh csrms 13.2 uc4lin

You can use the browse icon to browse to and select a file. If the file you select requires additional arguments, you can select the file and type in the arguments.

The MMHOME variable sets the Oracle Retail home directory. It is required in the RA Oracle Retail Agent's environment and must be set in the environment source file.

Source File Prefix

The SHELL type prefix to use when calling the Oracle Retail environment source file. For example, if the source file prefix is /bin/ksh when the script is called, it will execute it like the following:

/bin/ksh /home/retek/internal/bin/chgenv.ksh csrms 13.2 uc4lin

Source File Timeout Seconds

The amount of time that the Agent waits for the environment source file script to complete. If it takes longer than this number of seconds, the script is killed and an error is thrown. This value applies to both the Agent's Environment Source File field and the Environment Source File Override field in the Job definitions.

Execution Directory

Specifies the directory where the Oracle Retail executable programs reside. You can use the browse icon to browse to and select a directory.

Output Directory

The directory where the Oracle Retail program output will be created. You can use the browse icon to browse to and select a directory.

Status Check Seconds

How often to check the status while threads are running.