FLOWCHARTER 1.45
by J. C. Justin















Table of Contents
1. INTRODUCTION

FLOWCHARTER Overview ................................. 1-1
FLOWCHARTER files .................................... 1-2

2. FLOWCHARTER Installation

Initialization ....................................... 2-1
FLOWCHARTER execution ................................ 2-2
FLOWCHARTER Command Options .......................... 2-3

3. Flowchart Files

Flowchart Command Structure .......................... 3-1
Flowchart Commands ................................... 3-2
Special Format Commands .............................. 3-8

4. FLOWCHARTER Messages

Error Messages ....................................... 4-1




1-1



INTRODUCTION

FLOWCHARTER OVERVIEW

The purpose of a flowchart is to provide a method of displaying
complex procedures or events in a graphical manner using standard
symbols which are easy to understand. The most common use of
flowcharts is in the design of complex computer programs. These
flowcharts show the basic design of the program independent of the
computer language in which they will later be written. In this
way, other programmers can translate the design into the actual
program using the flowcharts.

FLOWCHARTER is designed to provide a programmer with the capability
to easily produce flowcharts using simple commands which are then
translated into the actual flowchart symbols and output to a dot
matrix printer.

This method allows flowcharts to be easily updated as the program
design changes and eliminates the tedious job of drawing and re-
drawing flowcharts while maintaining up to date drawings. Updates
or corrections are made to the flowchart using any standard text
editer such as Word Star, PC Write etc... and then re-printed with
minimal effort.

The FLOWCHARTER was developed for use on the IBM Personal Computer
or any compatible such as the PC XT, PC AT, Sperry PC, etc.. and
the Epson FX-80 or compatible dot matrix printer.

This software is user-supported software and copies of this
diskette (but not of the printed manual) can be freely copied and
used by anyone who wishes to do so. Because of this, FLOWCHARTER is
changing to respond to the requests of its users. If you feel this
program has benefited you or or you wish to recieve the most
current revision, we encourage you to register for your own copy.
Registration costs $25 and provides you the following benefits:

* Current FLOWCHARTER manual * FLOWCHARTER support for a year
* Current FLOWCHARTER diskette * Telephone support for questions

To register for your copy send $25 to:

JJ Enterprises(tm)
13133 Thomas Circle, Burnsville, Mn. 55337 612/890-5405
PO, COD, Minnesota residents add 6% sales tax.
Quantity discounts available.

If you have any comments concerning FLOWCHARTER they would be
greatly appreciated and can be sent to the above address. Rights to
commercially market this software remain with the programmer.


1-2

FLOWCHARTER FILES

Included with the FLOWCHARTER program is a number of other files
which enable it to be used with different printers or allow the
user to tailor the program to their specific needs. The following
list contains a brief description if each file supplied with the
FLOWCHARTER program.


FLOW.COM
This file is the actual FLOWCHARTER executable program.

PRINTDVR.000
This file contains the printer driver to be used by the
FLOWCHARTER program (see 2-1).

FLOWDEMO.FLO
This file contains a sample flowchart, which can be printed by
the FLOWCHARTER program, and demonstrates the various options
possible.

FLOW.DOC
This file contains the document explaining the FLOWCHARTER
program and its operation.

2-1


FLOWCHARTER INSTALLATION

INITIALIZATION

Before using the FLOWCHARTER program you should, for your own
protection, make a working copy of the distribution disk before
proceeding.

Before the FLOWCHARTER program can be run you must copy the printer
driver for your printer into the file called PRINTDVR.000. Refer
to page 1-2 for the descriptions of each printer driver. Locate the
driver for your printer (all drivers end with the extension .DVR)
and enter the following command replacing the XXXXXXXX with the
name of the driver for your printer.

COPY XXXXXXXX.DVR PRINTDVR.000

When the FLOWCHARTER program is started, it searches for the
PRINTDVR.000 file in the current directory. If the file is not
located in the current directory, the path must be specified using
the INSTALL program (see 4-1). This will allow you to place the
FLOWCHARTER program and the printer driver in a common system
directory.

