High-Level Screen Management Intrinsic Library Reference Manual (32424-90002)

C-: 1
Appendix C Diagnostics and Sample Programs
This appendix discusses the Hi-Li diagnostic facility and version
utility, and provides sample application programs written in COBOL,
FORTRAN, and Pascal that demonstrate the use of Hi-Li intrinsics.
Hi-Li Diagnostics Trace Facility
The Hi-Li intrinsic diagnostic facility is an application debugging tool
that can be used to diagnose applications that use Hi-Li intrinsics. It
shows:
* intrinsic entry and exit,
* intrinsic formats, and
* parameter contents.
To enable the Hi-Li trace facility, set the DEXLIBTRACE job control word
to 1.
SETJCW DEXLIBTRACE,1 Return
Diagnostic information is written to the file HPDTRACE. Trace messages
are appended to the file. Note that subsequent traces are appended to
the same file. You may want to purge the trace file (HPDTRACE) before
performing subsequent traces.
To save a trace file, use the MPE BUILD command to build an 80-character
ASCII file. Then, use any editor to view the file. For example,
BUILD HPDTRACE; rec = -80,1,F,ASCII
You can also direct the trace file to a terminal by using the MPE FILE
command. If you do this, the application I/O must be directed to a
different terminal. Use this command to redirect the I/O:
FILE HPDTRACE = $STDLIST
The following is a sample trace for an application using Hi-Li
intrinsics.
Example of a Trace File
>>>> Entered HPDOPENFORMS
Globalpak.expectedvuf = A.00.10
.callprotocol = 0
.comarealen = 300