AIX or Linux client

This topic describes the client setup information needed for the AIX® or Linux® client.

Required shared object files

The following shared object files must be added to a directory that the calling application is able to access:
  • libPayDrAPI
  • libPayDrSpxServ
  • libPayDrUtils
  • libPmtUtils

Configuration file

The Business Rules API has the ability to use a configuration file, which allows an implementer to customize the behavior of the API. Most of these configuration options are also able to be set directly through the API interface. A sample configuration file, PayDrAPI.cfg.defaults.Unix, is provided.

Environment settings

Adjust the PATH environment variable to include the current directory to locate the required libraries. For example:
export PATH=./:$PATH
If the configuration file is used, the API uses the PAYDRAPICFG environment variable to retrieve the absolute path for the configuration file. Set this environment variable to the directory where the configuration file is located. For example: 
export PAYDRAPICFG=/opt/IBM/PaymentsDirector/PayDir/Config/PayDrAPI.cfg
If the environment variable is not set, the default location for the configuration file is: 
/opt/IBM/paydir/PayDrAPI.cfg

API test utility

A test utility, APITest_Cmd, initializes and terminates a session with the configured Business Rules Server. It also has the ability to send decisions, motor stops, and no-op messages to the server.