Browse Prior Art Database

Brktfmt - A Program to Bracket And Make More Readable Formatted Traces From Os/2 EE Database Manager

IP.com Disclosure Number: IPCOM000121037D
Original Publication Date: 1991-Jul-01
Included in the Prior Art Database: 2005-Apr-03
Document File: 5 page(s) / 193K

Publishing Venue

IBM

Related People

Sirkin, J: AUTHOR [+2]

Abstract

The formatted traces provided by the OS/2* EE Database Manager are very difficult to read. These traces are used by developers when coding, debugging and looking at bug reports. The traces can be over 300,000 bytes long (and well over 20 pages long), and are hard to read quickly and well.

This text was extracted from an ASCII text file.
This is the abbreviated version, containing approximately 43% of the total text.

Brktfmt - A Program to Bracket And Make More Readable Formatted Traces
From Os/2 EE Database Manager

      The formatted traces provided by the OS/2* EE Database
Manager are very difficult to read.  These traces are used by
developers when coding, debugging and looking at bug reports.  The
traces can be over 300,000 bytes long (and well over 20 pages long),
and are hard to read quickly and well.

      BRKTFMT is a two-pass program which takes a formatted trace
file as an input, and creates a more readable trace file in one of
many output forms (depending on the options selected).

      The primary motivation for the program is that it is very
useful, when reading traces, to know at a glance which procedures
were entered in the program, but not exited. This helps locate where
the error occurred in the code, and helps identify the flow of
execution that led up to it. This concept leads to the primary output
format of "bracketing."  Bracketing means that a square bracket is
placed (on the left of the screen) around each procedure which was
entered and exited in the program execution. Procedures which were
entered and exited inside of other procedures (nested calls) have
nested brackets in the output. Further, bracketing entry and exit
traces of procedures helps identify the inter-component data flow in
Database Manager.

      BRKTFMT uses a "smart-stack".  What this does is to make sure
that the only procedures which are bracketed are ones in which there
is both an input and output trace.  If there is a procedure with an
entry and no exit, or an exit trace with no entry trace, the stack
processing does not bracket the procedure. Further, there are user
options so that specific process(es), and/or specific thread(s) can
be bracketed.
***************************************************************
      What follows is the documentation for BRKTFMT:
      NAME
        BRKFMT -- A program to take formatted traces and to
                  alter them to a more useful output format.
      SYNOPSIS
        Usage :   BRKTFMT [-abhlprt2] <input file> <output file>
                    Where [-abhlprt2]  = are options you may
                                         choose to select.
                    Where <input file> is the input formatted
                                         trace.
                    Where <output file> is the OPTIONAL output
                                         file name.
      Type BRKTFMT -h for complete help.
      DESCRIPTION

      BRKTFMT is a utility which reformats SQL trace formats. The
input to the program is an output trace from SQLTFMT.  Depending on
the output option you select, BRKTFMT will read through the input
file and will rewrite the file in a...