Verifying environment variables

The CWSharedEnv.sh file includes the environment variables that InterChange Server needs. The file groups the environment variables into categories. All InterChange Server scripts that run on UNIX source this file before executing so that they have access to the correct environment variable settings. Command-line utilities source this file before executing the InterChange Server software.

Installer creates the CWSharedEnv.sh file. It is recommended, however, that you verify the environment variable settings in this file. Make sure the following environment variables are correctly set in the CWSharedEnv.sh file:

Variable Description
CROSSWORLDS Set to the directory in which InterChange Server software is installed
LIBPATH (AIX)
LD_LIBRARY_PATH (Solaris)
SHLIB_PATH (HP-UX) LIBPATH or LD_LIBRARY_PATH (Linux)
Includes:
  • The /lib directory of the WebSphere InterChange Server installation
  • The /java/lib directory of the WebSphere MQ installation
CWJAVA Set to jre/bin/java in the WebSphere InterChange Server installation (the executable used to invoke InterChange Server components). This setting picks up the default Java Virtual Machine (JVM) in the PATH.
JVM_FLAGS


Java options for components other than the Server. Includes:
  • -mx512m (maximum heap size of 512 megabytes - configurable)
  • JAVA_PROPERTY_FLAGS (a variable that contains a list of Java properties)
JVM_ICS_FLAGS


Java for InterChange Server. Includes:
  • -Xmx512m (the same value as set by CW_MEMORY_MAX)
  • -Xss512k
  • CW_MEMORY_MAX(maximum heap size of 512 megabytes - configurable)
  • ORB_BUFFER_SIZE_PROP="-Dcom.ibm.CORBA.BufferSize=8192"
  • JAVA_PROPERTY_FLAGS (a variable that contains a list of Java properties)
  • -Duser.home=${CROSSWORLDS} (main user directory is $CROSSWORLDS)
MQ_HOME Set to the directory in which WebSphere MQ is installed. Installer sets this environment variable to the /WebSphere_MQ_inst_home/mqm directory. Verify with your UNIX system administrator that this directory is the location of the WebSphere MQ software. If it is not, set MQ_HOME to the correct location.
PATH Includes:
  • The /bin directory of the WebSphere InterChange Server installation
  • The /java/lib directory of the WebSphere MQ installation
  • The /mqseries directory of the WebSphere InterChange Server installation

It is recommended that the WebSphere business integration administrator account ( admin by default) source the ProductDir/bin/CWSharedEnv.sh file in its profile. Table 13 lists the possible shells and their corresponding profile files in the user's home directory.

Note:
This chapter assumes that you have set the CROSSWORLDS environment variable in your shell. Therefore, references to the directory in which InterChange Server software is installed are specified as ProductDir. For example, the ics_manager script resides in the directory ProductDir/bin.

Copyright IBM Corp. 1997, 2004