Setting Java Properties For iAccess Client Solutions

Troubleshooting

Problem

In order to perform advanced configuration or debug tasks with IBM i Access Client Solutions, it may be necessary to set Java System properties.

Resolving The Problem

In order to perform advanced configuration or debug tasks with IBM i Access Client Solutions, it may be necessary to set Java System properties. This document illustrates a few simple ways to set these properties.

To set the properties through the AcsConfig.properties file:

Located, by default, in the same directory as the acsbundle.jar file

<property>=<value>

for example:

java.net.preferIPv4Stack=true
or
java.security.krb5.realm=CS4.RCHLAND.IBM.COM

To use Command line:

-D<property>=<value>

for example:

acslaunch_win-32.exe -Djava.net.preferIPV4Stack=true
or
java -Djava.net.preferIPv4Stack=true -jar acsbundle.jar
(for platforms that do not have executable launchers)
or
acslaunch_win-32.exe -Djava.security.krb5.realm=CS4.RCHLAND.IBM.COM

To set the properties using Environment Variables:

These are specific to the JRE you are running.

For instance, when using an Oracle JRE, you may set _JAVA_OPTIONS to include arguments to be given to the Java Virtual Machine. On an IBM JRE, you can set IBM_JAVA_OPTIONS.

_JAVA_OPTIONS="-D<property>=<value>"
IBM_JAVA_OPTIONS="-D<property>=<value>"

for example:

set _JAVA_OPTIONS="-Djava.net.preferIPV4Stack=true"
or
set IBM_JAVA_OPTIONS="-Djava.net.preferIPV4Stack=true"

You should consult the documentation for the Java Runtime Environment (JRE) you are using for more details.

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CTpAAM","label":"IBM i Access-\u003EAccess Client Solutions"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

670666545

Was this topic helpful?

Document Information

More support for:
IBM i

Component:
IBM i Access->Access Client Solutions

Software version:
All Versions

Operating system(s):
IBM i

Document number:
683513

Modified date:
22 December 2024

UID

nas8N1010376

IBM Support

Tips