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, Java Virtual Machine (JVM) creation settings, and batch immediate (BCI) job creation settings.

Jobs on the AS/400 can be one of the following:

The debugger can attach to all types of jobs. When you load a non-Java application, a BCI job is automatically created on the AS/400. When you load a Java class, a Java Virtual Machine (JVM) is created on the AS/400.

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

Settings groupings, and controls 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.
Update Production Files If this box is selected, database files in a production library can be opened. If it is not selected, production files will not be accessed, and you will run into an exception when the program tries to open the files.

The default is not to update production files.

Local Source Path In this field, you can specify the search path for locating source on your workstation. Separate individual search path entries with a semicolon. For example:

c:/directory1/mypath;d:/directory2/yourpath

The default setting is none.

IFS Source Path Specify the search path for locating source on the AS/400 IFS drive, typing a solidus (/) at the beginning of the field entry. Separate individual search path entries with a colon. For example:

/home/mypath:/home/yourpath

The default setting is none.


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.
CLASSPATH In this field, specify the CLASSPATH.

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

Text in this field wraps for extra convenience. Do not press Enter while in this field.


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 the Variable and Value cell fields of the initial highlighted row and make the appropriate entries. To add additional variables, press the Insert key on the keyboard to create rows for as many variables as you wish to add.

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

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

Entries in the environment variables table can be reordered by dragging and dropping rows.

AS/400 environment variable names and values cannot contain blanks. The environment variable value cannot be an empty string.

Multiple environment variable entries of the same name are permitted. If multiple entries are made, the last one entered is used.


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 Java Native Interface (JNI) calls.

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

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

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

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

Entries in the library list table can be reordered by dragging and dropping rows.

Library names cannot contain blanks and cannot exceed 10 characters.

Current Library Specify the name of the current library for JNI calls.

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 property, click the Variable and Value cell fields of the initial highlighted row and make the appropriate entries. To add additional properties, press the Insert key on the keyboard to create rows for as many properties as you wish to add.

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

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

Entries in the properties table can be reordered by dragging and dropping rows.

Property names and values cannot contain blanks. The property value cannot be an empty string.

Multiple property entries of the same name are permitted. If multiple entries are made, the first one entered is used.


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 that is created on the AS/400 if the job number in the Load Program dialog box is not specified, and to specify where the application under debug mode will execute.

Do not run interactive applications in a batch immediate job.

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

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

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

Entries in the environment variables table can be reordered by dragging and dropping rows.

AS/400 environment variable names and values cannot contain blanks. The environment variable value cannot 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 when calling programs in a BCI job.

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

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

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

To delete a library from the Library List, select the appropriate row and press the Delete key.

Entries in the library list table can be reordered by dragging and dropping rows.

Library names cannot contain blanks and cannot exceed 10 characters.

Current Library Specify the name of the current library for program calls from BCI jobs.

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

If you specify incorrect values, the dialog box will not close. All fields which contain an error will be marked in red. Tool Tip Evaluation will give details when you position the cursor over the field containing the entry.

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