2-2


FLOWCHARTER EXECUTION

The following section describes operation of the FLOWCHARTER
program and assumes that the FLOWCHARTER program (FLOW.COM) and the
printer driver (PRINTDVR.000) are located in the current directory.
If the file PRINTDVR.000 can not be found the following message
will be printed and the program will terminate.

PRINTDVR.000 File not found!! --- FLOWCHARTER Program terminated

To run the FLOWCHARTER program enter the command:

FLOW

The FLOWCHARTER program should now be running and displaying the
following prompt on the third line from the bottom:

OPTION >

Below the prompt line are 2 lines showing all of the single letter
OPTION commands possible. Each command is executed by pressing the
corrosponding letter. If a command requires more information (such
as a filename) another message requesting the needed information is
displayed above the prompt line. Any other information or error
messages are also scrolled onto the screen above the prompt line.

The FLOWCHARTER program processes two types of files. The fist type
contains the flowchart commands which are used to plot the actual
flowchart symbols.

Example:

START .$H EXAMPLE OF A FLOWCHART FILE
.$P PROCESS BOX SYMBOL
.$D DISPLAY SYMBOL
.$E END


The second type is a batch file which contains FLOWCHARTER command
options. This file can be used to load the Plot Queue with the
names of flowchart files which are to be plotted. This file type
must have a filename extension of (.BAT).

Example:

A (Add DEMO.FLO file to Plot Queue)
DEMO.FLO
A (Add DEMO1.FLO file to Plot Queue)
DEMO1.FLO
Q (List Plot Queue)
P (Plot files)

When the FLOWCHARTER program is first started it searches for batch
file AUTOFLOW.BAT and starts executing it. This file can be used
load a flowchart file which initializes the FLOWCHARTER defaults
(such as margins, position of title, etc.).




2-3

FLOWCHARTER COMMAND OPTIONS



COMMAND OPTION "A"

The FLOWCHARTER program is capable of printing any number of
flowchart files by (A)dding the names of all files to be printed
to the Plot Queue using the (A) command option. To enter a file
name press "A" and the following message will be displayed:

Enter Filename >

Now enter the name of the flowchart file to be printed. You can
use a file name with a drive (like C:DEMO) or an extension (like
DEMO.FLO). With DOS 2.00 you can also use a pathname (
\TEST\DEMO.FLO ). FLOWCHARTER uses standard DOS files and
filenames. However, the entire file name must not be longer than
30 characters.

An optional field follows a flowchart filename which is used to
specify the first and last sheets of the flowchart to be printed.
A (/) must seperate the filename, first sheet number, and last
sheet number. If this field is ommited all sheets are printed.
In the following example, only sheets 2 through 3 of FLOWDEMO.FLO
will be printed.

Enter Filename >FLOWDEMO.FLO/2/3

The FLOWCHARTER program searches for the filename entered before
it is entered into the Plot Queue and if the specified file
cannot be found the following message will be displayed:

FILE NOT FOUND...



COMMAND OPTION X (Exit FLOWCHARTER)

Pressing X causes the FLOWCHARTER program to be terminated and
control returned to DOS.


2-4


COMMAND OPTION P (Process Plot Queue)

Pressing P causes all flowchart/batch files entered in the Plot
Queue to be plotted/executed. As the Plot Queue is processed,
the lower three lines of the display is replaced with a running
status showing the name of the file being processed, the sheet
being printed, the total number of sheets to print, the total
number of files in the Plot Queue left to process, and the total
number of flowchart errors and warnings printed for all files
processed so far. The format of the running status is as follows:


Plotting................... FILENAME.EXT
Currently printing sheet... 1 of 4 Error Count...... 0
Files not yet Plotted...... 0 Warning Count.... 0


Pressing any key while the Plot Queue is being processed causes
the following message to be displayed and allows you to either
terminate or continue processing the files in the Plot Queue.

**Abort (Y/N)?

