Rational Developer for System z
Enterprise COBOL for z/OS, Version 4.1, Compiler and Runtime Migration Guide


Command language comparison

Table 1 compares the command language of TESTCOB, COBTEST, and Debug Tool. As you can see, many of Debug Tool commands are different from the commands used in COBTEST and TESTCOB. In most cases, the function is identical.

Commands not supported by a specific debugger are indicated with a dash.

Table 1. Debug Tool command language comparison
TESTCOB command COBTEST command Debug Tool command Function
AT AT AT Set a breakpoint
- AUTO1 MONITOR LIST Automatically monitor variables
- COLOR1 PANEL COLORS Display panel to set color attributes
- DOWN2 WINDOW DOWN Move window down
DROP DROP CLEAR Delete a defined symbol
DUMP DUMP CALL %DUMP Produce a memory dump
END QUIT QUIT End the debug session
EQUATE EQUATE SET EQUATE or CLEAR EQUATE Define a symbol
- FLOW LIST LAST Collect control flow information
- FREQ SET FREQUENCY Tally the execution counts for verbs
GO GO GO Start execution of the COBOL program
HELP (TSO only) HELP3 HELP Provide online help information
IF IF IF Evaluate a condition
- LEFT2 WINDOW LEFT Move window left
- LINK LOAD or CALL5 Set up a LINKAGE SECTION
LIST LIST LIST, DESCRIBE6 List contents of variables
LISTBRKS LISTBRKS LIST AT List breakpoints in effect
- LISTEQ QUERY EQUATES List the defined symbols
LISTFILE LIST DESCRIBE ATTRIBUTES List attributes of a file
- LISTFREQ LIST FREQUENCY List frequency counts of verbs
- LISTINGS1 PANEL LISTINGS Display panel associating program with a listing
- MOVECURS1 CURSOR Move cursor from command line to a window or vice versa
NEXT NEXT STEP Set temporary breakpoint at next verb
- NORECORD SET LOG OFF Turn off debug session logging
OFF OFF CLEAR AT Turn off a breakpoint in effect
OFFWN OFFWN CLEAR AT Turn off a conditional breakpoint
- ONABEND AT OCCURRENCE CEExxxx Perform an action at occurrence of a Language Environment condition, where xxxx is the condition returned from Language Environment
- PEEK QUERY prefix Show breakpoints within a line
- POSITION1 SCROLL TO Move to a certain location of a displayed object
- PREVDISP1 -6 Show the last displayed user ISPF screen
- PRINTDD -7 Route the output to a data set
- PROC AT CALL Trap calls to certain subprograms
- PROFILE1 PANEL PROFILE Display panel to set user profile attributes
QUALIFY QUALIFY SET QUALIFY Change the current program qualify
- RECORD SET LOG ON Turn on logging of debug session
- RESTART RESTART8 Reinitialize program without exiting debugger
- RESTORE1 SET or QUALIFY RESET Return to current point of execution
- RIGHT2 WINDOW RIGHT Move window right
RUN RUN CLEAR AT then GO Remove breakpoints and run to completion
- SEARCH1 FIND Search for a string in displayed object
- SELECT SHOW Display a specific frequency count
SET SET MOVE or SET or COMPUTE Alter contents of a variable
SOURCE SOURCE9 WINDOW OPEN Display source program statements
- STEP STEP Execute specified number of verbs
- SUFFIX1 SET SUFFIX Turn on visual display of frequency
TRACE TRACE AT GLOBAL STATEMENT or AT GLOBAL PATH Trace flow of execution
- UP2 WINDOW UP Move window up
- VTRACE1 STEP Dynamic visual trace of program
WHEN WHEN AT * IF... Set up conditional breakpoint
- WHERE QUERY LOCATION List current point of execution
Notes:
  1. These commands are supported only with COBTEST FULL SCREEN debugging.
  2. The DOWN, LEFT, RIGHT, and UP commands are executed by ISPF. They are not actual COBTEST commands.
  3. HELP is supported only under TSO with COBTEST LINE MODE debugging.
  4. LINK in COBTEST provides real storage for the data items in the LINKAGE SECTION. Debug Tool accomplishes this by declaring those data names. It then calls the COBOL program, passing the necessary parameters.
  5. Debug Tool does not have a facility to list a range of names. However, it is possible to list all names for a block, or all names matching a specific pattern.
  6. The PREVDISP command is no longer required. Debug Tool does not use ISPF for display.
  7. The PRINTDD command is unnecessary for Debug Tool. The print file has a fixed ddname (although, the ddname can be specified at invocation.)
  8. The RESTART command is available only with the programmable workstation. Note, the RESTART command does not retain break settings as it did in COBTEST.
  9. The COBTEST SOURCE command is only supported in FULL SCREEN debugging. Also, the connotation is different from the TESTCOB SOURCE command.

Terms of use | Feedback

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