H-Series Application Migration Guide (H06.03+)

Migrating TNS Applications to H-Series Systems
H-Series Application Migration Guide—429855-006
B-10
H-Series TNS Debugging Tools
Inspect
H-series Inspect is similar to G-series Inspect; the syntax is identical and it offers most
of the same commands. Its use is limited to accelerated or interpreted TNS programs,
including Screen COBOL programs; it cannot be used with TNS/E native programs.
Using H-series Inspect, you can do symbolic debugging at the source statement level
in either interpreted or accelerated execution modes. The following G-series Inspect
commands are not available in H-series Inspect. (Since OSS TNS processes are not
supported on H-series systems, there is no need for these commands.)
SELECT SYSTYPE
SIGNALS
The following Inspect commands are changed or have different behavior in H-series
Inspect:
For TNS processes, H-series Inspect can be used as a replacement for the G-series
Debug facility. H-series Inspect provides a familiar debugging tool for TNS
programmers who use Inspect on G-series systems.
Inspect Command Change for H-series Inspect
ADD PROGRAM Cannot specify a TNS/E native process or snapshot file. If a TNS/E
native process or snapshot file is specified, an error message is
issued.
DISPLAY
REGISTER BOTH
Does not display TNS/E registers. If this command is entered, TNS
registers are displayed and a warning message is issued.
ICODE Output shows memory exact and register exact points for an OCA
accelerated process but not for a snapshot file based on an OCA
accelerated process.
ICODE location
BOTH
Does not display TNS/E instructions. If this command is entered, TNS
instructions are displayed and a warning message is issued.
INFO OBJECTFILE Cannot read TNS/E native object files.
INFO SAVEFILE Cannot read TNS/E native snapshot files.
SELECT
PROGRAM
Cannot specify a TNS/E native object file for the CODE or LIB option.
If a TNS/E object file is specified, an error message is issued.
SOURCE Output shows register-exact and deleted statement annotations for an
OCA accelerated process but not for a snapshot file based on an OCA
acceleration.
TRACE Output does not show symbolic information or procedure names for
TNS/E native frames. Output is unchanged for TNS frames. See note
following this table.
Note. H-series Inspect shows a TNS/E call site location as a 32-bit hexadecimal number. Although H-
series Inspect does not support TNS/E native processes, a TNS process can be held at a TNS/E code
location. For example, a TNS process can be held due to a memory access breakpoint (MAB), stop
event, or abend event.