Search VisualAge for Java Information Go to Information Home Page Go to VisualAge for Java WWW Site

Debugger Settings dialog box

Restriction: This dialog box applies only when debugging on the AS/400.

Use the Debugger Settings dialog box to modify debugger environment settings, JVM creation settings, and BCI job creation settings.

Jobs that are running on the AS/400 are either BCI (enabled to run a threaded application) or interactive (enabled to run an application with input/output). BCI jobs are also referred to as batch immediate or batch jobs. Both BCI and interactive jobs can be attached to by the debugger. When a non-Java application is loaded into the debugger, a BCI job is automatically created on the AS/400. When a Java class is loaded into the debugger, an interactive JVM is created.

Note: Interactive applications should not be run in a BCI job.

Debugger settings are gathered into related groupings. To see and gain access to all possible areas of debugger settings, expand the display tree shown in the left part of the Debugger Settings dialog box.

Settings groupings and controls in these groupings are described below. Control group and subgroup names appear in italics, and control names appear in bold.


Session Settings Debugger environment settings appear when Session Settings is selected. Controls in this group are:
Host Name Specify the name of the AS/400 host on which you are debugging your applications in this field. You can enter the host name in one of the following formats:
  • An IP address, such as 9.99.99.99
  • A hostname which is defined in your local host table or on a name server to which you link, such as name.name.name.com

To determine the IP address of your AS/400, type GO CFGTCP on an AS/400 command line, and choose menu option 12 = Change local domain and host names.

Note: Be careful not to change the local domain name and hostname when you use this option.

The default setting is none.

Source Path In this field, you can specify the search path for locating source either on your workstation or on the AS/400 IFS drive. To indicate that your search path addresses the AS/400 IFS drive, simply put a '/' at the beginning of the field entry. For example:

/home/mypath;/home/yourpath

Note: Individual search path entries are separated by a semicolon.

The default setting is none.

Port Number You need to specify the port number only if you want to connect to the AS/400 using a port other than the default port.

Use this field to specify the port permanently used by the AS/400 debug server. Enter a value between 1 and 64,767 that matches the port number specified for the QDBGSVR entry on the AS/400.

By default, the port number is set to 3001.

Update Production Files If checked, database files in a production library can be opened for updating or adding records. If not checked, production files will not be updated, and you will run into an exception when the program tries to access the files.

The default is not to update production files.


JVM Creation Settings Use this group to specify the CLASSPATH variable for the JVM in which classes under debug will execute. The CLASSPATH variable indicates to the JVM which IFS directories to search for the Java classes. Controls in this group are:
CLASSPATH In this field, specify the CLASSPATH.

The CLASSPATH variable is mandatory. It defaults to /QJAVA.


JVM Creation Settings->Environment Variables Use this group to specify all AS/400 environment variables other than CLASSPATH for the job in which the Java Virtual Machine will run on the AS/400.

To add an environment variable, click on the Variable and Value cell fields of the initial highlighted row and make the appropriate entries. To add additional variables, press the keyboard Insert key to create rows for as many variables as you wish to add.

To edit variable names or values, click on the appropriate table cell and change the cell contents.

To delete a variable and its value, select the appropriate row, and press the keyboard Delete key.

Note: AS/400 environment variable names and values may not contain blanks. The environment variable value may not be an empty string.


JVM Creation Settings->JNI Library List Use this group to specify the libraries the debugger should search to locate programs on the AS/400. This group is useful when debugging Java applications that make JNI and program calls.

The first 20 valid AS/400 libraries will be added to the Library List.

To add a library, click on the first Library List cell field and make the appropriate entries. To add additional libraries, press the keyboard Insert key to create rows for as many libraries as you wish to add.

To edit library names, click on the appropriate table cell and change the cell contents.

To delete a library from the library list, select the appropriate row, and press the keyboard Delete key.

Other controls in this group are:

Current Library Specify the name of the first library to be used when debugging.

JVM Creation Settings->Properties Specify property names and values that will be passed to the Java Virtual Machine. These can be retrieved by the Java program running on the AS/400. (See your Java documentation for more information.)

To add a variable, click on the Variable and Value cell fields of the initial highlighted row and make the appropriate entries. To add additional variables, press the keyboard Insert key to create rows for as many variables as you wish to add.

To change variable names or values, click on the appropriate table cell and change the cell contents.

To delete a variable and its value, select the appropriate row, and press the keyboard Delete key.

Note: Property names and values may not contain blanks. The property value may not be an empty string.


Batch Job Creation Settings There are no controls in this settings grouping.

Batch Job Creation Settings->Environment Variables Use this group to specify all AS/400 environment variables and their values for the batch immediate job which has been created on the AS/400, and where the application under debug will execute. Use this group if you did not specify the job number in the Load Program dialog.

Note: Interactive applications should not be executed in the batch immediate job.

To add an environment variable, click on the Variable and Value cell fields of the initial highlighted row and make the appropriate entries. To add additional variables, press the keyboard Insert key to create rows for as many variables as you wish to add.

To edit variable names or values, click on the appropriate table cell and change the cell contents.

To delete a variable and its value, select the appropriate row, and press the keyboard Delete key.

Note: AS/400 environment variable names and values may not contain blanks. The environment variable value may not be an empty string.


Batch Job Creation Settings->Library List Use this group to specify the libraries the debugger should search to locate programs on the AS/400.

The first 20 valid AS/400 libraries will be added to the Library List.

To add a library, click on the first Library List cell field and make the appropriate entries. To add additional libraries, press the keyboard Insert key to create rows for as many libraries as you wish to add.

To edit library names, click on the appropriate table cell and change the cell contents.

To delete a library from the library list, select the appropriate row, and press the keyboard Delete key.

Other controls in this group are:

Current Library Specify the name of the first library to be used when debugging.

Debugger Settings Push-buttons
OK Saves your selected or entered settings to the debugger, then closes the Debugger Settings dialog box. Settings are saved for the current debug session and enabled for future sessions

If incorrect values were specified, the dialog box will not close. The field which contains the error will be marked in red and with a hover help error dialog.

Cancel Closes the Debugger Settings dialog box without changing any debugger settings.
Help Displays this panel.