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:
- file allocation statements
- run-time options
- program parameters
- the name of your program
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:
- From the Debug Tool Utilities panel, select
the Debug Tool Setup File option.
- 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.
- 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.
- 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:
- From the Debug Tool Utilities panel, select the Debug Tool Setup
File option.
- 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.
- 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:
- 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.
- Enter the parameter string in one of the following ways:
- Type the parameter string in the Enter / to modify parameters field.
- Type a slash ("/") before the Enter / to modify parameters field and press Enter. The Debug Tool Foreground - Modify Parameter
String panel appears. Define your run-time options and suboptions by doing
the following steps:
- Define the TEST run-time option and its suboptions.
- Enter any Language Environment or Debug Tool run-time options and other program
parameters.
- Press PF3. DTSU creates the parameter string from the options that you
specified and puts it in the Enter / to modify parameters field.
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:
- Modify the statement directly on the Edit - Edit Setup File panel:
- Move your cursor to the statement you want to modify.
- Type the new information over the existing information.
- Press Enter.
- Modify the statement by using a select command:
- Move your cursor to the statement you want to modify.
- Type one of the following select commands:
- SA - Specify allocation information
- SD - Specify DCB information
- SS - Specify SMS information
- SP - Specify protection information
- SO - Specify sysout information
- SX - Specify all DD information by column display
- SZ - Specify all DD information by section display
- Press Enter.
To copy a statement, do the following steps:
- Move your cursor to the Cmd field of the statement
you want to copy.
- 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:
- Move your cursor to the Cmd field of the statement
you want to delete.
- Type D and press Enter. The statement is deleted.
To reorder statements in a concatenation, do the following steps:
- 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:
- Move your cursor to the Cmd field of the line right
above the line you want a new statement inserted.
- Type I and press Enter.
- 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.
|
This information center is powered by Eclipse technology. (http://www.eclipse.org)