If Y is pressed, the current file being processed is terminated
and removed form the Plot Queue and the cursor returns to the
prompt line and waits for another Command Option. If N is
pressed, processing continues where it left off.

2-5

COMMAND OPTION S (Scan Plot Queue)

Pressing S causes all files entered in the Plot Queue to be be
scanned for any errors. When initiated the following prompt is
displayed:


Select Scan Mode...(1 = Scan & Printout 2 = Scan) >


If "1" is selected, all error messages will be outputted to the
printer and the screen as the flowcharts are scanned. If "2" is
selected all error messages will be output to the screen only.

As the Plot Queue is processed, the lower three lines of the
display is replaced with a running status showing the name of the
file being processed, the sheet being printed, the total number
of sheets to print, the total number of files in the Plot Queue
left to process, and the total number of flowchart errors and
warnings printed for all files processed so far. The format of
the running status is as follows:


Plotting................... FILENAME.EXT
Currently printing sheet... 1 of 4 Error Count...... 0
Files not yet Plotted...... 0 Warning Count.... 0


Pressing any key while scanning causes the following message to
be displayed and allows you to either terminate or continue
scanning the Plot Queue.


**Abort (Y/N)?


If Y is pressed, scanning is terminated and the cursor returns to
the prompt line and waits for another Command Option. If N is
pressed, scanning continues where it left off.

Unlike the command option "P", files are not deleted from the
Plot Queue as they are processed so when scanning is complete
they can be plotted without re-entering the filenames.


2-6

COMMAND OPTION Q (List Plot Queue)

The following command option allows you to verify the filenames
and sheet limits entered in the Plot Queue. Each filename listed
is preceded by a number which represents the order the files will
be processed. This number is also used if you want to delete a
filename from the Plot Queue. (see Command Option D). To list
the Plot Queue press Q and FLOWCHARTER will print all files
currently in the Plot Queue.

EXAMPLE:

**1 TEST.BAT BATCH FILE
**2 \TEST\DEMO.FLO PAGES 1 - 999
**3 DEMO1.FLO PAGES 1 - 6
**4 DEMO2. PAGES 1 - 1




COMMAND OPTION D (Delete filename from Plot Queue)

This Command Option allows you delete a filename from the Plot
Queue. To delete a filename from the queue you must know the
number of the filename in the Plot Queue. To find this, list the
Plot Queue by pressing "Q" (List Plot Queue command).


**1 \TEST\DEMO.FLO PAGES 1 - 999
**2 DEMO1.FLO PAGES 1 - 6
**3 DEMO2. PAGES 1 - 1


Now press "D" and the following message will be displayed:

ENTER NUMBER OF FILE TO DELETE >

Now enter the number of the filename to delete from queue.

For example: Enter 1 to delete \TEST\DEMO.FLO
Enter 2 to delete DEMO1.FLO
Etc...

If you deleted filename number 2 then listed the Plot Queue it
would now be:


**1 \TEST\DEMO.FLO ALL PAGES
**2 DEMO2. PAGES 1 - 1


3-1


FLOWCHART FILES


FLOWCHART COMMAND STRUCTURE

The FLOWCHARTER program automatically generates three columns of
flowchart symbols which fit on a standard 8.5 x 11 sheet of paper.
When a chain of flowchart symbols takes more than 1 column, the
first column ends in a numbered circle and the next column begins
with the same numbered circle.

Any connecting circles going to another sheet will be indicated by
writing the word "SHEET" and the coresponding sheet number. Each
printed sheet will automatically be numbered by placing "SHEET __
OF __" in the lower right corner.

Flowcharts are generated by creating a text file which contains the
flowchart commands which are used by the FLOWCHARTER program to
draw the individual flowchart symbols. This file can be
created/edited using any text editer such as Wordstar, PC Write
etc... Each line in the flowchart file may contain only one
flowchart command and consists of the following three fields:

Label : This field is optional but must begin in column 1 if used.
The label may contain any characters to a maximum of 10.
If the label field is used, a space must separate the
label and the command field. When the FLOWCHARTER finds a
label, a numbered connector circle is generated with the
label printed to left of the circle.

