PRTREP: Print Report File Elements

Last updated 19 Nov 97

PRTREP produces an overall CODAP report which may consist of many individual reports. It can print a standard Report Block Header, and can overlay monograms on each non-header page. A table of contents lists all the reports printed. Only those reports which were created using SAVREP can be printed.

Program Invocation

The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.


@codap prtrep <opt> <ssss> <RP>

opt:  S   Suppress printing of header page for each report
ssss:     The study number
RP:       Input Report file

Banner Card (optional)

This card allows the user to specify a banner to replace the large PRTREP banner that is on the header page. Two lines of banner type are allowed, with up to nine characters per line consisting of letters or numbers, a single blank is used to separate the two lines. Because a blank is used to separate the lines, an embedded blank is not allowed in either of the two lines, although if any character other than A-Z or 0-9 is specified in a line it will be replaced with a blank.


BANNER <banner1> <banner2>

BANNER:   The literal 'BANNER'
banner1:  A 1-9 character banner line consisting of (A-Z,0-9), which
	  specifies the first line of the banner print
banner2:  A 1-9 character banner line consisting  of (A-Z,0-9), which
	  specifies the second line of the banner print

Block Header Cards (optional)

This set of cards causes the standard block header page to be printed prior to the report. A maximum of 29 cards is allowed. When the block sentinel is found at the beginning of a card, the scan for block header cards ends.


BLOCK <sent>
...
block  header
cards...(up to 29 cards)
...
<sent>

sent:    A 1-6 character sentinel used as a flag to indicate no more
	 block header cards.

Monogram Cards (optional)

These three cards create the first, second, and third lines respectively of the monogram, which is printed on every non-header page. Each line is case-sensitive, and cannot exceed 32 characters.


M<n> <text>

M:       cc 01     The literal 'M'
n:       cc 02     The monogram line number (1-3)
text:    cc 04-35  The monogram, 1-32 characters

Report Request Cards

These cards indicate which report(s) are to be printed.


RPnnnn [<maxpag>] [title]

RPnnnn:  cc 01-06  The report to be printed
maxpag:  cc 08-11  The maximum number of pages to print for this report
		   (default=9999).
title:   cc 13-72  Optional new title for this report

These cards are terminated by an '@eof' image.

Note Cards (optional)

If note cards are supplied, they will be printed on the first page of the index only. There is no limit on the number of note cards.


<text>

text:    cc 01-80  Any information desired

The control cards are terminated by an end-of-file or an '@eof' image.

Example

@codap prtrep s ssss rp000
BANNER TRAINING EXTRACT
BLOCK XXXXXX
TASK SCIENTIST....Mr. Tom J. Sullivan
DESIGNER..........John Mellon
XXXXXX
M1  TECHNICAL SERVICES DIVISION  
M2 AF HUMAN RESOURCES LABORATORY
M3   AIR FORCE SYSTEMS COMMAND  
RP0006 9999
RP0007 9999 New title for this report
@EOF
This note card appears only on the Table of Contents
@EOF

Reports RP0006 and RP0007 from file RP000 will be printed, with a limit of 9999 pages for each report. An installation monogram will be added to each page. The individual report header pages will not be printed.

Back to document index