SmartWare DOS Install ================================================== This document explains the installation procedures for SmartWare on DOS. If you have already installed the DOS version with Windows Setup and you now want to add devices to the resource file, refer to the Changes and Additions section. However, if you are not familiar with the DOS install program, it is recommended that you read the entire document, particularly, the installation steps. The instructions here assume you are installing from the A: drive - substitute the appropriate drive if necessary. Installation Requirements -------------------------------------------------- The minimum requirement for the 32 bit DOS executable (ANGOSSX) is an 80386 machine with at least 3 megabytes of RAM free. The minimum requirement for the 16 bit DOS executable (ANGOSS) is an 80286 machine with at least 2 megabytes of RAM free. Note that if you are using RAM disks, TSRs, or disk caches, you may require more memory. Depending on the installed options, SmartWare will require between 7 and 30 megabytes of disk space. What Install Does -------------------------------------------------- The Install program enables you to create a copy of SmartWare tailored to suit your needs. With Install you can specify the hardware, peripheral devices, and ANGOSS products to use. The Install program creates a directory structure on the destination drive and copies the appropriate files to it. Simply copying the contents of the ANGOSS disks to a hard disk will not work because ANGOSS files are shipped in a compressed format. On-line Help for Install -------------------------------------------------- Installation has been designed to be as simple as possible. An overview of the Install process, titled About Install, is also available on-line. This option is on the first Install screen and provides information on choosing options, prompts, function keys and exit options. In addition, On-line Help is available to explain prompts and to assist you in providing proper responses. To enter Help, press F1 at any time during the Install process. Using Install -------------------------------------------------- If this is the first time you have installed ANGOSS, you may wish to read the entire document. Before beginning, you should familiarize yourself with the hardware devices that make up your system. You should know the brand name and model number of devices, specifically your printer (and plotter if you have one). Your hardware manuals or your hardware dealer may assist you in gathering this information. Within the install program there are two ways to make selections. Usually the arrow keys are used to move a pointer to an item and then Enter is pressed to make a selection. Some lists allow for more than one choice to be made. In this case, use F6 to highlight each choice and then press F10 to complete the selection. Refer to the bottom of the screen for key stroke information. When installing on a network, login as an administrator to ensure that you have a complete set of permissions (rights). The following steps describe the installation process. Note that some steps are marked as optional; if you are not sure of what to do at these steps or are in a hurry to install SmartWare, you can skip them. Use the Changes and Additions option later if you need to reconfigure. Installation Steps -------------------------------------------------- Step 1: Insert the DOS Install Disk labeled DOS 1 Each SmartWare disk is uniquely named on the bottom right side of the label. Insert the disk named DOS 1 into the floppy drive. Step 2: Make the drive current At the DOS prompt, type the appropriate drive letter (either A or B) followed by a colon and press Enter. Step 3: Execute the Install program Type INSTALL and press Enter. Optionally you can specify the destination drive on the command line following the install command (i.e., INSTALL G:). If successful, the first install screen is displayed. Step 4: Select First Install Select First Install by pressing the Enter key. Step 5: Specify a path After selecting First Install, the recommended location for SmartWare is displayed. To install SmartWare in this directory, press Enter. To install it in a different directory, use Backspace to delete the default name and then type a new one. Step 6: Select ANGOSS Environment The Installation Categories screen lists the ANGOSS Environment and a number of hardware/software categories. Press Enter on the first item. Step 7: Select Environment Items to install After selecting ANGOSS Environment, a second list is displayed containing the ANGOSS items and tutorials. If you will be using all of the ANGOSS Environment features, select the first option, All of ANGOSS Environment, with the F6 key and then press F10. Otherwise, use F6 to toggle the highlighter on the option(s) you want and press F10. If you are low on disk space, refer to the Custom Installation section in this document. Note, however, that the ANGOSSX item must be installed. Step 8: Select the Display Adapters (Optional) You do not need to select the Display Adapter categories since SmartWare will automatically detect the Display Adapter in your system. See the Display Adapters section in this document for more information. NOTE: Do not select a display driver that supports extended resolution unless you are certain that your monitor supports it. Step 9: Select Printers After selecting the Printers item with the Enter key, you will be presented with a menu listing Printer Manufacturers. To select the manufacturer, move the arrow to the appropriate choice and press Enter. The second level menu presents a list of models; use the F6 key to highlight the models you want and press F10 when you are finished. If you have more than one printer, repeat this sequence for each manufacturer and model required. For more information on printers, refer to the Printer and Plotters Descriptors section in this document. When running SmartWare, you can set the default printer at any time by selecting the Tools Preference Hardware command on any of the module menus. Step 10: Select Plotters (Optional) If you have a plotter, use F6 to select from the list of available plotters and press F10 when you are finished. For more information on plotters, see the Printer and Plotters Descriptors section in this document. When running SmartWare, you can set the default plotter at any time by selecting the Tools Preference Hardware command on any of the module menus. Step 11: Select Fonts (Optional) If you want all of the fonts installed, you do not need to select this category. All fonts are highlighted and installed automatically. Generally, it's a good idea to install all of the fonts because SmartWare supports a wide range of printing, graphics, and display capabilities that would allow you to use them. If disk space is a problem, however, you might want to choose only those fonts you need or only those supported by your printer. Use the F6 key to deselect fonts. Remember that your font selections may affect what can be displayed on your screen as well as what can be printed. Step 12: Installing Network drivers (Optional) A generic network driver is always installed. The generic driver should work on all networks. Other drivers can be installed which will take advantage of special features, such as Novell's TTS or improve performance by directly calling the appropriate interrupts. Step 13: Installing Modem drivers (Optional) If you plan to use a modem (communication device), select at least one on the drivers from the list. Step 14: Select Character Comparison Tables (Optional) Character Comparison Tables determine the rules for sorting accented and special foreign language characters. If you want all of the tables installed, you do not need to select this category. All of the Character Comparison Tables are highlighted and are installed automatically. Use F6 to deselect tables. Step 15: ANGOSS Voice Suite (Optional) If you have the Voice feature, you must confirm installation of the ANGOSS Voice Tools. If you do not have the Voice feature, do not select this option. Step 16: The 16 bit Executable (Optional) If you have ordered the 16 bit executable (for 286 machines or 386 machines with less than 3 MB of RAM) select this option. Note that you must still install the ANGOSSX version (Step 7) for other system files. If you did not order this executable, do not select this option. Step 17: Install selections When you have finished making selections, press F10. You will then be prompted to either Install The Selections you have made or Abandon Install. Point to the option of your choice and press Enter. Step 18: Enter the Node Key(s) If you opted to install the selections, you will be prompted to enter a company name and the Environment Node Key found on your Node Key Card. This key determines the serial number and the number of nodes initially installed. If the Developer System was selected, you will also be prompted for the Developer System Node Key. Step 19: Insert disks when prompted The Install program prompts you to insert the disks by number or name. Note that, depending on your selections, the install program may not require all of the disks. When this process is complete, you will have the option to copy the install program to the hard drive as well. Step 20: Finishing Install At the prompt, selecting the Enter key will complete the installation and return you to the operating system. After completing the install procedure, you should configure the operating system by adding the ANGOSS bin directory to the path and by setting the appropriate number of files in the config.sys. Then run SmartWare and set the default printer and any other applicable default settings. Note that the default printer is not automatically detected therefore, in order to print correctly from SmartWare, you should select a default printer. The following sections, Configuring the Operating System, Running SmartWare and, Setting Preferences discuss these topics. Configuring the Operating System -------------------------------------------------- The Path Statement. You should put the ANGOSS bin directory in your path statement so that you can access ANGOSS from any location within your system. If you do not do this, you will need to specify the path (i.e., c:\angoss\bin) or change to that directory each time you execute SmartWare. The path statement is usually located in the autoexec.bat file. The Files Statement. Next, consider how many files will be opened at any one time. The files statement in your config.sys file specifies how many file handles are currently set. Usually, 30 to 40 files is a realistic number however, when running database applications, 60 to 100 files may be required. NOTE: If you are using a network, there may be network configuration files that affect the number of open files. See your network documentation. Editing the autoexec.bat and config.sys files -------------------------------------------------- The following steps assume that you have installed SmartWare in the recommended directory on the C: drive (c:\angoss). If this is not the case, substitute the drive letter and/or the ANGOSS directory name. Also, if you are using the 16 bit executable, substitute angossx with angoss. STEP 1: Load the autoexec.bat file into a text editor. At the DOS prompt, enter the command: c:\angoss\bin\angossx -vm Select Tools followed by Text-Editor from the menus and enter the file name: c:\autoexec.bat STEP 2: Move the cursor to the line beginning with PATH or SET PATH. Path statements vary (depending on system hardware and software), they can also appear in upper or lower case letters. For example, the following is a simple path statement: PATH=C:\; C:\DOS If the path statement isn't there, add one. Note that each item in a path statement is separated by a semicolon and that each item should include the drive letter. STEP 3: Add the ANGOSS bin directory. Using the previous example, the path statement would become: PATH=C:\; C:\DOS;C:\ANGOSS\BIN Occasionally items must be arranged in a certain order; if you have any problems, refer to a DOS manual for information and rules concerning the autoexec.bat file and the PATH command. STEP 4: Press F10 to save the file The SmartWare Text-Editor automatically creates a backup of this file. The backup file can be found in the same directory, using the original name but replacing the extension with .btx (i.e., c:\autoexec.btx). STEP 5: Load the config.sys file into the text editor. Again, select Tools followed by Text-Editor from the menus and enter the file name: c:\config.sys STEP 6: Move the cursor to the line beginning with the word FILES. Files statements can appear in upper or lower case letters. For example: FILES=20 If the files statement isn't there, add one. STEP 7: Set the number of files. Change the number following the equal sign to the appropriate value: For example: FILES=60 STEP 8: Press F10 to save the file and then quit SmartWare A backup file called config.btx will be saved in the original directory. STEP 9: Reboot the computer Changes to the config.sys file will only take effect when the computer has been restarted. Running SmartWare -------------------------------------------------- To run the 32 bit version of SmartWare, at the DOS prompt, enter the command: angossx To run the 16 bit version of SmartWare, enter the command: angoss NOTE: The -vm command line option instructs SmartWare to use virtual memory, therefore if you have 4 meg of RAM free or more you may not need to use the virtual memory option. To produce a list of all the SmartWare command options, use the -x flag: angossx -x A complete list and an explanation of command line options can be found in the Software System manual. Assuming you have installed the 32 bit version in the recommended location, the sample application can be started with the DOS command: angossx -RADc:\angoss\apsys\sample Setting Preferences -------------------------------------------------- You can set the default printer to any of the printers selected in the install process. As well, if special text and screen drivers were installed, these can be used as defaults. To set or change these hardware settings, start SmartWare, select TOOLS, followed by PREFERENCES, followed by HARDWARE. Move to the desired item (i.e., Printer), press F6, select the appropriate device, and press F10. When you have finished selecting devices, press F10 again. General defaults, such as the Date and Currency types, can be set through TOOLS PREFERENCES GLOBAL. Module defaults, such as dictionary settings, are specified in the preference options headed by the module name (e.g., TOOLS PREFERENCES WORDPROCESSOR). Note that the Software System manual covers Hardware, Global, and Module Preferences in detail. Display Adapters -------------------------------------------------- There are two types of display drivers: text screen drivers graphics screen drivers Text screen drivers display text; graphics screen drivers display graphics. SmartWare uses the driver appropriate for your current screen display. Text drivers fall into two categories: character-based what you see is what you get (WYSIWYG) Character-based text drivers use the video display card in its character mode. Fonts and attributes are indicated on screen by different colors, when possible. This mode has the advantage of faster display and smaller memory requirements. WYSIWYG drivers use the display card's graphics features to display fonts and attributes on your screen. This mode requires more memory and is slower than character mode. SmartWare WYSIWYG drivers are only partially WYSIWYG in that they do not display point size, proportional spacing, or all the attributes of a typeface. They do, however, display attributes such as boldface and italics. As well, they can provide a screen with more rows and columns then the standard screen. WYSIWYG drivers can be identified easily because "WYSIWYG" is included in the description. For example, the following is a WYSIWYG driver: EGA w/ECD or VGA wysiwyg If you will be creating documents, worksheets, or data-files containing many fonts, foreign language characters, or type attributes, you should install a WYSIWYG driver so that you can see them on screen. You can install both a WYSIWYG and character-based driver and switch between them as your work dictates. Switching is usually easy because many WYSIWYG drivers match the screen format used by character-based drivers. This prevents you from having to exit and reenter SmartWare to see the difference. Screen format refers to the number of character rows and character columns comprising a screen. The "standard" size is 25 rows x 80 columns. When a screen format is larger than this, the screen is referred to as having an "extended screen format." Usually, text characters will have a lower resolution when you use extended screen format. Two examples of text display drivers follow. The first indicates that it supports a standard screen format. The second indicates that it supports an extended screen format. EGA 25x80 wysiwyg text/mono Hercules mono text 35x90 wysiwyg Extended screen formats are useful for displaying more of a worksheet or document than the standard format permits. If you do not think you would ever need extended screen capability, you can save disk space by not installing drivers that support it. If you choose to install a driver(s) that supports extended screen format, you can change the screen format using the Tools Preferences Hardware command. The change will not take effect until you exit and reenter SmartWare. Graphics drivers. SmartWare graphics drivers allow the graphs you create in the Spreadsheet to be displayed on screen. The resolution of graphics displays is measured in pixels, resulting in pixel columns and pixel rows. Just like text drivers, some graphics drivers support extended display modes. These screens are referred to as having "extended resolution." A graphics display could be referred to as having extended resolution if the number of pixel columns and rows is higher than the IBM-defined standards for CGA, EGA, and VGA screens, which are 640 x 200, 640 x 350, and 640 x 480 respectively. EGAECD 256k EGA on Enhanced Color Display, 640x350 Some of the display cards, when used in conjunction with graphics drivers, offer a choice between higher resolution or displaying more colors simultaneously. High resolution produces a smoother appearance for your graphics, however, other circumstances may require the use of more colors. Some display cards, such as IBM MCGA, can display 256 colors simultaneously. SmartWare uses 16 colors, but some SmartWare graphics drivers can use the additional color capability to smooth color transitions. This technique, called anti-aliasing, smooths the jagged lines often seen in computer-generated graphics. Switch settings. Before you select a text or graphics driver that supports an extended display mode, be certain your monitor supports it. Switch settings on your display card indicate to SmartWare what type of monitor you are using. If the switches are set incorrectly you may get an error message. For example, if the switch settings indicate you have an EGA monitor and you have a multifrequency monitor, you will not be able to get an extended display mode. The switch settings indicate that you have an EGA monitor, which does not support this mode. Therefore, you will get the error message Incompatible screen driver. IMPORTANT: If you select a driver that supports either extended resolution or extended screen format, but do not have the proper monitor, your monitor can be damaged. While SmartWare attempts to check for the proper equipment whenever possible, you should use care to select only those drivers designed for your display card and monitor combination. ANGOSS Software International cannot be responsible for damage caused by selection of the wrong driver. If you see wavy horizontal lines on your screen, shut off the monitor immediately and reinstall choosing the proper driver. Manually Editing the Hardware Preference File -------------------------------------------------- If, for some reason, you cannot start SmartWare after making a driver change, you can restore the smarthdw.def file from a backup or you can edit it manually in a text editor. This text file contains the current settings of hardware defaults. When the screen driver values are blank, SmartWare uses auto-detection. For single users, the location of this file is probably in the ANGOSS oasys directory (i.e., c:\angoss\oasys\smarthdw.def) though SmartWare first looks for preference files in the start up directory, then the home directory (set by the home environment variable), and finally the ANGOSS oasys directory. To reset screen drivers, first search for a line containing the words Text Screen. This line and the following 2 lines might look like this: p[101]Text Screen: c 80 EGACL - EGA/VGA 25x80 color text mode If the value in the last line of this block is incorrect, delete its contents, leaving the blank line in place. Repeat this process for the graphics block which is headed by the words Graphics Screen. Printer and Plotter Descriptors -------------------------------------------------- In the printer and plotter categories, the group of files represent available descriptor files. Choosing a plotter descriptor is much more straightforward than choosing a printer descriptor. You simply pick the descriptor with the same model number as your plotter. You can find more information about configuring your plotter in the Software System manual. When choosing a printer descriptor, you must consider several factors. The following explains the information contained in a descriptor file name so you can choose one easily. Usually, two descriptors are loaded with every printer: a draft descriptor and a quality descriptor. If your printer supports font cartridges, you may have cartridge descriptors. If you are using cartridges, separate cartridge descriptors will need to be installed. Note that some printers use "pseudo" font cartridges to provide access to internal fonts. In this case, the cartridges are automatically installed by selecting the printer. Descriptors for laser and inkjet printers indicate that they are draft or quality by listing their resolution, the number of dots per inch (dpi). Descriptors for dot matrix printers simply list "draft" or "quality". For example, when you select a Hewlett Packard Series II laser printer, the following descriptors are installed: HPII DC- HP Series II, 100 Resolution HPII QC- HP Series II, 300 Resolution If you select an Epson FX850 printer, the following descriptors are installed: EP F850D Epson FX-850/1050, Draft Mode EP F850Q Epson FX-850/1050, Quality Mode The way draft and quality output is produced depends on what type of printer you are using. Lasers and dot matrix printers produce draft and quality output in very different ways. For draft output, lasers print fewer dots per inch, which yields coarser text and graphics. Dot matrix printers, on the other hand, could use one of several techniques. They may pass over the paper once only, rather than twice. Or, they may use fewer print head pins, printing the text and image in a less precise way. For quality output, lasers use more dots per inch to produce finer, more well-defined text and graphics. Dot matrix printers might print bi-directionally (two passes), or use all the pins to print the text and image. In general, draft descriptors produce output much more quickly, use less memory, and yield coarser text and graphics, and, in some cases, eliminate graphs and filled area fonts altogether. Quality descriptors will yield higher quality text and graphics, but will take longer to print and use more memory. If there are other descriptors available in the hardware preferences, they are probably font cartridge descriptors or descriptors that support color output. The descriptors you selected during Install are stored in the system Resource Library. This file, resource.srl, is created automatically when you complete installation. Printer Emulation -------------------------------------------------- If you can't find your printer on the install program's list, you might be able to use a different printer driver. Check your printer's manual to see if it can emulate another printer, most printers can. If this is the case, install that printer descriptor instead. Note that when using SmartWare, the printer should be in emulation mode. Adding Nodes -------------------------------------------------- Typically, one SmartWare and one Developer node will exist after the installation process has been completed. Since each node allows one user or process to run, a single user will have the ability to access ANGOSS. You must purchase additional nodes if more than one user will be accessing ANGOSS at a time. The SmartWare nodes file, called nodes.usr, is located in the nodes directory beneath the ANGOSS directory. The Developer nodes file, called devnodes.usr, is also located in this directory. The number of nodes currently installed can be shown by the dmpnodes program which is located in the ANGOSS bin directory. This program presents a list of the contents of the nodes.usr file. Assuming the recommended location of the ANGOSS system directory, this command may look like: dmpnodes -a c:\angoss\nodes\nodes.usr or dmpnodes -a c:\angoss\nodes\devnodes.usr Note that the -a parameter must be lower case. This version of the command will produce a listing similar to the following: SN: ca00001000, 4 nodes N001 ca00001000 N002 ca00001001 N003 ca00001002 N004 ca00001003 The first of the two letters preceding each number indicates the node file type. The opening line also shows the first serial number plus the number of nodes; the remaining lines are the actual serial numbers. If dmpnodes is issued without the -a parameter, only the first line will be displayed. Nodes can be purchased in two formats: 1. A node key, which is a special password that allows the addition of a node, or 2. A node file, which is physically shipped on a diskette. Purchasing a Node Key -------------------------------------------------- Because adding a node may only require a key, nodes can be purchased quickly and easily over the phone. ANGOSS Software can fax you the key immediately. Before You Call With Your Node Order Before calling ANGOSS Software to order additional nodes, you must run the program which reports information we require to calculate the key. At the DOS prompt, type the following command: lastnode c:\angoss\nodes\nodes.usr for SmartWare modes, and lastnode c:\angoss\nodes\devnodes.usr for Developer nodes. This will produce the number of nodes currently on your system, the last serial number, and the version number. Please include this information with your purchase order. Node Key Installation -------------------------------------------------- Once you have received the node key from ANGOSS Software, you are ready to add a new user access node to your system. To do so, follow these steps: Step 1: Ensure no one is currently running ANGOSS Step 2: Run the newnodes command on the appropriate node file. For example: newnodes c:\angoss\nodes\nodes.usr If you have not installed ANGOSS in the recommended directory, adjust the path accordingly. Substitute with the node activation key supplied by ANGOSS Software. Please note that there are no zeros (0), ones (1), lower case L's or upper case I's in the . NOTE: Network users should make sure that permissions (rights) to the nodes.usr file for all users is read/write. Novell Netware also requires the file to be shareable. The command "flag nodes.usr SRW" can be used with Novell Netware 3.11. Node Installation From a Diskette -------------------------------------------------- Usually, there is only one nodes file on the disk that came with your node package however, you may have requested more than one. If there is only one nodes file on the disk, it will be called nodes-c.1; if there are two, the second will be called nodes-c.2; and so on. The "-c" in the name indicates that the file is a SmartWare nodes file. A "-e" indicates that a file is a Developer nodes file. To find out the number of nodes in a new file, use the dmpnodes command on it. To Install Nodes Insert the nodes disk, make that drive current, and execute the addnodes program specifying the -u update parameter and the name of both the nodes file in the system and the nodes file on the disk. addnodes -u . Where is the path and name of the original nodes file and is the name of the nodes file that came with the node disk. Note that the -u parameter must be lower case. For example: addnodes -u c:\angoss\nodes\node.usr a:nodes-c.1 The program will produce messages indicating that it is reading the nodes file and adding records. When it has completed, the number of records written is displayed. If an error occurs, a diagnostic message will be displayed. Note that you can only add SmartWare nodes to SmartWare and Developer nodes to the Developer. NOTE: If this program appears to cause a system `hang', it is probably waiting for keyboard input. Press Ctrl Break and retype the command making sure that the parameters are entered correctly. Network users should make sure that permissions (rights) to the nodes.usr and devnodes.usr files for all users is read/write. Novell Netware also requires the file to be shareable. The command "flag nodes.usr SRW" can be used with Novell Netware 3.11. Changes and Additions -------------------------------------------------- At some point, you may wish to add hardware or software elements to your system. To install additional hardware or software elements, use the Changes and Additions option in the DOS Install program. IMPORTANT: Before using the Changes and Additions option on a network, make sure all users are logged off to prevent possible damage or corruption of SmartWare files or shared files. STEP 1: Insert the DOS 1 disk of the installation set into the appropriate drive (A or B). STEP 2: Choose the changes and additions option. STEP 3: Select the category(s) you wish to update. If you need more information on the DOS install program, review the installation steps at the beginning of this document. In particular, steps 8 through 14 describe each of the categories. Remember that any hardware changes you make will be reflected in the Resource Library. Upon making the change you will be prompted to choose where to store the additional resource. You can choose to store it on disk, in your local library, or in your system library. If you select disk, existing libraries will not be affected as the new resources will be stored on disk. If you select local, the new resources will be added to the current library or one will be created, if necessary. If you select system, the resources will be added to the system library. NOTE: When adding a resource to an existing library, remember that any resource with the same name as the one you are adding will be overwritten. In some cases, you may not need to use Changes and Additions in the Install program. You may be able to use one of the Tools commands. For example, if you installed a file during the original installation, but need to move it to a local workstation, you can use the Tools Resource Extract command. This command gives you access to all the files stored in the system Resource Library (refer to the next section). Networks -------------------------------------------------- SmartWare uses a generic network driver that should work on any network. For file and record locking to operate correctly, you must set the network driver on the TOOLS PREFERENCES HARDWARE screen. NOTE: A number of networks such as 3Com and NetWare offer full NetBIOS options which can be installed or loaded. SmartWare does not need these additional NetBIOS functions, so you may free memory by not using them. However, you should consider whether any other applications on your network need full NetBIOS options before making this decision. Resource Library -------------------------------------------------- The descriptors, device drivers, and font files you selected during Install are stored in one file, the Resource Library. You will find the library in your system resource directory under the name resource.srl. The primary function of the Resource Library is to speed up activities that must read these resources in order to execute. Because descriptors, drivers, and fonts must sometimes be altered or copied individually, the library has commands that enable you to extract and modify its contents. Although they can be extracted out of the library, SmartWare cannot use them as individual files. You must copy them back into the library before SmartWare can use the resource. (Resource commands are explained later.) The Resource Library is created automatically when you install SmartWare. The .srl extension indicates that it is the system resource library. In some situations you will want to create a local library, which will have an .lrl extension. Each time you enter SmartWare, it looks for both a local library and a system library. Using More Than One Resource Library -------------------------------------------------- When running SmartWare locally, generally only one library, the system library, is required. It contains all of the resources needed to run your hardware and peripheral devices. If you are working on a network, however, local libraries are very useful. Because the Resource Library's function is to enhance SmartWare's execution speed, resource.srl benefits from being kept as small as possible. Ideally, it should contain only those resources used by all network users. Network users with unique hardware needs should store those hardware requirements in their own local resource library. For example, assume you work in an office where six people work on a network. Half of the employees use laser printers and the other half use dot matrix printers. In this case, the system resource library may include screen drivers and graphics drivers but each person would have a local resource library in their home path containing the appropriate printer descriptor. Creating a Local Resource Library -------------------------------------------------- You can create local libraries in a variety of ways. One of the more common ways is with the Tools Resource Extract and Modify commands in the Main module. Because the resources are not individual files, they must first be extracted from the Resource Library. The resource can then be added to the local resource library with the Modify command. Another way to create a local resource library is to use the Tools Edit- Printer command or Tools New-Font. When you edit a descriptor or prerasterize a font, you have the option of saving it to disk, the local library, or the system library. If you select Local, SmartWare stores the resource in the local library, creating one if necessary. Refer to the Software System manual for more information about this process. To create a local resource file: STEP 1: Execute Tools Resource Extract in the Main module. STEP 2: Select System to access the system library. STEP 3: Point the arrow to a category of resources and press Enter. STEP 4: Point to a resource and press Enter. If you want to extract more than one item, use F6 to highlight the items. If you want to deselect an item, use F6 again. STEP 5: Enter a destination path for the extracted resource(s). Do not include the resource name. If you are extracting a resource from a network library, you should enter your home path. If you are not on a network, press Enter so that the resource is placed in the system directory. STEP 6: Execute Tools Resource Modify. STEP 7: Select Local. STEP 8: Select the same category of resources as in Step 3. IMPORTANT: If you copy an item into the wrong category, for example, a network driver into the hardware driver category, SmartWare will not recognize the driver. STEP 9: Press F7 to add a resource. STEP 10: Enter the name of the resource, e.g. egacl.sdv, and press Enter. The resource appears in the prompter followed by [add], indicating the resources had just been added to the local resource library. NOTE: You may want to simply enter *.sdv. This is particularly helpful if you have extracted more than one resource from the same category. STEP 11: Press F10 to complete the modification and then again to return to the Main menu. Notice that when you press F10 the first time, the categories screen is displayed and the number following the category you just modified reflects the change. For example, if you added a screen driver to your local resource library and it was empty prior to doing so, this category would be followed by 1. The other categories would not be followed by numbers. When you press F10 the second time, a message is displayed indicating how many files are being written to the local resource library. For example, if you have 4 files in the library, the message begins with Writing 1 out 4 files... and continues until it has written all four files. The library is rebuilt each time it is modified to keep it efficiently packed. Tools Resource Commands -------------------------------------------------- Three commands enable you to use the Resource Library. Tools Resource View Tools Resource Extract Tools Resource Modify Tools Resource Extract Extract copies a resource to a specified location. Used alone, the command simply allows you to store a resource in a different directory or on a floppy. Used in combination with the Tools Resource Modify command, you can create a local library. The steps to creating a local library are given in the previous section. You may wish to copy a resource to a file so that another SmartWare user can access the resource and copy it into their Resource Library. If you and the other user are on the same network, you can copy the resource to a network directory so the other user can access it. The following steps demonstrate these situations: STEP 1: Execute Tools Resource Extract in the Main module. STEP 2: The options Local and System are displayed. Select the one you need. The contents of the library are then displayed. STEP 3: Select a category by pointing to it and pressing Enter. STEP 4: Select a resource. Use F6 to highlight one or more files and press Enter or F10. STEP 5: Enter the destination path for the extracted resources. To copy the resources to a floppy for others to use, simply specify a:. If you and the other user are on a network, specify a common network directory. Tools Resource Modify This command allows you to add and delete files from the Resource Library. To use the command: STEP 1: Execute Tools Resource Modify in the Main module. STEP 2: The options Local and System are displayed. Select the library you need to modify. The contents of the library are then displayed. STEP 3: Select a category of resources by pointing to it and pressing Enter. The following four Quick Keys are displayed: F5 Cancel F7 Add F8 Delete F10 Finished If you selected an empty category, only F7 and F10 are listed. STEP 4: adding resources to a library To add a file, select F7 and enter the name of the file you wish to add. If this file is not in your system directory, enter the complete path. You may wish to use the wild card character (*). The new file will appear in the list followed by [add]. If the file you added replaced a file with the identical name, the new file will appear in the list followed by [refresh]. Anytime you add or refresh one or more resources, its path is displayed in the bottom left- hand corner of the screen. STEP 5: deleting resources from a library To delete a file, point to the file and select F8. The word [delete] is placed after the file. Press F10 to exit the screen. Tools Resource View This file displays the contents of the local or system library. It is similar to the Tools Directory Display command in that you can view the files, but you cannot alter them in any way. To use the command: STEP 1: Execute Tools Resource View in the Main module. STEP 2: Select Local or System. The categories of the library are displayed followed by the number of resources stored in each one. STEP 3: To view the resources within a category, point the arrow at a category and press Enter. STEP 4: Press F10 to finish viewing the resources.