Command: This field must begin in any column except 1. It can
contain any legal flowchart command.

Comment: This field must follow the command field and consists of
any string of characters to be printed with the flowchart
symbol specified in the command field. If all the comment
does not fit on one command line, the continuation
character (;) must appear at the end of that line and the
next line must contain only a (.$) in the Command field
and the remaining text in the comment field. The
FLOWCHARTER program automatically divides the text string
to fit in each flowchart symbol. In the case of the
Test/Decision symbol the text is centered both
horzizontally and vertically.


3-2

FLOWCHART COMMANDS

The following section describes all of the flowchart commands
available and examples of how they can be used. The examples used
are contained in the file called FLOWDEMO.FLO supplied with this
program. This file can be printed before this section is read in
order to make the examples easier to understand.



HEAD OF CODING (.$H)

The .$H command is used to start (or Head) a new flowchart. It
causes a terminal symbol to be drawn at the top of a new sheet to
designate the entrance to the flowchart. If a label is present
it will be printed inside the terminal symbol. If there is no
label, "ENTER" will be printed instead. The text in the comment
field is used as the title of the flowchart and is printed on the
lower left corner of the sheet. The title may be up to 90
characters in length and will be printed on all sheets until the
flowchart ends or another .$H command is encountered.



PROCESS BOX (.$P)

The .$P command is used to draw a process box symbol. The normal
symbol size contains four lines of twelve characters from the
comment field. If the comment field consists of more than four
lines, the box is increased in hight to accommodate up to ten
lines of text.

Example:

.$P COMMENT IN PROCESS BOX


LISTING (.$L)

The.$L command is used to draw a listing/documentation symbol.
The normal symbol size contains four lines of twelve characters
from the comment field. If the comment field consists of more
than four lines, the symbol is increased in hight to accommodate
up to ten lines of text.

Example:

.$L THIS IS A LISTING SYMBOL


3-3




SUBROUTINE BOX (.$S)

The .$S command is used to draw a subroutine box symbol. The
symbol can contain a maximum of four lines of twelve characters
from the comment field. Since the subroutine may have more
detailed coding elsewhere in the same set of flowcharts, the
symbol can be labeld by placing the label of the subroutine
followed by a (/) as the first word in the comment field. The
label can be a maximum of ten characters and will be printed just
above and to the left of the subroutine symbol. The word "SHEET"
followed by a sheet number will be printed just above and to the
right. The sheet number is the sheet where the label of the
detailed coding is located. If the label is not located in the
current flowchart file a question mark will be printed instead of
the sheet number.

Example:

.$S SUBLABEL/ COMMENT IN SUBROUTINE BOX




PREPARATION BOX (.$W)

The .$W command is used to draw a preparation box symbol. The
symbol can contain a maximum of four lines of twelve characters
from the comment field. Since the preparation routine may have
more detailed coding located elsewhere in the same set of
flowcharts, the symbol can be labeled by placing the label of the
preparation routine followed by a (/) as the first word in the
comment field. The label can be a maximum of ten characters and
will be printed just above and to the left of the preparation
symbol. The word "SHEET" followed by a sheet number will be
printed just above and to the right. The sheet number is the
sheet where the label of the detailed coding is located. If the
label is not located in this flowchart file a question mark will
be printed instead of the sheet number.

Example:

.$W PREPLABEL/ COMMENT IN PREPARATION BOX


3-4

INPUT/OUTPUT BOX (.$I)

The .$I command is used to draw a input/output box symbol. The
symbol can contain a maximum of four lines of twelve characters
from the comment field. Since the input/output routine may have
more detailed coding located elsewhere in the same set of
flowcharts, the symbol can be labeled by placing the label of the
input/output routine followed by a (/) as the first word in the
comment field. The label can be a maximum of ten characters and
will be printed just above and to the left of the input/output
symbol. The word "SHEET" followed by a sheet number will be
printed just above and to the right. The sheet number is the
sheet where the label of the detailed coding is located. If the
label is not located in this flowchart file a question mark will
be printed instead of the sheet number.

