HCL Workload Automation, Version 9.4

Defining the common options

Table 1 lists additional options that you can specify in either configuration file.

Table 1. r3batch common configuration options
Option	Description	Default
bdc_job_status_failed	(Optional) How HCL Workload Automation sets the completion status of a job running BDC sessions, according to a possible BDC processing failure. The allowed values are: n If at least n BDC sessions failed (where n is an integer greater than 0), HCL Workload Automation sets the job completion status as failed. all If all the BDC sessions failed, HCL Workload Automation sets the job completion status as failed. ignore When all the BDC sessions complete, regardless of their status, HCL Workload Automation sets the job completion status as successful. This is the default. Note: This option is ignored if you defined the job by setting the nobdc or nobdcwait option. For details about these options, see Task string to define SAP jobs.	`ignore`
ccms_alert_history	(Optional) Enables (`ON`) or disables (`OFF`) the product to retrieve all the matching CCMS alerts, included those that were generated before the monitoring process started. The default value is `OFF`, meaning that the product retrieves only the CCMS alerts that are generated after the monitoring process started. Note: This option takes effect the first time you start the CCMS alert monitoring. If you initially set it to `OFF` and later you want to retrieve the alerts generated before the monitoring process started, stop the monitoring and delete the `XAname_r3xalmon.cfg` file located in `TWS_home/methods/r3evmon_cfg`. In the options file, set `ccms_alert_history=on` and start the monitoring process again.	`OFF`
commit_dependency	(Optional) Enables (`ON`) or disables (`OFF`) the product to commit internetwork dependencies after processing. If you enable this option, internetwork dependencies are committed immediately by default. If you disable or delete this option, the -commit parameter set in the internetwork dependency definition is applied. For details about the -commit parameter, see Table 1.	`OFF`
enable_appl_rc	(Optional) Enables (`ON`) or disables (`OFF`) the mapping of the application return code to the HCL Workload Automation return code. Note: This feature does not modify the exit code of the access method. For more details, refer to the rccondsucc keyword in the job definition documented in HCL Workload Automation: User's Guide and Reference.	`OFF`
evmon_interval	(Optional) The polling rate (in seconds) that the `r3evmon` process applies to monitor the list of events.	`60`
ifuser	(Optional) The ID of the user who runs the access method to retrieve job information.	None
idoc_no_history	(Optional) Enables (`ON`) or disables (`OFF`) the product to retrieve only IDoc data that is generated after the monitoring process started. If you specify `OFF`, all matching IDocs are retrieved, including those that were generated before the monitoring process started. When processing this option, `r3evmon` uses the XAname`_r3idocmon.cfg` file to retrieve the date and time for the next monitoring loop.	`ON`
idoc_shallow_result	(Optional) Enables (`ON`) or disables (`OFF`) the product to retrieve only the most recent matching IDocs. For example, suppose you set `idoc_shallow_result=ON`. If the status of an IDoc changes several times during the monitoring interval and the same status, matching an event rule condition, occurs more than once in the sequence of statuses, only the most recent matching IDoc is retrieved. If you specify `OFF`, all matching IDocs are retrieved.	`ON`
jobdef	(Optional) If enabled, you can use the Dynamic Workload Console to define jobs, in addition to the command line. Specify `r3batch` to enable the option, and any other value to disable it.	`r3batch`
job_interceptable	(Optional) Enables (`ON`) or disables (`OFF`) the job launched by r3batch to be intercepted by SAP. If enabled, when r3batch launches a job and the SAP job interception feature is enabled, the job can be intercepted if it matches previously defined criteria. If disabled, the job launched by r3batch cannot be intercepted by SAP.	`OFF`
ljuser	(Optional) The ID of the user who runs the access method to launch jobs (LJ tasks) and manage jobs (MJ tasks).	None
log_r3syslog	(Optional) Enables (`ON`) or disables (`OFF`) the access method to write the latest entries from the SAP syslog to its trace file when an RFC returns with a general error.	`OFF`
long_interval	(Optional) The maximum interval, in seconds, between status checks. It cannot be greater than 3600 seconds. See also short_interval.	`3600`
max_n0_counter	(Optional) The maximum value of the N0 counter. If the N0 counter reaches the specified value, it starts again from 0.	`2^15 - 1`
max_name_counter	(Optional) The maximum value of the variant name counter. If the name counter reaches the specified value, it starts again from 0.	`40`
n0_counter_policy	(Optional) The N0 counter policy: step The N0 counter is increased once for every step. job The N0 counter is increased once for every job.	`job`
name_counter_policy	(Optional) The name counter policy: step The name counter is increased once for every step. job The name counter is increased once for every job.	`job`
nojobdefs	(Optional) Disables (`1`) or enables (`0`) the definition of new SAP jobs using the Dynamic Workload Console. If this option is set to 1, you must create the job definitions in the SAP job before creating the HCL Workload Automation job that is going to schedule them.	`0`
oldcopy	(Optional) Enables (`1`) or disables (`0`) the access method to use the old way of copying jobs, even though the function module BAPI_XBP_JOB_COPY is present on the SAP system.	`0`
pchain_recover	(Optional) The action taken by HCL Workload Automation when you rerun a job that submits a process chain. The allowed values are: rerun HCL Workload Automation creates another process chain instance and submits it to be run again. restart HCL Workload Automation restarts the original process chain from the failing processes to the end. For details about rerunning a process chain job, refer to Rerunning a process chain job.	`rerun`
pchain_details	(Optional) Enables (`ON`) or disables (`OFF`) the display of details about an SAP process chain that you scheduled as an HCL Workload Automation job.	`OFF`
pchainlog_bapi_msg	(Optional) Enables (`ON`) or disables (`OFF`) the product to retrieve additional messages from the BAPI calls from the SAP Business Warehouse process chains and appends them to the stdlist of HCL Workload Automation.	`ON`
pchainlog_level	(Optional) Supplements the option retrieve_pchainlog. Specifies which level of process chain logs you want to retrieve. Allowed values are: 1 Only the first level of process chain is logged. level_number Process chains are logged down to the level of chain you indicate here. For example, if you indicate 2 only the first two levels are logged. all All process chains are logged.	If you omit this option, and leave retrieve_pchainlog set to `ON`, the default is level `1`.
pchainlog_verbosity	(Optional) Supplements the option retrieve_pchainlog. Specifies which type of process chain logs you want to retrieve. Allowed values are: chains_only Logs only the process chains. chains_and_failed_proc In addition to the process chains, logs all failed processes. complete Logs all process chains and processes. Note: This option affects the entire process chain; verbosity cannot be reduced for individual processes.	If you omit this option, and leave retrieve_pchainlog set to `ON`, the default is `complete`.
pc_launch_child	(Optional) Enables (`ON`) or disables (`OFF`) the product to launch child jobs that are in scheduled state. Note: You can use this option only if you activated the parent-child feature on the SAP system. On the XBP 2.0 or later SAP system, you can activate this feature by using the INITXBP2 ABAP report.	`OFF`
placeholder_abap_step	(Optional) If XBP version 2.0 is used, the name of the ABAP report used as the dummy step in the SAP placeholder job that is created to monitor an SAP event defined as external dependency.	If this option is not specified, either as global or local option, the default `BTCTEST` is used.
qos_disable	(Optional) Enables (`ON`) or disables (`OFF`) the creation of the environment variable QOS_DISABLE on Microsoft Windows systems that use the Quality of Service (QoS) feature, before `r3batch` opens an RFC connection. Without this option, because of problems in the implementation of the QoS service, the connection between `r3batch` and the SAP RFC library does not work.	`OFF`
r3auditlevel	(Optional) The audit level for the XBP. A number from 0 (low) to 3 (high).	`3`
rcmap	(Optional) Enables (`ON`) or disables (`OFF`) the return code mapping capabilities of Access method for SAP.	`ON`
retrieve_applinfo	(Optional) Enables (`ON`) or disables (`OFF`) the retrieval and appending of the SAP application log to the stdlist of HCL Workload Automation.	`OFF`
retrieve_ipaklog	(Optional) Enables (`ON`) or disables (`OFF`) the retrieval and appending of the SAP BW InfoPackage logs to the `stdlist` of HCL Workload Automation. Note: The retrieval and appending of SAP BW InfoPackage job logs to the `stdlist` might be time-consuming for jobs that produce large logs.	`ON`
retrieve_joblog	(Optional) Enables (`ON`) or disables (`OFF`) the retrieval and appending of the SAP job logs to the `stdlist` of HCL Workload Automation. Note: The retrieval and appending of job logs to the `stdlist` might be time-consuming for jobs that produce large logs. If you disable the retrieval of the job logs, you also disable the return code mapping function for the log entries. This option does not affect the `BDC Wait` feature.	`ON`
retrieve_pchainlog	(Optional) Enables (`ON`) or disables (`OFF`) the retrieval and appending of the SAP BW process chain logs to the `stdlist` of HCL Workload Automation. Note: The retrieval and appending of SAP BW process chain logs to the `stdlist` might be time-consuming for jobs that produce large logs. If you disable the retrieval of the SAP BW process chain logs, you also disable the return code mapping function for the log entries. This option on its own retrieves the log of only the first level of a process chain. To retrieve more complete logs, use this option with the pchainlog_level and pchainlog_verbosity options.	`ON`
retrieve_spoollist	(Optional) Enables (`ON`) or disables (`OFF`) the retrieval and appending of the SAP job spool lists to the `stdlist` of HCL Workload Automation. Note: The retrieval and appending of SAP job spool lists to the `stdlist` might be time-consuming for jobs that produce large spool lists. If you disable the retrieval of the SAP job spool lists, you also disable the return code mapping function for the spool list entries.	`ON`
retry	(Optional) The retry count for SAP function module calls. Specify an integer greater than 0.	`5`
rfc_interval	(Optional) The polling rate (in milliseconds) with which r3batch listens for results of RFC requests. The rate cannot exceed 1,000 milliseconds. Consider that the lower the value of the rfc_interval option, the higher the frequency with which RFC request results are collected and, as a consequence, CPU consumption on the r3batch system is high.	`10`
rfc_open_delay	(Optional) The maximum number of seconds to wait between two consecutive calls before opening an RFC connection.	`1800`
rfc_open_retry	(Optional) The retry count for opening an RFC connection to the SAP system. Specify an integer greater than 0 to limit the number of retries, or `-1` for an unlimited number of retries.	`5`
rfc_timeout	(Optional) The time (in seconds) that `r3batch` waits before canceling a non-responding RFC communication. Allowed values are in the range from 0 to 9999; 0 means no timeout.	`600`
short_interval	(Optional) The minimum interval, in seconds, between status checks. It cannot be less than 2 seconds. Setting this option to low values makes the notification of status changes faster, but increases the load on the hosting machine. See also long_interval.	`10`
throttling_enable_ job_class_inheritance	(Optional) Enables (`ON`) or disables (`OFF`) the inheritance of priority class. `ON` means that the intercepted job inherits the priority class of its progenitor job, if it is higher than its own class; otherwise it keeps its own class. `OFF` means that the intercepted job keeps its own class, regardless of its progenitor’s class. Note: By setting this option, the parent-child feature is automatically enabled on the SAP system.	`ON`
throttling_enable_ job_interception	(Optional) Enables (`ON`) the job interception feature at job throttler startup, or keeps the current setting (`OFF`). `ON` means that when the job throttler starts, it enables the job interception feature on the SAP system. When the job throttler is stopped, the job interception feature is also automatically restored to the setting that was previously configured on the SAP system. `OFF` means that the job interception feature is kept as it is currently set in the SAP system.	`ON`
throttling_job_ interception_ version	Specifies the BC-XBP interface version to be used when the job throttler starts. Valid values are: 2 3 The default BC-XBP interface version that is used is `2` (version 2.0).	`2`
throttling_interval	(Optional) The interval (in seconds) between each job throttling run.	`5`
throttling_max_ connections	(Optional) The maximum number of connections (connection pool size) that the job throttler can open to communicate with the SAP system. The minimum value is 3.	`5`
throttling_release_all_ on_exit	(Optional) Enables (`ON`) or disables (`OFF`) the release of all intercepted jobs. `ON` means that when the job throttler is stopped, it releases all the intercepted jobs. `OFF` means that when the job throttler is stopped, it does not release the intercepted jobs therefore the jobs remain intercepted, in scheduled state.	`ON`
throttling_send_ ccms_data	(Optional) Enables (`ON`) or disables (`OFF`) the sending of data from job throttling to the SAP CCMS Monitoring Architecture. `ON` means that the job throttler sends its status data to CCMS continuously. `OFF` means that the job throttler does not send its status to CCMS.	`OFF`
throttling_send_ ccms_rate	(Optional) Rate (in number of runs) at which the job throttler sends its status data to the SAP CCMS monitoring architecture. The minimum value is `1`, meaning that the job throttler sends the data at every run.	`1`
twsmeth_cp	(Optional) The code page that `r3batch` uses to write its output. This option must be consistent with twsmeth_lang. It can be any of the existing TIS codepages.	The code page used by the HCL Workload Automation workstation that hosts the `r3batch` access method.
twsmeth_lang	(Optional) The language used to report messages. This option must be consistent with twsmeth_cp.	The language of the locale of the workstation that hosts the `r3batch` access method.
twsxa_cp	(Optional) The encoding used by `r3batch` to establish RFC connections with SAP systems. Use this option if `r3batch` is not Unicode-enabled. Possible values are: 1100 1103 8000 8300 8400	`1100`
twsxa_lang	(Optional) The language used to log in to SAP systems. Specify one of the following (DE, EN, and JA can be set from the Option Editor. The other languages can be set using any text editor): DE German EN English ES Spanish FR French IT Italian JA Japanese KO Korean pt_BR Brazilian Portuguese zh_CN Simplified Chinese zh_TW Traditional Chinese Note: If you are working with InfoPackages and process chains on operating systems that do not support Unicode, this option must be set.	`EN`
use_fips	(Optional) Enables (ON) or disables (OFF) the FIPS mode of operation for HCL Workload Automation.	`OFF`
utf8cmdline	(Optional) Enables (`1`) or disables (`0`) the encoding of extended parameters in UTF-8 format. The default value is `0`.	Note: If you have both global and local options files and you want to change the default value for utf8cmdline, modify the local options file because this overrides the global options.
variant_delay	(Optional) The time, in seconds, that r3batch allows the SAP system to clean up the structures used for communication between r3batch and the SAP system. This option is valid when you launch a job that uses extended variants and requires a copy of a job template. Use this option only when you want to reduce r3batch response time, because it increases the load on the hosting machine. Higher values of variant_delay increase the response time and decrease the load. Allowed values are in the range from 0 to 3600.	`10`
variant_selection_ screen	(Optional) Specifies the functional interface used to read report selection screens. Specify one of the following: Custom To communicate with the SAP system using the HCL Workload Automation custom function module. SAP To communicate with the SAP system using the XBP 3.0 function module.	Custom
xbpversion	(Optional) The XBP version used on the target SAP system. Specify an integer value. This value overwrites the XBP version automatically determined during RFC logon. Note: For details about XBP 3.0 and SAP NetWeaver 2004s with SP9, refer to the SAP Note 977462.	The XBP version determined by r3batch during RFC logon from the SAP system.