AllClear User's Guide

,IP
Ir (
--
Table of Contents
Chapter 1:
J
Chapter 2:
\xicJ
_
N (
. ~'v
Chapter 3:
\J
.
Chapter 4:
Chapter 5:
.f
.? ?)
- .- '"
;....
--,,;.,,
.,,
--
~;~
-...
-...
;-
-- .....
-
1
llf?
--
fJrc/3~
-IJtt'
lntroduction _ . . . .
What Does allCLEAR Do?
Who Can Use allCLEAR? .
What Is in the Package? .
- Organization of the User's Guide
..
111
.
.
'
.
1-3
1-4
1-6
1-7
Getting Started . . . . . .
What Do You Need to Run allCLEA~?
What Does the INSTALL Program Do?
lnstalling allCLEAR
Setting the PATH
Starting allCLEAR
. 2-1
. 2-3
Sample Sesslon
To Begin
Getting Help
Selecting the File
Looking at the File
Displaying the Diagram
Walking Through the Diagram
Preparing the Diagram for Print
Printing the Diagram
What Is Next
. 3-1
allCLEAR Basics .
allCLEAR Diagrams
Script Files
The Style Sheet
allCLEAR Menus .
Basic Operating Guidelines
On-Line Help and Error Messages .
allCLEAR Keys
. : . . : -. . . _, ~ Managing allCLEAR Script Files
The File Menu . .
Selecting a File . -
Changing Directory
Editing a Script File
Creating a Script File
Printing a Script File
Formatting a Script File -
--
__,..;;..
..,_ '
.
.
.
.
2-4
2-6
2-8
2-9
. 3-3
. ::S-4
. 3-5
::>-7
. 3-8
3-12
3-15
3-21
3-22
. 4-1
. 4-3
. 4-8
: 4-9
4-11
4-14
4-15
4-17
..
.
.
.
5-1
5-3
5-4
5-6
. 5-7
. 5-8
5-10
5-12
?~
lv Table of Contents
Chapter 6:
Chapter 7:
Chapter 8:
Viewing allCLEAR Diagrams

The View Menu . . . . . . .
Scrolling the Diagram . . . .
Page Previewing . . . . . . .
Printing allCLEAR Diagrams
The Print Menu
Printer Output . . . . . . . .
PRINT File Output . . . . . .
PCX, PIC, and EPS File Output
. 6-1
. 6-3
. 6-4
. 6-8
6-12
6-19
. 71
. 7-3
. 7-4
. 7-9
7-11
Worklng wlth the Style Sheet

The Style Menu . . . . .
Modifying the Style Sheet
Style Sheet Options . . .
Saving the Style Sheet
Managing the Style Sheets
. 8-1
. 8-3
Chapter 9:
Runnlng Extemals from allCLEAR

The Run Menu . . . . . . . . . .
Reconfiguring allCLEAR Environment
Setup Options . . . . . . . . . . .
.
.
.
.
Chapter 10:
Most Common Questions and Problems

How Do l. .. . . . . .
What Do 1 Do Jf... . . . . .
10-1
10-3
10-6
Chapter 11:
Advanced Features . . . .
Using allCLEAR with Lotus 123
Diagramming Outlines . . . .
Diagramming DOS Batch Files
Diagramming DOS Directories
Managing HP Fonts . . . . .
11-1
11-3
Chapter 12:
lndex
Error Messages and Wamlngs

Error Messages
Warnings
. 8-4
. 8-6
8-18
8-19
9-1
9-3
9-4
9-6
.11-14
.11-17
.11-20
.11-22
. 121
. 12-3
.12-12
. . 1-1
Chapter 1:
lntroduction
This introductory chapter gives you a quick
look at the package rmd explains how to
!{Se the rest of this User' s Guide.
12 lntroeluctlon
What Does allCLEAR Do? 13
Chapter Contents
Who Can Use allCLEAR? . . . .
What Is in the Package? . . . .
Organization of the User's Guide

. 1-3
. 1-5
1-7
. 1-8
It is a well known fact that people understand pictures better

than words. That is why at the most critica! points of an explanation or presentation we usually rely on pictures. However, we can all write fairly well but few of us know how to
draw or want to spend time preparing diagrams using a draw
system. For those people who believe in the benefits of
visual representation but have neither time nor money for
dealing with graphics artists, we introduce a!ICLEAR.
al!CLEAR allows you to illustrate any textual description of
ideas, procedures, policies, structures, and co!lections of data
with graphical ima2es, or cliagrams. allCLEAR supports
three broad types of cliagrams: Procedure (or flow chan),
Tree (or hierarchy chart), and Decision Tree. Because
allCLEAR prcxinces and updates the diagrams automatically
from the text files, we call it "the automatic idea i!lustrator".
To illustrate your ideas:

1.
Enter the information in question (using your favorite Text

Editor or Word Processor) and save it in a disk file. Th.is
will be the allCLEAR script file. The information has to be
described in the al!CLEAR script language, wh.ich writes and
reads line any human languec:. (such as English or German)
nut has a number cf >trct structuring rules. As you use the
script symbols (punctuation marks) to structure the information, there wi!I be no ambiguity in its interpretation.
2.
allCLEAR then reads the script file, analyzes it, and absoh.1tely
automatically produces the diagram of the information
described in it. You can browse the diagrarn on the screen,
walk through all the steps or components with a tracing cursor, print preview all the diagram pages, and print the
cliagram to the printer or file.
"
1-4 lntroductlon
Who Can Use allCLEAR? 15
~;
..;.>
3. Just like a desk-top publishing system uses a style sheet to formar the text, allCLEAR uses a Style Sheet to format the
diagram. Simply by modifying the current Style Sheet, you
can customize any of the diagram attributes, such as style,
fonts, box shapes, page orientation, margins, pagination, and
others. allCLEAR redraws the diagram instantly with the
new settings.
4.
Let's suppose that you need to add new information to your illustrations. For example, you wish to update your
company's organizational chart to show new positions and
employees. Ali you have to do is enter the new information
into the script file. allCLEAR takes it from there and automatically creares a new set of diagrams. allCLEAR illustratiou, are always up-to-date.
Thus, in a matter of minutes, a!ICLEAR helps you convert
any information into professional quality graphical illustrations. These diagrams can be presented alone or in combination with text to act as concise illustrations of !he logical
structure behind any words. Irnpress your clients with them,
use them every day to follow routine procedures, or just put
them into instruction manuals - whatever you do, the time
you put into working with a!ICLEAR will be well spent.
Who Can Use allCLEAR?

a!ICLEAR can be used by anyone who has access to a Personal Computer and wants to effectively communicate
his/her ideas to others by enhancing !he textual or verbal
presentation with visual aids, such as graphical i!lustrations.
The following people could particularly benefit from using
allCLEAR:
Managers
can use diagrams to train personnel and to coordinate
the work of the department or project.
Technical Writers
can use diagrams to provide illustrations of key procedures or menu structures described in the manual.
Teachers
can use diagrams to support !ectures to enhance
students' understanding.
Accountants
can use diagrams to explain- how to fill out tax forms.
The Financia! Accounting Standards Board publishes
special books, called Accounting Standards, where instructions are given in !he form of flow charts.
Military Personnel
can use diagrams to describe procedures. Procedure
Manuals with extensive flow charts (explaining what to
do in emergency situations, for example) are commonly
used in rnilitary and c;ommercial aviation.
Engineers
can quickly create and distribute instruction diagrams on
how to trouble shoot a problem.
System Designers
can write specifications in the al!CLEAR script language
and support thern with flow charts and tree charts of the
future systern. Diagrams would also contribute to effective cornrnunications with the end users.
Programmers
can outline their prograrns in the allCLEAR script language and use the diagrarns for approval by managers
and better comrnunication with the other team members.
'
,.
~
......
1-4J lntroduction
What Is in the Package? 1-7
Administrative Personnel
can create diagrams with instructions to be followed by
supporting personnel, for example, how to process a
bank transaction (for bank tellers) or how to process orders (for order clerks).
Before using al!CLEAR, you should be familiar with DOS
and the concepts of a file system, including files and directories. If you don't know what a file name is, what it means
to execute a command at the DOS prompt, or how to use the
DOS PATH and PRINT commands, you may need to learn
more about DOS to understand sorne of the important items
in this User's Guide.
You don't need to be a programmer to use allCLEAR. The
al!CLEAR script language is very simple, easy to learn, and
is designed to resemble English. The language tutorial (see
Language Reference) and the sarnple files should provide
you with enough guidance to achieve a great deal with
al!CLEAR.
What Is in the Package?

Your allCLEAR package includes software and supponing
hard copy material. The software includes:
...
allCLEAR Program - the main component of the package

which analyzes the script files and generares diagrams from
them.
...
ASETUP Program - the environment reconfiguration utility

which can be run as a stand-alone program or invoked from
the menus.
...
INST ALL - the program that sets up the files on your disk.
...
Other Programs - the text editor, called AEDIT, which

works with ASCII files; a program, called DIR. C.'{ART,
which scans your system's directory structure and converts it
into an al!CLEAR script describing a tree diag~am; a program, called OUTCHART, which convens an vutline into an
allCLEAR script describing a tree diagram; a program, called
BATCHART, which convens any DOS batch file into an
al!CLEAR script describing a procedure diagram (flow chan).
...
Fonts - different fonts al!CLEAR uses for diagram display

and printer output.
...
Sample Files - severa! sample script (*.ACL) files and their

style sheets (* .STY) which show various applications of the
program.
Your package also includes four additional materials:
'
;,,
...
User's Guide - the user manual which exp!ains how to use

the al!CLEAR command system.
...
Language Manual - the language reference guide which

describes the a!ICLEAR script language.
...
Registration Card - a card which you should fill out and

mail to us in order to register your a!ICLEAR package.

1-8 lr:troduction
organlzatlon of the User's Gulde 1-9
Organization of the User's Guide
Chapter 11, ADVANCED FEATURES

focuses on techniques for !he advanced users, such as
how to use allCLEAR with Lotus 123 or Symphony
spreadsheets and Outline files and how to use allCLEAR
to diagrarn batch files and DOS diretories.
The allCLEAR User's Guide is organized into twelve chapters:

Chapter 2, GE1TING STARTED
provides basic instructions on how to instaII and start
allCLEAR.
Chapter 12, ERROR MESSAGES AND WARNINGS

Iists allCLEAR error and warning messages (related to
diagrarn generation) with their explanations and corrections.
Chapter 3, SAMPLE SESSION

is a tutorial which illustrates the basic capabilities of
allCLEAR and may be !he only instruction you will require.
Chapter 4, al/CLEAR BASICS
introduces the basic concepts and explains the basic
operating principies of alICLEAR, including the command system and !he use of !he keyboard.
Chapter 5, MANAGJNG al/CLEAR SCRIPT FILES
provides comprehensive instructions on how to select,
edit, create, print and format script files with aJICLEAR.
A separate Language Reference describes !he a!ICLEAR
script language.
Chapter 6, VIEWING al/CLEAR DIAGRAMS
explains how to work with allCLEAR diagrams on the
screen using the four different views.
Chapter 7, PR/NT/NG al/CLEAR DIAGRAMS
contains comprehensive information on how to print
allCLEAR diagrams to !he primer or file and how to
work with !he different allCLEAR output files .
Chapter 8, WORKING W/TH THE STYLE SHEET
provides instructions en how to change various diagram
attributes using !he diagram Style Sheet and how to
manage allCLEAR Style Sheets.
Chapter 9, RUNNING EXTERNALS FROM a/ICLEAR
explains how to reconfigure alICLEAR environment,
change alICLEAR global parameters, and run extemal
programs from allCLEAR.
The fo!lowing conventions are u sed throughout the User' s

Guide:
1>
Keys - the actual key you should press is indicated by the

special font which approximates the appearance of the key
on the keyboard, for exarnple, ~ or [].
1>
Commands - the actual command you shouid enter is always

introduced by the instrucrion "type" and is indicated by the
courier font.
Tasks - the procedures which you should follow in order to
accomplish a particular task are introduced with the black
Iine heading which displays the description of the task.
1>
1>
Steps - the steps you should take in order to follow a particular procedure are set out by indentation and consecutively
numbered.
1>
Important Notes - the comments, instructions, or wamings

which are of particular importance are introduced with the
"pointing hand" flag and the word "IMPORTANT".
If you should find an error in this manual, or wish to malee a
cornment on how you did or did not like it, picase write to:
CLEAR SOFfWARE, INC.

P.O. Box 909
Brookline, MA 02146
Chapter 10, MOST COMMON QUEST!ONS AND

PROBLEMS
provides answers to the most common "How Do I?" and
"What Do I Do If?" questions.
....
........,
2-2 Gettlng Started
What Do You Need to Run allCLEAR? 2-3
Chapter Contents
What Do You Need to Run allCLEAR?
lnsta//ing a//CLEAR
Setting the PATH
Starting a//CLEAR
What Do You Need to Run allCLEAR?

. 2-3
. 2-4
. 2-6
. 2-8
. 2-9
1>
1>
You need the following equipment to run a!lCLEAR:

An IBM PC, PC/XT, PC/AT, PS(2, or 100% compatible personal computer.
A 5.25" or 3.5" diskette drive on the PC to run the
a!ICLEAR installation program.
1>
A hard (or fixed) disk drive on the PC on which the

a!JCLEAR program will be installed.
1>
512K bytes or more of available memory; 640K byte RAM

is strongly recommended.
1>
A COA, EGA, VGA, or Hercules graphics card.
1>
A printer that supports high-resolution graphics, i.e. any dotmatrix or Jaser printer (a daisy-wheel printer, for example,
does not print graphics).
IGi"
IMPORTANT: lf you have an HP LaserJet printer, please

make sure the printer has at least 512K bytes of available
memofY. Sorne older HP LaserJet models have 128K and you
will have to install additional memorY in order to print al~
CLEAR diagrams.
You also need the following software to run allCLEAR:

1>
DOS version 3.0 or later.
1>
If you don't want to use the editor provided with a!lCLEAR

(AEDIT), you can use another Text Editor or Word Processor.
2-4 Gettlng Started

'.~'
What Does the INSTALL Program Do? 25

Before you can use the al!CLEAR programs in this package,
you must copy them from the enclosed diskettes (distribution
diskettes) onto your han:! disk. In addition, you must tell
alICLEAR on what kind of printer you will print al!CLEAR
diagrams and what Text Editor or Word Processor you will
use to edit and create the allCLEAR script files. Finally, the
enclosed diskettes include sorne sample files that have to be
copied onto the hard disk in order for you to run the sample
session. This entire process is called installing the software
on your system.
The INSTALL program does the fol!owing things automatically:
"'
Unarchive the allCLEAR program files and copy them onto

your hard disk.
"'
Customize the al!CLEAR configuration file to your edito.,

primer and output port.
"'
Unarchive and copy fonts.
"'
Unarchive and copy sample files.
"'
e'
yoor root diedor whlch

contalns
AL!TOEXEC.BAT.
C:\OOS and C:\...
your DOS and other

ditectories whld'I exist on
)'OYI' system.
C:\ALLCLEAR\FONTS
contains saeen and
harocopy lonts.
C:\ALLCLEAR
concalns the maln and
$upportino aBCLEAR
program tues.
C'.\ALLCLEAR\SA.MPLES
contains .ACL and STY
tiles osed Curingttle
s.arrple sessk>n.
C:'ALLCLEAA\FILES
detloed as desUnation tor

al!CLEAA file OUl)Ul
..\SAMPLES\TUTOAIAL
contains .ACL and .STY
riles osed during the
language tutoal.
Unarchive and copy rniscellaneous extra programs.

In !he process f installing al! CLEAR, several directories are
created on you hard disk. Figure 2-1 is a graphical representation of these directories in the "tree" structure (using a
hypothetical system as an example).
C ~WP
~~~~~
your system.
Figure 2-1. Directory Tree After a//CLEAR lnstallation
C:\ALLCLEAA\TEMP
delined as temporary
;;irao11k:st,uHarfor
dtagr<ll'r. ';:enenttlon.
2~ Gettlng Started
lnstalling allCLEAR 27
lnstalling allCLEAR
5.
Befare installing aJ!CLEAR, please prepare the answers to

the following three questions:
Which Editor or Word Processor are you going to use with
al!CLEAR? Where is this Editor located?
...
As an example, let's assume that you want to use Word Perfectas the editor and that it is located in the C:\WP directory. Then you should type:
What is the printer connected to your PC?
...
C:::: \ WP \ WP i--'Enterj
To which output port is the printer connected?
...
a- IMPORTANT: a\ICLEAR inserts the parameter alter the

editor's name to always invoke the editor with the currently selected file. lf you wish to change that parameter (which is
something you might have to do if your editor doesn't accept
the file name from the command line), please run the Setup
utility when you enter a\ICLEAR and change the editor definition string.
To install allCLEAR:
1. Put the diskette labelled allCLEAR Disk #1 in your floppy

drive (we wi!I call this drive SOURCE).
2.
To give you an exarnple, let's assume that you have chosen

the A: floppy drive as the source for al!CLEAR installation.
So, you should put the al!CLEAR Disk #1 into drive A:
Type:
A : i.i Enter)
This will make A: (SOURCE) the curren! or logged drive.
3.
4.
Once the editor is specified, al!CLEAR asks you to select the

printer driver.
6.
Use the cursor keys to position the cursor on the desired

printer and press l?Enterj to select it.
a- IMPORTANT: Remember that if your printer is not on the list
Decide where on the hard disk you are going to put the
allCLEAR prograrn files (we will call this drive and directory DESTINATION).
of options available during the installation procedure, you

may be able to emulate one of the supported printers.
Check your printer manual to see if this is possible.
Again, let's assume that you are installing allCLf\R on the

C: drive and you wish to call the al!CLEAR directory
C:\ALLCLEAR.
The last step is to specify the output ;ort for the printer you
have just selected.
Be gin the INSTALL program with the SO URCE and

DESTINATION parameters.
In our example, you will have to type:
INSTALL A: C:\ALLCLEAR pEterJ

al!CLEAR then begins making the directories described
above and unarchiving and copying files. The next step is to
specify the Text Editor or Word Processor which you plan to
use to edit and creare the allCLEAR script files.
,~
Enter the path and program name for the Text Editor or Word
Processor of your choice. If you wish to use the a!ICLEAR
editor (AEDID. simply press i.iEnterl.
7.
Use the cursor keys to position the cursor on the desired

printer port (LPT 1, LPT2, or LPT3) and press 1--'Enterj to
select it.
al!CLEAR then completes the installation procedure, changes
directory to DESTINATION and comes back to the DOS
prompt.
s- IMPORT ANT: During installation, a\ICLEAR automatically configures the Graphics and File buffer directories to be the
TEMP and FILES subdirectories of the a!ICLEAR program directory. In arder to change these settings, as well as the editor,
printer, and port selections, run the Setup utility of the Run
menu.
2-8 Getting Started

Starting allCLEAR 2-9
Setting the PATH
Starting allCLEAR
To run al!CLEAR, the al!CLEAR prograrn directory (or

DESTINATION in our installation exarnple) must be either
the current directory or the directory listed in your DOS
PATH setting. P!ease follow the procedure illustrated in Figure 2-2 step-by-step to set the PATH for a!ICLEAR.
You can start a!ICLEAR using the fol!owing seven different

methods:
METHOD 1:
_Change directory to C:\ALLCLEAR and type:
A i..iEnterl
To set the PATH for allCLEAR:
al!CLEAR will be started and the script file directory

will be set to the default directory (specified in Setup).
Note that right after you run the INST ALL program, the
default file directory wil! be C:\ALLCLEAR\SAMPLES.
The a!ICLEAR prograrn directory does not have to be in
!he path in order to use this method.
METHOD2:
Change directory to C:\ALLCLEAR and type:
Go to ft\-:J root directory of
your is==Check
A C:\ALLCLEAR\SAMPLES\*.* i..iEnteri
(or any other script file directory). a!ICLEAR wil! be

started and the current directory and files-to-list wi!l be
set to whatever setting you entered fol!owing the "A"
command. This directory will be in effect only for one
session. The allCLEAR program directory does not
have to be in the path in order to use this method.
Create a new file ealled

AUTOEXEC.BAT in !he
l'OO!
directory.
METHOD3:
From any directory type:
T:.is file should contain
"PATH-C:\ALLCLEAA".
C:\ALLCLEAR\A ~Enteri
No
~llCLEAR
Add ";C:\ALLCLEAFr at
the end of thal line.
Add a new line to

AUTOEXEC.BAT
"PATH-C:\ALLCLEAR".
will be started and the script file directory

will be set to the default directory (specified in Setup).
The a!ICLEAR program directory does not have to be in
!he path in order to use this method.
METHOD4:
Type:
A C:\ALLCLEAR\SAMPLES\FILE.ACL i..iEnteri
This wil! enter allCLEAR and automatically select the

file (FILE.ACL). When you come back to the menu, !he
current directory will be set to
C:\ALLCLEAR\SAMPLES\* .ACL for that session.
Figure 2-2. Setting the PATH for al/CLEAR
210 Gettlng Started

fu>
METHODS:
Type:
A C:\ALLCLE~.R\SAMPLES\FILE.ACL -D l~Enter!
This will enter allCLEAR, automatically select the file

(FILE.ACL), and display the al!CLEAR diagram (using
the attached Sty!e Sheet) in the WaLlc-Through view. If
the Style Sheet is missing, the DEFAULT Style Sheet
will be used. When you come back to the menu, the
current directory will be set to
METHOD6:
Type:
Chapter 3:
Sample Session
This.chapter takes you step-by-step through
a sample session of allCLEAR. The script
files used in this sample session are
installed on your hard disk during the
allCLEAR installation procedure.
A C:\ALLCLEAR\SAMPLES\FILE.ACL -P FEnterl
This will enter al!CLEAR, automatically select the file

(FILE.ACL), and print the al!CLEAR diagram (using the
attached Style Sheet) to the currently selected primer. If
the Style Sheet is missing, the DEFAULT Style Sheet
will be used. When al!CLEAR finishes printing, the curren! directory will be set to
METHOD7:
For HP LaserJet and compatible printers, you can use
any of the first four methods with a special parameter,
-F which deactivates the printer font managemem
(down!oad and removal) usually performed by
al!CLEAR. For example, type:
A -F l~Enterl
This method is usef! for !hose people who intend to go

in and out of al!CLEAR frequently and don't want the
fonts to be down!oaded and removed every time (refer
to Chapter 11 for more information).
You shou!d try ali of the seven methods to determine which
one you Iike the most. However, the first time you run
al!CLEAR, we recommend that you use METHOD 1, which
is the most straightforward of the seven .
"-~ ... -.--~--- -~---.-''""
~--
-~ .. ~ ....""-'-.. -~........._,_,.,,$~ ...
--.......-..-.- ,..................,.,_,_ ,
-~ ...;.,.-...... ~.--.,,,.~..._,_......,..._,
--""'"' ., ....,. ,..
--.:-""-~--~
_._.__
3-2 Sample Sesslon
To Begln 3-3
Chapter Contents
To Begin
Getting Help
Selecting the File
Looking at the File
What Is Next . . . . . . . . .
To Begin
. 3-3
. 34
. 3-5
. 3-7
. 3-8
3-12
3-15
3-21
3-22
IMPORTANT: The instructions in this chapter assume that

you have successfully completed the al!CLEAR installation procedure, including configuring al!CLEAR for working with a Text
Editor or Word Processor of your choice. lf that is not the
case, please go back to Chapter 2 and follow the installation
and configuration lnstructions found there.
To begin the sample session:

1. Change directory to the allCLEAR system directory. For example, from !he DOS prompt type:
C: \ALLCLEAR
2.
tJEnterJ
Type:
A l~EnterJ
allCLEAR displays the introductory screen and enters h;;

menus.
~--~~
....... ,_,._,
............"--------
-----------"'
.,
3-4 Sample Sesslon
Selectlng the File 3-5
~:
Getting Help
;::_,.,
~r
Selecting the File
allCLEAR includes a context-sensitive help facility to provide you with information and reminders. This help feature
is keyed to the location of the cursor, and consists of two different parts:
The first step in generating an a!ICLEAR diagram is to

specify the script file. To do that you use the Select option
of the File menu. Notice that the cursor already highlights
the word "Select" in the File menu (Figure 3-3).
The one line message (Figure 3-1)

which allCLEAR displays in inverse video at the bottom
of the screen, and the most important keys, which
allCLEAR displays to the right of the Style Sheet.
~StvlSM.l:
Dl.....:t.e~
Ult
OTHIJlroMTS---
t !lth
L.aNLa
,,.tnta
: ... u
:-11
<ll-nd
!t
S..!..,l a -: .. 1,-t fil tor allct.1'.AJI acrtlo-
Figure 3-1.
___
c.-
S:t...rt
'lart,..... 11.1.,...,.
: rl1H ,......lhlo9r-
i.. .. , ...
"'""'"'
:: dllP
tr.,...u.
l.aop
___j
lnd
: H.l-llc. 1z,.1,.ta
: 191-Uoa
",.tnta
l'AllOllJWOlll"---
, ....... t
ia...11"1: U
L-im:~OFSl'AnS
St.ai-rt: .....U"fl
ID
"-" Ult
P'rlnl
""'
mi
Orla .. t.tl11:l.~,.
,.,..... Un: latl.r
SLda
:4-}ola
SU.rt O..
: rl,~t ,.,_
~~:.
""'"'
::
1---~IMS---
ten
!onl
Rlsftl
Top
"'"
: l.ZSLnci...
loth"
: t.ZS lr.cllaa
:l .:ZS
I~
----- ~I
The On-Line Help

S.lact scrlpt rtlo ror llCl..lAI: aclto_~------~
The help screen (Figure 3-2)

which you can access at any point in a!ICLEAR operations by pressing IIT]. When you have reviewed the
necessary information, press any key to retum to the
point where you were when you asked for help.
L!IG.
,,
;p4rn;.
llIIZll:'.!l
1. . . .
-,
?E*'" '"'Y'
&
TllP FILE ... u-. t<r ~11f'd '' ~rl~t flt;. for d1ct_CM
.-rl1"" , ..,..,...,.. tlat> ..,nr..., di<'ft:lCl""f, 1cht U11 cur""'1 filr, crrlP
il ...... n ..,.,ni ............ '.". r11 ... tn fhl"pri,.,rr ........ ..
tln I"'""" fll.- uUh Uv l la.F.nR 11111' f<l'.--llrr. Pl"f"7:: 1011 IU" . ~
Figure 3-3. The File Menu
To specify thefile:
1.
Press
'
1..,Enterl to activate the Select option of the
allCLEAR displays the list of ali the script files (with extension .ACL) in the SAMPLES subdirectory of the al!CLEAR
system directory (Figure 3-4).
1n1 .-. ........ , ... ,,11.E-.
. ,,
Rlt .......... lh.ot ti.~..,..., fl.-st :;&.1J9 ,..
""'t&""' llCWR
i~ ta
~u., ~rlpt. UIE" ... tc:h u.UI hl' tllr !".ubjrr:t or all ~loro!:,
P11 ....... n-f...- to thr di"..<.rit1l10 f lll1. ~.rrlpf. I~ itn lltr
&....~ ~~...,r l~ fh~
File menu.
c:tt<tlr Jfl.r.:__.t_llQ.Etl.R ~ript .

HIH..' ' l&ti>" ltil Dlrrcto..., optlo" In tls ... ..,.. ir 'fOU ul~ lo ..,r
f_ """'"
uUlt strtpt fil" ,,. dlffl"IT!'lt dlt'ttlOl'tf. UJr' thP Pr-IPt hlf"
apllon I lh:: ta prlal lhL" :olt-.;kd Fil~ lll th1 prinkr u'l:i"9
tl"!'Pllll'ff.,tlltt., .
t.,r-tapt11>1tinthl~-topro...,-l':f
. .
.,....t,..
c:""~~~~~~~:: ~~~~-:.~-----t-.~
Figure 3-2. The Help Screen
~oloci.
acrlpt lllo or LICl...lAJI eUo .... (,..,.ti..
dl,...c;lo~
Figure 3-4. The File Selection Display
llslln1
3-6 Sample Sesslon
Looking at the File 3-7
2.
Use the arrow keys to position the cursor on the

COVERED.ACL file and then press l-'Enterl to select it.
COVERED.ACL is a sample script file describing a simple
procedure of determining whether a person is covered by an
insurance policy.
Once the file is selected, al!CLEAR comes back to the File
menu. Notice that the name of the selected file is now displayed at the bottom of the screen (above the help line) and
the name of the Style Sheet attached to that file is displayed
at the head of the Style Sheet.
Looking at the File

At this point, it would be useful to review the contents of the
selected script file. Refer to the Language Reference if you
don 't understand any of the script symbols or constructions.
To look at the script file:
1.
Press [] to position the cursor on the Edit option of the File

menu and press l-'Enterl to actvate it.
allCLEAR then transfers control to the Editor which shows
the first screen ofthe selected script file (Figure 3-5). You
can now edit the file or just browse it using the editor commands familiar to you.
tt..lleJNtl..,t.',..._,..At..otllolrlll.
~~ ;:-l:: 1 ~~:!:-..:~.~t:""u.~~. . 4.,.;
<S,...s.> Is t."1 r ... u,. ...... tnottvlMI 1'011C'J1
...
<l""'lv.> 11 sp!N.M Is anl'JI _..... ......... ra.111-. po11.,.,,.
cr-11!f) u.i.,..... .... 1.,.._...,,,.
<ChllO,..t.wr-olclilld?
<v...> ,,.,...t. .,_. rr-P la Uw d.IU'?
<<1,,Tlals,..-sonl~.
<:> 1'> I u.re "'J cid" UM.t U. clllld la ..... 11111 l ....,..rt. u ...... 1r
Clt.ll......,...,...1'.,.....,t_,......,.,1.,., Uwo,irc.i1,.u,1u.
"''
cv-> latl,..,..,.iclan'e.rtltlcab .. t....i1eoil

<Yn> TU p.rM" 1s ~.
(1'o)
1ui.111t~?
Tloil~ftla""tce....-..1.,IU...rtaMc:t..r-'saU~t.
'!"'
,....'""'
<llo) h
tM cUU. 1... 11!11 ....,,.t.MT
Rgure 3-5. Rrst Screen of the Selected Rle (AEDIT)

IQ'
IMPORTANT: The Editor allCLEAR invokes is the Text Editor

or Word Processor which you have specified during the installation procedure. lf your editor does not accept the filename
from the command line, you will have to enter the file name
before the Editor shows you the script file.
2.
When you finish reviewing the file , exit the Editor. lf you are
using the AEDIT editor, press ~aJJCLEAR comes back to the File menu.
-._
----IL,_----.-
3-8 Sample Sesslon

Displaying the Diagram 3-9

Now we are ready ro take the firsr Iook at rhe diagram. You
should norice the View oprion in the allCLEAR main menu
ar the top of the screen. This is the menu which allows you
ro generare the diagram to screen in severa! different
"views". First, we will display the diagram using the
simplest view, called the Scroll Yiew.
1.
:l
Press EJ ro activare the View menu (assuming you are still in

the File menu).
Dlsple.,.tllel"V'l"""t"-acrw." lns.: .... 11-de
Figure 3-7. The Rle Processing Status Screen
al!CLEAR dispiays the pull-down menu with the available

