- AllClear User's Guide

-,IP Ir (

.,, - --,,;.,, .- '"

; ....

f t

~

J

\xicJ _ N ( \J \ .~'v .

1

l -- -- 1 1

Table of Contents Chapter 1:

Chapter 2:

Chapter 3:

Chapter 4:

Chapter 5:

.f .? ?) ~;~

: -... ~ -... ;- -- ..... -

lntroduction _ . . . . What Does allCLEAR Do? Who Can Use allCLEAR? . What Is in the Package? .

- Organization of the User's Guide Getting Started . . . . . . What Do You Need to Run allCLEA~? What Does the INSTALL Program Do? lnstalling allCLEAR Setting the PATH Starting allCLEAR 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 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 -

-- __,..;;.. ~ ..,_ '

- 1

. .

- -

111 . 1-3 . 1-4 ' 1-6 . 1-7 . 2-1 . 2-3 . 2-4 . 2-6 . 2-8 . 2-9

. 3-1

. 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

llf? fJr c/3~ -IJtt'

lv Table of Contents

Chapter 6:

Chapter 7:

Chapter 8:

Chapter 9:

Chapter 10:

Chapter 11:

Chapter 12:

lndex

Viewing allCLEAR Diagrams The View Menu . . . . . . . Scrolling the Diagram . . . . Walking Through the Diagram Preparing the Diagram for Print Page Previewing . . . . . . . Printing allCLEAR Diagrams The Print Menu Printer Output . . . . . . . . PRINT File Output . . . . . . PCX, PIC, and EPS File Output Worklng wlth the Style Sheet The Style Menu . . . . . Modifying the Style Sheet Style Sheet Options . . . Saving the Style Sheet Managing the Style Sheets Runnlng Extemals from allCLEAR The Run Menu . . . . . . . . . . Reconfiguring allCLEAR Environment Setup Options . . . . . . . . . . . Most Common Questions and Problems How Do l. .. . .. . . What Do 1 Do Jf. .. . . . . . Advanced Features . . . . Using allCLEAR with Lotus 123 Diagramming Outlines . . . . Diagramming DOS Batch Files Diagramming DOS Directories Managing HP Fonts . . . . . Error Messages and Wamlngs Error Messages Warnings

. 6-1

. 6-3

. 6-4

. 6-8 6-12 6-19 . 71 . 7-3 . 7-4 . 7-9 7-11 . 8-1 . 8-3 . 8-4 . 8-6 8-18 8-19 . 9-1 . 9-3 . 9-4 . 9-6 10-1 10-3 10-6 11-1 11-3

.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 U ser' s Guide.

12 lntroeluctlon

Chapter Contents What Does allCLEAR Do? Who Can Use allCLEAR? . . . . What Is in the Package? . . . . Organization of the User's Guide

. 1-3 . 1-5

1-7 . 1-8

What Does allCLEAR Do? 13

What Does allCLEAR Do? It is a well known fact that people understand pictures better than words. That is why at the most critica! points of an ex-planation or presentation we usually rely on pictures. How-ever, 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 informa-tion, 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 cur-sor, print preview all the diagram pages, and print the cliagram to the printer or file.

1-4 lntroductlon

'

3. Just like a desk-top publishing system uses a style sheet to for-mar 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 il-lustrations. 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 auto-matically creares a new set of diagrams. allCLEAR illustra-tiou, are always up-to-date.

Thus, in a matter of minutes, a!ICLEAR helps you convert any information into professional quality graphical illustra-tions. These diagrams can be presented alone or in combina-tion 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? 15

Who Can Use allCLEAR? a!ICLEAR can be used by anyone who has access to a Per-sonal 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 proce-dures 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 in-structions 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 effec-tive cornrnunications with the end users.

Programmers can outline their prograrns in the allCLEAR script lan-guage and use the diagrarns for approval by managers and better comrnunication with the other team members.

' ;,,

,.

~ ......

1-4J lntroduction

-

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 or-ders (for order clerks).

Before using al!CLEAR, you should be familiar with DOS and the concepts of a file system, including files and direc-tories. 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? 1-7

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 pro-gram, 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

Organization of the User's Guide The allCLEAR User's Guide is organized into twelve chap-ters:

Chapter 2, GE1TING STARTED provides basic instructions on how to instaII and start allCLEAR.

Chapter 3, SAMPLE SESSION is a tutorial which illustrates the basic capabilities of allCLEAR and may be !he only instruction you will re-quire.

Chapter 4, al/CLEAR BASICS introduces the basic concepts and explains the basic operating principies of alICLEAR, including the com-mand 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.

Chapter 10, MOST COMMON QUEST!ONS AND PROBLEMS

provides answers to the most common "How Do I?" and "What Do I Do If?" questions.

organlzatlon of the User's Gulde 1-9

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.

Chapter 12, ERROR MESSAGES AND WARNINGS Iists allCLEAR error and warning messages (related to diagrarn generation) with their explanations and correc-tions.

The fo!lowing conventions are u sed throughout the U ser' 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.

1> T asks - 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> Steps - the steps you should take in order to follow a par-ticular 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 "IMPORT ANT". 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 SOFfW ARE, INC. P.O. Box 909 Brookline, MA 02146

. ....

~ ........, ~ -

2-2 Gettlng Started

Chapter Contents What Do You Need to Run allCLEAR? What Does the INSTALL Program Do? lnsta//ing a//CLEAR Setting the PATH Starting a//CLEAR

. 2-3

. 2-4 . 2-6 . 2-8 . 2-9

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:

1> An IBM PC, PC/XT, PC/AT, PS(2, or 100% compatible per-sonal computer.

1> 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 dot-

matrix 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? 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 INST ALL program does the fol!owing things automat-ically:

"' 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. "' 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 repre-sentation of these directories in the "tree" structure (using a hypothetical system as an example).

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

e' yoor root diedor whlch contalns

AL!TOEXEC.BAT.

C~WP C:\OOS and C:\. .. your DOS and other

ditectories whld'I exist on )'OYI' system.

C:\ALLCLEAR concalns the maln and $upportino aBCLEAR

program tues. ~~~~~

C:\ALLCLEAR\FONTS contains saeen and

harocopy lonts. I

C'.\ALLCLEAR\SA.MPLES contains .ACL and STY

tiles osed Curingttle s.arrple sessk>n.

.. \SAMPLES\TUTOAIAL contains .ACL and .STY

riles osed during the language tutoal.

your system.

C:'ALLCLEAA\FILES detloed as desUnation tor

al!CLEAA file OUl)Ul

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

C:\ALLCLEAA\TEMP delined as temporary

;;irao11k:st,uHarfor dtagr

,~

2~ Gettlng Started

lnstalling allCLEAR

...

...

...

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? What is the printer connected to your PC? To which output port is the printer connected?

To install allCLEAR:

1. Put the diskette labelled allCLEAR Disk #1 in your floppy drive (we wi!I call this drive SOURCE). 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:

2. Type: A : i.i Enter) This will make A: (SOURCE) the curren! or logged drive.

