Native Inspect Manual (H06.04+)

Syntax of Native Inspect Commands
Native Inspect Manual—528122-005
4-7
Syntax of Common Command Elements
to specify a code location within a subprocedure.
Specifying Code Locations for COBOL Programs
To specify a code location for a COBOL program, you use a line specification, as
defined previously. A line specification specifies a single source line. It is used by
commands that specify a single source line, such as the list command for listing source
lines and the break command for specifying where to set an instruction breakpoint. You
can use the line specifications described under Syntax of linespec on page 4-6 to
specify code locations in a COBOL program.
When debugging a COBOL program, you can also identify a code location using
paragraphs, line numbers, program units (including nested program units), instructions,
and sections. To specify one of these code locations, use one of the following notations
in the line specification:
program-unit [.program-unit] ...
[section.]paragraph
paragraph [of section]
These syntax elements enable you to qualify the code location in cases where the
code location is not unique within the program.
Syntax of native-address
native-address
is a 32-bit or 64-bit address. native-address can be specified in these formats:
•
hexadecimal (for example, 0x120001DC0)
•
decimal (for example, 48331845824)
Note.
•
In a paragraph number, the leading zero is significant.
•
If linespec consists entirely of digits, and that string of digits matches both a paragraph
name and a line number in the program unit, Native Inspect uses the paragraph name. To
specify the line number in this case, use the filename:line-number notation.
•
COBOL paragraph names need not be unique within a program unit. To differentiate
among paragraphs with the same name, specify a qualified paragraph name using the
section.paragraph or paragraph of section notation. If you specify a paragraph
name that is not unique within a program unit, Native Inspect issues an error indicating
that the name is ambiguous and that further qualification is required.
•
Native inspect does not support the program-unit.label, or program-unit.line-
number notation.
•
Native Inspect does not support setting breakpoints on statement ordinals.