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

Tracing Using Global Variables, Selecting Types of Tracing

Page 70 highlights

Troubleshooting Your Application Using A/P API Tracing 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 A/P API tracing is controlled by three global variables. The variables are described below: ap_trace ap_trace_fp ap_trace_max_udata An integer value which constitutes a bitmask to control the level of tracing performed. By default this mask is 0. A pointer to a UNIX file to receive the tracing output. By default this is set to stderr. 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 A/P tracing is controlled by the ap_trace variable. The ap_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 the following table. For example, if you want to trace output parameters only, you would set ap_trace to API_TR_OUTPUT. 70 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

70
Chapter 5
Troubleshooting Your Application
Using A/P API Tracing
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
A/P API tracing is controlled by three global variables. The variables are
described below:
Selecting Types of Tracing
The level of A/P tracing is controlled by the ap_trace variable.
The ap_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 the following table.
For example, if you want to trace output parameters only, you would set
ap_trace to API_TR_OUTPUT.
ap_trace
An integer value which constitutes a
bitmask to control the level of tracing
performed. By default this mask is 0.
ap_trace_fp
A pointer to a UNIX file to receive the
tracing output. By default this is set to
stderr.
ap_trace_max_udata
The maximum amount of user data (in
bytes) that will be displayed during tracing.
The default is 16.