3. Decide where on the hard disk you are going to put the allCLEAR prograrn files (we will call this drive and direc-tory DESTINATION). 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.

4. Be gin the INST ALL 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.

lnstalling allCLEAR 27

5. 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. As an example, let's assume that you want to use Word Per-fectas the editor and that it is located in the C:\WP direc-tory. Then you should type: C:::: \ WP \ WP i--'Enterj

a- IMPORTANT: a\ICLEAR inserts the parameter alter the editor's name to always invoke the editor with the currently se-lected 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 defini-tion string.

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 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.

The last step is to specify the output ;ort for the printer you have just selected.

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 con-figures the Graphics and File buffer directories to be the TEMP and FILES subdirectories of the a!ICLEAR program direc-tory. 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

Setting the PATH

Create a new file ealled AUTOEXEC.BAT in !he

l'OO! directory.

T:.is file should contain "PATH-C:\ALLCLEAA".

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 Fig-ure 2-2 step-by-step to set the PATH for a!ICLEAR.

To set the PATH for allCLEAR:

Go to ft\-:J root directory of your is==Check

Add ";C:\ALLCLEAFr at the end of thal line.

No

Add a new line to AUTOEXEC.BAT

"PATH-C:\ALLCLEAR".

Figure 2-2. Setting the PATH for al/CLEAR

Starting allCLEAR 2-9

Starting allCLEAR You can start a!ICLEAR using the fol!owing seven different methods: METHOD 1:

_Change directory to C:\ALLCLEAR and type: A i..iEnterl

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: 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.

METHOD3: From any directory type: C:\ALLCLEAR\A ~Enteri ~llCLEAR 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.

i ~

210 Gettlng Started

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 C:\ALLCLEAR\SAMPLES\* .ACL for that session.

METHOD6: Type:

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 cur-ren! directory will be set to C:\ALLCLEAR\SAMPLES\* .ACL for that session.

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 .

fu>

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.

. "-~ ... -.--~--- -~---.-''"" ~-- . -~ .. ~ .... ""-'- .. -~ ......... _,_,.,,$~ ... --....... -..-.- , .................. ,.,_, __ , -~ ... ;.,.-.. .... ~. --.,,,.~..._,_ .... ..,..._, --""'"' ., .... ,. ,.. . --.:-""-~--~ _._.__

-3-2 Sample Sesslon

Chapter Contents 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-3

. 34

. 3-5

. 3-7

. 3-8 3-12 3-15 3-21 3-22

To Begin

To Begln 3-3

w IMPORTANT: The instructions in this chapter assume that you have successfully completed the al!CLEAR installation pro-cedure, 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 ex-

ample, from !he DOS prompt type:

C: \ALLCLEAR tJEnterJ 2. Type:

A l~EnterJ allCLEAR displays the introductory screen and enters h;; menus.

., ~ -

3-4 Sample Sesslon

Getting Help allCLEAR includes a context-sensitive help facility to pro-vide you with information and reminders. This help feature is keyed to the location of the cursor, and consists of two dif-ferent parts: 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.

! S..!..,l a -: .. 1,-t fil tor allct.1'.AJI acrtlo- ___ ___j Figure 3-1. The On-Line Help

The help screen (Figure 3-2) which you can access at any point in a!ICLEAR opera-tions 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 . ,, ?E*'" '"'Y' 1

llIIZll:'.!l ;p4rn;. & TllP FILE - ... u-. - t

3-6 Sample Sesslon

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 dis-played 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 3-7

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 com-mands familiar to you.

tt..lleJNtl..,t.',..._,..At..otllolrlll.

~~ ;:-l:: 1 ~~:!:-..:~.~t:""u.~~ ... 4.,.; Is t."1 r ... u,. ...... tnottvlMI 1'011C'J1

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 1ui.111t~?

TU p.rM" 1s ~. (1'o) Tloil~ftla""tce....-..1.,IU...rtaMc:t..r-'saU~t.

'!"' '""' , ....

-._

----IL,_----.- 3-8 Sample Sesslon

Displaying the Diagram 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. Press EJ ro activare the View menu (assuming you are still in the File menu).

al!CLEAR dispiays the pull-down menu with the available Yiew options (Figure 3-6).

nn "'" , llti. : ltsl-t,.,. 18 ,.\nls L_ i..u.1. : Hel ... ttc.a 1 l"Olnt

S'milOL "*"llJM)(ff : Hel....ilc.. ,,..lnh

Tn '"'"JO si,.. =-11

