op_trace_resume()
Abstract
Reactivates tracing that was suspended with op_trace_suspend().
Syntax
op_trace_resume ()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Type
void
No return value.
Example
/* allocate a list */
list_ptr = (List *) op_prg_mem_alloc (sizeof (List));
/* initialize a list */
op_prg_list_init (list_ptr);
/** move the contents of subqueue #0 into the list **/
/* determine the number of packets in the subqueue */
subq_size = op_subq_stat (0, OPC_QSTAT_PKSIZE);
/* don't bother tracing the inserts */
op_trace_suspend();
for (i = 0; i < subq_size; i++)
{
/* take a single packet from the subqueue head */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);
/* insert the packet onto the list tail */
op_prg_list_insert (list_ptr, pkptr, OPC_LISTPOS_TAIL);
}
/* reactivate tracing */
op_trace_resume();
Details
This KP has no effect when ODB is not enabled.
For every call to op_trace_suspend(), there must be a matching call to op_trace_resume() before tracing is reactivated. If multiple calls to op_trace_suspend() occur before the first op_trace_resume(), tracing will not resume until an equal number of op_trace_resume() calls have been made. For example:
op_trace_suspend();
...
op_trace_suspend();
...
op_trace_resume(); // Still suspended
...
op_trace_resume(); // Tracing resumed (both suspends have been matched)
Traces that have been suspended by the ODB “susptrace“ command will not be reactivated by op_trace_resume(). These traces will remain suspended until an “acttrace“ command reactivates them.
Purpose
Provides a way to resume tracing in ODB after temporarily suspending it with op_trace_suspend().
Errors
- None.
Reference
- None.