# Start debug

Displays the Start Debug dialog for starting a debugging session.

Selecting Start Debug from the Debug Manager starts the System Debugger application on the client and begins the specified debugging operation. Selecting Start Debug from the System Debugger begins the specified debugging operation.

This function is available from the:

- Context menu
- Menu bar Debug -->Start Debug
- Shortcut key F4
- Tool bar

The Start Debug dialog dynamically changes appearance, depending on the debug method and type of program object that you want to debug. The dialog does not display all of the following options at the same time.

## Select debug method

Submit and debug program in batch job

> Submit a batch job that calls the specified program object that you want to debug.

Debug existing job on system

> Start a debug session to service the existing specified job, which can be active, on hold, or in a job queue that is on hold.

Debug PASE

> Select to specify PASE debug for the session. A second debug tab will appear allowing both the ILE and PASE attributes of the target job to be debugged. This option is useful if the target job has both ILE and PASE attributes.

## Program to debug

Depending on the debug method, you can debug programs, service programs, or class files.

Type

> From the list, select the type of program object that you want to debug. Possible choices are:

> - Program
> - Service Program
> - Class File

> Tip: Click Recent... to display a list of program objects that you have previously opened with the system debugger.

Name or Package

> Name: This option is active for programs and service programs. Type the name of the program or service program to debug.

> Package: This option is active for class files. Type the package name of the class file that you want to debug.

Library or Class name

> Library: This option is active for programs and service programs. Type the name of the library that contains the program or service program.

> Class name: This option is active for class files. Type the name of the class that you want to debug.

Parameters

> (Optional): Type any parameters or Java properties that you want to pass to the program object or click Edit... to display a dialog that enables you to edit and save parameters.

> Note: Use the following format for Java properties: `-Dname=value`

Initialization command

> (Optional): Type a single control language command that you want to run before calling the program you want to debug. For example, you can use this command to set environment variables, library lists, and so on.

Standard I/O

> From the list, select the type of input/output that the program should perform. Possible choices are:

> - Send to spool file
> - Redirect to client

> Note: I/O that is redirected to the client appears in the Standard I/O panel. To send data to standard input; type the characters in the Standard Input entry field. Press the enter key to send the data with a terminating newline. Click on the Go button to send the data without a terminating newline.

Classpath

> (Optional): This option is active for class files. Type the classpath or click Edit... to display a dialog that enables you to edit and save the classpath.

Host source path

> (Optional): This option is active for class files. Type the host source path or click Edit... to display a dialog that enables you to edit and save the host source path.

Client source path

> (Optional): This option is active for class files. Type the client source path or click Edit... to display a dialog that enables you to edit and save the client source path.

> Note: The Debug Manager searches for Java files in the following order:

> 1. The same directory that contains the corresponding .class file
> 2. The path specified in Host source path
> 3. The path specified in Client source path

## Existing job to debug

Selecting Submit existing job on system when you are debugging a program, service program, or class file activates this panel.

Job Name

> Type the name of the job to service.

> - Tip: Click Browse... to search for and automatically enter the required information for an existing job.

Job User

> Type the user profile associated with the job to service.

Job Number

> Type the job number of the job to service.