MBF COMPANY CONFIDENTIAL FIELD INFORMATION BULLETIN SERVICE GROUP(S): MICRO,MINI MFG: BASIC FOUR NACS TYPE(S): N031 MFG. MODEL(S): DS-5XX/15XX BBVI CATEGORY: SOFTWARE DESC: O.S. & UTILITIES *** TABLE OF CONTENTS AS OF 12/21/90 *** FIB 00001.DS-5XX General Information..................................06/24/86 FIB 00002.PCs.that are compatible with PC-LINK........................09/04/86 FIB 00003.BOSS Release 6.2A Software Announcement.....................09/11/86 FIB 00004.Updated mnemonics for 4217/4218 printers on 1500 at OS 6.2A.10/01/86 FIB 00005.Possible.corruption of BOSS and MS-DOS partitions...........10/16/86 FIB 00006.Error 19 in the 'bencrypt' utility..........................10/17/86 FIB 00007.BOSS release 6.3A is now available..........................04/27/87 FIB 00008.BOSS release 6.3A Software Announcement.....................05/04/87 FIB 00009.Business BASIC/PC Release 1.3 Software Announcement.........05/04/87 FIB 00010.6.3B.O.S. available for MAI 1500............................10/30/87 FIB 00011.Announcing the Release of Business Basic/PC 1.5 [ WPSF 493 10/25/88 FIB 00012.6.3C Tape Operating System Available for 1500 Systems [ WPS10/25/88 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------Table Of Contents Pg01 of 01 FIB 00001 06/24/86 *** DS-5XX General Information *** This is to announce the availability of the MAI Basic Four\ DS-500 (Decision Support) Workstations. TABLE OF CONTENTS 1.0 INTRODUCTION 2.0 HARDWARE OVERVIEW 3.O INSTALLATION 3.1 SETTING UP THE DS-500 3.2 ENVIRONMENTAL AND POWER CONCERNS 3.3 CONNECTING DEVICES AND/OR OPTIONS 4.0 SYSTEM START UP 4.1 DISK SYSTEM INTRODUCTION 4.2 BOOTING FROM THE MS-DOS DISKETTE 4.3 HARD DISK SYSTEMS (THE DS-510 AND DS-520) 5.0 KEYBOARD 6.0 MS-DOS INTRODUCTION 6.1 THE IMPORTANCE OF BACKUP 7.0 FILES AND DIRECTORIES 7.1 FILE EXTENSIONS AND DIRECTORY NAMES 7.2 FILE COMMANDS 7.3 DIRECTORY COMMANDS 8.0 ADVANCED MS-DOS FEATURES 8.1 REDIRECTING STANDARD INPUT AND OUTPUT 8.2 FILTER COMMANDS 8.3 COMMAND PIPING 8.4 THE REAL TIME CLOCK 8.5 BATCH PROCESSING 8.6 THE AUTOEXEC.BAT FILE TABLE OF CONTENTS 9.0 OPTIONS AND PERIPHERALS 9.1 SETTING UP INTERNATIONAL KEYBOARDS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg001 10.0 TROUBLESHOOTING 11.0 COMPATIBILITY ISSUE 12.0 MAI PC-LINK 13.0 CONCLUSION 1.0 INTRODUCTION MAI Basic Four, Inc. is proud to present the DS-500 (Decision Support) Series Workstations. The DS-500 Series is a fully compatible MS-DOS~ hardware and software workstation designed to work in two environments. First, the DS-500 Series functions as a distributed processing executive workstation when connected to an MAI Basic Four\ host System via MAI\ PC-LINK. This allows the host system to distribute some of the workload to the workstation resulting in more efficient use of processing time. Second, the DS-500 Series can also be used as a stand alone user business solution, particularly for certain vertical applications. In either environment the DS-500 Series Workstations are a great enhancement to the MAI Basic Four line of solution-oriented systems. The DS-500 Series is unique to the MAI Basic Four family of systems in that it operates under the MS-DOS operating environment. This operating system allows the user access to the more popular application software programs for personal computing. Via PC-LINK some application software programs may be used in conjunction with the MAI Basic Four host system. This is an exciting feature that will be most beneficial to you, the user. This software announcement contains general information about the DS-500 Series Workstations, its operating system and an introduction to its use with the MAI Basic Four host system. Included are brief discussions about the following procedures: setup and installation, upgrade options, system start up and the MS-DOS operating environment. This document also contains a section labeled "troubleshooting" listing possible problems and their solutions. The DS-500 Series Workstations come with manuals for proper usage and operation of this system. This document will, at times, refer to these manuals as a point of reference or for a better understanding of the workstations themselves. Please read these manuals in addition to this document for a more complete understanding of the DS-500 Series Workstations. The manuals referred to in this document are as follows: 1. MAI Basic Four DS-500 Series Workstation User Guide #M6230 2. MAI Basic Four DS-500 Series Workstation GW-BASIC~ Guide #M6232 3. MAI Basic Four DS-500 Series Workstation MS-DOS Guide #M6231 2.0 HARDWARE OVERVIEW The DS-500 Series Workstations are a family of MS-DOS hardware and software compatible products. The family consists of three models: The DS-500, the DS-510, and the DS-520. All three models provide the following features: SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg002 * IBM\ PC FAMILY HARDWARE AND SOFTWARE COMPATIBILITY * HALF HEIGHT PROFILE, SMALL FOOTPRINT CCA * TILT AND SWIVEL MONITORS * IBM PC COMPATIBLE CARDSLOTS In addition to the system features, all three base CCA's come standard with the following features: * INTEL 8088 PROCESSOR * 256K RAM * IBM PC/AT-STYLE KEYBOARD * 2 SERIAL PORTS * 1 PARALLEL PORT * MONOCHROME MONITOR ADAPTER PORT * MS-DOS 3.1 OPERATING SYSTEM * GW-BASIC VERSION 3.1 * COMPLETE SET OF USER MANUALS MAI PC-LINK is also available on each CCA with a special market code at a discounted price. * DS-500 2 IBM COMPATIBLE 360KB 5 1/4" FLOPPY DRIVES 2 IBM COMPATIBLE CARD SLOTS * DS-510 1 IBM COMPATIBLE 360KB 5 1/4" FLOPPY DRIVE 1 10MB FIXED DISK DRIVE 1 IBM COMPATIBLE CARD SLOT * DS-520 1 IBM COMPATIBLE 360KB 5 1/4" FLOPPY DRIVE 1 20MB FIXED DISK DRIVE 1 IBM COMPATIBLE CARD SLOT The DS-500 incorporates single-board design, including the floppy disk controller, monochrome display adapter and three I/O ports. One or two additional IBM compatible option slots allow you to use any additional IBM compatible option cards and accessories with the DS-500 Series. The DS-500 Series offers several options to enhance and expand the systems (these are explained in further detail in Section IX, titled "Options and Peripherals"). A brief listing of some expansion options are listed here for your convenience: * 14" Monochrome display monitor * 14" Color display monitor with color graphics card * Expansion chassis - The expansion chassis has the same small footprint as the base DS-500 Series CCA's. It sits under and is connected to the base CCA. This allows the user to connect up to four additional IBM PC compatible controller cards to the DS-500 series. * 256K memory upgrade kit - This kit contains an additional set of 256K RAM which will plug onto the motherboard and increase the RAM by 256K. Two 256KB upgrade kits provide a maximum of 768KB; however, most MS-DOS programs only access up to 640KB. 3.0 INSTALLATION Your user's guide contains a detailed description of how to connect SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg003 your equipment. The user's guide will also explain how to install MS-DOS onto your hard disk drive. This section will briefly discuss this procedure, so please use your user's guide for proper installation. 3.1 SETTING UP THE DS-500 Please refer to Chapter One in your user's guide and follow the procedure outlined under "Setting up the DS-500." This section covers unpacking the computer and setting it up where you will be using it. 3.2 ENVIRONMENTAL AND POWER CONCERNS Please refer to your user's guide to determine the proper environment in which to set up your DS-500. The DS-500 runs on 115 volts AC. Make sure that you have a grounded power outlet that can accommodate a three-pronged plug. The international DS-500 is set up to run on 220 volts AC. 3.3 CONNECTING DEVICES AND/OR OPTIONS When installing devices and/or options, please keep in mind that static electricity may be a problem in your area. Always touch the back of the unit after removing the cover so as to be grounded prior to handling any internal components. Please follow all directions in Chapter One of your user's guide to properly set up your DS-500 for first time use. Chapter Four in your user's guide further discusses the addition of options and peripherals to your DS-500. 4.0 SYSTEM START UP 4.1 DISK SYSTEM INTRODUCTION On the DS-500 Series you will find one (DS-510/DS-520) or two (DS-500) 5 1/4" floppy disk drives. The floppy disk drive can read or write a 360KB diskette. There are two kinds: one can read or write on only one side of a diskette, the other works on both sides. Each side can hold about 180,000 characters of data. Each drive has a "name" of one letter followed by a colon. The drives are named A: and B:. The fixed disk drive is named C:. If you are using a DS-510 or a DS-520 the floppy drive can be referenced by either A: or B:. For example, if you have booted the DS-500 Series from the MS-DOS diskette in Drive A, and you want to switch to Drive B, type: B: and press RETURN. The B> prompt now appears on the screen, indicating that drive B is now the primary, or active, disk drive. To refer to files in drive A you must type the prefix A:. To insert a diskette in the diskette drive, hold the diskette with the label side up and slide it into the slot. You will hear a click when it is in place. Press the button labeled PUSH until it locks in place. The DS-500 cannot read or write to the diskette unless the PUSH button is engaged. To release the diskette, press the PUSH button again. The diskette will pop out of the drive. CAUTION - Do not remove a diskette from the drive while the red SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg004 drive-active light is on - you could damage the diskette and lose information that is stored on it. The drive-active light indicates that the drive is in the process of reading or writing to the diskette. Please see your user's guide, Chapter 3, for more information on caring for your diskettes. To make a copy of your MS-DOS 3.1 diskette please follow the instructions in your user's guide, Pages 1-13 to 1-16. 4.2 BOOTING FROM THE MS-DOS~ DISKETTE Place your diskette labeled MS-DOS 3.1 (diskette #1 of 2) in your floppy disk drive A press the PUSH button, and turn on the power. The following message now appears: Phoenix ROM BIOS version 1.11 The computer now runs a self test, including a check of system RAM (Random Access Memory), displaying the message. xxx kb Good The final value displayed is the total size of system RAM measured in kilobytes. A single short beep will signify that everything is in order. If you have started the DS-500 without properly inserting the MS-DOS diskette, you will see the following message: Non System disk or disk error Press a key to re-try If you see this message, make sure that the MS-DOS system diskette is in drive A and that the PUSH button is engaged. Then press any key. If you see something else on the screen, do not hear a beep, or hear more than one short beep after the self-test, turn to Appendix A. The MS-DOS system files are now being loaded from the MS-DOS diskette into the internal memory of the DS-500. As this takes place, you momentarily see the message: Booting MS-DOS You then see the message: IO System Rev x.xx MS-DOS version x.xx (C)Copyright 1981,85 Microsoft Corp. Command v. x.xx (C)Copyright Microsoft Corp. 1981,85 Current date xx-xx-xx Enter new date (mm-dd-yy) MS-DOS is now asking you to enter the date. Enter the current date in the format mm-dd-yy, where SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg005 mm is a number from 01 to 12 that indicates the month dd is a number from 01 to 31 that indicates the day of the month yy is a number from 80 through 99 that indicates the year. A dash (-) or slash (/) separates the month, day, and year. Use the number keys on the top row of the keyboard to enter the date. The keys on the numeric keypad will not generate numbers unless you first press the NUM LOCK key. After you have entered the date, press the RETURN key to send the information to MS-DOS. Now the screen displays the message Current time is 0:00:00.00 Enter new time: Enter the time in format hh:mm, where hh is a number from 01 through 23 that indicates the hour. mm is a number from 00 through 59 that indicates the minutes in the hour. A colon (:) separates the hours and the minutes. MS-DOS uses a 24 hour clock. For instance, you would enter 1:30 p.m. as 13:30. After typing the time, press the RETURN key. It is not necessary to enter the date or time every time you start your DS-500. If you do not want to enter the date or time just press RETURN without typing anything. (Note, however, that the date will then be incorrect.) If you have a Real Time Clock attached to your DS-500 please see the "AUTOEXEC.BAT" file for information for keeping the correct time and date. If you make a mistake entering the date or time, you can correct it by erasing what you typed with the BACKSPACE key and retyping the response. If you have already pressed the RETURN key, you can still correct the error with the DATE and TIME command. When the MS-DOS prompt, A>, appears on the screen, type the word DATE (to correct the date) or TIME (to correct the time) and press RETURN. Now the system prompt A> appears on the screen. You have loaded the operating system and MS-DOS is now ready to accept commands. What you have just done is called loading MS-DOS or booting the system. You must load MS-DOS from diskette every time you turn on the DS-500, unless you transfer MS-DOS to a hard disk, as explained in the next section. 4.3 HARD DISK SYSTEMS (THE DS-510 AND DS-520) Before you can use your hard disk on your DS-510 or DS-520 you must first follow these steps as outlined in you user's guide. 1. Initialize the hard disk (HDINIT) 2. Spare the bad sectors on your hard disk (SPARE) 3. Set up your MS-DOS partition (FDISK) 4. Format the hard disk (FORMAT) After you have run these programs, you can copy the MS-DOS files onto the hard disk and begin working directly from the disk. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg006 But before you turn on the computer and initiate the hard disk preparation procedure, there is something you must do. On the bottom of the computer, you will find a label called the "Hard Disk Error Map." This is a listing of the errors that the manufacturer of the hard disk found when the disk was tested. When you run the SPARE program, you will need the numbers recorded in Cylinder (Cyl) and Head (Hd) columns of the Hard Error Map." Write those numbers in the following form. (If there are no number in the map it means that the manufacturer found no errors on your disk.) Hard Error List _ _ _ _ _ _ Cyl Hd _ Cyl Hd _ Cyl Hd _ Cyl Hd _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ NOTE: For hard disk preparation procedure, you must run only MS-DOS 3.1 utilities programs. You cannot initialize the hard disk with the HDINIT program from MS-DOS 2.1 and then run the SPARE and FDISK programs from MS-DOS 3.1. If your hard disk was previously initialized with MS-DOS 2.1, you must refer to the MS-DOS 3.1 Manual for updating to MS-DOS 3.1. Please refer to Chapter One in your user's guide for all information pertaining to the set-up of your hard disk. 5.0 KEYBOARD The keyboard for the DS-500 Series Workstations is similar to the IBM PC/AT- style keyboard. Please refer to Chapter Two in your user's guide for all pertinent information regarding usage and familiarization with your keyboard. Please take this time to familiarize yourself with the layout of this keyboard. You should particularly take note of the CAPS LOCK, NUM LOCK, and SCROLL LOCK/BREAK keys. 6.0 MS-DOS INTRODUCTION MS-DOS contains two types of commands, those that are internal and those which are external. Internal commands are those which are available to the user at all times from anywhere in MS-DOS. External commands are resident in a file which must be executed from the directory in which they lie. Directories will be discussed in Section VII. 6.1 THE IMPORTANCE OF BACKUP DS-510 and DS-520 users must understand the importance of BACKUP and RESTORE. BACKUP and RESTORE are the most important commands to keep in mind. In order to maintain a current backup of all files on the hard disk this listing should be updated on a daily basis. Please refer to your MS-DOS Guide for a full discussion of the BACKUP and RESTORE commands. 7.0 FILES AND DIRECTORIES SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg007 MS-DOS organizes files into directories. Directories divide the files into separate groups in separate places. When you FORMAT a disk you create a root directory for that disk. MS-DOS lets you organize your files in a hierarchical directory structure. This type of structure allows you to create subdirectories from the root with the MKDIR command which we will discuss soon. This type of structure is called a tree structure. A typical tree structure is shown below: ROOT _ _ _ _ _ _ SUBDIR1 SUBDIR2 _ _ _ _ _ _ FILE1 _ FILE2 FILE FILE _ _ SUBDIR3 7.1 FILE EXTENSIONS AND DIRECTORY NAMES MS-DOS file names have two parts: a one to eight character file name, and an optional file name extension consisting of a period(.) and one to three characters. If you are specifying a file that is not on the current disk drive, a disk drive letter (called a designator) must also be prefixed to the beginning of the file name. An example of a complete file name is B: TEST.DAT The file TEST.DAT is on the disk drive B. TEST is the file name and .DAT is the file name extension. If the file name is followed by an extension, you must specify both the file name and the extension when referring to it. Please read Chapter Two in your MS-DOS manual for further guidelines for creating file names, and also contains reserved extensions and file names. In order to access a file that is not in the current directory, you must tell MS-DOS the files' location on the tree. You do so by specifying the drive designator followed by a colon (:) and a backslash ( ) between all directory paths you are attempting to designate. For example if you are in SUBDIR2 on Drive C and want to specify a file called FILE1 on Drive C in SUBDIR1 you would type: C: SUBDIR1 FILE1 This will specify the path to the file name that you are referring. Until you become more familiar with the tree structure of your DS-500, please indicate full path names and extensions when specifying a file or directory. 7.2 FILE COMMANDS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg008 In order to display a directory, use the command: DIR This will display the current directory listings to the screen. To display the contents of a file, use the command: TYPE filename.ext "TYPE" will display the file contents to the screen. Use full pathnames and extensions to display, for example, the contents of another directory. DIR C: SUBDIR1 This will display the contents of sub-directory SUBDIR1 on Drive C. The syntax used in copying a file is as follows: COPY C: SUBDIR1 FILENAME.EXT C: SUBDIR2 FILENAME.EXT where the first file named is the source file to copy and the second file named is the new name. To rename a file use the following: REN C: SUBDIR1 FILENAME.EXT C: SUBDIR2 NEWNAME.EXT where the first file named is the source file to be renamed and the second file named is the target. To delete a file use the following syntax: DEL C: FILENAME.EXT Please indicate full path names when specifying a file to be deleted so as to avoid deleting the wrong file. Please refer to Chapters Two and Three in your MS-DOS guide for a full explanation regarding these commands. 7.3 DIRECTORY COMMANDS To create a directory use the following command: MKDIR C: SUBDIR Where C is the designated disk drive and the path indicates where to place the named subdirectory. To change to a directory use the following command: CHDIR C: SUBDIR Where C is the designated disk drive and the path indicates which directory MS-DOS is to make active. Please read Chapters Two and Three in your MS-DOS guide to get a full explanation of the use of these commands. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg009 8.0 ADVANCED MS-DOS FEATURES 8.1 REDIRECTING STANDARD INPUT AND OUTPUT MS-DOS normally assumes that input comes from the keyboard and output goes to the terminal screen. You can change that assumption by redirecting the input to come from a file or the output to go to a file or printer. In order to get input from a file rather than from the keyboard, enter the "less than" sign (<) and the file name at the end of a normal command. For example, if a program named ADDRFORM will automatically format information from a data file into an envelope address file, you can retrieve the appropriate file with the command: ADDRFORM ). For example, the DIR command normally displays a list of files on the screen. Your can redirect that output to a file by giving a command such as: DIR >DIR.LOG This command places the output of the DIR command directly into the file named DIR.LOG. If that file does not exist, MS-DOS creates it. If the file does exist, however, this method erases any information already in the file when it writes the new information. If you want to keep the information that is already in a file and add other information to the end of the file, you have to type two greater than signs (>>). For example, if you want to add the current directory listing to a file that contains a permanent list of important directories, you can type: DIR >>DIR.LOG This command tells MS-DOS to append the output of the DIR command to the specified file. In order to help you remember how the I/O redirection characters work, you can think of them as arrows that point in the direction that the input/output will take. You can think of the two "greater than" arrows as pointing to the end of the specified file. 8.2 FILTER COMMANDS MS-DOS provides three special filter commands - MORE, FIND, and SORT: Command Function MORE Displays standard terminal output one screen at a time. FIND Searches for a constant string of text in a file. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg010 SORT Sorts text alphabetically These commands input data, transform it in some way, and then output it to a file or to the screen. They are thus said to "filter" the data. The filter commands are often used with another MS-DOS feature called piping, which is discussed in the next section. The filter commands are external commands, so they must be in the current directory or in the path MS-DOS searches (refer to the PATH command in your MS-DOS manual). Otherwise, you should specify the proper path name. 8.3 COMMAND PIPING The MS-DOS piping feature takes the output of one program and uses it as the input to another. By using the vertical bar character ( ) between commands, you tell MS-DOS to store the output of one program in a temporary file, and then use that temporary file as input to the next program. NOTE: The temporary file is named %PIPEx.$$$ and is placed in the root directory of the default drive. For example, if you want an alphabetically sorted listing of the current directory, you can pipe the output of the DIR command to the SORT filter by giving the command: DIR SORT This command sends the output directory listing to the sort command, which will sort the listing alphabetically before displaying it to the screen. You can use more than one piping character in a command line. For example the alphabetical listing from the example above can be displayed one screen at a time by adding the MORE command as follows: DIR SORT MORE This command sends the directory listing to the SORT command, then sends that sorted listing to the MORE command, which will display it one screen at a time. The ability to pipe output through filter commands as input to another program can be extremely useful. For example, the FIND and SORT command can be used along with the redirection capability to create a file that contains a sorted listing of all files that have a particular file extension. You can do this with the following command: DIR B: FIND ".TXT" SORT >A:TEXTLIST When this command is executed, the file TEXTLIST on Drive A will contain an alphabetical listing of all the .TXT files on the diskette in Drive B. The CONFIG.SYS File The CONFIG.SYS file allows you to customize your DS-500 in a number of ways. Every time MS-DOS starts, it looks for CONFIG.SYS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg011 in the root directory. If it finds the file, it uses commands contained there to set up such items as the device drivers and the number of allowable open files. The commands are BREAK=, BUFFER=, COUNTRY=, DEVICE=, FILES=, and SHELL=. You can enter these commands into a CONFIG.SYS file in any order, but they will not go into effect until you reboot MS-DOS. 8.4 THE REAL TIME CLOCK If you have installed the optional backplane with the real time clock/calendar chip you can set the time and date with the SETCLOCK command. You can then use the RTCLOCK command to update the MS-DOS system clock. SETCLOCK (SETTING THE REAL TIME CLOCK) You set the time and date by entering the SETCLOCK followed by the correct date and time in the same date or time syntax used by the DATE and TIME command. 8.5 BATCH PROCESSING Batch processing files are a series of commands within a file that has a .BAT file extension. When you run a batch file, MS-DOS executes the commands in that file in the order in which they were originally entered, just as if they were submitted one at a time from the keyboard. Batch processing can thus be a substitute for commonly used commands. Please see your MS-DOS guide, Chapter Four, Pages 4-15 to 4-18 for information regarding creating and executing batch files. 8.6 THE AUTOEXEC.BAT FILE An AUTOEXEC.BAT file is a special kind of batch file. This batch file resides in the root directory. Any commands that are entered in this file will automatically be executed each time MS-DOS is booted. Since the AUTOEXEC.BAT file can include any MS-DOS command, applications that you will always initially use after booting may be entered in this file. We recommend that if using an AUTOEXEC.BAT file, that you use one of the following options for setting the date and time, as the AUTOEXEC.BAT supplants the normal boot routine of asking for date and time: 1. If you have the real time clock option, enter the RTCLOCK command in the AUTOEXEC.BAT file so the system clock can be automatically set to the correct real time. 2. If you do not have the real time clock option, it is recommended that you include the DATE and TIME commands in the AUTOEXEC.BAT file. 9.0 OPTIONS AND PERIPHERALS A discussion of the addition of various options and peripherals to your DS-500 Series Workstation is included in fine detail in Chapter Four of your user's guide. A list of proper internal switch settings is included on Page 4-19 of your user's guide. There is one group of settings which is not SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg012 included in your user's quide that is included here for your benefit. There are two jumpers on the motherboard, at locations J30 and J31, which govern the addressable amount of memory. For your convenience the chart below shows the correct jumper settings for the three levels of memory: CONFIGURATION ASSEMBLY MEMORY J30 J31 BANK DASH NO. SIZE -01 256K IN IN 0 -02 512K OUT IN 0+1 -03 640K (768KB) OUT OUT 0+1+2 9.1 SETTING UP INTERNATIONAL KEYBOARDS Please see Appendix C in your MS-DOS guide for a full explanation of how to set up your DS-500 Series Workstation for use with international keyboards. 10.0 TROUBLESHOOTING The following is a listing of where to locate specific error messages and where to find possible solutions to specific problems. To date, there have been no problems reported that have not been covered in the manuals. INSTALLATION PROBLEMS APPENDIX C USER'S GUIDE HARDWARE MESSAGES APPENDIX G USER'S GUIDE SYSTEM ERROR MESSAGES APPENDIX D MS-DOS~ GUIDE 11.0 COMPATIBILITY ISSUE As with all micro-computers that claim 100% compatibility with the IBM\ product, this should be taken with a grain of salt. No product can be 100% the same as another unless it is in fact that product. However, the DS-500 Series Workstation is as close a product as is available on the marketplace today. All MAI Basic Four, Inc. branches, and subsidiaries should have the following manuals to assist them in determining which foreign devices have been proven to work, as well as a listing of which software applications have been tested and are known to work. These listings are kept current and up-to-date. The manuals are: 1. Software Applications Guide. (M6233) 2. Interface Guide. (M8104) Please refer to these manuals to determine if particular devices and/or software applications will run on the DS-500 Series Workstation. 12.0 MAI PC-LINK One of the major uses of the DS-500 Series Workstation is the use of the workstation as a terminal to a MAI Basic Four host system. This is accomplished through the use of MAI PC-LINK. MAI PC-LINK allows the exchange of files between the MAI Basic Four Host System and the DS-500, as well as allowing the DS-500 to emulate a terminal on the MAI Basic Four host system. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg013 For a full explanation of MAI PC-LINK, please refer to your MAI PC-LINK manual. NOTE: Please be aware that, as of this date, MAI PC-LINK does not support international character sets. There is no plan at this time to include international character support on MAI PC-LINK. 13.0 CONCLUSION We have attempted to be as concise as possible in presenting this brief look into the world of the DS-500 Series Workstation. If you have any questions that are not completely answered in this announcement or the documents that are referred to, please feel free to call MAI Basic Four Product Support at (714)730-3131. ORIGINATOR: MBF SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB001 Pg014 FIB 00002 09/04/86 *** PCs that are compatible with PC-LINK *** Below is a list of compatible PCs and portable PCs that will work with PC-LINK. Also included in the list is a number of PCs that have been proven to be NON-compatible. Some PCs have a question mark associated with them because they are possibly compatible but have yet to be thoroughly tested. LIST OF PC COMPATIBILITY WITH PC-LINK (AS OF JUNE 19, 1986): PC COMPATIBLE? --------------------------------------------- ACT APRICOT............................N AT&T 6300 PC...........................Y PC PLUS......................? (PROBABLY Y) UNIX PC...........................? CAD COUNSEL PROTEAN....................N CANNON AS-100..........................N COLBY PC 3.2...........................N COLUMBIA 1600 VP.......................? COMMODORE PC10.........................N COMPAQ DESKPRO.........................Y DESKPRO PLUS....................Y PORTABLE........................Y PORTABLE PLUS...................Y 286 DESKPRO.....................Y 286 PORTABLE....................Y COMPUCORP OMEGAMITE....................N CORONA PC..............................Y MEGA PC.........................N PORTABLE PC.....................N PPC 400.........................Y DATA GENERAL DG1.......................N DATAVUE SERIES 30 PC...................N `AW` .D EC RAINBOW............................N VAX MATE AT........................? DIGIGRAPHIC EXTRA......................N EAGLE PC...............................N PC PLUS..........................? 1600.............................N SPIRIT...........................? TURBO............................N ELECTRO DESIGN IMP-12..................N EPSON QX-10............................N QX-16............................N ERICSSON PC............................? PORTABLE PC...................? FUTURE COMPUTER FX-20..................N GRID...................................N HP 150.................................N VECTRA..............................Y HYPERION...............................N IBM PC.................................Y XT.................................Y AT.................................Y PORTABLE...........................? 3270...............................? 5550 (JAPANESE PC).................N PC JR..............................N INTERTEC HEADSTART 512.................N SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB002 Pg001 ITT XTRA...............................Y XTRA XP............................Y JONOS 2150i............................N KAYPRO 16..............................Y PC..............................N LEADING EDGE...........................Y LOGICAL LX-T...........................N MAD1...................................N MICRO CRAFT DIMENSION..................N MINDSET................................N MINOLTA PCW-1..........................? NCR MODEL 4............................? NEC APC................................N APC III............................N APC 4..............................N PC-8801A...........................N NIXDORF PC.............................? NORTH STAR DIMENSION...................N OLIVETTI M21...........................? M24...........................Y M28...........................N PC............................N OLYMPIA PEOPLE.........................N OTRONA 2001............................N ATTACHE 8:16....................N OSM PC.................................N PANASONIC SR. PARTNER..................Y BUSINESS PARTNER 286.........N PC'S LIMITED...........................N POLO...................................N PRONTO.................................N SANYO 555..............................N MBC 775..........................? MBC 880..........................Y MBC 990..........................N SEATTLE COMPUTER GAZELLE II............N SEQUA..................................N SEVILLE XT Turbo.......................? SHARP PC 5000..........................N 7000..........................? 7500..........................N SPERRY PC..............................? (PROBABLY Y) AT or IT........................? (PROBABLY Y) STEARNS DESKTOP........................N STM PIED PIPER.........................N STRATEGIC TECHNOLOGIES PC TRAVELER.....N TANDY 1000.............................Y 1200.............................? (PROBABLY Y) 2000.............................N 3000.............................? TAVA PC................................Y TELEVIDEO 1605.........................? 1605 PLUS....................Y AT...........................? TPC2.........................? TELECAT-286..................N TELEX 11-86............................N TI PROFESSIONAL........................N PORTABLE PROFESSIONAL...............N TOSHIBA T-300..........................N VICTOR VI..............................? VPC.............................? SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB002 Pg002 9000............................N VISUAL COMPUTER........................? WANG PC................................N APC...............................? WYSE 1100..............................Y XEROX PC...............................? 1810/1850........................N ZENITH Z100............................N Z150............................Y Z158............................? Z160............................? Z171............................? ORIGINATOR: D. WENZEL SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB002 Pg003 FIB 00003 09/11/86 *** BOSS Release 6.2A Software Announcement *** Level 6.2A BOSS operating system and its related software products are now available for the new MAI 1500 system. BOSS 6.2A is a multi-user business operating system with Business BASIC (BB6) integrated into the O/S. Since BB6 is based on BB3 and BB4, conversions from older MAI Basic Four equipment will be simplified. BOSS allows both Business Basic and MS-DOS applications to reside on the MAI 1500 in their own unique partitions on the hard disk, allowing the user to operate in either the single-user MS-DOS environment or the multi-user BASIC environment but not concurrently. The partition sizes are user configurable. The MAI 1500 is a powerful, multiuser, business, IBM PC/XT/AT-compatible computer based on the 16-bit Intel 80286 microprocessor. The MAI 1500 system uses industry standard 7-bit (low order) ASCII, the same as the MAI 2000. Conversion and transport utilities are available in the BQR/ATP package to allow data interchange with any Basic Four system capable of communicating with the ATP module. This Software Announcement contains general and specific information about the BOSS 6.2A operating system, system start-up, and shutdown, software installation, system configuration, hardware considerations and set-up procedures, cabling, back-up, restore techniques, system customization, disk compressor utilization, system security, transporting methods and procedures, helpful hints and useful information, along with summary of available documentation. The 6.2A BOSS release contains the following bundled software disks: (For ordering information refer to the appropriate Marketing Announcement.) BOSS SYSTEM DISK 6.2A BOSS ULIB DISK 6.2A 1500 DISK COMPRESSOR MS-DOS 3.1 (2 DISK) SETUP AND TEST DISKETTE 1.0 GRAPHICS DISPLAY ADAPTER DISK The following software may be ordered separately: 1500 ATP/BQR 6.2A ENCRYPTION DISK TABLE OF CONTENTS 1.0 BOSS OPERATING SYSTEM 1.1 Business BASIC Level 6 1.2 Differences Between BB4, BB6, BB7 and BB8 2.0 SYSTEM START-UP AND SHUTDOWN 2.1 System Start-up 2.1.1 From Floppy Disk Drive 'A' 2.1.2 From Active Partition on Hard Disk Drive 'C'. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg001 2.2 System Shutdown 3.0 INSTALLATION 3.1 System Set-Up 3.2 Installing MS-DOS 3.2.1 Initialize Hard Disk 3.2.2 Create MS-DOS Partition 3.2.3 Formatting and Copying MS-DOS to the Hard Disk 3.3 Installing BOSS 3.3.1 BOSS Disk Set-Up 3.3.2 Create BOSS Partition 3.3.3 Loading BOSS to the Hard Disk 3.4 Configuring the System 3.4.1 System Configuration 3.4.2 Terminal Support 3.4.2.1 International Terminal Support 3.4.3 Printer Support 3.4.3.1 International Printer Support 3.5 Finish Installation 4.0 SYSTEM HARDWARE 4.1 Hardware Configuration 4.2 System Hardware Set-Up 4.3 System Cabling 5.0 BACK-UP AND RESTORE 5.1 Back-Up 5.2 Restore 6.0 SYSTEM CUSTOMIZATION AND UTILIZATION 6.1 System Buffering 6.1.1 Device Buffering 6.1.2 File Information Buffering 6.2 The File System 6.3 Setting-Up Terminal Parameters 6.3.1 The Color Monitor 6.3.2 Non-standard Serial Ports 6.3.3 Auto-Starting 6.3.4 Ghost Tasks 7.0 DISK COMPRESSOR SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg002 7.1 Disk Map (DISMAP) 7.2 Disk Compressor (DISCPR) 8.0 SYSTEM SECURITY 8.1 1500 System Password Procedure 8.2 Application Program Encryption 9.0 TRANSPORT FROM OTHER MAI BASIC FOUR\ SYSTEMS 9.1 Software/Hardware Requirements and Set-Up 9.2 MAI 13xx to MAI 1500 Transporter (Bit Mover) 9.3 MAI 2000 to MAI 1500 Transporter (BQR/ATP) 9.4 Transport Consideration 10.0 FOR YOUR INFORMATION 11.0 HELPFUL HINTS 11.1 Loading the Printer VFU 12.0 DOCUMENTATION 1.0 BOSS OPERATING SYSTEM The operating system is called BOSS. It is a multiuser business operating system with Business BASIC integrated into the O/S. BOSS is BB3-BB4 compatible. (A chart comparing BOSS to BB4, BB7 and BB8 is included in the announcement). BOSS is a very fast operating system which provides excellent expansion capabilities for future use. 1.1 Business BASIC Level 6 MAI Business BASIC Level 6 (BB6) for the MAI 1500 is an integrated programming language, file system and utilities. Because it is based on BB3 and BB4, conversions from older MAI Basic Four equipment will be simplified. The language itself has many extensions not available in most BASIC languages including dynamic variable allocation, 14 digit precision decimal arithmetic, unlimited line length, and unlimited nesting of "FOR/NEXTs". All are designed to speed the programming effort, helping to reduce expensive program coding and maintenance time and increase the customer's profitability. The file system is integrated with the language so no external calls are needed. It supports a sophisticated keyed-file structure that is much easier to use and executes faster than that found on other systems. BB6 also includes SORT files, which provide a built-in keyed access to data files. BB6 creates an interactive programming environment. As statements are entered, they are translated into an internal token format. This process not only eliminates the need for compiling, but provides for greatly enhanced execution. Other features include: o Floating point capability SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg003 o Pre-defined functions with ability to define user-specific functions o Extensive algebraic functions o String functions o Support of Indexed, Direct, Sort and Program Files o Record locking o Program overlay support o File backup and restore facilities o Program maintenance tools for listing, editing, merging and deleting programs o Source code debugging and statement execution tracing o In-line execution of operating system commands o Compressed numeric data storage to conserve disk space 1.2 Differences Between BB4, BB6, BB7 and BB8 The following charts show the difference between BB4 (used on 13xx system), BB6 (used on the MAI 1500), BB7 (used on the MAI 2000) and BB8 (used on the MPx family). An "X" indicates that the command or feature is present in that version. BASIC Statements BB4 BB6 BB7 BB8 Comments ! X X ADD X X Creates entry in File Control Table ADDE X X Add error handler to public memory ADDR X X X X BEGIN X X X X CALL X X X X CLEAR X X X X CLOSE X X X X DEF FNx($) X X X X DELETE X X X X DIM X X X X DIRECT X X X X DISABLE X X Prevents access to a logical disk DROP X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg004 EDIT X X X X ENABLE X X Allows access to a logical disk ENCRYPT X Encrypts BASIC program END X X X X ENDTRACE X X X X ENTER X X X X ERASE X X X X BASIC Statements BB4 BB6 BB7 BB8 Comments ERROR X X X Displays current BASIC error ESCAPE X X X X EXECUTE X X X X EXIT X X X X EXITTO X X X X EXTEND X Allows longer variable names EXTRACT X X X X EXTRACT REC X X X X FILE X X X X FIND X X X X FIND RECORD X X X X FLOATING PT. X X X X FOR/NEXT X X X X GET X X Reads from a specific disk location GOSUB X X X X GOTO X X X X IF X X X X INDEXED X X X X INPUT X X X X INPUT RECORD X X X X IOLIST X X X X LET X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg005 LIST X X X X LOAD X X X X LOCK X X X BASIC Statements BB4 BB6 BB7 BB8 Comments MERGE X X X X NEXT X X X X NO EXTEND X Takes system out of EXTEND mode ON GOSUB X X Transfers program to a subroutine ON GOTO X X X X OPEN X X X X OPEN INPUT X X Open a file in read only mode PRECISION X X X X PREFIX X Defines list of directories to search PRINT X X X X PRINT RECORD X X X X PROGRAM X X X Defines parameters of a Program file PSAVE X Copies a program (obj code only from memory to a Program file on disk PUT X X Writes data to a specific disk loc. QUIT X Enter command language from Business BASIC RANDOMIZE X Establish starting seed value for RND READ X X X X READ RECORD X X X X RELEASE X X X X REM X X X X REMOVE X X X X RENAME X X Rename a file RESERVE X X Restricts logical disk access RESET X X X X BASIC Statements BB4 BB6 BB7 BB8 Comments SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg006 RETRY X X X X RETURN X X X X RUN X X X X SAVE X X X X SELECT X X Specifies sequence of directories used in a file search SEQ X Supplies program statement numbers SERIAL X X X Defines a serial file SETCTL X X X Program control is transferred to another part of the program SETDAY X X X X SETERR X X X X SETESC X X X X SETTIME X X X X SETTRACE X X X X SORT X X X X START X X X X STOP X X X X STRING X Defines a UNOS string file TABLE X X X X UNLOCK X X X X VMERGE X Program merge WAIT X X X X WRITE X X X X WRITE RECORD X X X X FUNCTIONS BB4 BB6 BB7 BB8 Comments ABS X X X X AND X X X X ASC X X X X ATH X X X X ATN X Returns the arctangent BIN X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg007 BSZ X X Returns bytes of available memory CHR X X X X COS X Cosine CPL X X X Converts BASIC statement to complied form CRC X X X X DEC X X X X DSD X X Returns info on specified directory device or task EPT X X X X ERR X X Returns an integer value that depends on value of ERR variable EXP X Exponential FID X X X X FNx($) X X X X FPT X X X X GAP X X X X HSA X X Variable in BB8 HSH X X X X HTA X X X X FUNCTIONS BB4 BB6 BB7 BB8 Comments IND X X X X INT X X X IOR X X X X KEY X X X X LEN X X X X LOG X Natural logarithm LRC X X X X LST X X X Converts complied BASIC stmt to English text format LVL X Returns level of BASIC software or file system MAX X Maximum argument value SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg008 MIN X Minimum argument value MOD X X X X NOT X X X X NUM X X X X PCK X Stores numbers in packed format PGM X X X Returns complied format of designated statement number POS X X X X PUB X X X Returns info on public programs RND X Random number SIN X Sine SGN X X X X SGR X Square root SSZ X X Variable in BB7 & BB8 FUNCTIONS BB4 BB6 BB7 BB8 Comments STR X X X X TBL X X Same as TBL=option + TCB X X Variable in BB7 & BB8 TIM X X Variable in BB7 & BB8 TSK X X X Returns memory parameters of active tasks TSK(O) X X X Lists all tasks & terminal devices UNT X Returns lowest unused unit number UPK X Unpack XOR X X X X VARIABLES BB4 BB6 BB7 BB8 Comments CSW X Tells if current program is a RUN or CALLed program CTL X X X X DAY X X X X DSZ X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg009 ERR X X X X HSA X X Function in BB6 PFX X X Returns prefix list PGN X PNM in BB7 & BB8 PNM X X PGN in BB6 PSZ X X X X SPF X Current system prefix SSN X X X X SSZ X X Function in BB6 SYS X X X X TCB X X X Function in BB6 TIM X X X Function in BB6 TSM X Termination status message OPTIONS BB4 BB6 BB7 BB8 Comments DOM= X X X X END= X X X X ERR= X X X X IND= X X X X IOL= X X X X ISZ= X X X Allows file to be accessed as an indexed file KEY= X X X X LEN= X X X X SEQ= X X Specifies tape file # to be opened SIZ= X X X X TBL= X X X X TIM= X X X X PRIORITY= X Spooled priority CLASS= X X Name of class of spooler forms COPIES= X Number of spooled copies OPTS= X Specify printer attributes SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg010 CONSOLE MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control * * terminal messages, and printers. * * * ************************************** BB4 BB6 BB7 BB8 Comments @ (x) X X X X @ (x,y) X X X X '8L' X X X 8 lines to the inch 'BB' X X X Begin blink 'BC' X Back cursor 'BE' X X X Begin echo 'BG' X X X Begin to generate ERROR 29 'BH' X 'BI' X X X Begin to input transparency 'BO' X X X Begin output transparency 'BR' X X Set reverse video 'BS' X X X X 'BT' X X X Begin input buffering 'BU' X X X Begin underline mode 'CE' X X X X Clear screen to end of page 'CF' X X X X 'CH' X X X X 'CI' X X X Clear input buffer 'CL' X X X X 'CR' X X X X 'CS' X X X X 'DC' X X X Delete character 'DN' X Move cursor down one line * See Section 3.4.2 CONSOLE MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control * SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg011 * terminal messages, and printers. * * ************************************** BB4 BB6 BB7 BB8 Comments 'EB' X X End blinking 'EE' X X X End echo 'EG' X X X End generation of ERROR 29 'EH' X 'EI' X X X End input transparency 'EL' X X X 'EO' X X X End output transparency 'EP' X X X 'ER' X X End reverse video 'ES' X X X X 'ET' X X X End input buffering 'EU' X X X End underline 'FF' X X X 'HT' X Horizontal tab 'IC' X X X Insert character 'KL' X Keyboard lock 'KU' X Keyboard unlock 'LD' X X X X 'LF' X X X X 'LI' X X X X 'LT' X Move cursor left one space 'NL' X New line 'PE' X X X End protect mode * See Section 3.4.2 CONSOLE MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control * * terminal messages, and printers. * * ************************************** BB4 BB6 BB7 BB8 Comments SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg012 'PG' X X X Send screen to local serial printer 'PL' X Page mode used with first line of plot data 'PM' X X X Causes terminal to enter plot mode 'PS' X X X Start protect mode 'PT' X Partial transmit 'RB' X X X X 'RC' X X X Read cursor 'RT' X Move cursor one space to the right 'S2' X X X X 'S3' X X X X 'S4' X X X X 'S5' X X X X 'S6' X X X 'S7' X X X X 'S8' X X X X 'SB' X X X X 'SI' X 'SF' X X X X 'SL' X X X X 'SO' X 'TL' X Transmit line unprotected 'T1' X * See Section 3.4.2 CONSOLE MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control * * terminal messages, and printers. * * ************************************** BB4 BB6 BB7 BB8 Comments 'TP' X Transmit line protected 'TI' X 'TR' X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg013 'TS' X Transmit screen protected 'UP' X Move cursor up one line 'VT' X X X X In addition to the differences outlined in the chart, the following should be noted: The field separator on the MAI 1500 is an '8A', on other BASICs using the lower ASCII set (EX. the MAI 2000) the field separator is an '0A'. BB6 fully evaluates conditional expressions, where as other MAI BASIC FOUR BASICs terminate evaluation when a false condition is encountered. For example: IF 1=2 AND 3/0=4 THEN... This expression will work in Non-Level 6 MAI BASICs since BASIC will stop the evaluation as soon as it sees the false condition '1=2'. BB6 will continue to evaluate the expression and get an error at the condition '3/0=4'. This expression must be written as a nested 'IF' on BB6: IF 1=2 THEN IF 3/0=4 THEN... The SSN field in the MAI 1500 is a numeric expression. On other systems it is a string variable. The system variable "ERR" does not contain '127' after the ESCAPE key is pressed, as on other systems. It is not possible to program the CONSOLE function keys (F1-F10). Precision is always set to 2 unless specified via a PRECISION directive. * See Section 3.4.2 2.0 SYSTEM START-UP AND SHUTDOWN 2.1 System Start-up The MAI 1500 can either be booted with the MS-DOS or BOSS Operating System. The system start-up used depends on which Operating System you wish to run and the device on which that Operating System is located. It can reside on Floppy disk drive 'A', the top floppy drive on the system or the Active partition on Hard disk drive 'C', the first hard disk drive on the system. When the system is powered up it will automatically get the Operating System from Floppy drive 'A', if there is a bootable diskette (a diskette that contains a loader and an Operating System) in the drive and the disk drive door is closed. If there is a non-bootable diskette in Floppy drive 'A' at boot time and the disk drive door is closed, an error will be produced and you will be required to re-boot the system. If there is no diskette in Floppy drive 'A' or the floppy drive door is not closed, the system will automatically boot from the active partition on the Hard disk drive 'C'. If there is no active partition on the hard disk or the hard disk partition does not contain a Operating System, an error will be produced or the system will display unreadable characters on the Monitor. If the system is powered up and already has an Operating System SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg014 booted, the system can be re-booted by depressing and holding down and , then quickly depressing and releasing all three. The system will then use the steps outlined above to boot the system. If the message "ERROR, (RESUME='F1' KEY)" appears, depress to complete the boot. Following are the steps required to boot the desired Operating System from the correct device. NOTE: If this is a new installation you will need to first boot your system from Floppy drive 'A' by following the procedure outlined below for System start-up from a floppy. You will need to have the "SETUP and TEST' diskette in the Floppy drive 'A' at boot time. 2.1.1 From Floppy Disk Drive 'A' To boot the system from Floppy drive 'A' perform the following steps: 1. Hold the diskette you wish to boot from with the label facing up and towards you, and insert it into Floppy drive 'A'. 2. Close the floppy drive door. 3. If the system is powered off, power on the system. If the system has already been booted, depress and hold and then , and depress and quickly release all three keys. The system will now boot from the diskette in Floppy drive 'A'. 2.1.2 From Active Partition on Hard Disk Drive 'C' As mentioned above, if there is a diskette in the floppy drive and the door is closed, the system will attempt to boot off the floppy. To boot from the active partition on the Hard disk drive 'C' perform the following steps: 1. Ensure that the floppy drive door is open. 2. Ensure that the partition you wish to boot from is Active. To check which partition is Active or to activate a partition perform the following: A. If you are on the BOSS partition run the program '*PARTDSK'. This program will allow you to activate the MS-DOS partition. You will be required to re-boot the system after running this program and changing the active partition. B. If you are on the MS-DOS partition run the program 'fdisk'. This program will allow you to activate the BOSS partition. In MS-DOS the BOSS partition is called non-DOS. 3. If the system is powered off, power on the system. If the system has already been booted, depress and hold and , and depress and quickly release all three keys. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg015 The system will now boot from the Active partition on Hard disk 'C'. 2.2 System Shutdown The following outlines the steps required before shutting down the system: NOTE: These steps should also be followed before re-booting the system after it has been powered up and an Operating System has been loaded. 1. Exit all programs. That is, get the system into console mode. 2. If the system is running under BOSS, release all tasks. This is to ensure that all files are closed. NOTE: There is no warning given to the other operators that their task is going to be released. When a task is released all information that the task has in memory will be lost. For this reason it is recommended that all terminals be taken to console mode or a main menu before releasing the task. 3. If the system is running under BOSS, disable all enabled Directories. This is to ensure that the buffering caches are written back to the disk before power down. It is now safe to power off or re-boot the system. 3.0 INSTALLATION The hard disk on the MAI 1500 can be partitioned and set up so that the system can be booted and run as either a single-user MS-DOS system or a multi-user Business BASIC system. This section provides the procedure for installing MS-DOS and BOSS on a one or two fixed disk system, beginning with preparing the fixed disk(s). If the system is going to be used only with BOSS this procedure should still be followed skipping the section on installing MS-DOS. Before continuing with this procedure ensure that you have the following diskettes: o BOSS BASIC o BOSS Utilities o MAI 1500 Setup and Test Diskette o MS-DOS 3.1 (2 floppies) Required only if MS-DOS is going to be installed. In addition to the above diskettes you will need the bad track information for your hard disk(s). This information is contained on a label attached to the underside of the MAI 1500 CCA and on the disk drive case. If for some reason the label on the CCA is missing, you will need to remove the cover and read the list from the disk drive case. The relevant information is the Cylinder and Head number. When you have the proper diskettes and have obtained the bad track information, you are ready to begin the installation. Warning: MAI Basic Four has instituted procedures limiting the installation of BOSS to a single system for each copy of BOSS purchased. It is SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg016 important to understand that for this reason you are restricted to two times that BOSS can be installed on your system. (One installation is counted only after BASIC has been installed. The procedure up to that point can be repeated without restriction.) The system will not allow you to install BOSS a third time; you must contact your MAI Basic Four dealer for information on installing BOSS a third time. 3.1 System Set-up This section describes the procedure to tell the system how many hard disk drives are installed and what type they are. This must be done regardless of the combination of operating systems being installed, whether it be a system partitioned between BOSS and MS-DOS or a system dedicated to BOSS. Section 3.2 is required only for installations including MS-DOS. BOSS has its own procedures for installing BOSS, so section 3.2 can be skipped for dedicated BOSS installations. To start, insert the "Setup and Test" diskette in floppy drive A (if your system has two floppy drives, Drive A is the top drive), and boot the system. When the boot is complete, the system will display the Diagnostics Main Menu. The setup program stores a record of certain configuration information in system memory. This information is required by the system to function properly, whether it is running under MS-DOS or BOSS. The steps required to setup your system are outlined below: 1. Run the setup program from the Diagnostics menu by selecting Option O followed by a . The Setup menu will be displayed. 2. From the Setup menu select Option 0, 'Set Date and Time'. The current date and then time will be displayed. If they are correct, enter a ; if they are incorrect, enter the correct date and time. When the date and time are correct enter 'Y' and , this will return you to the 'Setup menu'. 3. From the Setup menu select Option 1, 'SET DISKETTE DRIVE TYPE'. This option will allow you to set your floppy disk drive types. The system will display the drive type for both the floppy drives 'A' and 'B'. The floppy drive types are shown as follows: (Not installed = no floppy configured at that location) DOUBLE-DENSITY DISKETTE DRIVE - 360 KB floppy configured HIGH-DENSITY DISKETTE DRIVE - 1.2 MB floppy configured. If the information is correct enter a 'Y' . If the information is incorrect enter a 'N' and enter the correct information for the floppy drives. When the information is correct enter a 'Y' . This will return you to the Setup menu. 4. From the Setup menu select Option 2, 'SET HARD DISK DRIVE TYPE'. This option will allow you to set your hard disk drive types. The system will display the drive types. Only two drive types are currently supported on the MAI 1500: 20 MB hard disks (both full-high and half-high) are type 2. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg017 31 MB hard disk is type 3. In addition to these drive types, if no drive is configured at a location, it will display 'not installed'. If the information is correct, enter a 'Y', . If the information is incorrect, enter an 'N', , and follow the system prompts to enter the correct hard disk drive information. When the information is correct enter a 'Y', , and this will return you to the Setup menu. NOTE: When changing the hard disk drive information the system will display the drive types followed by a prompt to 'enter selection'. This prompt is for hard disk 'C'. 5. From the Setup menu, select option 3, 'SET SYSTEM SPEED'. This option will allow you to set your system speed and, in addition, will enable or disable the system speed button located on the control panel. The system will display the current configuration for your system's speed options. If these are correct, enter 'Y', . If they are incorrect enter 'N', , and enter the correct information. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 6. From the Setup menu, select Option 4, 'Set expansion memory size'. This option will allow you to set system memory expansion. Presently the MAI 1500 is not being sold with expansion memory so this parameter should be set to zero. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 7. From the Setup menu, select Option 5, 'Set primary display type'. This option will allow you to set the type of controller your monitor is connected to. The question 'Is a GDA board installed ?' should be answered with a 'Y'. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 8. From the Setup menu, select Option 6, 'Review current configuration'. This option will allow you to review the existing system setup. If any of the entries are incorrect, return to the Setup menu by entering a and repeating the appropriate steps. If the entries are correct, enter an to return to the Setup menu. 9. To exit the Setup program and save the updated configurations select Option 7, 'Exit SETUP and save new configuration'. The system will display the new configuration and prompt you if the entries are correct. If the settings are correct, remove the diskette and insert the appropriate diskette for the next procedure before answering the prompt. If you are installing a PARTITIONED system with MS-DOS, insert the 'SETUP and TEST' diskette into the floppy disk drive. Then enter 'Y' and go to section 3.2 'Installing MS-DOS'. If you are installing a DEDICATED BOSS system, insert the BOSS system Diskette into the floppy disk drive; enter 'Y' ; and go to section 3.3, 'Installing BOSS'. 3.2 Installing MS-DOS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg018 The steps in this section are required only if you are setting up a disk to contain MS-DOS. If your system will be a DEDICATED BOSS system proceed to section 3.3 'Installing BOSS'. 3.2.1 Initialize Hard Disk The following outlines the steps required to prepare the hard disk for the installation of MS-DOS. If your system has two hard disk drives and you will be partitioning them both to MS-DOS, follow this procedure twice. The first time using drive 'C' and the second time using drive 'D'. 1. From the 'SETUP and TEST' Menu select Option 4, 'Hard disk preparation'. 2. The system will display the Hard disk preparation menu, with a message that no disk drives are selected. Enter Option 0, 'Select drive', from the menu. The system will prompt for drive 'C' or 'D', enter 'C'. The system will now display 'Hard disk drive C: selected'. 3. From the option menu enter Option 2, 'Initialize hard disk'. Warning: this will destroy all the data on the disk and should only be run the first time the system is installed. If it is required to run again ensure you have a good back-up of your COMPLETE disk, MS-DOS and BOSS. You will be prompted twice to ensure this is what you wish to do. Enter 'Y' to the first question and to the second. If you do not wish to initialize your disk, enter . 4. When the initialization program is complete, you will be prompted with a message telling you the program is complete and to enter to continue. Enter , and you will be returned to the Hard Disk Preparation Menu. From this menu, select Option 1, 'Enter bad tracks'. 5. This step outlines the procedure to spare the bad tracks from the bad track information gathered earlier from the listing on the bottom of the CCA or from the disk drive. If there are no bad tracks listed then no bad tracks were found. The following prompt appears and allows you to enter the cylinder number and head numbers listed on the Hard Error Map: TYPE CYLINDER NUMBER, COMMA, HEAD NUMBER, AND THEN PRESS ENTER> From the bad track list, enter the cylinder number, followed by a comma, the head number, and press ; for example, 49, 3, . If you enter a nonexistent cylinder or head number, you will be prompted that the wrong head or cylinder has been entered and to press to continue. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg019 allows you to go back and re-enter the incorrect numbers. After you press to enter the numbers for a bad cylinder, you will be prompted to answer with a 'Y' if the information is correct or an 'N' to cancel the entry. Entering either choice, Y or N, the entry prompt appears again. Continue to enter the data from the Hard Error Map until all the bad track numbers from the list have been entered. When you have finished entering the bad track numbers, press . The system will display a table of the bad tracks you have just entered. You will then be prompted if you wish to save the list. If this list is incorrect, enter 'N' to re-enter the list. If it is correct, enter 'Y' . A message will be displayed telling you to run 'FDISK AND FORMAT TO SPARE BAD TRACKS'. Enter to return to the Hard disk preparation Menu. 3.2.2 Create MS-DOS Partition MS-DOS and BOSS provide separate programs to partition a hard disk. In order to implement a partitioned hard disk, both programs must be used. This section describes the procedure for creating a MS-DOS partition using MS-DOS FDISK and installing MS-DOS onto your system. Section 3.3 'Installing BOSS' describes the procedure for creating a BOSS partition and installing BOSS on your system. Before proceeding with this section, you should have initialized the hard disk and created the bad track list. (See Section 3.2.1). A hard disk is divided into cylinders. The number of cylinders and the size of the cylinders can vary depending upon the hard disk. The MAI Basic Four 20-megabyte disk contains 614 cylinders, and 31-megabyte disk has 640 cylinders. In order to create an MS-DOS partition with FDISK, you will have to specify its location (starting cylinder) and size (number of cylinders). Following are the steps required to create the MS-DOS partition: 1. Insert the MS-DOS diskette (1 of 2) into floppy drive 'A' and boot the system. After entering the date and time, the system will respond with the MS-DOS prompt A>. 2. Enter 'fdisk' , the system will display the FDISK options. The default choice is 1. To select another option, enter the number and press . If you have more than one hard disk you will get a message displayed with the current disk. In addition, the option menu will contain a 5th option to select the next fixed disk drive. 3. Select Option 1, 'Create MS-DOS Partition'. The system will respond with the following question: Do you wish to use the entire fixed disk for MS-DOS? SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg020 The default choice is 'Y'. To select 'N', enter the letter and press . The system displays the Create MS-DOS Partition screen with the following prompt: Enter Partition Size..........: The default choice is 614. To select another partition size, enter the number and press . NOTE: a. Entering a at this point will partition the entire disk for MS-DOS leaving no room for BOSS. b. The MS-DOS partition should be allocated to 100 cylinders minimum in order to use PC-LINK. 4. Enter the MS-DOS partition size (in cylinders) that you wish your MS-DOS partition to take, followed by a . You will next be prompted for the starting cylinder. To locate MS-DOS in the front position of the disk (Cylinder 0) enter '0', 5. The system displays a table with the partition information leaving the cursor positioned at the prompt at the bottom of the screen. The column headings are defined as follows: PARTITION - the number of the partition in the order in which it appears on the hard disk. STATUS - shows whether a partition is 'A' (for Active, i.e., in control when the system is started from the hard disk) or 'N' (for Non-active). TYPE - shows whether the operating system that occupies the partition is MS-DOS or not MS-DOS. START - the starting cylinder number for the partition. END - the ending cylinder number for the partition. SIZE - the size of the partition in cylinders. NOTE: FDISK will not allow a partition to start in a cylinder where a bad track has been marked. If the cylinder you selected as your starting cylinder contains a reserved bad track, FDISK automatically starts the new partition in the next cylinder that does not contain bad tracks. 6. When you press , the system redisplays the FDISK options. If you are partitioning two drives, enter Option 5, 'SELECT NEXT FIXED DISK DRIVE' and follow steps 3 - 5 to partition the second disk. After you are finished partitioning your disk drive(s), press . The system will display a message to insert the MS-DOS diskette in drive 'A' and press any key when ready. Insert the MS-DOS diskette (1 of 2) and press . When the system has been restarted proceed to the next section. 3.2.3 Formatting and Copying MS-DOS to the Hard Disk SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg021 This section details the procedure used to format the hard disk for MS-DOS and to copy the MS-DOS files to the disk. If you have two hard disks that have been partitioned, you should perform this procedure for both disks, substituting the correct disk designation (e.g.,D:) in steps 1 and 4 below. 1. The last step performed was restarting or booting the system from the MS-DOS diskette. After you have entered the date and time, the system displays the MS-DOS prompt A>. From the prompt enter 'format c: /s/v', . The system will display a warning message that the program will destroy all the data on the disk and prompt for a 'Y' to continue. 2. Enter 'Y' and the system will again display a warning message that the program will destroy all the data on the disk and prompt for a 'Y' to continue. Enter 'Y', . The system will respond with: Formatting... Verifying... System transferred 3. The last message says that a copy of MS-DOS has been placed on the disk. You are now prompted for a label to identify the disk. The label can be up to 11 characters long or a will equal no label. Enter the label and when complete. The system will next display information about disk space allocation in bytes, used by the system and bytes available on the disk. 4. The system responds with the MS-DOS prompt A>. To copy all files from your MS-DOS diskette onto the hard disk enter 'copy*.* c:', . NOTE: If you wish to copy the MS-DOS files to a directory other than ' ', see helpful hints under putting MS-DOS files to a directory. 5. When the transfer is complete, remove the MS-DOS diskette from the floppy disk drive. 6. Insert the MS-DOS (2 of 2) diskette into the floppy disk drive and enter 'copy *.* c:', . 7. Remove the MS-DOS diskette from the floppy disk drive and set it aside. Your system now has MS-DOS in the MS-DOS partition of your hard disk. 3.3 Installing BOSS If your system already contains data, perform a back-up prior to attempting to install BOSS. 3.3.1 BOSS Disk Set-up This section details the procedure to specify the hard disk on the system and configure the hard disk directories that are necessary for the software to be loaded. This procedure is applicable to ALL systems and MUST be SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg022 performed prior to loading BOSS. If your system has two hard disk drives, you need to know, prior to performing this procedure, which hard disk designation (H0 or H1) references a particular disk. In case of a single hard disk, the disk designation is always 'H0'. In the case of a dual hard disk system, the primary hard disk, which contains the operating system(s), is always 'H0' and the secondary hard disk is always 'H1'. 1. Remove the write-protect tab from the diskette labeled BOSS BASIC SYSTEM DISK. Insert this diskette in floppy drive 'A' (top drive in a two floppy drive system), known as drive 'F0' under BOSS, and boot the system. When the boot is complete, the system will display the BOSS Installation Menu. 2. From the Installation menu select Option 1, 'SELECT HARD DISK TYPES'. This option will allow you to set your drive types for BOSS. The system will display the drive types (these drive types are the same as under section 3.2.1). Enter the number for the type of drive installed as 'H0', . You will then be prompted for the drive number corresponding to the drive-type just specified. Enter 'H0', . If you have a two drive system, enter the number for the type of drives installed as 'H0', and 'H1', at the appropriate drive number prompt. When the hard disk drive(s) for your system have been selected, enter (twice). The system will re-display the BOSS installation Menu. 3. From the BOSS Installation Menu, select Option 2, 'Configure disk directories'. This option will allow you to setup the directories your system will have on it. The system will display the BUSINESS BASIC CONFIGURATOR Menu; this menu contains the steps to configure your BOSS system. At this time we will only be working with the disk directory section. 4. From the 'SELECT CONFIGURATION SOURCE' prompt, select option 2, 'FLOPPY DISK UNIT 0'. 5. From the menu, select Option 2, 'DISK DIRECTORIES'. The system displays the DISK CONFIGURATION Screen along with a prompt to enter directory code to modify. Enter 'DO', ; the system will respond with a prompt for disk type ('H' for hard disk, 'F' for floppy). Enter 'H', ; the system will respond with a prompt to enter drive number. For a single hard disk system enter '0', ; for a dual drive system, enter the drive number of the primary hard disk followed by a . The system will respond with a prompt for directory name. Enter 'UTIL', ; the system will respond with a prompt for type of device buffering. Enter the option best suited for your areas needs. (See Section 6.1.1 for details). NOTE: Device buffering refers to the buffering (caching) of the entire hard disk. Read/Write Buffering (option W) is recommended for best performance. In areas subject to frequent power failures without battery backup SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg023 facilities, performance can be traded for increased data integrity by selecting Read Only Buffering (R). If your system has a second hard disk drive, you can configure Directory D7 for that hard disk at this time. This can be accomplished through the following inputs: D7 Directory Code H for hard disk 1 for secondary hard disk drive number XXXX any four character Directory name is valid If your system has two floppy disk drives you can configure the second floppy as follows: D8 Directory Code F for Floppy disk 1 for second floppy disk drive number XXXX any four character Directory name is valid R for Read Only Buffering (removable disks MUST be configured for Read Only Buffering; otherwise a diskette may not be fully updated before it is removed). 6. When the directories have been configured, exit the menu by entering . The BUSINESS BASIC CONFIGURATION Menu will be re-displayed. To save the new configuration, enter , 'TO END JOB NORMALLY (SAVE NEW CONFIGURATION)'. The program writes the configuration to diskette and displays the BOSS Installation Menu. Select Option 3, 'RE-BOOT SYSTEM', and the system will respond with a message to re-boot. Boot the system from the BOSS BASIC SYSTEM diskette. 3.3.2 Create BOSS Partition This section details the *PARTDSK procedure used to create the BOSS partition on a partitioned disk. Just prior to arriving at this section, you should have booted BOSS from the diskette labeled BOSS BASIC Operating System. Use the following procedure to create the BOSS partition: 1. From the BOSS Installation Menu, select Option 4, 'PARTITION HARD DISKS'. If you have one hard disk proceed to step 3. 2. If you have two hard disks, the system responds with a question as to which disk to partition (H0 or H1). Select the designation of the disk to partition followed by . 3. The system will display the *PARTDSK screen. If you have selected a disk to partition and it also contains a MS-DOS partition the following message should be displayed on the screen: THERE IS CURRENTLY 1 DEFINED PARTITION ON THIS DISK SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg024 This refers to the MS-DOS partition you created earlier. This partition information is displayed at the bottom of the screen. BOSS can recognize the boot code created by MS-DOS 3.1. If some other MS-DOS-like operating system was used, BOSS will indicate this condition with the following message: PARTITION SECTOR DOES NOT CONTAIN RECOGNIZABLE BOOT CODE. USE OPTION 'R' TO CLEAR PARTITION SECTOR; THEN USE 'FDISK' TO CREATE PARTITION STRUCTURE. TYPE 'CR'. This message may also be the result of an incorrect procedure. Retry the Loading Procedure, and if the error recurs, contact the supplier of your system. 5. From the *PARTDSK screen, select option B, 'BUILD BOSS PARTITION'. The system displays the CREATE BOSS PARTITION screen and a prompt for the start cylinder. This is the starting location of the BOSS partition. To protect the integrity of the BOSS partition header area, Head 0 of the BOSS starting cylinder must not have a bad track. If you determine that a bad track interferes with the header area, then select another (higher) STARTING CYLINDER. Enter the BOSS starting cylinder, . NOTE: It is suggested that you locate BOSS directly after the MS-DOS partition. Depending upon the location of the MS-DOS partition, a will default to the lowest available cylinder number on the disk. The system will display a prompt for the ending cylinder for the BOSS partition. To use the rest of the disk for BOSS, you can specify the highest cylinder number on the disk by pressing , or enter the BOSS ending cylinder, . The system will responded with a message saying the partition is built and prompt for a to continue. After entering a , the system will display the *PARTDSK screen and the new partition information. 6. At this point you will activate the BOSS partition, to specify BOSS as the operating system to boot from the hard disk. NOTE: If your system contains two hard disks, activate only the first disk, 'H0'. To activate the BOSS partition from the *PARTDSK menu select Option A, 'ACTIVATE PARTITION', and the system will respond with a prompt to enter the partition number to activate. This prompt refers to the partition numbers on the bottom right of the screen. To select the BOSS partition, enter 2, ; the system will highlight the BOSS line to indicate that it is active. To get back to the *PARTDSK menu, enter . If you have one hard disk drive or you have completed the partition procedure for your disk(s), proceed to SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg025 step 7. If you have two hard disk drives and wish to partition the second disk, select the disk by entering Option N, 'NEXT DISK'. To partition the second disk proceed to step 2. NOTE: When partitioning the second hard disk do not forget to include the BOSS partition header restrictions when deciding the location of the partition. After you have built the BOSS partition on the second disk, DO NOT ACTIVATE IT. 7. When the hard disk(s) have been partitioned, exit the utility by pressing , and the system will respond with a message to re-boot the system. Boot the system from the BOSS diskette. NOTE: The *PARTDSK - ERASE PARTITION option is not used in this loading procedure, but it can be used to erase the BOSS or MS-DOS partition. This may be useful if you wish to reduce the size of the BOSS partition and install another operating system on the disk. However, if you use this option, you should first backup all BOSS data on your system. You will then have to reinstall BOSS from scratch. If only the BOSS partition is erased using this option, MS-DOS data will not be erased and MS-DOS will not have to be reinstalled. (Remember the 'R' option REMOVES ALL PARTITION INFORMATION, and erases all partitions and data on the disk). 3.3.3 Loading BOSS to the Hard Disk This section details procedure to accomplish a Surface Analysis on the hard disk, to initialize a directory on the hard disk, and to copy the BOSS BASIC Operating System to the hard disk. Warning: If this is the third installation of the BOSS Operating System on your system, you are prevented from completing the installation in this section. You will have to contact your MAI Basic Four dealer for information on installing BOSS a third time. NOTE: In this section, references to the hard disk refer only to the BOSS partition, and not the whole disk. It is necessary to have the bad track information for your hard disk(s) available prior to performing the following procedure. For two disk systems, follow the procedure to initialize the primary hard disk and then repeat the procedure for the secondary hard disk. The primary disk will contain the directory UTIL, and the secondary disk will contain the directory that you previously configured in step 4, section 3.3.1, 'BOSS Disk Set-up'. NOTE: If you attempt to install BOSS on a dedicated hard disk and an Error 103 occurs in the following procedure (*1PSD) below, it indicates that partition data still exists on the hard disk or you did not re-boot prior to proceeding with this section. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg026 The following steps outline the procedure to initialize the hard disk and to copy BASIC to the hard disk: 1. From the BOSS Installation Menu select Option 5, 'INITIALIZE HARD DISKS'; the system will respond with a message warning that this program will destroy the data on the selected device and prompt you if this is what you want to do. If you want to destroy all the data on the disk (BOSS partition only), enter 'Y', . 2. The system responds with a prompt for device name. If you have a single drive system, the response for the first disk drive will be 'H0, and 'H1', for the second disk drive. 3. The system responds with the prompt 'SHOULD BASIC BE INCLUDED'. If this is a primary disk, enter 'Y', . If this is the secondary disk, enter 'N', . NOTE: You should not include BASIC on the secondary disk. It should always reside on the primary disk. If you have two floppy devices configured, the system will respond with a prompt asking for the device to copy BASIC from, enter 'F0', . 4. If you are performing a second installation, the system will warn you that this is the last possible installation allowed. If you do not wish to continue press . If you wish to continue press . NOTE: If you are performing a third installation of BOSS on your software, the software prevents you from continuing and displays a message informing you of this. If a third installation is required, contact the supplier of your system or MAI Basic Four Worldwide Product Support. (See Section 8.1) Otherwise the system will respond with a prompt asking if bad track sparing should be included. If you do not want to implement Bad Track Sparing or perform a Surface Analysis, enter 'N', and proceed to step 8. To implement Bad Track Sparing or perform a Surface Analysis, press . 5. The system will prompt you for a head number. From the Bad Track List, enter the Head number of a bad cylinder, . The system next prompts for a cylinder number. From the Bad Track List enter the corresponding cylinder number for the bad track, . If the Cylinder is on the MS-DOS side of the partition the system will not accept it. Press to move the cursor back to the previous prompt. 6. Continue to enter the head and cylinder number for all bad tracks contained on the Bad Track List. When this information has been entered, press at the prompt for head. The system will respond with a prompt asking if the information is correct, enter 'Y', . 7. The system responds with a prompt asking if a test for SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg027 bad tracks should be performed. This refers to the Surface Analysis procedure. If you do not want to test your hard disk for additional bad tracks enter 'N', and go to step 8. If you wish to perform this procedure, enter 'Y', . If no additional bad tracks are detected proceed to step 8. Otherwise, the system displays on the screen, in background intensity, any additional bad tracks detected and asks if you wish to add these bad tracks to the bad track table. If you do not want these bad tracks spared, enter 'N', and proceed to step 8. Otherwise record these additional bad tracks for your own information, and then enter 'Y' . The system will display a message that bad tracks are being added to the Bad Track Table. 8. The system responds with a prompt for directory name. For a single-disk system or the primary disk of a two disk system enter 'UTIL', . For secondary disks, enter the 4-character directory name you created in step 4, section 3.3.1, 'BOSS Disk Setup'. 9. The system will respond with a prompt asking for the number of files for the directory. For a single-disk system or the primary disk of a two disk system, enter '500', . For secondary disks, enter the number of files, . The system responds with the prompt for the directory name. At this point you may create other directories on the disk. (Alternatively, after BOSS has been installed, you may add additional directories by using the *4PSD Utility.) Directory names may be up to 4-characters long. When you are finished creating directories, press at the prompt for directory name. NOTE: See Section 6.2 for more information about directories. 10. The system responds with a prompt asking if the information is correct. Ensure the information is correct before answering this question. If it is not correct, enter 'N', and re-enter the information. If it is correct, enter 'Y', . The system will display a message that the directories are being initialized and that BOSS BASIC is being copied if it is included. When the initialization is complete, a prompt to continue will be displayed. At this prompt press . The BOSS Initialization Menu is displayed. Return to step 1 to initialize a second hard disk. Otherwise, this completes the Directory Initialization and Bad Track Sparing procedure. The following steps outline the procedures that are used to logically attach the second diskette, labeled BOSS Utilities (ULIB), to the floppy logical device and to copy the BOSS utilities from the floppy diskette onto the hard disk. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg028 1. From the BOSS Installation Menu, select Option 6, 'LOG ULIB DISK ONTO SYSTEM'. The system will respond with the *UPSD - SWITCH FLOPPY DISKETTE screen. You will be prompted to enter to switch diskette. Press . 2. If your system has only one floppy disk drive configured, the screen automatically selects that unit. If your system has two floppy disk drives configured you will be prompted for unit number, enter for 'F0'. 3. The system now disables the floppy drive directory (Disc #9, F0 BOSS). It then displays a message to insert the diskette and enter to continue. 4. Remove the diskette labeled BOSS BASIC SYSTEM DISK from the floppy disk drive and insert the diskette labeled BOSS Utilities (ULIB) and the press . 5. The system automatically logs-on the diskette directory as ULIB and displays the information briefly. It then displays the BOSS Utilities Menu. 6. Select Option 22 (*SPSD) from the BOSS Utilities Menu. At the 'FROM DISC#' prompt, enter '9' . At the 'T0 DISC #' prompt, enter '0', . This selects the directory on the primary hard disk. 7. The system responds with a prompt asking for the type of files to transfer. Enter 'A' for all, . The system responds with a prompt asking what to do if a file is existing on the disk. Enter 'R' for replace, . The system responds with a prompt for the file names to transfer. Enter '@' to select all, . The system will display each file as it is being copied. 8. When the transfer is complete you will be prompted with a message that the transfer is complete along with and a prompt to press to continue. Press twice. The system will respond with a READY. 9. Remove the diskette labeled BOSS Utilities (ULIB) from the floppy disk drive and insert the diskette labeled BOSS BASIC Operating System. Boot the system from the BOSS diskette. 3.4 Configuring the System This section provides information on the system configuration as shipped and how to modify the configuration for your system requirements. It contains information on implementing and configuring Serial Ports, Memory, Terminals, International Keyboards and International Printers. 3.4.1 System Configuration Review the information in this section. If you do not wish to change the system configuration , proceed to section 3.5, 'Finish Installation'. Otherwise, from the BOSS Installation Menu, select Option 7, 'CONFIGURE SYSTEM'. The system enters the *NPSD Utility. The system configuration is maintained and modified by using the *NPSD - BASIC CONFIGURATOR Utility. Documentation of this SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg029 utility is provided in the BOSS Reference Manual in the chapter on utilities. The *NPSD Utility is capable of configuring your system on either a floppy or hard disk. When you enter the utility you will be prompted to select the disk drive from which to get the configuration source. Your choice will depend on if your normal boot device is the hard disk or floppy. In a normal installation, the boot device is the hard disk. If this is true for your system, enter '1', . The configuration source will then be read from the selected disk and the BOSS Configuration Menu displayed. 1. The BOSS is shipped configured for the monitor on port 0 with an auto start and to run "**" at load time. Ports 1 & 2 are setup for terminals at 9600 baud and no auto start. If you wish to change this, select Option 1, 'SERIAL PORTS'. 2. The BOSS is shipped configured for the following: 1 - PARALLEL PRINTER MODEL CODE . . . . . .4217 The option for this parameter is 4217 or 4218. 2 - MAXIMUM NUMBER OF GHOST TASKS. . . . . .1 The number of Ghost tasks allowed is 0 - 4. 3 - SIZE OF INTERNAL FILE DICTIONARY . . . .72 This can be from 13 - 255. 4 - DATE DELIMITER . . . . . . . . . . . . ./ This can be any character other than a space or comma. 5 - DATA FORMAT. . . . . . . . . . . . . . .M This can be (M=MDY, D=DMY, Y=YMD) 6 - EDIT DELIMITERS. . . . . . . . . . . . .[] This can be any character other than a space or a comma. 7 - RESIDENT COMPILER AND LISTER . . . . . .Y This can be yes or no. If you select no you will be unable to load and list programs. 8 - DEVICE BUFFERING SECTOR MULTIPLE . . . .2 This is the amount of sectors that are read into memory for each buffer read. This can be 1, 2 or 4 sectors. 9 - DEVICE BUFFERING SYNC INTERVAL . . . . . 10 This is the time in seconds between the end of one disk buffer write cycle to the beginning of the next. If you wish to change any of these parameters, select Option 4, 'SYSTEM OPTIONS'. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg030 BOSS comes configured with maximum of 4 tasks running in banks 1 and 2, with 45,498 bytes for program and data, 18,432 bytes for record buffering and 1,606 bytes for system tables. Select Option 5, 'MEMORY BANKS', if you wish to add more tasks or change the way the memory is configured. NOTE: Before saving a new MEMORY BANKS configuration, make sure that the following MINIMUM requirements have been met: PROGRAMS AND DATA = 20K per user in a bank RECORD BUFFERS = 8K per user in a bank Any extra memory in a user bank should be allocated to device buffers. When you have selected the desired system configuration, you must save the new information. From the CONFIGURATION Menu enter a 'Y', . The system writes the information to disk and displays the BOSS INSTALLATION Menu. NOTE: The new configuration only takes effect when you boot from the normal boot device after completing section 3.5, 'Finish Installation'. 3.4.2 Terminal Support The standard terminals supported on the 1500 are the 4310, 4312, and the EVDT. Each of these has a table of mnemonics assigned to it and can be modified as follows: 1. Enter *N at the UTILITIES MENU. 2. Select Menu item 6, TERMIANL TABLES, from the CONFIGURATOR MENU. 3. Select menu item 1, MODIFY TEMINAL TABLES. 4. Enter 'M', 5. Enter the model number of the terminal you to modify (e.g. B$ 4310) From here on, you will be prompted with all mnemonics assigned to this model, given their old values and descriptions, and given an opportunity to modify them ( leaves the old value in place). As soon as you have viewed and/or modified the mnemonics table(s), enter to exit to the "SAVE NEW TERMINAL TABLE (Y/N)?" prompt. 3.4.2.1 International Terminal Support BOSS supports the following International Keyboards: AMERICAN FRENCH ITALIAN SPANISH GERMAN ENGLISH DANISH NORWEGIAN SWEDISH/FINNISH The AMERICAN keyboard is the default keyboard. NOTE: This feature is for keyboards connected directly to the CONSOLE. International keyboard support for terminals connected to the RS-232 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg031 port(s) is supplied by the individual terminal manufacturers. In order to modify the CONSOLE to support an International Keyboard, follow the same procedure listed in Section 3.4.2 for modification of Terminal Tables with the following differences: 1) At the 'ENTER TERMINAL TABLE' prompt, enter CONSOLE. 2) At the ENTER TERMINAL NAME (20 CHARACTERS MAX):' prompt, enter . 3) Continue entering 's until you reach '19 ENTER MNEMONIC CODE MM:', or enter BACK18. 4) ENTER 'TI,' , and the system responds with: ----- OLD VALUE --> $1B33001B360F 19.1 ENTER CODE TO BE TRANSMITTED TO TERMINAL: The desired International Keyboard is selected by appending the escape sequence 1B380N to the end of the existing character string. The existing character string plus the new sequence must all be keyed in. For the new value, enter: $1B33001B360F1B380n , where n is equal to one of the following: 0 = AMERICAN 1 = FRENCH 2 = ITALIAN 3 = SPANISH 4 = GERMAN 5 = ENGLISH 6 = SWEDISH/FINNISH 7 = DANISH 8 = NORWEGIAN 5) through prompts 19.2 through 19.5 until you return to 19, 'ENTER MNEMONIC CODE MM:'. 6) Enter 'END'. 7) At 'SAVE NEW TERMINAL TABLE (Y/N)?' enter 'Y'. 8) At 'CREATE OR MODIFY MORE TERMINAL TABLES (Y/N)?, enter 'N'. 9) At 'ENTER NUMBER OF CONFIGURATION TYPE:', enter 'Y' to save the configuration and then reboot the system. 3.4.3 Printer Support The standard printers supported on the 1500 are the 4217 and 4218. Each of these has a table of mnemonics assigned to it that can be modified by entering *N at the UTILITIES menu and then selecting menu item 3 (MNEMONIC TABLES) AT THE CONFIGURATOR menu. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg032 NOTE: Due to the way the programs are set up, it is not possible to verify any mnemonics after they have been changed. The only known way to verify your changes is by entering the *I (HEX FILE DUMP) utility, selecting file 'DO', and then looking for your changed mnemonics starting at record number 368. In other words, the MNEMONIC TABLES menu is only usable to modify mnemonics and not to verify their contents. A changed mnemonic will have the letters MNC preceeding its entry. Type twice to exit the HEX DUMP program. Also, if any entry in a table is changed, then all changes made previously must be reentered or they will revert back to the default values. The 4217 and 4218 have some standard BOSS PRINTER mnemonics entered in the tables (these are different than the default mnemonics). Since it is so easy to lose these mnemonics, a list of them and their contents is shown below: MNEMONIC CONTENTS CS OC EP ODOE PM (IGNORE) RB (IGNORE) S2 OB S3 OB S4 OB S5 OB S7 OB S8 OB SB 1B46 SF 1B45 8L (IGNORE) BU 1B2D01 EU 1B2D00 SI (IGNORE) SO (IGNORE) 6L 1B02 BO (IGNORE) EO (IGNORE) BG (IGNORE) EG (IGNORE) TI OC (OC1B1B=INTERNATIONAL) NEW MNEMONICS (MUST BE CREATED) 10 1B2100 12 1B2101 16 1B2104 NL OAOD OP OD 3.4.4.1 International Printer Support The 1500 comes with the 4217 and 4218 printer mnemonics installed. In order for these printers to support international character sets, it is necessary to modify the 'TI' mnemonic by entering *N from the UTILITIES menu, selecting menu item 3 (MNEMONIC TABLES) from the CONFIGURATOR menu, and then changing 'TI' as follows: SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg033 1) Select 4217 or 4218 2) Enter 3) Enter 's until 'TI' appears (approx 54 CR's) 4) Enter at the 'NEW VALUE:' prompt 5) Enter , 'Y', and re-boot. 3.5 Finish Installation From the BOSS Installation Menu select Option 8, 'Finish the Installation'. The system should display the message 'Installation Complete', and then the installation is finished. 4.0 SYSTEM HARDWARE This section details information on the minimum and maximum hardware configuration options and the switch settings, board placement, cables and cable connection. 4.1 Hardware Configuration The configuration range of the MAI 1500 is as follows: _ _ _ _ _ _ Memory _ Minimum _ Maximum _ Comments _ _ _ _ _ _ _ Memory _ 640KB _ 640KB _ _ _ _ _ _ _ _ Hard disk drive _ 1 _ 2 _ Any mix _ _ _ _ _ _ _ Hard disk capacity _ 20MB _ 63MB _ Configurations include _ _ _ or 31MB _ _ 20,31,40,51 and 62MB _ _ _ _ _ _ _ Floppy disk drive _ 1 _ 2 _ 1st drive is 1.2MB, 2nd _ _ _ _ _ drive may be 1.2MB or _ _ Floppy disk capacity _ 1.2MB _ 2.4MB _ 360KB _ _ _ _ _ _ _ Disk controller _ 1 _ 1 _ Supports 2 hard disks _ _ _ _ _ & 2 floppy dr. _ _ _ _ _ _ _ Monitor _ 1 _ 1 _ Monochrome or color. Can _ _ _ _ _ run MS-DOS and Business _ _ _ _ _ BASIC _ _ _ _ _ _ _ Keyboard _ 1 _ 1 _ U.S. (Keycap sets are _ _ _ _ _ available for inter- _ _ _ _ _ national languages) _ _ _ _ _ _ _ Serial & Parallel _ 1 _ 2 _ Software supports _ _ port controller _ _ _ only 1 par. printer _ _ _ _ _ _ _ Display Terminals _ 0 _ 2 _ Can run Business BASIC _ _ _ _ _ applications only _ _ _ _ _ _ _ Number of users _ 1 _ 3 _ _ _ _ _ _ _ * Second floppy is not available if system is equipped with two full-height hard disk drives (i.e., two 20MB (40ms) or two 33MB (55ms). The base MAI 1500 system is shipped with the following hardware in the CCA cabinet: o Monochrome/Color Graphic Adapter Card SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg034 o 640 KB of memory on the Mother board o 1.2 MB floppy disk drive o Full-high 20MB hard disk drive o Serial/Parallel port controller o Disk Controller (supports 2 hard disks & 2 floppy disk drives) o Mother Board with 8 Board slots o Power Supply for disk drives and boards o Front panel with key lock and two keys o Cables to install a second hard disk drive and a second floppy disk drive. 4.2 System Hardware Set-up To install/access the boards in the CCA, remove the four screws one at each corner in the back, plus the screw located in the back at the upper center. Ensure that the key is set to the unlocked position. The CCA cover will now slide forward towards the front panel, and can be removed and set aside. Each board is held in place by a screw located at the back of the CCA. To remove a board, first remove this screw and any connected cabling. The board will now slide out. To install a board, just reverse this procedure. Warning: The CCA cover should be removed only by a trained service person and only after all power is off. In addition, the CCA power should not be applied while the cover removed. The following are the installation and set-up instructions for each board in the CCA: o Monochrome/Color Graphics Adapter Card The Monochrome/Color Graphics Adapter Card is shipped in the CCA, in slot location 1, with the switches set for a color monitor. Following are the various switch settings for the adapter card: GRAPHICS DISPLAY ADAPTER Switch Settings: Switch Name Setting 1 Power On Display Mode 1 Monochrome: ON Color: OFF Emulation: OFF 2 Power On Display Mode 2 Monochrome: OFF Color: ON Emulation: OFF 3 Monitor Type 1 Composite: OFF Monochrome: ON SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg035 Color (RGB): ON Color (Enhanced Graphics: OFF 4 Monitor Type 2 Composite: ON Monochrome: OFF Color (RGB): OFF Color (Enhanced Graphics): OFF 5 Composite Monitor Color: ON Monochrome: OFF Specific Selections: Monitor Operational Switch Settings Type Mode 1 2 3 4 5 Monochrome Monochrome or ON OFF ON OFF Ignored monochrome/Hercules * Monochrome Emulation OFF OFF ON OFF Ignored ** Color Color/Graphics OFF ON ON OFF Ignored Color Color/Graphics (Enhanced Graphics) OFF ON OFF OFF Ignored Monochrome Composite Monochrome ON OFF ON OFF OFF Color Composite Color/Graphics OFF ON OFF ON ON * These are the switch settings for the Monochrome monitor ** These are the switch settings for the Color monitor o Serial/Parallel port controller One serial/parallel port controller is shipped in the CCA, in slot location 7. The jumper block at location 2E on the board has the two open connections away from the cable connectors to be set for COM1, or the first terminal (This is how the board is shipped.). To set the board for COM2, or the second terminal, remove the jumper block and turn it 180 degrees so that the open connectors are towards the cable connectors. To set the board for LPT1, the jumper block at location 2D will have the two open connectors away from the cable connectors (This is how the board is shipped.). The MAI 1500 will only support one parallel printer. If two serial/parallel port controllers are installed, the second board must be addressed for LPT2, even though this port will not be used. This is done by removing the jumper block at 2D and turning it 180 degrees so that the open connectors are towards the cable connectors. NOTE: The serial/parallel port controller(s) can be located in any open board slot. o Disk Controller The disk controller is shipped in the CCA, at board slot SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg036 location 8. It comes with all the cables necessary to connect 2 hard disk drives and 2 floppy disk drives. Each cable is stamped with a letter corresponding to the drive it plugs into. (A=F0, B=F1, C=H0, D=H1). The floppy drive has one daisy chain cable for both drives. The hard disk drives have one each radial or control cable (the radial controller end is hanging free at the drive end.). The hard disk data cable is a daisy chain cable. The disk controller board should have jumper E2 jumped to E3, E5 to E6 and E7 to E8. The first two jumpers are for setting the floppy and hard disk, and need not be changed when adding a second disk of either type. The third jumper is for the data separator and must be in place at all times. NOTE: The jumper block for E1 though E6 is labeled with E1 and across from it is E4. E2 and E3 are on the same side as E1 but are not marked. The jumper for E7 and E8 are not at the same location as the E1 though E6 jumpers. o Mother Board The Mother board is located on the bottom of the CCA and contains the board slots. The Mother board, also, contains 640KB of memory and there are no switch settings for memory addressing. In addition, there is a slide switch located just to the left of slot 8, towards slot 7, for setting the system for a color or monochrome monitor. This switch should always be set to color if a Monochrome/Color Graphics Adapter board is installed. o Additional hardware items and switch settings The front panel contains a key lock, if the key lock switch is turned to the locked position, the CCA cover can not be removed and the keyboard becomes inoperative. NOTE: With each system you will receive 2 keys. It is recommended that one key be left in the key lock or near the system and the other key be stored in a safe place. The front panel, also contains a button above a picture of a 'lightning bolt'. This button is to set the CPU to 6MHZ (light off), for programs that require it, or 8MHZ the (light on), which is the standard setting. This switch can also be disabled by the system set up procedure (See Section 3.1, 'System Setup'.). In addition there are two other lights. The light above the picture of the 'light bulb' is the system power on light. The light above the picture of the 'barrel' is on when the hard disk drive is being accessed. In the back of the CCA is the on/off switch, a switch to set the system for 115 or 220 volts, a place to plug in your monitor, the CCA power plug connector, and two different types of jacks for keyboards. The phone jack type is the only type of keyboard supported. Also this is where the connectors for the monitor and serial/parallel ports are located. 4.3 System Cabling The following sections show drawings of the standard system cables and a system interwiring diagram: SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg037 907970 Serial Printer to System 907976 Modem to System 907933 Parallel Printer to System The MAI 1500 provides a Back-up and Restore utility. This utility can be run from the main utility menu '**' by entering '*V', at the 'ENTER SELECTION' prompt or by running the program '*VPSD'. To ensure data integrity, it is recommended that a back-up of the data files be done daily and a back-up of the programs be done as often as modifications are made. 5.1 Back-up The back-up program requires that you have the correct number of formatted diskettes before performing it, since this program cannot format diskettes. If you are unsure of the number of diskettes required, you can run the back-up program. It will tell you the number of diskettes that are required and then you can exit the program. NOTE: The diskettes can be formatted under MS-DOS or through the '*1PSD' utility under BOSS. Warning: When formatting diskettes ensure that you format them for the correct type. That is, format a 1.2MB as a 1.2MB and a 360KB as a 360KB. The back-up can be done by backing up complete directories or on a file-by-file mode. To backup complete directories perform the following steps: 1. Ensure that you have the correct number of diskettes and that they are properly formatted. 2. From the '*V' menu select Option 1, 'BACKUP'. The BACKUP screen will be displayed and you will be prompted for the date. Enter the correct date or 'Y', if it is correct. 3. The cursor will then go to the top of the directory listing with a 'D>'. If you wish to include this directory in your backup enter 'S', . If you do not want that directory in the backup enter 'D', . The cursor will go down to the next directory. Continue modifying the entries until you get the prompt for 'SELECTIONS CORRECT'. NOTE: The entry under directories name '*VBU' is the selection you make to backup individual files. This option can be used with a directory backup, but is not recommended. The steps for this procedure are outlined. Under file-by-file backup steps. 4. If the selections are correct enter 'Y', . If they are incorrect enter 'N', and re-enter your selections. 5. The system will now calculate the number of diskettes the backup will require. After the calculations are complete, you will be asked if you want data files, programs or both. Enter your selection. The system will now display the number of diskettes required for your backup. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg038 NOTE: If you do not have enough diskettes formatted enter at the prompt for 'Selections correct' and format the correct amount. 6. If you have enough diskettes for the backup and the selections are correct enter 'Y', . If they are not correct enter 'N', and re-enter the correct data. 7. After entering 'Y' to the selection prompt, you will be prompted to mount volume 01 of the backup set into the floppy drive. Insert volume 01 in the floppy drive or if this is the first backup using this set insert a formatted diskette in the floppy drive and close the floppy drive door. Enter . 8. You will next be prompted and asked if you wish to verify the floppy. This test will check to ensure that the diskette can written and read. Enter 'Y' or 'N', depending on your choice. 9. The system will now ask for the rest of the diskettes to be labeled. After you have labeled all the diskettes required, you will be prompted to put the first diskette back in the drive and enter . After entering , the system will start the backup, showing the files as they are backed up. When it fills up a diskette you will be prompted to insert the next diskette. When the backup is complete the system will display a message telling you that the backup is complete and prompt for a to continue. 10. Entering a will return you to the '**' menu. To backup the system file-by-file The procedure for accomplishing file-by-file backups is in the UTILITIES section of the BOSS REFERENCE MANUAL under *VBU maintenance option and is also summarized below. The *VBU Maintenance Option allows you to backup individual files. The names of the files selected are maintained in a file called (*VBU). Additional file names can be added at a later point and existing file names can be deleted. 1. Enter S beside *VBU to select this option and press . The system responds with the following screen: *VBU MAINTENANCE OPTION....................................... (C) CREATE (L) LIST (A) ADD FILES (D) DELETE FILES (CR) NO CHANGE Explanation of Fields (C) CREATE Creates space for the files to be defined. (L) LIST Lists the files already defined and maintained by *VBU. (A) ADD FILES Defines file to *VBU. You will be prompted for the volume number and the file name when you enter A. (D) DELETE FILES Deletes files from *VBU. You will be prompted for the volume number and the file name when you enter D. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg039 (CR) NO CHANGE Retains the previously defined *VBU list. 2. If this option has not been previously selected, a list of the files to be backed up must be defined to *VBU. Enter C and press . The system responds with the following prompt: SAVE FILE NAMES IN *VBU (Y/N)? CURRENT ENTRIES = NEW ENTRIES: Enter N if you are creating a list for the first time (i.e., there are no existing file names to save). For: CURRENT ENTRIES Enter the approximate number of files you want to back up. This entry can be larger, but not smaller, than the actual number of files you are entering now. NEW ENTRIES The NEW ENTRIES field is used when you want to add more entries at a later date. Enter the sum of the CURRENT ENTRIES field and the number of newly added entries. 3. When the required information has been entered, press to return to the initial *VBU prompt. Enter A to add the names of the files to backup. The system responds with the following prompt: VOLUME NUMBER: FILE NAME: Enter the volume number (directory) where the file resides and press . The cursor is positioned at FILE NAME. Enter the name of the file to be backed up and press . The system responds with the fillowing message: n-name ADDED TO BACKUP CONROL FILE (where: n is the volume number and name is the file name) The cursor is then positioned at FIlE NAME, with the volume number form the previous file name remaining. If the next file is on the same volume, simply enter the file name. To add a file from a different volume, press . The cursor is then positioned at the VOLUME NUMBER field. Press after each entry. Each file entered is listed as follows: n.filename ADDED TO BACKUP CONTROL FILE If the filename was previously added to *VBU, the following message appears: n.filename ALREADY IN BACKUP CONTROL FILE 4. Press when all files to be backed up have been entered. Press again to return to the *VBU Selection screen. To end the *VBU option and continue with the backup, press . The system responds with the following message: CALCULATING # OF DISKETTES REQUIRED FOR BACKUP, PLEASE WAIT! Continue with the Backup procedure as documented from step 5 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg040 in the previous section on backing up complete directions. 5.2 Restore The restore option will allow you to restore the complete back-up or a range of the back-up. To restore files from your back-up perform the following steps: 1. From the '*V' menu select Option 2, 'RESTORE'. The RESTORE screen will be displayed with a prompt asking if you wish a complete restore. 2. If you answer 'Y' to this prompt, you will be asked to insert Volume 1 of the back-up and enter a when ready. If you answer 'N' to this prompt, you will be asked to insert valid backup volume and when ready. This is any diskette that has been backed up using '*V' and contains the file(s) you wish to restore. 3. After entering , the first and last file on the diskette is displayed with a prompt for a listing of the diskette directory. If you wish a listing enter 'Y', , and all the files of the diskette will be displayed. 4. After the diskette listing, the restore parameters will be displayed with the prompt asking if the files should be restored to the original volume. This will allow you to put the files back to the directory from which they were backed up. If you wish to put the files to the same directory from which they were backed up, enter 'Y', otherwise enter 'N'. If you enter 'N' you will be asked to which volume to write them. Enter the directory number to which you wish the files to be restored. 5. The next prompt is asking if you wish to write over a file that is already on disk. If you answer 'Y', you will be asked if you want to be advised before over-writing a file. This parameter will allow you to answer with a 'Y' or 'N' before a file is over-written. If you answer 'N', the system will go to the next step. 6. If you are not doing a complete restore you will next be asked if you wish to restore a range of files. If you answer 'Y' to this question, you will be asked for the from/to file names. These names must have the volume number from which they were backed up as the first character. (e.g. 1FILENAME, is the file 'FILENAME' and comes from directory number 1.) 7. If you answer 'N' to the range question, you will be asked for a single file to restore. This file name will also have to have as its first character the volume number from which that it was backed up. 8. After entering the parameters, you will be asked if they are correct. If they are, enter 'Y', and the restore will take place. If you need to change something enter 'N', , and make the modification. 9. After the restore is complete, a message will be displayed informing you that the restore is complete with a prompt to enter to continue. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg041 10. If you are doing a complete restore the will take you back to the BACKUP/RESTORE Menu. If you are doing a selective restore the will take you to the restore parameter options. To get back to the '**' Menu, enter . 6.0 SYSTEM CUSTOMIZATION AND UTILIZATION This section outlines the steps to customize and utilize your MAI 1500 in the following areas: o System Cache Buffering o The File System o The Color monitor o Non-standard serial ports o Auto-starting terminal ports o Ghost tasks In addition to these areas, you can use the "*NPSD utility to customize the data format, date delimiters, edit delimiters, parallel printer model code, terminal and printer ports for international character sets, besides having the lister and compiler resident. The steps to customize these items can be found in section 3.4 'Configuring the System'. 6.1 System Buffering The MAI 1500 uses two different types of System Memory Cache Buffering: (Buffering is storing data in memory so that each time this data is used or modified a read or write to the disk is not required.) The next two sections outline the types of buffering the system uses, how to customize them, and how to utilize them. 6.1.1 Device Buffering The system will store sectors of data in memory as they are required. The number of sectors brought into memory on each read is determined by the parameter 'Device Buffering Sector Multiple' in the *NPSD utility under the 'System Options' option. The number of sectors stored in memory is determined by the amount of memory that is available and comes from the amount of memory you have on your system and how you set up your memory banks in the *NPSD utility under the 'Memory Banks' option. NOTE: If you set up a directory for no buffering, then the information in this section does not apply. If it is set up for read only, then all writes go directly to disk. It has been found that for the best utilization of sector buffering a 2 sector multiple should be used. To get the best use of your device buffering when you are setting up the memory banks, it is recommended that you set all unused memory to device buffering. If a memory bank is set up for unused tasks, that memory bank cannot be used for device buffering and is wasted. The two paragraphs above are only recommendations for SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg042 setting up your system. Individual parameters can be modified to fit your requirements. Each time the system is required to read or modify data the system will first look in the system's device cache to see if the data is there. If it is not there, a read or write to the disk is performed and that data is stored in memory. If memory gets full, the system employs an aging scheme to copy the oldest, unmodified data back to disk. The device buffer cache is written to disk if it was modified and the sync interval has been reached. The sync interval is the number of seconds between the end of one disk buffer write cycle and the beginning of the next. The modified data is written to disk as the program performing the search is given its CPU time slice. In other words, not all data is written to disk at one time. The sync interval time is set up in the *NPSD utility under the 'System Options' option. The data from a directory is written to disk from the cache as the directory is globally disabled (see 6.2 for more details). 6.1.2 File Information Buffering The other type of memory buffering the system uses is file information buffering. That is, the storing in system memory of information about a file, such as the FID of the file and if it is being used or not. The number of file information entries that can be stored in memory is set by the *NPSD utility in the 'System Options' option under the 'Size of Internal File Dictionary' parameter. Each time a file is opened, closed or accessed this cache is checked to see if the information about this file is present. If it is not there, a read of the disk is required to get the file information before a read of the data can be made. This parameter must be set high enough to store the data of all open files on the system. Care should be taken when setting this parameter because if it is too large the system will run inefficiently. The recommended number for this parameter is 72, as this is large enough to handle a good number of opened and closed files and still small enough not to use up system time by looking through it each time a file is used. The data from this cache is written to disk each time a global disable of the directory is performed (see 6.2). When the cache gets full, the system uses the same type of aging scheme as is used for device buffering to clear unused data. 6.2 The File System The disk on the MAI 1500 is divided up into 512 byte sectors. On a bootable disk, both hard disk and floppy diskette, the first 544 sectors are taken up with the following: 1 sector for the boot, 1 sector for the disk table of contents, 26 sectors for the available sector table, 2 sectors for the media descriptor table, 1 sector for the bad track table (on the floppy diskette this is dead space), 512 sectors for the Operating System and BASIC. Sector 544 to the highest sector available (HSA) is free for the user's use. On other disks the first 32 sectors are used by the disk for its own information, and the rest of the disk is SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg043 available for the user. Alternate tracks are located beyond the highest sector available on the hard disk. NOTE: By disk, this section of the announcement is referring to the BOSS partition of your disk. If you have partitioned your disk with MS-DOS and BOSS, the sectors in the above paragraph are taken from your BOSS partition. The disks on the MAI 1500 can be divided into up to 20 directories. The system requires one directory active for each disk you wish to use on the system. Of these 20 possible directories, 10 can be active on the system at one time. If you have all 10 directories active and wish to use another directory, you will need to run the *JPSD utility to switch the directory you wish to use with another directory (5 option). Dividing your system up into more than one directory does not partition it into different sections. Each directory does not take a section of disk for its use, but is a file itself that contains the information about the files that are in it. WARNING: When defining a directory, you are asked what are the maximum number of files that it can contain. This number is fixed! If you wish at a later date to add more files to the directory you will have to move all the files from one directory to another, delete the old one, and re-define it for a larger number of files. It is recommended that you define the directory for more files than you feel you will ever put in it, or use more than one directory for your program and data files. If your system contains a second disk drive or you have a floppy diskette that you wish to access, then a directory will have to be defined for each. As long as that directory is enabled, the system will access it for files. Directories cannot span disk, and therefore files cannot span disk. If you have two hard disks and a floppy diskette that contain files you wish to use, you will have to have at least three directories defined and active on your system. When the system is booted, all directories that are activated will be enabled. There are two types of disable/enable in BB6, GLOBAL and LOCAL. Each type does something different. The global disable is the directive "DISABLE" followed by the directory number of the directory you wish to disable (eg. DISABLE 1). This will disable that directory system-wide so that no other task will be able to access it. It will also cause all entries in the device cache associated with that directory to be written to disk. To enable the directory again, the task that disabled the directory will need to use the global ENABLE command followed by the directory number (eg. ENABLE 1). The other way to disable a directory is by the use of the local DISABLE. This is the directive "DISABLE" followed by the number of the directory to disable, then a comma, and the word "LOCAL" (eg. DISABLE 1,LOCAL). This will disable a directory locally. A locally disabled directory is disabled only for the task that disabled it. All other tasks can still access it normally. This type of disable does not cause a write of device cache data to disk. To enable the directory, the task that disabled it will need to use the ENABLE command followed by the directory number, comma, and "LOCAL"(eg. ENABLE 1,LOCAL). NOTE: The use of ENABLE without LOCAL will not enable a directory that was disabled locally. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg044 WARNING: When a file is accessed, the O.S. will look through the file dictionary for the file, and the first file by that name is the one it will use. This includes ERASEs, LOADs, READs, WRITEs, etc. So, care should be taken to disable other directories that may contain files of the same name as a file you are working with. This disable should be of the local type so as not to prevent other tasks from using the directory. 6.3 Setting Up Terminal Parameters As discussed in the following sections. Most terminal parameters are set through the BASIC CONFIGURATOR by entering '*N' from the UTILITIES menu and then selecting the appropriate action from the menu. 6.3.1 The Color Monitor The color monitor is able to produce 8, high-intensity, foreground colors with an equal number of low-intensity, background colors. BOSS normally to outputs high-intensity, white foreground characters and low-intensity, white background characters. The foreground character color is determined by the escape sequences in each of the following mnemonics: CF - Clear foreground CL - Clear a line CS - Clear screen LD - Line delete LI - Line insert SF - Start foreground TI - System boot The background character color is determined by the 'SB' mnemonic. Each time one of these mnemonics is used, the color will be determined by how that mnemonic's escape sequence is configured. For example, if the 'TI' mnemonic is set up for the color red and the 'CS' mnemonic is set up for the color white, the monitor will produce red foreground characters as the system is booted. This foreground will remain in effect until the 'CS' mnemonic is used, at which time the foreground characters will switch to white. The following describes the steps to set up your system's mnemonics to produce the colors you wish: 1) Enter RUN "**" (In the console mode) 2) Select *NPSD from the BOSS UTILITIES MENU 3) Select menu item 1 from BOSS CONFIGURATOR 4) Select menu item 6 - TERMINAL TABLES 5) Select menu item 1 - MODIFY TERMINAL TABLES 6) Select M - (M)odify 7) At "ENTER TERMINAL TABLE" enter, CONSOLE 8) At "ENTER TERMINAL NAME (20 CHARACTERS MAX):" enter, 9) At "ENTER TERMINAL BACKSPACE CODE (HH):" enter, BACK18 10) At "ENTER NUMBER OF NULLS FOR SCREEN ROLL..." enter, 11) The screen will display a "LIST OF DEFINED MNEMONICS" and you should enter SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg045 the code(s) you want to modify. 12) The screen will display: -----OLD VALUE--> $XXXXXX... 19.1 ENTER CODE TO BE TRANSMITTED TO TERMINAL: The OLD VALUE field will display the current contents of the mnemonic. The mnemonic pattern relating to color is $1B36XX, where the XX determines the foreground/background color as follows: BACKGROUND FOREGROUND CHAR COLORS CHAR COLORS 00 = BLACK 08 = HIGH INTENSITY BLACK 01 = BLUE 09 = HIGH INTENSITY BLUE 02 = GREEN 0A = HIGH INTENSITY GREEN 03 = CYAN 0B = HIGH INTENSITY CYAN 04 = RED 0C = HIGH INTENSITY RED 05 = MAGENTA 0D = HIGH INTENSITY MAGENTA 06 = BROWN 0E = HIGH INTENSITY BROWN 07 = WHITE 0F = HIGH INTENSITY WHITE NOTE: IN ORDER TO CHANGE ANY PART OF A MNEMONIC, THE ENTIRE MNEMONIC MUST BE REENTERED. This is important since many of the mnemonics are multi-valued. The "standard" foreground mnemonic value is $1B360F. The "standard" background mnemonic value is $1B3607. A table of "typical "mnemonic values is shown below for reference: SF - $1B360F CF - $1B33031B360F CL - $1B33011B360F CS - $1B351B360F LD - $1B341B360F LI - $1B341B360F TI - $1B33001B360F SB - $1B3607 There are five prompts (19.1 - 19.5) for each mnemonic. Enter to leave the values unchanged. 13) When all mnemonics have been modified, enter END AT "ENTER MNEMONIC CODE MM:" 14) At "SAVE NEW TERMINAL TABLE (Y/N)?:", enter Y 15) At " CREATE OR MODIFY MORE TERMINAL TABLES (Y/N)?", enter N 16) Answer Y to save the configuration 17) Reboot the system 6.3.2 Non-standard Serial Ports This section describes the steps to modify your serial ports for parity/stop bits/word length, receiving nulls ($00$) during communication, and disabling XON/XOFF protocol during communication. It also describes the steps to modify your printer port to a longer printer timeout. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg046 Each modification requires you to do a GET from disk, modify certain bytes in that sector, and then do a PUT to write them back on disk. The first part of this section gives the bits/bytes that need to be modified, and the last part shows an example of how to modify the parity on the second terminal. PARITY/STOP BITS/WORD LENGTH: LOCATION: sector 52/bytes 227,2 CONTENTS: bit pattern as described below: 7 6 5 4 3 2 1 0 _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ must be 0 x0=none _ 10=7bits 01=odd _ 11=8bits 11=even _ _ 0=1 stop bit 1=2 stop bits byte 227 controls COMM1 (your first serial port) byte 228 controls COMM2 (your second serial port) The software comes with: odd parity/1 stop bit/7 bit words which are defined by the bit pattern 0000 1010 = $0A$ ALLOW RECEIVING OF NULLS ($00$) DURING COMMUNICATION: LOCATION: sector 50/bytes 145, 2 CONTENTS: was $7445$ / change to $9090$ DISABLE XON/XOFF PROTOCOL DURING COMMUNICATION: LOCATION: sector 50/bytes 114,2 CONTENTS: was $7415$ / change to $EB1B$ LENGTHEN PRINTER TIMEOUT: LOCATION: sector 47/bytes 83,1 CONTENTS: was $96$ / change to larger number $FF$, if $FF$ is not long enough, byte 84 is the high byte and starts at $00$. PROCEDURE: The following is a sample showing the procedure to change the parity on the second serial port from odd to even: DIM A$(256) GET 9,52,A$ PRINT HTA(A$(228,1)) [verify expected contents] LET A$(228,1)=$1A$ [$1A$=0001 1010] PRINT HTA(A$228,1)) [verify new contents] DISABLE 9 PUT 9,52,A$ ENABLE 9 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg047 6.3.3 Auto-Starting Auto-Starting allows the system to automatically boot up a specified program or boot up the BASIC CONSOLE MODE. After an install, auto-starting will be enabled only on the CONSOLE. To enable auto-starting on other Tasks, enter the BASIC CONFIGURATOR menu and select option 1, SERIAL PORTS. Select the port number you want to modify, and enter it at the ENTER PORT NUMBER TO MODIFY (CR TO EXIT): prompt. The port should be configured for the type of device you will have attached and its associated parameters. A summary of the prompts for accomplishing this are shown below. ENTER DEVICE CODE: ENTER BAUD RATE: AUTO START (Y/N): ('Y' will cause the terminal to come up with 32 pages of memory 'N' will require a manual START later. ENTER BANK NUMBER: (Assure that you have enough tasks configured to use the bank) ENTER PROGRAM (BLANK FOR BASIC CONSOLE MODE): After making modifications, enter to return to the CONFIGURATOR menu, and then select 'Y' to save the configuration. Remember to re-boot the system. 6.3.4 Ghost Tasks Ghost tasking allows you to enable up to 4 tasks running as background processes. You must have the number of ghost tasks you want to run allocated, via the BASIC CONFIGURATOR (See Section 3.4.1) in order to use them. You also must have task area set up in a bank for each ghost in addition to the terminals you have started. The command to start a Ghost Task has the general format: START n, ["pgm name"], "Gm" where n = 1 - 127 m = ghost id (0-3) To check the status of a Ghost Task, enter *G at the UTILITIES menu and then the id (0-3) of the task you want. 7.0 DISK COMPRESSOR Disk Compressor is used to maintain the efficiency of your disk file system. It is recommended that this utility be run at least weekly after a back-up or if any disk problems occur. This utility will: o Consolidate available disk sectors into one large continuous area on your disk. o Identify any disk allocation errors that have occurred on your disk SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg048 due to operating system hangs, improper system shutdown, power failures and any direct sector allocation problems. o Separate and identify any overlapping files that were caused by operating system hangs, improper system shutdown, power failures, and any direct sector allocation problems. o Relocate files that have been allocated in the diagnostic cylinder possibly caused by a previous allocation problem. The Disk Compressor diskette contains two different programs. DISMAP is used to prepare a sequentially ordered listing of you disk space. If run before DSKCPR, it will identify the current state of your disk with respect to overlapped files and gaps of sectors that are unavailable to the system. 7.1 Disk Map (DISMAP) DISMAP is provided to the user as an added utility that will prepare a sequentially ordered listing of your disk space. If run before Disk Compressor, it will identify the current state of your disk with respect to overlapped files and gaps of sectors that are unavailable to the system. To run this utility, with the Disk Compressor disk in the floppy disk drive, type 'RUN "DISMAP"' from console, or by entering 'DISMAP' at the BOSS Utility selector prompt. The first display shows the defined directory names with their starting sectors, ending sectors, current number of directory entries and maximum number of entries defined. You will be prompted for the output device; this can be either 'TO' or 'LP'. A listing will be output to the device you entered showing starting sector, ending sector, size in sectors, directory the file is in, file name, remarks and errors found within file. The error field can contain one of two errors as follows: Overlap - The file that appears with this message overlaps the file listed above. Gap - This area is not being used and does appear on the available sector table. The remarks field can contain one of two messages as follows: Temporary - Currently used by DISMAP Available - Current available sectors When this utility has completed with the listing it will return to the BOSS Utility menu. 7.2 Disk Compressor (DSKCPR) DSKCPR is the program that performs the disk compressing. It runs in three steps: 1. Verify This will read the hard disk to determine the validity and current version of the operating system. Next, DSKCPR scans every directory on the disk to verify that file names are valid and the space allocated by the operating system is not SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg049 occupied by more than one file. If no errors are found in this step, the program will skip the reconstruct. 2. Reconstruct The reconstruction step of DSKCPR will construct a new AVS (available sector table) based on the directory contents derived from the verify step. DSKCPR will separate any files that overlap and inform the user of any impending problems before the compress step can be executed. 3. Compress The compress step uses the AVS table to identify the computed free space on the disk and moves all program files together creating one single free space area at the end of the disk (high sector numbers). If the user checks the AVS table after this step, there will be only one entry. 8.0 SYSTEM SECURITY 8.1 1500 System Password Procedure This procedure describes the steps necessary to provide a PASSWORD key to anyone requiring additional installation of BOSS from the BOSS SYSTEM DISK after they use up the allowed 2 installs. The USER will have reached the point in the installation where the following error message appears at the bottom of the screen: INSTALLATION NO LONGER POSSIBLE FROM THIS DISKETTE. PLEASE CALL YOUR LOCAL PRODUCT SUPPORT OFFICE. ('CR' TO CONTINUE): At this point the USER should enter 'RESTORE', . The system responds with: ACCESS CODE: (A series of letters) SERIAL NUMBER: (S/N of diskette) ENTER PASSWORD: At this point, call Software Distribution to get the PASSWORD. You'll need the Serial number on the BOSS diskette and the ACCESS CODE. This procedure can be repeated if additional installations are required. There is no limit to the number of times this can be repeated. However, only one installation is possible each time. Enter the PASSWORD , and continue with the installation. ENTER SERIAL NUMBER: (Enter the S/N of the diskette) ACCESS CODE: (Enter the series of letters) SERIAL NUMBER OK. PASSWORD: (A series of letters) This PASSWORD should be given to the USER to enter on their system at the PASSWORD prompt. This will enable an additional installation of BOSS. 8.2 Application Program Encryption The ENCRYPT diskette (P/N WG135AA) contains a program that will SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg050 protect source code programs from being loaded and listed. This diskette can be purchased as an option with the MAI 1500. The program may be run via the floppy or copied to the hard disk. To execute the encryption program perform the following: 1. Enter 'ENCRYPT' , at the BOSS system prompt. 2. At 'DISC ID:', enter the directory number where your programs are located. 3. At 'ENTER FILENAME OR MASK; '@' FOR ALL, to END', enter the appropriate option. 4. At 'ASK TO ENCRYPT EACH FILE? Y/N' select the appropriate option. WARNING: ONCE PROGRAMS HAVE BEEN ENCRYPTED, THEY CANNOT BE UNENCRYPTED. Notes: Statements 0 - 20 in each program are still listable after encryption. A program line can still be modified by typing the line number and entering the changes. The newly entered line will not be encrypted. 9.0 INTERSYSTEM TRANSPORTING The MAI 1500 supports the asynchronous transport package ATP. This section outlines the harware/software requirements for use of this package on the MAI 1500, the steps to install it, the steps to use it and the known problems and workarounds for the package. Warning: This version of ATP is not compatible with any other version. Before using this package ensure that the system you are communicating with has the same version. For more information on this please see the ATP software announcement. 9.1 Hardware/Software Requirements The following is a list of the hardware and software requirements to run the ATP package: o A terminal on which to communicate with the operator o An asynchronous port, configured as a standard VDT, to use as the communications port o A cable to connect the two system ports. This cable will require that pins 2 and 3 are crossed. o The package installed on the hard disk or on an enabled floppy o Optional, a printer to print out the transport conversion considerations. 9.2 Installing the ATP Package The ATP package can be run from an enabled floppy diskette or from the hard disk. If you wish to install the package on to the hard disk, first enble the ATP floppy and next use the "*S" utility to transfer all the programs to the hard disk. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg051 9.3 Using the ATP package on the MAI 1500 The steps for using the ATP package on the MAI 1500 are the same as those outlined in the 'Intersystem Transport Package User Guide', BFISD 6354C. For this system use the steps for the 13xx type systems, as they are the same with the following exceptions: o ATP is the only transport media available for the MAI 1500. For this reason when defining a BQR filelist you are not given a transport media option. o Programs and data files are converted during the transport, therefore, no option for data conversion is given. That option has been replaced with an option for printing transport and conversion listings. o The use of schemas for mixed data type files is not supported so there is no option for schema generation. The only type schemas you can use are text or binary type files. (For details on how to handle this type of file see the next section.) 9.4 Known Problems and Workarounds for the ATP Package Following is a list of know problems with this version of the ATP transport including a work-around for each: o This version of ATP is not compatible with any other version of ATP. For this reason care should be taken when using this package to ensure that the two systems that will be communicating have the same version of ATP. Since this new version of ATP uses a new protocol if you try to transport from any other version of ATP to this version communications start. If you are transporting from this version to an other version the results will be unknown. o Serial files are not supported on the MAI 1500. Transporting this type of file to the MAI 1500 will cause an error. Workaround: If you need to transport this type of file on the sending system, first write them to an indexed file. o It change the number of records received on an indexed file, As the MAI 1500 fills up a whole disk sector, this will cause your file to end up with additional records at the end of the file. Workaround: Write the indexed file to a new index file with the correct number of records on the MAI 1500 side. o The schema generation and use of mixed data-type files is not supported. Workaround: On the receiving system, after the transport, use the following program to convert the binary fields back to proper data: This will require a file to be defined with the same parameters as the file you wish to modify. It will be called 'NEW FILE' for this procedure. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg052 10 OPEN(1)"FILE TO CHANGE" 20 OPEN(2)"NEW FILE" 30 READ (1,KEY="",ERR=40) 40 LET K$=KEY(1,END=100) 50 READ (1,KEY=K$)A$,B$,C$; REM"ENTER AS MAY FIELDS AS THERE ARE IN YOUR FILE. FOR THIS EXAMPLE ONLY FIELD B$ WILL BE CONVERTED, BUT AS MANY FIELDS AS YOU WISH CAN BE MODIFIED." 60 DIM Z$(LEN(B$),$80$) 70 LET B$=XOR(B$,Z$); REM "THIS WILL CAUSE THE HIGH BIT TO BE FLIPPED. TO CONVERT MORE FIELDS ADD LINES TO DO THE STEPS IN 60 AND 70. 80 WRITE (2,KEY=K$)A$,B$,C$ 90 GOTO 40 100 PRINT "CONVERTION COMPLETE. ERASE THE OLD FILE AND RENAME THE NEW TO THE OLD!" 10.0 FOR YOUR INFORMATION This section summarizes the reported, known problems with this release and any associated workarounds. 1. RELEASE: 6.2A BOSS SYMPTOM: Floppy drive not enabled for use by the CONSOLE after formatting from another task. WORKAROUND: Enter from the CONSOLE. 2. RELEASE: 6.2A BOSS SYMPTOM: Making the SIZE of the INTERNAEL FILE DICTIONARY greater than 110 causes an ERROR 41 and requires that the system be reinstalled. WORKAROUND: Insure that the size of the Internal File Directory is less than 110. 3. RELEASE: 6.2A BOSS SYMPTOM: Date packing format from other systems causes problems when transported to the 1500. WORKAROUND: Create new files without packed dates, and resend. 4. RELEASE: 6.2A BOSS SYMPTOM: Incorrect number of diskettes calculated for doing a BACK UP. WORKAROUND: An EOF falls on a Sector boundry. Increase or decrease file size slightly and retry BACK-UP. 5. RELEASE: 6.2A SYMPTOM: The BOSS UTILITIES MENU can accomodate only 29 items after that point, the @ADD and @DELETE commands don't function normally. This is in conflict with the BOSS REFERENCE MANUAL which states that 34 entries are allowed. WORKAROUND: LOAD 'XXPSD', 'REM' STATEMENT 8510 If the system will not boot from the hard disk, it may be because: a. No partition is activated. Check this with 'fdisk' or *PARTDSK. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg053 b. Wrong Hard Disk Drive Type configured. Check this by booting the SETUP AND TEST diskette and reviewing the current configuration in the SETUP menu. 11.0 HELPFUL HINTS 11.1 LOADING THE PRINTER VFU Documentation to the contrary, the SL (Start Load) and EL (End Load) mnemonics do not work. However, there is a workaround that can be used with Whisper and DMP printers. Using the load codes in the table below you can create a VFU string and send it to the printer. Once the VFU is loaded the Sx and VT mnemonics can be used. The hex codes are: $1E$ Start VFU load $10$ Form Feed $1F$ End VFU load $11$ Channel 2 $12$ Channel 3 $1D$ Fill Character $13$ Channel 4 $14$ Channel 5 $16$ Channel 7 $17$ Channel 8 $0B$ Vertical Tab The step by step process is: 1. Modify the mnemonic table with the following codes: S2--> $11$, S3--> $12$, S4--> $13$, S5--> $14$, S7--> $16$, S8--> $17$, VT--> $OB$ (Re-boot the system to load the new codes). 2. Define the VFU string. For example: A$=$101D1D111D1D121D1D1D131D1D1D1DOB1D1D1D1D$ This string sets the form length to 29 lines, channel 2 at line 4, channel 3 at line 7, channel 4 at line 11 and a vertical tab at line 16. 3. Send the Start Load code, followed by the VFU string, followed by the End Load code: OPEN(1)"LP" PRINT(1) $1E$,A$,$1F$ An alternate approach is to define a special mnemonic that performs the above sequence and sends it to the printer as part of a system start-up routine. For example, the TI mnemonic could be modified to: $1E101D1D111D1D121D1D1D131D1D1D1DOB1D1D1D1D1F$ Note that unlike terminals, TI is NOT sent to the printers by the OS as part of the boot process. 11.2 The following is the procedure to set the forms length in # of lines on the Parallel PT-4217/18 on the 1500: Forms length through BOSS (BBPC): SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg054 PRINT (1)'BO',$1B43xx$, 'EO' xx = The hex of the decimal from 01 to 255. Example: of 20 lines per page: The hex of DEC 20 is 17 so, xx should be $17$. Forms length from GWBASIC: lprint chr$(27) "C" chr$(n) n =# of lines from 1 to 255 12.0 DOCUMENTATION The following are the manuals are currently available for the MAI 1500. They are now available and can be ordered. M5101 - BOSS Installation Manual M6260 - BOSS Reference Manual M6234 - MAI 1500 User Guide M8105 - MAI 1500 Service Manual ORIGINATOR: MBF SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB003 Pg055 FIB 00004 10/01/86 *** Updated mnemonics for 4217/4218 printers on 1500 at OS 6.2A *** The mnemonics have been updated for both the serial and parallel versions of the 4217 and 4218 printers on the 1500. In most cases, the mnemonics set to IGNORE were changed to ERROR 29. The two mnemonics that must be changed in order to run the Pharmacy application are 6L and 8L (see table below). The corrected mnemonics will be incorporated in the 6.3A Operating System. To install the new values, use the "MODIFY TERMINAL TABLES" menu in the *NPSD utility (see Reference Manual for instructions). The values that have changed are indicated by an *. Mnemonic Value Mnemonic Value Mnemonic Value BS Error 29 S5 Error 29* 6L 1B32* CF Error 29* S7 Error 29* RC Error 29 CH Error 29* S8 Error 29* BE Error 29 CL Error 29 SB Ignore EE Error 29 CR 0D SF Ignore CE Error 29 CS Error 29* SL Error 29* DC Error 29 EL Error 29* TR Error 29 IC Error 29 EP 0E* VT 0B TL Error 29 ES 1B 8L 1B30* BO Ignore* FF 0C BB Error 29 EO Ignore* LD Error 29 EB Error 29 BG Ignore* LF 0A SI Error 29* EG Ignore* LI Error 29 SO Error 29* BT Error 29 PM Error 29* BH Error 29 ET Error 29 RB Ignore* EH Error 29 BI Error 29 S2 Error 29* BU 1B2D01* EI Error 29 S3 Error 29* EU 1B2D00* PG Error 29 S4 Error 29* CI Error 29* TI Error 29* Some additional mnemonics that might be helpful and can be added via the *NPSD are: NL 0A0D OP 0D 10 1B2100 12 1B2101 16 1B2104 ORIGINATOR: T. SEARS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB004 Pg001 FIB 00005 10/16/86 *** Possible corruption of BOSS and MS-DOS partitions *** There is a problem with the 'fdisk' program (MS-DOS version 3.10, I/O system 1.03B) that results in both the BOSS and MS-DOS partitions becoming corrupted. When 'fdisk' is used to change to a non-DOS partition, the final part of the processing (hitting twice, then booting) writes $02$ to sector 0, byte 11. of the BOSS paartition, and writes $03$ or $04$ to sector 2, byte 11 of the DOS partition. This causes an UNEXPECTED SW INTERRUPT XX AT YYYY error, making it impossible to boot from either partition. There are two recommended ways to prevent this from occurring. METHOD ONE - 1. After changing the active partition to non-DOS at the 'Change Active Partition' menu, DO NOT 'Press to return to FDISK Options.' 2. Reboot at this point. If is used, the error will occur, METHOD TWO - 1. Keep the BOSS partition always activated. 2. To use DOS, boot up the MS-DOS diskette. 3. Change the current drive to 'C'. 4. Remove the diskette and run DOS. 5. Rebooting will go back to BOSS. If the UNEXPECTED INTERRUPT.... has already occurred, then the workaround is to modify sector 0 of drive 0, byte 11 of the BOSS partition and sector 2 of drive 0, byte 11 of the MS-DOS partition (assuming MS-DOS is the first partition on the disk). To modify BOSS, perform the following: 1. Boot the BOSS SYSTEM DISKETTE and select menu option 3 to get into CONSOLE. 2. Verify the contents of sector 0, byte 11 and if it's wrong, fix it as follows: DIM A$(256) GET 0,0,A$ PRINT HTA(A$(11,1)) The byte should be 'F0'. If it is not, continue with procedure. DISABLE 0 LET A$(11,1))=$F0$ PUT 0,0,A$ To modify MS-DOS, perform the following: 1. Boot with the MSDOS diskette 1 in the floppy disk drive. 2. Use the sys command to reload the MS-DOS system files onto the hard disk: A>sys c: ORIGINATOR: T. SEARS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB005 Pg001 FIB 00006 10/17/86 *** Error 19 in the 'bencrypt' utility *** Original Document Name - Worldwide Product Support Field Bulletin 256 When encrypting BASIC programs using the utility 'bencrypt' an error 19 can occur. This will occur when using the filelist that contains programs that have been csaved. The following is a workaround for this problem: Use the filelist utility to create a filelist of programs to encrypt. Ensure that you have the 'EXPANSION' option set to 'yes' in the utility. WARNING: This program will not make a backup of the programs to encrypt. Ensure that you have backup copies before encrypting any program. NOTE: basic.f will be the name of the filelist to use. 10 OPEN(1)"/util/fl/basic.f" 20 READ(1,END=100)A$ 30 LET V$=" 'ENCRYPT "+$22$+A$+$22$+","+$22$+A$+$22$+"'" 40 LET V$=" !basic s=256 "+V$; EXECUTE V$ 50 GOTO 20 100 PRINT "PROGRAM COMPLETE" This will encrypt the BASIC programs for you. ORIGINATOR: W. MOORE SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB006 Pg001 FIB 00007 04/27/87 *** BOSS release 6.3A is now available *** The new BOSS Operating System, level 6.3A is now available for the MAI 1500 system. This level Operating System is the recommended level operating system for the MAI 1500 multi-user system. This new Operating System provides enhancements which were not available with the previous O/S. They include: o Up to 10 user capability, with the addition of the multi-port adapter. ** NOTE ** Avoid the use of the monitor as an input terminal. If used as a standard input terminal it may cause "system hang". o Disk storage of up to 230MB, in any combination of disks. o MCS 1/4" tape streamer back-up. *** NOTE *** The MCS 1/4" tape unit is intended strictly for back-up and restore purposes only. It can neither be used as a boot device, nor as a means of transporting files between other than MAI 1500 systems. o Expanded printer support with the addition of models 4214, 4215 and 4216. For more specific details see the 6.3A Software Announcement. ORIGINATOR: P. KOEHLER SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB007 Pg001 FIB 00008 05/04/87 *** BOSS release 6.3A Software Announcement *** Level 6.3A BOSS operating system and its related software and hardware products are now available for the MAI 1500. BOSS 6.3A offers expanded hardware capabilities such as, 1 to 10 user support, 1/4" tape backup/restore, and disk capacity up to 230 MB. Expanded software capabilities include extended terminal and additional printer support, improved utilities, addition of a tape O/S, expanded disk support, and a simplified upgrade procedure when converting from an earlier release level. This Software Announcement contains complete information about installing 6.3A, upgrading from an earlier O/S level, adding and using new hardware, configuring serial ports, updating and expanding printer mnemonics, summarizing bugs and known workarounds, providing helpful hints, and listing all recommended reference documents. The major differences between 6.3A and prior releases are: 1) The addition of the BOSS MCS 1/4" Tape System and associated O/S. 2) The addition of up to 10 user support using the Multi-port board. 3) Expanded hard disk support up to 230 MB maximum with the addition of 58 MB or 115 MB optional drives. 4) Expanded printer support with the addition of the 4213, 4214, 4215, 4216 printers. Release of the 4217 and 4218 serial printers. NOTE: Serial printers can only be configured for industry standard U.S. ASCII output (i.e., English language). Output of foreign character sets can only be accomplished through the parallel port. TABLE OF CONTENTS 1.0 BOSS OPERATING SYSTEM 1.1 Differences Between BB4, BB6, BB7, and BB8 2.0 SYSTEM START-UP AND SHUTDOWN 2.1 System Start-up 2.1.1 From Floppy Disk Drive 'A' 2.1.2 From Active Partition on Hard Disk Drive 'C' 2.2 System Shutdown 3.0 INSTALLATION AND UPGRADING 3.1 Installation 3.1.1 System Set-up SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg001 3.2 Installing MS-DOS 3.2.1 Create MS-DOS Partition 3.2.2 Formatting and Copying MS-DOS to the Hard Disk 3.3 Installing BOSS 3.3.1 BOSS Disk Set-up 3.3.2 Create BOSS Partition 3.3.3 Loading BOSS on the Hard Disk 3.3.4 Loading ULIB on the Hard Disk 3.4 Configuring the System 3.4.1 System Configuration 3.4.2 Terminal Support 3.4.2.1 International Terminal Support 3.4.3 Printer Support 3.4.3.1 Modifying Mnemonic Codes 3.4.3.2 Mnemonic Table Changes 3.4.3.3 International Printer Support 3.5 Finish Installation 3.6 Upgrading 4.0 MCS 1/4" TAPE SYSTEM 4.1 O/S Set-up Procedures TABLE OF CONTENTS 5.0 SYSTEM HARDWARE 5.1 Hardware Configuration Range 5.2 Hardware Set-up 5.2.1 Graphics Display Adapter (GDA) Board 5.2.2 Serial/Parallel Port Board 5.2.3 Disk Controller Board 5.2.4 Main CPU Board 5.2.5 Multi-port Board 5.2.6 MCS 1/4" Tape Controller Board 5.2.7 Miscellaneous Hardware and Switch Settings 5.3 Cabling 6.0 FOR YOUR INFORMATION 7.0 HELPFUL HINTS 7.1 Loading the Printer VFU 7.2 Setting Form's Length 8.0 REFERENCE DOCUMENTATION SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg002 1.0 BOSS OPERATING SYSTEM The operating system is called BOSS. It is a multiuser business operating system with integrated Business BASIC Level 6 (BB3 and BB4 compatible). Level 6.3A of the BOSS O/S provides expanded capabilities to handle up to 10 users, to provide MCS 1/4" tape backup and restore, to allow the use of more printers, and to increase the maximum disk capacity of the system. In the 6.2A Software Announcement (134) all of the necessary general functions and features were discussed. This announcement will present information about all the new hardware and software in 6.3A and review any pertinent information from before. Included also are sections about Installation, System Hardware, Helpful Hints, For Your Information (known problems and workarounds), and Reference Documents, all modified to reflect 6.3A changes. 1.1 Differences Between BB4, BB6 (6.3A BOSS), BB7 and BB8 The following charts shgw!the differences between BB4 (used on the 13xx system), BB6 (used on the MAI 1500), BB7 (used on the MAI 2000/3000), and BB8 (used on the MPx family). An "X" indicates that the command, feature, or mnemonic is present in that version. BASIC Statements BB4 BB6 BB7 BB8 Comments ! X X ADD X X Creates entry in File Control Table ADDE X X Add error handler to public memory ADDR X X X X BEGIN X X X X BEGIN EXCEPT X X CALL X X X X CLEAR X X X X CLEAR EXCEPT X X CLOSE X X X X DEF FNx($) X X X X DELETE X X X X DIM X X X X DIRECT X X X X DISABLE X X Prevents access to a logical disk SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg003 DROP X X X X EDIT X X X X ENABLE X X Allows access to a logical disk ENCRYPT X Encrypts BASIC program END X X X X ENDTRACE X X X X ENTER X X X X ERASE X X X X BASIC Statements BB4 BB6 BB7 BB8 Comments ERROR X X Displays current BASIC error ESCAPE X X X X EXECUTE X X X X EXIT X X X X EXITTO X X X X EXTEND X Allows longer variable names EXTRACT X X X X EXTRACT REC X X X X FILE X X X X FIND X X X X FIND RECORD X X X X FLOATING PT. X X X X FOR/NEXT X X X X GET X X Reads from a specific disk location GOSUB X X X X GOTO X X X X IF X X X X INDEXED X X X X INPUT X X X X INPUT RECORD X X X X IOLIST X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg004 LET X X X X LIB X LIST X X X X LOAD X X X X LOCK X X X BASIC Statements BB4 BB6 BB7 BB8 Comments MERGE X X X X NEXT X X X X NO EXTEND X Takes system out of EXTEND mode ON GOSUB X X X Transfers program to a subroutine ON GOTO X X X X OPEN X X X X OPEN INPUT X X Open a file in read only mode PRECISION X X X X PREFIX X Defines list of directories to search PRINT X X X X PRINT RECORD X X X X PROGRAM X X X Defines parameters of a Program file PSAVE X Copies a program (obj code only from memory to a Program file on disk PUT X X Writes data to a specific disk loc. QUIT X Enter command language from Business BASIC RANDOMIZE X Establish starting seed value for RND READ X X X X READ RECORD X X X X RELEASE X X X X REM X X X X REMOVE X X X X RENAME X Rename a file RESERVE X X Restricts logical disk access SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg005 RESET X X X X BASIC Statements BB4 BB6 BB7 BB8 Comments RETRY X X X X RETURN X X X X RUN X X X X SAVE X X X X SELECT X X Specifies sequence of directories used in a file search SEQ X Supplies program statement numbers SERIAL X X X Defines a serial file SETCTL X X X Program control is transferred to another part of the program SETDAY X X X X SETERR X X X X SETESC X X X X SETTIME X X X X SETTRACE X X X X SORT X X X X START X X X X STOP X X X X STRING X Defines a UNOS string file SYSTEM X X Executes system-level command from BASIC. TABLE X X X X UNLOCK X X X X VMERGE X Program merge from STRING files. WAIT X X X X WRITE X X X X WRITE RECORD X X X X FUNCTIONS BB4 BB6 BB7 BB8 Comments SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg006 ABS X X X X AND X X X X ASC X X X X ATH X X X X ATN X Returns the arctangent BIN X X X X BSZ X X Returns bytes of available memory CHR X X X X COS X Cosine CPL X X X Converts BASIC statement to complied form CRC X X X X DEC X X X X DSD X X Returns info on specified directory device or task EPT X X X X ERR X X X X Returns an integer value that depends on value of ERR variable EXP X Exponential FID X X X X FNx($) X X X X FPT X X X X GAP X X X X HSA X X Variable in BB8 HSH X X X X HTA X X X X FUNCTIONS BB4 BB6 BB7 BB8 Comments IND X X X X INT X X X IOR X X X X KEY X X X X LEN X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg007 LOG X Natural logarithm LRC X X X X LST X X X Converts compiled BASIC stmt to English text format LVL X Returns level of BASIC software or file system MAX X Maximum argument value MIN X Minimum argument value MOD X X X X NOT X X X X NUM X X X X PCK X Stores numbers in packed format PGM X X X Returns complied format of designated statement number POS X X X X PUB X X X Returns info on public programs RND X Random number SIN X Sine SGN X X X X SQR X Square root SSZ X Variable in BB4 & BB8 FUNCTIONS BB4 BB6 BB7 BB8 Comments STR X X X X TBL X X Same as TBL=option + TCB X X Variable in BB7 & BB8 TIM X X Variable in BB7 & BB8 TSK X X X Returns memory parameters of active tasks TSK(O) X X X Lists all tasks & terminal devices UNT X Returns lowest unused unit number UPK X Unpack SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg008 XOR X X X X VARIABLES BB4 BB6 BB7 BB8 Comments CSW X Tells if current program is a RUN or CALLed program CTL X X X X DAY X X X X DSZ X X X X ERR X X X X HSA X X Function in BB6 PFX X X Returns prefix list PGN X PNM in BB7 & BB8 PNM X X PGN in BB6 PRC X X Returns arithmetic precision PSZ X X X X SPF X Current system prefix SSN X X X X SSZ X X Function in BB6 SYS X X X X TCB X X Function in BB6 TIM X X Function in BB6 TSM X Termination status message OPTIONS BB4 BB6 BB7 BB8 Comments DOM= X X X X END= X X X X ERR= X X X X IND= X X X X IOL= X X X X ISZ= X X X Allows file to be accessed as an indexed file KEY= X X X X SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg009 LEN= X X X X SEQ= X X X Specifies tape file # to be opened (BB7 - 7.2 and 7.3) SIZ= X X X X TBL= X X X X TIM= X X X X PRIORITY= X Spooled priority CLASS= X X Name of class of spooler forms COPIES= X Number of spooled copies OPTS= X Specify printer attributes MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control, * * terminal messages, and printers. * ************************************** BB4 BB6 BB7 BB8 Comments @ (x) X X X X At positioning @ (x,y) X X X X At positioning '6L' X 6 lines to the inch '8L' X X X 8 lines to the inch 'BB' X X X Begin blink 'BC' X Back cursor 'BE' X X X Begin echo 'BG' X X X Begin to generate ERROR 29 'BH' X 'BI' X X X Begin input transparency 'BO' X X X Begin output transparency 'BR' X X Set reverse video 'BS' X X X X Back space 'BT' X X X Begin input buffering 'BU' X X X Begin underline mode 'CE' X X X X Clear screen to end of page SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg010 'CF' X X X X Clear foreground 'CH' X X X X Cursor home 'CI' X X X X Clear input buffer 'CL' X X X X Clear line 'CR' X X X X Carriage return 'CS' X X X X Clear screen 'DC' X X X Delete character MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control, * * terminal messages, and printers. * ************************************** BB4 BB6 BB7 BB8 Comments 'DN' X Move cursor down one line 'EB' X X End blinking 'EE' X X X End echo 'EG' X X X End generation of ERROR 29 'EH' X 'EI' X X X End input transparency 'EL' X X X End load 'EO' X X X End output transparency 'EP' X X X Expanded print 'ER' X X End reverse video 'ES' X X X X Escape 'ET' X X X End input buffering 'EU' X X X End underline 'FF' X X X Form feed 'HT' X Horizontal tab 'IC' X X X Insert character 'KL' X Keyboard lock 'KU' X Keyboard unlock 'LD' X X X X Line delete SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg011 'LF' X X X X Line feed 'LI' X X X X Line insert 'LT' X Move cursor left one space 'NL' X X New line MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control, * * terminal messages, and printers. * ************************************** BB4 BB6 BB7 BB8 Comments 'PE' X X X End protect mode 'PG' X X X Send screen to local serial printer 'PL' X Page mode used with first line of plot data 'PM' X X X Causes terminal to enter plot mode 'PS' X X X Start protect mode 'PT' X Partial transmit 'RBg ) X X X X Ring bell 'RC' X X X Read cursor 'RT' X Move cursor one space to the right 'S2' X X* X X Slew 2 'S3' X X* X X Slew 3 'S4' X X* X X Slew 4 'S5' X X* X X Slew 5 'S6' X* X X Slew 6 'S7' X X* X X Slew 7 'S8' X X* X X Slew 8 'SB' X X X X Start background 'SI' X 'SF' X X X X Start foreground 'SL' X X X Start load 'SO' X 'TL' X X Transmit line unprotected SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg012 * See Section 7.1 MNEMONICS ************************************** * NOTE: In BB6, new mnemonics can * * be defined for screen control, * * terminal messages, and printers. * ************************************** BB4 BB6 BB7 BB8 Comments 'TP' X X Transmit line protected 'TI' X System boot 'TR' X X X Terminal read 'TS' X Transmit screen protected 'UP' X Move cursor up one line 'VT' X X* X X Vertical tab * See Section 7.1 In addition to the differences outlined in the chart, the following should be noted: The field separator on the MAI 1500 is a hex '8A', on other BASICs using the lower ASCII set (e.g. the MAI 2000/3000) the field separator is a hex '0A'. BB6 fully evaluates conditional expressions, whereas other MAI BASIC FOUR BASICs terminate evaluation when a false condition is encountered. For example: IF 1=2 AND 3/0=4 THEN... This expression will fail (i.e., the ELSE path will be executed) in Non- Level 6 MAI BASICs since BASIC will stop the evaluation as soon as it sees the false condition '1=2'. BB6 will continue to evaluate the expression and get an error at the condition '3/0=4'. This expression must be written as a nested 'IF' on BB6: IF 1=2 THEN IF 3/0=4 THEN... The SSN field on the MAI 1500 is a numeric expression. On other systems it is a string variable. The system variable "ERR" does not contain '127' after the ESCAPE key is pressed, as on other systems. It is not possible to program the CONSOLE function keys (F1-F10). Precision is always set to 2 unless specified via a PRECISION directive. BOSS uses sector size = 256 bytes. MS-DOS uses sector size = 512 bytes. 2.0 SYSTEM START-UP AND SHUTDOWN SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg013 2.1 System Start-up The MAI 1500 can either be booted with the MS-DOS or BOSS Operating System. The system start-up used depends on which Operating System you wish to run and the device on which that Operating System is located. It can reside on Floppy disk drive 'A' (the top floppy drive on the system), or the Active partition on Hard disk drive 'C' (the first hard disk drive on the system). NOTE: Do not cycle A.C. power with a floppy diskette installed and the lever in the locked position. When the system is powered up it will automatically get the Operating System from Floppy drive 'A', if there is a bootable diskette (a diskette that contains a loader and an Operating System) in the drive and the disk drive door is closed. If there is a non-bootable diskette in Floppy drive 'A' at boot time and the disk drive door is closed, an error will be produced and you will be required to re-boot the system. If there is no diskette in Floppy drive 'A' or the floppy drive door is not closed, the system will automatically boot from the active partition on the Hard disk drive 'C'. If there is no active partition on the hard disk or the hard disk partition does not contain an Operating System, an error will be produced or the system will display unreadable characters on the Monitor. If the system is powered up and already has an Operating System booted, the system can be re-booted by depressing and holding down and , then quickly depressing and releasing all three. The system will then use the steps outlined above to boot the system. If the message "ERROR, (RESUME='F1' KEY)" appears, depress to complete the boot. If the multi-port board is installed, then the system must be powered off and then on in order to reboot. Following are the steps required to boot the desired Operating System from the correct device. NOTE: If this is a new installation you will need to first boot your system from Floppy drive 'A' by following the procedure outlined below for System start-up from a floppy. You will need to have the "SETUP and TEST" diskette in the Floppy drive 'A' at boot time. 2.1.1 From Floppy Disk Drive 'A' To boot the system from Floppy drive 'A' perform the following steps: 1. Hold the diskette you wish to boot from with the label facing up and towards you, and insert it into Floppy drive 'A'. 2. Do not close the diskette locking lever. 3. If the system is powered off, power on the system, and close the diskette locking lever. 4. If the system has already been booted, depress and hold and then , and depress and quickly release all three keys. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg014 The system will now boot from the diskette in Floppy drive 'A'. 2.1.2 From Active Partition on Hard Disk Drive 'C' As mentioned above, if there is a diskette in the floppy drive and the door is closed, the system will attempt to boot off the floppy. To boot from the active partition on the Hard disk drive 'C' perform the following steps: 1. Ensure that the floppy drive door is open. 2. Ensure that the partition you wish to boot from is Active. To check which partition is Active or to activate a partition, perform the following: A. If you are on the BOSS partition, run the program '*PARTDSK'. This program will allow you to activate the MS-DOS partition. You will be required to re-boot the system after running this program and changing the active partition. B. If you are on the MS-DOS partition, run the program 'fdisk'. This program will allow you to activate the BOSS partition. In MS-DOS the BOSS partition is called non-DOS. NOTE: There is a bug in 'fdisk'. See Field Bulletin #255, MS-DOS 3.10, I/O version 1.03B. 3. If the system is powered off, power on the system. If the system has already been booted, depress and hold and , and depress and quickly release all three keys. The system will now boot from the Active partition on Hard disk 'C'. 2.2 System Shutdown The following outlines the steps required before shutting down the system: NOTE: These steps should also be followed before re-booting the system after it has been powered up and an Operating System has been loaded. 1. Exit all programs. That is, get the system into console mode. 2. If the system is running under BOSS, release all tasks. This is to ensure that all files are closed. NOTE: There is no warning given to the other operators that their task is going to be released. When a task is released all information that the task has in memory will be lost. For this reason it is recommended that all terminals be taken to console mode or a main menu before releasing the task. 3. If the system is running under BOSS, disable all enabled Directories. This is to ensure that the buffering caches are SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg015 written back to the disk before power down. It is now safe to power off or re-boot the system. 3.0 INSTALLATION AND UPGRADING 6.3A is structured so that it can be installed from scratch on a new system or upgraded onto an existing system. The first five parts of this section cover the installation of the O/S on a new system. Section 3.6 covers upgrading procedures. 3.1 Installation The hard disk on the MAI 1500 can be partitioned and set up so that the system can be booted and run as either a single-user MS-DOS system or a multi-user Business BASIC system. This section provides the procedure for installing MS-DOS and BOSS on a one or two fixed disk system, beginning with preparing the fixed disk(s). If the system is going to be used only with BOSS this procedure should still be followed skipping the section on installing MS-DOS. Before continuing with this procedure ensure that you have the following diskettes: o BOSS SYSTEM DISK o BOSS ULIB (Utilities) o MAI 1500 Setup and Test Diskette o MS-DOS 3.1 (2 floppies) Required only if MS-DOS is going to be installed. In addition to the above diskettes you will need the bad track information for your hard disk(s). This information is contained on a label attached to the underside of the MAI 1500 CCA and on the disk drive case. If for some reason the label on the CCA is missing, you will need to remove the cover and read the list from the disk drive case. The relevant information is the Cylinder and Head number. When you have the proper diskettes and have obtained the bad track information, you are ready to begin the installation. Warning: MAI Basic Four has instituted procedures limiting the installation of BOSS to a single system for each copy of BOSS purchased. It is important to understand that for this reason you are restricted to two times that BOSS can be installed on your system. (One installation is counted only after BASIC has been installed. The procedure up to that point can be repeated without restriction.) The system will not allow you to install BOSS a third time; you must contact your MAI Basic Four dealer for information on installing BOSS a third time. 3.1.1 System Set-up This section describes the procedure to tell the system how many hard disk drives are installed and what type they are. This must be done regardless of the combination of operating systems being installed, SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg016 whether it be a system partitioned between BOSS and MS-DOS or a system dedicated to BOSS. To start, insert the "Setup and Test" diskette in floppy drive A (if your system has two floppy drives, Drive A is the top drive), and boot the system. When the boot is complete, the system will display the Diagnostics Main Menu. The setup program stores a record of certain configuration information in system memory. This information is required by the system to function properly, whether it is running under MS-DOS or BOSS. The steps required to setup your system are outlined below: 1. Run the setup program from the Diagnostics menu by selecting Option O. The Setup menu will be displayed. 2. From the Setup menu select Option 0, , 'Set Date and Time'. The current date and then time will be displayed. If they are correct, enter a ; if they are incorrect, enter the correct date and time. When the date and time are correct enter 'Y' and , this will return you to the 'Setup menu'. 3. From the Setup menu select Option 1, 'SET DISKETTE DRIVE TYPE'. This option will allow you to set your floppy disk drive types. The system will display the drive type for both the floppy drives 'A' and 'B'. The floppy drive types are shown as follows: (Not installed = no floppy configured at that location) Double-Density DISKETTE DRIVE - 360 KB floppy configured. HIGH-DENSITY DISKETTE DRIVE - 1.2 MB floppy configured. If the information is correct enter a 'Y' . If the information is incorrect enter a 'N' and enter the correct information for the floppy drives. When the information is correct enter a 'Y' . This will return you to the Setup menu. 4. From the Setup menu select Option 2, 'SET HARD DISK DRIVE TYPE'. This option will allow you to set your hard disk drive types. The system will display the drive types. Four drive types are currently supported on the MAI 1500: 20 MB hard disks (both full-high and half-high) are TYPE 2. 31 MB hard disk is TYPE 3. 115 MB - TYPE 9. 58 MB - TYPE 18. In addition to these drive types, if no drive is SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg017 configured at a location, it will display 'not installed'. If the information is correct, enter a 'Y', . If the information is incorrect, enter an 'N', , and follow the system prompts to enter the correct hard disk drive information. When the information is correct enter a 'Y', , and this will return you to the Setup menu. NOTE: When changing the hard disk drive information the system will display the drive types followed by a prompt to 'enter selection'. This prompt is for hard disk 'C'. 5. From the Setup menu, select option 3, 'SET SYSTEM SPEED'. This option will allow you to set your system speed and, in addition, will enable or disable the system speed button located on the control panel. The system will display the current configuration for your system's speed options. If these are correct, enter 'Y', . If they are incorrect enter 'N', , and enter the correct information. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 6. From the Setup menu, select Option 4, 'SET EXPANSION MEMORY SIZE'. This option will allow you to set system memory expansion. Presently the MAI 1500 is not being sold with expansion memory so this parameter should be set to zero. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 7. From the Setup menu, select Option 5, 'SET PRIMARY DISPLAY TYPE . This option will allow you to set the type of controller your monitor is connected to. The question 'Is a GDA board installed ?' should be answered with a 'Y'. When the information is correct, enter 'Y', , and this will return you to the Setup menu. 8. From the Setup menu, select Option 6, 'REVIEW CURRENT CONFIGURATION . This option will allow you to review the existing system setup. If any of the entries are incorrect, return to the Setup menu by entering a and repeating the appropriate steps. If the entries are correct, enter an to return to the Setup menu. 9. To exit the Setup program and save the updated configurations select Option 7, 'EXIT SET-UP AND SAVE NEW CONFIGURATION'. The system will display the new configuration and prompt you if the entries are correct. If the settings are correct, enter 'Y', , and the system will save the configuration and reboot to the Set-up menu. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg018 The following steps outline the requirements to prepare the hard disk. If your system has two hard disk drives, follow steps 10 - 14 twice. The first time using drive 'C' and the second time using drive 'D'. 10. From the 'SETUP and TEST' Menu select Option 4, 'Hard disk preparation'. 11. The system will display the Hard disk preparation menu, with a message that no disk drives are selected. Enter Option 0, 'Select drive', from the menu. The system will prompt for drive 'C' or 'D', enter 'C'. The system will now display 'Hard disk drive C: selected'. 12. From the option menu enter Option 2, 'Initialize hard disk'. Warning: this will destroy all the data on the disk and should only be run the first time the system is installed. If it is required to run again ensure you have a good back-up of your COMPLETE disk, MS-DOS and BOSS. You will be prompted twice to ensure this is what you wish to do. Enter 'Y' to the first question and to the second. If you do not wish to initialize your disk, enter . 13. When the initialization program is finished, you will be prompted with a message telling you the program is complete and to enter to continue. Enter , and you will be returned to the Hard Disk Preparation Menu. From this menu, select Option 1, 'Enter bad tracks'. 14. This step outlines the procedure to spare the bad tracks from the bad track information gathered earlier from the listing on the bottom of the CCA or from the disk drive. If there are no bad tracks listed then no bad tracks were found. NOTE: Some tracks may not be able to be spared due to program problems in MS-DOS. The following prompt appears and allows you to enter the cylinder number and head numbers listed on the Hard Error Map: TYPE CYLINDER NUMBER, COMMA, HEAD NUMBER, AND THEN PRESS ENTER> From the bad track list, enter the cylinder number, followed by a comma, the head number, and press ; for example, 49, 3 . If you enter a nonexistent cylinder or head number, you will be prompted that the wrong head or cylinder has been entered and to press to SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg019 continue. allows you to go back and re- enter the correct numbers. After you press to enter the numbers for a bad cylinder, you will be prompted to answer with a 'Y' if the information is correct or an 'N' to cancel the entry. Entering either choice, Y or N, the entry prompt appears again. Continue to enter the data from the Hard Error Map until all the bad track numbers from the list have been entered. When you have finished entering the bad track numbers, press . The system will display a table of the bad tracks you have just entered. You will then be prompted if you wish to save the list. If this list is incorrect, enter 'N' to re-enter the list. If it is correct, enter 'Y' . A message will be displayed telling you to run 'FDISK AND FORMAT TO SPARE BAD TRACKS'. Enter to return to the Hard disk preparation Menu. 3.2 Installing MS-DOS If you are installing a Dedicated BOSS system, proceed to Section 3.3. If you are installing a PARTITIONED system, then proceed to Section 3.2.1. 3.2.1 Create MS-DOS Partition MS-DOS and BOSS provide separate programs to partition a hard disk. In order to implement a partitioned hard disk, both programs must be used. This section describes the procedure for creating a MS-DOS partition using MS-DOS FDISK and installing MS-DOS onto your system. Section 3.3 'Installing BOSS' describes the procedure for creating a BOSS partition and installing BOSS on your system. Before proceeding with this section, you should have initialized the hard disk and created the bad track list. A hard disk is divided into cylinders. The number of cylinders and the size of the cylinders can vary depending upon the hard disk. CAPACITY # CYL # HEADS 20MB 614 4 31MB 614 6 115MB 900 15 58MB 977 7 In order to create an MS-DOS partition with FDISK, you will have to specify its location (starting cylinder) and size (number of cylinders). MS-DOS sectors have 512 bytes; BOSS sectors have 256 bytes. Following are the steps required to create the MS-DOS partition: 1. Insert the MS-DOS diskette (1 of 2) into floppy SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg020 drive 'A' and boot the system. After entering the date and time, the system will respond with the MS-DOS prompt A>. 2. Enter 'fdisk' , the system will display the FDISK options. The default choice is 1. To select another option, enter the number and press . If you have more than one hard disk you will get a message displayed with the current disk. In addition, the option menu will contain a 5th option to select the next fixed disk drive. 3. Select Option 1, 'Create MS-DOS Partition'. The system will respond with the following question: Do you wish to use the entire fixed disk for MS-DOS? The default choice is 'Y'. To select 'N', enter the letter and press . The system displays the Create MS-DOS Partition screen with the following prompt: Enter Partition Size........: Enter the number and press . NOTE: a. Entering a at this point will partition the entire disk for MS-DOS leaving no room for BOSS. b. The MS-DOS partition should be allocated to 100 cylinders minimum in order to use PC-LINK. c. The maximum size for a single MS-DOS partition is 32MB. d. The maximum number of MS-DOS partitions on a disk is 3. 4. Enter the MS-DOS partition size (in cylinders) that you wish your MS-DOS partition to take, followed by a . You will next be prompted for the starting cylinder. To locate MS-DOS in the front position of the disk (Cylinder 0) enter '0', 5. The system displays a table with the partition information leaving the cursor positioned at the prompt at the bottom of the screen. The column headings are defined as follows: PARTITION - the number of the partition in the order in which it appears on the hard disk. STATUS - shows whether a partition is 'A' (for Active, i.e., in control when SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg021 the system is started from the hard disk) or 'N' (for Non-active). TYPE - shows whether the operating system that occupies the partition is MS-DOS or not MS-DOS. START - the starting cylinder number for the partition. END - the ending cylinder number for the partition. SIZE - the size of the partition in cylinders. NOTE: FDISK will not allow a partition to start in a cylinder where a bad track has been marked. If the cylinder you selected as your starting cylinder contains a reserved bad track, FDISK automatically starts the new partition in the next cylinder that does not contain bad tracks. 6. When you press , the system redisplays the FDISK options. It is possible to create another MS-DOS partition at this time. If you are partitioning two drives, enter Option 5, 'SELECT NEXT FIXED DISK DRIVE' and follow steps 3 - 5 to partition the second disk. After you are finished partitioning your disk drive(s), press . The system will display the A> prompt. Proceec to the next section. 3.2.2 Formatting and Copying MS-DOS to the Hard Disk This section details the procedure used to format the hard disk for MS-DOS and to copy the MS-DOS files to the disk. 1. At the MS-DOS prompt A>, enter 'format c: /s/v', . The system will display a warning message that the program will destroy all the data on the disk and prompt for a 'Y' to continue. 2. Enter 'Y' and the system will again display a warning message that the program will destroy all the data on the disk and prompt for a 'Y' to continue. Enter 'Y', . The system will respond with: Formatting... Verifying... System transferred 3. The last message says that a copy of MS-DOS has been placed on the disk. You are now prompted for a label to identify the disk. The label can be up to 11 characters long or a will equal no label. Enter the label and when complete. The system will next display information about disk space allocation in bytes, used by the system SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg022 and bytes available on the disk. 4. The system responds with the MS-DOS prompt A>. To copy all files from your MS-DOS diskette onto the hard disk enter 'copy*.* c:', . NOTE: For an alternate method of configuring your MS-DOS parition, see pages 3-13 and 3-14 in the BOSS Installation Guide (M5101A). 5. When the transfer is complete, remove the MS-DOS diskette from the floppy disk drive. 6. Insert the MS-DOS (2 of 2) diskette into the floppy disk drive and enter 'copy *.* c:', . 7. Remove the MS-DOS diskette from the floppy disk drive and set it aside. Your system now has MS- DOS in the MS-DOS partition of your hard disk. 3.3 Installing BOSS If your system already contains data, perform a back-up prior to attempting to install BOSS. 3.3.1 BOSS Disk Set-up This section details the procedure to specify the hard disk on the system and configure the hard disk directories that are necessary for the software to be loaded. This procedure is applicable to ALL systems and MUST be performed prior to loading BOSS. If your system has two hard disk drives, you need to know, prior to performing this procedure, which hard disk designation (H0 or H1) references a particular disk. In case of a single hard disk, the disk designation is always 'H0'. In the case of a dual hard disk system, the primary hard disk, which contains the operating system(s), is always 'H0' and the secondary hard disk is always 'H1'. 1. Remove the write-protect tab from the diskette labeled BOSS SYSTEM DISK. Insert this diskette in floppy drive 'A' (top drive in a two floppy drive system), known as drive 'F0' under BOSS, and boot the system. When the boot is complete, the system will display the BOSS Installation Menu. NOTE: Leaving the Write-protect tab on results in an ERROR 103. 2. From the Installation menu select Option 1, 'SELECT HARD DISK TYPES'. This option will allow you to set your drive types for BOSS. The system will display the drive types (these drive types are the same as under MS-DOS section 3.1.1). Enter the number for the type of drive installed as 'H0', . You will then be prompted for the drive number corresponding to the drive-type just specified. Enter 'H0', . If you have a two drive system, enter the number for the type of SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg023 drives installed as 'H0', and 'H1', at the appropriate drive number prompt. When the hard disk drive(s) for your system have been selected, enter (twice). The system will re- display the BOSS installation Menu. 3. From the BOSS Installation Menu, select Option 2, 'CONFIGURE DISK DIRECTORIES'. This option will allow you to setup the directories your system will have on it. The system will display the BUSINESS BASIC CONFIGURATOR Menu; this menu contains the steps to configure your BOSS system. At this time we will only be working with the disk directory section. 4. From the 'SELECT CONFIGURATION SOURCE' prompt, select option 2, 'FLOPPY DISK UNIT 0'. This prompt will not appear on the initial installation. 5. From the menu, select Option 2, 'DISK DIRECTORIES'. The system displays the DISK CONFIGURATION Screen along with a prompt to enter directory code to modify. Enter 'DO', ; the system will respond with a prompt for disk type ('H' for hard disk, 'F' for floppy). Enter 'H', ; the system will respond with a prompt to enter drive number. For a single hard disk system enter '0', ; for a dual drive system, enter the drive number of the primary hard disk followed by a . The system will respond with a prompt for directory name. Enter 'UTIL', ; the system will respond with a prompt for type of device buffering. Enter the option best suited for your areas needs. NOTE: Device buffering refers to the buffering (caching) of the entire hard disk. Read/Write Buffering (option W) is recommended for best performance. In areas subject to frequent power failures without battery backup facilities, performance can be traded for increased data integrity by selecting Read Only Buffering (R). If your system has a second hard disk drive, you may configure Directory D7 for that hard disk as follows: D7 Directory Code H for hard disk 1 for secondary hard disk drive number XXXX any valid four character Directory name * If your system has two floppy disk drives, you may configure the second floppy as follows: D8 Directory Code F for Floppy disk 1 for second floppy disk drive number XXXX any valid four character Directory name * SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg024 * Invalid directory names, include: UTIL, PROG, DATA, DOCU, DEMO, SURV. R for Read Only Buffering (removable disks MUST be configured for Read Only Buffering; otherwise a diskette may not be fully updated before it is removed). 6. When the directories have been configured, exit the menu by entering . The BUSINESS BASIC CONFIGURATION Menu will be re-displayed. To save the new configuration, enter , 'TO END JOB NORMALLY (SAVE NEW CONFIGURATION)'. The program writes the configuration to diskette and displays the BOSS Installation Menu. Select Option 3, 'RE- BOOT SYSTEM', and the system will respond with a message to re-boot. Boot the system from the BOSS SYSTEM Disk. 3.3.2 Create BOSS Partition This section details the *PARTDSK procedure used to create the BOSS partition on a partitioned disk. Just prior to arriving at this section, you should have booted BOSS from the diskette labeled BOSS System Disk. Use the following procedure to create the BOSS partition: 1. From the BOSS Installation Menu, select Option 4, 'PARTITION HARD DISKS'. If you have one hard disk proceed to step 3. 2. If you have two hard disks, the system responds with a question as to which disk to partition (H0 or H1). Select the designation of the disk to partition followed by . 3. The system will display the *PARTDSK screen. If you have selected a disk to partition and it also contains an MS-DOS partition the following message should be displayed on the screen: THERE IS CURRENTLY 1 DEFINED PARTITION ON THIS DISK This refers to the MS-DOS partition you created earlier. This partition information is displayed at the bottom of the screen. BOSS can recognize the boot code created by MS-DOS 3.1. If some other MS-DOS-like operating system was used, BOSS will indicate this condition with the following message: PARTITION SECTOR DOES NOT CONTAIN RECOGNIZABLE BOOT CODE. USE OPTION 'R' TO CLEAR PARTITION SECTOR; THEN USE 'FDISK' TO SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg025 CREATE PARTITION STRUCTURE. TYPE 'CR'. This message may also be the result of an incorrect procedure. Retry the Loading Procedure, and if the error recurs, contact the supplier of your system. 4. From the *PARTDSK screen, select option B, 'BUILD BOSS PARTITION'. The system displays the CREATE BOSS PARTITION screen and a prompt for the start cylinder. This is the starting location of the BOSS partition. To protect the integrity of the BOSS partition header area, Head 0 of the BOSS starting cylinder must not have a bad track. If you determine that a bad track interferes with the header area, then select another (higher) STARTING CYLINDER. Enter the BOSS starting cylinder, . NOTE: It is suggested that you locate BOSS directly after the MS-DOS partition. Depending upon the location of the MS-DOS partition, a will default to the lowest available cylinder number on the disk. The system will display a prompt for the ending cylinder for the BOSS partition. To use the rest of the disk for BOSS, you can specify the highest cylinder number on the disk by pressing , or enter the BOSS ending cylinder, . The system will responded with a message saying the partition is built and prompt for a to continue. After entering a , the system will display the *PARTDSK screen and the new partition information. 5. Now activate the BOSS partition, to specify BOSS as the operating system to boot from the hard disk. To activate the BOSS partition from the *PARTDSK menu select Option A, 'ACTIVATE PARTITION', and the system will respond with a prompt to enter the partition number to activate. This prompt refers to the partition numbers on the bottom right of the screen. To select the BOSS partition, enter its partition number and ; the system will highlight the BOSS line to indicate that it is active. To get back to the *PARTDSK menu, enter . If you have one hard disk drive or you have completed the partition procedure for your disk(s), proceed to step 7. If you have two hard disk drives and wish to partition the second disk, select the disk by entering Option N, 'NEXT DISK'. To partition the second disk return to step 2. NOTE: 1. If your system contains two hard disks, SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg026 activate only the first disk, 'H0'. 2. When partitioning the second hard disk do not forget to include the BOSS partition header restrictions when deciding the location of the partition. After you have built the BOSS partition on the second disk, DO NOT ACTIVATE IT. 6. When the hard disk(s) have been partitioned, exit the utility by pressing , and the system will respond with a message to re-boot the system. Boot the system from the BOSS diskette. NOTE: The *PARTDSK - ERASE PARTITION option is not used in this loading procedure, but it can be used to erase the BOSS or MS-DOS partition. This may be useful if you wish to reduce the size of the BOSS partition and install another operating system on the disk. However, if you use this option, you should first backup all BOSS data on your system. You will then have to reinstall BOSS from scratch. If only the BOSS partition is erased using this option, MS-DOS data will not be erased and MS-DOS will not have to be reinstalled. (Remember the 'R' option REMOVES ALL PARTITION INFORMATION, and erases all partitions and data on the disk). 3.3.3 Loading BOSS on the Hard Disk This section details procedures to accomplish a Surface Analysis on the hard disk, to initialize a directory on the hard disk, and to copy the BOSS BASIC Operating System to the hard disk. Warning: If this is the third installation of the BOSS Operating System on your system, you are prevented from completing the installation in this section. You will have to contact your MAI Basic Four dealer for information on installing BOSS a third time. NOTE: In this section, references to the hard disk refer only to the BOSS partition, and not the whole disk. It is necessary to have the bad track information for your hard disk(s) available prior to performing the following procedure. For two disk systems, follow the procedure to initialize the primary hard disk and then repeat the procedure for the secondary hard disk. The primary disk will contain the directory UTIL, and the secondary disk will contain the directory that you previously configured in step 5, section 3.3.1, 'BOSS Disk Set-up'. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg027 NOTE: If you attempt to install BOSS on a dedicated hard disk and an Error 103 occurs in the following procedure below, it indicates that partition data still exists on the hard disk or you did not reboot prior to proceeding with this section. The following steps outline the procedure to initialize and to copy BASIC to the hard disk: 1. From the BOSS Installation Menu select Option 5, 'INITIALIZE HARD DISKS'; the system will respond with a message warning that this program will destroy the data on the selected device and ask you if this is what you want to do. If you want to destroy all the data on the disk (BOSS partition only), enter 'Y', . 2. The system responds with a prompt for device name. If you have a single drive system, the response for the first disk drive will be 'H0, and 'H1', for the second disk drive. 3. The system responds with the prompt 'SHOULD BASIC BE INCLUDED'. If this is a primary disk, enter 'Y', . If this is the secondary disk, enter 'N', . NOTE: You should not include BASIC on the secondary disk. It should always reside on the primary disk. If you have two floppy devices configured, the system will respond with a prompt asking for the device to copy BASIC from, enter 'F0', . 4. If you are performing a second installation, the system will warn you that this is the last possible installation allowed. If you do not wish to continue press . If you wish to continue press . NOTE: If you are performing a third installation of BOSS on your software, the software prevents you from continuing and displays a message informing you of this. If a third installation is required, contact the supplier of your system or MAI Basic Four Software Distribution. Otherwise the system will respond with a prompt asking if bad track sparing should be included. If you do not want to implement Bad Track Sparing or perform a Surface Analysis, enter 'N', and proceed to step 8. To implement Bad Track Sparing or perform a Surface Analysis, press . NOTE: We Strongly recommend performing bad track track sparing and surface analysis on the initial installation. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg028 5. The system will prompt you for a head number. From the Bad Track List, enter the Head number of a bad cylinder, . The system next prompts for a cylinder number. From the Bad Track List enter the corresponding cylinder number for the bad track, . If the Cylinder is on the MS-DOS side of the partition the system will not accept it. Press to move the cursor back to the previous prompt. 6. Continue to enter the head and cylinder number for all bad tracks contained on the Bad Track List. When this information has been entered, press at the prompt for head. The system will respond with a prompt asking if the information is correct, enter 'Y', . 7. The system responds with a prompt asking if a test for bad tracks should be performed. This refers to the Surface Analysis procedure. If you do not want to test your hard disk for additional bad tracks enter 'N', and go to step 8. If you wish to perform this procedure, enter 'Y', . If no additional bad tracks are detected proceed to step 8. Otherwise, the system displays on the screen, in background intensity, any additional bad tracks detected and asks if you wish to add these bad tracks to the bad track table. If you do not want these bad tracks spared, enter 'N', and proceed to step 8. Otherwise record these additional bad tracks for your own information, and then enter 'Y' . The system will display a message that bad tracks are being added to the Bad Track Table. 8. The system responds with a prompt for directory name. For a single-disk system or the primary disk of a two disk system enter 'UTIL', . For secondary disks, enter the 4-character directory name you created in step 5, section 3.3.1, 'BOSS Disk Setup'. 9. The system will respond with a prompt asking for the number of files for the directory. For a single-disk system or the primary disk of a two disk system, enter '500', . For secondary disks, enter the number of files, . The system responds with the prompt for the directory name. At this point you may create other directories on the disk. (Alternatively, after BOSS has been installed, you may add additional directories by using the *4PSD Utility.) Directory names may be up to 4-characters long. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg029 When you are finished creating directories, press at the prompt for directory name. 10. The system responds with a prompt asking if the information is correct. Ensure the information is correct before answering this question. If it is not correct, enter 'N', and re-enter the information. If it is correct, enter 'Y', . The system will display a message that the directories are being initialized and that BOSS BASIC is being copied if it is included. When the initialization is complete, a prompt to continue will be displayed. At this prompt press . The BOSS Initialization Menu is displayed. Return to step 1 to initialize a second hard disk. Otherwise, this completes the Directory Initialization and Bad Track Sparing procedure. 3.3.4 Loading ULIB on the Hard Disk The following steps outline the procedures that are used to logically attach the second diskette, labeled BOSS Utilities (ULIB), to the floppy logical device and to copy the BOSS utilities from the floppy diskette onto the hard disk. 1. From the BOSS Installation Menu, select Option 6, 'LOG ULIB DISK ONTO SYSTEM'. The system will respond with the *UPSD - SWITCH FLOPPY DISKETTE screen. You will be prompted to enter to switch diskette. Press . 2. If your system has only one floppy disk drive configured, the screen automatically selects that unit. If your system has two floppy disk drives configured you will be prompted for unit number, enter for 'F0'. 3. The system now disables the floppy drive directory (Disc #9, F0 BOSS). It then displays a message to insert the diskette and enter to continue. 4. Remove the diskette labeled BOSS SYSTEM DISK from the floppy disk drive and insert the diskette labeled BOSS Utilities (ULIB) and the press . 5. The system automatically logs-on the diskette directory as ULIB and displays the information briefly. It then displays the BOSS Utilities Menu, after prompting for date and time. 6. Select Option 22 (*SPSD) from the BOSS Utilities Menu. At the 'FROM DISC#' prompt, enter '9' . At the 'T0 DISC #' prompt, enter '0', . This selects the directory on the primary hard disk. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg030 7. The system responds with a prompt asking for the type of files to transfer. Enter 'A' for all, . The system responds with a prompt asking what to do if a file is existing on the disk. Enter 'R' for replace, . The system responds with a prompt for the file names to transfer. Enter '@' to select all, . The system will display each file as it is being copied. 8. When the transfer is complete you will be prompted with a message that the transfer is complete along with a prompt to press to continue. Press twice. The system will respond with a READY. 9. Remove the diskette labeled BOSS Utilities (ULIB) from the floppy disk drive and insert the diskette labeled BOSS BASIC Operating System. Boot the system from the BOSS diskette. 3.4 Configuring the System This section provides information on the system configuration as shipped and how to modify the configuration for your system requirements. It contains information on implementing and configuring Serial Ports, Memory, Terminals, International Keyboards and International Printers. 3.4.1 System Configuration Review the information in this section. If you do not wish to change the system configuration , proceed to section 3.5, 'Finish Installation'. Otherwise, from the BOSS Installation Menu, select Option 7, 'CONFIGURE SYSTEM'. The system enters the *NPSD Utility. The system configuration is maintained and modified by using the *NPSD - BASIC CONFIGURATOR Utility. Documentation of this utility is provided in the BOSS Reference Manual in the chapter on utilities. The *NPSD Utility is capable of configuring your system on either a floppy or hard disk. When you enter the utility you will be prompted to select the disk drive from which to get the configuration source. Your choice will depend on whether your normal boot device is the hard disk or floppy. In a normal installation, the boot device is the hard disk. If this is true for your system, enter '1', . The configuration source will then be read from the selected disk and the BOSS Configuration Menu displayed. 1. On the 1-3 user system, BOSS is shipped configured for the monitor on port 0 with an auto start and to run "**" at load time. Ports 1 & 2 are setup for terminals at 9600 baud and no auto start. If you wish to change this, select Option 1, 'SERIAL PORTS'. 2. The BOSS is shipped configured for the following: 1 - PARALLEL PRINTER MODEL CODE . . . . . .4217 The options for this parameter are 4214, 4215, or 4217*. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg031 * 4217 covers 4218 also. 2 - MAXIMUM NUMBER OF GHOST TASKS. . . . . .1 The number of Ghost tasks allowed is 0 - 4. 3 - SIZE OF INTERNAL FILE DICTIONARY . . . .150 This can be from 13 - 255. 4 - DATE DELIMITER . . . . . . . . . . . . ./ This can be any character other than a space or comma. 5 - DATE FORMAT. . . . . . . . . . . . . . .M This can be (M=MDY, D=DMY, Y=YMD) 6 - EDIT DELIMITERS. . . . . . . . . . . . .[] This can be any character other than a space or a comma. 7 - RESIDENT COMPILER AND LISTER . . . . . .Y This can be yes or no. If you specify No the O.S. will load the lister and compiler as needed from the disk before listing or compiling programs. 8 - DEVICE BUFFERING SECTOR MULTIPLE . . . .2 This is the amount of sectors that are read into memory for each buffer read. This can be 1, 2 or 4 sectors. 9 - DEVICE BUFFERING SYNC INTERVAL . . . . . 10 This is the time in seconds between the end of one disk buffer write cycle to the beginning of the next. If you wish to change any of these parameters, select Option 4, 'SYSTEM OPTIONS'. On the 1-3 user system, BOSS comes configured with maximum of 4 tasks running in banks 1 and 2, with 45,498 bytes for program and data, 18,432 bytes for record buffering and 1,606 bytes for system tables. Select Option 5, 'MEMORY BANKS', if you wish to add more tasks or change the way the memory is configured. NOTE: Before saving a new MEMORY BANKS configuration, make sure that the following MINIMUM requirements have been met: PROGRAMS AND DATA = 20K per user in a bank RECORD BUFFERS = 8K per user in a bank Any extra memory in a user bank should be allocated to device buffers. When you have selected the desired system configuration, you must save the new information. From SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg032 the CONFIGURATION Menu enter a 'Y', . The system writes the information to disk and displays the BOSS INSTALLATION Menu. NOTE: The new configuration only takes effect when you boot from the normal boot device after completing Section 3.5, 'Finish Installation'. 3.4.2 Terminal Support The standard terminals supported on the 1500 are the 4310, 4312, and the EVDT. Each of these has a table of mnemonics assigned to it and can be modified as follows: 1. Enter *N at the UTILITIES MENU. 2. Configuration source is the Hard Disk. 3. Select Menu item 6, TERMINAL TABLES, from the CONFIGURATOR MENU. 4. Select menu item 1, MODIFY TERMINAL TABLES. 5. Enter 'M', 6. Enter the model number of the terminal you want to modify (e.g. B4 4310) From here on, you will be prompted with all mnemonics assigned to this model, given their old values and descriptions, and given an opportunity to modify them ( leaves the old value in place). As soon as you have viewed and/or modified the mnemonics table(s), enter END to exit to the "SAVE NEW TERMINAL TABLE (Y/N)?" prompt. 3.4.2.1 International Terminal Support BOSS supports the following International Keyboards: AMERICAN FRENCH ITALIAN SPANISH GERMAN ENGLISH DANISH NORWEGIAN SWEDISH/FINNISH The AMERICAN keyboard is the default keyboard. NOTE: This feature is for keyboards connected directly to the CONSOLE. International keyboard support for terminals connected to the RS-232 port(s) is supplied by the individual terminal manufacturers. In order to modify the CONSOLE to support an International Keyboard, follow the same procedure listed in Section 3.4.2 for modification of Terminal Tables with the following differences: 1) At the 'ENTER TERMINAL TABLE' prompt, enter CONSOLE. 2) At the ENTER TERMINAL NAME (20 CHARACTERS MAX):' prompt, enter . 3) Continue entering 's until you reach '19 ENTER MNEMONIC CODE MM:', or enter BACK18. 4) ENTER 'TI,' , and the system responds SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg033 with: ----- OLD VALUE --> $1B33001B360F 19.1 ENTER CODE TO BE TRANSMITTED TO TERMINAL: The desired International Keyboard is selected by appending the escape sequence 1B380n to the end of the existing character string. The existing character string plus the new sequence must all be keyed in. For the new value, enter: $1B33001B360F1B380n , where n is equal to one of the following: 0 = AMERICAN 1 = FRENCH 2 = ITALIAN 3 = SPANISH 4 = GERMAN 5 = ENGLISH 6 = SWEDISH/FINNISH 7 = DANISH 8 = NORWEGIAN 5) through prompts 19.2 through 19.5 until you return to 19, 'ENTER MNEMONIC CODE MM:'. 6) Enter 'END'. 7) At 'SAVE NEW TERMINAL TABLE (Y/N)?' enter 'Y'. 8) At 'CREATE OR MODIFY MORE TERMINAL TABLES (Y/N)?, enter 'N'. 9) At 'ENTER NUMBER OF CONFIGURATION TYPE:', enter 'Y' to save the configuration and then reboot the system. 3.4.3 Printer Support The standard printers supported on the 1500 are the 4214, 4215, 4217, and 4218 parallel; and 4213, 4214, 4215, 4217, and 4218 serial. To configure a parallel printer, select SYSTEM OPTIONS, option 4 under *NPSD. The first option on this screen is for PARALLEL PRINTER MODEL CODE. Enter the desired model followed by , and then save the configuration and reboot. To configure a serial printer, select SERIAL PORTS, option 1 under *NPSD. On the 3, 6, and 8 user systems a maximum of 2 serial printers can be configured. On the 9 - 10 user system a maximum of 3 serial printers can be configured. Choose the ports you want to configure for serial printers from the SERIAL PORTS menu and modify them for P1, P2, or P3 as required. Enter the MODEL #, baud rate, parity (ODD is standard), stop bits (1 is standard), and no auto-start for each printer being configured. 3.4.3.1 Modifying Mnemonic Tables SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg034 Each supported printer has a table of mnemonics assigned to it that can be accessed/modified by entering the *NPSD utility and selecting MNEMONIC TABLES, option 3. Due to a limitation in the program used to modify mnemonics, it is not possible to look at changed mnemonics using this utility and every changed code for a given printer must be reentered if ANY mnemonic is modified. The recommended way to verify the current contents of modified mnemonics is to use the *IPSD (HEX FILE DUMP) utility to read the configuration records from disk. The modified mnemonics configuration record can be found in File D0, Record Number 371. A sample of this screen is shown below. Mnemonic records start with the code MMC, followed by the Model Number. The mnemonics appear in three different formats depending on whether the code is to be ignored, is used to generate an error, or is used to generate a hex sequence. Codes to be ignored appear as follows: mm01 Where mm = mnemonic code Codes that generate ERROR 29 appear as follows: mmFF Where mm = mnemonic code Hex sequences are represented with the two character mnemonic, followed by a length byte, followed by the the hex sequence. They appear as follows: 6L031B32 This is the 6L mnemonic 3.4.3.2 Mnemonic Table Changes Each printer mnemonic table has been changed in some way in this release. Since it is so easy to lose the changed mnemonics, a complete list of the changes is shown below. If any of the tables get reset to their default values, you will need to reenter the mnemonics from these tables. 4213 4214 'SI' - ERROR 'NL' - $0A0D$ 'SO' - ERROR 4217/4218 'CF' - ERROR 'SB' - IGNORE 'EP' - $0E$ 'SF' - IGNORE SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg035 'LF' - $0A0D$ 'TI' - ERROR '8L' - $1B30$ 4215 4216 'NL' - $0A0D$ 'NL' - $0A0D$ 'SP' - $1B6A08$ 'VT' - ERROR 'SS' - $1B4A08$ '6L' - $1B1E09$ 'VT' - ERROR '8L' - $1B1E07$ '6L' - $1B1E09$ '10' - $1B1F0D$ '8L' - $1B1E07$ '12' - $1B1F0B$ '10' - $1B23101B1F0D$ '16' - $1B1F09$ '12' - $1B23111B1F0B$ '16' - $1B23251B1F09$ 3.4.3.3 International Printer Support (Parallel printers only) 6.3A comes complete with all printer mnemonics installed. The 4217/4218 and 4215 printers can print international character sets by sending a special hex sequence to the printer. The code is: $1B52hh$ where hh is replaced with the appropriate country code, shown in the table below. American 00 UK English 03 Italian 06 French 01 Danish 04 Spanish 07 German 02 Swedish 05 Norwegian 08 This code can be assigned to a mnemonic, then sent to the printer at the start of an application. The 4214 and 4213 printers use special proms to print international characters. None of these printers use mnemonics to print international characters. NOTE: Serial printers cannot support international character sets since there is no MBF/ISO translation to ASCII for serial ports. 3.5 Finish Installation From the BOSS Installation Menu select item 8, 'Finish the Installation'. The system should display the message 'Installation Complete'. Remove the floppy diskette and boot the system from the hard disk. 3.6 Upgrading When it is necessary to upgrade from 6.2A to 6.3A, a convenient procedure exists to accomplish this. The standard installation process requires the user to back up all data, initialize the disk(s), load the new software, then restore the data. The upgrade process for 6.3A eliminates the need to initialize the disk(s), therefore eliminating the SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg036 need to back up and restore. NOTE: 1. Even though it is not required, it is advisable to have a good back-up prior to an upgrade. 2. The upgrade procedure does not apply to Tape O/S, since Tape O/S should not be installed on the hard disk(s). 3. It will be necessary to have a complete list of all existing directories and their exact names available (see step 10). 1. Boot the system with the BOSS 6.3A SYSTEM DISK. 2. Select step 1, set disk types. Configure the system for the type(s) of hard disk(s) on your system. 3. Select step 2, configure disk directories. Select 1, Configuration Source from the hard disk. Select 2, Disk Directories and configure D0 for UTIL with Device Buffering = 'w'. Additional directories should be configured just as they are on your system now. Enter to exit. 4. Enter 'Y' to end job normally and save configuration. 5. Select step 3, reboot the system. 6. Press F4 to exit the installation menu. 7. Type RUN "*UPGRADE" 8. The program asks if you want to copy the system from F0 to H0. Type YES. 9. The program asks if you want to copy the configuration information. Type YES. 10. After *UPGRADE completes copying, it returns to the main utility menu. At this point additional directories should be added exactly as they appeared on your 6.2A system using *NPSD. 11. Select *UPSD, the switch floppy utility, and replace the BOSS 6.3A System Disk with the BOSS 6.3A ULIB Disk. 12. Run *SPSD and copy all the utilities from the floppy to the hard disk. 13. Exit from the main utility menu. DISABLE any directories that are configured with Read/Write caches to ensure that all buffers are written out. 14. Replace the ULIB diskette with the SYSTEM diskette and reboot the system. 15. Select step 8 to 'Finish the Installation.' 16. Remove the floppy diskette, and the reboot the system from the hard disk. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg037 4.0 MCS 1/4" TAPE SYSTEM The BOSS Tape System is designed to be run from the System Tape diskette. It should NOT to be installed on the hard disk. It is intended to be used as a back-up and restore utility and will not work with tapes from other MBF systems. Data transfer between other MBF systems and the MAI 1500 should be accomplished via ATP. The Tape System supports one system console "T0," one tape device "C0," one floppy diskette drive directory "D9," and one to two hard disk drives. The number of hard disk drives, their drive type(s), and any directories on the system are identified during the system setup procedures and only this custom configuration information is written to the Tape System diskette. 4.1 O/S Setup Procedures 1. Boot up from the BOSS Tape System O/S diskette. Enter the current date and time after the proprietary notice. NOTE: For the initial installation, the write protect tab needs to be removed from the diskette. If it is not removed, an ERROR 103 will result. 2. Select option 1, 'Configure Disk Types and/or Directories,' from the BOSS 6.3A Tape System menu. 3. Select step 1, 'Select the Hard Disk Types.' 4. Assign the hard disk types to 'H0' and 'H1' based on your current system configuration and enter to return to the main configuration menu. 5. Select step 2, 'Configure Disk Directories,' and the Business Basic Configurator menu displays asking for '...CONFIGURATION SOURCE:'. 6. Enter 2, Floppy Disk Unit 0. 7. Select option 2, 'Disk Directories,' from the Business BASIC Configurator menu. 8. Enter the EXACT current directory configuration of your system as it appears on the hard disk(s). 9. Enter when finished and then 'Y' to end the job normally and save your changes. 10. Select option 3, 'Re-boot System,' and then press CTRL-ALT-DEL after the message 'System must now be re-started.' 11. The Tape System Setup is now complete. 12. Select option 2, 'Run Tape Utilities,' and then select which tape function you want to run, from the following menu: 1. Backup 2. Restore 3. Verify Tape Readability 4. Erase Tape SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg038 5. Exit 13. Exit from this menu, remove the Tape System diskette, and re-boot from the hard disk, when finished. 5.0 SYSTEM HARDWARE To install or access boards in the CCA, remove the four screws at each corner on the back panel plus the one in the upper center; and the four screws, two on each side. Set the key to the unlocked position and slide the CCA forward to remove it. Each board is held in place by a screw located at the back of the CCA. To remove a board, remove this screw and any connected cabling and pull the board out. For installing a board, simply reverse this procedure. WARNING: The CCA cover should be removed by trained service personnel and only after all power is off. Power should not be applied while the cover is removed. 5.1 Hardware Configuration Range _ _ | | | | | | Memory | Minimum | Maximum | Comments | | | | | | | Memory | 640KB | 640KB | 640KB adequately | | | | | supports 10 users | | | | | | | Hard disk drive | 1 | 2 | Any mix | | | | | | | Hard disk capacity | 20MB | 230MB | Configurations include | | | | | 20,31,40,51,58,62,78,89, | | | | | 115,116,135,146,173 and | | | | | 230MB. | | | | | | | Floppy disk drive | 1 | 2* | 1st drive is 1.2MB, 2nd | | | | | drive may be 1.2MB or | | | | | 360KB | | | | | | | Floppy disk capacity | 1.2MB | 2.4MB* | | | | | | | | Disk controller | 1 | 1 | Supports 2 hard disks | | | | | & 2 floppy dr * | | | | | | | Monitor | 1 | 1 | Monochrome or color. Can | | | | | run MS-DOS and Business | | | | | BASIC | | | | | | | Keyboard | 1 | 1 | U.S. (Keycap sets are | | | | | available for inter- | | | | | national languages) | | | | | | | Serial Ports | 1 | 9 | | | port controller | | | | | | | | | | Parrallel Ports | 1 | 2 | BOSS Software supports | | | | | only 1 par. printer | | | | | | | Number of Serial prntr| 0 | 2 | Max. is 3 on 9-10 | SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg039 | | | | user BOSS, 2 on every | | | | | other BOSS system. | | | | | | | Display Terminals | 0 | 9 | Can run Business BASIC | | | | | applications only | | | | | | | | | | | | Number of users | 1 | 10 | | | | | | | * Second floppy is not available if system is equipped with two full-height hard disk drives (i.e., any two of the following: 20MB (40ms); 31MB (55ms); 58MB (28ms); or 115MB (28ms)). 5.2 Hardware Set-up 5.2.1 Graphics Display Adapter Board (GDA) The GDA board is shipped from the factory in card slot 1 with the switches set for a color monitor. The following are the switch options for the GDA board: Operational Switch Settings Monitor Type Mode 1 2 3 4 5 Monochrome Monochrome or ON OFF ON OFF N/A mono-Hercules * Monochrome Emulation OFF OFF ON OFF N/A ** Color Color/Graphics OFF ON ON OFF N/A Color Color/Graphics OFF ON OFF OFF N/A Enhanced Monochrome/ Monochrome/ ON OFF ON OFF OFF Composite Composite Color/ Color/Graphics OFF ON OFF ON ON Composite Composite * These are the switch settings for the Monochrome monitor ** These are the switch settings for the Color monitor The slide switch on the main PCBA labeled 'COLOR/MONO' near the disk controller connector should be set to the 'COLOR' position for both of the standard switch settings (* and **) shown above. 5.2.2 Serial/Parallel Port Controller One Serial/Parallel Port Controller is shipped in the CCA in slot 7. The jumper block at location 2E is configured for COM1 (the first port) as standard (the open connections on the block are away from the cable connector side of the board). To set the board for COM2, remove the jumper block at 2E and turn it 180 degrees so that the open connections on the block are toward the cable connector side of the board. The jumper block at 2D is configured for LPT1 as SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg040 standard (the open connections on the block away from the cable connector side of the board). The BOSS will only support one parallel printer, but if two Serial/Parallel Port Controllers are installed, the second one (COM2) must be addressed for LPT2 even though this port will not be used by BOSS (it can be used by MS-DOS). This is done by removing the jumper block installed at 2D, turning it 180 degrees, and installing it so that the open connections on the block are toward the cable connector side of the board. NOTE: The Serial/Parallel Port Controller(s) can be located in any open board slot. 5.2.3 Disk Controller Board The Disk Controller is shipped in the CCA in slot 8. It comes complete with all the cables necessary to connect 2 hard disk drives and 2 floppy disk drives, although only three devices may be installed at any one time due to power restrictions. Each cable is stamped with a letter corresponding to the drive associated with it (A=F0, B=F1, C=H0, D=H1). The floppy drives have one daisy chain cable for both drives. The hard disk drives have one radial or control cable for each drive and one daisy chain cable for data. The jumpers on the Disk Controller need not be reconfigured when adding or removing disk drives. The standard jumper configuration is shown below. E2 to E3 E5 to E6 E7 to E8 5.2.4 Main CPU Board The Main CPU Board (known as the Mother Board) is located in the bottom of the CCA and contains the board slots, 640KB of memory, the CPU circuitry, and the MONO/COLOR switch. There are no switches for setting memory addressing. The MONO/COLOR switch is explained in Section 5.2.1 about the GDA Board. 5.2.5 Multi-port Board The Multi-port Board comes complete with a communications controller PCBA, a remote panel port connector box, and a ribbon cable. The communications controller can be optionally configured as a 4-way, 6-way, or 8-way. The proper configuration is determined by a PAL, the number of UARTS installed, and the settings of SW2. The 4, 6, or 8 ports allowed in the hardware need to have corresponding 4-6, 7-8, or 9-10 user O/S versions in order to use them. The board has two DIP switches; SW1 is for interrupt and and addressing, SW2 controls the number of users. Settings for SW1 - 1 2 3 4 5 6 7 8 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg041 All configurations OFF ON OFF OFF OFF OFF ON ON Settings for SW2 - 1 2 3 4 4-way ON ON ON ON 6-way OFF OFF ON ON 8-way OFF OFF OFF OFF One remote panel is used for all configurations. This box has one connector labeled J1 which connects the box to the Multi-port board in the 1500 via the ribbon cable. There are eight, DB25 port connections, labeled P1 through P8, to be used for connecting terminals. Port P1 is configured as DTE (Data Terminal Equipment) with handshake lines for modems, terminals, or printers. This line can be connected directly to a modem, or through an adapter that switches pins 2 and 3 to connect DCE (Data Communications Equipment) such as terminals and printers that do not require handshaking. Ports P2 through P8 are DCE ports. Remote Panel Pin Outs Signal DTE DCE Name Port 1 Ports 2 - 7 CTS 5 DSR 6 DCD 8 DTR 20 RTS 4 Transmit Data 2 3 Receive Data 3 2 Signal Ground 1,7 1,7 The Multi-port Controller Board should be installed in place of the second Parallel/Serial Port Board. The Port Board remaining in the 1500 should be set to COM1 and LPT1 (see Section 5.2.2). The following chart shows how the OS port configurations relate to the Hardware ports (P1-P8 on the remote panel): OS Terminal Hardware Ports (Tasks) Ports 0 T0 Console 1 T1 COM1 2 T2 P1 (remote panel) 3 T3 P2 (remote panel) 4 T4 P3 (remote panel) 5 T5 P4 (remote panel) 6 T6 P5 (remote panel) 7 T7 P6 (remote panel) 8 T8 P7 (remote panel) 9 T9 P8 (remote panel) * Pins 2 and 3 reversed SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg042 NOTE: 1) The Multi-port Board cannot be used by MS-DOS. 2) A re-boot using does not reset the Multi-port board. Power the 1500 off then back on to reset. 5.2.6 MCS 1/4" Tape Controller Board The MCS 1/4" tape system consists of the model 4403 tape drive, a MCS Tape Controller Board, and an I/O cable. The MCS Tape Controller has one configuration switch SW1 and three jumpers. They are configured as follows: SW1 1 - 8 ON and 9 - 10 OFF JUMPERS: DA (in position 1) IRQSL (in position 7) DR (in position 1) NOTE: 1) A drawing of the I/O cable appears in Section 5.3 2) The O/S for the tape system is not to be installed on the hard disk 5.2.7 Miscellaneous Hardware and Switch Settings 1. The front panel contains a key lock switch. If the switch is in the locked position, the CCA cover cannot be removed and the keyboard is disabled. Two keys come with each system. It is recommended that one key be left in the lock or near the system and the other be secured. 2. There is also a button on the front panel above the picture of a lightning bolt and a green LED. The LED is lit when the system is operating at 8 MHZ, and it is off when operating at 6 MHZ. This button can be disabled by the system setup procedure (see Section 3.1 step 5). 3. The green LED above the picture of a light bulb is the system power on indicator. 4. The green LED above the picture of a drum is lit whenever there is a hard disk access. 5. The back panel of the CCA contains the ON/OFF, circuit breaker switch, a 115/220 volts select switch, a power receptacle for the console monitor, a receptacle for the main A/C power cord, and two different types of jacks for keyboards. 5.3 Cabling The following pages show diagrams of the standard cables and a system interwiring diagram: SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg043 907970 Serial Device to Serial/Parallel Port Board 907976 Modem to Serial/Parallel Port Board 907933 Parallel Printer to Port Board 906694 Multi-port REmote Panel to Serial Device (Ports 2-7) 916031 MCS 1/4" Tape Drive to System ------ System Interwiring Drawing CABLE DRAWINGS Serial Device to Serial/Parallel Board Market Code - UV00XAA P/N - 907970 Modem to Serial/Parallel Board Market Code - UV004AA P/N 907976 CABLE DRAWINGS Parallel Printer to System Unit Market Code - UT001AA P/N - 907933 Multi-port Remote Panel (P2 -P7) to Serial Device Market Code - UC008AA to 023AA P/N - 906694 CABLE DRAWINGS MCS 1/4" Tape Drive to System Market Code - P/N - 916031-001 6.0 FOR YOUR INFORMATION SPR # Description Work-around SYSTEM CRASHES 507182 ERROR 31 can crash the system. e.g. None 100 CALL "CRASH" 507181 RELEASE can cause a system crash if Avoid the task is CALLing or EXITing a program. 507308 Data overrun may occur on the Multi-port None board. 507311 *MPSD can crash the system if modified to Avoid loop on itself. 508833 BACKUP/RESTORE to floppy does not work Turn off caching. reliably. 503610 System hangs in multi-user mode in low Switch to high speed, accessing the same files speed MISCELLANEOUS MALFUNCTIONS 507175 LOAD does not work if an enabled directory Do not name them has the same name as a program. the same. 507180 The three-key reboot does Power the system SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg044 not reset the Multi-port board. off and then back on to reset. 507183 The TCB values are changed before entering a Assign the TCB CALLed program and cannot be passed as a value to a parameter. variable and pass the variable. 507312 MOD function returns a negative number None instead of 0 if the first number is > eleven digits. Also if the first number is negative. 507374 The following program should print two lines Add another but only print the first: PRINT(2) command. 10 BEGIN It would be added 20 OPEN(2)"LP" as line 75 in the 30 PRINT(2) CHR(24) example. 40 FOR I=33TO126 50 PRINT(2) CHR(I) 60 IF MOD(I-32,50)=0 THEN PRINT(2) 70 NEXT I 80 END 507378 CALL/EXIT sometimes leaves the CALLed (none known) program in memory. SPR # Description Work-around MISCELLANEOUS MALFUNCTIONS (CONT) 508277 There is no MONITOR test available. Use MS-DOS "TESTAT" 507394 If the system is booted without a floppy in Read the file the drive, the first disk access after an twice, ignoring ENABLE command cannot find files on the the first ERROR disk. 12. 507377 If a file is OPENed by several tasks, 2 (none known) WRITEs to the same record in rapid succession may lose data from the second WRITE. 509612 The LF mnemonic is missing the CR (hex 'OD') Add CR ('OD') in the 4213, 4214, 4215 and 4216 printer to each of the tables. printer's LF mnemonics. UTILITY PROBLEMS 508086 *1PSD requires the boot floppy to be in Put boot floppy the drive to install a 2nd hard disk. in drive. 507176 *4PSD - the maximum number of files is None 9999 not 32000, as the message says. 507439 *DPSD reports the wrong disk number when After the ERROR renaming a file to a name that already 41, exit the exists causing an ERROR 41 at the new name utility, re- query. enter it, and use a different SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg045 name. 507440 *LPSD does not reset variables correctly. Exit and re- e.g. If files are listed by location using enter the a FROM other than 0, the utility is then utility. limited to the new value as a lower limit. 507443 *LPSD generates an ERROR 2 with the following Exit and re- sequence: List files by name starting with T, enter the list files by location for all locations. utility. 508255 *NPSD - Internal File Directory Size message None is misleading. It says "THE MAXIMUM REQUIRED DICTIONARY SIZE..." It should say, "THE OPTIMUM DICTIONARY SIZE IS...." 508213 *OPSD cannot handle file parameters for the Use data areas data area of around 8,000,000 or greater. of < 7,500,000. 508204 *OPSD accepts a decimal number for the Avoid using record size when defining index files. decimal numbers. SPR # Description Work-around 507379 *PPSD does not change line numbers in (none known) the PGM function. 507178 *QPSD displays line numbers before the (none known) START LINE. 508220 *QPSD unable to search for a string Do not do string value of ' x' where x is the first letter searches with a of the line preceeded by a space. This leading space. causes ERROR 47. 508218 *QPSD - If is entered at, "HARD COPY Respond with Y (Y/N) ?" , it causes a program hang. or N but not . 507380 If *QPSD is used to change a line and Use verify. an ERROR occurs, then the change is not made. No warning is given unless the verify option or hard copy is selected. 7.0 HELPFUL HINTS 7.1 Loading the Printer VFU In spite of documentation to the contrary, the SL (Start Load) and EL (End Load) mnemonics do not work. However, there is a workaround that can be used with 4213 and 4214 printers. Using the load codes in the table below you can create a VFU string and send it to the printer. Once the VFU is loaded the Sx and VT mnemonics can be used. The hex codes are: $1E$ Start VFU load $10$ Form Feed $1F$ End VFU load $11$ Channel 2 $12$ Channel 3 $1D$ Fill Character $13$ Channel 4 $14$ Channel 5 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg046 $16$ Channel 7 $17$ Channel 8 $0B$ Vertical Tab The step by step process is: 1. Modify the mnemonic table with the following codes: S2--> $11$, S3--> $12$, S4--> $13$, S5--> $14$, S7--> $16$, S8--> $17$, VT--> $OB$ (Re-boot the system to load the new codes). 2. Define the VFU string. For example: A$=$101D1D111D1D121D1D1D131D1D1D1DOB1D1D1D1D$ This string sets the form length to 29 lines, channel 2 at ine 4, channel 3 at line 7, channel 4 at line 11 and a vertical tab at line 16. 3. Send the Start Load code, followed by the VFU string, followed by the End Load code: OPEN(1)"LP" PRINT(1) $1E$,A$,$1F$ An alternate approach is to define a special mnemonic that performs the above sequence and sends it to the printer as part of a system start-up routine. For example, the TI mnemonic could be modified to: $1E101D1D111D1D121D1D1D131D1D1D1DOB1D1D1D1D1F$ Note that unlike terminals, TI is NOT sent to the printers by the OS as part of the boot process. 7.2 Setting Form's Length The following is the procedure to set the forms length in # of lines on the Parallel PT-4217/18 on the 1500: Forms length through BOSS (BBPC): PRINT (1)'BO',$1B43xx$, 'EO' xx = The hex of the decimal from 01 to 255. Example: of 20 lines per page: The hex of DEC 20 is 14 so, xx should be $14$. Forms length from GWBASIC: lprint chr$(27) "C" chr$(n) n =# of lines from 1 to 255 7.3 DISK COMPRESSOR OPERATING PROCEDURE * NOTE - The Disk Compressor will only run if: o it is loaded from a diskette SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg047 o it is initiated from T-0 o a printer is on line o no one else is accessing the system To load the Disk Compressor the following steps should be followed: 1. Boot the BOSS diskette. 2. Enter the correct date/time. 3. At the UTILITY Menu, enter "24" or "*U". 4. At the *UPSD Menu, enter "C/R" to default to diskette 0. 5. Enter "C/R" to default to "F0". 6. Insert Disk Compressor diskette into disk unit F9, the upper (or only) disk drive in the system. Shut disk drive door. 7. The directory for the drive unit should now change to "*DPP". 8. Wait for screen to change back to UTILITY Menu, then enter "C/R". 9. At the "READY >" prompt enter "DISABLE 0". * NOTE - If unit H0 is still enabled when RUN "DSKCPR" is entered, the screen wll print a copyright infringement error message. 10. Insure that F9 is enabled. 11. Enter RUN"DSKCPR" (System loads DSKCPR and copyright screen appears) 12. Enter "C/R" (DSKCPR will go to the second screen and ask "Are you sureyou want to continue Y/N ?") 13. Enter a "Y" (DSKCPR will ask "Are the date and time correct Y/N ?") 14. Enter a "Y" (DSKCPR asks for your printer choice of either P1 or LP) 15. Enter "LP" 16. The DSKCPR utility will print a "Phase 1 - Verify Environment" message on the printer, and ask for you to "Select disk to analyze H60 or H31:" * NOTE - H60 = Hard disk unit 0 H61 = Hard disk unit 1 H30 = Floppy unit 9 SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg048 H31 = Floppy unit 1 17. After entering your selection, test will automatically initiate. Any errors encountered are printed and explained on the LP. 8.0 DOCUMENTATION The following manuals are currently available for the MAI 1500 and can be ordered: M5101A - BOSS Installation Manual M6260A - BOSS Reference Manual M6234A - MAI 1500 User Guide M8105 - MAI 1500 Service Manual M8109 - MAI 1500 Hardware Installation Guide The following Marketing Announcements cover pertinent products in this release. 443 U.S. MAI 1500 Expands Capabilities - Domestic 297 Int'l MAI 1500 Expands Capabilities - International DRAWING INFORMATION: See WPS Software Bulletin #147 for illustrations. ORIGINATOR: T. SEARS SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB008 Pg049 FIB 00009 05/04/87 *** Business BASIC/PC Release 1.3 Software Announcement *** MAI Business BASIC/PC level 1.3 is now available for distribution. Orders for Business BASIC/PC are made through the normal sales order procedures. It is also available from the Supply Distribution Center. TABLE OF CONTENTS 1.0 Overview 2.0 Features and Limitations 3.0 Hardware and Software Requirements 4.0 Installation Information 5.0 PC-LINK and Business BASIC/PC 6.0 Problems and Workarounds 7.0 Utilities 8.0 Warnings and Cautions Business BASIC/PC is a complete business BASIC system designed to operate on the DS-500 series workstation under the MS-DOS operating system. Business BASIC/PC is significantly compatible with Business BASIC Level 3, but there are differences. Several of the differences are due to the DS-500 Series Workstation being a single user machine. Additional differences will be noticed by long-time Business BASIC programmers, but are easy to accommodate. 2.0 Features and Limitations 2.1 Features o Built-in Compiler/Lister for system efficiency o Supports String, Indexed, Serial, BASIC Program, Direct and Sort files o Powerful I/O directives o Printer and screen mnemonics o Full MS-DOS pathname control is supported. Also included are CHDIR, MKDIR, RMDIR and SETDRIVE directives o Public programming is supported o Four Utilities included 2.2 Limitations o Multi-tasking and multiple users not supported on the DS-500 series workstation o Ghost tasks are not supported o Print spooling is not supported 3.0 Hardware and Software Requirements Business BASIC/PC operates on an MAI DS-500 Series Workstation. The minimum requirements are as follows: o DS-500 Series with at least one floppy disk drive SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg001 o MS-DOS level 2.1 or above o 256K RAM 4.0 Installation Information Business BASIC/PC will run on a DS-500 dual floppy, a DS-510 10MB hard disk or a DS-520 20MB hard disk workstation. 4.1 Dual floppy installation No installation is required when using a DS-500 dual floppy workstation. The master diskette contains the Business BASIC/PC program file and all associated utility files. The system must be booted by placing an MS-DOS system diskette in the A: drive. Once the system is booted, the MS-DOS diskette must be replaced by the Business BASIC/PC master diskette. When the A> prompt is displayed, type BBPC to initiate the Business BASIC/PC program. When using the dual floppy machine a second formatted diskette may be used in drive B: for all data and program modules. 4.2 Installation on a DS-510 or DS-520 When working with a hard disk, the user should use the DOS "CD" command to enter the appropriate directory. Once in the desired directory, Type "A:" and press the or key. With the Business BASIC/PC master diskette in drive A:, type "copy *.*" and press . This will copy all Business BASIC/PC files to the C: directory. The Business BASIC/PC program and utilities are now ready to run from the hard disk. Type BBPC to initiate the program run. NOTE: The Business BASIC master diskette MUST be placed in drive A: when initially loading the Business BASIC/PC program. The master diskette is checked to see if a valid copy of Business BASIC/PC is being executed. 5.0 PC-LINK and Business BASIC/PC Using the MAI PC-LINK software package, program and data files can be easily transported between the DS-500 series workstation and the 13xx (210-710), MAI 2000 and MPx Series Systems. Business BASIC/PC application programs written on the DS-500 will require little if any modification when transported to the larger MAI system. Applications written on other MAI Basic Four systems and transported to the DS-500 will require modifications depending on the type of application. EXAMPLE for 2000 to DS-500 program file transfer via PC-LINK: 1. Create a SERIAL file to store the file to be transferred 2. While in BASIC mode, load the appropriate program file 3. OPEN a channel to the created SERIAL file 4. LOCK the channel 5. LIST to the channel 6. CLOSE the channel 7. Refer to PC-LINK manual for standard transfer procedures Note: After receiving the serialized BASIC file from the host, the first line of the file contains a line of text that must be deleted because MAI PC-Link receives the program type as the first line. Load the newly received file into a text editor and delete the first line from the file. SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg002 8. After the program is on the DS-500, enter the Business BASIC/PC BASIC mode and merge the received program Example: "STUFF" is the created serial file and "ATP" is the host program file to transfer ** Procedure to follow on host machine ** >START 128 >LOAD"ATP" >OPEN(1)"STUFF" >LOCK(1) >LIST(1) >CLOSE(1) ** Procedure to follow on DS-500 with BB/PC ** >OPEN(1) "STUFF" >MERGE(1) >SAVE"STUFF2",2000 EXAMPLE for DS-500 to 2000 program file transfer via PC-LINK: 1. Create a SERIAL file to store the file to be transferred 2. While in BASIC mode, load the appropriate program file 3. OPEN a channel to the created SERIAL file 4. LOCK the channel 5. LIST to the channel 6. CLOSE the channel 7. Refer to PC-LINK manual for standard transfer procedures 8. After the program is on the 2000, enter 2000 BASIC mode and merge the received program Example: "DSERIAL" is the created serial file and "DSPROG" the DS-500 program file to transfer ** Procedure to follow on host machine ** >START 128 >LOAD"DSPROG" >OPEN(1)"DSERIAL" >LOCK(1) >LIST(1) >CLOSE(1) ** Procedure to follow on DS-500 with BB/PC ** >OPEN(1) "DSERIAL" >MERGE(1) >CLOSE(1) >SAVE"PROG2",2000 6.0 Problems and Workarounds Problem: EXTRACT and EXTRACT RECORD fail to lock records from being accessed on other channels. An error 0 should be generated SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg003 attempting to read or write to the extracted record from another channel. Workaround: None. Problem: EXTRACT and EXTRACT RECORD on a string file performs a file read and increments the record pointer. Workaround: None. Problem: Business BASIC/PC allows a file opened on multiple channels to be locked on each of the channels if each of the filenames supplied to the various OPENs use different pathnames. EX: "/usr/SQA/file" , "SQA/file" and "file" Workaround: Refrain from using multiple pathnames. Problem: The system hangs while attempting to print beyond the 24th line on the screen. Workaround: None. Problem: The result of assigning or printing a numeric variable or constant N, where 1 > N >= .5, while precision is set to 0 results in N being 0 instead of 1. Workaround: None. Problem: Cannot perform a READ RECORD directive on a file OPENed with ISZ= option. An error 13 is generated. Workaround: Perform READs instead of READ RECORDs where possible. Problem: The MOD function produces incorrect results if the second parameter specified (the divisor) is negative. Workaround: None SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg004 Problem: Incompatability of DIRECT file record index assignments between Business BASIC/PC, BOSS/IX and BOSS/VS. Workaround: None. Problem: If the "&files" utility is CALLed, the current workspace is wiped out and replaced with the "&files" source code. This is due to the allowance of START in a CALLed program. Workaround: None Problem: The "&files" utility sets the keyboard to UPPER CASE mode. Upon return from "&files" the user has no control over changing the mode. Caps lock has no effect. Workaround: PRINT 'LC' can be used to switch back to normal mode. Problem: There is a problem with the "&x" utility when sending a cross reference listing to a file. The file containing the cross reference is not a standard ASCII file and cannot be cleanly displayed on a printer (A PT-4218 was used for the test). Workaround: The file can be printed from Business BASIC/PC by OPENing a channel to the printer, READing records from the file until the end of file is reached and PRINTing to the channel each record. There is some extraneous data due to faulty print mnemonics contained in the file. 7.0 Utilities Several utility programs are included in the MAI Business BASIC/PC package as programmer aids. These utilites are: Title Name Renumber program &P Cross-referenced program listing &X Display file information &FILES Define/Redefine file &DEF These programs are run directly from console mode as described in the MAI Business BASIC/PC user manual. 8.0 Warning and Cautions SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg005 o Upon return from the "&def" utility, the user is confronted with an "Insert disk in drive A:" message. When ENTER is pressed an "Insert disk in drive B:" appears. After ENTER is again pressed, some garble appears on the screen and the Business BASIC/PC prompt appears. o Error 2 is generated when attempting to READ a record from a string file that has been written with a WRITE RECORD. An error 1 should be generated. o Error 0 is generated when attempting to LOCK a file that has already been locked. An error 14 should be generated. o Error 14 is generated when attempting to LOCK a file that has been opened on a different channel. An error 0 should be generated. o Error 2 is generated when attempting to execute a MERGE directive on DIRECT, SORT, and PROGRAM files. An error 17 should be generated. o Error 0 is generated using the MKDIR directive when attempting to create a directory that already exists. An error 12 should be generated. ORIGINATOR: MBF SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB009 Pg006 FIB 00010 10/30/87 *** 6.3B O.S. available for MAI 1500 *** The BOSS 6.3B operating system is now available for the MAI 1500. This release supports the following new functionality: o Increased Number of Hard Disk Installations To better accomodate situations where BOSS must be re-installed onto the hard disk (e.g., the disk has been reformatted, replaced, etc.), BOSS can now be installed onto the hard disk up to five times before MBF needs to be contacted for additional installation capability. Previously, only two installs were possible before MBF had to be contacted. When a Service representative contacts MBF for additional installation capability (i.e., more than five installs onto the hard disk are required), MBF can authorize by telephone which allows up to three additional installations. Previously, only one additional installation could be performed with the extension. o Disk Compressor Operation No Longer Limited The disk compressor utility can now be run an unlimited number of times, regardless of whether the BOSS operating system has been re-installed on the hard disk. Previously, once the disk compressor was run, it could not be run again if BOSS were re-installed on the hard disk. All other functionality is identical to 6.3A. For information pertaining to the 6.3B O.S. release, please refer to tje 6.3A Software Announcement #147. ORIGINATOR: Dan Wenzel SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB010 Pg001 FIB 00011 10/25/88 *** Announcing the Release of Business Basic/PC 1.5 [ WPSF 493 ] *** MAI Business BASIC/PC level 1.5 is now available for distribution. The installation and operating instructions are included with the software in manual M6261A Business BASIC/PC Reference Manual. BBPC 1.5 has the same functionality as BBPC 1.3 with the following additions and modifications: BB/PC Level 1.5 Added Features 1. A new system function: INFO(n,n) has been added. The INFO function currently accepts two integer arguments. These arguments determine the string returned. Currently defined values are: arg1 arg2 description 0 system information 0 Operating System name (best guess) 1 OS version number 1 hardware information 0 processor ID 2 BB/PC information 2. The display drivers have been greatly enhanced for the PC. The biggest change is that the PCCON.DRV uses the DMA screen. 3. New verb: ON .. GOSUB nnnn,nnnn,nnnn (nnnn = statement #) This works similarly to the ON ... GOTO except that control returns to the statement following the ON ... GOSUB when a RETURN is encountered. 4. Additional I/O item: (ALL) Array (ALL) arguments are now supported in I/O item lists. This will accept/produce the array in a row major form. Format: PRINT (1)A$,A(ALL) If the array A is DIMed to 10, BB/PC will output the values A(0)..A(9) 5. 5 digit line numbers BB/PC now supports a line number range of 1..65534. The line number 65535 (x'FFFF') is reserved for the system 'end' statement. Programs having the old ending line number are automatically modified upon load. Note the program is not modified on the disk, only in memory. A SAVE is necessary for permanent modification. 6. Error branch handling is somewhat different. The rules are now as follows: IF SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB011 Pg001 the error happened in the file system (I/O errors..) AND there is currently an 'ERR=' active, that branch is taken ELSE the code following the error point is scanned until the end of the statement is reached, for an 'ERR='. If no 'ERR=' is found, the active 'ERR=' will be taken (if any). 7. The string format mask handler will now simply copy any character that it doesn't recognize into the output 8. DOS System calls are now permitted. The format in console mode is: !. In a program the format is: = SCALL( string ) Where is any string constant or variable containing a valid DOS command. Upon returning to BB/PC, the return code of the DOS function will be placed in the . Note: Many DOS commands do not set return codes. In most cases, the numeric variable will be zero when the function is complete. In these cases, there is no way to confirm whether the function completed normally or not. The ! (console) directive will re-set the cursor position to the currently active position on the screen. The SCALL(..) function does not do this. If you want to make sure the cursor on the screen is where you (and BB/PC) think it is you must reset the cursor to that position when the function returns to BB/PC. MS-DOS does not know that the screen may be protected or that a scrolling region may be set. If you perform an SCALL or '!' function without re-directing the output, the current screen will be overwritten. The current screen could be saved and restored using the 'SS', 'SR', and 'RS' mnemonics. 9. Scrolling regions support added. Scrolling regions on the screen can be set up with the 'DS' mnemonic. This mnemonic requires a 4 byte hexadecimal code immediately following to describe the boundaries of the scrolling region. The information required is: Byte Contents 1. Starting column number (0 based) 2. Starting row number (0 based) 3. Number of columns 4. Number of rows To set a scrolling region on the screen that will include only the first 23 lines on a PC screen and leave the last two alone, the command is: PRINT 'DS',CHR(0)+CHR(0)+CHR(80)+CHR(23), SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB011 Pg002 or, equivalently PRINT 'DS',$00005017$ Screen and line oriented mnemonics, such as 'CS', 'CF', 'CL', will function only within the confines of the active scrolling region. In the above example, if the active scrolling region is the upper 23 lines of the screen, a 'CS' will only clear those lines, leaving whatever had been previously printed on the lower 2 lines alone. A scrolling region is similar to a window. 10. Color support added. The 'SA', set attribute, mnemonic has been added to allow changing of screen colors. This mnemonic requires a 2 byte hexadecimal code immediately following. The first byte is a function code and the second is the color code. The values for these codes are as follows: Function Code Value (Hex) Function 00 Set Screen Border Color (does not work on some systems, including EGA monitors). 01 Set Character Color 02 Set Character Field Color 04 Set Screen Color Color Code Value (Hex) Color Value (Hex) Color 00 Black 08 Grey 01 Blue 09 Light Blue 02 Green 0A Light Green 03 Cyan 0B Light Cyan 04 Red 0C Light Red 05 Magenta 0D Light Magenta 06 Brown 0E Yellow 07 Dark Grey 0F White NOTES on colors o Colors 08 thru 0F are only valid with the Set Border Color function code, 00h. The character color, function byte=01, is modified by the 'SB' and 'SF' mnemonics. Characters printed while 'SB' is in effect are dark, while those printed while the 'SF' is in effect are light. The statement to set the border to red, the characters to grey/white on a green field, and the screen color to blue is: PRINT 'SA',CHR(0)+CHR(4),'SA',CHR(2)+CHR(7), 'SA',CHR(3)+CHR(2),'SA',CHR(4)+CHR(1) or, equivalently, SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB011 Pg003 PRINT 'SA',$0004$,'SA',$0207$,'SA',$0302$, 'SA',$0401$. o The DOS command, MODE CO80, must be executed before entering BB/PC in order for the 'SA' mnemonic to work. 11. Screen save/restore added. The current contents of the screen can be saved using the 'SS' mnemonic. The format is: PRINT 'SS' This causes the contents of the current screen to be saved on the screen stack, the size of which can be from 1 to 8 screens, depending on the SCREENS parameter specified in the CONFIG.BBM file. An attempt to save more screens than specified will result in an error 1. The current screen is always on the top of the stack. To restore a previous screen, it must first be popped to the top of the stack using the 'SR' mnemonic. Then the screen is restored using the 'RS' mnemonic. This feature is particularly useful if System calls are used. The example below shows how the current screen is saved, followed by a DOS function call, then the BB/PC screen restored: 1000 PRINT 'SS','CS'; REM SAVE CURRENT SCREEN & CLEAR 1010 LET A=SCALL("DIR"); REM DISPLAY DOS DIRECTORY 1020 INPUT "PRESS ANY KEY TO CONTINUE ... ",* 1030 PRINT 'SR','RS';REM POP SCREEN TO TOP AND RESTORE 12. Communications Port Access Added Access to the PC's Communications ports is available via the device driver PCCOM.DRV. The devices T1 and T2 can be configured for COM1 or COM2. Buffered I/O with XON/XOFF flow control is provided by the driver. Memory constraints limit the buffer size to 256 bytes, so that at higher baud rates smaller data packets are required. If data loss occurs on sending or receiving lower the baud rate and/or reduce the size of the data packet. Once a COM port is set up in the CONFIG.BBM file, it may be opened as any other device or file. Record I/O is supported for the device. To send the message "LOG ON PLEASE" to another system, and wait for a reply, the following code is required: 1000 OPEN(1)"T1";REM OPEN COM DEVICE 1010 A$="LOG ON PLEASE" 1020 WRITERECORD(1,SIZ=LEN(A$))A$; REM SEND MESSAGE 1030 READRECORD(1,SIZ=1)B$; REM WAIT FOR RESPONSE ... The CONFIG.BBM file must have a line defining the communications device in order for BB/PC to recognize it. This is discussed in the user's manual. ORIGINATOR: D. Wenzel SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB011 Pg004 FIB 00012 10/25/88 *** 6.3C Tape Operating System Available for 1500 Systems [ WPSF 500 ] *** The BOSS 6.3C Tape Operating System is now available for the MAI 1500. The Tape O.S. was modified to support the newer MT-4406 tape drives (The MT-4403 model is no longer available). The 6.3C Tape O.S. can also be used to do save/restore operations using the MT-4403 43MB tape drives on 6.3A/B Operating System. NOTES: 1. 6.3B is still the current operating system release level for the MAI 1500 system. 2. The 6.3C Tape O.S. is NOT part of the 6.3B O.S. 6.3C is distributed on a single diskette and bundled with the MT-4406 tape drives. 3. The 600-foot tapes are NOT supported on the MT-4406 drives under 6.3C. USE ONLY THE 450-FOOT TAPES. ORIGINATOR: D. Wenzel SOFTWARE-BASIC FOUR-DS-5XX/15XX BBVI----------------FIB012 Pg001