Example:

.$I INOUTLABEL/ COMMENT IN INPUT/OUTPUT BOX



JUMP (.$J)

The .$J command will cause a jump to the label specified in the
comment field. The specified label must exist within the current
flowchart file. The .$J command draws a connector circle
containing a FLOWCHARTER generated number with the label and
sheet number of where that label is located printed to the right
of the circle. On the sheet where the label is located another
connector circle is drawn with the same FLOWCHARTER generated
number. If the label is located on the same sheet as the .$J
command the word "SHEET" will not be printed.

Example:

.$J LABEL



COMMENT (.$C)

The .$C command draws a comment symbol which can contain up to
ten lines of eighteen characters from the comment field. The
size of the comment bracket expands to accomodate the amount of
the text.

Example:

.$C THIS IS THE COMMENT


3-5
MESSAGE (.$M)

The .$M command prints a message or note of up to ten characters
above and to the left of the next flowchart symbol.

Example:

.$M MESSAGE



TEST (.$T)

The .$T command draws a test/decision symbol which can contain up
to three lines of eight characters. If more than two branches
are required, the number of branches required are specified
immediately following the .$T as part of the command field. The
branch alternatives/conditions are specified using the .$A
command.

Examples:

.$T THIS IS A TEST SYMBOL
.$T3 MULTIPLE BRANCH TEST

Default conditions occur when using the .$T command without the
.$A command. When not using the .$A command, tests are assumed
to have two alternatives/conditions associated with the test
symbol, "YES" (test passes) and "NO" (test fails). When a .$J
command or .$E command follows the .$T command the word "NO" is
printed to the right of the test symbol and the word "YES" is
printed below the test symbol. If followed by a .$J command, a
connector symbol and the label specified in the comment field of
the .$J command is printed to the right of the test symbol. If
followed by a .$E command, a end of coding symbol is drawn to the
right of the test symbol with the text from the comment field of
the .$E command printed inside the end of coding symbol. If the
comment field of the .$E command is blank the word "EXIT" will be
printed instead.

Examples:

.$T GOOD
.$J GOODONE
.$T BAD
.$E ERROR
GOODONE .$D DISPLAY DATA

When the .$T command is not followed by a .$A, .$J or .$E the
word "YES" is printed to the right of the test symbol and the
word "NO" is printed below the test symbol. A connector symbol
is drawn to the right which branches to the point following the
next flowchart symbol.

Example:

.$T PRINTER OFF?
.$P PRINT LINE
.$P GET NEXT LINE

3-6

ALTERNATIVES (.$A)

The .$A command is used to specify the branch alternatives for
the test symbol. This command must directly follow the test
(.$T) to which it applies. The format for the comment field of
the .$A command is as follows:

.$A Alternative,Label Alternative,Label etc...

The alternative can be a maximum six characters and specifies the
branch condition out of the test symbol (for example, YES, NO,
PASS, FAIL, etc.). The label can be a maximum of ten characters
and specifies the destination for the associated alternative.
The label must exist elsewhere in the current flowchart file.

When two labels are specified in the .$A comment field the first
alternative with a label is printed to the right of the test
symbol, and the second alternative and label are printed below.
Each alternative produces a connector circle containing a
FLOWCHARTER generated number and the label and sheet number where
the label is located. If only one label is specified the
alternative with the label is printed to the right of the test
symbol. The alternative without the label is printed below the
test symbol allowing a continous flow of symbols.

Examples:

.$T PASS 1
.$A YES,BRANCH1 NO
.$P PROCESS ONE
.$T PASS 2
.$A YES,BRANCH2 NO,BRANCH1
BRANCH1 .$P PROCESS TWO
BRANCH2 .$P PROCESS THREE

When multiple branches were selected by the previous .$T command
(ie .$T4), the number of alternatives specified in the comment
field of the .$A command must equal the number specified in the
.$T command. Also, more than 2 alternatives cannot be specified
without labels.

