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 when you enter the name of the new set up
file in the Other Data Set Name field. 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.
Debug Tool Utilities does not support reordering the
DD names, only the data sets within each concatenation. The DD names
are automatically sorted in alphabetical order. 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)