1

1.2 HOW TO INSTALL Z88 FOR WINDOWS 95 TO XP

Remark: We could of course use the standard installation routines or ready-to-run installation tools for Z88, but as there are no hidden .DLL files, no .INI files are to be modified and no subdirectories are created, we leave it alone. You will see, Z88 installs quite simply:

Windows in five steps:

1st step: Copy the Z88 files into a new or existing directory:

We assume that you have copied the file Z88RUNE.EXE from the Z88 diskette or CD-ROM into a new directory named Z88 on hard disk D: . If you have copied Z88 to C:\SOMEWHERE then replace D:\Z88 in the following description against C:\SOMEWHERE. Now launch Z88RUNE.EXE, e.g. by Start > Run oder from the "DOS prompt". This uncompresses Z88. No other modifications are made and the Windows system files are not modified.

Now you may delete Z88RUNE.EXE to prohibit another start resulting in overwriting your own input files.

2nd step: Make Z88 ready to run:

Two different methods are usual under Windows:

(1) Folder on the desktop:

Define a new folder on the desktop: Point to a free area on the desktop, press right mouse key, New > Folder. Name the new folder e.g. Z88. Include at least Z88COM into the new folder: Open folder by double click, File > New > Shortcut. Enter: D:\Z88\Z88COM.EXE, Next > Z88COM and Finish

With the same procedure you can add the other Z88 modules (File > New > Shortcut): Z88F, Z88I1, Z88I2, Z88D, Z88E, Z88G, Z88H, Z88X, Z88N, Z88V, Z88P. However, skip it, if you want to launch the modules exclusively by the Z88 Commander Z88COM.

(2) Installation in "Start":

Point at the Start button, press right mouse button, select Open. Open folder programs by double click. File > New > Shortcut, enter for command line: D:\Z88\Z88COM.EXE, Next > , name the icon e.g. Z88, Finish. You can also place a whole folder here.

3rd step: Enter your favourite editor in Z88

You may produce all input files either by a CAD program which can read and generate DXF files in cooperation with the CAD converter Z88X or also write by editor since Z88 operates with ASCII files, however. An editor for looking at the Z88 results is also very useful. So you should define it:

Suitable editors are under Windows edit or editor from Start > Programs > Accessories. However, you can also use old-fashioned DOS programs like WordStar or the Norton Editor.

Assume you want to use edit (included in Windows) as Z88 editor . Start Z88COM, File > Define Editor, enter in textfield Editor Name any text, e.g. EDIT or TRUE-LIES. In textfield Editor Call, if nes. Path enter the program name, here edit. You want to work with Notepad: enter in textfield Editor Name any text, e.g. MY-NOTEPAD, enter in textfield Editor Call, if nes. Path. the program name notepad. Further example: Word for Windows. You must find out where Word for Windows is located. Go ahead: Start > Find > Files or Folders : winword.exe. Let's assume WinWord is located in C:\MSOffice\Winword. Thus you could enter in Z88COM: Word4Windows and C:\MSOffice\Winword\winword . Make sure when using Winword that you work and save in plain text mode!

4th step: Add an Internet Browser for Z88's OnLine help:

Integrate your favourite Internet Browser into Z88. This may be Mozilla, Mosaic or MS Internet Explorer.

(1) the next step is very important: Z88 must be able to start the Browser ! Either you must put it into the PATH or enter the PATH in Z88COM or copy the whole Browser into the Z88 directory.

State at first where your Internet-Browser is located. Use Start > Find > Files or Folders. The Microsoft Internet-Explorer is called iexplore.exe, Mozilla is called mozilla.exe. Note down the found path.

1st possibility: Type in path into the PATH variable: Start > Settings > Control Panel > System > Advanced > Environment. You should always do this if the path also includes blanks.

Example: The Internet-Explorer is located in Windows 2000: c:\Program Files\Internet Explorer (with blanks between Program and Files and Internet and Explorer !).

Do we assume your previous PATH variable looks as follows:
D:\WATCOM\BINNT;D:\WATCOM\BINW;
With the Browser included PATH should look like:
D:\WATCOM\BINNT;D:\WATCOM\BINW; c:\Program Files\Internet Explorer;

Logoff and login again.

2nd possibility: Enter path in Z88COM directly: Assume Mozilla is located in D:\MOZILLA\PROGRAM\. Start Z88COM, File > Define Browser and enter in textfield Browser Call, if nes. Path:

D:\MOZILLA\PROGRAM\MOZILLA

Now for advanced users: The Internet-Explorer is located in Windows 2000: c:\Program Files\Internet Explorer. Because of the blanks between Program and Files and Internet and Explorer you may proceed as follows: Start Z88COM, File > Define Browser and enter in textfield Browser Call, if nes. Path:

c:\progra(tilde)1\intern(tilde)1\iexplore

This are the "old" DOS names with a maximum of 8 letters without any blanks. How do you get such old- fashioned DOS names? Try dir /X in a DOS windows (Command Prompt). It works, really.

(2) Take into account that most Internet-Browsers immediatelly try to contact the Internet. Now they are to load a local HTML file. Thus, various file prefixes depending on the used Browser must be fixed. For Mozilla the prefix is file:///Z88 path, e.g. file:///D:/Z88/ for Microsoft Internet Explorer the prefix is file:Z88 path, e.g. file:D:\Z88\ .

With above explanations and assuming that you have copied all Z88 files to D:\Z88, the Browser definitions in Z88COM would read:

Microsoft- Internet Explorer: | Mozilla (also true for Netscape):
File Prefix for Browser: file:d:\z88\ | File Prefix for Browser: file:///d:/z88/
Browser Call, if nes. Path : c:\progra(tilde)1\intern(tilde)1\iexplore | Browser Call, if nes. Path: d:\progra(tilde)1\mozilla.org\Mozilla\Mozilla.exe

5th step: Launch Z88:

Z88 is ready to run. You may fire away immediatelly by launching the Z88- commander Z88COM and using the OnLine help system. Proceed with example 5.1.

Notes for the Z88-Commander Z88COM

It starts all Z88 modules, provided that you don't want to start them stand-alone (which is possible any time and without any restrictions), permits the immediate editing of all input and output files and calls the context sensitive online-help. So you launch the online- help: Select in an arbitrary pulldown menu the point Help Mode. The cursor changes to a question mark. If you click now on a menu item the menu point is not executed but the associated help appears. The help mode keeps active until you click on a menu item Help Mode again.

Furthermore, the Z88-Commander Z88COM offers support for HP-GL files, such as generating header sequences for HP plotters and HP LaserJets.

Z88COM files your entries for the Internet-Browser and editor in a file Z88COM.CFG. If this file should be destroyed accidentally, you can edit Z88COM.CFG by hand:

1st line: Editor name
2nd line: Editor call
3rd line: Browser prefix
4th line: Browser call

Example:

Word4Windows
C:\MSOffice\Winword\Winword
File:///D:/z88/
d:\progra(tilde)1\mozilla.org\Mozilla\Mozilla.exe

... And how do you remove Z88 ?

Simply delete all files in the directory containing Z88. Then delete the directory if necessary. You should delete the links we made for Windows NT/95 in chapter 1.2. That's all !

And how to compile Z88 for Windows?

Only if you want to add improvements to Z88 you will need to compile the package. Every Windows C or C++ compiler should work properly. I tried the free LCC and the compilers from Microsoft (Visual C++), Borland (C++ Builder) and Watcom (C/C++ 10.6 and OpenWatcom). Because every brand uses its own project management we can't use ready- to- go makefiles. How do we proceed? I prepared for you a compiler session for the iterations solver part 2 Z88I2 featuring the free LCC, but Microsoft Visual C++, the Borland C++ Builder and the Watcom C/C++ compiler sessions are very similar :

1. Launch a new project.

2. Be sure to choose a pure Win32 application "without anything" . Don't use any application skeleton neither any application wizzard nor generate a "Hallo World" application.

3. Enter your favorite directories and make sure to generate a Windows application not a Console application.

4. Add the matching sources to your project (ref. table below), i.e. the C- sources and the appropriate Ressource file *.rc (in this case Z88I2.RC).

5. a most important step:

Adjust the compiler, the linker and the ressource compiler: Tell your compiler system

- where the Header files Z88*.H (the so-called include files) are located
- which Defines are necessary (here FR_WIN95, FR_XDOUB and FR_XLONG) (ref. Table below).

Most of the compiler malfunctions will result from wrong paths and missing defines!

You may leave the Debug infomations off. Choose a soft to medium optimization level.

If in doubt skip optimization if you don't know the details. If you have never heard about a Framepointer or inline functions, Parameter passing by Stack or Parameter passing by Memory and Aliases, then keep your hands off! (if you are interested in such stuff, you may consult the book Rieg,F.; Hackenschmidt, R.: Softwaretechnik für Ingenieure, Hanser Verlag, München Wien 2001 (in German language)).

6. Don't forget to link against the library comctl32.lib (Common Controll Library) ! It is part of your compiler system and exists on your machine.

7. make project or rebuild all

8. Make sure to have the files Z88.DYN, Z88COM.CFG, Z88O.OGL and Z88P.COL in the same directory were you did the compilation i.e. where your executables are located. Otherwise, you don't need to wonder about fancy error massages. And the proper input files should exist here, too.

