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
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 ther3batch
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. TheDYNAMIC_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 theFor example, if the SAP R/3 access method is installed forTWA_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.AGENT1
andAGENT2
that belong to the dynamic pool DYN_POOL, you need to create the following options files in the pathTWA_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 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 ther3batch
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 ther3batch
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
andS4HANAR3BW
, that access two SAP systems,SAP1
andSAP2
, with ther3batch
access method, you must define the following three configuration files:- Global
r3batch.opts
- Local file
07756YBX76Z6AFX2_r3batch.opts
- Local file
S4HANAR3BW_r3batch.opts