This chapter tells you how to get your copy of WIZARD up and running from the tape or floppy disks you have received.
Please note that the information in this chapter may be supplemented by additional information relevant to your specific release of WIZARD or to your own special media or hardware requirements. So if you have supplementary notes, be sure to read these also.
Wizard is available for a number of different multi-value database environments, and can be supplied in a number of different formats. As such, instructions specific to your environment will be supplied as a separate document with your copy of Wizard. Please refer to those instructions for details on how you should load Wizard.
Once you've loaded Wizard/Pro onto your system, it will need to be activated. To activate the software, you should log into the WIZARD account and, from the command prompt, type WFIX. The first time this is run on your system, you will be asked to enter your serial number.
If you successfully enter the serial number, WFIX will respond with the code 00. This indicates that the software has been temporarily activated for 14 days with 8 users and 1 developer access. If you log out and back in you will see the warning message and find yourself at the main system menu.
To complete the activation of your copy of WIZARD, you should contact your WIZARD dealer (or General Automation Australia). Before you do so, you should have first checked that the date on your system is correct. You should also have some idea of how many ports are connected to the system.
When you call your dealer, you will be asked to run a function from TCL in the WIZARD account. The name of the function is WFIX. This routine prints two rows of numbers, the first from 1 to 20, and the second a sequence of random numbers. A sample output from WFIX is included below.
W i z a r d S y s t e m E n a b l e R o u t i n e
Wizard 5.3b; July 1996.
[Current date 15 Jan 1999. Enter 'END' to exit.]
Serial Number : 00000*00000*00000; Ref.: 5850/1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
3 4 7 9 1 2 0 6 8 5 0 9 6 4 7 2 5 1 8 3
001:
Once you have these details, you can:
If you inadvertently run this routine, you need only type END at the prompt to exit.
Before you begin development work using WIZARD, or even just playing around with the environment to "try it out", you may find it necessary to set up appropriate terminal types and keyboard types.
There are two ways to do this, one quick, one slow. To be able to easily select from the set of terminal drivers supplied with Wizard, from the TCL command prompt in the WIZARD account, type:
RUN WIZ.BP SetTerm
This will show you the following prompt:
Current terminal type is "VT220".to use this, for a list, or enter a terminal type :
Of course, the current terminal type you see will probably be different. By entering a ? followed by <return>, you will be provided with a list from which you can select a terminal type.
If you find a valid terminal driver, skip to the next section, otherwise you may need to read the following information about how to configure the terminal and keyboard settings individually.
WIZARD needs to know what terminal type you are using so that it can correctly display screens and menus. For more detail, see below on the instructions for use of the WIZARD Terminal Setup screen. However, you will not be able to use that screen unless at least one terminal works with WIZARD.
If you are using WIZARD on R83 Pick, or Advanced Pick on DOS, or UniVerse on SCO Unix, you should find that the console terminal (or port 0) is correctly set up. If that is so, see the Set Keyboard Types section.
If the terminal is not set up correctly, you may need to know how the file is set up. For details on structure, refer to the Appendix on file structures. This section will cover the basics of configuring a terminal.
The terminal file is called WIZ.TERM and it contains an item for each port on the system. The ID of each item is simply the port number (so if your port is number 4, the data is stored in
The WIZ.TERM file also contains master items for each terminal type which do not have numeric IDs. For example, the master item for a Wyse 50 terminal emulating an Adds-Viewpoint with Enhance mode on is called ADWY. If port 4 is of this type, it could be set up simply by using the following command from TCL (if you want to do it from another account, you will need to
COPY WIZ.TERM ADWY (O TO: 4
Thus port 4 is set as a Wyse 50 emulating an Viewpoint terminal. For a complete list of terminal types, you may type:
SORT ONLY WIZ.TERM
and note the items which have an ID which is not a number.
The procedure for setting terminal types is almost identical to the procedure for setting keyboard types. WIZARD needs information on the type of keyboard, because it needs to know what code each key on the keyboard is so that it can tell when you press a function key an arrow, or any other button. The file structure for the keyboard file (called WIZ.KBD may be found in the appendix at the end of this manual.
As with the terminal file, each port has an item defining its keyboard, and the ID of that item is the port number. There are also master items, such as that for a Wyse 50 terminal emulating an Adds Viewpoint which is called ADWY. There are also others and these may be listed by typing:
SORT ONLY WIZ.KBD
If one of these matches the type of keyboard you are using, you may copy the item by typing:
COPY WIZ.KBD ItemName (O TO: 4
(That is if your port number is 4). Once one port is working, you may set up others using the keyboard setup screen.
This screen allows you to set up new terminal types or alter existing terminal types. WIZARD requires the terminals to be correctly set up so that it knows how to correctly display screens and menus. If your terminals are not set up correctly, you cannot use WIZARD, so as you can see, this is a serious matter.
Setting up terminals actually involves three WIZARD screens which are all connected - one for general functions, one for colour, and one for graphics characters.
Screen 1: General Functions
Upon entering this option you will be presented with a WIZARD Screen with fields relating to the function of the terminal. The fields are explained here:
If you want to edit an existing terminal definition, you may type = at this field and be presented with a list from which you can select one of the terminal definitions.
1,2,4,5
is a valid command. You may also enter a range of ports by typing:
1-10
which will set all ports from 1 to 10 (inclusive) to this terminal type (when you file it).
If you want to add ports to an existing list, you may type:
A11-15,20
which would add ports 11, 12, 13, 14, 15, and 20 to those currently selected.
If you want to delete some of the ports from the current list, you may type (for example):
D8-12,15
which would delete ports 8, 9, 10, 11, 12, and 15 from the list of those currently set up as this terminal type. NOTE that when you do this, these ports will have no terminal definition and so not be able to log on to a WIZARD account until they have a terminal definition.
If you are entering a new item WIZARD will automatically obtain as many defaults as it can from the system and fill them in. This makes setting up terminals considerably quicker.
The remaining fields (on this and subsequent Terminal set-up screens) require that the data entered be in hexadecimal. This allows an accessible representation of control codes. Your terminal manual will be required if you are to find the appropriate codes.
|
Entering Hexadecimal in Wizard/Pro In order to simplify entering hexadecimal codes in Wizard/Pro, the input processor includes the ability to convert keystrokes into their hexadecimal equivalents as you type. This feature can be activated on any field on any Wizard screen by simply typing the ! key before you type anything else in the field. Once the Hex Mode is active, any key (including If you need to include the hexadecimal code for the Hex entry is only available for terminal types where Hex Codes is set to Y. |
All the following fields require Hexadecimal codes unless noted.
This screen allows you to set the colour display codes for the screen. It is accessed only by typing Y into field 22 (see above). This screen is divided into two columns: the foreground colours and the background colours. In each column the names of the colours are listed (these are obtained from the fourth option on the set up menu), and next to these are spaces for the Hexadecimal codes for activating that colour. (See above for information on how you can use hexadecimal entry.) This screen appears as follows:
If the colour listed does not have a corresponding colour on your terminal, you can either leave it blank or enter a similar colour.
Pressing
Screen 3: Graphics Characters
When you press
All fields in this screen are hexadecimal entry fields. When you enter this screen, it appears as follows:
The fields here are:
Cursor Display :
Graphics Characters:
The remainder of the fields on this screen are used to define the codes required to display each of the graphics characters which are described in the field names. These are used to display boxes and other similar features in WIZARD.
Pressing
Not only do you need to set up terminals for WIZARD, but you also need to set up keyboard definitions so that WIZARD can recognise the meaning of the key when it is pressed. One important thing to remember here is that you must not define two different functions with the same code, for then only the first will work.
Entering A New Keyboard Definition
If you are setting up a new keyboard definition, you will probably find it easier running the Keyboard Setup routine. You will find this in the WIZARD master account (usually called WIZARD) under Set Up Wizard. It is called Enter New Keyboard.
To enter a new keyboard simply select this option and press the keys as you are prompted for them. You must wait to be prompted before pressing each key.
Once you have completed this, you will be asked if you want to set a keyboard delay.
Keyboard Delay
Some keys on your keyboard send a sequence of codes to the computer. On some systems, WIZARD's input routine may operate too quickly and miss the second and subsequent codes coming from the keyboard. For this reason, WIZARD allows you to add a delay.
The delay will not change the speed of normal typing. It only changes the speed at which WIZARD recognises special keys, such as function keys.
To set a delay, you may either run the Keyboard Delay option in the WIZARD Master account (under the Set Up Wizard menu), or else you may edit the delay yourself.
WARNING: Only use the manual approach if you are familiar with your system's editor.
To edit a delay manually, get to TCL and determine what port number you are on. You can usually do this by typing WHO and pressing the
Next edit the item whose key is your port number in the WIZ.KBD file. Attribute 3 is the delay number. Starting with 50, you may change this until WIZARD recognises your function keys. You should return to the menu to test whether your function keys are working or not.
Maintaining An Existing Keyboard Definition
The keyboard set up screen appears as follows:
All but the first three fields entered here are hexadecimal fields.
The fields here are described in what follows.
All the other keys are self explanatory. The only one worthy of special note is the Margin Release code (number 34). This is the key you press when you want to enter more data into a WIZARD field than the length of that field permits. Since most keyboards have no equivalent to this key, you may need to use a control code (such as <control> with the R key - as long as it is distinct from all other codes).
If you have no key on your keyboard which corresponds to the function in this screen, you may use a control character. You will, however, have to remember which control character it was you selected to perform the specific function, and whenever you see a note on the subject in the manual, you will have to remember that you need to press the control character rather than, for example, the
Although WIZARD can recognise the function keys from the code set up in the Keyboard screen, you need to define what you want the keys to represent. There are only two function keys which you cannot define, these are
If you do set up your function keys to perform certain commands, these commands will be valid from the menus, from WIZARD's TCL interface, and from within WIZARD screens (although WIZARD screens may have custom function key settings which will override your settings while you are running those screens).
WIZARD routines such as the WIZARD Screen Editor, or the WIZARD Word Processor, however, have their own function key settings.
When you enter this option, you enter a WIZARD screen which appears as follows:
The port number field will display the port number you are using as a default. You may type the number of another port or press
Following this you enter a Line Item Set which allows you to enter the function performed by each function key. For example, if you want function key 2 to be loaded with TCL (i.e. pressing
It is possible to make a function key perform the operation of another special key (such as
| Code | Description |
|---|---|
| HELP | Call up the help. |
| UP | Move the cursor up. |
| DOWN | Move the cursor down. |
| LEFT | Move the cursor left. |
| RIGHT | Move the cursor right. |
| WORD_LEFT | Move the cursor left a word. |
| WORD_RIGHT | Move the cursor right a word. |
| MAR_REL | Margin release - allows you to enter data past the end of the displayed field. |
| BSPACE | Backspace and delete the previous character. |
| DELETE | Delete the character the cursor is over. |
| INSERT | Enter edit mode (not currently used). |
| PAGE_UP | Move to the previous page. |
| PAGE_DOWN | Move to the next page. |
| TOP | Move to the top of the document. |
| BOTTOM | Move to the bottom of the document. |
| START_LINE | Move to the start of the line. |
| END_LINE | Move to the end of the line. |
| DEL_WORD | Delete the current word. |
| DEL_LINE | Delete the current line. |
| EXIT | Exit (as with |
The following screens allow you to control colour terminals in WIZARD (in addition to the sub-screen from the Terminal Setup Screen). If you do not have colour terminals available, you can go straight to the section named Print The Manual.
This screen allows you to set up the colour names for the system. These colour names are used elsewhere (such as in the Colour setup screen of the Terminal Setup, in specifying colours for menus and screens, etc.). A series of colours are already entered into this screen, and you should not need to change them unless you want to add more.
Warning: It is dangerous to delete or change existing colours. If, for example, you were to change RED to read BLUE, the terminal setup screen would retain the RED code, but now it would be called BLUE. You should only use this screen to add extra colours to the list.
The screen will appear as follows:
The screen is divided into two columns - Foreground and Background colours. For each colour, you can specify (this is optional) a number which WIZARD can use to get default codes for this colour from the system. This is possible where colours are set up in the system cursor control file. If, for example, the foreground colour red can be turned on by the code @(-44), you would enter the number 44 under the @(-x) column.
For all ports which have colour, this screen allows you to set the colours of the menus on your system. When you enter this screen, it appears roughly as follows:
For each field, you must set up a Foreground and a Background colour. At any field, you may get a list of the possible colours available to you by entering an = followed by
Note that you must set both a foreground colour and a background colour.
The fields you have on this screen are:
If you set only one colour here, all menus will appear in that colour. If you set two colours, menus will alternate between the colours you have specified. Whichever number of colours you set, the menus will cycle through the list of colours available to them.
Menus can, alternatively, have colours set in the menu setup screen which will override the colours set here.
This screen sets up the default colours for your WIZARD screens. These colours are used only if you have not specified colours when you formatted and generated your screen, but these settings do allow you to change the colours for a screen without having to regenerate that screen.
The screen which lets you maintain colours for WIZARD screens appears as follows:
Each colour specification requires both a foreground and a background colour. In any field, typing = followed by
Generally your screens will look better if you consistently use the same background colour and vary the foreground colours. Furthermore, using numerous different colours can be quite distracting.
The fields on this screen are:
The remaining colour setup fields change the colours of the data entry or display fields. For each field type you must set up the colours of both the Label and the Picture section of the field. This means that you can have the data you enter appear in a different colour to the label for the field. The fields under this section of the screen are:
This option allows you to print this documentation in form of the manual for WIZARD. You ought to note that the most up-to-date version of the manual is now maintained in HTML format for the web. The following instructions apply to the on-line version of the manual, which may not contain some of the most current information. For more current information, use a Web Browser to print the relevant sections of the manual.
Note that you need to assign the correct spooler output if you want to send the manual to the printer.
When you select this option, you will be prompted by this routine, asking where you want to send the output. You have two choices:
| P | The manual is sent to the printer currently assigned as output for the spooler. When this option is selected, you will see messages telling you which spool file number the manual is being sent to. The manual is sent into a series of spool files as it is too large to fit into just one. Note that the manual being large, may not only take quite a large number of pages, but may tie up the printer for quite some time. |
| S | The manual is sent to the screen. This is a very slow and roundabout way of viewing the manual. A better way is to hit the function key 1 ( |
WIZARD allows you some control over the formatting of the manual when you print it out. In the file WHELP are several RULER items.
To adjust formatting, you first need to know how wide the system setting for your output device is. You can usually find this out (or change it) with the TERM command, which you should run from TCL. Remember, if you are going to print to a printer you should look at the width under the Printer column.
Also remember that, if you are going to print to a printer, you must set the printer to accept the width you select. You usually do this by selecting the CPI (Characters Per Inch) value on your printer.
To adjust formatting, you need to edit the WHELP item whose ID is "RULER.xx" where "xx" is the width of the output device. For example, if you are printing to a 96 column printer, the formatting control item would be called "RULER.96".
WIZARD includes four ruler items in the WHELP file: RULER.79, RULER.80, RULER.131, RULER.132. If you want a width other than one of these, you can copy one of these items and this makes it easier to set up
Within the RULER items, attribute 4 contains the letters L, R, S, T. Where you place these on attribute 4 determines how the manual will print. The letters represent:
| L | The left margin. |
| R | The right margin. |
| S | The starting position of Sub-Headings. |
| T | The left margin for text. |
Although you may vary their positions, you should always have these in the order: L, S, T, R.
Install WIZARD allows you to install WIZARD into a new account. You may install either the Menu & Security facility, the Screen Generator facility, or both.
Note that before you run this process you will need to create an account (i.e. the account in which you want to install WIZARD must already exist). To find out how to create an account, you should consult the manual for your system. The account you create should have the maximum privilege level that your system allows - this is only necessary while you install WIZARD into your account. Once installed, you may then adjust the privilege level of the account.
Another point to note is that, for maximum security, you should activate the account's re-start option. If you are using R83 Pick, all you do is edit the item in the SYSTEM file with an ID equal to the account name, and replace attribute 9 by the letter R.
After creating the account into which you want to install WIZARD enter the install process by selecting it and pressing
The WIZARD Installer screen will appear (it is simply a WIZARD data entry screen . It should appear as follows:
The cursor should be positioned at the first field. Here you should type in the name of the account into which you wish to install WIZARD. If you type a name that is incorrect, WIZARD will give you an appropriate error message.
After entering the account name, you will be asked whether you wish to install the Menu System, the Screen Generator or both (the default is for both these modules to be installed). You must type Y to at least one of these options.
The final field on the screen allows you to share WIZARD data files with another account (which should already have been set up with WIZARD). If you type the name of another account here, the WIZARD files in the new account will simply be pointers to the data files resident in the other account. This allows you to install WIZARD in numerous accounts, but to keep all the programs in one place.
If you hit
Once you have completed all this, hitting
WIZARD may ask for other information along the way, so keep watching. When WIZARD has finished installing, if all went well, you should be sitting in the new account (at the Menus if you chose to install them).
If any errors occurred during the installation process, they will be recorded in the MD (or VOC) file in an item called WIZ.INST.ERRS.
The WIZARD Installer allows you to install either the WIZARD Menus, the WIZARD Generator, or both into an account on your system. If you install only the Generator (i.e. you do not choose to install the menus) you ought to be aware of the following:
| FS | Screen formatter |
| WGEN | Screen generator |
| WIZ.GEN.ALL | Generate all screens |
| WIZ.IR | Columnar reports |
If you set your system up in this way, all the WIZARD functions will be available in the development account, but they will update the original account.
You should also be aware of the following details when installing WIZARD into an account: