EPTRACE Manual

Using EPTRACE
EPTRACE Manual—528811-002
2-2
EPTRACE Usage Considerations
EPTRACE Usage Considerations
•
Separate multiple commands on the command line using a semicolon.
•
You can use comments on the command line. Any text after the “--” is a comment.
•
You may split a command line entry over multiple lines by entering the continuation
character “\” before pressing the return key at the end of each intermediate line.
•
EPTRACE may need to display tracing information that exceeds 23 lines. When
this happens you are prompted to continue with the display. Press “Y”, the space
bar, or the Enter key to continue with the display. Pressing BREAK, Ctrl-Y, or any
other character returns you to the TACL prompt.
Sample EPTRACE Session Sample
> EPTRACE
START PROGRAM fred -- Trace program of interest
--<Run program fred from a separate TACL prompt>
SHOW PROGRAM fred --Display traced information
STOP PROGRAM fred --Stop tracing
Analyzing EPTRACE Data
When tracing is enabled, EPTRACE also displays data about misalignment events,
unexpected transitions to or from accelerated or unaccelerated code, and relative
segment 2 or 3 problems. You should eliminate some potential trace events before you
run EPTRACE if they occur in the hundreds per second.
Locating problematic source lines
eNoft may be used to translate a program file address to an approximate source line
(approximate because aggressive code optimization may move instructions out of
order; C++ function inlining may cause further obfuscation).
Event RESOLUTION
NATIVE_MISALIGNMENT Fix source program errors.
TNS_MISALIGNMENT Fix source program errors.
RELSEG2OR3 For frequent occurrences, fix source program
errors. You should recompile TNS COBOL 85
programs using the compiler version released on or
after 15JUN91.
FROM_ACC For frequent occurrences try re-Accelerating the
code using different options, recompiling the source
program, or fixing source program errors.