Example:

.$T4 BRANCH ON CODE
.$A CODE=4,ROUTINE4 CODE=3,ROUTINE3 CODE=2,ROUTINE2 CODE=1
ROUTINE1 .$S FUNCTION 1
ROUTINE2 .$S FUNCTION 2
ROUTINE3 .$S FUNCTION 3
ROUTINE4 .$S FUNCTION 4




3-7

When the .$A command is used with two labels unspecified, the
first alternative without a label is printed below the test
symbol and the second alternative without a label is printed to
the right and branches to a connector symbol after the next
flowchart symbol.

Example:

.$T DATA READY?
.$A YES NO
.$P GET DATA
.$P PROCESS ANY DATA



ALTERNATE END OF CODING (.$AE)

The .$AE command is used to generate an end of coding symbol to
the right of the test symbol. This command must immediately
follow the .$T command to which it applies. The format for the
comment field is the same as the .$A command except the first
alternative appears to the right of the test symbol and it's
label is printed inside the end of coding symbol. If the label
is omitted, the word "EXIT" will be printed instead.

Example:

.$T STOP
.$AE YES,HALT NO


DISPLAY (.$D)

The .$D command draws a display symbol which can contain up to
three lines of eight characters from the comment field.

Example:

.$D THIS IS A DISPLAY SYMBOL


END OF CODING (.$E)

The .$E command indicates the end of the current flowchart and
draws the end of coding/terminal symbol which can contain a
maximum of ten characters from the comment field. If the comment
field is blank the word "EXIT" will be printed in the terminal
symbol instead.


3-8

SPECIAL FORMAT COMMANDS

Special format commands do not generate any symbols, but allow you
to change the defaults for margins, positioning of text, and adding
special text. Once changed, the new values remain in effect until
reset by another command. Care must be taken when repositioning or
adding text so as not to write over any existing text on the page.

In addition, some of the commands allow you to change the font of
the text being printed (Bold, Expanded, etc.). Depending upon the
printer driver being used, only some of the 16 font types may work.
It is suggested that the FLOWDEMO.FLO file be plotted which will
print text in all font types. You can then examine the printout to
see which font types are available for your printer.



MARGIN COMMAND (.$XM)

This command is used to change the margins on the sheet. This
command must appear before the .$H (Head of Coding) at the
beginning of the flowchart file or between a .$E and .$H command.
Once changed, the new margins remain in effect until changed by
another command. The FLOWCHARTER program automatically reduces
the length and number of flowchart columns drawn on each sheet so
all symbols are within the specified left, right, top, and bottom

limits. The format for this command is as follows :

.$XM L.LL,R.RR,T.TT,B.BB

where: L.LL = This parameter specifies the left margin in decimal
inches. The Default is 0.25 inches.

R.RR = This parameter specifies the right margin in
decimal inches. The Default is 0.0 inches.

T.TT = This parameter specifies the top margin in decimal
inches. The Default is 0.20 inches.

L.LL = This parameter specifies the maximum length of the
flowchart in decimal inches from the top of the
sheet. The Default is 9.4 inches.

All fields must contain a value and commas must seperate each
field.

3-9


POSITION TITLE COMMAND (.$XH)

This command is used to change the font and reposition the title
generated by the .$H command. This command must appear before
the .$H to which it applies. The titles on all sheets following
this command will be printed at the specified position until
another .$XH command is encountered. The format of this command
is as follows:

.$XH Fx,X.XX,Y.YY

where: Fx = This parameter is optional and is used to change
the font that the title will be printed in
(boldface, condensed, etc.). The font type is
specified by "x" and can be any value between 0
and 15.

X.XX = This parameter specifies the horizontal position
in decimal inches from the left edge of the sheet
where the title should be printed. The Default is
1.0 inches.

Y.YY = This parameter specifies the vertical position in
decimal inches from the top edge of the sheet
where the title should be printed. The Default is
9.75 inches.

All fields except the Fx field must contain a value and commas
must seperate each field.


3-10