Yiew options (Figure 3-6).
nn
"'"
L_
Tn
si,..
~,..,
S'milOL
: Hel....ilc..
'"'"JO
,,..lnh
...
=-11
-ASSI'1tmfror~
St..u..nt: ....,la"fi
Ir
: ,,_,,..
ea-
' .._,.,,
Chotcn
t..o,
: tra~1'
' 111,...
: ltsl-t,.,. 18 ,.\nls
: Hel ... ttc.a 1 l"Olnt
"*"llJM)(ff
llti.
i..u.1.
0.-1.,,t.u ... : ,.. .. t ... ll
,..,,. .. u,..: hu....

s1u.
: "--1
SlartO..
: rt,lllpap
,..,.,..,.
1o....i..,....
,.,.
_ _ _ ,.,.llC"{l'U
i..tt
.t1,11t
St..rt
: ,....u,..,.
r.,.
t""
:,.1,u,......1i.1.,.._
lot.t-
'
.zs , .......,
: l.2S lncicn
: e.se lncu.
: l.ZStnca..
When the file is processed, al!CLEAR begins building the

diagram. Again, allCLEAR informs you of the progress by
showing the degree of diagrarn completion on the termometer-like gauge (Figure 3-8).
m
....
ll!I
""
IEI
St11 l
Sl,lo.st..t: COUDID . STV
@=I_'r<ic.d..,..
"""'"
~L
lllfi
r..,,1.
; Q1
~.
~~l~
' ~
~~..,o..
~ ;~'"t
,.,.
Bard.,....
: on
: tr,....l<I
t..fl
11,11t
: 8 . ZS l nc:lln
: a.zst,...,Jls
: ol lt pse
!01
: e . se l nc:"s
St...rt
: ,....;tu"J I
lloll ...
: 11.Z:S l nc:l<H;
End
: rl s H ,..,..11.1., .....
: o-no1
c.-
: ... ,..,..,,.
C l cl't:
Loop
8 l'Olnh
Ortentatlon! portralt
P.,.rSlno: !rtlr
s1.i...
: 110..bl
11RitGI~
- --
ln ler""pt
The screen now clears to display rhe diagram (Figure 3-9).
a!ICLEAR begins processing the script file and checking ir

for errors. You can see the progress of file processing as the
rexr of the file scrolls rhrough the center window on the
screen (Figure 3-7) .
'.:
: ..... 11
'polnls
Rgure 3-8. The Diagram Process1ng S tatus Screen
These sreps direcr aIICLEAR to generare the diagram of the

selected scripr file ro screen and display it in the Scroll view.
OTHEJI CffS~
: HIPJ ... uc:o 18 polnh [
C:trl-~kto
Notice rhat the cursor is posirioned on the first option (rhe

Scroll view), which is the one we are going to select. Press
L"'"Enterl now.
------.. . ------- - .
s1-.
rr
Figure 3-6. The View Menu
-~--- ---~-~-~-
:Hel.,,..Uc:a
:....-.,
Slat....,.t: ,..,.clnt l '"
Dlqila'llthdl"'"nt.'1irse.....,,,Scroll...:icl
. --- -
hnt
taxt.
~l:S1~
.!
2.
Tltl
1.&Mll
DIACIWI
.!f'.
3-10 Sample Session

Dlsplaylng the Dlagram 3-11
e::..;:~;::;::~:
_........
. .._
.........,......
...._.... ..
C:..t
,,..
- - - - - - - / .::~.~: ~
.....
. . 11cvJool:
~~
Rgure 3-9. Sample Diagram in Sera// View

Rgure 3-10. Sample Diagram Zoomed In
When it is displayed on the screen, the diagram is scaled

down in size, so that the complete drawing can fit on one
screen. This is a good time, perhaps, to bring the diagram up
a little (or zoom in) so that you can better see !he details.
3.
Press EJ to zoom in to the next zoom leve!. Then press

again to zoom in even further.
Use [J. [[], EJ. EJ. ~. ~.

scroll the diagrarn.
!Homel, and ~ to
After you are done experimenting with the scrolling keys,

please press O to zoom the diagrarn out. This will assure
the accuracy of the illustrations which follow.
EJ
Now that the diagram is scaled :;p (Figure 3-10), it is bigger

than the screen. You need to scroll it to view the parts that
are beyond the screen.
"'
4.
5.
Press ~ to exit diagram display and get back to the menu.
......, _
-, -
3-12 Sample Session
Walking Through the Diagram 3-13

2.
You are now ready to see another diagram view, called WalkThrough. As suggested by its name, the Walk-Through view
allows you to step through the diagram displayed on the
screen.
This is the "spacious" walk, or the cursor moves through the

diagram with no regard to !he logic flow. a!ICLEAR also allows you to trace !he logic of the diagram step-by-step.
To walk througlt the sample diagram:

1.
Press []to position the cursor on the Wa!k-Through option

of the View menu and press [+'Enterl.
al!CLEAR shows you the diagram in a view similar to !he
Scroll view. In addition, it positions the "tracing" cursor inside the first box and displays the contents of this box at the
top of !he screen (Figure 3-11 ).
~ - nt.
"~ an<1 <ll er "'ltll.
Use EJ, [], EJ, EJ, ~. and [PageOown l to mov~ the cursor in different directions through the diagram.
;~
~f~
-~
.;.~:,
;i~
,f.-'
3.
Press [Home[ to point to the first box.
4.
Press [--'Ented or [-Backspace[ to step to the next or previous logical step in a procedure diagram. Press [+'Ente<[ or [-Backspace[
to traverse the tree forward or backward in a tree diagram or
decision tree.
In a procedure diagram or a decision tree, when you reach a
statement of branching, such as lf, Loop, or Case, al!CLEAR
expects you to specify which branch you wish to continue
walking through. In these cases, in addition to the usual line
of text at the top of the screen, you can see a second line
which lists the available choices (drawn from the text of the
script file). The bar cursor is positioned on the first choice
(Figure 3-12).
I
lht
ratlw
QIOIC~:Elil:tII!JI
tn.i.1 .. 14....,.I
. . 110,.'J
r-tl\I
Rgure 3-11. Sampfe Diagram In Walk-Through View
You can now manipulate the tracing cursor and jump from
one box to another.
Rgure 3-12.
Walking from a Branching Statement
3-14 Sample Session
You can press !Space Bar! to position the bar cursor on the
choice you wish to trace and press [--'Enterl to select it. The
tracing cursor then moves in the direction of your choice.
Thus, if "Family" choice is selected in the illustration above,
the cursor will step to "This person is covered." box.
Preparing the Dlagram for Print 3-15

After dispiay1ng thc diagram in Scroll and Walk-Through
vicws, you should feel cxuemely familiar with it. This is a
good time to find out how it will look on paper. allCLEAR
provides you with a way to preview on the screen ali the
diagrarn pages and diagram layout throughout the pages.
In sorne cases, you may wish to go back to the previous position, or undo the last step.
5.
Press
6.
When you finish experimenting with walking through the

diagram, press ~ to exit diagram display and get back to
the menu.
[QJ to undo the previous logical step.
/ To. prepare. the:cliagrant for pnting:

1.
Press :i to position the cursor on the All-Pages option of the

View menu and press !--'Enterl to select it.
allCLEAR rebuilds the diagram and shows you the All-Pages
view which is an approximation of the complete printout
scaled to fit on the screen (Figure 3-13).
lml!m!I [
Figure 3-13. Sample Oiagram in All-Pages View
Now that you see what the diagram will look like when
pnntcd. you sl1ould cxperimeni to see if you can make it bettc in tcnns ol ;pace: consumptio n and clarity. For example.
thc shape ol tlic diagram is vel)' much affected by the
diagra111 para111ctcr calleJ "Style". Let 's see what happens
\Vh<.:n wc ch:mgc thc '\ tylc of the sample diagram.
Preparlng the Dlagram for Prlnt 3-17

3-16 Sample Session
In order to change any of the diagram and page layout attributes, you should leam how to work with the curren! Style
Sheet.
2.
Press ~ to get back to the menu.
3.
Press EJ to display the Style menu. Select the Edit option

from that menu .
a!ICLEAR enters the curren! Style Sheet and positions the

cursor on !he first diagram attribute, diagram type. You can
move the cursor around the Style Sheet using the standard
cursor control keys or highlighted letter keys.
4.
Press [] to move the cursor to the diagram Style artribute and

press 1-'Enterj to change it.
a!ICLEAR displays a popup menu with ali the available
diagram Style options (Figure 3-14).
l'lmm!I
1 DI
.....
______
nu. .,,.."""'
.1ca 1s,.1fttsllm
---!-----""'""""'
e
Sl'lll Shnt.: COUDD.ST't
11~_,..
.. _
Lakls
",.1..ta
si...1.1.., , ...
-ltSSIQll"lll'l"tOfs:tn:S
Sht-=~"'91
ir
......,...
:.u-'""
~-
e.Mices
:tra-14
lllpse
:,...,.u."!li
l.o
Start.
'""'
'""11...
: lt!JlueUca
a ,.l,.UI:
SI"'"
st.art.0.
'"'I"'
........
Jau....
: -.....ta
1 ..1,hlps-
..........
:
:
'1oll
""'""'
EIP
hs:1l
ll'lcion
S.Z51~
RlsJit
Top
: 1.58\nc.M'I:
let"""
:1.ZSl-
' f" l f'- ~,....11.1._
Position the cursor on Style four (far example) and press 1-'Enterj
to select it.
Now we need to direct al!CLEAR to generate the diagram
again by going back to the View menu and selecting the AllPages option. However, let's take a shortcut.
Press
7.
~11
Figure 3-14. Editing the Style Sheet
6.
You can see that with style faur the diagram becomes wide.
In this case it makes sense to choose !andscape page orientation (rather than currently selected portrait).
Orl....U.t.loJI: ,..-t,.ait..
,,,_.s1a:
!>elect. di~.- Sl'lll" sl'lllft art..:1. U.e 41!1"" dl'C enl'll
5.
Figure 3-15. Sample Diagram with Style Four
idll
IBJ which is the fast key far All-Pages view.
As illustrated in Figure 3-15, changing the style of our

sample diagram makes it spread out more and take up more
pages.
8.
Press ~to go back to the Style Sheet and select the

landscape setting far the page orientation parameter (the
Orientation option of the Page Layout section.
Press
IBJ again to see the diagram in All-Pages view.
al!CLEAR rebuilds the diagram and shows you the new

layout (Figure J.j. Notice that it takes up only 2 pages
now.
3-18 Sample Session

Preparing the Diagram for Print 3-19
i"r.~
nmllmJI
Agure 3-16. Sample Diagram with Landscape Orii:ntation
9.
While in the All-Pages view, press [] to change the box size

from small to medium. Press [] one more time to change
the box size from medium to large.
Using the menus, you can press [jQ) to go back to the Style
Sheet and select the large setting for the symbol size
parameter (the Size option of the Symbol section. Then
press iffi to generate the diagram again.
As you can see, the effect of this change is dramatic; instead
of 2 pages the diagram now takes up 15.
Notice the cursor which is positioned on the first page of the
diagram. You can use the cursor keys to point to a page of
your choice and then zoom in on that page if you wish to
review its contents in greater detail.
10. Press
EJ to zoom in on the first page.
allCLEAR displays the first page and scales it down to fit on

the screen (Figure 3-17).
~
:~Ht>
'l
~~
You may wonder what would happen if the boxes on the

diagram were of a different size. We can take another
shortcut here by using the allCLEAR fast keys.
"
Agure 3-17. Arst Page of the Sample Oiagram
11. Press JTab~l to display the second page (or the next page to
the right of the first page). Press J~ Shiftl and, without releasing it, JTab~I to display the next page to the left of the current
page.
12. When you finish looking at the pages, press
and see the complete picture again.
O to zoom out
The All-Pages view is mostly intended for ch-J<Jsing the settings which malee the diagram smaller and clearer. It looks
like our experiments took us far away from th:;.t goal and the
original senings were much bener. Let's come back to those
settings before we proceed any further.
13. Press QJ to edit the Style Sheet. Select Diagram Style two,
Symbol Size small, and Page Orientation portrait.
So far, what has been shown to you are approximations of
the actual primer output. At this point, you may want to see
exactly how the pages will look on the printer. This is the
purpose of the last allCLEAR diagram view.
3-20 Sample Session
Printing the Diagram 321
14. Press ~ to access the menus. Se!ect the Print Preview option of the Vicw menu.

The instructions below assume that you have previously configured allCLEAR to use the correct printer driver. Printer
driver installation is a part of the al!CLEAR installation procedure.
allCLEAR displays the first page in its actual size, without

scaling it to fit on the screen (Figure 3-18).
Is the Patient Covered?
To pnt the diagram:
1
1.
Select the Printer option from the Print menu ar press (0.
If you are printing to a PostScript ar Canon printer,
a!ICLEAR prompts whether ar not you wish to scale the
diagram to fit on one page. Far any other printer, al!CLEAR
displays the Print Options screen (Figure 3-19).
,..l!tWIQM\ Prlnt
Ge1neo;;i11rrrsn;rn1
an:!Oilo1D'tf\
wn;tWm-m
~.,JF,;! D.1:f'i
Geine1x:ihCJflQloers
flilmlan11"U:ltlr'
,,..
~~
FnL
t ... t.
r~-----~"
"~
s,_1..,
-ASS1'"1t
-'
Slat..o.ni:
Ir
..
: 41
'
.....
,..,.,
Cholcni
,ftBlmll
....
:;:!;"~~
.. ~ '""'
..!..t
Pr111t f'.tq>l't P9i_"';,- .," ..,
Rr=l f'rinln>
Dounlo.d l"ont~
ID -
OK
al/ -
U\t.
.......
.....
ID -
:tr~Ol<l
<1!H
: 111,_
: .-.ct"'!I
~tt ....
: rlJU ,..relhl!ll,....
Qull
: l.ZSl""'lt.r:a
: e.se 1.,..,,."
: D.ZSlncll..s
Figure 3-18. Print Preview of the Sample Diagram

!nur tha ""'"lierof tk<! f!rst p&'f to ti.. ,rlnted "df...,lt ! pr!nt ll
15. Use the cursor keys to scroll and see more of th~ !Jage.
Figure 3-19. Diagram Print
You can be sure that what you see on the screen is what you
are going to get on :he primer (the WYSIWYG approach).
After you Print Preview ali the pages, the diagram should be
ready for primer or file output.
Option~
Make sure your primer , prnperly connected and on-line.
2.
Press fF7l to begin printing.

allCLEAR prints out the diagram. It should look very
familiar to you have just seen it in rnany different views (including Print Preview) or. the sr.reen. When the diagram
finishes printing, allCLEAR comes back to the menu.
"'~- -~-~
...,_.,,.,,.,,....
..........
,.._
,,""'"""'"""~--.....-~-...
... .........
~---
...-"""""... :.,"" ......
~.........,. __
,_
... ____..._
,
___-_.
___
-- -----........
~-~
...
..... ..---...
-
--~-
.... ---~-,.__,..
-~.....---
... ___
~----"-
, ...._..
....
___
........... ,.... __ ........,_,_,.,_._, ..
---------
-;
..........
..... ,,.
~---~-
..,_, ........... , ________ ,. ..
,~---
... ..
. ...... _____
3-22 Sample Session

What Is Next 3-23
What Is Next
To create a new scpt file~

You have now leamed how to generate allCLEAR diagrams
from the existing scrpt files. To find out more ahout how
al!CLEAR works. consult the appropriate chapters in this
User's Guide.
1. Select the New Edit option of the File menu.

2.
You should continue with another tutora] found in the

separate Language Manual to get an introduction to the
aJICLEAR scrpt language.
Enter the new scrpt file name next to the current directory
strng, to where allCLEAR has moved the cursor (Figure
3-20).
1
st'lll s:>w.l: COUDD.S'!Y
telsct
~~~
r~
The al!CLEAR language tutora] uses the sample scrpt files

located in the \TUTORIAL subdirectory of the
\ALLCLEAR\SAMPLES directory.
1.
Select thc Select option of the File menu.
Position the cursor on the \TUTORIAL option and press /--'Enter)

The \ALLCLEAR\SAMPLES\TUTORIAL\*.ACL directory
is now the working allCLEAR directory. You are now ready
to start the language tutoral.
After you have gone <llf0ugh the language tutorial , you are
ready to try creating your own scrpt files and genera ting
diagrams from them.
: ... 11.. uc.o. a ,..11.u
hl<l
; ..... ,
,..,.,.u.:
s 1Sha4l"9
,...,.11
: on
:n.rt On
Sl.S.a
St.-to...,t:
11'
C.ae
:
Cl\olcn1 :
tAo,
:
Slut
:
~.,1..,
Ion!...,.
.-.oU.ntlo
:1-"'
b ... ,..,.
L'""
allCLEAR displays the list of .ACL files in the

\ALLCLEAR\SAMPLES directory. Notice that the
\TUTORIAL subdirectory is displayed as one of the entries
in the file selection display.
2.
rtll
o..toea
~ lt$SIQl'Wf? Or Sl'4APC:
rr-0 qr. rim 1n6flN!!t?i efufo 41111111
?~....~
-..-..-,-.,-.
-.-..-...-.+...-,-....-.-"-...~,!~ - -
"""'Ull
~ts
tropc-nl
oLll,sa
....,t....,.,lo
: .. 1,11t,..,..lll~
!rlt ...
: -.1>1
: rl1lr.l ,.. . .
: "
nAKll'IS---
: l.ZS lncM>I
l!1U
Ta,
. . l~
: l.2S lrociLn:
: l.Sol lnc~
: 1.25 l..U-
~
IIlll
St~lo
Clll
: "
t..rrt
""'""'
Elll
Tenlo
~e
rrr~-,,.
C~h o,_,, filo"" '""tao th IW:"t.!..,. hxt
Ulhr h
dlt ll
Rgure 3-20. Creating a New Script Rle
3.
Once the new script file is saved, aJICLEAR comes back to the
menus and asks you to select the diagram type (Figure 3-21).
r"''
~
q113srwm-m
lw
""""':1tm1-uc.1z,.11rt
~
s:t.,1.si...t.: iu...,.,,
Tltl
Wbela
Tn1
Flw<:lalo., l '.-o
: a .. l..
s1 ....
: -..11
, si....:1..,:
. rr
cr st'iill'f:S
su.a-..i.: ...cu..,i.
lf
Sl<ln.
: .touI
: r1,h1..,...,.
; ..,,...,..,.
: Llt ,_,...Lsr: .. 1,1rit,_,..11.1..,.. -
,.1,.t.s
l M~pc
s 1.arlt>n
,,.,1..,
: n
krd...-s
: ...
~t:.
. e. ::;
llt ~ l
:l.ZSl...,..,.
Top
..ti._
1.ZSI~
l . ZS lnc"-
: o-M
O.Ole.a: lra~li
Loo,
:elllp-..
St.a.-t
:...,
O.. h..tUr>
r apcr Un : l .ttr
1 - - - - MSI~
c..-
: H111l-i1c;..0
Pl'IC;t: UWOUT - - -
1.. ta
ro .. t
f .,><l
MKIJCS - - ~ncJ.n
IIlll
St'lll
Clil
'"'""'
lllU
:~sst=
~I
S.Le<::l ~. T,..., .,. ~Id" T..- tatr- t.,,,._
Figure 3-21. Selecting the Diagram Type
As explained in the Lnguage Manual, it is important that the

corree! diagram type be selected. Otherwise, allCLEAR will
probably report an error message .
__
.....,.,_,,_.,.
..........-..
..---..
...__....--,~--
.. -~.
,,.
--~
3-24 Sample Sesslon
4.
Goback to the beginning of this sample session and perform al!

the operations again on the file you have just created. Please
remember that you can always press
to enter the Editor
directly from diagrarn display and make changes to the script.
ru
S.
Select the Attach to File option of the Style menu to save the
Style Sheet for the script file you have created.
After you finish going through the al!CLEAR tutorials and
creating script files, you may wish to end your first
al!CLEAR session.
Chapter 4:
allCLEAR Basics
To exit allCLEAR:
1. Select the Quit option of the main menu.
This chapter presents an overview of

allCLEAR basic concepts and provides
general operating guidelines for using the
allCLEAR command system.
4-2 allCLEAR Baslcs

allCLEAR Diagrams 4-3
Chapter Contents
allCLEAR Diagrams
Script Files . .
The Style Sheet . .
allCLEAR Menus . . . . . . . .
On-line Help and Error Messages
allCLEAR Keys
allCLEAR Diagrams
. 4-3
. 4-8
allCLEAR diagrams represen! the textual description of a

process or hierarchy in the form of standard graphical charts
consisting of symbols, text, and lines. Because allCLEAR
diagrarns are generated in graphics (as opposed to text)
mode, they give you presentation quality results.
. 4-9
4-11
4-14
4-15
4-17
Just like percentages are usually shown with a pie chart in

business graphics, it is common to represen! a process with a
flow chart, a hierarchical structure with a tree chart, and a
decision path with a decision tree. Most diagrams fit under
one of those broad categories. To reflect that fact,
allCLEAR produces three types of diagrams:
.,.
Procedure Diagram (or flow chart),
.,.
Tree Diagram (or hierarchy chart), and
1>
Decision Tree.
PROCEDURE DIAGRAM
A Procedure Diagram (Figure 4-1) represems a logical
chain of steps which have to be executed in certain order,
such as instructions on how to follow a culinary recipe or fill
out a tax form.
Any procedure consists of two categories of steps:
.,.
l. Steps which are simply executed one after another (for exarnple, "Enter total income on line #24. ").
1>
2. Decisions which have to be made in the course of the procedure (for exarnple, "Is your total income greater than
$20,000?").
The first category of steps is represented with a symbol
which has one orno line (or connection) going out of it.
The script statements which describe such steps are called
"linear". The second category of steps can ha ve as many
lines going out of it as there are alternative choices for the
condition described by the decision. The script staternents
which describe such steps are called "logical" or "branching" . These are the staternents which necessitate script symbols and block structures, such as?- (c h oi c e) -?e nd , in
the allCLEAR script language.
allCLEAR Diagrams 4-5
4-4 allClEAR Basics
TREE DIAGRAM
A Tree Diagram (Figure 4-2) is very different from the procedure diagram. Instead of showing a sequence of events, it
shows a hierarchical structure with no elements of logic flow
in it. A very common example of a tree diagram describes
the hierarchical structure of a company or the organizational
chart.
Any tree diagram consists of three categories of components:
What to Do lf the Engine Overheats
Yes
..
l. The main componen! (or the root of the tree).
..
2. Components which are lower in hierarchy than the main

componen! but still have subordinate components.
..
3. Components which are lowest in hierarchy and have no

subordinate components.
The main componen! is always shown at the top center of
the diagram. The tree then branches out to the second
category of components which are represented at the appropriate levels of hierarchy. The last category of components is shown at the last leve! of each branch of the tree
diagrarn.
Youcan~s1Nt
tlrivtngl
DECISION TREE
..
A Decision Tree (Figure 4-3) is a combination of the procedure and tree diagrams. It represents a hierarchical structure
with sorne elements of logical decisions in it, such as structure and policy, for exarnple.
A decision tree consists of three categories of steps and components:
l. The main componen! (or the root of :he tree).
..
2. Decisions which have to be made to determine further
composition .
3. Other subordinate components of the tree.
l.::=.J
No
\..., :,.. \ [,,--__.
' -.~-~
<7
The three categories are represented the sarne way as the corresponding categories on the procedure and tree diagrams.
Adcoolantto!he
rvs.t<Voot aod rao;muor.
Figure 4-1. Sample Procedure Diagram
4-6 allCLEAR Basics
allCLEAR Dlagrams 4-7
Organizational Chart of a Software Company
New Patient's Visit
SOFTWARE GENERAL
INCORPORATEO
President
Mr. John L!vinlhal
OEVELOPMENT
VICe Presk!ent
Mr. Richard JacobsOn
FlNANCE & SUPPORT

VicPresidem. ot Finance
Mr. Eric L.Mngston
MARKETING
Vice President
Cwight Blackstone
SALES
VQ Presidenl
Oa\11dCarter
FINANCEIACCOUNTING
Director
Jashua Blrmingham
BurtStn.11'19
Controilet
.A.OVERTISING
Oirector
sm Stratnmore
NATIONAL ACCOUNTS
Kei~K~W~ton
~"
~1~
~
ENGINEEAING
NFN PATlaIT
v..
Oiscusslamily tlistory.
NO
Plan future monitorino
and lrllllmtnt.
~':f
~~:
Counseilhe~lienl
NEW PROOUCTS
~r::?r..
EMPLOYEE AELATIONS
Personnel Manaqer
Margare! Trainer
TELEMARKETING
M.anager
Ern.tt Fraser
!NTERNAT10NAL
ACCOUNTS
Manaoe<
Arme Dewar
Test tO ~lhll
prt>lem.
PAOOUCT SUPPORT
OFFICE OPERATIONS
~~
Usa Mor~
Manager
CUST0"'4ER SUPPORT
Mana99f
Matk Rvers
PAESS AELATIC>W;
Director
Char!-e Ch2p
RETAIL & OISTAIBUTK)N
.:~~~le
0.!1Wm1ne lhll t>icst
b'N tment strateqy.
EncouraQt! more rnlistic

ell.C)el:tabOns.
T1.eattheproblern
svrgically 0tmedcally.
ps)"d"IQlogcat prooklrr..
MARKET RESEAACH
Director
Loi.s Traughbien
OUAU1Y ASSURANCE
~"~:fers
Figure 4-2. Sampte Tree Oiagram
.._....,..
Proo. benavlOf rad
Figure 4-3. Sample Decision Tree
Explof~ possi
The Style Sheet 4-9
4-8 allCLEAR Basics
The Style Sheet
Script Files
An a!ICLEAR script file is the file which holds the description of an al!CLEAR diagram in the allCLEAR script language. This file looks pretty much like a regular English
text document oran outline. However, a script file also contains the script symbols, such as the ?- (choice) -?end,
which identify the logical constructions. Figure 4-4 shows
the script file describing the procedure diagram in Figure 4-1.
The al!CLEAR script files can have any name and extension.
However, we recommend that you give them extension .ACL
to differentiate between the script files and other documents.
Refer to the separate Language Manual for detailed information on the allCLEAR script language and the script files.
l.lhat to :Do lf the Engine Ouerheats

Does you.r ca.r Mue an a.ir conditioner7
('les) Turn the air conditioner off.

?end
To.ke t.he uehicle to a safe place and park .

-check
Let the cngine run at. the ldle specd t'or a fcw "inut.es.
Is thc te"peNt.t.ure down to accepta.ble level7
,,
The Style Sheet is an allCLEAR file which holds information on ali the attributes of a diagram, such as diagram type,
style, fonts, page layout, etc. The concept of an al!CLEAR
Style Sheet is similar to the concept of a style sheet in a desktop publishing system. In a desk-top publishing system, a
style sheet formats the 1ex1 in a document and assures that it
appears in a certain way on the screen or printer. In
al!CLEAR, the Style Sheet formats the diagram and determines which attributes it is to have when it is displayed or
printed. If the script file determines the "substance" of a
diagram, the Style Sheet defines its "form ".
Obviously, the same diagram can take a number of different
forms. Thus, the Style Sheet is next to the script file in importance as far as the allCLEAR diagram is concerned. To
emphasize that fact, the Style Sheet related to the current
script file is always displayed on the allCLEAR menu screen
(Figure 4-5). The Style Sheet information is saved in a file.
The style sheet file always has the same name as the script
file and extension .STY and is located in the same directory
as the related script file.
/l"'t"" 11z *?f"'WW

n.,.1.s-t:
('fes> You Cdn now start d.riuing!
CNol Turn thc enginc off .

Does the water pu,,.p belt look OK1'
CNo)
>dea ler
(Yes) Check t.he coo lant leucl.

Is it below t.he "LOW" l lne7
(Yes) Add coo lant. to the reseruoir and radf4tor.
>check
CHo)
>dea ler
?end
?end
?end
-dea ler
l 1H~1e : {j;":" ._
[!~~.
- - - S"'"BOL
r ... t
: Ho:l<..,.t! C
Orh"Utlo11: ,..,.trall
' ,.. 1,,ts
;:::S~ :::~~:
1
ra:
s1-
Tet
; ur I'
, . ,...,.
SI-
: P> lt
: on
SI"'"
Stultm
P.,1..,
' '--bl
: r t,i.l r !!
: "
ten
~ llSS!Clll'liltt OF SHMCS
ShMll...,
:;"-"':~::::::::
ea: hJt&''"'
UIYO\IT - - -
l ltr
S . ZS Lnckn
: tr~
.
<>l<i
l l!hl
: l.ZS l n<:k.S
Loop
: l!lpu
Tor
: 11 . s.e
St.,-t
[,...
: ,..cla "'Jh
: rl!llp.ora l lo Log...,.
&otlo,.
t1>e~~
Br i ng your cor to the dca lcr.
Figure 4-4. Sampfe Script File
11
ci.....,. 1
QI
, ,. . ~ ';,: ,. ,, ._ ::i:: I'
ClHCfll
Se l tc l ,roctdu,... Tr... ,
~""
Da
St\lh
r~h lonT!"eedl o!r..., l-iP
h:i!l l t
oe
~~
.,
Rgure 4-5. Styfe Sheet Screen
You can change any of the diagram options by editing the

current Style Sheet. Figure 4-6 explains (in a form of an
allCLEAR tree diagram) all the different diagram parameters
contained in a Style Sheet. Refer to Chap1er 8 for more infonnat ion on working with allCLEAR St vle Sheets.
allCLEAR Menus 4-11
4-10 allCLEAR Basics
1
1
00 00
e~
e~
~i
allCLEAR Menus
~i
~t
The allCLEAR menu control system is similar to the type

employed in a number of popular microcomputer packages.
The menu system consists of two major parts:
~J
~!
...
The Main Menu and the associated pull-down menus, displayed at the top of the screen.
...
The Sryle Sheet, displayed in the center of the screen.

In addition to the above, a typical allCLEAR screen (Figure
4-7) also includes:
.~,
~!~
...
The curren! directory and selected file window, displayed at

the bottom of the screen, above the help line.
...
The help line, displayed at the bottom of the screen .
...
The most importan! keys and their descriptions, displayed to

the right of the Style Sheet.
~-.
Uiy
l.'13i![(
. ffiJ i
mW
c!a
. ~:
;1!
"'1.!.i
~i
"'~
'
.!
g~;
~_q
"f
/@
~i'"
~t.~!.~
E
/
------
'
:;:
~~~
l~~~
ij
. o'
~~-
d..1
~~
"'"acii
'""t
iA
tuct
Hsl-tlc.a
: urp
Sliu
:-11
,,..1 .. ts
s11aoo11.., '"
~i~
-llSSIGl'!l'IEKT01SHAl'ES
Sh.t......,t: l"l't:Ul"!I
"'i ...
1r
~-
OnIFOKTS
: IWh..,tle. 11 polnts
L.-b.ls
~~= Slu : hU..er'
,.,1..,
!ordl'N;
.... u.
:t.-.,._,
Rl51\l
: l.2SLN:Aal
: elllJ>R
Top
lotlo"
' 11.Soelncn
[nd
rtsu ,.,-lhlo,,.,.
~
~
;
,~..,.
: ...
Chelcn
Loe>p
Sl&rt
D\aph'I U1c 1U<Jr" on
~~~
: .. 1,11t,.,.
:o11-""
: M:.u,....
:~ftfl
1 J"llnls
Or\s.,tt1.., ,...-trlt
~u
~i:I=
tl .....-..
;u
Ioule
;Q
...!.'
In Se.....I J """'
Figure 4-7. A Typical al!CLE.:..R Screen
ciit~
~2
allCLEAR menus are organized around six basic operations:

1
L
e~~
1
'
:~:~;:.,_ ~
~ S'tnBOl.
...,,
ID
11.oh-t~ ...... ,..
-1
...
performing File operat1ons
...
generating diagrams to the screen in different Views
...
Printing the diagrams to the printer or file
...
working with the Style Sheet
...
Running externa! programs from allCLEAR including the

Setup program
Quiting allCLEAR.
1
1
Ci~ ..
Figure 4-6. Styie Sheet Options
4-12 allCLEAR Baslcs

allCLEAR Menus 4-13
These six basic operating procedures constitute the first level

of alJCLEAR menu structure, or the Main Menu. An
al!CLEAR tree diagram in Figure 4-8 illustrates the hierarchy of the al!CLEAR menu system and explains ali the Main
Menu and pull-down menu options.
To use all CLEAR menus:
1.
~~~
a~11
=~i_,..
Position the bar cursor over the option which you wish to actvate and press !..iEnterl to select it.
Use [] or EJ to move the cursor up or down, respectively,

within the same pull-down menu. You can also use
/Space Bar! instead of E].
4.
Press ~ to move up the leve! of the menu hierarchy, e.g. to

