DCE for the HP e3000 (B3821-90002)

Programming Notes

Threads Architecture

Chapter 4

[init_thread_pin].tin speciﬁcation speciﬁes a stop-all-threads breakpoint option.

For example:

Example Breakpoint Description

B thd_mtx:2e.2 Sets a breakpoint at thd_mtx to be recognized by tin

2 of the task with initial thread 2e.

B thd_mtx:.2 Sets a breakpoint at thd_mtx to be recognized by tin

2 of the current task.

B start_thread:2c.@ Sets a task-wide breakpoint at start_thread to be

recognized by all threads within the task with initial

thread 2c.

B start_thread:.@ Sets a task-wide breakpoint at start_thread to be

recognized by all threads within the current task.

B HPFOPEN::@ Sets a breakpoint at HPFOPEN for the current pin

(tin) with the stop-all-threads option that is honored

if the pin belongs to a threaded task.

B HPFOPEN:.3:@ Sets a breakpoint at HPFOPEN for tin 3 of the

current task, and the breakpoint has the

stop-all-threads option.

B HPFOPEN:.@:@ Sets a task-wide breakpoint at HPFOPEN for the

current task, and the breakpoint has the

stop-all-threads option.

Commands

The following commands aid in debugging threaded applications.

Command Description

TIN [init_thread_pin.]tin This command causes debug to switch to the

environment of the speciﬁed tin. The default

init_thread_pin is that of the current task. Privilege

mode is required to switch to any tin in another task.

SUSPEND This command suspends all other threads within the

task of the tin being debugged. The suspended

threads are not resumed automatically with the

continue command.

ACTIVATE This command resumes the threads that were

suspended by the SUSPEND command. It should be

issued from the same tin that issued the SUSPEND

command.

Environmental Variables

There are two environment variables that simplify debugging applications:

Environment Variable Description

SS_TERM_KEEPLOCK When set to TRUE, a pin (tin) being debugged

retains the terminal semaphore while

single-stepping. This prevents any other pin (tin),