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

Using ROSE API Tracing

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 75 highlights

Troubleshooting Your Application Using ROSE API Tracing Using ROSE API Tracing Tracing is enabled in your application program and the tracing output is printed to a trace file. Different levels of tracing are provided with the trace facility. For example, you can trace procedure entry and exits, error conditions, or both. ROSE tracing has been implemented to be consistent with ACSE/Presentation tracing. Environment Variable Names The names of the ROSE environment variables available are as follows: ROSE_TRACE ROSE_TRACE_FILE ROSE_TRACE_MAX_UDATA The effect of these environment variables below. AP_TRACE: These values indicates the trace level to be used for each API call. It is actually a set of flags, defined in the file //opt/ots/lib/api_trace.h. Default = 0 (trace_off). You may set this value in one of two ways: 1. It may be treated as an integer value and may be set using either decimal or hexadecimal notation, for example: AP_TRACE=0xff 2. It may be treated as a set of ASCII flags. The following standard flags are defined. i = input parameters o = output parameters x = external procedure entry exit e = error tracing n = internal tracing Chapter 5 75

  • 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
Chapter 5
75
Troubleshooting Your Application
Using ROSE API Tracing
Using ROSE API Tracing
Tracing is enabled in your application program and the tracing output is
printed to a trace file. Different levels of tracing are provided with the
trace facility. For example, you can trace procedure entry and exits, error
conditions, or both. ROSE tracing has been implemented to be consistent
with ACSE/Presentation tracing.
Environment Variable Names
The names of the ROSE environment variables available are as follows:
ROSE_TRACE
ROSE_TRACE_FILE
ROSE_TRACE_MAX_UDATA
The effect of these environment variables below.
AP_TRACE:
These values indicates the trace level to be used for each API call. It is
actually a set of flags, defined in the file //opt/ots/lib/api_trace.h.
Default = 0 (trace_off).
You may set this value in one of two ways:
1.
It may be treated as an integer value and may be set using either
decimal or hexadecimal notation, for example:
AP_TRACE=0xff
2.
It may be treated as a set of ASCII flags. The following standard flags
are defined.
i = input parameters
o = output parameters
x = external procedure entry exit
e = error tracing
n = internal tracing