move up to the Main Menu from a pull-down menu.
5.
Press ~ to go back to the menus from editing the currem

Style Sheet or displaying the diagrams.
Table 4-f describes ali the keys for cursor movements in
al!CLEAR. Table 4-2 describes ali the "fast keys" which can
be used from anywhere in the al!CLEAR menus or diagram
views in order to bypass the menus.
~~ll.
Fo
~~s~
2~
2. Use EJ or EJ to display the next pull-down menu on the left

or right, respectively.
3.
~fu'
.~
An alternative way of selecting a menu option is to press the

Ietter key corresponding to the highlighted character (usually
first) of that option.
o~~
J..
,,;..
1
~il
<ll
f ! 1 ~ 1 H1 ~~
111 '
.!
B~i
~~l
"';,
1.~
.~
111;.~J
~ ~ ffi,f
~a.;:-=
.i~
t_=
.~
""i
1 w~l
H
~~~-
1-a.-j
~i~
a.;~
::i
z;.i
3-;g
<~!
~~~
E~!
~}:~~
:ti~
~~;
~!<
i;Jf5
~~ 1 !.1~g~
~ "I ~~&.;~'"'
r:i~
,(~~j
U~";~
Q.,i'i'u
;i~
:.!
~ ~
.2;.:
o.?j~
~i]
: .. ~
a..}:!
... ~-s
!i
.. ~
~:-~o
1f1
~u~
. !~
~h
1~!'.'~
>
~fti
[!:-
'
~!1
~1 ~
.~
a
r~
: ~i
6i
w~~
til~
Rgure 4-8. af/CLEAR Menu Structure
t;so
~{-i
l~ 11 ~-~h
~b
i:~
li:;!
]~
~li
~~
li
On-line Help and Error Messages 4-15
On-Line Help and Error Messages
The al!CLEAR procedure diagram in Figure 4-12 illustrates

the basic operating procedure you will need to follow in
order to use al!CLEAR. Refer to Chapter 5 through Chapter
9 for detailed information on all the different options available in a!ICLEAR.
a!lCLEAR includes a convenient help line that is keyed to

your current location in the system. This line is always displayed at the bottom of the screen and provides brief instructions on your current options. al!CLEAR also includes an online ful! screen help facility that fully explains the
information in the status line (Figure 4-10).
Ut.e ltle New Edrt QpUOtl

oltheFMmenutOCtl
lsicnpthle.
\p,~~1
\.::..1
1
Figure 4-10. The Hetp Display
The following keys are associated with the on-line hel

facility:
looll Tlt'Htdi;i.9tam10
1tsgenOllsl'l.lpt,
LOOO;i1.t!t'Mtd<a9ram
IUl:lly U 11 w~I ,iOpeU

~
..... .,.,,_
..
..
DaSC71bet:...d1a<;ram..,
!he aiJClEAA SCl"pl
lanoua~.
When!tl<td~g.'~ looks
ll"lflr~S~C:: S~~w
Figure 4-9. Basic Operating Procedure for a//CLEAR
l1shouto/\live 1S1yi.
S"-t wnod1 r11f11s

oes.ue<;J s.pech<::.a.11ons
~ - to see the current help display.
Any key - to retum to the point where you requested help .

The full help screen can be accessed ar any pcint during
allCLEAR operations. You shculd find that in most cases the
information contained in the help screen provides sufficient
reference so that you den 't need to consult the User's Guide.
We recommend that you frequcntly use the a!ICLEAR online help facility until you ccmpletely familiarize yourself
with all the oprions available.
lf an error condition is encountered. a!ICLEAR halts al!
processing and displavs a one-line e1Tor message (Figure
4-11 ).
allCLEAR Keys 4-17
allCLEAR Keys
Ths section describes the keys most cornmonly used in
allCLEAR.
CURSOR KEYS
Dlaplv lile.,..,....,. 11 U..e
SC1"ft'1I
111 Senil 1Mde
allCLEAR malees extensive use of the cursor control key pad

(located on the right-hand side of most PC keyboards). Each
cursor key has a particular function in allCLEAR as
describcd in Table 4-1.
Rgure 4-11. The Error Message
Table 4- J. The Cursor Keys

Key
Used During
Purpose
To obtaln an exptanatlon of the error message:
[]
menus and file selection displays
to scroll down
1. Get the error number and the reference to the User's Guide
frorn the error message on the screen.
2.
Look up the explanation of the error message in the User's

Guide (page number is provided in the error message).
3.
Press any key to retum to the menus.

Most error messages occur as a result of one of the following
categories of conditions:
[]
Main Menu
to select an entfy
Scroll view and

Print Preview
to slowly scroll down
Walk-Through view
to step one box down

(spacious walk)
All-Pages view
to point to the page below

the current page
to scroll up
Scroll view and

Print Preview
to slowly scroll up
1>
errors detected in the script file (see the separate Language

Reference for the list of these errors)
1>
no file selected for allCLEAR actions
1>
invalid path specified for directory, editor, publisher, or buffers
Walk-Through view
to step one box up

(spacious walk)
insufficient buffer space
All-Pages view
to point to the page above

the current page
to scroll to the left
Scroll view and

Print Preview
to slowly scroll to the left
Walk-Through view
to step one box to the left

(spacious walk)
All-Pages view
to point to the page to

the left of the current page
editing and entering strings
to move the cursor to the

left through the string
1>
Consult Chaprer 12 of this User's Guide for more inforrnation on possible errors and how to correct them.
El
4-l.8 allCLEAR Basics

allCLEAR Keys 4-l.9
Table 4-1. The Cursor Keys (cont'd)
Table 4-1. The Cursor Keys (cont'd)
Key
Used Durfng
Purpose
El
to scroll to the right
Scroll view and

Print Preview
to slowly scroll to the right
Walk-Through view
to step one box to the

right (spacious walk)
All-Pages view
to point to the page to

the right of the current
page

right through the string
to scroll to the first shown

selection
Scroll view and

Print Preview
to scroll one full screen up
Walk-Through view
to step one sc:reen up

(spacious walk)
All-Pages view
to point to the page above

the current page
to scroll to the last shown

selection
Scroll view and

Print Preview
to scroll one full screen

down
Walk-Through view
All-Pages view
IPageUpf
!Page Dc.vnl
Key
Used Durfng
Purpose
[]
to scroll to the first selection
Scroll view and

Print Preview
to scroll to show the first

step (for procedure) or the
main componen! (for tree
and decision tree)
Walk-Through view
to step to the first step

(for procedure) or the
main component (for tree
and decision tree)
All-Pages view
to point to the first

diagram page

first c:;;r;;~ter in the string
to scroll to the last selection
Scroll view and

Print Preview
to scroll to show the last

step (for procedure) or the
last component (fpr tree
and decision tree)
Walk-Through view
to step to the last step

(for procedure) or the last
component (for tree and
decision tree)
to step one screen down

(spacious walk)
All-Pages view
to point to the last

diagram pag,;
to point to the page below

the current page
to move the cursor to ~he

last character in the string
[]
-----
j:
f(,
allCLEAR Keys 4-21
FUNCTION KEYS
TYPEWRITER KEYS
allCLEAR also makes use of the function keys (located on

the left-hand side or along the top of most PC keyboards.
Each function key has a particular purpose in alJCLEAR as
described in Table 4-2.
al!CLEAR also makes use of severa! keys on the typewriter

portian of the keyboard (located in the center of most PC
keyboards). Each key has a particular function in al!CLEAR
as described in Table 4-3.
Table 4-2. The Function Keys
Table 4-3. The Typewriter Keys
Used Durlng
Purpose
Key
Used During
Purpose
any time during aliCLEAR operations
to access the on-line help

facility
l-'Enterj
to enter the editor

specified in Setup and
edit the selected scri pt file
menus, Style
Sheet, and file selection displays
to select, or actvate, the

menu/option/file highlighted by the cursor
Walk-Through view
any time during al~

CLEAR operations
to display the diagram of

the selected file in Scroll
view

the selected file in WalkThrough view
to step to the next

executed step for a procedure diagram orto
traverse the tree forward
far a tree diagram and
decision tree
to indicate the completion

of editing or entering
lm
a_ny time during aliCLEAR operations

the selected file in Al 1Pages view
Walk-Through view
ITl

the selected file in Print
Preview view
to step to the previous

logical step for a procedure diagram or to
traverse the tree backward for a tree diagram
and decision tree
to print the diagram of the

selrcted file to printer
to delete the previous

character
ITl
to save the current Style

Sheet, or attach it to the
selected file
menus, Style
Sheet, and file selection disptays
equivalent to
[ill
menus , Style
Sheet, Setup, and
diagram views
to run the Setup program

in order to reconfigure
aliCLEAR environment
viewing a diagram
to exit to the menus
printing a diagram
to interrupt printing and

exit to the menus
menus, Style
Sheet, Setup, and
diagram views
to access the menus or

Style Sheet
to abort editing or entering and restore the old

string
Key
m
im
rn
~
[fJ
[jQ]
'"~,
.~i
:,
1-Bad<spaceJ
[!QJ

allCLEAR Keys 4-23
4-22 allCLEAR Baslcs
Table 4-3. The Typewriter Keys (cont'd)
Table 4-3. The T ypewriter Keys (cont'd)
Key
Used Durlng
Purpose
Key
Used Durlng
Purpose
Style Sheet
to toggle ali the possible

choices for an option
jSpaceBarj
menus and Style

Sheet
equivalent to
El
Scroll view
to scroll the diagram one

screen-full to the right
file selection displays
equivalent to
EJ
pres sed with l~s-m l, to

scroll the diagram one
screen-full to the left
Walk-Through
view, branching
statements
to position t he cursor on
the choice desired for further walk
jJfil
Setup program
to save the changes to

configuration and exit
Setup (equivalent to selecting Save and Qult)
[ID@
}fil
All-Pages view
to undo horizontal squeeze
All-Pages view
to undo vertical squeeze
EJ
diagram views
to zoom in to the next

zoom level (in Sc;o!' nd
Walk-Through views) and
to zoom in on the current
page (in All-Pages 1iew)
diagram views
to zoom out to the next

zoom level (in Scroll and
Walk-Through views) and
to zoom out to see al 1
pages (in Al ~Pages view)
Walk-Through view
to step to the next screen

to the right
pres sed with l~SMtl, to
step to the next screen to
the left
All-Pages view
to point to (or show, if the

view is zoomed in) the
next page on the right of
the current page
pressed with l~Stii!tl, to
point to (or show, if the
view is zoomed in) the
next page to the left of
the current page
Print Preview
to preview the next page

to t he right of the curren!
page
pressed with l~SMtl, to
preview the next page to
the left of trie current page
l~Stii!tl
Hlgllllghted
letter
diagram views,
pressed with fjib"
acts as the opposite of
menus and Style

Sheet
to select an options
without pointing to it with
the cursor
file selection displays
to search for the first fil e

on the list beginning with
that letter
fjib"
---
All-Pages view
to change the box size
[]
Scroll and WalkThrough views
to change the character

size
l8J
All-Pages view
to squeeze the diagrz:m
[QJ
All-Pages view
to change orientation of
the page
horizontally
Table 4-3. The Typewriter Keys (cont'd)

Key
Used Durlng
Purpose
All-Pages view
to activate/deactivate
dlagram paglng
![]
All..Pages view
to change the sty!e of the

diagram
[QJ
Walk-Through view
to undo the previous step
IYJ
All.Pages view
to squeeze the diagram

vertically
linsen 1
to insert a blank character
l0eie1el
to delete a character
Chapter 5:
Managing allCLEAR Script Files
This chapter provides comprehensive
instructions on how to manage directories
and files with al!CLEAR. It also explains
how to use the allCLEAR script file
formatter.
....
5-2 Managng allCLEAR Scrlpt Fiies
The File Menu 5-3
Chapter Contents
The File Menu
The FILE Menu

Selecting a File
Changing Directory
Printing a Script File .
Forrnatting a Script File
Ali of the file management activities in allCLEAR are organized in the File menu (Figure 5-1 ).
5-3
5-4
5-6
-Ll
llf"'"
. 5-7
. 5-8
5-10
5-12
st!lll stw.t: MfiU.T
Dt ... cUrt
""
"-Lllt.
...
~=-,.-,.-,-.,-.
~h
: Mol.....tlca
,,.l~ls
- . -..--"+-,
... ....
-,-...~~
r.,. .. s1a:
~.
SJze
: -11
Sl>Ml"S: .rr
nu.
.llSSlawcT
' SHIU'tS
su~:~u...,1.
ea..
1r
: __ ,.,,
:,u_,..
tMlcn
: tr_l,.
.i11..: 1.rt.,.....lll.,rwo
1.o.,.
st.M-t
1no1
:,.1,u,.....11.i .,._
SU
Jrtt.ar
: "-.iol
S't.&rl.O..
: ..
~~
1,1r.t,..,.
~::
' - - - - Mll511U - - i.tt

: l.ZSlN:ll. .
ll9lll
: l.ZS lncMs
..u . ..
:1.ZS1nc....,
: l.ZS l.,.,_Jwa
t.,
m
.....
m
""
IJII
St~I
,;......
ICn
r..,sl
; g1
.!.
S.l..:t.scrl,ttllotrllCU:Alacll..S
Figure 5-1. The FILE Menu
,..
Select - enables you to select a script file from a listing of

the working directory.
,..
Directory - enables you to specify the new file directory for

allCLEAR file operations.
,..
Edit - enables you to enter the text editor in order to edit or

look at the currently selected script file. The same can be accomplished by pre~;ing ~ (or file edit) from any point in
allCLEAR operations.
...
New Edit - enables you to create a new script file and enter
the text editor to edit it.
...
Print - enables you to print the currently selected script file

to the printer with proper indentation, logic lines, and other
formatting options.
...
Format - enables you to properly indent the currently

selected script file with the allCLEAR forrnatter.
;'C.:
'-----""''''\-~>";.-.
~--.:
-'' ,_,_,,. . __ ... ,.-w.-_, .. .,.-.;...-~--.-----.....:,'-'-.,,......,...~J,..,...:;...-.:,.~o.---.-.:..;.--->----~~~.... .........._., __ ,__,.,,..._. ... ,.. ______ _._,. _
_.,_~----"""'
--~-------
Selectlnt a Fiie 5-6

5-4 Managlng allCLEAR Scrtpt Flles
2. Position the cursor over the desired file and press [.-EnterJ to
Selecting a File
select it.
allCLEAR loads the file into the memory and displays its
name on the bottom of the screen, above the help line.
Selecting a script file is always the first step in any

allCLEAR operation.
To select a file::
worl<.ing directory setting. The worl<.ing directory is specified in

Setup (of the Run menu).
1. Position the cursor on the Seled option of the FILE menu and
press +J Enterl.
When a script file is selected, allCLEAR has to know its format. allCLEAR specifically supports the following file for-
allCLEAR displays the alphabetized list of files in the working directory and positions the bar cursor on the first file on
the list (Figure 5-2).
mats:
ttvl sa..t: JCFMLT
:.01..:t. SCl"tpt. rlh
r-
llCUM act.te- (...., U.. 0Net..l"'JI llrtl"f
Rgure 5-2. Rle Selection Screen
As you can see. a!ICLEAR also displays subdirectories as

entries in L'le file selection screen. You can use this feature
to go up or down the directory tree.
allCLEAR offers you the following two options for moving
the cursor in the file selection screen:
,.
Use ~. !Page Down l, [Homej, ~. EJ, EJ, EJ. and [] to

scroll the list of files in a fashion familiar to you.
If you know the first character of the filename you are looking for, simply type that letter and allCLEAR will move the
cursor to the first file on the list which begins with that character.
IMPORTANT: lf you don't see your file on the list, check the
f.~~
'':~;.
,.
ASCil
,.
Lotus WKS/WKl/WRX
,.
MicroSoft Word
,.
WordPerfect
Any other non-ASCil format is also supported under the
Other and Auto Detect settings. The script file format is
specified in Setup. You must make sure that the default format is correct far the selected file.
Managtng allCLEAR Script Ales
Editlng a Script Ale 5-7
Changing Directory

Editing the file is an option you will use a lot during your
allCLEAR sessions. It allows you to enter the Text Editor
and modify the curren! script file without exiting from
allCLEAR. You should also use this option when you just
need to browse the file to make sure it is the file you want.
allCLEAR works with any file directory accessible to your

PC.
To change the working directory:

1.
Position the cursor on the Directory option in the File menu

and press !...iEnterl.
You can use any Text Editor of your choice, as long as its
directory and prograrn narne are correctly specifiecl in Setup.
To make sure the Text Editor is always invoked with the currently selected script file, its specification in Setup should include the "*" character following the editor name. For example, you should enter:
a!ICLEAR moves the cursor to the last character of the curren! directory string displayed on the bottom of the screen,
above the help line.
2.
Enter the designation of the new directory and files-to-list setting using standard DOS forrnat. For example, type:
C: \WP\WP
C:\ALLCLEAR\DATA\*.ACL ~EnterJ
You can use
EJ. EJ. lDeieteJ, llnsert 1.1~--8ackspace--~!. [Ho<rel, and
!] to edit the current string. If you change your mind, you
can press ~ to retum to the previous setting.
The working directory setting for file operations during any

alICLEAR session is deterrnined by the default directory setting specified in Setup. Refer to Chapter 9 for detailed instructions on how to run Setup to reconfigure the al!CLEAR
environment.
You can overwrite the default directory setting when you invoke alICLEAR by typing the desired directory and files-tolist string after the word "A". For example, to work with ali
the files with extension .ACL in the C:\ALLCLEAR\DATA
directory, at the C:\ALLCLEAR prompt, type:
A C: \ALLCLEAE\DATA \ *. ACL tJEnterJ
Refer to Chapter 2 for inforrnation on ali the possible

methods of invoking al!CLEAR.
in Setup in order to edit the curren! script file with Word

Perfect.
a- IMPORTANT: For those editors which do not take the file

name from the command line, you will need to type in the file
name when the editor is invoked.
allCLEAR offers you two ways of getting to the Text Editor
in order to edit the file:
...
While in the File menu, position the cursor on the Edit option and press [...iEnterl.
...
From any point in al!CLEAR menus or diagram display,

press ~
You should always remember that ~ is the Edit File key
in al!CLEAR. It is particularly useful when you want .to
make changes to the file while in diagram display. Then,
when you exit the Text Editor, the diagram is rebuilt to immediately reflect the changes.
a- IMPORTANT: When allCLEAR processes the script file,

whether fer diagram generation or formatting, it first converts
it to ASCII format. Thus, ali the Word Processor control sequences, such as under\ine or bold text, will be lost. Always
remember NOT TO spend time formatting the text with your
Word Processor while editing an allCLEAR script file.
5-8 Managlng allCLEAR Scrfpt Files

Creating a Scr.ipt File 5-9

~
't11l ~t : PD'AUl.T
=======---r=:-- ona....,., - - - m
t.""
i....uc.,.
You can create a new file without exiting from al!CLEAR.

You should use this option when you want to describe a new
procedure, structure, or decision tree in the script language
for the purposes of generating an allCLEAR diagram.
st.., l
Tl"99
: -u
= -
: .u-""'
C:\ALLCLEAR \ DATA \ NEWFILE.ACL ~Ente)
allCLEAR then invokes the Text Editor with the new file's
name. You can now start writing the diagram description.
Refer to the separate Language Reference for instructions on
how to use the script language. When vo: come back from
the Text Editor, having saved the new file, the new file is assigned the DEFAULT Style Sheet. However, befare you g0
any funher, allCLEAR asks you to specify one style sheet
parameter the type for the diagram described in e new
file (Figure 5-3).
l!ii"
IMPORTANT: When you create a new script file, you should always keep in mind which diagram type it describes.
Orlnl atln:
i...,...
t.rto-H
: .i 11,..
: l d't. ,.....11.1.,.._
: ,.1,u,.....11. 1.....-
: ._I
MllGllC - - -
11,lol
ro,
a.u....
e
Clll
:!illl ....
1o.....-. : ...
~ftfO..
.zs 1-i.: e . 251 ........
"'"mn
1
T-ssl
: zs tnca.s
: 1.ZS ll'Clloeil
S.I Ml ,.,._....., T,..., ,,. O.Ohl" T,._ .. t . _
allCLEAR moves the cursor to the window on the bottom of

the screen, above the help line, and displays the current directory and files-to-list string.
to create a new file in the C:\ALLCLEAR\DATA directory.

You can use the standard cursor and edit keys to manipulate
the existing string. If you change your mind, press ~ to
cancel new edit and return to the File menu.
a.1i...,
n.art.
. . l ftl.&
,....,. s1. . ; lrtt...r

Sl4'n
RWIS
at
tt..t.-.t: ......... , .
Position the cursor on the New Edit option of the File menu
and press [?Entefj to select it.
Enter the name of the new file next to the directory string and
press [?EntefJ. For exarnpk, type:
l ..t
11
~':S1~
e.u.
2.
: iw 1--i 1 ~ 12
: iw1...u ea"'111ts
P'flfauwout--
o.ci.1 ...
r ..t
T-C.
SI
1r
1.
THh
t.,,,..
Rgure 5-3. Se/ecting Diagram Type for the New Rle
fil~
7.,.:
3. Position the cursor on the desired diagrarn type and press

l--'EnterJ to seJec; ;t.
irJ
,.
You can now display the diagram and see if the1e are other
diagram attributes !hat you wish to change in the Style Sheet
for the new file. Even if you haven ' t changed anything but
the diagram type, the next step is to assign the Style Sheet to
the new file.
~~
y;
,,
4. Press ~ to move up to the menus.

5.
Press
EJ twice to display the Style menu.
Once in the Style menu, position the cursor on the Attach to

File option and press l--'E"'"'J w select it. The Style Sheet,
caJ!ed NEWFILE.STY in our exarnple, is now assigned to
the new file. The style sheet file has the same name as the
new file and an .STY extension. An alternative method of attaching the Style Sheet to a new file is to press !] when
ready to save the Style Sheet.
Prlntlng a Scrlpt File 5-11
5-10 Managing allCLEAR Scrlpt Files
The allCLEAR script file print utility allows you to specify

the following:
Printing a Script File

You can print a script file to the printer by using the Print
option of the File menu. When the file is printed using this
option, it is also properly indented and formatted using the
built-in allCLEAR printing utility. This utility should make
your work with the script language easier, as it is designed to
provide various visual aids for enhancing the language structures (Figure 5-4).
"'
number of characters for indentation
,.
number of lines per page
,.
number of characters per line
"'
logical block lines' type
,.
line numbering
The above options are specified in Setup menu as a part of
the global allCLEAR configuration. Refer to Chapter 9 for
detailed instructions on how to redefine the script file print
settings.
lMPUT SCJlllT FILl

Does IJOl'r c&r M.ue an air conditJaner7
!Yes) Tlll'll the ir conditioncr off.
?end
To pnt the selectecl script file:
Take the '-'Chicle to & S&fe place and. park.

""""ccl<
Let thc envine run lit the ldle spced Cor a tev i1'U.tcs.
Is thc tc.per11.t.un: clown to aca:pt.ble lcuel'?
1.
CYes) 'fou cu now nart drlvfngf

U\ll tun the engine otr.
Does the w.alcJ' JIUlllP bclt loolt OX7
Position the cursor on the Print option of the File menu and
press l-'Enterl to select it.
Make sure your printer is properly connected and on-line
before you activate this option. There will be no further
prompts; allCLEAR starts printing the file right away.
Otol >dc&ler
CYesl Check the coolant leuel.
Is lt bc:IOlll the '1.0ll' line7
Ucs) Ad4. coolll't to the l"CSeruolr and re.dlator.
>chetl
Utol >el.caler
7encl 7end 7en4
-dealer
Brlng !JOUl' car t.o the d.ealer.
l(i"
IMPORTANT: lf you wish to print the file as is (not formatted), you should use the DOS PRINT command. You can
jump to DOS by using the DOS option of the Run menu without loosing any of the current selections.
PRil'm:n SCJtlPT FIU:
The Characters per line and Lines per page settings of the
print utility allow you to configure it for compressed pri!lting. You have to make sure, however, that your printer has
the appropriate font/mode selection.
Does ~ c.tr h.tue an 4ir cond ltloner?

Uesl TllMI thc ak conditloncr otr.
1'end
Ta.ke the l<ehlcle to a sale place and park.
""""ccl<
Let the englne "'" .t t.he ldlc speed for- f't:w 11inute.
Is the tc.perature dCMI to 4C:Ceptablc leuel?
Uesl You ca.11 1Dll start driulnq!
(rtc:J)
TW"n thc engine off.
Does the vatu PJAP belt look OK'!
(l\:t)
>dealer
n'esl Oecl: the coolant leuel.
Li lt bcla.t thc '"UJ..r" llnc1
[
('tes)
to the l"eServotr &nd radlo.tor.
[
Ub> >dcaler
~,:lant
7end
'?end
7end
-dealer
Brlng your car to the dealer.
Rgure 5-4. Script Rle Printed with Print Utility
:~~
';~~
~~:
Formattlng a Scrlpt File 5-13
5-12 Managlng allCLEAR Script Files
Formatting a Script File
LIU"ORttATttD FIU
Does your car hauc an ir conditloner7

(Yes) Turn t.hc a.lr c:onditioner ott.
a!ICLEAR also provides an option for formatting the script

files. When you choose to format a script file, it is modified
as follows (Figure 5-5):
'"
Beginnings and ends of logical structures are properly

aligned.
'"
Ali logical blocks are properly indented to reflect the nesting

levels.
To format the selected file:
1.
If the input script file has extcnsion .ACL, al!CLEAR formats it and saves the unformatted version in a backup file
(with extension .BAK). Thus, if you format a file called
FILENAME.ACL, the old version of the file will be saved in
the working directory under the name FILENAl'vfE.BAK. If
the input script file has extension other than .ACL,
al!CLEAR <loes not modify it, but rather saves the formatted
version in a file with the same name and .ACL extension.
Thus, if you format a file called FILENAME.DOC, the formatted version of the file will be saved in the working directory under the name FILENAl'vfE.ACL.
"" IMPORTANT: Once again , we rem ind you that if the script file
is in non-ASC!i lormat, allCLEAR will convert it to ASCII while

formatting. Your Word Processor should be able to read it
an
T&Ju: t.hc \llChiclc to a sd'e place aJMI park.

-check
Let. ti.: ~ine run .t t.hc ldlc speed Cor a fet.1 1111inu.tes .
Is t.he U.pcrature d1>11m to accept.&blc leuel'T
CYes> You can now st&rt driuinqt
Uta) Turn the englne olf,
Does the -ter P'd'P 'Delt. look OIC'1'
Cl1DJ >dealcr
<Ves) Check t.hc coolant lcuel.
Is lt be low the '1..DW .. l lne7

CYesl Add coolant to thc rcscruoir and radiator.
)chccl
Uto} >dcalcr
'?cnd 7end 7cnd
-ticaler
Brinq JP-ll'
Position the cursor on the Format option of the File menu and
press .., Entocl to select it.
back as an ASCII file, however,
7end
the Y.lord Processvr control
C4lJ"
to the d.ealer.
FDHnATn:D FIL!
lloc:s your car hauc an a ir cond t t 1onc:r7
(Yes) Tu.rn the &ir condltioner off,
7end
T&kc the .1eh:de to a sale place and. pa.rk .
-d>eck
Let the engtne run o.t the idh: speed for & rew 111tnutes .
Is tb: t.Clllpcrature down t.o cccptahle le...el7
<Yesl 'lou ca.n ncw st&rt driuingt
Crtol Turn the englne off.
Does the -.t.er pwrp helt look OX'7
Crtol
>dea.ler
('tes) Check t.he coolant leuel.

ls it below t.he -WW .. 11nc:7
CYes) Add. cnolant to the: rescruolr e.nd r&dlator.
)chccl
Cl'lo > >de.a l er
7end
7cnd
?end.
-d=ler
Bring !PJ.l'
C4l'
to
HM::
,;k>,.oler.
Figure 5-5. Unformatted and !'"ormatted Script R!e
sequences will be lost.
If a!ICLEAR finds an error in the script file, when it formats

the file, it inserts the o::rror message into the body of the text
file, in a!ICLEAR comments (Figure 5-6). This feature
provides you with a powerful aid in finding mistakes in the
script files. Thus, when you encounter the "Errors De1ected
During Processing" error message, the first thing you should
do is format the script file . When you edit the file (the formatted version), you can see exactly what the error was and
where it occurred.
The Vlew Menu 6-3
6-2 Viewlng allCLEAR Diagrams
The View Menu
Chapter Contents
The View Menu . . . . . . . . . . . . . . . . .
. . . . . .
Scrolling the Diagrams (Scroll View)
Walking Through the Diagrams (Walk-Through View)
Preparing the Diagrams for Print (All-Pages View)
Page Previewing (Print Preview View)
Ali of the diagram display options (four different views) in

allCLEAR are organized in the View menu (Figure 6-1 ).
. 6-3
. 6-4
6-8
1m
"'- W"**J'"-'2'
,.
liallt.JN-911
11111-r..f"rlM " ' - 1 -
- ,_,,
....,
,_
Fe11t
: i.1-u.,.
Slu
: ...u-
u.MI,.-
: ""
,,,.. """'
"n.
: lllh,.tl.,. U ,.111ta
"
: . i t -....
c...
: """-"
...
"""
11,lll
: .111..-
''
JoU.-
'""'
tra~I
: 1.n ,.....11.1....-
: ..i.,n,..-
gjj
=tt
:.rr
S~~:.-.ct.&.,.I
""loes:
""
11111
,,.111u
""'"''
; l.ZS 1.... u.
:l.ZSlnc:Us
;l.ZStow:i.n
: 1.25 ln<:Ms
: ,.1,11t ,....11.1.,.--
IZ!I
""""""'
: IWLw-tioa
1,..1nta
-lltSSl~OTSWll'IS
.....
....
E!!fH
6-12
6-19
Sl'!lll
"'"-
ICll
r.,,1.
~a
Otqola'f lM ,,.,...., "" Ule _.._.. 111 Ser911 ......
Rgure 6-1. The View Menu

1<>
1<>
Scroll, [ill - spreads the diagram on the screen like a cloth

on a table and lets you move the screen to view different
parts of the drawing, or scroll the diagram.
Walk-Through, ~ - lets you step through the diagram displayed on the screen by allowing you to manipulate the tracing cursor which moves from one box to another in response
to your input.
,..
All-Pages, ~ - enables you to prepare the diagram for print

by showing the diagram layout for ali the pages.
,..
Print Preview, @ - shows the diagram page-by-page exactly as it will appear on the printer.
a- IMPORTANT: Each view has a corresponding function key,

[TI through ffi, which can be used from any point in the allCLEAR menu system instead of selecting a menu option.
When you press one of the four function keys. allCLEAR
starts generating the diagram and displays it in the view of

your choice.
while
You should always remember that you can press
viewing a diagram, and allCLEAR will display a ful! help
screen with the available view options. Any of those options
screen.
can be executed directly from the help or
6-4 Vlewlrig allCLEAR Diagrams
Scrolllng the Dlagram 6-5
Scrolling the Diagram

(Scroll View)
Zoom Leve/ 1:1
Zoom Leve/ 1:2
The Scroll View is intended for a fast diagrarn overview so

that you can quickly get familiar with the general shape of
the diagram. You can zoom in to focus on details or zoom
out to get an overview of the complete drawing. This view is
not affected by any of the page layout senings, such as
paging, page orientation, borders, etc.
To view the diairam in Scroll view:

1. Select the Scroll option of the View menu or press
When the diagrarn is displayed on the screen, it is scaled

depending on the selected default Zoom Leve/. allCLEAR offers five different zoom levels; the default is specified in
Setup of the Run menu. Figure 6-2 ~~ows a sarnple tree
diagram displayed in the Scroll view with five different
zoom levels. The sarne default wom leve! applies when the
diagrarn is displayed in the Walk-TI1rcugh view.
Q"
,,
Zoom Leve/ 1:3
Zoom Leve/ 1:4
IMPORTANT: lf you feel that the curren! default zoom level is

not what you want, press [ill to enter Setup and select a different setting.
You can also zoom in or out while in the Scroll view, regardless of what the default zoom leve! is.
EJ to zoom in (bring the diagrarn closer tp) or

zoom out.
2. Press
to
EJ or O work as a toggle in this case; they consecutively

toggle the five different zoom levels. Thus, if the diagram is
currently displayed with zoom level 1:3, pressing EJ once
will change the zoom leve! to 1 :2; pressing O will change
the zoom leve] to 1 :4, and so on (see Figure 6-2 for examples of different zoom levels ).
Zoom Leve/ 1:5
pn
When the diagrarn is bigger than the screen, you may find
that you want to view the parts that are beyond the screen, or
scroll the diagrarn.
Rgure 6-2. Zoom Levels for Sera// and Walk-Through Views
6-6 Vlewlng allCLEAR Dlagrams
3.
Press [], [], EJ, or EJ to slowly scroll the screen upward,

downward, to the left, orto the right, respectively.
4.
Press /~Shittl key and then, without releasing it, [], [], EJ. or
EJ to fast scrol! the screen upward, downward, to the left, or
to the right, respectively.
5.
Press /Tab~l to scroll the diagrarn one screen to the right Press
l~Shittl and then, without releasing it, /Tab~l to scroll the
diagrarn one screen to the left.
Scrolllng the Dlagram 6-7
- 1 - - - ..... 11
tDltt.J-uvw..
- t...t - - .... 11
~ -
'"""ll"C"'"'l
- -.11
u.....J-'f.1""1
- -11
nul'\:SliiltU-<T.W - -.11
u~
--
--
a.. t.,.,..u... r .,.__
6. Press ~ or /PageDowni to scroll the diagrarn one screen upward or downward, respectively.
7.
Press !Home! or ~to scrol! the diagrarn to the very top or bottom box, respectively.
You can change !he following two diagrarn attributes direct!y
from the Scrol! view. The same c-.an be accomplished by exiting diagrarn display, modifying the Style Sheet, and generating the diagrarn again.
8.
Press ~ to change the diagrarn style.
~ works as a toggle in this case; it consecutively toggles

the four different diagrarn styles. Thus, if !he diagrarn currently has style three, pressing ~ once will change the style
to four, pressing ~ twice will change the style to one, and
so on.
9.
Press 1] to change the character size of the text inside the

diagrarn boxes.
1] toggles the two available choices (smal! and large) for

the screen fonts. The bigger font is intended for better
readability of the text.
To see which keys are available while viewing diagrarns in
Scroll view, you can press ~to see a screen which summarizes al! the scroll and fast key options (Figure 6-3).
10. Press ~ or ~ to clear the diagram off the screen and

come back to the menu.
This erases the diagrarn from the screen, so don' t press this
key until you are done with viewing the diagram.
Figure 6-3. Keys Available in Scroll Vew
6-8 Vlewlng allCLEAR Diagrama
Walklng Tbrough the Dlagram 6-9
You can use the cursor control keys to walk-through the

diagram spaciously. This would be the same as scrolling it,
except for the fact the the tracing cursor moves from one box
to another as you scroll.

{Walk-Through View)
6.
The Walk-Through View is intended for assisting you to

analyze and study the logical structures imbedded in the
diagram description (or the script file). It allows you to step
through the diagram displayed on the screen by manipulating
the tracing cursor which jumps from one box to another
depending on your input. A special text line at the very top
of the screen displays the contents of the current box
(defined by the position of the cursor) for your review. Just
like the Scroll view, this view is not affected by any of the
page layout settings, such as paging, page orientation, oorders, etc.
If you wish to trace the logic of the diagram step-by-step,

you can use the logical step keys. These do not respect spacious movement rules and remain true only to logic flow.
7. Press l+>Enterl or 1-Backspa:?el to step to the next or previous logical step in a procedure diagram. Press !+'Enterl or 1-Backspa::el
to traverse the tree forward or backward in a structure
diagram or the decision tree.
In a procedure diagram or a decision tree, when y.ou reach a
statement of branching, such as If, Loop, or Case, a!JCLEAR
expects you to specify on which branch you wish to continue
walking through. In these cases, in addition to the usual line
of text at the top of the screen, you can see a second line
which lists the available choices (drawn from the text of the
script file). The bar cursor is positioned on the first choice
(Figure 6-4 ).
""" ,. t1., ...
.... , -1-. .. :
To view the diagram in WalkThrough view: ~.' "'"

1.
Press ~ or IPageDownl to step to the next screen up or

down, respectively.
Select the Walk-Through option of the View menu or press
~J
When the diagram is displayed on the screen, it is scaled
depending on the selected default Zoom Leve!. Refer to the
previous section for description of different zoom leve!s and
instructions on how to change it.
p ., . . . . . . . .
~Til,..
,--~~~~~~~. 1
At first, the cursor is positioned on the box located in the center of the screen. You can press IHomel to move to very first
box, Le. the root of the strucrure or the start of the procedure.
Pay attention to the line at the very top of the screen which
displays the contents of the box.
3.
Press [], EJ, 8. or EJ to step one box up, down, to the !eft.
orto the right, respectively.
4.
Press l"i'Shiftl and then, without releasing it, [], [], 8. or EJ

to step two boxes up, down, to the left, or to the right, respectively.
5.
Press ITab>:;l to step to the next screen to the right. Press l"l'Shiltl
and then, without releasing it, !Tab>:; l to step to the next
screen to the left.
~!..;1~;::~::'::
1
n
:J1
;:
~-
'i{
Rgure 6-4. Walking from a Branching Statement
,.
6-10 Vlewlng allCLEAR Diagrama
Walklng Through the Dlagram 6-11
You can press ~to position the bar cursor on the

choice you wish to trace and press [-'Enter[ to select it. The
tracing cursor then moves in the direction of your choice.
Thus, if "Self' choice is se!ected in the illustration above, the
cursor will step to the "Self' box.
8.
Press [Home[ or ~ to step to the root or the last component in

a tree diagram or the decision tree. Press [Home[ or ~ to
step to the beginning or the end box in a procedure diagram.
In sorne cases, you may wish to go back to the previous position, or undo the last step.
9.
Press [[] to go back to the previous position (or undo the last
step).
Similarly to the Scroll view, yo u can change the following
t'.rn diagram attributes directly from the Walk-Through view.
The same can be accomplished by exiting diagram display,

modifying the Style Sheet, and generating the diagram again.
10. Press fil] to change the diagram style (toggles the four available styles).
11. Press ~ to change the character size of the text inside the
diagram boxes.
You can also zoom in or out while in the Walk-Through
view, regardless ~f what the default zoom leve! is.
12. Press EJ to Z'Jom in (bring the diagram closer up) or
zoom out.
O to
To see which keys are available while viewing diagrams in

Walk-Through view, you can press ~to see a screen
which summarizes al! the cursor movement and other key options (Figure 6-5).
""'J.!!I !! 1!!!!1 ~..e1"'1a...I/!.

ru.
v1-
n..
u1-
~ rrw-
111-
111 ...
1111.
...
iiiilNM:"" i'.l'Yl
._.._..
-..t-tt-~
( ...... J4~
-~--- a..vt..t. ._ <tw ~ '1....->

'1....vbll MJC u .............. tl..,_I
- ~- 1.. 1091 R-.
UUJ-'tQltu-CT.W - 11~ C.._J.-tDoil
(C2l"lll'ICX INCll
UD
UloM l..t st.,
11ilflllOlllllOf'T10IC
Ul ft11l
tCl-~d-
Rgure 6-5. Keys Available in Walk-Through View
13. Press ~ or ~ to clear the diagram off the screen and

This erases the diagram from the screen, so don't press this
key until you are done with viewing the diagram.

{All-Pages View)
You can change severa! diagram and page layo ut attributes

directly from the All-Pages view. The same can be accomplished by exiting diagram display, modifyi ng the Style
Sheet, and generating the diagram again. Re fer to Chapter 8
for detailed description of the diagram and page layout attributes discussed below.
The AII-Pages View is intended for assisting you to prepare

the diagrarn for printing to assure the most efficient space
utilization. It allows you to preview the exact diagram
layout throughout alJ the pages. While you are in the AllPages view, you can change diagrarn and page layout
pararneters and see how they affect the shape of the drawing.
To view the diagranr in AllPages

1.
view~
2.
Press [] to change the diagram style (toggles the four available styles).
3.
Press [[] to change the box size (toggle the three available
sizes - sma//, medium, and large ).
4. Press 12:) to change the orientation of the page (from
Select the All-Pages option of the View menu or press ~
landscape to portrait and vice versa).
When the diagrarn is displayed on the screen, al!CLEAR lays

it out through al! the pages and scales the pages down as
mu ch as possible to fit more pages on one screen (Figure
6-6).
:;
r..:' .
o...,.anlatl.,I
e>..rt or
Sot"t-- c ....... y
S.
Press ~ to actvate or deactivate diagram paging.

As the diagrarn is regenerated with the new attribute, you
can immediately see the effect of the change on the d; ~gr~m
layout, on the number of pages in panicular. For exru:n:Jc
changing the style of a sample tree diagram whi ch fits on
one page can result in making the diagram spread over 2
pages (Figure 6-7).
1
Tl
Hlp
Rgure 6-6. All-Pages View
nmmm
Figure 6-7. Effect of Changing Style on Diagram Layout
~---.-,,.._.._
...... --
----
----~.
--- .
:-~
6-14 Vlewing allCLEAR Dlagrams
Preparlng the Dlagram for Print 6-15
When you first enter the All-Pages view, the first page of the
diagram is highlighted or is pointed to by the cursor.
6.
o .. ,.aniatlo .. I
Press EJ to zoom in on the page which is pointed to by the

cursor. To come back to ali pages, press O.
When you press EJ, al!CLEAR displays the selected page
and scales it down to fit on the screen (Figure 6-8). You can
then review the layout of each page in greater detail.
0.-..nltlnal
Ch&i>t er
Chr
or
Sart-...
e. ... .,.,.
I
@
Stt .. a ... Cnw
..................... ...----.--.--.-..
-~--
Agure 6-9. A/1-Pages View far a Dot-Matrix Printer
You can use the usual cursor control keys to poini to different pages in All-Pages view (naturally, if the view is
zoomed in on one page, cursor keys allow you to display
other pages).
Agure 6-8. Zooming ;n
011
One Page in All-Pages View
Far your conv;,nience, if yu have selected a dot-matrix

(rather than a laser) primer, the All-Pages view symbolicaiiy
illustrates that fact by showing the side perforation lines
(Figure 6-9).
7.
Press EJ, [], F], or EJ to point to (or display in zoomed in

mode) the next pe.ge up, down, right, or left, respectively.
8.
Press fPaeUp J, ~. [Tab=; I, or l ~Shift l - I Tab=; J keys to point

to (or display in zoomed in mode) the next page up, down,
right, or left, respective!y.
9.
Press !Homel or ~to point to (or display in zoomed in mode)

the first or last page.
As mentioned above, the All-Pages view is mostly intended
for choosing the settings which make the diagram smaller
and clearer. For those special cases when the drawing comes
just one box short of fitting on a page, al!CLEAR offers a
special option called SQUEEZE. Squeeze can be vertical or
horizontal.
You should exercise y.our judgment as to which squeeze option to use. The diagram in Figure 6-10, for exarnple, obviously needs a horizontal squeeze.
6-16 Vlewing allCLEAR Dlagrams
EfJ
:;
':'?
Figure 6-10.
Diagram Which Would Benefit from a Squeeze
10. Press 0 to activate the venical squeeze, or compress the

diagram in the venical direction. Press iEJ to activate the
horizontal squeeze or compress the diagram in the horizontal
direction.
alJCLEAR then tries to compress the drawing. You will find
that, in cenain cases, this option is very effective in cutting
down the number of pages. Figure 6-11 shows the same
diagramas the one in Figure 6-10 with horizontal squeeze.
~~====~~~~
Figure 6-11 . Effect of Squeeze on a Diagram
In other cases, however, squeezing can have no effect, or adverse effect such as overlap of boxes. You should then und_o
the sq ueeze.
11. Press !] and then, without releasing it, iEJ or

the horizontal or venical squeeze, respectively.
to undo
To see which keys are available while viewing diagrams in

All-Pages view, you can press
to see a screen which
sumrnarizes ali the scroll and fast key options (Figure 6-12).
_,
mmmmmm
,._
Scroll
Ul,...
U.llo.
T"""
All,_...,.
trlnt.
hT-
PrlnlAtldo
S:t .. l
l"Jll;! l'IOVD'!DllkEVS
-->11,...,.
CP~l.-Ct,o..J
llal>J/CS:~lrtJ-CTdol
- 1l11hvi...f"t - P!
lHoPWl"lCndl
-~-,..,_
-flr-sV\..u:trs
,______ """"' "'" -------<

[Hl/IVI
- s..,..oN'Zt <illa11r.,. HDdte,.h. \l.,,.-V..rtlell<t
llllll-CHJ/(Vl--'epr'"'lo... IVUs,.._.n
~:~
: ~!.!:.';:;. I ~~~ : ::~!..i.u ...
Figure 6-12. Keys Availab/e in All-Pages View
Page Prevlewlng 6-19
12. Press ~ or ~ to clear the diagrarn off the screen and

This erases the diagram from !he screen, so don 't press this
key umil you are done with viewing the diagrarn.
Page Previewing
(Print Preview View)
The Print Preview View shows you each page of the
diagram exactly as it will appear on the primer. The so
called What-You-See-Is-What-You-Get (or WYSIWYG) approach is implemented to assure that what you see on the
screen when you preview the diagram is exactly what you
are going to get when you print the diagram to primer or file.
a- IMPORTANT: The changes to dlagram attributes, which you

make while viewing the diagram in the All-Pages view, are reflected in the Style Sheet. Thus, when you come back to the
menus, you will see that the Style Sheet has been changed.
lf you want those changes to be permanent, press
to
save the new Style Sheet and attach it to the selected file.
ru
The squeeze setting, however, does not get saved as a part of

the Style Sheet. The next time you need to work with the
diagrarn, you will have to squeeze it again using the AllPages view prior to printing.
To view the diagram in Print Preview view:

1.
Select the Print Preview option of the View menu or press

~.
Unless you have come from the All-Pages view, aIJCLEAR
displays the first page of the diagram. In !he Print Preview
view, the wh0!e page does not fit on the screen, so you can
only see a portien of the page ata time Figure 6-13 .
IMPORTANT: lf you pressed ffi while in the All-Pages view,

allCLEAR gives you a page preview of the page to which the
cursor was pointing.
Organizatiu;v.! Gi 1art ol a Software Company
SCflWlfE Oerevt. CO.

Ptn10tm
"' . ..thu.1oinh,.
FINMCE & SLPPCm

, \i C..f'U !!Ot1 1101Hn;wn
lt'_Eflr l h lr"QSD'I
~COLNTINCI
MMO<Ell"1
'do.PrU1o.o!
Clwil(f!IBllCi:SUV
,lr0\1:RTISPJ
'""'
'e1c.PrtSI
1)1,,(IC
JtA.TlCNM..JiCC
..,, .,...,
BlllSnrmcn
~ l t!Kt!lii
EM'lO'lEEFElATICffl
m..EWAO:TIH3
.......
IN'TEmATI
Caira1u
Ptf'SC1r"nl"""1a';llr
~1Trttner
Rgure 6-13. Print Preview View
Olr1CD'
&n 111f ruoer
""""'
,_..,.
"''"-"
6-20 Vlewlng allCLEAR Diagrams
You may want to view the parts of the page that are beyond
the screen, or scroll the page.
2.
Press [], [], EJ, or EJ to slowly scroll the screen upward,

downward, to the left, orto the right, respectively.
3.
Press l~SMtl and then, without releasing it, the [], [], EJ, or
EJ to fast scroll the screen upward, downward, to the left, or
to the right, respectively,
You may also want to preview another page.
4.
Press ITab>:;I to preview the next page to the right from the current page. Press l~Shittl and then, without releasing it, ITab";;I
to preview the next page to the Ieft from the current page.
5.
Press ~ or IPage Downl to preview the next page up or

down, respectively, from the curren! page.
6.
Press !Horre! or ~ to preview the first or the last page, respecti vely.
To see which keys are available while viewing diagrarns in
Print Preview view, you can press ~to see a screen which
summarizes ali the scroll and fast key options (Figure 6-14 ).
Rgure 6-14. Keys Available in Print Preview View
7. Press l1:22J or ~to clear the diagram off the screen and come
back to the menu.
This erases the diagram from the screen, so don't press this
key until you are done witb viewing the diagram.
Chapter 7:
Printing allCLEAR Diagrams
instructions on how to print allCLEAR
diagrams to printer or file.
The Print Menu 7-3
72 Prlntlng allCLEAR Dlagrams
Chapter Contents
The Print Menu
The Print Menu

Printer Output .
PRJNT File Output . . . . . .
All of the diagram print options (printer or file) in allCLEAR

are organized in the Print menu (F igure 7-1 ).
7-3
7-4
ru=am "'"' . ,.
7-9
7-11
'TW"f
: l'..........i
Sl !ll l
: t....
PIC
D"S
---n'9CI
r. ..t
: He ) ..,.tl o;a
t ..i.
: - h
S is
: - 11
si..41"1 : arr
, ,.1..u
P..,-l..,
..,.......
ir
c..-
:: ....
1...,.
-,,...
0...lcn:
: t.ra,..se l 4
Shrt
: t e rt. ,......11.i.,.....
: rl tU ,_..11e 1....-
l'l'"t11t t.M
~
,.,
,
.. ...
1 1s11t
111, . .
ta,.-- t.o
....
ID
' ,.hl
u- '
SIMa
St.arl O..
Sh t.....t: .....u..,I
lnd
: w.1 ...uu
l'JIC;I UIYOIJT
0.. l otM.t.I,.: 1 Msca,.
,.. , ...
"
: iw 1- """
u c.o 1Z,_l,,t.
IU
I
-ittS t~ OFSHRl'ts
i...,
_'1'
!.ti.ar
: ~ la
: ' ltH ,.,_
: ..,
""'""
1 .25 1..........
l .ZSLroclWS
1 . 25 1.........
1. 25 1 ~
~
Dl:I
St 'tlh
llMI
a....,.
llll"
t.n l
:;_;
t.M l""l "lv
Rgure 7-1. The Print Menu

o:w
IMPORTANT: The ~ function key can be used for printer output (instead of selecting the corresponding menu option) from
any point in the allCLEAR menu system or diagram views .
..
Printer, ~ - send the diagram to printer.
..
File - save the diagram characteristics in a binary file. This

file can be printed in the background using the DOS PRINT
command.
PCX - save the diagram characteristics in a PCX file ( or
files, for multiple page <liagrams). This file can be accessed
and edited with a desk-top publishing or paint system.
..
..
PI C - save the diagram characteristics in a PIC file (or files,

for multiple page diagrams). This file can be accessed and
edited with a desk-top publishing or graphics system.
..
EPS - save the diagram characteristics in an Encapsulated

PostScript file (or files , for multiple page diagrams). This
file can be accessed with a desk-top publishing system and
incorporated into a document.
The instructions below assume that you have already
selected a file for al!CLEAR actions. Refer to Chapter 5 for
information on how to select file .
..
~-
~;r.~-
.~
..)"":
7-4 Prlntlng allCLEAR Dlagrams
Printer Output 7-5
Printer Output
The Print Options menu allows you to select the following

print settings:
Start on Page - number of the diagram page from which
you want allCLEAR to start printing. allCLEAR assumes
the first page unless you tell it otherwise.
Printing the diagrarn to the primer is the final step in the

process of generating an allCLEAR diagram. You should
first view the diagrarn in All-Pages and Print Preview views
to make sure that the Style Sheet parameters are what you
want befare senc!ing the diagrarn to primer. Refer to Chapter 8 far instructions on how to view allCLEAR diagrarns.
"
"
End on Page - number of the diagrarn page after which you

want a!ICLEAR to stop printing. allCLEAR assumes the last
page unless you tell it otherwise.
To print the diagram to printer:
"
Pause between Pages - whether or not allCLEAR is to

pause between pages (for single sheet feeding, for example).
"
Print Empty Pages - whether or not allCLEAR is to print

the empty diagram pages. In certain cases, for complicated
procedure diagrarns in particular, the diagram layout can require severa! empty pages (Figure 7-3 ). If you are printing a
diagram for paste-up, you might want to print the empty
pages so that ali the segments are available.
"
Initialize the Printer - whether or not al!CLEAR is to reset

the primer befare starting to print the diagram.
"
Download Fonts - which font downloading procedure

al!CLEAR is to follow for the HP Laser printers only. This
option is set to auto as the defau!t. Advanced users should
refer to Chapter 11 for instructions on how to control the
allCLEAR font management procedures.
1. Select the Printer option of the Print menu or press ~

If a PostScript or Canon laser primer is selected in Setup,
for multi-page diagrarns, you have an option of scaling the
printout to fit all on one page. Thus, for PostScript and
Canon laser printers only, al!CLEAR prompts you wheth:=r
or not you want to scale to fit on one page. If you answer
positively, al!Cl..EAR starts printing right away and yot:
should skip the next steps in this printing procedure.
If you are printing to a primer other than PostScript or Canon
(or if you answer negatively to the fit on one page prompt),
l!Cl..EAR displays the Print Options menu in the center of
the screen Figure 7-2).
lllmmmm
oq
Tw-
' ""
T-t.
: ,..
s1-
: -
~~
,_ , ..,
n..11,,. : ~'
-lllS:SJ"'11i
o..t~: l'Pl'"- T...._~
......,.,......
r-...1.....tt ...1 .
t~'.~lm-QI(
=tra~t4'
0..1....s
r...,
=lit,..
: .. 1p.t ,_..11.1.,.._
Sl..erl;~
or
2. Use the cursor keys to position the cursor on the option w[,;_!:1
you want to change and press (+'Enterl to toggle the av~ i labc
choices. For the Start on Page :md End on Page of11ions,
enter the desired page number and then press ..., Enter] to accepl it.
3. When ali the print options are set according to what you want,
press ~ to begin printing.
,,..
.,,...
-
""
mi1-U1t ID-0..11
1""
ttiu..- tM -.-,..
r.....
P -., 111 tUOTn

p,.,, ...,,,.,..'fl_
11,u
r.,
a.tt.-
4. If you wish to cancel print, press ~ and al!CLEAR will

U. flryt ,...~ te be ,..lnled , dd'... lt La ,..11r1; 1.Jl
Figure 72. The Print Options Menu
,,... IMPORTANT: lf you are printing to a PostScript printer, you

chose to fit on one page, and paging is set to on in the Style
Sheet, a\ ICLEAR wi ll print ali the pages scaled and positioned

next to each other on one page (Figure 7-4).
'7 ...__.. _ ._ ;;..... -
.........._---
_._,K, .-~-~---
~- -
~,-
''' '
-7~
Printer Output 77
Printlng allCLEAR Dl&grams
-D~~~
-, L:!J-
CJCJ
s
- - -
Agure 7-4. Mult-Page Diagram on
c=:JEJ
-d:J
El
C
, J -1
a PostScript Printer
There is a number of other printing controls an advanced

user might want to exercise, such as using a different font or
changing the font downloading procedure. Further information on this subject can be found in Chaprer 11.
allCLEAR contains an intelligent built-in engine which treats
printouts somewhat differently depending on the kind of
printer that is selected. This engine adapts to your specific
printer. An allCLEAR procedure diagram in Figure 7-5 il
lustrates the altemative paths allCLEAR takes based on the
type of printer and page layout settings.
_Agure 7-3. Diagram with Empty Pages
7-8 Printlng allCLEAR Diagrams
PRINT File Output 79
PRINT File Output

In cenain situations (for instance, when you wish to print in
the background while the computer is doing other tasks) you
may want to output the diagram to a print file.
~~a:i
~~
il
"a
u:..- IMPORTANT: Prior to outputting to a PRINT file , you should al-
:u
ways make sure that the printer selection corresponds to the

printer which will be used for actual printing. The PRINT file
characteristics depend a great deal on the printer driver. lf
you decide to print the file to a different printer, you must go
to Setup, change the printer se lection, and reprint the diagram to file.
~f
;
>
f _ .":,
..
-.:-?::
To generate-the diagram to file and print it in the
li
1Ji.lc$ground::
*
-iJ;
.;%
1.
allCLEAR then takes you through exactly the same procedure of specifying the Print Options as if you were printing
directly to the printer (refer to the previous section).
~
"!L
]_
~1~
~~ c.
~o
2.
lHJ 1~~
~I
[,;~
(~
il8.
~.
~~
~~
~f
Once the diagram generation process is completed and the

file is saved to disk, you are ready to execute the DOS
PRINT command to print the diagram in the background.
il
~;;;
.;
'
C>"E_
~E
i~
~e
n
~;;
~
Figure 7-5. al/CLEAR Print Procedure
Confirm all the options and direct al!CLEAR to start printing

by pressing [D.
The output files will have the same name as that of the input
script file and extension .PRN. Far example, when you print
to File the diagran1 of a script file, called FILENAME.ACL,
the output file will Je called FILENA!vlE.PRN. This file
will be located in the File Buffer directory (which is set to
C:\ALLCLEAR\FILES as the default during the aliCLEAR
installation procedurc). Rcfer to Ch.:ip:cr 9 for instractior.s
on how to change the File output destination directory.
.... ~
5~
~,
Select the File option of the Print menu.
3.
4.
Exit to DOS either by quitting allCLEAR or by using the DOS

option of the Run menu.
At the DOS prompt , type:
P RINT C : \ ALLCLEAR \ FI LE S \F I LEN1'11 E . P RN l ~Enter l
(where C:\ALLCLEAR\FILES is the File Buffer directory

and F!LENAME.PRN is the narne of the created file).
710 Prlntlng allCLEAR Dlagrams

PCX, PIC, and EPS File Output 7-11
..,-
IMPORTANT: lf you want to be able to use the DOS option of

the Run menu for printing diagrams in the background, you
must install the DOS PRINT prior to entering allCLEAR. Refer
to the IBM Disk Operating System manual for information on
ali the different parameters which can be used with the
PRINT installation.
In cenain situations, for instance, when you wish to change

the allCLEAR diagram in any way or when you wish to incorporare a file with the allCLEAR diagram into a document,
you may want to output to a graphics file with format which
can be accessed by a desk-top publishing or paint system.
allCLEAR suppons three graphics file formats:
We recommend that you make the DOS PRINT installation a

pan of your AUTOEXEC.BAT file. For example, insen the
following line in the AUTOEXEC.BAT file:
PRI NT / D:LPTl
to send PRINT files to the LPT 1 port.
5.
If you used the DOS option of the Run menu, type:

E XI T
J-' EnterJ
to return to allCLEAR .
6.
After the printing is completed, you should go to the File Buff.

er directory and erase the .PRN files which are no longer
needed. The binary diagram files can take up large amounts
of disk space.
If you are printing a PRINT file to an HP LaserJet printer,

you have to download the allCLEAR fonts prior to printing.
And when you finish printing, you need to remove the
allCLEAR fonts from the primer memory. To perform these
operations, allCLEAR provides two prograrns, called
HPSEND and HPREMOVE respectively. Refer to Chapter
11 for detailed ilstructions on how to download and remove
HP LaserJet fonts.
..
PCX, or PC Publisher's Paintbrush image file format ,
..
PIC, or Lotus line art file formar , and
..
EPS, or Encapsulated PostScript file formal.
~1.
To save the diagram to a graphics file and work

,.:
with that file:
....
1.
Select the PCX, PIC, or EPS option of the Print menu.

allCLEAR then takes you through exactly the same procedure of specifying the Print Options as if you were printing
directly to the printer (refer to the appropriate section above) .
2.
Confirm all the options and direct allCLEAR to start printing,

by pressing l!:[l.
Unlike the PRINT file output, when you output to a PCX ,
PIC, or EPS file, allCLEAR creates as many files as there
are pages in the diagram (or as many pages you have chosen
to print). This determines the naming convention for PCX,
PIC, and EPS files:
..
allCLEAR outputs one graphics file per diagram page. For

example, if the diagram has a total of four pages, allCLEAR
outputs four different graphics files (if you select to print ali
pages in the Print ptions menu).
..
Each file has the same name as the input script file , except
for the last two characters; the last two characters are the two
digits of the page number. For example, assuming the input
script file is called FILENAME.ACL , its diagram has four
pages, and you choose PIC file output, the following four
files will be created: FILENAOl.PIC, FILENA02.PIC ,
FILENA03.PIC, and FILENA04.PIC.
7-12 Prlntlng allCLEAR Diagrams
PCX, PIC, and EPS File Output 713
PCX files are the biggest and the slowest of the three. They
also ha ve the worst quality, because the picture is built of
pixels or dots. Another disadvantage is that several publishing packages (WordPerfect 5.0 is one of them) are known to
have a problem with importing large PCX pictures.
"'"" IMPORTANT: Only the first 6 letters of a filename are used.
Two files with the same first 6 letters could overwrite each
other's output files.
~
For PCX file output, each file has extension .PCX; for PIC
file output, each file has extension .PIC; for EPS file output,
each file has extension .EPS.
The good thing about PCX format is that you can merge it
with scanned images. For example, you can produce an organization chart with pictures of real people inside the boxes.
If you haven 't changed the File Buffer directory since installing al!CLEAR, the output graphics files will be written to the
C:\ALLCLEAR\FILES, or the curren! File Buffer directory.
Refer to Chapter 9 for instructions on how to change the File
output destination directory.
When al!CLEAR generales diagrams to a PCX file, it takes

into account the type of printer and paper size that you have
selected. Thus, if the printer is HP LaserJet, the graphics
file will have 300 dpi resolution; if the printer is Epson dotmatrix, the graphics file will have 72 dpi reso!ution.
Once the diagram generation process is completed and the

files are saved to disk, you are ready to import them into the
desk-top publishing, paint, or other graphics system of your
choice.
3.
Make sure the patl1 ano program name for the system you wanr
to use is specified correctly in Setup (the Publisher option).
4.
Select the Publisher option of the Run menu.

al!CLEAR then invokes the Publisher and you can use it to
modify or simply import the generated PCX, PIC, or EPS
files. After you exit the Publisher, al!CLEAR retums you to
the menus.
Below are sorne notes on the differences between PCX, PIC,
and EPS files and thei" use.
PCX
The PCX file formar is supported by PC Publisher' s
Paintbrush, Ventura, Pagemaker, and almost any other desktop publishing or graphics package. PCX files can be used
ro:
~
erase any part of the diagram
add text to the diagram
add scanned pictures or clip art to the diagram
add new boxes or other graphical elements to the diagram
merge the diagram with a text document.
PIC
The PI C file format is supported by Freelance, Ventura, Harvard Graphics, l!lld almost any other desk-top publishing or
graphics package. PIC files can be used to:
~
remove any part of the diagram
add text to the diagram
change the font for any text in the diagram
move or change the symbols
move the lines around
add new boxes or any other graphical elements
merge the diagram with a text document
plot the diagram to the plotter.

Although PIC files are line art formal files and will produce
very good results, we recommend that you use the EPS format for merging text and graphics because of its outstanding
quality. PIC files are the best, however, for making changes
to the diagrams.
Prior to outputting to a PIC file, you should select the HP
LaserJet printer in Setup and review the diagram using the
Print Preview option. This will show you an EXACT
preview of the PIC graphics files, which are generated with
the 300 dpi resolution Uust like the resolution attained while
printing al!CLEAR diagrams on the HP LaserJet printer).
71.4 Printlng allCLEAR Diagrams
EPS
The EPS file format is supported by Ventura, Pagemaker,
Corell Draw and almost any other desk-top publishing package. EPS files can be used to:
,..
merge the diagram with the text to be printed as a part of the

document
EPS files are the smallest, the fastest, and the best quality of
the three. The only disadvantage is that you cannot modify
the diagram when it is saved to an EPS file .
EPS file output is the only file format which gives you the
option to fit on one page. If you choose to do that, only one
output file is created; this file has the same name as that of
the input script file (no page number digits) and extension
.EPS. The picture saved to this EPS file is either whole or
broken down to pages, depending on whether paging is off or
on.
The EPS file output works exactly the same way as printing
to a PostScript printer. Refer to the second section of this
chapter for more information on PostScript printer outriut.
Chapter 8:
Working with the Style Sheet
This chapter describes the Style Sheet
options and provides comprehensive
instructions on how to change and manage
Style Sheets with al/CLEAR.
8-2 Worklng wfth the Styfe Sheet
The Styfe Menu 83
Chapter Contents
The Style Menu
Style Sheet Options . . .
The Style Menu

Ali of the Style Sheet management activities in al!CLEAR
are organized in the Style menu (Figure 8 I ).
. 8-3
. 8-4
. 8-6
r"'""" "m"'!I':' !!i-tt
8-18
8-19
styl
T~
llUdt h
r;.l h tult
S-.Nllori'..,ll
~~--
11m
IAIWI.
.,,,_, - -
',.1"1.a
r11.
11
lca!S,.tnta
l ea t , .11,ts
'"l
; Hitl....-tloo
T..-1.
se-
: ..,..,
Ort. .. tU,.; ,.,.t,. l l

!'a,..- U : lett.&-r
' -
Sl<ln
: "-'>!
~,..,
st.a,.l O..
: rt11rit , .,.
11
.,
- R S S l "9C!'flf1'$1oW'ES
St..t-m.: r'9CUftt'I
lt
U-NI.
""''~~
....
.......
\.r-"
""'""
: e.zst..a.n
!:~i-
,,_laftfl
~o:tyl
Cj/
"'""'"
U111t
111-
12!1
""
Dl!I
: t . 2S l ndi.n
: t . se1..w:i..s
: 1.25 l ncMs
.. 1,11it,.....11.1 . . .-
Te.u!
~I
Lltt. -t11e=~ttt.!i!lSheat
Rgure 8-1. The Style Menu
..
Edit enables you to enter the Style Sheet currently on the

screen and change any of the Style Sheet parameters
(diagram attributes). The same can be accomplished by
pressing ~ from the allCLEAR menus.
..
Load - enables you to load an existing style sheet file.
..
Attach to File, ~ - enables you to save the current Style

Sheet in a separate style sheet ;;Je which becomes attached to
the selected script file.
..
Get Default - enables you to load the default Style Sheet

and overwrite the current one.
..
Save as Default - enables you to save the current Style

Sheet as the defaulr.
Modlfylng the Style Sheet 8-5
8-4 Wort<lng wlth the Style Sheet
When you press J...iEnterJ, al!CLEAR displays the available

choices in a window which pops up next to the selected
parameter (Figure 8-3).

Editing the Style Sheet is an option you will use a lot during
your allCLEAR sessions. It allows you to enter the Style
Sheet currently displayed on the screen and modify any of
the diagram parameters.
Tlll
191-U~
- - - + - -.....
_ ' ' - :.1~
r...t
~...._
r-
T...t.
To edit the c:urrent Style Sheet:
Sl
s:ha<I\..,:...
11,.1..t.
. ,.,ftt..11
,,.i.rtsOlrle..t..lls":,.r-trll
,..,.... s:i- ' i.ti..r
SI._
: .i-i.ts
~o..=.-ttliotpa$'1
-ltSSl~Ol'SHIU'IS
1.
St.~:......Ullfl
Position the cursor on the Edit option of the Style menu and
press J+'Enterl to select it. An altemative method is to simply
press Ql from any point in the allCLEAR menus or diagram
views.
DP"*"-
l ~DI~
liJfl_~ Y.tJ - -
____ ...,.._
f Sl;t"
.,
1
'"t.
te><t
SI-
; u.
iw1-u.,.
,,..1,.h
: .... ,.
: -11
: ""
1 SAMI""
1 - - ASSI'11'Q'.l'!T
ea-
i..-~"
CM1cni: l:-a,.._1.i
1-lf'
:e111..Si.a.-t.
: .....:U..,l
lnol
""'""""'
: HodwUca
8 ,..,,,,_.
Orlenhtl"' 1nt.tlt
si,,.11
st&rt O..
OF Sl1Al'ts
:<11.._..
~le
onDP"OffTS--: Hal\Mtlca ll ,.1nts
,.,....sin: lst.t..r
St.i....nt: reet.antl
1r
flt.b
'""
m
: rl5kl. l'flS
: ...,
: "'
~us---
Ld't
'e.zs
llsJril
Top
..U..-
: l.2Slnclln;
: l.Slltnc ...
:
1rocJo.a
.:zst...,._
: .. 1,i.t,.....11.1._
3.
'"'
lllllll
Sllfl
: ._.,.
l'*!l"!I
Jol"derl
CIOI
""'""
icn
1..,,1.
;:g
.....
r....
4lav- lY!"I
~'
''.~e
,.,,
IG"
;
2.
Use the cursor control keys to position the bar cursor on the
diagram attribute which you want to change and press J+'EnterJ.
Notice that you can also use the highlighted characters to
move faster from one section of the Style Sheet to another.
Thus, if you press (0 from the DIAGRAM section, the cursor
will move directly to the MARGINS section. Also notice that
you can move the cursor left and right as well as up and
down.
: tra,..-nl'
Rltt
:t.ZSlnclon
l.aoJI
=111,.n
su..t
:~..,-l
~i~
: 1.ZStnca..
:1.se1........,.
:r1111t,.....llI~
""'""
~11
Tenl
....
; : 1
Position the cursor on the desired choice and press [...iEnter[ to

select it.
An altemative method (to steps number 2 and 3) is to use

JTab~I which simply toggles all the available choices without
displaying the menu.
rf
Rgure 8-2. The Styfe Sheet
You should familiarize yourself with the Style Sheet layout.

The name of the style sheet file is di;.piayed at the head of
the Style Sheet. Each parameter shows the current selection
to the right.
:1.zs1 .... ,,...
c.i.otc.s
a!ICLEAR displays the new choice next to the diagram attribute you have changed. If you generate a diagram now (to
screen, primer, or file) it will reflect the new setting(s).
~-
't
S..\...:t "'"-d..,.., Tr.e. r I>-=tden
..,,
Ulll
Slyl
Rgure 8-3. Changing a Styfe Sheet Parameter
ID
Styl n...t.: COJDUl.STI
:.u-""
: ... ,...
Sd9C'ttll~SL.,1~st.1tlnrreet.U1t,.....,."l!I
a!JCLEAR then enters the current Style Sheet (Figure 8-2).
iw11
ir
c...
lnol
$t!fl n..t.: COUDD.SN
IMPORTAF;T: lf you wish the change to the Style Sheet to be

pennanent (cany over to the next sessions) you should al
ways remember to save the Style Sheet befare selecting another file. Refer to the section after next for instructions on
how to save Style Sheets.
8-6 Wortdng wlth the Style Sheet
Style Sheet Optlons 8-7
Style Sheet Options
For Procedure Diagrams,

the styles mostly dffer in the way the lines are drawn
from the branchng or logcal statements (If, Loop, and
Case). Figure 8-4 illustrates the same simple procedure
dagram in four dfferent styles.
This section describes ali the diagram parameters which you

can change using the Style Sheet. Those parameters are
categorized under ,the six categories explained below.
DIAGRAM
~
You can change two diagrarn parameters under this category: .

the diagrarn type
the diagrarn style
-""'
................................................................. -
~
~
--
The Diagram Type parameter is the most important attribute

of the diagrarn. It determines which analysis and plottng algorithms are employed when the diagram is generated.
When you create a script file, you should always decide
beforehand which diagrarn it describes. allCLEAR offers
three diagram types:
~
Procedure Diagram
Tree Diagrarn
Decision Tree
Refer to Chapter 4 for detailed explanation and illustration
of the three dagram types.
................................................................. -
The Diagram Style parameter deternnes the shape or

layout of the dagrarn. There are many dfferent ways a
graphics artst, for instance, can layout a drawing. Similarly,
allCLEAR offers four dfferent styles for each diagram type.
P!ease remember that, when you change the diagram style,
allCLEAR generates THE SAME diagram which simply
LOOKS dfferent.
~
-Tino
IMPORTANT: You should always try to choose the style which

makes the diagram clearer and smaller. The best way to experiment with styles is to use @] from the All-Pages view. As
the style changes, you can immediately see its effect on the
page layout.
Rgure 8-4. Procedure Diagram Styles
-~
\ ~ \-~l 1-~-1
.
8-8 Worklng wlth the Style Sheet
For Tree Diagrams,

the styles mostly differ in the way the clusters of the last
leve! components are posioned. Figure 8-5 illustrates
the same simple tree diagram with four different styles.
-;;r
l~I
k 11g
r-;::;;,1--1 1 -11- 1
~
l ~I
For Dedsion Trees,

the styles differ the same way they do for tree diagrams.
The branching statements, If in particular, are always
shown the sarne way on decision trees. Figure 8-6 illustrates the same simple decision tree with four different styles.
11-::::.-1@~rEJ~Eoo1 *
-~
__
~~
El El
... ,,,.,
~I
--
l= H ~
~==
~~=
- S!9
~-:..s- -=- I ~ ~
........
l~I
~[,:;--;-.:;. 1 1 =~~ ~1 1T,..1

-=--=- 1-..=.. 1
c-=;7
-~
0~EJI ~
8~ 1-~1
~I
-
~-=
==~
-1~
~--1
-=-
~
-
EJ
""""'
EJ
1--=--1 EJ l==-1
--
_,_
~-:e:-
cm
-=
..,..,,,_
t=:J
~~
--=---
--
1
~
1 -=-~
Rgure 8-5. Tree Diagram Styfes

Agure 8-6. Decision Tree Styles
--
l:=J
1---1 I
I a
-~- /-!_/
1-:--=-I
1-=:1 1E--'=-1 1 :J 1 E-=-1

e
El
Style Sh&et Optlons 8-11
SYMBOL
You can change four diagrarn parameters under this category:
"
the font for the text which is shown inside the boxes
"
the alignment for the text which is shown inside the boxes
"
the size of the boxes
"
the drop-shadow setting for the boxes
...................................................................
The Size parameter determines the universal size of the symbols. You can choose smal/, medium, or large symbol size.
Figure 8-11 illustrates the three available symbol sizes. Obviously, if the diagram is Iarge and you want to conserve the
space, you should select the smal/ symbol size.
The Font parameter determines the size of the characters

used to write the text inside the symbols on the diagram.
You can choose between 6 point, 8 point, 10 point, 12 point,
and 18 point sizes. You should use your judgment to make
this attribute work with the symbol size setting. For example, you may want to choose one of the bigger fonts if the
symbol size is set to /arge.
This box Ulustrates

an ~~~l~r.bol,
This box illustrates

an allCLEAR symbol,
MEDIUM SIZE.
The Text parameter determines the alignment of the text

printed inside the symbols. You can choose word wrap or
auto setting. Wben you select word wrap, allCLEAR fits as
many COMPLETE words as it can on each line of the text;
the remainder of the text is omitted with three dots indicating
that there is yet more text. When you select auto, for those
boxes which have a Iot of text to fit in, a!lCLEAR disregards
word wrap and puts as much text on each Iine as it can.
Figure 8-7 shows a sample allCLEAR box with word wrap
and without.
IMPORTANT: lf the script file contains long statements, you

should select auto word wrap setting for the text. This will
make sure that the maximum text is displayed inside each
box.

an allCLEAR symbol,
LARGE SIZE.
------
his box illustrates

an aJICLEAR symb
ol with "auto" text s.

an allCLEAR
symbol with "wrap"
Rgure 8-8. Avai/able Symbol Sizes

w
IMPORTANT: For 9 or 8-pin dot-matrix printers, we recommend that you use medium or farge box size with 6 point text
font. Otherwise you will find that you can 't fit enough text in-
side the boxes. For low resolution devices, it is impossible

to reproduce the bit-map of the small size letters.
Rgure 8- 7. Sample Symbof with and without Word Wrap
............................................. .. .................. The Shading parameter determines whether or not the

diagram symbols will have 3-dimensional drop shadows.
You can choose to activate or deactivate the symbol shading.
8-12 WOl'ldng wlth the Style Sheet

Style Sheet Options 8-13
Figure 8-9 illustrates an allCLEAR diagram symbol with and

without the shading.
an ;~~~s~~:;'gbol.
You can choose any of the following seven different box

shapes (Figure 8-10) far any of the script statements.

an al/CLEAR symbol,
with shading.
RECTANGLE
Rgure 8-9. Sample Symbol with and without Shading
a- IMPORTANT: Shading makes the diagram bigger. Sorne diagrams might greatly benefit from de-activating shading (in
terms of how many pages they occupy, in particular).
~RA~EZOIO
E--~
ARALLElOO
<~f~~DN
BOX SHAPES
..
.
..
.
..
.
.
You can change assignrnent of symbol shapes for the following categories of script statements:
Rgure 8-10. Available Box Shapes
Statement - the standard procedure steps on the procedure

diagram and ali he components on the tree diagram and the
decision tree.
If - the If statements which are described using the

allCLEAR script symbols.
?-
The shapes can be assigned according to your company

standards or preferences.
? END
Case - the Case statements which are described using the

: - : END allCLEAR script symbols.
Choice - the choice labels for the Case statement which are
described using the ( .. ) script symbol inside the : - : END
script language structure.
Loop - the Loop statements which are described using the ; ; END aJICLEAR script symbols.
Start - the first step (first encountered statement in the
script) of the procedure or roots of the decision tree branches.
Stop - the stop in a procedure described using the ! script
symbol (or the last statement in the script file) or the components on the last leve! of the decision tree.
OTHER FONTS
.
..
You can change two fon! parameters under this category:

Title
Choices
. ........................... .................. ...................

The Title Font parameter determines the size of the characters used to write the diagram tille. You can choose between
6 point, 8 point, 10 point, 12 point, and 18 point sizes. The
diagram title is al ways shown at the top of the first page,
when paging is on, and at the center of the diagram, when

paging is off. The larger font setting (12 points or 18 poinrs)

is, probably, most appropriate for the diagram title .
....................................................................
1~1
The Choices Font parameter determines !he size of the characters used to write the If and Loop choices (yes and IW, for
example) which label !he corresponding connecting lines on
a Procedure Diagram or Decision Tree. You can choose between 6 point, 8 point, 10 point, 12 point, and 18 point sizes.
~~
~~
PAGE LAYOUT
You can change six page layout parameters under this
category:
"
"
!he portrait or landscape page orientation
1-= 1
!he size of paper
"
single or double page setting
"
the start on left or right p~ge ~etting
"
active or inactive automatic paging
"
l~I
Figure 8-11. Portrait and Landscape Page Orientation
................................................................. -
borders or no borders for diagram pages
The Paper Size parameter determines the size of the diagram

pages which are drawn to fit the paper size. You can choose
between letter (defined as 8.5 x 11), legal!wide (defined as
8.5 x 14 for laser printers and 14 x 11 for dot-matrix
printers), and custom (defined as European 8 x 9 for laser
printers). For wide-carriage printers, you should use the
wide paper size setting.
The Orientation parameter determines how the pages of !he

diagram are oriented in relation to !he long and short sides of
!he paper. Thus, portrait orientation means that the
diagram's top is al the short side of th" p~ge, and landscape
orientation means that the diagram 's top is Iined up with the
long side af the page and that the diagram wll be printed
sideways (Figure 8-11).
a- IMi>ORTANT: Any one of the three available paper sizes can

be redefined in Setup. This is useful fer paper sizes which
are not standard. Refer to Chapter 9 fer inst-Jctior.s on how
to redefine paper sizes.
Orientation is a very importan! Style Sheet parameter which

greatly affects diagram space requirements.
...................... ........................................... -
a- IMPORTANT: You should always try to choose the page orientation which makes the diagram clearer and smaller.
best way to experiment with that is to press 1QJ while
All-Pages view. As the page orientation changes, you
mediately see the effect on the number of pages and
gram layout.
The Sides parameter d~termines whether the diagram is built

with single or double page setting. If your left and right rnargins are the same, whether you select single or double sides,
makes no difference. This option is available to facilitate the
incorporation of a!ICLEAR diagrams into reports and other
docurnents .
The
in the
can imdia-
. .. .. ... . .. . .. ... .. . . . .. ......... . .. . . . . . . . . . . . .. . . ............. . The Start On parameter determines on which page, right or
left, allCLEAR starts the diagram. If you have selected
single sides or if your left and right margins are the same,
f'...a. }.
.,
.....
8-l.6 Working with the Style Sheet
Style Sheet Optlons 8-l.7
whether you start on the right page or on the left page,

makes no difference. This option is available to facilitate the
incorporation of al!CLEAR diagrams into repons and other
documents.
ih~ P~g~-g ;~~~i~~ ci~i~~i~~; -~;~iii~~-~~-~~t ih~-~~i~~- ..matic diagram paging is activated. When paging is on, each
diagram page is keyed to the adjacent pages by means of the
following:
,,.
Each line which crosses the page break originates and ends
with an index box with a key Ietter printed inside.
,,.
The top left and the bottom right comer of each page has a
page map box which shows the numbers of the adjacent
page(s).
,,.
Each page is also Iabeled with the page number stamp, such
as Page 1 of 4 , for example, printed at the top right comer.
~plEJ
.
-=
EB
-
When paging is on, al!CLEAR automatically spaces the

diagram to be put into a document as is. When paging is off,
the diagram is printed as tightly as possible to be cut-andpasted (Figure 8-12).
If you are printing on a continuous feed printer, al!CLEAR
will print continuously through the perforation marks, if
paging is tumed off. Depending on orientation, continuous
layers will be either vertical (for ponrait) or horizontal (for
landscape).
The

..
Borders parameter determines whether orno lhe
diagram has a border around each page. Please note that, on
dot-matrix printers, diagrams without borders are printed
faster than diagrams with borders.
_,
~-
Agure 8-12. Sample a/ICLEAR Oiagram with and without Paging
MARGINS
You cai:i cha.'lge four margin parameters under this category:
,,.
Top
,,.
Bottom
,,.
Left
,,.
Right
.. .... ... ...... ..... .... .... ......... ...... .. ... ... .... .. .. ... ... The Margins pararneters determine the amount of white
space between the edge~ of page and borders. The available
settings are .25, 50, .75, or 1 inches. Obviously, in order to
put the diagrams into sorne sort of a binder (a three-ring, for
example), you need to make the Ieft margin bigger than the
right one. If your sides are set to double, this setting affects
the left margin of the right page and the right margin of the
left page. Margins affect the page layout only when paging
is set to on.
8-18 Working with the Style Sheet

Managing the Style Sheets 8-19
The Attach to File option of the Stye menu allows you to

save the changes you have made to the Style Sheet. You
should use this option in two cases:
..
1.
An operation you may need to perfonn quite often while

managing allCLEAR Style Sheets is to copy one script file's
Style Sheet to that of another. Let's assume that the file
whose Style Sheet you want to copy is called
FILEONE.ACL, consequently its style sheet file is called
FILEONE.STY, and the filefor which you wish to copy a
Style Sheet is called FILETWO.ACL.
When you create a new file, the DEFAULT Style Sheet is assigned to it at first. You then tailor the Style Sheet to fit the
new file, change the diagram type in particular. The new
Style Sheet has to be s~ved, or attached to the file, you have
created.
To copy. a Style Sheet:.
When the file already has a Style Sheet attached, you may
want to make further modifications. AJ] the changes to the
Style Sheet will be lost as soon as you select a different file
or exit allCLEAR. If you wish to make the changes permanent, the modified Style Sheet has to be saved, or attached
to the script file.
1.
2.
Position the cursor on the Attach to File option of the Style

menu and press [.oEnter) to select it. The altemative method is
to simply press [] from any point in the allCLEAR menus
or diagram views.
allCLEAR then saves the Style Sheet information in a special file. The style sheet file has the same name as the script
file and an .STY extension. When you select the Attach to
File option, the style sheet file is created or overwritten. It is
located in the same directory as the script file.
~ IMPORTANT:
St<1l1tSh
"'
"'''
1,"t
.;;.. }
Please do nct try to edit the style sheet files

using an Editor. You can only make changes through the ali
CLEAR menus and then save the Style Sheet.
Slirctscrlpt fl! forllCLLAltcllo1>Sf.-o.,thdlt'e'Clot"'f l1slln'
Figure 8-i3.
List of Style 5h1'et Fiies
3.
Position the cursor on the FILEONE.STY sryle sheet file and

press 1--'Enterl to select it.
4.
Press !FSi or select the Attach to File option of the Style

menu.
allCLEAR creares a new file (o r overwrites the old one)
called FILETWO.STY in the working directory. which is a
copy of FILEONE.STY but is attached to FILETWO.ACL.
......
__._..__..__.._
For your convenience, al!CLEAR comes with the

DEFAULT Style Sheet (Figure 8-14).
onCI n M T S - - -
.....
; Mtlt1~ 12 ,., .....

: Mrl..,.tloti ' ,..l..t
!:!
n.,.1. ss..t: llCFMA.t

DllClllltt
141
.
~
tlth
l.Ueh
'-'T...t
: Msl..t.11 -t.
SI
:-11
s1-.
u-11..,
: tf
S't.art
L--
m twor "'
' ,.11.ta
$HJlll'C
ID
-UM>UT---
0..1-t..tt-= 1-..-,.
h - S I : l.t.t..r
o.
htl..,
..........,
C...
Lft't
i..,.
: ......,_,.
: Lr' ...... "
:e111,_
Tp
1t.art.
IM
: 1.n. ,.....11.1.,.-: ,.pt,_..11.1...-
.. tt.a.
CMI-.
llsU
S.lect. ...._ ....... T?-99, .... Deolal-
~I
rtpt.,...
: -
St.au..-.t.: .....,.,_I
Ir
: 41......
: Ml'IOUU-- 1.zs
: l.ZS lndln
'""*""
.zs1~
e.zs
Chapter 9:
from allCLEAR
Running Externals
ICU
Tenl
'
1...-
rr- t.,.._
!!...

instructions on how to reconfigure the
allCLEAR environment, change the
allCLEAR global parameters, and run
externa! programs from allCLEAR.
t ....
Figure 8-14. The DEFAULT Style Sheet
The purpose of the DEFAULT Style Sheet is to give you a

starting point for managing the Style Sheets in allCLEAR.
There are two things you can do with the DEFAULT Style
Sheet:
,,.
You can load the DEFAULT Style Sheet and overwrite the
current one by using the Get Default option of the Style
menu. When you get the DEFAULT Style Sheet, first thing
allCLEAR asks you to do is select the diagram type.
,,.
You can save the current Style Sheet as the DEFAULT, by

using the Save as Default option of the Style menu, and thus
permanently modify the DEFAULT style sheet file.
~
'1'
~
~?;
~r
The Run Menu 9-3
9-2 Runnlng Extemals from allCLEAR
The Run Menu
Chapter Contents
The Run Menu
. . . . . . . . . .
Setup Options . . . . . . . . . . .
Ali of the options concemed with running externa! programs

in allCLEAR are organized in the Run menu (F igure 9-1).
9-3
9-4
9-6
rm=
n-w1"" *"' 1
~
___ ,.......
:w-.,
-u,.._.
St.111
:w.
p.,,l
: Hisl....t.lca
11 u .,I_ - __
__ .
~la
u.'11
-11$$1~'~
St..a~:~I
:"
c..
: l _...
u.,....t<lll
Wi't
CMIC9S
: lri'\ ,....11.iv-.
l ls llt
: l .ZS
; rlsU ,.,..ll l .,._
Top
lAI"
st..art.
: Ma,.11
mol
: ~l
~
g
s.w1.., : ...
lt
....
mi
1 ,.1.ta
te><\
si-
1ID
l'IAACltlS
a.u.011
.ZS 1_._,
!....,,...
: l .ZS !ne....
: l .ZS l......_
"""""
ICO
,..,1.
~~
Oull i...,.rartlywltMul 1..d"'f ""utl..:tlN lt,,....'"IXIT'' t..,..t""'
Agure 9-1. The Run Menu
"
"
,,.
DOS - temporarily exit to system Uump to DOS).

Publisher - run the Publisher program, specified in Setup,
directly from allCLEAR.
Setup, @:) - run the allCLEAR setup program which allows
you to reconfigure allCLEAR environment and defaults.
When you select the DOS option of the Run menu,
allCLEAR jumps to DOS but remains memor.1-resident. To
come back to allCLEAR, at the DOS prompt, type:
EXIT l+'Enterf
IGi"
IMPORTANT: Please don"t install memory-resident programs,

such as DOS PRINT for example, while in DOS through the
DOS option of the Run menu.
When you select the Publisher option of the Run menu,

allCLEAR transfers command to DOS and directs it to execute the program defined as Publisher in Setup. When you
exit Publisher, you come back to allCLEAR menu.
IGi"
IMPORTANT: In order to be able to use the DOS and Publlsher options of the Run menu in allCLEAR , you need to
make sure that your DOS directory is in the current path. ali
CLEAR has to have access to the COMMAND.COM file at ali
times.
Reconflgurlng allCLEAR Environment 9-5
9-4 Running Extemals from allCLEAR
kt.>tpO,.ll-
----~--1.llKO
,,..,-1cac..rii&:VGfil
..... 1......
: ""'
r11il'ltftf--
1.-.nt<-'r-U:4
Changing the curren! al!CLEAR configuration and global

parameters is accomplished by means of an externa! Setup
program. This program can also be run as a stand-alone program from DOS.
:t==----1
1,.i_,.... ,....
'"
r;ur.c,,,_ ,_. Ll_: M

UecJl Ll_.
: cbr
LJ,.~lnt
:f
""'...
11111
11:111
T~,1
:_i;
r------- ...... _________, eit

,,..,.1eo1:C:~ni1P
"'"
:C:~IUS
Ult.t"
P>all-
To change the current configuration:
Fil
1. Position the cursor on the Setup option of the Run menu and
press l--'Enterl to select it. An altemative method is to simply
c;-.;u..rc:I-.-;;.
3.
al!CLEAR then enters the Setup program and displays the

Setup Options screen (Figure 9-2). Each configuration
parameter shows the current selection to the right.
s.t...p O,t.hns
UIDCO---
@ .1wern;._
:LJn:
Z.0-
l'lltnlt..r
:~
'1lL1'111l'IT-1""'1d.Clf'dl<lrsJ<i
: '9
'"'''-'---~et.a~,.... LI-:
: 1!J
11.U.
Lt,.,..,_...,_,..
u ....
r.cr
Dlrecl'""J:t:~
EXtD!W..S - - - - - - - - <
:t:~t"
"'-lllllU...I Ult.r
!
- - - - -:t:"""'-UI'
- - " ' " " ' _________,
1
(i;rplolcs:t:~TVIP
r11.
m
~
~I
~
""'"'"
ICll
To,sl
c:~1u:s
:l'
lml3I
s.~
_ _1
"'"
::..tLect.rLntu
Figure 9-2. The Setup Options Screen
2.
,.
LJ,..~11"'1
$orlpt.h ..... t:ASCll
t..z.
irw-!Hl1cs CaN: UCA
Use the cursor control keys to position the bar cursor on the
configuration setting which you want to change and press
--'Enterl .
Notice that you can also use the highlighted characters to
move faster frorn one section of Setup to another. Thus, if
you press [[] from the PRINTER section, the cursor will
move directly to the BUFFERS section. Also notice that you
can move the cursor left and right as wel! as up and down.
When you press 1--'Enterl, for rnost of the options, allCLEAR
displays the available choices in a window which pops up
next to the selected pararneter (Figure 9-3).
r ...
,..1nt ... S>oOdon
Rgure 9-3. Changing a Setup Parameter
press ~ from any point in the al!CLEAR menus or diagram

views.
l'UW'IVI
'[Juttl"'
--~
Position the cursor on the desired choice and press
\2"Ent~ to
select it.
For other parameters, such as Directory, Externals, and Buffers, when you press EEn@, allCLEAR expects you to enter
a new string or edit the existing string.
Use the ~. [nsert], E-~ and cursor keys to edit the
4. current string. If you make a mistake or change your mind,
press [ to restare the initial string. After you enter the
new string, press EEn@ to store it.
When you finish reconfiguring allCLEAR and verify that all
the senings are correct, you have to make sure to save the
new configuration.
Press \B] to actvate the menu at the top of the Setup Options
5. screen. First, select the Save option and then the Quit option from that menu. An aitemative rr.ethod :s to press @
and, without releasing it, press [] to save the new configuration senings and exit Setup.
allCLEAR saves the new configuration settings in a system
file and comes back to the menu.
9-6 Running Extemals from allCLEAR
Setup Options 9-7
Setup Options
This section describes all the allCLEAR environment
parameters and defaults which can be changed using the
Setup program. Those parameters are categorized under the
six categories explained below.
PRINTER
This category allows you to redefine the fo!lowing printer
parameters:
pon settings. If your primer is connected to a serial port.

you need to redefine the COM port as an LPT port. To do
that, at the C:\ALLCLEAR prompt, type:
C OM
...., Enterl
This will run the special program, called COM.BAT, which

redefines the COMl portas LPTl and changes back to the
original setting at the end of the allCLEAR session. Refer to
Chapter JO for more detailed information on how to print to
serial output ports from al!CLEAR.
c:P.R 1~ .. . -
..
Primer
Tii~-C::Ri P~~~i~~. ~~;;~; y~~ i~. ~j~~i ~
..
Output Pon
!he Carriage Ret:.im and Line Feed switch settings of your

printer without actually changing the printer dip switches.
al!CLEAR requires that both a Line Feed and a Carriage
Return be performed after each line of out!JUL Usually, this
is controlled by the setting of dip switches in the printer.
The CR/LF option of the Setup utility can be used to assure
the required printer condition setting without !-iaving to actually reset the dip switches.
..
CR/LF
..
Printer Test
..
HP Memory
..
Table of Paper Sizes
. . . . . . . . . . .. . . .. . . . . . . ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . ..
The Printer parameter allows you to select the printer driver

for allCLEAR primer output. Figure 94 shows the list of
primers supponed by allCLEAR. If you don't see your
primer on the list, check the primer Owner's Manual to determine which would be the driver compatible with your primer.
P& *
1
unm.
Following are the guidelines for using this opton:

Actual Switch Setting
Needed Menu Selection
CR=OFF, LF=OFF
CR & LF
LF=OFF, CR=ON
LF Only
CR=OFF, LF=ON
CR Only
The default setting of CR Only is based on an assurnp,ion

that your printer is setup to output an autom<.li~ LF after a
CR is executecl If you experience problems printing
allCLEAR diagrams, you should expenment witb the three
CR/LF settings to find the corree! combination.
Figure 9-4. Printers Supponed by a/ICLEAR
........... ..... ............. .. .. .... ...... ... ... .. ... .. .. ..... .. The Output Port parameter allows you to specify the output
pon to which the default primer is connected in your system.
You can choose between LPTl , LPT2, and LPTJ parallel
The Printer Test parameter enables you t<> specifj' whether

or not allCLEAR is to check the printer before staning to
print the diagrams. If the printer test is on and retums the
"Printer Is Not Ready" error, allCLEAR abons diagram
processing before even trying to print. On the systems that
are connected to any printer sharing devices or networks, it
is >0ssible that allCLEAR will not be able to perform the
printer check correctly. If that happens , deactivate the
Printer Test and try again.
.Setup Optlons 9-9

The option of redefining paper sizes is intended mostly for

situations when nonstandard paper is used by the printer or
you want a different diagram page size for sorne other reason .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . The HP Memory parameter is meaningful only for the HP

LaserJet and compatible printers. It enables you to specify
whether the primer has 512K or >512K (more than 512K) of
available memory. CLEAR assumes 512K sening unless you
tell it otherwise. If your primer does ha ve more memory,
make sure to change the memory setting in Setup. It will
allow allCLEAR to download fonts necessary for printing
large symbols and 18 point fonts.
The Table Paper Sizes option enables you to overwrite the

default values of the three paper sizes (Letter, Legal/Wide,
and A41Custom) for the selected printer. allCLEAR provides
default values for aII paper sizes and primers. For laser
printers, the Legal/Wide size is defined as 8.5'' x 14" (or
legal) and the A41Custom size is defined as 210mm x 297mm
(or A4 European). For dot-matrix printers, both the
!,,:gallWide and the A4/Custom sizes are defined as 14" x 11"
(or wide) for wide-carriage primers.
Each dimension of the paper size if defined in pixels and consists of two numbers. For instance, in the number
!024x1536, 1024 represents the width and 1536 represents
the height.
When you enter the Table of Paper Sizes (Figure 9-5), you
should u~,. th~ arrow keys to position the cursor on the size
you wish to redefine. Then press l--'Enterl to enter the new
value. After ali the values have been redefined, press ~ to
exit the Table of Paper Sizes and get back to Setup.
al!CLEAR imposes the following limitations on paper sizes:
...
Neither the width nor the height can be less than 100 pixels.
...
Total paper size cannot exceed a certain number which is

determined by the memory available in your PC. al!CLEAR
has to be able to fit every complete diagram page (one page
at-a-time) in the memory.
lf you enter a number which results in either of the above
situations, al!CLEAR gives you a warning message (Figure
9-6 ). Pressing any key will restore the initial size definition.
....
s.t,w.pOpUM
Plllft'O
~~~~ hrt ~ ~~-J.t

o.-u
,,.1m....
i:.rt
..,_..,
..
i.t...el"":f
- UID!X:I
1 =~~~~
!1
, __ ,,... ! ...
c.r'. 1:;:
...,.....t._ ..
, .;r
-,;:~
oo.-.S _ _ _ _ _ _ __
:e:~,,..
-:e:~
U.lt.1'
l"ulo1L-
"'""" _ _ _ _ _ _ _- l
:c:~nnr
:c:~ll.lS
,,...,RIDS
Fll
r;,11r~
l irnn- . ... ~ ,.
<:>.1t" ,...,...,. 11\~
,._.
...,
llllEI
dlr\ltln
Figure 9-6. Paper Size Oefinition Waming
DEFAULTS
This category allows you :o redefine the following global

defaults:
s.t.upo,t.ll'IS
---PllM'l'D
i !
~!~~h..t ~ ~~u.-Jt
~~- T~l
lirtlft'
lllF>m---
j ~r~!...ca c..rc; ~
llf'!l""l.I
"""'""i.-
l<P'~~
___J
):4
~51l!CJl87ZZ3118x3'8ez:l5olxll48:&.I;
---~
z.a- i.......1 : 1:3
Scrlpt r..--t: ASCII
a..n
: .cr
1>1....,l'"'J:C:~
- - - - - - - '""'''"'
J:dltH
:(:~UI
...... 11 ......
:c:~lll'
;~~:llle.
: C:'-AU.CUAhT'!l1P
11..:11. ~1..s
: cJlr
1.1-,._.,.,.1..,
.rr
_________,
""""'--------!
:C:~JUS
l"o41f<1 lotlor, wt6o. 1r c:u:1to ..
,..l'C'I"
un "'"ln1tln
Figure 9-5. Table of Paper Sizes
"""
Clll
.,.._
112n
r..,,11
g
~I
~.
... Zoom Leve!

... Script Formal
... Buzz
... Directory
The Zoom Leve! parameter enables you to specify the
default zoom leve! for Scroll and Walk-Through diagram
views. When the diagram first appears in one of the two
views, it is zoomed out depending on the default zoom !evel.
Thus, if you specify 1: 1 as the default zoom leve! in Setup,
Setup Optlons 9-11
the diagrams will appear in full size. You can choose 1 :1,
1:2, 1:3, 1:4, or 1:5 zoom settings. The 1:5 setting, naturally, will produce the smallest diagram, or the view which is
the most zoomed out.
al!CLEAR on C:\ALLCLEAR. When al!CLEAR is invoked,

only the default directory and files-to-list specified in Setup
are made available for file operations. You can then access a
different directory by using the Directory option of the File
menu. Please remember that, if you want the change in directory to be permanent, you should redefine the default Directory parameter using the Setup program.
.... .......... ..... .... .......... ......... ... ...... .... .. ........ -
The Script Forma! parameter enables you to specify the file

format for the script file. The file formal depends on the
editor or word processor which you use to create and edit the
a!ICLEAR script file. allCLEAR specifica!ly supports
ASC!!, lotus WKSIWKJ IWKR, MicroSoft Word, and Word
Perfect formats.
If you are using a Word Processor with non-ASCII file formal which is not supported, try the Other script format setting. If you are not sure about the file format of your script
files, try the Auto Detect script format setting; this directs
al!CLEAR to match the file against all the supported formats
and automatically decide which one to use. For obvious
reasons, this setting somewhat slows down file processing
performed by a!ICLEAR. If none of the available options
works, output the script file as ASCII befare processing it
with allCLEAR.
a- IMPORTANT: You can tell allCLEAR to always set the warning

directory to the directory from which it was invoked by entering nothing but * as the default directory string. Then, if you
run aJJCLEAR from the C:\SCRIPT prompt, for example, the
working directory will be set to C:\SCRJPT\ .ACL.
EXTERNALS
This category allows you to redefine the following externa!
program parameters:
~
Editor
Publisher
The
Editor

parameter enables you to specify the path and
program name for the Text Editor or Word Processor which
you are going to run directly from a!ICLEAR to edit and create a!JCLEAR script files. You should always enter the
editor program name using the standard DOS formal, e.g.
C:\P ATH\P ATH editor. If the subdirectory holding the
editor program files is in the system PATH, you don't have
to enter the path as a part of the Editor string in Setup .
We enc<;mrage you to use an editor which produces ASCII

formal files. With any other format the probability of
allCLEAR incorrectly interpreting control characters is rather
high. When one of the non-ASCII supported formats is
selected, the first thing a!ICLEAR <loes when it reads the
file, is convert it to ASCII formal in memory.
. . .. . .. . . . .
.. . . .. .. . .. . . ... .. . . . . ..... . .... . ... . . . . . . . . . .. . . . ... . -
The Buzz parameter enables you to specify whether or not

sound cues are to be generated during a!ICLEAR operations.
al!CLEAR produces a tone just befare displaying the
diagram , when the tracing cursor moves from one symbol to
another, and when the status bar moves to indicate the degree of diagram completion.
The Directory parameter enables you to specify the default

working directory and files-to-list for a!ICLEAR script file
operations. Initially, the directory where the allCLEAR
sample files are insta!led will be defined as the default working directory and files-to-list. This directory will be the
C:\ALLCLEAR\SAMPLES\* .ACL directory if you installed
ua;-
IMPORTANT: You should always direct allCLEAR to invoke the

Editor with the currently selected file by ending the editor
string with an asterisk.
For example, enter:

C: \ WP *
as the editor string for WordPerfect. Then, when you press

or select the Edit option of the File menu (assuming that
the selected file is SCRIPT.ACL located in the
C:\ALLCLEAR\SAMPLES directory) , allCLEAR will call
WordPerfect with the directory and file name string for the
selected file, such as:
C: \ WP C: \ ALLCLEAR\SAMPLES \ SCRIPT.ACL
Setup Optlons 9-13
Tii~ ;~;~i;~~ P~~~i~~ ~~~;1;s ;.:~. ~ ;P~~;r;; ih~. ii~ii-i. ~;;prograrn narne for the desk-top publishing or paint system
which you intend to run directly from allCLEAR to edit
allCLEAR diagrarns orto incorporate allCLEAR diagrarns
into a published document. Sorne exarnples of a Publisher
are Ventura, Freelance, PC Publisher's Paintbrush, etc. You
should always enter the publisher prograrn name using the
standard DOS format, for exarnple:
C : \VENTURA\ VP
If the subdirectory holding the publisher prograrn files is in
the system PATH, you don't have to enter the path as a part
of the Publisher string in Setup.
has to read those files while displaying diagrams on the

screen.
allCLEAR usage of the virtual memory available in your PC
is rather unconventional, for it lets you determine the destination for the temporary files. Please make sure that the subdirectory which you specify for the graphics buffer exists
prior to generating allCLEAR diagrams.
.,.. IMPORTANT: lf your system has a RAM disk, make sure you
entera RAM disk subdirectory as the graphics buffer. In
order to use the RAM disk, your CONFIG.SYS file has to include VDISK device driver installation. Refer to your DOS
Technical Reference Guide for instructions on how to do that.
........................... ........ ..... ... ..... .. ..... .......... The File Buffer parameter enables you to select the subdirectory ior writing PRINT, PCX, PIC, and EPS files for
al!CLEAR file output.
a- IMPORTAHT: In order to successfully run either the Editor or

the Publisher, allCLEAR has to have access to the
COMMAi~D.COM file at all times. Thus, you need to make
sure that the DOS directory is in the current system PATH.
VIDEO
This category allows you to redefine the fol\owing Setup
pararneters:
BUFFERS
This category allows you to redefine the following storage
buffers:
...
Graphics Card
...
Monitor
...
Graphics Buffer
...
File Buffer
Tii~ c~~phi~~ c~~ci ;~~~~~i~~~~~~; ;~ ~;~~~ti;~. -
Please note that the iaitial choices for Graphics and File Buffers get set auiomatically during the allCLEAR installation
procedure. allCLEAR creates two subdirectories of the Sys:em directory, called TEMP and FILES. For example, if
allCLEAR has been installed on the C:\ALLCLEAR directory, the graphics buffer gets set to C:\ALLCLEAR\TEMP
and the file buffer gets set to C:\ALLCLEAR\FILES.
graphics card typ<:: determined by allCLEAR during the installation proccdure.
Tii~ e~~;;~ il~rr~~ ii~~;t~r ~~~;i~; ;~~ i~ ~~i~~i ili~ ...subdirectory for writing temporary files during allCLEAR
diagrarn generation.
allCLEAR needs access to a hard disk or RAM disk in order
to create diagrarns. During diagrarn generation, allCLEAR
writes temporary work files containing necessary graphical
information to the graphics buffer directory. allCLEAR then
.. .... ..... ...... ..... ............. .. .. ... ... .......... ...... .. .. The Monitor parameter enables you to overwri te the monitor
type (black-and-white or color) determined by al!CLEAR
during the installation procedure. If the color monitor is
selected, the default colors for allCLEAR interface are automatically activated. If you have a color monitor, but wish to
deactivate colors, select black-and-white as the Monitor
choice in Setup.
.................
--~------------a---9-14 Runnlng Externals from allCLEAR
Setup Optlons 9-15
FILE PRINT
the script file using the al!CLEAR print file utility. Line
nurnbers are printed to the left of the text and block lines.
This category allows you to redefine the following

parameters for the formatted script file print:
"
.,.
Indent (number of characters)

Lines per Page
.,.
Characters per Line
.,.
Block Lines
"
Line Nurnbers
OWW:TIJI L l f'IES
,,. Docs
The lndent parameter enables you to specify how rnany

blank spaces are to be used for indenting the logical blocks
(such as the text between ? and ?END) when the script file is
forrnatted or printed using the allCLEAR print file utility.
...... ........... .... .......... ..... .. ... .......... ............. ...
The Lines per Page pararneter enables you to specify how

rnany lines per page are to be used for printing the script file
using the allCLEAR print file utility. You should increase
the nurnber of lines per page if you are using the cornpressed
primer font.
IBft SET Llf'tES

[
Does you.r car ha.ve an alr cond ltloncr 7

CYesl turn t.hc 41r condtttoncr otr .
1'end
take the uehfc l e to a sale place and MLrlt .
..... ...... ...................... .. ............... ... ..............
-check
Lct thc enginc run at the idle spccd for a f cw i nutcs .
The Characters per Line pararneter enables you to specify

how rnany characters are to be used on a single line for printing the script file using the allCLEAR print file utility. You
should increase the number of character per line to 132 if
you are using the cornpressed printer font.
Is thc te111pero.ture dOlfn to occcpt.ab le l eue l?

('/es) You can now st4rt drlv tngl
cno> tu.rn the cnglne orr .
Doc:s Uc -:ter JIW"P be 1t look 0)(7
Uio) >dea ler
<Yes ) Check the cna lant leue 1 .
Is lt bclow t hc '"LOW" linc7
CYesJ Add coolant to t he :-eservolr and ro.d l ator .
[
>check
.. ... .. ..... .... ....... ... .. .. ... ..... .. .. ... ...... .... ..... ..... ..
O'to>
7end
The Block Lines pararneter enables you to specify what type

of lines are to be used for printing the script file using the
allCLEAR print file utility. The block lines are used to rnark
the beginnings and ends of logical blocks and thus provide
visual aids for rnaking sure your script file doesn 't have any
mistakes. You can choose JBM character set or ASC!I characters as building blocks for the logic lines Figure 9-7).
The Line Numbers parameter enables you to specify
whether or not the Iine nurnbers are to be used for printing
he.vean alr condltlonc:r7
Takc tic uehi cle to a &de place and park .

-cl>cck
Lct thc cnglnc run at lhe ldlc specd ror a tc:w lnutes .
,. Is t hc te.per.turc down to &eeept..blc lcuc: l7
( Yes) You can now stut d.r l ulngt
O'to) tw-n t.he eng lnc orr .
/ Does the tN1.ter pw1p belt look OIC7
Cl'to l >de4ler
<Yes) Check thc coolant lct1e l.
/ Is l t below t.he ''IDW" Jl nc7
CYesJ Ad.d coola.nt to the rescrwlr and radlator .
>check
1
Otol >dcaler
\ 7end.
' 7end
\ 7end
-dC4 ler
Br i ng your ca.r to t he d.ca ler ,
... ......... ....... .. .... ...... ... .... ....... .. .... .......... .... ..
...... ..... .... .. ..... .. .. ................... ... ... ........ .... ....
~ car
( 'Jcs) tu.rn thc &lr CDndlt l oocr off .
''1cnd
>dealcr
- 7cnd
7end
-dea ler
Brlng you.r car to t he dea.ler.
~----
Figure 9- 7. Two Kinds of Block Unes for File Print
:\i
-1i
.;:
..f
. i
r-{'
10-2 Most Common Questlons and Problems
How Do l... 1o-3
Chapter Contents
How Do l. .. (Questions and Answers)
. . .
What Do 1 Do lf... (Problems and Solutions)
10.3
10.7
How Do l. ..
(Questions and Answers)
You will probably find yourself asking sorne of the questions
listed below, when you start using allCLEAR on a somewhat
advanced leve!. Additional information can also be found in
the pertinent chapters of this User's Guide.
How Do 1 Make the Diagram Smaller?
1.
Display the diagram in All-Pages view.
2.
Decide whether or not the diagram would benefit from horizontal or vertical squeeze. If yes, press IBJ or 0 to squeeze the
diagram.
3.
Change symbol size to smal/.
4.
Change diagram style until the the smallest diagram is displayed.
4.
Change page orientation to the setting which generates the

least number of pages.
How Do 1 Use a Certain Word Processor with
allCLEAR?
1.
Check ali the supported script formats in Setup.
2.
If your Word Processor IS on the list, select the corresponding

script formal. save new configuration, and proceed to editing
or creating the script files.
3.
If your word processor IS NOT on the list, select Other or

Auto Detect script formal.
4.
If none of the above works, select ASCII script formal. You
will have to output the script file as ASCII every time you
save it with your Word Processor and come back to
allCLEAR.
-
-""""-_............_ . _ , , ; , ; _ , . _ , .. _. __
.,.;..._._._.__,_~'-q-<.:....---~--'-"'"-
..
~-
........ .
....:
10-4 Most Comrnon Questions and Problema
How Do l ... 10.5
How Do l. Print to the Serial Outpa4 Port?

1.
How Do l Merge Dagrams with a Text Document?
Prior to entering allCLEAR, at the DOS prompt, type:
MODE COM1:9600,n,8,l,p
MODE LPTl=COMl l~Entffl
a- IMPORTANT: lf you don't want to cut-and-paste, only desk-top
l~Entffl
(assuming LPTI is selected as output pon in allCLEAR).

This initializes the COM! pon and redirects LPT! to COMI.
2.
publishing systems or word processors which can import

graphics (such as WordPerfect) a/low you to make a/ICLEAR diagrams part of a text document.
1.
Output the diagrams to PCX, PIC, or EPS files (whichever forma! your desk-top publishing system imports). Sorne systems (Ventura, far example) import ali three formats. If you
have a choice, EPS file formal gives the best quality and
speed.
2.
If your text document is not yet published, import the text into
the desk-top publishing system. Locate positions where you
wish to see a!ICLEAR diagrams and import the diagram files
into those positions.
After you finish printing diagrams and exit allCLEAR , type:
MODE LPTl=LPTl
l~Enter !
This retums your system back to its original configuration.

Altematively, you can run the special program provided with
allCLEAR, called COM.BAT, which performs Steps 1 and 2
automatically. To run this program, at the C:\ALLCLEAR
prompt, type:
COM l~Entffl
~-~ How Do l Print a Diagram toa Plotter?
How Do 1 Make the Diagram Preview and Pnt

Faster?
IGi"
IMPORTANT: allCLEAR does not directly support plotters.

The only way to get a diagram printed on a plotter is to import it with a graphics package which includes plotter drivers
and then print it using that package.
1.
Output the diagram to PIC formal file.
2.
Enter :he graphics package which has the driver far your plotter. Most urganizations and individuals own Lotus 1-2-3
PGRAPH (utility far printing Lotus graphs), far example,
which suppons PIC format and prints to a plorter.
3.
Impon the graphics file (output by al!CLEAR) and print ir to

the plotter.
1.
Specify a RAM disk as the Graphics Buffer directory in Setup.

This will speed up diagram generation by minimizing disk
read/write operations.
2.
Do not print empty pages.
3.
If you are printing to a dot-matrix printer, deactivate borders.
4.
Deactivate symbol shading in the Style Sheet.
l.~
What Do 1 Do lf . 10-7
Most Common Questions and Problems
How Do r Make tlle Diagram F'"lt" on One Page?

1.
If you are using a Canon or Postscript laser printer, select

Scale to Fit on One Page as the print option.
2.
Display the diagram in All-Pages view.
3.
Make sure symbol size is small. Try changing the diagram

style and page orientation to choose the best combination.
4.
If you see a page with one box on it, try to squeeze the
diagram (vertically or horizontally, depending on layout).
5.
If none of the above helps, print the diagram without paging,

cut-and-paste the pages together, and reduce the complete
picture to the desired size.
What Do 1 Do lf...
(Problems and Solutions)
You might run into sorne of the unusual situations described
below in the course of installing or working with allCLEAR.
Most of these problems can be resolved fairly easily. Please
cal! our technical support line if you encounter a problem
which is not on the list.
What Do 1 Do lf the lnstallation Procedure Fails?

Severa! causes are possible:
SOUJIJON: a!ICLEAR can be used only with DOS versions

3.0 or higher. You should upgrade your version of DOS and
then install al!CLEAR from the beginning.
How Do l lnstalt anct Use allCLEARon a LAN? .

IGi"
IMPORTANT: allCLEAH does not fully support networks. A
separate network version will be available in the near future.

You should always make sure your computer is in loca l mode
when you install or use allCLEAR. Naturally, allCLEAR cannot
be installed on the server.
Load the editor into the memorv prior to entering allCLEAR.
2.
Fr'.}m the allCLEAR menus or diagram display, press the key(s)

wnich invoke your TSR editor. For example, press ~ - ]
for the SideKick editor.
3.
Specify the name of the script file which you wish to edit.
When you exit the ~ditor, :tllCLEAR checks the date and
time of the file and decides whether or not it is to reparse it.
Your computer operatlng system Is DOS version 4.x ..
SOLUTION: Insert the following line into CONFIG.SYS file:

INSTALL~C:\DOS4\SHARE.EXE,
How Do 1 Use a Memory-Resident Editor witb

allCLEAR?
1.
Your computer operating system Is DOS version 2.x.
reboot your machine, and install al!CLEAR from the beginning.
You have tried t<> 11stall allCLEAR on a LAN.
SOLUTION: This version of al!CLEAR does not fully support networks. You should install allCLEAR on your local
stati;m. allCLEAR can, hawe'1er, work wit!i the uipt files
located on the server.
10-S Most Common Questlons and Problems
What Do 1 Do lf... 10-9
What Do 1 Do lf the Menu Screens Are Clouded?
What Do 1 Do lf 1 Can't Display the Diagr&m?
Several causes are possible:
You have a Hercules clone graphlcs adapter and

allCLEAR was not able to lnltlallze lt to Full mode.
Several causes are possible:
You have a Hercules clone graphics adapter and

allCLEAR was not able to inltialize lt to Full mode.
SOLUTION: Full mode initialization should be performed

manually. Consult the Owner's Manual for your graphics
adapter to find out how to run the program to select Full
mode.
Your computer has memory-resldent programs

(TSRs) whlch lnterfere wlth aJICLEAR operatlons.
SOLUTION: Ful! mode initialization should be performed

manually. Consult the Owner's Manual for your graphics
adapter to find out how to run the program to select Full
mode.
You have just come back from a TSR editor, such
as SideKick.
SOLUTION: Exit from allCLEAR and remove ali the TSRs

from the memory before starting allCLEAR again.
lncorrect graphlcs adapter type Is speclfled In

Setup.
SOLUTJON : This could hapJen if you moved al!CLEAR

from one system to another without reinstalling it or if, for
sorne reason, allCLEAR incorrectly determined the graphics
card type during installation.Enter Setup and select corree!
graphics card type. Save the new configuration and retum to
allCLEAR menus.
SOLUTION: Press lPageUpl and then

memory of the remaining garbage.
IPageDownl
to clear the
Your computer has memory-resident programa

(TSRs) which lnterfere with allCLEAR operations.
SOL UT!ON: Exit from atCLEAR and remove ali the TSRs
from memory before starting allCLEAR again.
lncorrect graphics adapter type is specified in

Setup.
SOLUT!ON: This could happen if you moved allCLEAR

from one system to another without reinstalling it or if, for
sorne reason, al!CLEAR incorrectly determined the graphics
card type during installation. Enie1 Setup and select correct
graphics card type. Save t:i~ new configuration and retum to
al!CLEAR menus.
Whal'Do-1-Do-lf t Can't-PrinHhe Diagram?"-'-:":-cThe allCLEAR procedure diagram in Figure 101 explains

the most common print?~ problems and how to deal with
them.
What Do 1 Do lf... 1()-11
1().10Most Common Questlons ancl Problema
~loCl
Printer Problems:
Oi$abl~ ~e;. check ~
Put pMte< on-l;ne and

try aga/n.
)r
tj
Thcough a
software
Consutt network
Thtough a
hardware
manuals on how to
print Hl-AES graphics.
'"""'
spoole<
e the spooler. if
it does not anow
printiogof Hl -RES
Rwlar to =RINTCON lo
~~!~;;J~-
or
grapllics.
""
figure the spooler
{~~i~e
graphics.
Use a ditfererrt
cable.
Rgure 10-1. Dealing with Printer Problems
:emove any
MEMOAY
AESlOENT
software.
Ask Printer
Manulacturer
""Hi.~rs;,,i
10-12 Most Common Questions and Problems
'
What Do 1 Do lf the Script- File Print Doesn't Work?

You have selected IBM chaacter set as the block
line type In Setup mHf your prlnter does not support that set at lts present conflguratlon.
SOLUTION: Use your printer's menu options or dip

switches to select the correct font (which supports IBM character set).
Chapter 11:
Advanced Features
What Do 1 Do lf 1 Can't Read the PCX File?
The page slze of the PCX file created by allCLEAR

Is too blg for your Publlsher.
This chapter provides instructions on how

to use the more advanced fea tures of
allCLEAR.
SOLUTION: Enter Setup to redefine the Custom paper size

(Table of Paper Sizes option) to be smaller. Then select
Custom paper size in Page Layout and regen~rate the
diagram to PCX file.
What Do 1 Do lf the Diagram Doesn't Pnt Correctly on HP LaserJet?
Ali the fonts necessary for successfull HP LaserJet

printlng have not been downloaded to the printer
memory.
SOLUTION: Direct a!ICLEAR to print the diagram again

and select auto as the Download Fonts sening in the Print
Options menu. If you have started allCLEAR with the -F
parameter, you have to exit allCLEAR and download HP
L:i.serJet fonts using the HPSEND utility.
lf
1
1
112 Advanced Featurea

Using allCLEAR with Lotus 123 11-3
Chapter Contents
Using allCLEAR with Lotus 123 or Symphony
uiagramming Outlines . . . .
Managing HP Fonts . . . . .
Using allCLEAR with Lotus 123

or Symphony
. 11-3
.11-14
.11-17
.11-20
. 11-22
One of the script formats supported by allCLEAR is Lotus

WKS, WKI. or WKR. This allows you to build a!ICLEAR
scripts inside Lotus or Symphony spreadsheets. If you are
going to try this feature, malee sure you redefine the Editor to
be Lotus or Symphony and select the appropriate script formal in Setup. If you want Lotus to automatically retreive
the selected WK? file (when invoked from allCLEAR) you
should enter the following editor string in Setup:
123 -W*
~
iW'
A
.,.. IMPORTANT: When allCLEAR formats the script file which is

in a spreadsheet format, the output .ACL file cannot bi; rnarj
directly by Lotus or Symphony. Of course , any formatted
script file (ASCII format) can be IMPORTed back into the work
sheet, but active spreadsheet data will be replaced by a text
strng.
al!CLEAR analyzes Lotus or Symphony scripts using one of

the four methods described below.
METHOD 1
This is the most simple method which lets you use 123 or
Symphony as a text editor or word processor and takes no advantage of the special spreadsheet features.
Following are the rules for usini;t Method 1:'
1. The diagram description in the a!ICLEAR script langu,.ge

should be entered in the 'A' column; each cell should contain the actual script line complete with ali the text and script
symbols.
Far example, cell 'A4' could contain:
' Janes 1 Presiden t 1 Salary: $5 0000 i Sonus:
$4000 0\
where " 1 " is the allCLEAR new line indicator and " \" is the
allCLEAR tree script symbol.
11-4 Advanced Features

Uslng allCLEAR wlth Lotus 123 115
2.
The diagram title (if any) should be entered in cell 'Al', otherwise ce]] ' A 1' should be left empry.
3.
METHOD 2
This method allows you to take advantage of the special
spreadsheet features and incorporate active data from tables
into an al!CLEAR script. This method is, probably, the most
complicated of the four and should be used only by people
who are very familiar with Lotus string functions and operations.
Cell 'A2' should be left empty.
4.
The spreadsheet should not contain a range named ALLCLEAR.

If this method is used, allCLEAR will automatically look for
the script in the 'A' column. Each cell in column 'A' will
be treated as though it were a line in a regular allCLEAR
script. Remember that, if you use this method, the 'A'
column of the spreadsheet cannot contain any data which is
not a part of the script.
Following are the rules for using Method 2:
1. The diagram description in the al!CLEAR script Ianguage

should be located in column 'A'; each cell should contain
FORMULAS composed from active worksheet data and
Lotus string functions with script symbols.
Figure 11-1 shows an allCLEAR script describing an organizational chart entered in column 'A' as a column of
LABELS. Since these LABELS are not dependant on other
values in the spreadsheet, this is an example of using 123 as
a simple Word Processor. This sample spreadsheet is found
in the \SAMPLES subdirectory of the allCLEAR system
directory and is called WKJORGJ.WK!.
on.s: f'ron:J.den
For example, cell 'A4' could be defined as:

+B4& " 1 "&C4&" 1 Salary: $"&@STRING(D4, 0) &"
Bonus: $"&@STRING(E4,0)"
where column 'B' contains names of people, column 'C' con

tains their positions in the company, column 'D' contains
their annual salaries, and column 'E' contains their annual
bon uses.
ry:
tha l"portnl Co"P~
{toHIDE AU.>
Joncs : P'restdent :
S..1~:
Curus : s.1~... n 1
O" rt.ra ! S.Js-n :
s..1.~: szeeee : BorNs: szeeee.

S..l~: $Z8888 l Bonus: S3seee.
$58888 : Bonus;: S.. 888~"
As you can see, the Lotus concatenation operator & and the
STRING function are combined with cell values to produce
a single allCLEAR script line in each cell of column 'A'.
When the spreadsheet data of the cells used in the string
FORMULAS is changed, the values in column 'A' are updated to reflect the most recen! entries of either LABEL or
NUMBER values in the table.
S..ith : UP S..les: / S..l~; S388ee : Bonus: $"5~

Bro..,.... S..h-U1n l S.lu~: Szaeee : Bo""i;;: $38888.
8
1
Z
3
"'""
Ryan l VP Flrwu'lce l Sla~: $69e88 ' Borw.u;: $18888'

Taylor : Accts Re"C : Sahry: S3et>ft8 l Bor,.,111;: $5888.
f'lynn l ~cts: Pay l S..iary: $3ee&e ! Bonus: $1888.
"'""
"'""
L..., ., __
2.
\~r:
Agure 11-1. Samp/e WKl Script Ale, Method 1
When you direct allCLEAR to generare a diagram from this

file, it processes the 'A' column of the spreadsheet and ignores all the orher columns. The resulting tree diagram is
shown in Figure 11-5.
.............. .J;.< ..
........ ...'"' ... -..
'~
-. __ ..,,.,_._,..... ___ .'"'"'_ _ ,,,,.,,.. ........... .,__ , , ........
.,-.~-.-~
.......... _._
-~.J- ...~-
,,. _ _ _
_..,..,_-~.._ ........ ~ ....--.-
,,....
The diagram title (if any) should be entered in cell 'Al', otherwise cell 'Al' should be left empty.
3.
Cell 'A2' should be left empty.
4.
The spreadsheet should not contain a range named ALLCLEAR.

If this method is used, allCLEAR will autom~;ically read the
formulas in the 'A ' column and convett them to text. Then
each entry derived from formulas in cells of column 'A' will
be treated as though it were a line in a regular allCLEAR
script. Remember that, if you use this method, the 'A'
column of the spreadsheet cannot contain any data which is
not a patt of the script.
""";,,-.._.,
---
-~"' . -~~~
--~""
. . - . - , .....
~--~-.-.. , _ . _
. . . . ..,_.,,,_. _
__._,_,.._,, ______ .,_ .
_,~- .........-.~--
11~ Advanced Features
Uslng allCLEAR wlth Lotus 123 11-7
Figure 11-2 shows an a!ICLEAR scripr describing rhe same

organizational chan as the one in Figure 11-1 only entered in
column 'A ' as a colurnn of FORMULAS. This sample
spreadsheet is found in the \SAMPLES subdirectory of the
allCLEAR system directory and is called WKIORG2.WKI.
f1:
tUS3J 871
IC71
sa1.~:
$ iiiS!RJHC<b7,>I
METHOD 3
This method is next to Method 1 in its simplicity. However,
it is somewhat more flexible, for it allows you to use any
spreadsheet column (rather than only column 'A'), starting
from and ending on any row, for the a!ICLEAR script entries
by taking advantage of the Lotus option called NAMED
RANGE. Named ranges are defined by using
, &Onus: S llJS:lRIHG<Dm
Thie J,.portnt Co"P"'!f

{NHlD[ ALL>
.Jo~s : Pres:td~l : S.l~: SSee&e 1 Bol'llui:: S4eEtefh

S...Jth : UP S..les : s.1.~: $388e8 : Bonus : HSBOe'\
Broun l S...J~n : S.l~: $Z8888 l Borowi:: $38988.
C..rth 1 s.1 ...,.." f s...1.~: szeeee : ao .... s : szeeee.
on.ra : s.1 ..
.......
T.ble
S.1-...,n
Cw-Us
O' M.ra
R!in
T!llor
S.l~n
UP F'lrwincc
Accts Rcc
Fl!lnn
Aects Pa!:f
Bonus:
S.la~; $3ee68 : Sonus : $1888.
''"'"
S..ith
,.,....1dent
Following are the rules for using Method 3:.
UP Sls;
Sate.._n
1. The spreadsheet should contain a one-column range named

ALLCLEAR, such as 'Dl8 ..D3 I ', for example .
2.
7
8
7 -M11<4 - 98
and specifying the range and its name.
--------
.Jo,..,
Broun
szeaee :
\ RANGE NAME CREATE
o..t.
Post l lon
$35888.
s .... n: S.lro,,:
Fl<Jnn : Accts Pa!I 1
'
Ha,..
R!:fan 1 VI" f"ln.ncc 1 S.J~: $68888 l Bo .... s: $19888'\

Ta!:llOr Accts R~ : SAlar!:f! $38e8e : Bonus : $5888.
. .......
s
0r1 5 1~1
8<4: 55 AN
mo
Figure 11-2. Samp/e WK1 Script File, Method 2
When you direct a!ICLEAR to generate a diagram from this

file, i! processes the 'A' column of !he spreadsheet and ignores ali !he other colurnns. The resulting tree diagram is
the same as !he one produced from !he spreadsheet in Figure
11-1 and is shown in Figure 11-5.
The diagram description in the al!CLEAR script language

should be entered in the column o! the named range, starting
from the first row of the range and ending on the last row of
the range (cells 'DJ8' through 'D31' in the example); each
cell should contain the actual script line complete with ali the
text and script symbols.
For example, cell 'D 18' could contain:
'Jones 1 President 1 Salary: $5 0 00 0 1 Bo nus :
$40000\
3.
The diagram title (if any) should be entered in the first cell of
the range, 'T5' in the example, otherwise the first cell of the
range should be left empty.
4.
The second cell of !he range, 'T6' in the example, should be

left empty.
the script in the named range colurnn. Jusi like with Method
1, each cell in this column will be treated as though it were a
line in a regular al!CLEAR script. The difference is that !he
cells before !he first row and after the las! row will be ignored.
Figure 11-3 shows an allCLEAR script describing the same
organizational chart as the one in Figures 11-1 and 11-2 only
entered in column 'T', cells 5 through 25, with 'T5 ..T25 '
defined as the range named ALLCLEAR. The cells in rhis
range are entered as LABELS. Since these LABELS are no!
dependant on orher values in !he spreadsheet, this is another

Using allCLEAR with Lotus 123 11-9
example of using 123 as a simple Word Processor. The

sample spreadsheet is found in the \SAMPLES subdirectory
o[ the allCLEAR system directory and is called
WK10RG3.WKI.
~lx.uple
METHOD 4
This method allows you to take acvantage of thc special
sprcadshect features and incorpon.te acrive data from tables
into an allCLEAR script. This nethod also uses thc Lotus
option called NAMED RANGE. Narned ranges are defincd
by using
J - ALUURR nr.ed ran9e $D$1 .. JD'.S'3
h,.ple 3 - ALLCLEAR rwi.,.d ra1'19e $0$18 . $0$31
\RANGE NAME CREATE
Th J,.porlnt CoHpu~
and specifying the range and its n1me.
(MtlJDE ALL)
Jo.-.s 1 ff"'Tsldnl 1 Shry: S5eeee 1 8on1.1s: $18900:'\

S"lth 1 UP SaJu 1 SaJal"J: $3e099 1 Bonus: S15fte8'
Broun 1 Sls"" 1 Sala.-.,,: $28088 1 l!o.,.,.s: $38908.
Curlis 1 Salas-.n 1 Salary:
Szaeee 1 Bo""s : SZOeee.
O' tiara 1 Sahs,..n 1 Salai-si: $18688 1 Bo""'s: $3Se89.
'"""
R<Jan 1 UP '1nance / Sabry: $Ge988 1 Bonus: $19988\

laylor 1 Aceh: Rae: 1 Salal"'J: $3e8oe 1 Bonus: $5800.
flyrm / Accls l'ay / Sahry: $3'0888 1 Bono.u:: $1869.
'"""
'"""
81: 58 Al'I
UHDO
Figure 11-3. Sample WK1 Script File, Method 3
When you direct allCLEAR to generare a diagram from this

file, it processes the range named ALLCLEAR of the spreadsheet and ignores ali the other cells. The resulting tree
diagram is the same as the one produced from the spreadsheets in Figures 11-1 and 11-2 and is shown in Figure 11-5.
, Followlng are the tules fot _sl111t:Metiod 4! :
r;. : . :
1. The spreadsheet should contain a multi-column range named

ALLCLEAR, such as 'Fl9 .. 032', far example.
2.
Each cell of the range should c>Jn\ain acrive worksheet data (including FORMULAS) which is ll be used in the diagram;
the last column of the range shou d contain the nccessary
script symbols.
Far example, row '22 could be defined as:
'F22' =+A23, 'G22' =' 1, 'H22' =+B23, 'I 22 ' =' I ,
'J22'='Salary:, 'K22'=+C23, 'L22'='1,
'M22'= 'Bonus:, 'N22'=+D23, '022'='\
where column 'A' contains names of people, column "B contains their positions in the organization, colunm 'C' contains
their annual salaries, and column 'D' contains their annual
bon uses.
z:TIJ?J'i1fZ'l
Th .. l"portanl
Co.,piu~
s-zo.eee
CHlOE
Janes
S"llh
Broun
Curlts
O't1ara
$35,81'0
sie,ooe
$5,008
laylor 1 Accls; Jt.,c : Salary: $36,866 : Borws:
Bonus
$48,000
$45,eee
$30,998
u.eoe
Ryan
F'lynn
ID
Pre'l'ldent '
UP Sal..s;
Sales""
Sahu.an
Sales.,an
Salar"'J : $58,698 l Bonus: $40.00 0 '

Slry: $30,000 1 Bonus;: $15,eoe '
Salar"'J: Sze,eoe l Bonus: S3tl.BB0 .

Sah~: SZB,868 1 BoMn:: $ 20,800 .
Sala~: $Z0,868 : Boous;: $35,BBB .
'""
1 UP Fln ..oc1d Shr"'J: SGB,606 1 Bo.,.,u:: Sie,006'

: Accts Pay 1 S11lry: $38,BBB : Bonus:
$5,806 .
$1,008 .
't'nd
'
7-Mr!IB
e&: 1e An
tmDO
Figure 11-4. Sample WK1 Script File, Method 4
-------
Uslng ullCLEAR wlth Lotus 123 1111

11-10 Advenced Features
3.
The diagram tille (if any) should be entered in the first cell of
the range, 'T5' in the example, otherwise the first cell of the
range should be left empty.
4.
The second cell of the range, 'T6' in the example, should be

left empty.
Figure 11-4 shows the allCLEAR script dcscribing 'the same

organizational chart as the oue in Figures 11-1, 11-2, and 113, only entered in columns 'O' through 'T', rows 5 through
25, with '05 .. T25' defined as the range named ALLCLEAR.
The sample spreadsheet is fourd in the \SAMPLES subdirectory of the allCLEAR system directory and is called
WKIORG4.WKI. When you <lirect allCLEAR to generate a
diagram from this file, it processes the range named
ALLCLEAR of the spreadsheet and ignores ali the other cells.
The resulting tree diagram is the same as the one produced
from the spreadsheets in Figur~s 11-1 and 11-2 and is shown
in Figure 11-5.
Figures 11-6 and 11-7 illustrnt! how you can create a
description of a procedure diagram using Method 4. The
sample WKI file is found in the \SAMPLES subdirectory of
the allCLEAR system direct:ii;.' and is called PROC.WK\.

the data in the named range columns and concatenate ali
cells in each row with a single space between entries, except
for cclls beginning with punctuation marks, such as the ". ",
"\ ", or "?" script symbols. Thus, the script will be constructed without your having to use the Lotus string functions. The cells before the first row and after the last row
will be ignored.
The Importan! Company
....
'ti
--
A 1
-1
!
C
D
E
.E><a,.plS - an al ICLCAR s:erlpt us: i ng the ALLCUAR n...,d
Jones
~~~;~
Brown
Salesman
~~~r~
Uork ln Pros
Curts
t~rr1=
Us,.5e
----------------------1ooe
200
... ...
VP~~C@
Salary: $60000
Bonus: $10000
Taylor
Accts Rec
Sala<y' $30000
Bonus: $5000
~-',.J
,,
;~
~fj
~
:fJ
;"'
%
Sales man
f'
$E$4 . . $J$38
f'rocess Dl sr"
President
~~uT~~
Smith
VP Sales
ra~
1 ICLEAR scrlpt
Flynn
SaJ~~~~
Bonus: $1000
O'Mara
Salesman
Salary : $20000
Bonus : $35000
Rgure 11-5. Sample Tree Diagram from WK1 Scripts
Jltou9h Culllng
MI llrr l
Mtller Z
Mlllirr 3
s ..oolhl,,..,
7-n.~-'le
&"': 51 Al1
25
25
,..
"....'
........ ...
R" nahrll I
u1r:
Qualll!I Contrel-1
Ulf':
(C ood>
up:
(8ad)
'?11'"4
llough Cutu,.,.,-:
UJf':
<Mlller Z> up:
<Mlller 3> uu:
:er>d
-lnh:h
s .. oolhl"91-:
01\ller 1)
Rgure 11-6. Sample Procedure WK1 Script
1112 Advanced Features
Uslng allCLEAR wlth Lotus 123 1113
Paac 1 o 2
Pagc 1 o( 2
Process Diagram
WIP:'
USE:20
A.lwt.tat.!l.iln
'MP:200
USE;1000
...
WIP:10
IJSE:40
R\Jf"IOV~
-,
..
~
~
... ~
Figure 11-7. Sample Procedure Diagram from WK1 Scr/pt
Diagrammlng Outlines 11-15

~~~~~~~~~~
For example, to diagram a sample outline OUTL!NE.PRN
Diagramming Outlines
(Figure 11-9), type:

OUTCHART OUTLINE.PRN :-'Ente~
This command will direct allCLEAR to analyze the OUTLINE.PRN file and save the dcscription of its tree diagram in
a script file called OUTLINE.ACL. This script file is complete with ali the script symbols necessary to confarm to the
allCLEAR script language rules (Figure 11-10).
allCLEAR offers two altemative methods far producing tree

diagrams from outlines:
...
METHOD 1: Include a command in your outline file which

tells allCLEAR that it is to interpret indents as script symbols identifying components of the tree. Please refer to the
Language Manual far instructions on how to do that.
...
.M.ETHOD 2: Run the utility, included with al!CLEAR,

which reads an outline and outputs an allCLEAR script file
describing a tree diagram of tls file. This utility is called
OUTCHART.EXE and is located in the \SAMPLES subdirectory of the al!CLEAR system directory.
Notice that the only required parameter far OUTCHART is

the input outline file name .
2. Enter allCLEAR, change directory to
: T diagralri ali outllne:
C:\ALLCLEAR\SAMPLES. and select OUTLINE.ACL file

from the list of script files.
3. Edit the default Sty\e Sheet to format the outline diagram. most
importantly se\ect cree diagram type.
1.
Make sure the outline is in ASCII formal with indents used to

identify the level of subordination. If you are using an outIiner (such as ThinkTank, for example), you have to print to
file prior to running the OUTCHART utility.
4.
2.
At the C:\A.LLCLEAR\SAMPLES prompt, type:
OUTLINE.ACL is now just another one of the script files

and you can work with its Style Sheet or you can e<lit the file
itself and modify it in any way you like.
OUTCHART l-'Enterl
allCLEAR displays the list of required and optional
parameters (Figure 11-8) far the OUTCHART utility.
~: V\LLCU:Aif'.SAl1PU'.S>outchart
utchr-l lnpulfll c-01 e-ro r-Pl c-RJ c-FJ t-UJ l-Tlllll c-Ooulflll (-Slabt:l
1
, J rgu-nls
optlonI
D for S>p:l" dal nd l he
r lo PC1l PJHrnd perlods:
R lo 11hou ~rlods
f lo nol shoY Clrsl lndlcalor (llke 1. )
U lo not us be9lnnln5 llrc "' spae as llll
Ttltle sp-elrtes tille 11trl"'!I' <In qtutles. lf necirsu~)
Ooulfll speclfls out.pul file ...-. ... (dfaull h .ACL>
Slabsl11 ,,.ns labs reprsa"t tabsl%1! poslllons (d11faull h 8)
'-ALLCLEA~AM!'L'ES>
v.,
Figure 11-8. OUTCHART Utifity Parameters
Direct al!CLEAR to generate the diagram to screen, printer, or

file. Figure 11-11 illustrates an al\CLEAR diagram
produced from the outline file shown in Figure 11-10.
1: Resume
1.1: Object i ve
1.2: Achie11e111ents
1.3: Education
1.1: Experience
1.1.1: Job 111:
Co111pany background:
Title:
Responsibilities:
1.1.2: Job 112:
Co111pany background:
Title:
Responsibilities:
1.5: Special Qualifications
1.6: Personal Interests/Hobbie
1.7: References
~
Rgure 11-9. Sample Outline Rle
1: Resul'T'le '
1.1: Objective.
1.2: Achieve~ents.
1.3: Educatlon.
1.1: Experience.'
1.1.1: Job Rl:'
CoMpany background: .
TitJe:.
Responslbllitles: .
'end
i.1.z:
Job RZ='
Company background:.
TltJe:.
Responslbilltles: .
'end
'end
1.5:
1.6:
1.7:
'end
Special Quallflcatlons.
Personal Interests/Hobbles.
Rcferences.
Rgure 11-10. Output of OUTCHART

Dlagrammlng DOS Batch Rles 1117

a!ICLEAR includes a utility which reads any DOS batch file
and outputs an allCLEAR script file describing a procedure
diagrarn (or a flow chart) of this file. This utility is called
BATCHART.EXE and is located in the \SAMPLES subdirectory of the alJCLEAR system directory.
Ji
'.'!f
5
-
JI""'
JI
To diagram a DOS batch file:
rH
,,..""'
~8
1. At the C:\ALLCLEAR\SAMPLES prompt, type:
l!
Jl-H!'
BATCHART
.IJ
l:: "'1.1.C.P~>bat.cM.rt
~t.c:Mrt. hd'll C-Dl l-ltl C-:l C-CJ l-TUt.l9l C-0.uU'tll

nl'll la Nt.ca ru. t.e
CMf-..lt. ts . IAT>
... ) ~t.armpt.1,..1
,...cesset1
. !:::!:",~..!: .... u -
.;,:
:;/'
:) rl:
!]
~
\?Enteri
allCLEAR displays the list of required and optional

parameters (Figure 11-12) for the BATCHART utility.
l.:)
r;-.
~
ahow l"'91't llnes
shou cls ltrws

lle Spi9C1Fl- tltle st.rlft9 (ln . - t . . , U _ . . . . . , . ,
U'il spec1r1n: out.pul rue - . . <Mfault. h . ACU
,..
YII
. ti
Figure 11-12. BATCHART Utility Parameters
~
~
For exarnple, to diagrarn a sample batch file (which customizes staning allCLEAR to usage with HP LaserJet
printer) called ALLCLEAR.BAT (Figure 11-13), type:
BATCHART ALLCLEAR
Figure 11-11. Sample Outline Tree Diagram
-e
-R "-TStart allCLEAR"
\?Enterl
This command will direct allCLEAR to analyze the

ALLCLEAR.BAT file and save the description of its flow
chart in a script file called ALLCLEAR.ACL with the given
diagrarn title. This script file is complete with ali the script
symbols necessary to conform to the a!ICLEAR script Janguage rules (Figure 11-14).
'
Dlagnunmlng DOS Batch Fil.. 1119
1118 Advanced Featurea
a{f
dla.?1111 st...t l'roa:dun:

bid
!j11U
lll<e to dlAble die.mi 11' fonts _ . , t '
lt you decide to do tlllt, ..... you -lood

1114 ......, 11' mlt faats 1>1tslde o{ 1llc.Ellll ulng
ll'SllGI mi IG'1lllOI!.
:tart al lCLEAR
Start allCLEAR
l<-HIDE ALL>
; ls:.
en get user cho lee.
holee HY Enter ChoiceCY;H)7 H.

lt errorleuel Z7
Cycs)
ds
>Di:sa.ble
end
>EHD
disable
-F.
EHD
rem oet user choicl
TMN yao far al.. dUl.EAll

cnoice KV Entw
Choice(YIN)? N
Figure 1113. Sample Batch File
Figure 1114. Output of BATCHART
Notice that the only required pararneter for BATCHART, ~

however; is the input batch file name.
No
yes
2. Enter allCLEAR, change directory to

C:\ALLCLEAR\SAMPLES, and select ALLCLEAR.ACL
file from the list of script files.
AF
3. Edit the default Style Sheet to format the batch file flow chart,
most importantly select procedure diagram type.
4. Direct allCLEAR to generate the diagram to screen, printer, or

file. Figure 11-15 illustrates an a!ICLEAR diagram
produced from the ALLCLEAR.ACL file shown in Figure
11-14.
ALLCLEAR.ACL is now just another one of the script files
and you can work with its Style Sheet to format the diagram
or you can edit the file itself and modify it in any way you
like.
Figure 1115. Sample Batch File Aow Chart
-~
U-20 Advanced Features

Dtagrammlng DOS Dlrectorles 11-21

allCLEAR includes a handy utility which scans your disk
directories and outputs an allCLEAR script file describing a
directory tree diagram. This utility is called
DIRCHART.EXE and is located in !he \SAMPLES subdirectory of !he allCLEAR system directory.
1
1. At !he C:\ALLCLEAR\SAMPLES prompt, type:

DIRCHART
tJEnteij
allCLEAR analyzes all the directories and saves the description of a directory tree in a script file called
DIRCHART.ACL. This script file i$ cc~plete with all the
script symbols necessary to conform to the al!CLEAR script
language rules (Figure 11-16).
2.
Enter allCLEAR, change directory to

C:\ALLCLEAR\SAMPLES, and select DIRCHART.ACL
file from the list of script files.
3. Edit the default Style Sheet to formal the directory tree

diagram, most importantly select tree diagram type.
AU.CLEAR
123
TEMP
DATA
WP
VENTURA
61 _l~SET
DOS
UTIL
FONTS
SAMPLES
FILES
4. Direct allCLEAR to generate the diagram to screen, printer, or

file. Figure 11-17 illustrates a hypotheticaJ directc:y tree
allCLEAR diagram produced from !he DIRCHART.AC'.., file
shown in Figure 11-16.
(..11Dt Alll"
lllJ..Cl.EAA\
TDll'.
l'Clfr.!.
'
Sl'llPU:s.
TJU:S.
'""..,,,..
'""llmtl!m.
""'
LlTl'DIS.
VElfTIDI'
'""TYl"ESU.
in,
'""
llOS.
UTIL.
''""'
Rgure 11-16. Samp/e DIRCHART.ACL
Rgure 1117. Sample Directory Tree
DIRCHART.ACL is now just another one of the script files

and you can work with its Style Sheet to formal 1he diagram
or you can edil the file itself and enter descriptions for each
subdirectory, for example. Naturally, at any time you can
regenerate DIRCHART.ACL to obtain the directory tree
which is up-to-date.
.,
..

Managlng HP Fonta 1123
Managing HP Fonts
'"
Download a subset of fonts required for the curren! diagram

every time printer output is selected; remove all the fonts
when the session is over. The advantage of this approach is
that allCLEAR downloads only the necessary fonts, which
takes considerably less time than downloading ali, and even
with printers with 512K memory you will be able to use any
size fonts and symbols. The disadvantage of this approach is
that even if you are printing the same diagram twice,
allCLEAR still download fonts every time. The speed of output now has to include the downloading time and averages at
35 seconds per page for single-page diagrams. This approach is recommended for printing allCLEAR diagrams
from a Local Area Network.
Far HP LaserJer and compatible printers, allCLEAR needs to

downJoad soft fonts befare it can sean printing. Similarly,
when you exit allCLEAR, all the fonts that have been
downloaded into the HP memory, need to be removed. You
control the HP soft fonts management procedures primarily
through the Download option of the Print Options menu
which comes up every time you choose to print a diagram
(Figure 11-18).
-..,.,,..._.,.
,,..
0..t ... t: l'rl..t..>Wt.a.rJrt IH
~t;
,_t
: Na
t-t
: ....
Strt on p.>gr
End un f>,.91
P-...-1'.. -t.,. ..... p.'I..._
no
l'r1nlt.><pl'fP~
no
~
'/i~t,.,..,t;;;
SI-
2 - Download selectively every time (auto setting)
'
S-1..,: en
i ......_
~1"911
m - Ok
all-
u1t
ID -
~-- ; ~........
~.,..---...,!".,!",.: 111~
Tep
St.M.
: r.cU.nsl
.. u .,
"'4
: rtstit,..rllel.,..._
W.p
S,...ctfy ""rt"-1-
'"
o..1t
Download NO fonts at all at any time during the session;

remove NO fonts when the session is over. Rely on the user
to perform ali the necessary font management procedures outside of allCLEAR. This approach is advantageous for those
users who prefer the first approach but frequently go in and
out of allCLEAR, because, with the first and second approaches, when Quit is selected, all the fonts are removed
from the printer memory. Obviously, this approach gives
you the best control since it disables all the automatic fon!
management procedures.
""'t U.e hnt.s sll.ovU M '-ntud behr<1 ,...lnl
Figure 11-18. Print Options Menu
'"
There are three alternative approaches to managing soft fonts:

1 - Download ali once (ali setting)
DownJoad the complete set of fonts befare printing for the
first time during a session; remove ali the fonts when the session is o ver. The advantage of this approach is that the
downloading procedure is performed only once an you
don't have to wait for the fonts to be downloaded when you
print any time aiter that. After the fonts are downloaded, the
spee of output averages ar 7 seconds per page. The disadvanrage of this approach is that downJoading all the available
fonts takes quite sorne time and may not be necessary for
printing your diagrams. 1n addition, for printers with on!y
512K memory, you will not be able to use large symbols and
18 point size font, if you choose this approach.
3 Do not download at ali (none setting)
ailCLEAR assumes the second approach to be the default.

To overwrite the default, change the Download setting in the
Print Options menu (!+'Enterl toggles a11 the choices) befare
hitting ~.
To use the thircl approach:
1.
Befare entering al!CLEAR, run the HPSEND utility. For example, at the C:\ALLCLEAR (allCLEAR system) prompt,
type:
HPSE ND O LPTl 1--'Enterl
This downloads the allCLEAR HP LaserJet fonts to the

printer memory.
ll24 Advanced Featurea
The HPSEND utility has two pararneters: memory (0 for

5!2K and 1 for >512K) and output port (LPTJ, LPT2, or
LPT3).
2. When you finish working with a!lCLEAR, run the

HPREMOVE utility. For example, at the C:\ALLCLEAR
prompt, type:
HPREMOVE O LPTl l-"EnterJ
This removes the al!CLEAR HP LaserJet fonts from the

printer memory.
Just like the HPSEND utility, the HPREMOVE utility has
two pararneters: memory (0 for 512K and 1 for >512K) and
output port (LPTI, LPT2, or LPT3).
3. You can save yourself from having to remember to change the

Download setting in the Print Options menu by starting
allCLEAR with the -F parameter. For example, start
a!ICLEAR by typing:
A -F
f? Enterl
This will assure that none setting is always selected for font
download and direct allCLEAR to never load/remove fonts
to/from the printer.
allCLEAR als<;> provides a way of controlling where in the
HP memory the fonts are downloaded and whether they are
permanent or temporary. This information (or the starting
font ID number and T or P setting) is contained in the
HPFONTS.DAT file located in the \HPFONTS subdirectory
of the a!ICLEAR system directory. This file is an ASCII file
which can be edited by any editor; the default is permanent
fonts with starting font ID 30,000. By editing the
HPFONTS.DAT file and changing the starting font ID, you
can make sure allCLEAR does not overwrite any fonts that
might already be in the memory for use by other prograrns.
Chapter 12:
Error Messages and Warnings
This chapter lists al!CLEAR error and
warning messages and provides
instructions on how to deal with them.
12-2 Error Messages and Wamlngs

Error Messages 12-3
Chapter Contents
Error Messages
Warnings
Error Messages
. 12-3
.12-12
lf an error condition is encountered, allCLEAR halts ali

processing and displays an error message with a brief explanation anda reference to the User ' s Guide (Figure 12-1 ).
Dliqih!tlhr oll,.r- onlll M:rn"n lnSc:,...11 -M
Figure 12-1. a//CLEAR Error Message Screen
Following are ali the possible errors and their explanations.

E1Tor #1
NO FILE SPECIFIED FOR ACTION
PROBLEM 1: You have tried to generate a diagram

without first selecting a script file.
PROBLEM 2: You have trled to format or print

wtthout first selecting a script file.
SOLUT/ON: You MUST specify the name of the file which

is to be the object of allCLEAR processing. Use the Select
option in the File menu.
.12-4 Error Messages and Wamlngs

Error Messages 125
Error #2
PROBLEM 1: You have lncorrectfy specffled the

drfve, path, or file name of your extemal program.
Error #4
SOLUT!ON: Use the Externals option of the Setup utility

to verify the name and path settings for your externa] Text
Editor or Publisher.
PROBLEM 2: Your CONFIG.SYS file doesn't have

the rfght settlngs for the number of flles and buf
fers.
SOLUT!ON : Check your Editor/Word Processor and Publisher rnanuals for the required number of files and buffers.
Change the CONF1G.SYS file accordingly and restart the systern.
PROBLEM 1: Your prlnter Is off or unplugged.
PROBLEM 2: No paper Is in the prlnter or paper is

incorrectly fed.
PROBLEM 3: Your printer Is not ON-UNE.
PROBLEM 4: Your printer Is not properly connected.
PROBLEM 5: Prlnter is not on the correct prlnter

port of your system.
PROBLEM 6: Printer is on a LAN.
SOL UT!ON: Check paper supply and power connections of

your primer. You MUST also verify that the primer is connected to the primer p:::-t specified during the installation procedure prior to making a hardcopy of the diagrams.
SOLUT!ON: To execute any externa! command, al!CLEAR

must allocate the COMMAND.COM file. You should make
sure that your DOS directory is in the current path and that
your COMSPEC is set correctly using the following DOS
cornmand:
COMMENTS: If you ar~ absolutely sure that the printer is

ready, use the Setup utility to deactivate the Pr inter Test.
In sorne situations (e.g. when the primer is shared through a
spooler or network) a!ICLEAR can be wrong.
Error #5
ERROR READING RLE
L:ii:i :l :;,, ' IJPS ' 1. 13.L g_1 1JE
PROBLEM 3: allCLEAR cannct fi:;d COMMAND.COM

file.
SET COMSPEC=C: \ DOS \ COMM.l>.ND . COM
Error #3
PRINTER IS NOT READY
PROBLEM 1: Directory specifications are noi

entered correctly.
PROBLEM 2: The directory or
found.
SOL UTION: You have to keep the s::me data disk with program fi'es in the working disk drive umil the diagram is
generated. Put the old diskette in the default drive and try
again.
driv~ cannot be
SOLUT!ON: Use the Directory option in the File menu to

verify the directory and specification. t.:se the standard DOS
format to specify drive and path when you set the working
directory.
PROBLEM 1: You have changed diskettes after file

selection.
PROBLEM 2: Your data disk or directory is

damaged and DOS cannot access it.
SOLUTION: Try to restore your data files by copying from

your backup disk or using the Norton Utilities ora similar
program. If your files are on the hard disk, use DOS
CHKDSK (Check Disk) command to find out whether the
disk has been damaged.
12~ Error Messages and Warnings

Error Messages 12-7
t;-)
Error #6
MISSING HP laserJet FONr FILE
Error #8
PROBLEM 1.: The allCLEAR program dlrectory Is
misslng the system file speclfied In the e~ror message.
PROBLEM 2: allCLEAR cannot read the system file

specified In the error message.
SOLUTION: al!CLEAR provides a way 10 install HP LaserJet fonts without reinstailing the whole system. Find the
al!CLEAR distribution diskettes and, at the C:\ALLCLEAR
prompt, type:
SOLUT!ON: Try reinstalling allCLEAR from the beginning

using the INSTALL program. It is possib!e that the system
file has been accidentally de!eted or damaged.
PROBLEM 3: You have DOS version 4.x and it
denles access to the allCLEAR system file because
SHARE is not lnstalled.
SOLUT!ON: Insert the foilowing line into CONFIG.SYS

file:
INSTALL=C:\DOS4\SHARE.EXE,
HP INSTALL
Errors ~ #14
RESERVED FOR FUTURE USE'
Errors #15
SOL UT!ON : If allCLEAR stopped whi!e down!oading foms

to an HP LaserJet, it probably ran out of memory. Make
surc you have made the correct selection for HP Memory in
Setup. lt is also possib!e that your primer cable is damaged
and does not work for high-resolution graphics.
PROBLEM: Your script file contains a single Case

statement with more than 64 choices introduced
after it. allCLEAR limitation is exceeded .
SOL UTION: Remove sorne of the choices or use a nested

Case structure instead of a single Case. Another option is to
split the script file imo two and illustrate all the choices for
this Case with two diagrams.
PROBLEM 1.: Your printer ran out of paper while

allCLEAR was prlntlng a diagram.
PROBLEM 2: Your printer has reported an 1/0 error

while allCLEAR was downloading fonis or printing.
.;:,
MORE THAN 64 CHOICES FOR CASE
Error #7
SOLUT!ON: Put more paper in, set the primer ON-LINE,

and press (Q_] ro cominue priming. lf you want to abort
prin~ing, press @9.
l--'Enteri
al!CLEAR then takes you through a simple installation procedure.
where C:\DOS4 is you DOS directory. Then reboot your

computer and try again.
PROBLEM: You are trying to print to an HP LaserJet printer, which is NOT the printer you chose
when you lnstalled allCLEAR. All the fonts necessary for HP LaserJet printing are missing.
MORE THAN 128 BRANCHES FOR TREE S1RUCTURE
Errors #16
PROBLEM: Your script file contains a single Tree

structure with more than 128 branches introduced
after it. allCLEAR llmitation is exceeded.
SOLUTION: Remove sorne of the branches or use a nested

Tree structure instead of a single Tree. Another option is to
split the script file into two and illustrate ali the branches for
this Tree with two diagrams.
12-8 Error Messages and Warnings

Error Messages 129
Errors #17
DIAGRAM IS TOO BIG HORIZONTALLY
Errors #20
PROBLEM: Your scrfpt file contalns too many Pl'ocedures or trees whlch are not connectec:t to each
other. allCLEAR llmttation is exceec:tec:t.
SOLUTION: Check the script file carefully to make sure
that you indeed intend to have separare diagrams as opposed
to one diagram. For example, you might have neglected to
put in the main root of the tree which would join ali the tree
branches into one hierarchical s tructure. You should split the
script file into two or more in order to generare al! the
separare diagrams it describes.
Errors #18
1odi',1n1,.t.1,;t.1 11 1.pc.J.1:1Jrn ----.... ---
PROBLEM: Tite selected script file is ver y long and

tts dlagram Is too blg horlzontally to plot using the
memory available In your PC.
SOLUTION: E<lit the current Style Sheet to select a different
diagram style. Changing the style might be al! you need to
make the diagram smaller.
COMMENTS : Due to memory lim itations, al!CLEAR cannot generare a diagram which is more than approximately
256 symbols or 20 pages wide.
DIAGRAM IS TOO BIG
Errors #21
PROBLEM: Tite selected script file I~ i ..o big;

allCLEAR Is unable to offer the complete diagram
for your review.
SOLUT!ON: Edit the script file to make it shorter or split it
into two files which will generare two diagrams.
COMMENTS: Due to memory limitations, allCLEAR cannot generare a diagram which is wider then 256 boxes or 20
pages in the most compressed style.
INSUFFICIENT MEMORY TO PLOT FULL PAGE
Errors #22
Errors #19
PROBLEM: Part of the RAM available in your >(; i,;;

occupied by memory-t"esident programs d!'d
allCLEAR does not have enough memory to plot a
full page of the drawlng.
SOL UTION: If you are unwilling to clear the memory of the
memory-resident programs, you should decrease che page
size definition using the Setup ucility. If you have the
legal!wide page size selected, try generacing che diagram
with the leuer size.
12-10 Error Messages and Wamings

Enor Messages 12-11
Errors #23
Errors #26
PROBLEM 1.: You have lncorrectly Spec:.lfied the
drive or path for the Graphlcs Buffer.
PROBLEM 2: You have lncluded a subdlrectory In

the path for the Grapflics Buffer which does not
exist.
SOLUT!ON: Use the Setup utility (Buffers option) in order

to verify the path. You should use the standard DOS formar
for defining the path, e.g. C:\ALLCLEAR\TEMP.
W{'rjf\g.1#13[{\r [1).il9l/.J lg, 13 I!J:jil3d
PROBLEM :l.: You have incorrectly specified the

drive cr path for the File Buffer.
PROBLEM 2: You have lncluded a subdlrectory In

the path for the File Buffer which does not exist.
SOLUT!ON: Use the Setup utility (Buffers option) in order

to verify the path. You should use the standard DOS formar
for defining the path, e.g. C:\ALLCLEAR\FILES.
COMMENTS: allCLEAR has to have access to the File Buffer during diagrain ge.;eration if you chose to print to a
PRINT, PCX, PIC, or EPS file.
Errors #25
CANNOT ACCESS FONT RLE
PROBLEM: You have accidentally deleted or

darnaged the allCLEAR fonts located In the \FONTS
subdirectory of the allCLEAR system dlrectory
(C:\AUCLEAR\FONTS, for example).
SOLUT!ON: Find the al!CLEAR distribution diskettes and

reinstall aJJCLEAR from the beginning using the INSTALL
program.
PROBLEM 1: The free space avallable In your Rle

Buffer dlrectory Is lnsufflclent to create the output
dlagram files; allCLEAR abortad dlagram generation.
PROBLEM 2: allCLEAR cannot wrHe a dlagram file
to the Fiie Buffer dlrectory, for lt wlll exceed the
DOS llmltatlon on the number of files allowed per
single dlrectory.
SOLUTION: Check the File Buffer directory for the free

space available and either delete sorne files from it or select
a different buffer. al!CLEAR provide you with the information on the amount of space needed in the error message.
COMMENTS: allCLEAR has to have access to the Graphics

Buffer during diagram generation if the output device is set
to screen.
Errors #24
FILE BUFFER IS TOO SMALL
; ....
{lf
l.2-l.2 Error Messages and W-
arnings
Warnings l.2-13
Warnings
allCLEAR diagram generation warning messages are displayed in the status window, next to the word "Warning "
(Figure 12-2).
en
"S*J r~1
.. l
*?!!
DIZlm!ma
Waming#2
"-.....,L.
'?'
[D_ n-..
"" " '"""""
-J
Unlike errors, allCLEAR wamings are not fatal, i.e. having

acknowledged a warning, allCLEAR then proceeds to
produce the diagram as if there were no problems encountered. Following is the list of ali possible allCLEAR
wamings with explanations and instructions.
::fil!fiimif!J.!S.t.11112
ce
This warning can come up only when you are printing to a

PostScript printer or EPS file. It is reponing the fact that
you ha ve accidentally deleted thc f'S DRAW.DA T file from
the allCLEAR system directory. PSDRA W.DAT is a file
which can be used by advanced users to change the font used
for allCLEAR diagrams (refer to Chapter 11 for more information). When this situation happens, allCLEAR uses
PSDRA W.BATthe default font, Helvetica or number 4.
MISSING 'FllE llPFONTS.DAT
This warning can come up only when you are printing to an

HP LaserJet or compatible primer. It is reporting the fac t
that you have accidentally deleted the HPFONTS.DAT file
from the \HPFOl'ffS subdirectory of the al! CLEAR system
directory. HPFONTS.DAT is a fik which can be used by advanced users to control the process o downloading
al!CLEJ .R fonts to the HP LaserJet primer by changing the
starting font ID and defining the a!ICLEAR fonts to be permanent or temporary. When this situation happens,
alJCLEAR defines the fonts to be perrnanent (remain in the
memory after primer reset) and assigns the default font !Ds
(ID numbers 30,000 through 30,026).
Figure 12-2. al/CLEAR Warning Message Screen
Warning #1
This warning can come up only when you are printing to a

PostScript printer or EPS file. lt is reponing the fact that
you have edited the PSDRA W.DAT fil e to select a font
which is not available, ora font number higher that 10.
When this situation happens, a!ICLEAR uses the default font,
Helvetica or number 4.
Warning #3
e-
FONT .NOT AVAILABLE
Waming#4
PRINTER OUT OF PAPER
Your primer ran out :if paper while al!CLEAR was printing a
diagram. Add paper to the primer and press iF7l to continue
printing. If you want allCLEAR to abon printing, press [@.
Waming#5
EMPTYPAGE
The diagram page(s) you have selected to be printed are

empty. allCLEAR inforrns you of the empty page number(s)
in this warning. lf you chose not to print empty pages in the
Print Options menu, don 't be surprised when sorne of the
output pages (or files) will be missing.
lndex 1-1
lndex
A
y.
A4 paper size
AEDIT . . . .
All-Pages view
available keys
diagram keys
dot-matrix printer
generating . . .
page movement keys
purpose
squeeze keys
zoom keys
ASCII format
ASETUP . . .
Assignment of shapes
Attach to file
Auto
detect script format
HP fonts download
text
AUTOEXEC.BAT
PATH definition
PRINT installation
8-15
. 2-6
6-17
6-13
6-14
3-15, 6-12
6-15
6-12
6-15
6-14
. 5-5, 9-10
. 1-7
8-13
8-18
. 5-5, 9-10
7-5, 11-23
8-10
. 2-8
7-10
B
Background printing
Basic
concepts . .
operating guidelines
Batch file d iagrams
BATCHART
Block lines
Borders
Box
shapes
size
. 7-9
. 4-3
4-14
.11-17
.11-17
9-14
8-16
8-12
8-11
Browse file
Buffers
file
graphics
initial default
Buzz
. . . 3-7, 5-7
7-9, 7-12, 9-13
. . . 9-12
2-4, 9-12
. . . 9-10
e
Case shape
Changing directory
Characters per line
Choice shape
Color . . . . . .
COM.BAT . . . .
COMMAND.COM
Compressed printing
CR/ LF . .
Create file
Cursor keys
Custom paper size
.8-12
5-6
.9-14
.8-12
.9-13
9-7
9-3, 9-12
. 5-11, 9-14
9-7
5-8
.4-17
. 8-15
D
Decision Tree
definition
styies
Defaults
buffers
buzz
directory
PostScri pt font
script format .
starting font ID
style sheet
zoom leve! . .
Diagram
All-Pages view
cho ices
4-5
8-9
2-4
. 9-10
2-9, 9-10
. . 1 2-12
.. . 9-10
1 1-24, 12-13
5-8
. . . . 9-9
.3-15, 6-12
. . . . 8-14
12 lndex
lndex 1-3
Decision Tree
. . 4-5, 8-9
file output
. . . . 7-3
Print Preview
3-20, 6-19
printing . .
. 3-21, 7-3
Procedure
.4-3, 8-7
Scroll view
. 3-8, 6-4
style
. . . 8-6
title
. . 8-14
Tree
. 4-5, 8-8
type
. 4-3, 8-6
viewing
. 3-8, 6-3
Walk-Through view
. 3-12, 6-8
Diagramming
batch files
.11-17
directories
.11-20
Lotus files
. 11-3
outlines
.11-14
Oip switches
. . 9-7
DIRCHART .
.11-20
Directory
changing
. . 5-6
default
. 2-9, 5-6, 9-10
overwriting default
.2-9, 5-6
tree after installation
. . 2-4
tree::. diagramming
. . 11-20
DOS
access to COMMAND.COM 9-3, 9-12
batch files ..
.11-17
directory trees
.11-20
PATH command
. 2-8
PRINT command
. . 7-9
Double sides
. 8-15
Download fonts
2-10, 7-5, 11-22
E
Edit
file . . ..
Style Sheet
. . . . . 5-7
. 8-3
Editor
AEOIT .. ...
installing
. . .
memory-resident
specifying
using . .
EDWIN .. .
Empty pages
End on page
End shape
Environment
configuration
problems
EPS file
. . .
Errors .. ..
European paper size
Exiting al!CLEAR
Externa! programs
running
specifying . . .
. 2-6
. 2-7
. 10-6
5-7, 9-11
5-7
2-6
7-5
7-5
.8-12
. 9-4
.1(). 7
.7-11
.4-15, 12-3
. 8-15
.3-22
G
Get default style
Graphics buffer
Graphics card .
Graphics file output
. 9-3
_-g.11
.4-12
Help
. . ... . .
Horizontal squeeze
HP fonts
HPFONTS.DAT .
HPREMOVE. BAT
HPSEND.BAT
F
Fast keys
File
buffer
creating
editing
EPS
format
menu
output to
PCX
PIC
print
PRN
selecting
Style Sheet
FlLES subdirectory
Fit on one page
Font
choices
...... . .
. 8-14
download . . .. . . . .
. 2-10
.11-23
download for HP LaserJet
8-10
symbol text
ti ti e
8-14
Formatter
5-12
backup file
indent
9-14
. . . . . . . . 5-12
using . . .
Function keys
. 4-20, 6-3, 8-18, 9-4
.9-13
3-22, 58
. . . 5-7
. . . 7-11
5-5, 5-12
. 5-3
.7-11
. 7-11
. 7-11
.5-10
. 7-9
. 3-5, 5-4
4-9, 8-18
2-4
. . . 7-4
lf shape
lndent
lnitialize printer
lnstalling al!CLEAR
lnvoking al!CLEAR
8-20
9-12
9-13
7-11
. 3-4, 4-15
. . . 6-15
. . . 11-22
. 11-24, 12-12
.11-24
. . . . . 11-23
8-12
9-14
. 7-5
. 2-4
. 2-9
K
Keys
cursor
function
other .
4-17
4-20
4-21
L
Landscape
Legal paper size
Letter paper size
Une numbers . .
Linear statements
Unes per page .
Load Style Sheet .
Logic lines . . . .
Logical statements
Loop shape
Lotus script format
. 8-14
.8-15
.8-15
.9-15
. 4-3
. 9-14
. 8-19
.9-14
. 4-3
.8-12
. 11-3
M
. . . . 4-12
Main Menu
Managing
. 7-5, 11-22
font download
script files .
. . . . 5-3
. . . . 8-19
Style Sheets .
8-16-8-17
Margins
.4-11
Menu command system
.9-10
, Microsoft Word script format
.9-13
Monitor
. . .... ... .
N
New file
creating
style sheet
3-23, 5-8
. 5-8- 5-9
o
On-line help
On-line printer test
Operating guidelines
Orientation
Other fonts .
OUTCHART .
Outline trees
Output port .
.4-15
. 9-7
. 4-14
. 8-14
.8-13
. 11-14
. 11-14
. 2-7, 96
1-4 lndex
- -
lndax 1-5
J
Output to
EPS file
PCX file
PIC . . .
PRINT file
printer
7-11
7-11
7-11
. 7-9
. 7-4
p
Page layout
8-14
Paging ..
8-16
Paper Size
options .
8-15
redefine
. 8-15, 9-8
PATH
access to COMMAND.COM
9-12
editor
..... .
9-11
publisher . . . . .
9-12
setting for allCLEAR
. 2-8
Pause between pages
. 7-5
PCX file
7-11
PIC file
7-11
Port . .
. 9-7
Portrait
8-14
PostScript
file . .
7-11
fonts .
. 12-12
printer
. 7-4
Print
abort .
. 7-5
file . .
5-10
fit on one page
. 7-4
menu
..
. 7-3
options . .
. 7-4
to EPS file
7-11
to file
..
. 7-9
to PCX file
7-11
to PIC file
7-11
to printer .
. 7-4
Print empty pages
. 7-5
....._
Print Preview view

available keys
generating
page keys
purpose
scroll keys
Print utility
block lines
characters per line
compressed
indent . . . .
line numbers
lines per page
settings
using
Printer
CR/LF
download fonts
driver ..
installing
memory
output port
printer test
Procedure diagram
definition
style . . .
PSDRAW.DAT
Publisher
running
specifying
..
file buffer
file print
..
graphics buffer
graphics card
memory
monitor
printer
printer test
running . .
script format
table of paper sizes
Requirements
equipment
software
Run
menu
Publisher
setup
. . . . 6-20
.3-19, 6-19
.6-20
.6-19
. 6-20
.9-14
. 9-14
. 5-11
. 9-14
. 9-15
.9-14
.5-11
.5-10
. 9-7
. 11-22
9-6
. . 2-7
. . 9-8
. 2-7, 9-6
9-7
4-3
8-7
. 12-13
. 7-12
.9-12
.. . . . . . . . . . . . . . 3-24
R
RAM Disk ..
Reconfiguration
CR/ LF .
directory . .
.9-13
1
. 9-7
.9-10
. 2-3
- 2-3
. 9-3
. 7-12, 9-3
. . . . 9-4
-S
Q
Quit
9-13
9-14
9-12
9-13
. 9-8
9-13
. 9-6
. 9-7
. 9-4
9-10
. 9-8
1
1
Sample session . . .
SAMPLES subdirectory
Save
as default
squeeze
Style Sheet
Scale to fit on- one page
Script file
create
definition
edit ..
format
Lotus format
print . .
select
Scroll view
available keys
diagram keys
generating
. 3-3
. 2-4
8-20
6-18
. 5-9, 8-18
. 7-4
. 5-8
. 4-8
. ':5-7
5-12, 9-10
11-3
5-10
. 5-4
. 6-6
. 6-6
.3-8, 6-4
purpose
scroll keys
zoom keys
zoom level
Setting the PATH
Setup
block lines . .
buzz . . . . .
characters per line
CR/LF .
directory .
editor ..
file buffer
graphics buffer
graphics card
indent . . . .
line numbers
lines per page
memory
monitor
options
printer .
printer test
publisher
"Ulining . .
script form at
table of paper sizes
zoom level
Shading . .
Sides
...
Single sides
Size
font
paper
symbol
Speed considerations
Squeeze
purpose
save
undo
6-4
6-4
6-4
6-4
2-8
.9-14
.9-10
.9-14
. 9-7
.9-10
.9-11
.9-13
. 9-12
.9-13
.9-14
.9-14
.9-14
. 9-8
.9-13
9-6
. 9-6
. 9-7
.9-12
. 9-4
.9-10
. 9-8
. 9-9
.8-12
.8-15
.8-15
.8-10
.8-15
. 8-11
.10-5
.6-15
.6-18
.6-17
--"-1"'-.. ~-.&.c ~---
,_..,j
1-6 lndex
Start on page . .
Start shape .. .
Starting allCLEAR
Statement
linear
logical
shape
Status screen
Stop shape
Style
diagram
menu
Sheet
Styl~ Sheet
assign to file
attach to file
borde; ...
box shapes .
choices font
copy ..
default
definition
edit ..
file . . .
for new file
get default
layout
load
margins
menu
narn<;
options
page orientation
paging
paper size ..
save . . . . .
save as default
sides . .
start on
. . .
..
. 7-5
8-12
. 2-9
. 4-3
. 4-3
8-12
. 3-9
8-12
. 8-6
. 8-3
4-9, 8-3, 8-6
. 5-9
8-18
8-16
8-12
8-14
8-19
8-20
. 4-9
. 8-4
. 4-9, 8-18
. 5-8
8-20
. 8-4
8-19
8-17
. 8-3
. 5-9
.4-9, 8-6
8-14
8-16
8-15
8-18
8-20
8-15
8-15
symbol font
symbol size
symbol text
title font . .
Symbol
box shapes
font
size
text
System
limitations
requirements
.8-10
.8-11
.8-10
.8-14
. 12-7
. 2-3
2-6
5-7, 9-11
. 5-7
.8-14
.3-12
-:.. .
'i'
. 11
~
lj.
'
"
!.
.
'
4-5
8-8
3-1
. 4-3, 8-6
. . . 4-21
V
VDISK . . . . .
Vertical squeeze
Yiewing diagrams
All-Pages view
function keys
Print Preview .
Scroll view . .
Walk-Through view
~{
9-8
2-4
.9-13
.6-15
. 3-15, 6-12
. . . . 6-3
.3-19, 6-19
. 3-8, 6-4
. 3-12, 6-8
. . . . . . . . . 9-13
. 8-12
.8-10
. 8-11
. 8-10
T
Table of paper sizes
TEMP subdirectory
Text Editor
installing
specifying
using ..
Titi e . . ..
Tracing the diagram
Tree diagram
definition
Style . . .
Tutorial .. .
Type of diagram
Typewriter keys
Virtual memory
Walk-Through view
available keys . . ..
branching statements .
cursor movement keys
diagram keys
generating
logical trace
purpose
undo key .
zoom keys
zoom level
Warnings ..
Wide paper size
WK? script files
Word Perfect script format
Word Processor
..
installing
.5-7,
specifying
using . .
Word wrap
'NYSIWYG
;
. . . 6-10
. 3-13, 6-9
. . . . 6-9
. . . 6-10
. 3-12. 6-8
. . . . 6-9
. . . . 6-8
3-14, 6-10
. 6-10
. . 6-8
.12-12
. 8-15
9-10, 11-3
. . 9-10
. . . 2-6
9-10 . 9-11
. . . . 5-7
. . . 8-10
3-20, 6-19
z
Zoom level
. . .. . . . . . . 6-4. 9-9
..

AllClear User's Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

AllClear User's Guide

Uploaded by

Copyright:

Available Formats

,IP

Viewing allCLEAR Diagrams

Worklng wlth the Style Sheet

Runnlng Extemals from allCLEAR

Most Common Questions and Problems

Error Messages and Wamlngs

What Does allCLEAR Do?

It is a well known fact that people understand pictures better

To illustrate your ideas:

Enter the information in question (using your favorite Text

Who Can Use allCLEAR? 15

Who Can Use allCLEAR?

What Is in the Package? 1-7

What Is in the Package?

allCLEAR Program - the main component of the package

ASETUP Program - the environment reconfiguration utility

Other Programs - the text editor, called AEDIT, which

Fonts - different fonts al!CLEAR uses for diagram display

Sample Files - severa! sample script (*.ACL) files and their

User's Guide - the user manual which exp!ains how to use

Language Manual - the language reference guide which

Registration Card - a card which you should fill out and

organlzatlon of the User's Gulde 1-9

Organization of the User's Guide

Chapter 11, ADVANCED FEATURES

The allCLEAR User's Guide is organized into twelve chapters:

Chapter 12, ERROR MESSAGES AND WARNINGS

Chapter 3, SAMPLE SESSION

The fo!lowing conventions are u sed throughout the User' s

Keys - the actual key you should press is indicated by the

Commands - the actual command you shouid enter is always

Important Notes - the comments, instructions, or wamings

CLEAR SOFfWARE, INC.

Chapter 10, MOST COMMON QUEST!ONS AND

2-2 Gettlng Started

What Do You Need to Run allCLEAR? 2-3

What Do You Need to Run allCLEAR?

You need the following equipment to run a!lCLEAR:

A hard (or fixed) disk drive on the PC on which the

512K bytes or more of available memory; 640K byte RAM

A COA, EGA, VGA, or Hercules graphics card.

IMPORTANT: lf you have an HP LaserJet printer, please

You also need the following software to run allCLEAR:

DOS version 3.0 or later.

If you don't want to use the editor provided with a!lCLEAR

2-4 Gettlng Started

What Does the INSTALL Program Do? 25

What Does the INSTALL Program Do?

Unarchive the allCLEAR program files and copy them onto

Customize the al!CLEAR configuration file to your edito.,

Unarchive and copy fonts.

Unarchive and copy sample files.

yoor root diedor whlch

C:\OOS and C:\...

your DOS and other

detloed as desUnation tor

Unarchive and copy rniscellaneous extra programs.

Figure 2-1. Directory Tree After a//CLEAR lnstallation

Befare installing aJ!CLEAR, please prepare the answers to

What is the printer connected to your PC?

To which output port is the printer connected?

a- IMPORTANT: a\ICLEAR inserts the parameter alter the

1. Put the diskette labelled allCLEAR Disk #1 in your floppy

;:-l:: 1 :!:-..:~.~t:""u.~~. . 4.,.;