Inspect Manual

Debugging PATHWAY Applications
Inspect Manual—429164-006
5-15
Guidelines for Debugging User Conversion Routines
Starting to Debug a Running TCP
If you want to debug the user conversion routines in a running TCP, you can start to
debug the TCP using one of two methods:

You can enter the command interpreter command DEBUG:
If you do not use the TERM clause, Inspect will use the TCP's home terminal as the
Inspect command terminal.

You can enter the Inspect command ADD PROGRAM:
Both of these methods require that you know the process ID of the TCP. To discover
the process ID of the TCP, use the PATHCOM command STATUS TCP:
After you enter the DEBUG or ADD PROGRAM command, the TCP enters the hold
state as soon as it completes executing the current machine-code instruction. If the
TCP has invoked a procedure, it will not enter the hold state until the procedure returns
control to the TCP.
Guidelines for Debugging User Conversion Routines
Because the TCP is a process, the guidelines for debugging processes apply to user
conversion routines as well. For more information, see Guidelines for Debugging a
Process on page 4-10.
Ending the Debugging Session
You can end the debugging session by entering either the EXIT command or the
RESUME * EXIT command. Neither of these commands alters the PATHWAY
environment, so you should enter PATHCOM and restore PATHWAY to the status it
had before you began debugging.
When you enter the EXIT command, Inspect terminates the Inspect session, but it
leaves the programs that you were debugging in their current states. Consequently,
you should use the EXIT command only after you have cleared all breakpoints in all
programs and resumed execution of any programs in the hold state. The RESUME *
EXIT command performs these cleanup tasks for you.
When you enter the RESUME * EXIT command, Inspect clears all breakpoints from all
programs on the program list and resumes execution of any programs in the hold state.
It then terminates the Inspect session after a prompt.
17> DEBUG process-id, TERM $INSPECT-command-term
--ADD PROGRAM process-id
=STATUS TCP tcp-name