Rational Developer for System z, Version 7.6

Starting Debug Tool from the Debug Tool Utilities

The Debug Tool Setup File option (also called Debug Tool Setup Utilities or DTSU) in Debug Tool Utilities helps you manage setup files which store the following information:

Then you use the setup files to run your program in foreground or batch. The Debug Tool Setup Utility (DTSU) RUN command performs the file allocations and then starts the program with the specified options and parameters in the foreground. The DTSU SUBMIT command submits a batch job to start the program.

Refer to the following topics for more information related to the material discussed in this topic.

Creating the setup file

You can have several setup files, but you must create them one at a time. To create a setup file, do the following steps:

  1. From the Debug Tool Utilities panel, select the Debug Tool Setup File option.
  2. In the Debug Tool Foreground - Edit Setup File panel, type the name of the new setup file in the Setup File Library or Other Data Set Name field. Do not specify a member name if you are creating a sequential data set. If you are creating a setup file for a DB2® program, select the Initialize New setup file for DB2 field. Press Enter.
  3. A panel similar to the ISPF 3.2 "Allocate New Data Set" panel appears. You can modify the default allocation parameters. Enter the END command or press PF3 to continue.
  4. The Edit - Edit Setup File panel appears. You can enter file allocation statements, run-time options, and program parameters.

Refer to the following topics for more information related to the material discussed in this topic.

Editing an existing setup file

You can have several setup files, but you can edit only one file at a time. To edit an existing setup file, do the following steps:

  1. From the Debug Tool Utilities panel, select the Debug Tool Setup File option.
  2. In the Debug Tool Foreground - Edit Setup File panel, type the name of the existing setup file in the Setup File Library or Other Data Set Name field. Press Enter to continue.
  3. The Edit - Edit Setup File panel appears. You can modify file allocation statements, run-time options, and program parameters.

Refer to the following topics for more information related to the material discussed in this topic.

Copying information into a setup file from an existing JCL

You can enter the COPY command to copy an EXEC statement and its associated DD statements from another data set containing JCL.

Entering file allocation statements, run-time options, and program parameters

The top part of the Edit-Setup File panel contains the name of the program (load module) that you want to run and the run-time parameter string. If the setup file is for a DB2 program, the panel also contains fields for the DB2 System identifier and the DB2 plan. The bottom part of the Edit-Setup File panel contains the file allocation statements. This part of the panel is similar to an ISPF edit panel. You can insert new lines, copy (repeat) a line, delete a line, and type over information on a line.

To modify the name of the load module, type the new name in the Load Module Name field.

To modify the parameter string:

  1. Select the format of the parameter string and whether the program is to start in the Language Environment. Non-Language Environment COBOL programs do not run in Language Environment. If you are debugging a non-Language Environment COBOL program, select the non-Language Environment option.
  2. Enter the parameter string in one of the following ways:

In the file allocation section of the panel, each line represents an element of a DD name allocation or concatenation. The statements can be modified, copied, deleted, and reordered.

To modify a statement, do one of the following steps:

To copy a statement, do the following steps:

  1. Move your cursor to the Cmd field of the statement you want to copy.
  2. Type R and press Enter. The statement is copied into a new line immediately following the current line.

To delete a statement, do the following steps:

  1. Move your cursor to the Cmd field of the statement you want to delete.
  2. Type D and press Enter. The statement is deleted.

To reorder statements in a concatenation, do the following steps:

  1. Move your cursor to the sequence number field of a statement you want to move and enter the new sequence number.

To insert a new line, do the following steps:

  1. Move your cursor to the Cmd field of the line right above the line you want a new statement inserted.
  2. Type I and press Enter.
  3. Move your cursor to the new line and type in the new information or use one of the Select commands.

The Edit and Browse line commands allow you to modify or view the contents of the data set name specified for DD and SYSIN DD types.

You can use the DDNAME STEPLIB to specify the load module search order.

For additional help, move the cursor to any field and enter the HELP command or press PF1.

Refer to the following topics for more information related to the material discussed in this topic.

Saving your setup file

To save your information, enter the SAVE command. To save your information in a second data set and continue editing in the second data set, enter the SAVE AS command.

To save your setup file and exit the Edit-Edit Setup File panel, enter the END command or press PF3.

To exit the Edit-Edit Setup File panel without saving any changes to your setup file, enter the CANCEL command or press PF12.

Refer to the following topics for more information related to the material discussed in this topic.

Starting your program

To perform the allocations and run the program with the specified parameter string, enter the RUN command or press PF4.

To generate JCL from the information in the setup file and then submit to the batch job, enter the SUBMIT command or press PF10.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)