javaoptions.properties file

Edit online

The javaoptions.properties file contains the information that is used by the Copy Services Manager CLI for Java runtime.

When the javaoptions.properties property file specifies the JAVA_OPTIONS parameter, Copy Services Manager uses those options when starting Java for the CLI.
If the javaoptions.properties file preexists in your environment, it is located in the install dir\CLI\ directory for distributed systems, and the path_prefix/opt/IBM/CSM/CLI directory for z/OS.
Note: If the CLI/javaoptions.properties file does not exist, you can create it and define the JAVA_OPTIONS parameter with your required options.

Restart the Copy Services Manager CLI to activate Java property file changes. The Java properties are valid for all Copy Services Manager CLI users on the modified system.

Some examples of possible options in the javaoptions.properties file include:
Xquickstart
Enables the CLI to start up with a subset of optimizations, which can improve the performance when invoking the CLI for short operations. Batch jobs initiate individual calls to the Copy Services Manager CLI, which means that Java has to be started up for each call. This requirement can add to the overall runtime of the batch job. However, you can use the Java Quickstart option to reduce the Java start time.
Xmx<value>
Modifies the max memory setting for the CLI. If no javaoptions.properties file is present, the Xmx value defaults to 512m (512 MB).
Duser.language=<ll>
Specifies the code of a supported language for the Copy Services Manager CLI to use. This parameter overrides the default language locale setting of the CLI host system.
Copy Services Manager supports the following language locales:
  • Chinese - China (zh-CN)
  • Czech (cs)
  • English (en)
  • French (fr)
  • German (de)
  • Hungarian (hu)
  • Italian (it)
  • Japanese (ja)
  • Korean (ko)
  • Polish (pl)
  • Portuguese - Brazil (pt-BR)
  • Russian (ru)
  • Spanish (es)

After the javaoptions.properties file is set up, every time the Copy Services Manager CLI is invoked, the specified Java options are used.

Example: Code sample for a javaoptions.properties file that sets the maximum memory to 1024 MB, specifies Quickstart, and sets the CLI language to English: 
# This is the properties file that can be used to add additional options
 to the CSM CLI Java runtime without having to update the sh/bat files.

# Add additional options to the parm below separated by a space.

# ex. -Xmx1024m -Xquickstart -Duser.language=en

JAVA_OPTIONS=-Xmx1024m -Xquickstart -Duser.language=en