Configuring the SAP access method

This section provides detailed information about the SAP options file creation.

The files for the SAP access method are located in the following path:
On UNIX operating systems
TWA_DATA_DIR/methods
On Windows operating systems
TWA_home\methods
If r3batch finds the local configuration file for an extended agent or dynamic agent, it ignores the duplicate information contained in r3batch.opts. If instead it does not find a local configuration file then it will use r3batch.opts global options file.

To successfully use the SAP access method, you must first install the SAP RFC libraries, as described in the System Requirements Document available at Product Requirements.

Dynamic agents
r3batch.opts
A common configuration file for the r3batch access method, whose settings affect all the r3batch instances. It functions as a “global” configuration file.
DYNAMIC_AGENT_FILE_r3batch.opts
One or more configuration files that are specific to each dynamic agent workstation within a particular installation of a r3batch access method. The DYNAMIC_AGENT_FILE_r3batch.opts is the name of the options file, where DYNAMIC_AGENT is not necessarily the name of the dynamic agent workstation, because the dynamic agent can have more than one.opts file associated. If you do not create a local options file, the global options file is used. Every dynamic agent workstation must have one or more local options file with its own configuration options.
Note: The value for DYNAMIC_AGENT must be written in uppercase alphanumeric characters. Double-byte character set (DBCS), Single-byte character set (SBCS), and Bidirectional text are not supported.
Note: If you have a pool or dynamic pool containing n agents, you must create an options file for the dynamic pool and copy it in the TWA_home/methods of each agent of the pool so that all members of the pool have a local options file with the same name. Then you must create another options file for the specific agent in the same directory.
For example, if the SAP R/3 access method is installed for AGENT1 and AGENT2 that belong to the dynamic pool DYN_POOL, you need to create the following options files in the path TWA_home/methods on each agent:
AGENT 1
  • FILE_AGENT1_r3batch.opts
  • FILE_DYN_POOL_r3batch.opts
AGENT2
  • FILE_AGENT2_r3batch.opts
  • FILE_DYN_POOL_r3batch.opts

On dynamic workstations, you can create a new options file or edit an existing options files from an Option Editor, a graphical user interface panel available on the General tab of the SAP job definition panels in the Dynamic Workload Console.

Extended agents
r3batch.opts
A common configuration file for the r3batch access method, whose settings affect all the r3batch instances. It functions as a “global” configuration file.
XA_Unique_ID_r3batch.opts
A configuration file that is specific to each HCL Workload Automation extended agent workstation that uses the r3batch access method. Its options affect only the r3batch instance that is used by that particular workstation. It functions as a “local” configuration file.
Note: XA_Unique_ID is the unique identifier for the extended agent workstation. See UNIQUE_ID for more details about identifying the unique identifier for an extended agent workstation.
For example, to define two extended agent workstations with unique identifiers, 07756YBX76Z6AFX2 and S4HANAR3BW, that access two SAP systems, SAP1 and SAP2, with the r3batch access method, you must define the following three configuration files:
  • Global r3batch.opts
  • Local file 07756YBX76Z6AFX2_r3batch.opts
  • Local file S4HANAR3BW_r3batch.opts