Previous Topic: Deploy the RequestService Client

Next Topic: Configure Web Service Security


Define the RequestService Java API rootdir Property

When writing a client Java program that calls the RequestService Java API, the root directory of the RequestService client distribution must be specified to the Java environment. You supply this information using the –D flag to the java command when launching your own Java application. Through the –D flag, you specify a property named com.ca.distauto.ap.websvc.rootdir. The value for this property is the root directory of the RequestService directory tree that you unzipped onto your remote client computer. Specify a directory path syntax that is appropriate for your Windows or Linux operating system. For example, on Windows the command would be similar to this example:

java -Dcom.ca.distauto.ap.websvc.rootdir="C:\YourClientUnzipDirectory\RequestService” com.YourCompany.YourPackage.YourClass YourParameters

Both of the CA command-line scripts RequestService and RequestService.bat utilize this –D flag to point to the java API root directory. Both scripts are located in YourClientUnzipDirectory\RequestService\bin. The Java API uses the rootdir property to determine the directory into which it will write log files. The rootdir property is also used to find the RequestService.properties file, which controls configuration options for the Java API. This file controls security certificates and logging options. Directions for setting properties for security certificates are documented in Configure a remote web service client for TLS. CA support staff can provide directions for changing logging properties when needed for diagnostic purposes.