Setting the environment

Two options need to be specified to provide configuration information for the C Bindings. One specifies the location of options that are passed to the underlying Java VM, the other controls trace.

JVM options

You need to create a text file that contains options for the underlying JVM. The location of this can be specified either by a registry entry, or as an environment variable. The registry key takes precedence over the environment variable.

The registry key is HKEY_LOCAL_MACHONE\SOFTWARE\IBM\MQe\CurrentVersion\Bindings with a String value of OptionsFile.

The environment variable is MQE_VM_OPTIONS_LOCN. This variable points to the location of a text file that contains the options for the underlying JVM and it must be set.

In general, the JVM options can be specified on the Java command line, for example to set the classpath:

java -Djava.class.path=e:\myclasspath myClassToRun

The configuration file uses the same style to pass configuration options. Multiple options can be given to the JVM, and the configuration file should contain such options, one on each line. The following is an example configuration file:

#Example configuration file 
	-Djava.class.path=e:\MQe;e:\MyApplicationClasses
	-Djava.compiler=NONE
Note:
If you do not specify the above configuration options the JVM will not create, returning:

Trace options

Trace in enabled with a registry key, HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQe\CurrentVersion\Trace.

All values are of type REG_SZ. The is the following two values are the minimum required for trace to be produced:

Enable=Yes 
Location=c:\my\directory\structure\mqetrace

Where enable turns trace on and the location is the directory in which trace files are produced. This directory is created if it does not exist already.

In addition to these required values, there are a number of optional entries that affect the output trace.

Note:
Enabling trace can produce very large files and, in general, you should only enable trace if instructed to by an IBM Support Representative.


© IBM Corporation 2002. All Rights Reserved