HP 800 ACSE/Presentation and ROSE Interface Programmer's Guide - Page 76

Ap_trace_file, Ap_trace_max_udata

Get HP 800 PDF manuals and user guides View all HP 800 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 76 highlights

Table 5-1 Troubleshooting Your Application Using ROSE API Tracing AP_TRACE_FILE: The name of the file that is to receive tracing results. Default = stderr. AP_TRACE_MAX_UDATA: The maximum amount of user data (in bytes) that will be displayed when parameters are displayed. Default = 16. Tracing Using Global Variables ROSE API tracing is controlled by three global variables. The variables are described below: ROSE Trace Variables rose_trace An integer value which constitutes a bitmask to control the level of tracing performed. By default this mask is 0 rose_trace_fp A pointer to a UNIX file to receive the tracing output. By default this is set to stderr. rose_trace_max_udata The maximum amount of user data (in bytes) that will be displayed during tracing. The default is 16. Selecting Types of Tracing The level of ROSE tracing is controlled by the rose_trace variable. The rose_trace variable is defined as a bitmask that can be set to particular values (as defined in the file /opt/ots/lib/api_trace.h) and as listed in Table 5-1. For example, if you want to trace output parameters only, you would set rose_trace to API_TR_OUTPUT. 76 Chapter 5

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
76
Chapter 5
Troubleshooting Your Application
Using ROSE API Tracing
AP_TRACE_FILE:
The name of the file that is to receive tracing results.
Default = stderr.
AP_TRACE_MAX_UDATA:
The maximum amount of user data (in bytes) that will be displayed
when parameters are displayed.
Default = 16.
Tracing Using Global Variables
ROSE API tracing is controlled by three global variables. The variables
are described below:
Table 5-1
ROSE Trace Variables
Selecting Types of Tracing
The level of ROSE tracing is controlled by the rose_trace variable.
The rose_trace variable is defined as a bitmask that can be set to
particular values (as defined in the file /opt/ots/lib/api_trace.h) and as
listed in Table 5-1.
For example, if you want to trace output parameters only, you would set
rose_trace to API_TR_OUTPUT.
rose_trace
An integer value which constitutes a
bitmask to control the level of tracing
performed. By default this mask is 0
rose_trace_fp
A pointer to a UNIX file to receive the
tracing output. By default this is set to
stderr.
rose_trace_max_udata
The maximum amount of user data (in
bytes) that will be displayed during tracing.
The default is 16.