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 without specifying a job, a BCI job is automatically created on the AS/400. When you load a Java class without specifying a job, 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.
Host Name

Specify the name of the AS/400 host on which you are debugging your applications. 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 AS/400 TCP/IP address, type GO CFGTCP on an AS/400 command line, and choose menu option 12 = Change local domain and host names. Be careful not to change the local domain name and hostname when you use this option.

If you always debug on the same AS/400 host, specifying that host name in this field will eliminate the need for you to log on to the host every time you load a new program, display the job list, or change the debugger settings.

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, type a solidus (/) at the beginning of the field entry. Separate individual search path entries with a semicolon. For example:

/home/mypath;/home/yourpath

The default setting is none.

Port Number You only need to change the port number if you want to connect to the AS/400 using a port other than the default port. By default, the port number is set to 3001.

Use this field to permanently specify the port 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.

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.


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.


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.


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.