POSITION SHEET COMMAND (.$XS)

This command is used to change the font and reposition the (SHEET
_ OF _) on each sheet. This command must appear before the .$H
of the flowchart to which it applies. The (SHEET _ OF _) on all
sheets following this command will be printed at the specified
position until another .$XS command is encountered. The format
of this command is as follows:

.$XH X.XX,Y.YY

where: Fx = This parameter is optional and is used to change
the font that the (SHEET _ OF _) will be printed
in (boldface, condensed, etc.). The font type is
specified by "x" and can be any value between 0
and 15.

X.XX = This parameter specifies the horizontal position
in decimal inches from the left edge of the sheet
where the (SHEET _ OF _) should be printed. The
Default is 6.0 inches.

Y.YY = This parameter specifies the vertical position in
decimal inches from the top edge of the sheet
where the (SHEET _ OF _) should be printed. The
Default is 9.75 inches.

All fields except the Fx field must contain a value and commas
must seperate each field.


3-11


TEXT COMMAND (.$XT)

This command is used to print additional text on each sheet.
Unlike the other special format commands this command can appear
after the .$H of the flowchart on which the text is to be
printed. More than one .$XT can be used to generate the desired
text. Once defined, the text will be printed on all sheets
following the .$XT until the next .$XT command is encountered
with no parameters specified.

When more than one line of text is to be printed, each line must
be terminated with a semicolon (;). The next line must contain a
(.$) in the command field and any additional text. The example
below would print four lines of text starting at positions
specified.

Example:

.$XT X.XX,Y.YY,LINE 1 OF TEXT;
.$ LINE 2 OF TEXT;
.$ LINE 3 OF TEXT;
.$ LAST LINE OF TEXT

where: Fx = This parameter is optional and is used to change
the font that the text will be printed in
(boldface, condensed, etc.). The font type is
specified by "x" and can be any value between 0
and 15. If not specified, the program default is
used. See 4-1 on changing program defaults.

X.XX = This parameter specifies the horizontal position
in decimal inches from the left edge of the sheet
where the text should be printed.

Y.YY = This parameter specifies the vertical position in
decimal inches from the top edge of the sheet
where the text should be printed.

All fields except the Fx field must contain a value and commas
must seperate each field. If no parameters are specified,
previously defined text is not printed on following sheets.

3-12

RESET DEFAULTS COMMAND (.$XR)

This command is used to reset the parameters changed by the
.$XH, .$XS, .$XT, .$XM, and $XP commands to the original program
defaults. This command must appear before the .$H of the
flowchart to which it applies. Each parameter can be
selectively reset by entering its corresponding letter in the
parameter field of the command. The format of this command is
as follows:

Example:

.$XR HSTPM

where: H = Set Title position and font to original program
defaults.

S = Set 'SHEET OF SHEET ' position and font to original
program defaults.

T = Disable printing of any special text.

P = Sets all page numbering parameters to original
program defaults.

M = Set margins to original program defaults.


4-1

FLOWCHARTER MESSAGES




ERROR MESSAGES

When a flowchart file is plotted each command line is scanned for
any errors. If any are found, the line number, the part(s) of the
actual line in error, and a message describing the error are
scrolled on the screen above the prompt line.

The following section describes all the error messages that are
generated and the format of each one.




1 >TOOLONGLABEL .$P PROCESS BOX
LABEL EXCEEDED MAXIMUM LENGTH OF TEN CHARACTERS

This message is displayed if the label starting in column one or
the label in the comment field of the .$S, .$W, or .$I commands
exceed the maximum length of 10 characters. The first line
displays the line number where the error occurred and the label
in error.


2 >COMMENT TOO LONG FOR TEST SYMBOL
COMMENT TOO LONG FOR SPECIFIED FLOWCHART COMMAND

This message is displayed if the comment will not fit within the
specified symbol. In the above example the comment supplied will
not fit inside the test symbol which can only hold a maximum of 3
lines of 8 characters. The first line displays the line number
and the line where the error was detected.


