Configuring the executor

In most cases, you must configure features by configuring the component that launches the executor, rather than by configuring the executor itself. However, the location of the Social Security high-group file is configured in the executor product options file. The Social Security high-group file is used by services that validate or mask Social Security numbers.

Location of executor product options file

Use the executor product options file to set the executor configuration properties. The executor product options file is located at executor_folder/eclipse.ini, where executor_folder is the folder to which the executor was installed. The default executor folder depends on the operating system and on the user who installed the executor.
  • Default executor folder on Microsoft Windows computers:
    • 32-bit: C:\Program Files\IBM Optim\executor\
    • 64-bit: C:\Program Files (x86)\IBM Optim\executor\
  • Default executor folder on AIX®, Linux, or Solaris computers:
    • Executor installed by superuser: /opt/IBM/Optim/executor/
    • Executor installed by user other than superuser: /home/username/IBM/Optim/executor/, where username is the name of the user who installed the executor

Location of the Social Security high-group file

By default, when the executor runs a service that validates or masks Social Security numbers, the executor uses the following high-group file:

http://www.socialsecurity.gov/employer/highgroup.txt

To change the location of the high-group file that is used by the executor, open the executor_folder/eclipse.ini file and find the line that specifies the optim.datamask.ssn.highgroup.uri property. Change the location at the end of the line to the location of the high-group file that you want to use.

For example, you want to use the high-group file at C:\my file\highgroup.txt. Open the executor_folder/eclipse.ini file, find the line that specifies the optim.datamask.ssn.highgroup.uri property, and change the line so that it matches the following line.
-Doptim.datamask.ssn.highgroup.uri=file:///C:\my file\highgroup.txt 

Configuring the executor to use UTF-8 encoding in logs

If the executor computer is set to use a language that uses double-byte characters, configure the executor to use UTF-8 encoding in its log files. To configure the executor to use UTF-8 encoding, add the following line to the end of the executor_folder/eclipse.ini file.

-Dfile.encoding=UTF-8

Configuring the executor to log SQL warnings

You can configure the executor to log SQL warnings (that is, SQL messages whose error code is not equal to zero). SQL warnings are displayed in the proxy console when a service is run and are saved to the proxy log. To log SQL warnings, add the following line to the end of the executor_folder/eclipse.ini file.

-Dcom.ibm.optim.show.sql.warnings=true