Name | Windows Sources | UNIX Sources | Defines | Library
z88f | z88f.c ale88f.c easyfont.c tob88f.c wrim88f.c z88f.rc | apla88.c choy88.c cshe88.c dyn88f.c hexa88.c hpla88.c isod88.c lan88f.c lqua88.c m1.c m2.c qshe88.c ri188.c rw2y88f.c spla88.c spur88.c tetr88.c wlog88f.c wria88f.c z88a.c z88b.c z88cc.c z88f.h | FR_WIN95 FR_XDOUB FR_XLONG | comctl32.lib
z88i1 | z88i1.c ale88i.c easyfont.c tob88i1.c wrim88i.c z88i1.rc | dyn88i1.c lan88i1.c ri188i.c w4y88i.c wlog88i1.c wria88i.c z88ai.c z88i.h | FR_WIN95 FR_XDOUB FR_XLONG | comctl32.lib
z88i2 | z88i2.c ale88i.c easyfont.c tob88i2.c wrim88i.c z88i2.rc | apla88.c cshe88.c dyn88i2.c hexa88.c hpla88.c isod88.c jaco88.c lan88i2.c lqua88.c m1.c m2.c qshe88.c r1y88i.c r4y88i.c spla88.c spur88.c tetr88.c wlog88i2.c z88bi.c z88ci.c z88i.h | FR_WIN95 FR_XDOUB FR_XLONG | comctl32.lib
z88d | z88d.c ale88d.c easyfont.c tob88d.c wrim88d.c z88d.rc | dyn88d.c fuvs88.c lan88d.c m3.c m4.c riy88d.c sapl88.c scsh88.c shex88.c shpl88.c siso88.c slqu88.c span88.c sqsh88.c sspl88.c sspu88.c stet88.c wlog88d.c z88d.h | FR_WIN95 | comctl32.lib
z88e | z88e.c ale88e.c easyfont.c tob88e.c wrim88e.c z88e.rc | apla88.c cshe88.c dyn88e.c forc88.c hexa88.c hpla88.c isod88.c lan88e.c lqua88.c m1.c m2.c qshe88.c riy88.c spla88.c spur88.c tetr88.c wlog88e.c z88e.h | FR_WIN95 FR_XDOUB FR_XLONG | comctl32.lib
z88n | z88n.c ale88n.c easyfont.c tob88n.c wrim88n.c z88n.rc | dyn88n.c join88.c lan88n.c mc188n.c mc288n.c mc388n.c mc488n.c mc588n.c rni88.c subn88.c wlog88n.c z88n.h | FR_WIN95 | comctl32.lib
z88v | z88v.c ale88v.c g1i188.c g1i388.c g1i488.c g2i188.c g3i188.c g4i188.c g5i188.c gxi288.c tob88v.c z88v.rc | dyn88v.c lan88v.c wlog88v.c z88v.h | FR_WIN95 | comctl32.lib
z88x | z88x.c ale88x.c easyfont.c tob88x.c wrim88x.c z88x.rc | dyn88x.c koi88x.c lan88x.c rea88x.c sub88x.c wlog88x.c wria88x.c z88fx.c z88tx.c z88x.h | FR_WIN95 | comctl32.lib
z88g | z88g.c ale88g.c easyfont.c tob88g.c wrim88g.c z88g.rc | cosm88.c nast88.c lan88g.c wlog88g.c z88g.h | FR_WIN95 FR_XDOUB FR_XLONG | comctl32.lib
z88h | z88h.c ale88h.c easyfont.c tob88h.c wrim88h.c z88h.rc | lan88h.c rdy88h.c wlog88h.c z88h.h | FR_WIN95 | comctl32.lib
z88p | z88p.c ale88p.c easyfont.c m8.c rcol88.c tob88p.c vc88.c vgpc88.c vgpp88.c vp88.c wlog88p.c z88p.rc | dyn88p.c lan88p.c m5.c m6.c m7.c pc88.c pgpc88.c pgpp88.c pp88.c z88p.h | FR_WIN95 | comctl32.lib
z88o | z88o.c ale88o.c m11.c m13.c oglfont.c rogl88.c tob88o.c wlog88o.c z88o.rc | dyn88o.c lan88o.c m9.c m10.c m12.c oc88.c z88o.h | FR_WIN95 | comctl32.lib opengl32.lib
z88com | z88com.c ale88c.c easyfont.c tob88c.c z88com.rc | lan88c.c wlog88c.c z88c.h | FR_WIN95 | comctl32.lib

The Z88 executables and the matching sources, defines and libraries.