~,.., , ... -ASSI'1tmfror~ St..u..nt: ....,la"fi Ir : ,,_,,.. ea- ' .. _,.,, Chotcn : tra~1' t..o, ' 111,... St..rt : ,....u,..,. t"" :,.1,u,......1i.1.,.._

0.-1.,,t.u ... : ,.. .. t ... ll ,..,,. .. u,..: hu .... s1u. : "--1 SlartO.. : rt,lllpap ,..,.,..,. ; H 1o....i..,.... ,.,. ___ ,.,.llC"{l'U i..tt ' .zs , ... ...., .t1,11t : l.2S lncicn r.,. : e.se lncu. lot.t- : l.ZStnca..

Dlqila'llthdl"'"nt.'1irse.....,,,Scroll...:icl

Figure 3-6. The View Menu

m ....

ll!I "" IEI St11 l

~ """'" lllfi r..,,1.

; Q 1 .!

2. 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. These sreps direcr aIICLEAR to generare the diagram of the selected scripr file ro screen and display it in the Scroll view. 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) .

.. ---- -~--- ---~-~-~- ------... ~ .. ------ - -.. .!f'. '.: ~.

Displaying the Diagram 3-9

:l Dlsple.,.tllel"V'l"""t"-acrw." lns.: .... 11-de

Figure 3-7. The Rle Processing Status Screen

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 ter-mometer-like gauge (Figure 3-8).

Sl,lo.st..t: COUDID. STV

'r

3-10 Sample Session

"'

Rgure 3-9. Sample Diagram in Sera// View

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 EJ again to zoom in even further.

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.

~ ~~

Dlsplaylng the Dlagram 3-11

e::..;:~;::;::~:

C:..t ,,.. _ ........ , ......

.. .._ ......... ...._.... ..

-------/ .::~.~: ~ ..... .. 11cvJool:

8 Rgure 3-10. Sample Diagram Zoomed In

4. Use [J. [[], EJ. EJ. ~. ~. !Homel, and ~ to scroll the diagrarn. 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.

5. Press ~ to exit diagram display and get back to the menu.

1 ......, _ -, -

3-12 Sample Session

Walking Through the Diagram You are now ready to see another diagram view, called Walk-Through. As suggested by its name, the Walk-Through view allows you to step through the diagram displayed on the screen.

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 in-side the first box and displays the contents of this box at the top of !he screen (Figure 3-11 ).

~ - nt. "~ an

3-14 Sample Session

5.

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. In sorne cases, you may wish to go back to the previous posi-tion, or undo the last step.

Press [QJ to undo the previous logical step. 6. When you finish experimenting with walking through the

diagram, press ~ to exit diagram display and get back to the menu.

? Preparing the Dlagram for Print 3-15

Preparing the Diagram for Print 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.

/ 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 bet-tc in tcnns ol ;pace: consumption 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

3-16 Sample Session

In order to change any of the diagram and page layout at-tributes, 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).

Sl'lll Shnt.: COUDD.ST't 1 DI .....

______ .,,.."""'

11~_,.. nu. '""11 ... .1ca 1s,.1fttsllm Lakls : lt!JlueUca a ,.l,.UI: idll

---!-----""'""""' e ",.1..ta .. _ si...1.1.., , ... -ltSSIQll"lll'l"tOfs:tn:S

Sht-=~"'91 ir :.u-'"" ~- ; ......,. .. e.Mices :tra-14 l.o : lllpse Start. :,...,.u."!li '""' ' f" l f'-~,....11.1._

Orl....U.t.loJI: ,..-t,.ait.. ,,,_.s1a: Jau .... SI"'" : -.....ta st.art.0. 1 .. 1,hlps-

'"'I"' ........

..........

: ~ ll'lcion RlsJit : S.Z51~ Top : 1.58\nc.M'I: let""" :1.ZSl-

!>elect. di~.- Sl'lll" sl'lllft art..:1. U.e 41!1"" dl'C enl'll

Figure 3-14. Editing the Style Sheet

'1oll ""'""' EIP hs:1l

Q ~11

5. 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 All-Pages option. However, let's take a shortcut.

6. Press 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.

7.

Preparlng the Dlagram for Prlnt 3-17

A

l'lmm!I

Figure 3-15. Sample Diagram with Style Four

You can see that with style faur the diagram becomes wide. In this case it makes sense to choose !andscape page orienta-tion (rather than currently selected portrait). 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.

8. 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

nmllmJI

Agure 3-16. Sample Diagram with Landscape Orii:ntation

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.

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. Y ou 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 ~~

"

Preparing the Diagram for Print 3-19

~ ~ - ~

i"r.~ 1

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 releas-ing it, JTab~I to display the next page to the left of the current page.

12. When you finish looking at the pages, press O to zoom out and see the complete picture again. The All-Pages view is mostly intended for ch-J

3-20 Sample Session

14. Press ~ to access the menus. Se!ect the Print Preview op-tion of the Vicw menu.

15.

allCLEAR displays the first page in its actual size, without scaling it to fit on the screen (Figure 3-18).

Is the Patient Covered? 1

Ge1neo;;i11rrrsn;rn1 an:!Oilo1D'tf\

Geine1x:ihCJflQloers flilmlan11"U:ltlr'

l r~-----~" l

- ' ,ftBlmll

Figure 3-18. Print Preview of the Sample Diagram

Use the cursor keys to scroll and see more of th~ !Jage. Y ou 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.

Printing the Diagram 321

Printing the Diagram The instructions below assume that you have previously con-figured allCLEAR to use the correct printer driver. Printer driver installation is a part of the al!CLEAR installation pro-cedure.

To pnt the diagram: 1. Select the Printer option from the Print menu ar press (0.

2.

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 wn;tWm-m

~.,JF,;! D.1:f'i

,,..

~~ FnL t ... t.

"~ s,_1.., -ASS1'"1t Slat..o.ni: Ir : 41

' ..

~ :;:!;"~~ .. ~ '""' .. !..t Pr111t f'.tq>l't P9i_"';,- .- ," .., Rr=l f'rinln> . .......

Dounlo.d l"ont~ .....

ID - OK al/ - U\t. ID - Qull Cholcni ..... ,..,.,

:tr~Ol

-3-22 Sample Session

What Is Next 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.

You should continue with another tutora] found in the separate Language Manual to get an introduction to the aJICLEAR scrpt language.

The al!CLEAR language tutora] uses the sample scrpt files located in the \TUTORIAL subdirectory of the \ALLCLEAR\SAMPLES directory.

rr-0 qr. rim 1n6flN!!t?i e fufo 41111111 1. Select thc Select option of the File menu.

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. 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

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 ru to enter the Editor directly from diagrarn display and make changes to the script.

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.

To exit allCLEAR: 1. Select the Quit option of the main menu.

Chapter 4: allCLEAR Basics

This chapter presents an overview of allCLEAR basic concepts and provides general operating guidelines for using the allCLEAR command system.

4-2 allCLEAR Baslcs

Chapter Contents allCLEAR Diagrams Script Files . . The Style Sheet . . allCLEAR Menus . . . . . . . . Basic Operating Guidelines On-line Help and Error Messages allCLEAR Keys

. 4-3

. 4-8

. 4-9 4-11 4-14 4-15 4-17

allCLEAR Diagrams 4-3

allCLEAR Diagrams 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. 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 ex-arnple, "Enter total income on line #24. ").

1> 2. Decisions which have to be made in the course of the pro-cedure (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 "branch-ing" . These are the staternents which necessitate script sym-bols and block structures, such as?- (c hoi c e) -?end , in the allCLEAR script language.

~ . .

4-4 allClEAR Basics

What to Do lf the Engine Overheats

No ~ l.::=.J

\ .. .,,:, .. \ [,,--__. Adcoolantto!he

rvs.t

4-6 allCLEAR Basics

OEVELOPMENT VICe Presk!ent

Mr. Richard JacobsOn

ENGINEEAING Director

Jashua Blrmingham

NEW PROOUCTS

~r::?r ..

PAOOUCT SUPPORT

~~

CUST0"'4ER SUPPORT Mana99f

Matk Rvers

OUAU1Y ASSURANCE

~"~:fers

Organizational Chart of a Software Company

SOFTWARE GENERAL INCORPORA TEO

President Mr. John L!vinlhal

FlNANCE & SUPPORT VicPresidem. ot Finance

Mr. Eric L.Mngston

FINANCEIACCOUNTING Controilet

BurtStn.11'19

EMPLOYEE AELATIONS Personnel Manaqer

Margare! Trainer

OFFICE OPERA TIONS Manager

Usa Mor~

MARKETING Vice President

Cwight Blackstone

.A.OVERTISING Oirector

sm Stratnmore

TELEMARKETING M.anager

Ern.tt Fraser

PAESS AELATIC>W; Director

Char!-e Ch2p

MARKET RESEAACH Director

Loi.s Traughbien

Figure 4-2. Sampte Tree Oiagram

SALES VQ Presidenl Oa\11dCarter

NATIONAL ACCOUNTS

Kei~K~W~ton

!NTERNAT10NAL ACCOUNTS

Manaoe< Arme Dewar

RETAIL & OISTAIBUTK)N .:~~~le

i ~" ~1~ ~

~':f ~~:

Oiscusslamily tlistory.

Test tO ~lhll prt>lem.

0.!1Wm1ne lhll t>icst b'N tment strateqy.

T1.eattheproblern svrgically 0tmedcally.

Figure 4-3. Sample Decision Tree

New Patient's Visit

/ NFN PATlaIT 1

v .. NO

allCLEAR Dlagrams 4-7

Counseilhe~lienl

Proo. benavlOf rad .._....,..

Plan future monitorino and lrllllmtnt.

EncouraQt! more rnlistic ell.C)el:tabOns.

Explof~ possi ps)"d"IQlogcat prooklrr..

4-8 allCLEAR Basics

Script Files An a!ICLEAR script file is the file which holds the descrip-tion of an al!CLEAR diagram in the allCLEAR script lan-guage. This file looks pretty much like a regular English text document oran outline. However, a script file also con-tains 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 informa-tion 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

('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.

?end ?end -dea ler

Is it below t.he "LOW" l lne7 (Yes) Add coo lant. to the reseruoir and radf4tor.

>check CHo) >dea ler

?end

Br i ng your cor to the dca lcr.

Figure 4-4. Sampfe Script File

,,

The Style Sheet 4-9

The Style Sheet The Style Sheet is an allCLEAR file which holds informa-tion 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 desk-top 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 deter-mines 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 im-portance 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: ~ 11 m "" Da St\lh

QI 1 ci.....,.

::i:: I' h:i!l l t o e

~~ 1

l 1H~1e : {j;":" ._ [!~~. ;:::S~ 1: :::~~: --- S"'"BOL ra: UIYO\IT ---

r ... t : Ho:l lt SI"'" ' '--bl

~ShMll..., : on Stultm : r t,i.l r!! llSS!Clll'liltt OF SHMCS P.,1.., : " :;"-"':~:::::::: ,,, .... ~ ' ;,::,..,,._

ea- : hJt&''"' ten : S . ZS Lnckn ClHCfll : tr~. l

4-10 allCLEAR Basics

.! g~; ~_q

"f

1 00 001 1 e~ e~ ~J ~i ~i ~t ~!

c!a ;1! m "'~ '

~ .~,

~!~ ~-. Uiy

W. ffiJ ~i t /@1 ------ L / 1 e~~ ij ~i'" 1 ~~~ ~ l~~~

' o' :;: . ~~-

. ~: "'1.!.i i '

!

~u ~~~ ciit~

~2

d..1 ~~ "'"acii

t

iA ~i~

"'i ...

t

1 1 -1 1 E 1

1 ~t. 1 1 ~!.~ Ci~ .. 1

Figure 4-6. Styie Sheet Options

allCLEAR Menus 4-11

allCLEAR Menus 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:

... The Main Menu and the associated pull-down menus, dis-played 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.

l.'13i![( H 11.oh-t~ ...... ,.. 4

:~:~;:.,_ ~ OnIFOKTS : IWh..,tle. 11 polnts ~ S'tnBOl. ! L.-b.ls ~i:I= 1 J"llnls

'""t ; Hsl-tlc.a ,,..1 .. ts tuct : urp Sliu :-11 s11aoo11.., '" -llSSIGl'!l'IEKT01SHAl'ES Sh.t......,t: l"l't:Ul"!I 1r :o11-"" ~- : M:.u,.. .. Chelcn :t.-.,._, Loe>p : elllJ>R Sl&rt :~ftfl [nd : rtsu ,.,-lhlo,,.,.

Or\s.,tt1.., ,...-trlt ~~= Slu : hU..er'

: .. 1,11t,.,. ,.,1.., !ordl'N; : ...

.... u. Rl51\l : l.2SLN:Aal Top ' 11.Soelncn lotlo"

D\aph'I U1c 1U

4-12 allCLEAR Baslcs

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 hierar-chy of the al!CLEAR menu system and explains ali the Main Menu and pull-down menu options.

To use all CLEAR menus:

1. Position the bar cursor over the option which you wish to ac-tvate and press !..iEnterl to select it. An alternative way of selecting a menu option is to press the Ietter key corresponding to the highlighted character (usually first) of that option.

2. Use EJ or EJ to display the next pull-down menu on the left or right, respectively.

3. 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.

~~~ a~11 =~i _,..

' ~~ .~ . ~fu ll ~~s~ o~~ ~ Fo 2~ J..

1 f ! 1 ~ 1 H 1 ~~ ~}: ,,;.. . ! . ~ z;.i 3-;g :ti~ ~il B~i ~~l E~! ~fti ~~


Basic Operating Guidelines

~ \.::..1 1

looll Tlt'Htdi;i.9tam10 - 1tsgenOllsl'l.lpt,

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 avail-able in a!ICLEAR.

When!tl


Dlaplv lile.,..,....,. 11 U..e SC1"ft'1I 111 Senil 1Mde

Rgure 4-11. The Error Message

To obtaln an exptanatlon of the error message: 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:

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 buf-fers

1> insufficient buffer space

Consult Chaprer 12 of this User's Guide for more inforrna-tion on possible errors and how to correct them.

allCLEAR Keys 4-17

allCLEAR Keys Ths section describes the keys most cornmonly used in allCLEAR.

CURSOR KEYS 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. Table 4- J. The Cursor Keys Key Used During Purpose [] menus and file se- to scroll down

[]

El

lection displays Main Menu Scroll view and Print Preview Walk-Through view

All-Pages view

menus and file se-lection displays Scroll view and Print Preview Walk-Through view

to select an entfy to slowly scroll down

to step one box down (spacious walk) to point to the page below the current page to scroll up

to slowly scroll up

to step one box up (spacious walk)

All-Pages view to point to the page above the current page

menus and file se- to scroll to the left lection displays Scroll view and Print Preview Walk-Through view

All-Pages view

editing and enter-ing strings

to slowly scroll to the left

to step one box to the left (spacious walk) to point to the page to the left of the current page to move the cursor to the left through the string

,

4-l.8 allCLEAR Basics allCLEAR Keys 4-l.9

Table 4-1. The Cursor Keys (cont'd) Key

Table 4-1. The Cursor Keys (cont'd) Used Durfng Purpose menus and file se- to scroll to the right lection displays Scroll view and to slowly scroll to the right Print Preview Walk-Through view to step one box to the

El Key Used Durfng Purpose [] menus and file se- to scroll to the first selec-lection displays tion Scroll view and to scroll to show the first Print Preview step (for procedure) or the

main componen! (for tree right (spacious walk) and decision tree)

All-Pages view to point to the page to Walk-Through view to step to the first step the right of the current (for procedure) or the page main component (for tree

editing and enter- to move the cursor to the and decision tree) ing strings right through the string menus and file se- to scroll to the first shown IPageUpf

All-Pages view to point to the first diagram page

lection displays selection editing and enter- to move the cursor to the Scroll view and to scroll one full screen up Print Preview

ing strings first c:;;r;;~ter in the string [] menus and file se- to scroll to the last selec-

Walk-Through view -----to step one sc:reen up lection displays tion (spacious walk) Scroll view and to scroll to show the last

All-Pages view to point to the page above the current page

menus and file se- to scroll to the last shown lection displays selection Scroll view and to scroll one full screen Print Preview down

!Page Dc.vnl

Print Preview 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)

Walk-Through view to step one screen down (spacious walk) All-Pages view to point to the last diagram pag,;

All-Pages view to point to the page below the current page j :

editing and enter- to move the cursor to ~he ing strings last character in the string

f(,

4-20 allCLEAR Basics allCLEAR Keys 4-21

FUNCTION KEYS TYPEWRITER KEYS allCLEAR also makes use of the function keys (located on al!CLEAR also makes use of severa! keys on the typewriter the left-hand side or along the top of most PC keyboards. portian of the keyboard (located in the center of most PC Each function key has a particular purpose in alJCLEAR as keyboards). Each key has a particular function in al!CLEAR described in Table 4-2. as described in Table 4-3. Table 4-2. The Function Keys Table 4-3. The Typewriter Keys Key Used Durlng Purpose Key Used During Purpose m any time during ali- to access the on-line help l-'Enterj menus, Style to select, or actvate, the

CLEAR operations facility Sheet, and file se- menu/option/file high-im any time during ali- to enter the editor lection displays lighted by the cursor

CLEAR operations specified in Setup and Walk-Through view to step to the next edit the selected scri pt file executed step for a proce-

rn any time during al~ to display the diagram of dure diagram orto CLEAR operations the selected file in Scroll traverse the tree forward

view far a tree diagram and decision tree ~ any time during ali- to display the diagram of '"~,

CLEAR operations the selected file in Walk- .~i editing and enter- to indicate the completion :,

Through view ing strings of editing or entering

lm a_ny time during ali- to display the diagram of 1-Bad

4-22 allCLEAR Baslcs allCLEAR Keys 4-23

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 jSpaceBarj menus and Style equivalent to El choices for an option Sheet

Scroll view to scroll the diagram one file selection dis- equivalent to EJ screen-full to the right plays pres sed with l~s-ml, to Walk-Through to position the cursor on scroll the diagram one view, branching the choice desired for fur-screen-full to the left statements ther walk

Walk-Through view to step to the next screen jJfil Setup program to save the changes to to the right configuration and exit pres sed with l~SMtl, to Setup (equivalent to select-step to the next screen to ing Save and Qult) the left [ID@ All-Pages view to undo horizontal squeeze

All-Pages view to point to (or show, if the }fil All-Pages view to undo vertical squeeze view is zoomed in) the EJ diagram views to zoom in to the next next page on the right of zoom level (in Sc;o!' nd the current page Walk-Through views) and pressed with l ~Stii!tl, to to zoom in on the current point to (or show, if the page (in All-Pages 1iew) view is zoomed in) the o diagram views to zoom out to the next next page to the left of zoom level (in Scroll and the current page Walk-Through views) and

Print Preview to preview the next page to zoom out to see al 1 to the right of the curren! pages (in Al~Pages view) page ~ All-Pages view to change the box size pressed with l~SMtl, to [] Scroll and Walk- to change the character preview the next page to Through views size the left of trie current page

1 l8J All-Pages view to squeeze the diagrz:m l~Stii!tl diagram views, acts as the opposite of horizontally

pressed with fjib" fjib" [QJ All-Pages view to change orientation of ---

Hlgll- menus and Style to select an options the page llghted Sheet without pointing to it with letter the cursor

file selection dis- to search for the first file plays on the list beginning with

that letter


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 editing and enter- to insert a blank character

ing strings l0eie1e l editing and enter- to delete a character

ing strings

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.

1 ....

5-2 Managng allCLEAR Scrlpt Fiies

Chapter Contents The FILE Menu Selecting a File Changing Directory Editing a Script File Creating a Script File Printing a Script File . Forrnatting a Script File

5-3 5-4 5-6

. 5-7

. 5-8 5-10 5-12

;'C.:

'-----""''''\-~>";.-. ~--.: -'' ,_,_,,. .. __ ... ,.-w.-_, .. .,.-.;...-~--.-----.....:,'-'-.,,......,...~J,..,...:;...-.:,.~o.---.-.:..;.--->----~~~ .... .........._., __ ,__,.,,..._. ... ,.. ______ _._,. _ _.,_~----"""' --~-------

The File Menu

The File Menu 5-3

Ali of the file management activities in allCLEAR are or-ganized in the File menu (Figure 5-1 ). llf"'" --

st!lll stw.t: MfiU.T Dt ... cUrt

"" "-Lllt. Ll nu. ~=-,.-,.-,-.,-. ~h : Mol.....tlca ,,.l~ls 1 -.-.. - -"+ ... -, .... -,- ... ~~

r.,. .. s1a: Jrtt.ar SU : "-.iol

: ... ~. SJze : -11 Sl>Ml"S: .rr

- .llSSlawcT ' SHIU'tS -su~:~u...,1. 1r :,u_,.. ea.. : __ ,.,, tMlcn : tr_l,. 1.o.,. : .i11..-st.M-t : 1.rt.,.....lll.,rwo 1no1 :,.1,u,.....11.i .,._

S't.&rl.O.. : .. 1,1r.t,..,. ~~ ~:: '---- Mll511U ---

i.tt : l.ZSlN:ll .. ll9lll : l.ZS lncMs t., :1.ZS1nc...., .. u .... : l.ZS l.,.,_Jwa

S.l..:t.scrl,ttllotrllCU:Alacll..S

Figure 5-1. The FILE Menu

m .....

m "" IJII

St~I

; , ......

ICn r..,sl

; g 1 .!.

,.. 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 ac-complished 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.

5-4 Managlng allCLEAR Scrtpt Flles

Selecting a File Selecting a script file is always the first step in any allCLEAR operation.

To select a file:: 1. Position the cursor on the Seled option of the FILE menu and

press +J Enterl.

,.

allCLEAR displays the alphabetized list of files in the work-ing directory and positions the bar cursor on the first file on the list (Figure 5-2).

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. Y ou 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 look-ing for, simply type that letter and allCLEAR will move the cursor to the first file on the list which begins with that char-acter.

f.~~ '':~;.

Selectlnt a Fiie 5-6

2. Position the cursor over the desired file and press [.-EnterJ to select it. allCLEAR loads the file into the memory and displays its name on the bottom of the screen, above the help line.

w IMPORTANT: lf you don't see your file on the list, check the worl

H Managtng allCLEAR Script Ales

Changing Directory 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.

a!ICLEAR moves the cursor to the last character of the cur-ren! 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 set-ting using standard DOS forrnat. For example, type: C:\ALLCLEAR\DATA\*.ACL ~EnterJ You can use EJ. EJ. lDeieteJ, llnsert 1.1 ~--8ackspace--~!. [Ho

5-8 Managlng allCLEAR Scrfpt Files

Creating a Script File

1.

2.

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.

Position the cursor on the New Edit option of the File menu and press [?Entefj to select it. allCLEAR moves the cursor to the window on the bottom of the screen, above the help line, and displays the current direc-tory and files-to-list string.

Enter the name of the new file next to the directory string and press [?EntefJ. For exarnpk, type: C:\ALLCLEAR \ DATA\ NEWFILE.ACL ~Ente) 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. allCLEAR then invokes the Text Editor with the new file's name. Y ou 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 as-signed 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 al-ways keep in mind which diagram type it describes.

fil~ 7.,.:

irJ , . ~~ y;

,,

3.

4. 5.

Creating a Scr.ipt File 5-9

't11l~t: PD'AUl.T

=======---r=:-- ona....,., ---~ THh : iw 1--i 1~ 12 .. l ftl.& st.., l Tl"99 ~ : iw1 ... u ea"'111ts

o.ci.1 ... t.- P'flfauwout--r ..t l ..t Orlnl atln: i....uc.,. T-C. : -u ,....,. s1 .. ; lrtt...r SI = - 11 Sl4'n : ._I ~':S1~ at RWIS ~ftf O.. ~ :!illl ....

tt..t.-.t: ......... , . 1o.....-. : ... 1r : .u-""' MllGllC ---e.u. : i...,... ~ : .zs 1-i.-a.1- t.rto-H 11,lol : e . 251 ........ i..., : .i 11,.. ro, : zs tnca.s n.art. : ld't. ,.....11.1.,.._ a.u.... : 1.ZS ll'Clloeil w : ,.1,u,.....11. 1.....-

S.IMl ,.,._ ..... , T,..., ,,. O.Ohl" T,._ .. t._ t.,,,..

~ m ""

e Clll "'"-mn T-ssl

g 1

Rgure 5-3. Se/ecting Diagram Type for the New Rle

Position the cursor on the desired diagrarn type and press l--'EnterJ to seJec; ; t. Y ou 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. E ven if you haven ' t changed anything but the diagram type, the next step is to assign the Style Sheet to the new file. Press ~ to move up to the menus. 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 at-taching the Style Sheet to a new file is to press !] when ready to save the Style Sheet.

5-10 Managing allCLEAR Scrlpt Files

Printing a Script File Y ou 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 struc-tures (Figure 5-4).

lMPUT SCJlllT FILl

Does IJOl'r c&r M.ue an air conditJaner7 !Yes) Tlll'll the ir conditioncr off. ?end 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'? CYes) 'fou cu now nart drlvfngf U\ll tun the engine otr. Does the w.alcJ' JIUlllP bclt loolt OX7 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.

PRil'm:n SCJtlPT FIU:

[ Does ~ c.tr h.tue an 4ir cond ltloner? Uesl TllMI thc ak conditloncr otr. 1'end Ta.ke the ldealer n'esl Oecl: the coolant leuel.

Li lt bcla.t thc '"UJ..r" llnc1

[ ('tes) ~,:lant to the l"eServotr &nd radlo.tor. Ub> >dcaler

7end '?end

7end -dealer Brlng your car to the dealer.

Rgure 5-4. Script Rle Printed with Print Utility :~~ ';~~

~~:

Prlntlng a Scrlpt File 5-11

The allCLEAR script file print utility allows you to specify the following:

"' 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.

To pnt the selectecl script file: 1. 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.

l(i" IMPORTANT: lf you wish to print the file as is (not format-ted), you should use the DOS PRINT command. You can jump to DOS by using the DOS option of the Run menu with-out loosing any of the current selections.

The Characters per line and Lines per page settings of the print utility allow you to configure it for compressed pri!lt-ing. You have to make sure, however, that your printer has the appropriate font/mode selection.

5-12 Managlng allCLEAR Script Files

Formatting a Script File 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. Position the cursor on the Format option of the File menu and

press .., Entocl to select i t. If the input script file has extcnsion .ACL, al!CLEAR for-mats 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 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

6-2 Viewlng allCLEAR Diagrams

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)

. 6-3

. 6-4 6-8

6-12 6-19

The Vlew Menu 6-3

The View Menu Ali of the diagram display options (four different views) in allCLEAR are organized in the View menu (Figure 6-1 ) . - "'- W"**J'"-'2' 1 1 m E!!fH ,. 1 liallt.JN-911 ....

11111-r..-"

,,,.. """' f"rlM "'-1- n. : lllh,.tl.,. U ,.111ta IZ!I

: IWLw-tioa ,,.111u "" - ,_,,

""""""' Fe11t : i.1-u.,. 1,..1nta 11111 ,_ : .... , Sl'!lll Slu : ... u-u.MI,.- : "" : ..i.,n,..- gjj -lltSSl~OTSWll'IS =tt

"'"-S~~:.-.ct.&.,.I :.rr

" :.it-....

""'"'' ICll

c... : """-" """

; l.ZS 1 .... u. r.,,1. ""loes: tra~I 11,lll :l.ZSlnc:Us ..... : .111..-

'' ;l.ZStow:i.n u

'""' : 1.n ,.....11.1....- JoU.- : 1.25 ln

6-4 Vlewlrig allCLEAR Diagrams

Scrolling the Diagram (Scroll View)

The Scroll View is intended for a fast diagrarn overview so that you can quickly get familiar with the general shape of the diagram. Y ou 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 of-fers 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" IMPORTANT: lf you feel that the curren! default zoom level is not what you want, press [ill to enter Setup and select a dif-ferent setting.

You can also zoom in or out while in the Scroll view, regard-less of what the default zoom leve! is.

2. Press EJ to zoom in (bring the diagrarn closer tp) or O to zoom out.

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 ex-amples of different zoom levels ). 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.

Scrolllng the Dlagram 6-5

Zoom Leve/ 1:1 Zoom Leve/ 1:2

Zoom Leve/ 1:3 Zoom Leve/ 1:4

,, ~

Zoom Leve/ 1:5

pn

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.

6. Press ~ or /PageDowni to scroll the diagrarn one screen up-ward or downward, respectively.

7. Press !Home! or ~to scrol! the diagrarn to the very top or bot-tom box, respectively.

Y ou can change !he following two diagrarn attributes direct!y from the Scrol! view. The same c-.an be accomplished by exit-ing diagrarn display, modifying the Style Sheet, and generat-ing 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 cur-rently 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 sum-marizes 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.

Scrolllng the Dlagram 6-7

-1--- ..... 11 tDltt.J-uvw.. - t...t -- .... 11 '"""ll"C"'"'l - -.11 ~ - --nul'\:SliiltU-

6-8 Vlewlng allCLEAR Diagrama

Walking Through the Diagram {Walk-Through View)

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, oor-ders, etc.

To view the diagram in WalkThrough view: ~.' "'" 1. 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. At first, the cursor is positioned on the box located in the cen-ter 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, respec-tively.

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.

n :J1 ;: ~- 'i{

~ ,.

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.

6. Press ~ or IPageDownl to step to the next screen up or down, respectively.

If you wish to trace the logic of the diagram step-by-step, you can use the logical step keys. These do not respect spa-cious movement rules and remain true only to logic flow.

7. Press l+>Enterl or 1-Backspa:?el to step to the next or previous logi-cal 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 ).

""" ,. t- p ., ........ 1., ... ~Til,.. .... , -1-. .. : 1 ,--~~~~~~~.1

~!..;1~;::~::':: 1

Rgure 6-4. Walking from a Branching Statement

6-10 Vlewlng allCLEAR Diagrama

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 posi-tion, 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 avail-able 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 O to zoom out.

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 op-tions (Figure 6-5).

Walklng Through the Dlagram 6-11

""'J.!!I !! 1!!!!1 ~ .. e1 .. I/!. ru. v1- n.. ~ rrw- "'1a. 1111. u1- 111- 111 ...

~ iiiilNM:"" i'.l'Yl ._.._.. ...

-..t-tt-~ ( ...... J4~ -~---UUJ-'tQltu-CT.W - 11~ - --C.._J.-tDoil a..vt..t. ._


Preparing the Diagram for Print {All-Pages View)

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 All-Pages 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 view~ 1. Select the All-Pages option of the View menu or press ~

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).

o...,.anlatl.,I e>..rt or Sot"t-- c ....... y

Tl Hlp

Rgure 6-6. All-Pages View

:;

r...:'.

1

~---.-,,.._.._ ...... -- ---- ----~. --- . - - -

:-~


You can change severa! diagram and page layout attributes directly from the All-Pages view. The same can be ac-complished by exiting diagram display, modifyi ng the Style Sheet, and generating the diagram again. Refer to Chapter 8 for detailed description of the diagram and page layout at-tributes discussed below.

2. Press [] to change the diagram style (toggles the four avail-able 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 landscape to portrait and vice versa).

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 which fits on one page can result in making the diagram spread over 2 pages (Figure 6-7).

nmmm

Figure 6-7. Effect of Changing Style on Diagram Layout

6-14 Vlewing allCLEAR Dlagrams

~

When you first enter the All-Pages view, the first page of the diagram is highlighted or is pointed to by the cursor.

6. 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 Stt .. a ... Cnw

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).

Preparlng the Dlagram for Print 6-15

o .. ,.aniatlo .. I Chr or Sart-... e. ... .,.,.

I@ f

.

..................... ...----.--.--.-.. -~--

Agure 6-9. A/1-Pages View far a Dot-Matrix Printer

You can use the usual cursor control keys to poini to dif-ferent pages in All-Pages view (naturally, if the view is zoomed in on one page, cursor keys allow you to display other pages).

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. Y ou should exercise y.our judgment as to which squeeze op-tion to use. The diagram in Figure 6-10, for exarnple, ob-viously needs a horizontal squeeze.

6-16 Vlewing allCLEAR Dlagrams

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.

:;

' :'?


EfJ

~~====~~~~ Figure 6-11 . Effect of Squeeze on a Diagram

In other cases, however, squeezing can have no effect, or ad-verse effect such as overlap of boxes. Y ou should then und_o the sq ueeze.

11. Press !] and then, without releasing it, iEJ or 0 to undo the horizontal or venical squeeze, respectively. To see which keys are available while viewing diagrams in All-Pages view, you can press m to see a screen which sumrnarizes ali the scroll and fast key options (Figure 6-12). _, -mmmmmm Scroll U.llo. All- trlnt. PrlnlAtldo

Ul,... T""" ,_...,. hT- 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


12. Press ~ or ~ to clear the diagrarn off the screen and come back to the menu. This erases the diagram from !he screen, so don 't press this key umil you are done with viewing the diagrarn.

a- IMPORTANT: The changes to dlagram attributes, which you make while viewing the diagram in the All-Pages view, are re-flected 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 ru to save the new Style Sheet and attach it to the selected file.

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 All-Pages view prior to printing.

Page Prevlewlng 6-19

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) ap-proach 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 .

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 .

W 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 , \iC..f'U !!Ot1 1101Hn;wn

lt'_Eflr l h lr"QSD'I

~COLNTINCI Caira1u ..,, . .,...,

EM'lO'lEEFElATI Cffl P

Date post:	15-Sep-2015
Category:	Documents
Upload:	radutari
View:	25 times
Download:	3 times

- AllClear User's Guide

Documents