PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Generate paginated files with title page, headings, footers, etc.


MOVEMENT WITHIN THE PAL CARD CATALOG
Move to top-level taxonomy
Move to keyword list

ASSET PROFILE

UNIT NAME
Generic_Report_Handler (GRPTHNDLR)
VERSION
1.0.0
REVIEW CODE
CS (Verdix Ada/SUN); ES; AR; C1 1.0 A
INET ADDRESS
cpscada@citron.cs.clemson.edu
or ...!gatech!hubcap!citron!cpscada
AUTHOR
William Thomas Wolfe
for the Clemson Ada Software Repository
Department of Computer Science, Clemson University
Clemson, SC 29634-1906 (1-803-654-3444)
RIGHTS
ACM-STYLE COPYRIGHT
COPYRIGHT
(c) Clemson University
DATE CREATED
1988 12 ??
DATE RELEASED
1989 07 26
DATE LAST UPDATED
1989 07 26
LOCATION
ASR
PAL
AdaNET
ENVIRONMENT
Telesoft TeleGen2 / Sun-3
Verdix VADS / Sun-3
LIMITATIONS
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Thursday  26 May       1994 12:49:42Pm
Overall Assessment of System: OK
Classification of System: A
Basis of Classification --
Syntax Errors                               PASS
Completeness                                PASS
Independence from External Libraries        PASS
Independence from a Specific Ada Compiler   PASS

Number of ...
Files               1
Library Units       4
Lines             577
Statements        148
Comments          206

FILE LISTING

Directory Display


languages/ada/asr/components/grpthndlr:
  File Name                 Size
  ---------                 ----
  grpthndlr.zip           10,231


Totals
  ==============  ==============
    1 Files               10,231

ABSTRACT

Generic_Report_Handler is a package which facilitates the generation
of printed reports.  The user supplies procedures which handle the
generation of column headers and the like, and the report handler
calls upon these user-supplied procedures as necessary.  The primary
advantage of using the package is that it provides a "virtual page"
abstraction which frees the user from the burden of making sure that
page feeds are done at the right time, etc., thus greatly simplifying
the user's logic.

The author has found it useful to have standard page header routines
which are instantiated with either a fixed title string or a function
which returns a string; these routines print the time and date in the
upper left corner, the page number in the upper right corner, and the
title in the middle.  Because of their dependencies on local packages
(notably the variable length string package, and a time-and-date
package), and the high likelihood that the user will want to devise
his/her own standard for this area, the package which does this is
being made available upon e-mailed request, rather than being
submitted with GRPTHNDLR.

Another useful support package is one which provides a set of null
procedures which serve as excellent background (after being withed and
used) procedures; the user can then selectively obscure these null
procedures as necessary (specifying, for example, page and column
header generation procedures), while simply not specifying procedures
which may not be necessary for this instantiation (page footers,
etc.).  These procedures are being supplied in GRPTHNDLR.NUL.

This implementation is for sequential use only, but can be readily
modified as per Booch (Software Components With Ada, pages 203-205) if
instances of the report type are to be shared by several tasks.

****************************************************************************
This is part of the Clemson University Computer Science Department's
Ada Software Repository, and is copyrighted (C) 1989 by Clemson University.
Permission to copy without fee all or part of this software is granted,
provided that the copies are not made or distributed for direct commercial
advantage, and that this copyright notice is not deleted or modified.  To
copy otherwise, or to republish, requires a fee and/or specific permission.
> All bug reporters receive a free updated copy once the bug's corrected! <
E-mail: cpscada@citron.cs.clemson.edu or ...!gatech!hubcap!citron!cpscada.
****************************************************************************


REVISION HISTORY

   DATE       VERSION         AUTHOR                NOTES 
==========    =======   ====================     ===============
1989 07 26     1.0.0    William Thomas Wolfe     Released to ASR


RELEASE NOTICE

See Abstract.


DISCLAIMER

	This software and its documentation are provided "AS IS" and
without any expressed or implied warranties whatsoever.  No warranties
as to performance, merchantability, or fitness for a particular
purpose exist.
	The user is advised to test the software thoroughly before
relying on it.  The user must assume the entire risk and liability of
using this software.  In no event shall any person or organization of
people be held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.