3 >ENTER .$H TITLE TOO LONG.....
TITLE EXCEEDED MAXIMUM LENGTH OF 90 CHARACTERS

This message is displayed if the comment for the .$H command is
longer than 90 characters. The first line displays the line
number and the line where the error was detected.


4 > .$M MESSAGE TOO LONG
MESSAGE EXCEEDED MAXIMUM LENGTH

This message is displayed if the comment for the .$M command is
longer than 10 characters. The first line displays the line
number and the line where the error was detected.


4-2


5 > .$M MESSAGE TOO LONG
EXCEEDED MAXIMUM MESSAGE COUNT

This message is displayed if more than 10 sequential .$M
commands are found are found in the flowchart file. The first
line displays the line number and the line where the error was
detected.


6 > .$F ILLEGAL FLOWCHART COMMAND
ILLEGAL FLOWCHART COMMAND

This message is displayed if an illegal flowchart command is
found in the flowchart file. The first line displays the line
number and the line where the error was detected.



7 > DUPLABEL
DUPLICATE LABEL

This message is displayed if a the label on the current line
appeared elsewhere in the same flowchart. The first line
displays the line number and the line where the error was
detected.



8 >LABLE
LABEL NOT FOUND IN THIS FLOWCHART FILE

This message is displayed if a the destination label (END) on the
current line cannot be found in this flowchart file. The first
line displays the line number and the line where the error was
detected.


9 > .$J END
WARNING--LABEL NOT FOUND IN THIS FLOWCHART BUT DOES APPEAR IN
ANOTHER

This message is displayed if a the destination label (END) on the
current line cannot be found in this flowchart but did appear
elsewhere in this flowchart file. The first line displays the
line number and the line where the error was detected.


4-3


10 > .$P PROCESS
UNABLE TO REACH THIS FLOWCHART COMMAND

This message is displayed if a the current line cannot be
reached.

Example:

.$J NEXT
.$P PROCESS
NEXT .$S SUBROUTINE

In the above example the .$P command cannot be reached because no
label was specified and the previous command jumped around it.
The first line displays the line number and the line where the
error was detected.



11 > .$P PROCESS
COMMENT EXPECTED TO BE CONTINUED ON THIS LINE

This message is displayed if the previous lines comment field
ended with a (;) indicating the comment continued on this line
and this line did not contain a (.$) in the command field. The
first line displays the line number and the line where the error
was detected.




12 > .$T2, TEST SYMBOL
BRANCH COUNT FOLLOWING .$T COMMAND IN ERROR

This message is displayed if an error was detected in the branch
count following the (.$T) command. The first line displays the
line number and the line where the error was detected.




13 > .$A ALT1,BRANCH1 ALT2 ALT3 ALT4
MORE THAN 2 ALTERNATIVES SPECIFIED WITHOUT LABELS FOR PREVIOUS TEST
SYMBOL

This message is displayed if the previous test command (.$T)
specified more than 2 branches and the following alternative
command (.$A) specified more than 2 alternatives without labels.
The first line displays the line number and the line where the
error was detected.


4-4


14 > .$A ALT1,BRANCH1 ALT2
NO TEST COMMAND SPECIFIED FOR THIS ALTERNATE

This message is displayed if the previous flowchart command was
not a test (.$T). The first line displays the line number and
the command line where the error was detected.





15 > .$A ALT1,BRANCH1 ALT2
ALTERNATE EXPECTED

This message is displayed if the previous test command (.$T)
specified more than 2 branches and the following alternative
command (.$A) did not specify an equal number. The first line
displays the line number and the command line where the error was
detected.



16 >LONGALT
ALTERNATE EXCEEDED MAXIMUM OF 6 CHARACTERS

This message is displayed if the alternative specified contains
more than six characters. The first line displays the line
number and the command line where the error was detected.



17 > .$XM 0,0,0,0
SET MARGIN COMMAND ILLEGAL IF NOT AT BEGINNING OF FILE

This message is displayed if the .$XM command was found after the
first .$H command in the file.