The Mnu Version 1.26 The Mnu programs and accompanying documentation are Copyright (c) 1989 Bonsai Technologies. All rights reserved. The Mnu is a trademark of Bonsai Technologies. Novell is a registered trademark of Novell, Inc. Table of Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 1 - Mnu Basics . . . . . . . . . . . . . . . . . . . 2 Program Modules . . . . . . . . . . . . . . . . . . . . 2 Mnu Objects . . . . . . . . . . . . . . . . . . . . . . 2 Chapter 2 - Mnu Configuration . . . . . . . . . . . . . . . . 5 Help in MnuCon . . . . . . . . . . . . . . . . . . . . . 5 MnuCon Operation . . . . . . . . . . . . . . . . . . . . 5 Main Menu . . . . . . . . . . . . . . . . . . . . . . . 6 Group Information . . . . . . . . . . . . . . . . . 7 Group Selection List . . . . . . . . . . . . . 7 Edit Group . . . . . . . . . . . . . . . . . . 7 Full Name (7); Group Members (7); Summary (7) Item Information . . . . . . . . . . . . . . . . . 9 Item Selection List . . . . . . . . . . . . . 9 Edit Item . . . . . . . . . . . . . . . . . . 9 Authorized Groups & Users (10); Default Drive (10); Description (10); Drive Mapping (11); Execution Method (11); Instructions (13); Menus Used In (14); Prohibited Groups & Users (14); Summary (15) Menu Information . . . . . . . . . . . . . . . . . 16 Edit Menu . . . . . . . . . . . . . . . . . . 16 Authorized Groups & Users (17); Description (17); Menu Structure (17); Menus Used In (17); Prohibited Groups & Users (17); Screen Position (18); Summary (18) Other Information . . . . . . . . . . . . . . . . . 19 Allow Escape to DOS (19); Auto Logout Item (19); Auto Logout Timeout (20); Base Menu (20); Display Station Number (20); Screen Saver Timeout (20); Separate Menus from Items (20); Summary (20) Program Information . . . . . . . . . . . . . . . . 22 Program Selection List . . . . . . . . . . . . 22 Edit Program . . . . . . . . . . . . . . . . . 22 Default Drive (23); Description (23); Drive Mapping (23); License Info (23); Search Path (23); Summary (23) User Information . . . . . . . . . . . . . . . . . 24 Group Selection List . . . . . . . . . . . . . 24 Edit Group . . . . . . . . . . . . . . . . . . 24 Full Name (24); Groups Belonged To (24); Security Equivalences (25); Summary (25) The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Reports . . . . . . . . . . . . . . . . . . . . . . 26 Complete System Configuration (26); Menu Structure (26); Mnu Configuration (26); Netware Configuration (26) Chapter 3 - The Wadget Example . . . . . . . . . . . . . . . 27 Appendix A - License Agreement . . . . . . . . . . . . . . . 39 Appendix B - Registration Information . . . . . . . . . . . . 41 Appendix C - Program Support . . . . . . . . . . . . . . . . 47 Appendix D - Hints . . . . . . . . . . . . . . . . . . . . . 48 Appendix E - Technical Information . . . . . . . . . . . . . 49 Bindery Usage . . . . . . . . . . . . . . . . . . . . . 49 Environment variables . . . . . . . . . . . . . . . . . 49 CGA Snow & BW w/Color Video . . . . . . . . . . . . . . 49 License Control . . . . . . . . . . . . . . . . . . . . 50 Work Files . . . . . . . . . . . . . . . . . . . . . . . 50 Dos Versions . . . . . . . . . . . . . . . . . . . . . . 51 Netware Version . . . . . . . . . . . . . . . . . . . . 51 Multiple File Servers . . . . . . . . . . . . . . . . . 51 Item Execution . . . . . . . . . . . . . . . . . . . . . 51 Appendix F - Cautions . . . . . . . . . . . . . . . . . . . . 55 Appendix G - Installation . . . . . . . . . . . . . . . . . . 57 Appendix H - Future Enhancements . . . . . . . . . . . . . . 59 Appendix I - Version History . . . . . . . . . . . . . . . . 60 Appendix J - System Config Report . . . . . . . . . . . . . . 62 Appendix K - Upgrade Instructions . . . . . . . . . . . . . . 63 The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Introduction Page 1 Introduction ---------------------------------- The Mnu is a menu system designed specifically for use with Novell. It was designed to be a logical extension of Novell's security system of Users, Groups and Trustees. In addition, program operation was designed to be very similar to Novell's existing Menu Utilities; i.e., MnuCon (The Mnu Configuration) operates very similarly to SysCon (System Configuration). The Mnu does not replace any of Novell's utilities, except for the Novell Menu, but rather works hand in hand with them. If you are familiar with the concepts of Novell's Groups and Users, you will have no problem with the concepts of The Mnu's Menus, Items and Programs. The Mnu, for all it capabilities and flexibility, really is a very simple program. If you are familiar with Novell's SysCon and other utilities, you will have no problem navigating in MnuInst and MnuCon, as they were designed to use the same user interface. The best way to become familiar with The Mnu is: 1) Skim Chapter 1 - Mnu Basics to get some background info. 2) Read Chapter 3 - The Wadget Example to get an idea of what The Mnu can do (not necessarily how it does it). If you are still interested (I hope you are!): 3) Skim Chapter 2 - Mnu Configuration to get a general idea of what you are going to do after The Mnu is installed. 4) Install The Mnu on your file server using Appendix G - Installation. 5) Set up a simple version of you current menus using Chapter 2 - Mnu Configuration as a reference (or, use the context-sensitive help). I hope you find The Mnu to be a valuable addition to your network! One other note, while The Mnu is a complete product as it is, it is continually evolving. Take a look at Appendix H and see if any of the things mentioned there interest you, then let me know! Also, let me know if there are other things that you would like to see. The Mnu was, is, and will be, designed and written to meet your needs. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 1 - Mnu Basics Page 2 Chapter 1 - Mnu Basics ---------------------------------- Program Modules Program Modules The Mnu consists of three modules: MnuInst Mnu Installation (MNUINST.EXE,MNU$HLP.HLP) MnuCon Mnu Configuration (MNUCON.EXE,MNU$HLP.HLP) Mnu The Mnu (MNU.BAT,MNU$MAIN.EXE) MnuInst is used to initially install The Mnu on a file server, enter registration information and update existing Mnu data. Please note that you must be SUPERVISOR equivalent to run this module. MnuCon works with Menus, Items and Programs in much the same way that SysCon works with Users and Groups. Please note that you must be SUPERVISOR equivalent to run this module. Mnu is the user interface module. It is the module that each user will run to access the menu system. Mnu Objects Mnu Objects Items An Item is simply a choice that appears on a user's menu. For example: Set Password, Word Processing, Logout. You may specify which groups and/or users are authorized to use an item. In addition, you may specifically prohibit groups and/or users from using an item. Also, you must specify which Menus the item is to appear on; i.e., Word Processing would appear on the Applications menu, Set Password would appear on the Netware Utilities menu, Logout would appear on the main menu. Drive Mapping may be specified by an option; i.e., for Word Processing, drive F: could be mapped to the WP subdirectory off the user's personal directory and drive G: could be mapped to a common data area. In conjunction with the Data drives, a Default Drive may be specified, so the item is executed with a specific drive letter as the default drive. The Program that the Item uses may also be specified. This will allow a search path to the program files to The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 1 - Mnu Basics Page 3 be setup and also any data drives that the program needs. Also, license metering may optionally be utilized. Items may also be used to standardize a set of instructions across other items through the use of Item Instructions. For example, you might set up an item called LASER_CAP to perform a printer capture to your laser printer. In the instructions for LASER_CAP, you enter the appropriate capture commands. Then in the instruction for your SPREADSHEET item, you insert an Item instruction before the Text instruction that loads your spreadsheet program. When The Mnu encounters the Item instruction during execution of SPREADSHEET, it inserts all of the instructions from LASER_CAP. Please note that in this case Authorization and Prohibition are ignored for Item LASER_CAP (but not for Item SPREADSHEET). Menus A Menu is similar to an Item in that you authorize and prohibit groups and users. Also, you specify which menus the Menu is to appear in. However, a Menu does not execute any programs or perform other actions and thus does not have Drive Mappings or Instructions. In a typical setup, you might have a Main Menu, an Applications Menu and a Netware Utilities Menu. The Applications Menu and the Netware Utilities Menu would be used in the Main Menu. Programs A Program is used to provide centralized license control, search path mapping and data drive mapping. For example, if you have an accounting system that has three modules, GL, AR and AP, you would setup a Program called ACCTING that has a search path to where all the executables are and a Data Drive to where the centralized data files are kept. Then you would make separate items for GL, AR and AP that all have ACCTING as the Program Used. If you later move the data and/or program files, you simply change the Search Path and Drive Mapping for the Program and the Items are affected automatically. The license metering feature may be used to allow single-user programs to run on a network; i.e., the above accounting system is single-user and will not The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 1 - Mnu Basics Page 4 allow multi-user access to the data files. Simply specify the number of licenses as 1 on the Program and only one person will be allowed into the accounting system at the same time (you must also use the Exec execution method for this to work). Note that this setup, 1 program and multiple items, would not allow a user to access GL if another user is in AP, since both items use the same program. The other application of the license metering feature is that it allows you to purchase fewer licenses for a program than the number of users on your network without violating your license agreement; i.e., on a 10 user network, you may buy 5 word processing licenses and use the license metering feature to only allow 5 users to use the program at the same time. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 5 Chapter 2 - Mnu Configuration ---------------------------------- Help in MnuCon Help in MnuCon MnuCon has an online context-sensitive help system. Whenever you need more information on something, simply press F1. The Help Text is organized as an information tree which gets more and more specific as you move through it. The following is a guide to interpreting the Help screens: The topic behind "::" is the title of the current page. The topics behind ">>" are more specific help. The topics behind "<<" is more general help. Any highlighted text may be selected by moving the selection bar with the cursor keys and striking enter. Highlighted text will generally appear after the ">>" and "<<" symbols. However, it will occasionally appear in the text also. MnuCon Operation MnuCon Operation MnuCon consists of a series of menus and list selections. When in a menu, use the up/down arrow keys to move among the options. Options that have a Quick-Select character will have that character highlighted. If you hit the Quick-Select character for an option, the cursor will move to that option. After the cursor is on your desired option, hit enter to execute the option. When in a list selection, use the up/down arrows, home/end, pgup/pgdn to move the cursor through the options. Also, you may hit the first letter of an option, this will take you to the first option in the list with that first letter except if the current option has that first letter, it will take you to the next option with that first letter. In addition to the cursor movement keys, one of more of the following may be active in a list selection: Enter, Delete, Insert, Mark(F5), Modify(F3). Hit the Help key while in the list to find out which keys are active. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 6 Main Menu Main Menu The Main Menu consists of the following options: Group This option will allow you add, delete, Information and edit Groups. The operations performed here are identical to those in SysCon. Item This option will allow you to add, delete, Information and edit Items. Menu This option will allow you to add, delete Information and edit Menus. Other This option will allow you to edit The Information Mnu's configuration information, such as the Base Menu, the Automatic Logout Timeout, whether or not to display the Station Number on the screen title, etc. Program This option will allow you to add, delete Information and edit Programs. Reports This option will allow you to print/display system-wide reports. User This option will allow you to edit Information information pertaining to Users. The operations performed here are identical to those in SysCon. Note that you cannot add or delete Users with this option, those functions must be performed in SysCon. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 7 Group Information Group Information Selecting Group Information will bring up a List Selection of Groups. The functions here duplicate those available in SysCon. From this list you may Add, Edit, Modify or Delete Groups. Group Selection List The Group Selection List has the following keys active: o Enter Edit the Group under selection bar. o Delete Delete Group under selection bar or delete all marked Groups. o Mark (F5) Mark/unmark Group under selection bar. o Modify (F3) Change the name of the Group under the selection bar. o Insert Create a new Group. Edit Group After you have selected a Group from the Group Selection List, the Edit Group menu is presented with the following options available: Full Name This option will allow to give the group a descriptive name. Group Members This option will allow you to add/delete users to/from this Group. Summary This option will allow you to display/print a summary of this group. Full Name The Full Name is only used to print reports. It has no impact on program operation. It does not need to be unique; i.e., two groups may have the same Full Name. The Full Name may consist of upper/lower case, spaces and punctuation. This is the same Full Name that may be manipulated with SysCon. Group Members The Group Members information is used in many ways, both by The Mnu and by Netware. This is the same Group Members that may be manipulated with SysCon. Summary The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 8 Summary will display/print a summary of the Group being edited. This Summary includes the Group's Full Name, Group Members and Trustee Assignments. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 9 Item Information Item Information Selecting Item Information will bring up a List Selection of Items. From this list you may Add, Edit, Modify or Delete Items. Item Selection List The Item Selection List has the following keys active: o Enter Edit the Item under selection bar. o Delete Delete Item under selection bar or delete all marked Items. o Mark (F5) Mark/unmark Item under selection bar. o Modify (F3) Change the name of the Item under selection bar. o Insert Create a new Item. Edit Item After you have selected an Item from the Item Selection List, the Edit Item menu is presented with the following options available: Authorized This option allows you to specify which Groups Groups are authorized to use this Item. Authorized This option allows you to specify which Users Users are authorized to use this Item. Default Drive This option allows you to specify a Default Drive letter for the Item to use as the default/current drive during execution. Description This options allows you to specify a Description for this Item. This Description is similar to Groups' & Users' Full Names. Drive Mapping This option allows you to specify the Drives that will be mapped when the Item executes. Execution This option allows you to specify an Method execution method for this item. There are several choices available, each with it's own strong points relating to memory overhead, license metering support, etc. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 10 Instructions This option allows to specify the Instructions that this Item will use when it executes. Menus Used In This option allows you to specify which Menus this Item will appear in. Prohibited This option allows you to specify which Groups Groups will be Prohibited from using this Item. Prohibited This option allows you to specify which Users Users will be Prohibited from using this Item. Program Used This option will allow you specify which Program this Item uses, if any. Summary This option will display/print a summary of this Item. Authorized Groups & Users The Authorized Groups & Users is used to determine if an item will appear on a user's menu. There are three ways a user may be authorized to use an Item: 1) The user is in the Authorized Users list. 2) The user is security equivalent to a User that is in the Authorized Users list. 3) The user is a member of a Group that is in the Authorized Groups list. Note that making a user security equivalent to another user does not transfer group membership (just like Netware Trustee Assignments). Also see Prohibited Groups & Users. Default Drive This option will allow you to select the drive letter of the default drive during execution. If a default drive is not specified, the user drive will be the default drive. Note that if the Item uses a Program that has a Default Drive specified, the Default Drive that you specify for the Item will override the Program's Default Drive. Description The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 11 This option allows you to specify a Description that will be used when the item appears on a menu. The default Description is the Item Name (as it appears in the Item Information List). The Description is similar to Full Names for Groups and Users. It may be any combination of upper/lower case, numbers, spaces and punctuation. It does not have to be unique (two items may have the same Description). In addition, this option allows you to specify a QuickSelect character. This character will appear highlighted on menus and may be used to move to the item with one keystroke. Note that this character must be specified in the same case (upper/lower) as it appears in the Description. Also, if the character appears more that once in the Description, the first occurrence will be used. Specify a space if you do not want a Quick Select character for this item. Drive Mapping This option will allow you to specify drive mapping for data drives. Note that Item Drive Mapping overrides Program Drive Mapping for any Drive Letters that are used in both the Item and Program. Execution Method This option allows you to specify the Execution Method for the Item. The following Execution Methods are available: Shell Very fast execution & return to menu, one line instructions only, relatively high memory overhead (75-150k), license control is available. Shell&Pause Same as Shell, except program pauses before it clears the screen and returns to the menu. Exec Fast execution & return to menu, multiple line instructions, low memory overhead (10k), license control is available. Exit Fast exit from the Menu to DOS. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 12 Batch Execution and return to menu is slower than other methods. License control is not available. This methods only purpose for existence is that there is no (0) memory overhead and so is suitable for loading/unloading TSR's and for running programs that won't tolerate even a 10k memory overhead. Batch & Exit Same as Batch except that the menu is not restarted after the item is done executing. The method is suitable for exiting to a local hard drive or starting another menu system (why would anyone would want to use anything but The Mnu?). Logout Same as Batch except that after the item is done executing, MNU$LOG.BAT is called to log the user out of the network. This is a table summarizing these methods: Shell Batch Method: Shell &Pause Exec Batch &Exit Exit Logout ----- ------ ---- ----- ----- ----- ------ Mem OverHead 75k 75k 10k 0k 0k N/A 0k Load TSR No No No Yes Yes N/A Yes License Ctrl Yes Yes Yes No No N/A No ExecSpeed Fast Fast Slow Slow Slow Fast Slow ReturnSpeed Fast Fast Fast Slow N/A N/A N/A Multi Instr No No Yes Yes Yes N/A Yes PauseOnReturn No Yes No No N/A N/A N/A Return to Mnu Yes Yes Yes Yes No No No Shell This method is well suited for executing interactive programs that do not need a lot of memory to run. This method yields the best turn-around speed since the Mnu does not need to be unloaded from memory, however it only executes one instruction line. If more than one instruction line is needed, use the Exec method. This method does provide license control. Shell & Pause This method is the same as Shell except that it pauses for a keystroke before that screen is cleared and the menu restarted. It well suited for use with non-interactive programs such as The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 13 ChkVol and Dir because it pauses and waits for the user to hit a key before overwriting the screen with the Mnu. Exec This method will be used for the great majority of items. It has a low memory overhead, license control and the return to the menu is almost instantaneous. It is slightly slower than the Shell methods because of the additional file i/o involved in multiple-line instructions and swapping the menu's memory space. It is much faster at returning to the menu than the Batch method because it does not have to reread all of the item and menu information from the file server. Batch This method is best for loading and unloading TSR's. The execution speed is similar to Exec but it's return to menu speed is greatly impacted, since all item and menu information must be reread from the file server. License control is NOT available with this method. This method may also be used for programs that will not tolerate the 10k memory overhead of the Exec method. Batch & Exit This method is the same as the Batch method except that the Mnu is not reloaded after execution. It may be used to transfer control to a local hard disk. Exit This method is used to provide an exit to dos capability for non- supervisor equivalent users when the Allow Escape to Dos is set to No. Note that supervisor-equivalent users may always escape from the base menu to dos, regardless of the setting of Allow Escape to Dos. Any item instructions are ignored. Logout This method is used to provide a logout capability for items. It is somewhat more flexible than the Novell Menu !Logout because it uses the MNU$LOG.BAT file to logout. This file may be modified to provide a continuous login loop, or display instructions about how to log back into the network. Also, MNU$LOG.BAT calls LOGOUT.EXE to actually log out, so the login statistics are displayed. ~ Instructions The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 14 This option will allow you to add,edit and delete the Instructions for this Item. Instructions may be straight text and may include instructions from other items. These instructions are normal DOS batch commands. User prompting for parameters may be done with same syntax as the Novell Menu -- put a '@' in the instruction, followed by the prompt in '"'s. For example, to do a copy: copy @"Source file spec" @"Destination file spec" The Instruction List has the following keys active: o Enter Edit the Instruction under selection bar. o Delete Delete Instruction under selection bar. o Insert Create a new Instruction. The new Instruction will be placed immediately before the Instruction under the selection bar. Menus Used In This option will allow you to specify which Menus this Item will appear on. You may also specify that this Item will appear on a Menu by using the Menu Structure in Menu Information. Prohibited Groups & Users The Prohibited Groups & Users is used in conjunction with Authorized Groups & Users to determine if an item will appear on a user's menu. For an item to appear on a user's menu, the user must first be authorized (see requirements in Authorized Groups & Users) and second, the user must NOT be prohibited. There are three ways a user may be prohibited to use an Item: 1) The user is in the Prohibited Users list. 2) The user is security equivalent to a User that is in the Prohibited Users list. 3) The user is a member of a Group that is in the Prohibited Groups list. Note that making a user security equivalent to another user does not transfer group membership (just like Netware Trustee Assignments). Program Used This option will allow you to specify which program will be used by this item. Specifying a program to be used will cause the program's search drives to be mapped when the item is executed. It also enables license control when the program has it enabled The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 15 and when a compatible execution method is used. In addition, the programs data drives and default drive are used. If the item and program have the same drive letter mapped, the item's mapping is used. Also, if the item has a default drive specified (not a space), the item's default drive is used. Summary Summary will display/print a summary of the Item being edited. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 16 Menu Information Menu Information Selecting Menu Information will bring up a List Selection of Menus. From this list you may Add, Edit, Modify or Delete Menus. The Menu Selection List has the following keys active: o Enter Edit the Menu under selection bar. o Delete Delete Menu under selection bar or delete all marked Menus. o Mark (F5) Mark/unmark Menu under selection bar. o Modify (F3) Change the name of the Menu under selection bar. o Insert Create a new Menu. Edit Menu After you have selected an Menu from the Menu Selection List, the Edit Menu menu is presented with the following options available: Authorized This option allows you to specify which Groups Groups are authorized to use this Menu. Authorized This option allows you to specify which Users Users are authorized to use this Menu. Description This options allows you to specify a Description for this Menu. This Description is similar to Groups' & Users' Full Names. Menus Used In This option allows you to specify which Menus this Menu will appear in. Menu Structure This option will allow you specify which Items/Menus will appear on this Menu. Prohibited This option allows you to specify which Groups Groups will be Prohibited from using this Menu. Prohibited This option allows you to specify which Users Users will be Prohibited from using this Menu. Screen Position This option will allow you specify where the Menu should appear on the screen. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 17 Summary This option will display/print a summary of this Menu. Authorized Groups & Users The Authorized Groups & Users is used to determine if a Menu will appear on a user's menu. There are three ways a user may be authorized to use an Menu: 1) The user is in the Authorized Users list. 2) The user is security equivalent to a User that is in the Authorized Users list. 3) The user is a member of a Group that is in the Authorized Groups list. Note that making a user security equivalent to another user does not transfer group membership (just like Netware Trustee Assignments). Also see Prohibited Groups & Users. Description This option allows you to specify a Description that will be used when the Menu appears on a menu. This Description will also be used as the Menu's title when it is displayed on the screen. The default Description is the Menu Name (as it appears in the Menu Information List). The Description is similar to Full Names for Groups and Users. It may be any combination of upper/lower case, numbers, spaces and punctuation. It does not have to be unique (two Menus may have the same Description). In addition, this option allows you to specify a QuickSelect character. This character will appear highlighted on menus and may be used to move to the Menu with one keystroke. Note that this character must be specified in the same case (upper/lower) as it appears in the Description. Also, if the character appears more that once in the Description, the first occurrence will be used. Specify a space if you do not want a Quick Select character for this Menu. Menu Structure This option will allow you to specify which Menus and Items will appear on this Menu. Menus Used In This option will allow you to specify which Menus this Item will appear on. You may also specify that this Item will appear on a Menu by using the Menu Structure in Menu Information. Prohibited Groups & Users The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 18 The Prohibited Groups & Users is used in conjunction with Authorized Groups & Users to determine if an Menu will appear on a user's menu. For an Menu to appear on a user's menu, the user must first be authorized (see requirements in Authorized Groups & Users) and second, the user must NOT be prohibited. There are three ways a user may be prohibited to use an Menu: 1) The user is in the Prohibited Users list. 2) The user is security equivalent to a User that is in the Prohibited Users list. 3) The user is a member of a Group that is in the Prohibited Groups list. Note that making a user security equivalent to another user does not transfer group membership (just like Netware Trustee Assignments). Screen Position This option will allow you to specify where the menu will appear on the screen. Both a Horizontal (Left,Center,Right) and a Vertical (Upper,Middle,Lower) position may be specified. The default is Middle,Center. The menu will be centered in the specified area of the screen. If the menu is too big to be centered in the given area, the position will be adjusted automatically. Summary Summary will display/print a summary of the Menu being edited. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 19 Other Information Other Information This option will allow you to edit global operation parameters for The Mnu. After selecting this option the following options will be presented: Allow Escape to This option selects whether or not DOS pressing Escape from the base menu will exit to DOS. Automatic If you wish to have an item execute when Logout Item the Automatic Logout Timeout expires, specify it here. If none is selected, the user will still be logged out. Automatic This option allows you to specify the Logout Timeout number of minutes of inactivity before the user is automatically logged out. Base Menu This option allows you to specify a Menu to be used as a system-wide Base Menu. Display Station This option allows you to specify whether Number or not to display the station number with the user name in the screen title area. Screen Saver This option allows you to specify the Timeout number of minutes of inactivity allowed before the screen is automatically blanked. Separate Menus This option allows you to specify whether from Items or not Menus are separated from Items when they are displayed on the screen. Summary The option displays/prints this information. Allow Escape to DOS This option will allow you to select whether or not to allow an exit to DOS by pressing Escape from the main menu. Note that Items with Execution Methods Exit or Batch & Exit will still exit to DOS after execution. Also, please note that SUPERVISOR equivalent users will always be able to escape to DOS from the Main Menu. Auto Logout Item The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 20 This option will allow you to select the Item to be used for Automatic Logout. If you select , the Automatic Logout will still function but no Item Instructions will be used. Please note that authorization checking is not performed for an Automatic Logout item. You must use Auto Logout Timeout to enable/disable the Automatic Logout. Auto Logout Timeout This option will allow you to select the Timeout for the Automatic Logout. Use a value of 0 to disable the Automatic Logout. The value is in minutes. The Automatic Logout is operational only when executing the menu, not while in MnuCon or MnuInst. Also, it is not operational while in an application program. Base Menu This option will allow you to select the Base Menu. This is the Menu that is used by the program as the "main menu". Please note that everyone should be authorized to use this Menu. Display Station Number This option will allow you to select whether or not to display the Station Number after the User Name in the Title Block on the top of the screen. The Station Number is the current setting of the DOS envvar MNU_STATION, which should be the Connection Number. Screen Saver Timeout This option will allow you to select the Timeout for the Automatic Screen Saver. Use a value of 0 to disable the Automatic Screen Saver. The value is in minutes. The Automatic Screen Saver is operational only when executing the menu, not while in MnuCon or MnuInst. Also, it is not operational while in an application program. Separate Menus from Items This option will allow you to select whether or not to separate Menu choices from Item choices when they are presented to the user. The separation consists of Sorting the Menus to the bottom of the list and inserting a separating line when the menu is presented to the user. Summary The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 21 This option will display/print a summary of the this info. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 22 Program Information Program Information Selecting Program Information will bring up a List Selection of Programs. From this list you may Add, Edit, Modify or Delete Programs. Program Selection List The Program Selection List has the following keys active: o Enter Edit the Program under selection bar. o Delete Delete Program under selection bar or delete all marked Programs. o Mark (F5) Mark/unmark Program under selection bar. o Modify (F3) Change the name of the Program under selection bar. o Insert Create a new Program. Edit Program After you have selected a Program from the Program Selection List, the Edit Program menu is presented with the following options available: Default Drive This option allows you to specify a Default Drive letter for Items that use this Program to use as the default/current drive during execution. Description This options allows you to specify a Description for this Program. This Description is similar to Groups' & Users' Full Names. Drive Mapping This option allows you to specify the Drives that will be mapped when Items that use this program execute. License This option allows you to specify how may Information license copies you own for this program. Search Path This option allows to specify the path where the executables for this program reside. The Search Path will be mapped when Items that use this Program execute. Summary This option will display/print a summary of this Program. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 23 Default Drive This option will allow you to select the drive letter of the default drive during execution. If a default drive is not specified, the user drive will be the default drive. Note that if an Item that uses this Program has a Default Drive specified, the Default Drive that is specified for the Item will override the Program's Default Drive. Description This option allows you to specify a Description for the Program. The default Description is the Program Name. Note that the Description for Programs is only used when printing reports and will never be seen on a user's menu (since only Items and Menus appear on user's menus). Drive Mapping This option will allow you to specify drive mapping for data drives. Note that Item Drive Mapping overrides Program Drive Mapping for any Drive Letters that are used in both the Item and Program. License Info This option will allow you to edit the License Information for the Program. The Number of Licenses sets the maximum number of users that may use the Program simultaneously. Note that if the Program is used from an Item with the Batch or Batch & Exit execution methods, the License Information will be ignored. Use 0 for an unlimited Number of Licenses. Search Path The search path specifies the location of the program files. This path will be mapped to a search drive (usually X:). Specify the full path including the volume name. Summary This option will display/print a summary of this Program. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 24 User Information User Information Selecting User Information will bring up a List Selection of Users. From this list you may Edit and Modify Users. These functions duplicate those available in SysCon. Note that you may not add or delete users, these functions must be performed in SysCon. Group Selection List The Group Selection List has the following keys active: o Enter Edit the Group under selection bar. o Delete Delete Group under selection bar or delete all marked Groups. o Mark (F5) Mark/unmark Group under selection bar. o Modify (F3) Change the name of the Group under the selection bar. o Insert Create a new Group. Edit Group After you have selected a User from the User Selection List, the Edit User menu is presented with the following options available: Full Name This option will allow to give the User a descriptive name. Groups Belonged This option will allow you to add/delete To groups that this User belongs to. Security This option will allow you to add/delete Equivalences Security Equivalences for this User. Summary This option will allow you to display/print a summary of this User. Full Name The Full Name is only used to print reports. It has no impact on program operation. It does not need to be unique; i.e., two users may have the same Full Name. The Full Name may consist of upper/lower case, spaces and punctuation. This is the same Full Name that may be manipulated with SysCon. Groups Belonged To The Group Belonged To information is used in many ways, both by The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 25 The Mnu and by Netware. This is the same Groups Belonged To that may be manipulated with SysCon. Security Equivalences The Security Equivalence information is used in many ways, both by The Mnu and by Netware. This is the same Security Equals information that may be manipulated with SysCon, except that you cannot manipulate Group security equivalences with MnuCon while you can with SysCon. However, MnuCon correctly maintains Group security equivalence while using this option and while using the Groups Belonged To option. Summary Summary will display/print a summary of the User being edited. This Summary includes the User's Full Name, Groups Belonged To, Security Equivalences, Login Script and Trustee Assignments. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 2 - Mnu Configuration Page 26 Reports Reports This option will allow you to edit display/print reports on the system-wide configuration. After selecting this option the following options will be presented: Complete System This option displays/prints a composite of Configuration the Menu Structure, Mnu Configuration and Netware Configuration reports. Menu Structure This option displays/prints a report illustrating the system-wide menu structure. Netware This option displays/prints a report of Configuration all the information relating to Netware (Users,Groups,Trustee Assignments,System Login Script). Complete System Configuration This option will display/print a composite of the Menu Structure, Mnu Configuration, and Netware Configuration reports. This report is complete enough to file as a paper backup of both your User/Group configuration and Mnu configuration. Menu Structure This option will display/print an illustration of the system- wide menu structure, without regard to Authorization/Prohibition. Mnu Configuration This option will display/print a complete report of The Mnu's information on your system. This report prints the equivalent of a Summary report for all Items/Menus/Programs and a Summary of Other Information. Netware Configuration This option will display/print a complete report of Netware's User/Group information on your system. This report also prints the System Login Script and all User Login Scripts. This report prints the equivalent of a Summary report for all Users and Groups. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 27 Chapter 3 - The Wadget Example ---------------------------------- Perhaps the best way to explain what The Mnu does is to use an example. We will use the infamous Wadgets International corporation. Appendix J contains the Complete System Configuration report for this example. Wadgets International has just installed a network in their office. A workstation is on every desk, including George's, the janitor. These are the employees: President Ken Verybery Sales Manager Ken Killum Sales Robert Realslick Yakov Wecandothat Secretarial Sara Sweetness Gloria Holley Controller Jay Justjoshin Accounting Mary Mixitup Production Mike Gleeful Manager Production Charles Chuckster Workers Andy Able Jerry Kindaslow Janitor George Geewhiz The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 28 The following applications will be used on the network: Make Em Fast The production workers will need to Make Em Fast production tracking use this program during the day to and management enter information on what they are doing. The program consists of two modules, FSTMAIN and FSTMGT. The production manager will need access to the management module to make sure the production workers are doing something. Wadgets has an unlimited site license for this program. Almost Balanced Obviously, the accounting department Almost Balanced accounting will need to use this program. Also, the sales staff will need access to the order entry portion of the program. The program consists of several modules: GL (General Ledger), PR (Payroll), AP (Accounts Payable), AR (Accounts Receivable), and OE (Order Entry). Also, this program has very high memory requirements and will not tolerate any memory overhead over the network shell (it barely handles the shell). Wadgets has an unlimited site license for this program. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 29 Count 143 Sales staff will need access to this Count 143 spreadsheet program so that they can run their football pool. Since this program costs $100,000.99 per copy, Wadgets could only afford to buy 2 copies. Words, Words, Words Everyone except the production Words, Words, Words wordprocessing workers will need to use this program. Wadgets has a site license for 5 users. Slow Blue The production manager will need this Slow Blue emulation for blue program to access the mainframe that mainframes controls the air conditioning in the production area. This program came with the Blue gateway and has an unlimited site license. However, the program will lock-up if more users than the gateway supports try to use it. The gateway currently supports one (1) user. TP Tracker The janitor will need to use this TP Tracker toilet paper program. Also, Jay Justjoshin will tracking and need to use it to make sure John ordering isn't ordering too much toilet paper and selling it for pocket money. This program comes free with each case of toilet paper. Wadgets currently has 553 copies. However, the program is a single-user program and will not allow multi-user access to the data files. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 30 The following users and groups have been created on the network: Users Groups ----------------------- ------------------------------ KV Ken Verybery SALES KK,YW,RR KK Ken Killum SECRETARIES SS,GH RR Robert Realslick ACCOUNTING JJ,MM YW Yakov Wecandothat PRODUCTION MG,CC,AA,JK SS Sara Sweetness MANAGEMENT KV,KK,JJ,MG GH Gloria Hollering JJ Jay Justjoshin MM Mary Mixitup MG Mike Gleeful CC Charles Chuckster AA Andy Able JK Jerry Kindaslow GG George Geewhiz The following directory structure has been created: SYS: --+-- SYSTEM +-- PUBLIC ----- IBM_PC --- MSDOS --- V3.30 +-- LOGIN +-- MNU_WORK +-- USERS --+-- KV | +-- KK | +-- RR | +-- YW | +-- SS | +-- GH | +-- JJ | +-- MM | +-- MG | +-- CC | +-- AA | +-- JK | +-- GG +-- DATA ---+-- TPTRACK | +-- MAKEFAST | +-- ALMSTBAL +-- APPS ---+-- MAKEFAST +-- ALMSTBAL +-- COUNT143 +-- WWW +-- SLOWBLUE +-- TPTRACK The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 31 The system login script is: * Remove any search maps or DOS Path SET PATH="" * Turn Map Display Off so we don't have to see unnecessary info MAP DISPLAY OFF * Map standard search drives and data drives MAP S1:=SYS:PUBLIC MAP S2:=SYS:PUBLIC\%OS\%OS_VERSION SET COMSPEC=S2:COMMAND.COM MAP F:=SYS:USERS\%LOGIN_NAME * Map Mnu work and search drives and set Env vars for the Mnu MAP INS S1:=SYS:APPS MAP W:=SYS:DATA\MNU_WORK DOS SET MNU_USER="F" DOS SET MNU_WORK="W" DOS SET MNU_SEARCH="X" DOS SET MNU_STATION=STATION Each Users login script is: * Exit to The Mnu EXIT "MNU" We have decided that sufficient program security will be provided by giving EVERYONE read-only (ROS) rights to the APPS subdirectory (SYS:APPS). If we wanted more security for individual programs, we would assign trustee rights to each of the program subdirectories under APPS. For data security, we have decided that security for each subdirectory under DATA should be provided. Therefore, using SysCon, we have created the following groups and assigned all but parental rights per the following: TP_TRACKER SYS:DATA\TPTRACK ALMOST_BALANCED SYS:DATA\ALMSTBAL MAKE_EM_FAST SYS:DATA\MAKEFAST Also, we have assigned group members as: TP_TRACKER JJ,GG ALMOST_BALANCED KK,YW,RR,JJ,MM MAKE_EM_FAST MG,CC,AA,JK The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 32 After installing The Mnu files and running MnuInst, we run MnuCon. First, we use the Menu Information option on the main menu to create a Menu to be used as the base menu: BASE_MENU Description Wadgets Int'l Main Menu Authorized Groups EVERYONE Then we use the Other Information option on the main menu and set: Allow Escape to DOS Yes Base Menu BASE_MENU Next, we use the Program Information option to create the following Programs: MAKE_EM_FAST Search Path SYS:APPS\MAKEFAST License Info Number of Licenses=0 Data Drives (Abs)G:=SYS:DATA\MAKEFAST Default Drive G ALMOST_BALANCED Search Path SYS:APPS\ALMSTBAL Data Drives (Abs)G:=SYS:DATA\ALMSTBAL Default Drive G License Info Number of Licenses=0 COUNT_143 Search Path SYS:APPS\COUNT143 License Info Number of Licenses=2 WWW Search Path SYS:APPS\WWW License Info Number of Licenses=5 SLOW_BLUE Search Path SYS:APPS\SLOWBLUE License Info Number of Licenses=0 TP_TRACK Search Path SYS:APPS\TPTRACK License Info Number of Licenses=1 Data Drives (Abs)G:=SYS:DATA\TPTRACK Default Drive G The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 33 Next, we use Item Information to create the following items: MAKE_EM_FAST_MAIN Authorized Groups PRODUCTION Instructions (Txt)FSTMAIN Program Used MAKE_EM_FAST Description Make Em Fast Execution Method Exec MAKE_EM_FAST_MGT Authorized Users MG Instructions (Txt)FSTMGT Program Used MAKE_EM_FAST Description Make Em Fast - Management Execution Method Exec ALMOST_BALANCED_GL Authorized Groups ACCOUNTING Instructions (Txt)GL Program Used ALMOST_BALANCED Description GL - General Ledger Execution Method Batch ALMOST_BALANCED_PR Authorized Groups ACCOUNTING Instructions (Txt)PR Program Used ALMOST_BALANCED Description PR - Payroll Execution Method Batch ALMOST_BALANCED_AP Authorized Groups ACCOUNTING Instructions (Txt)AP Program Used ALMOST_BALANCED Description AP - Accounts Payable Execution Method Batch ALMOST_BALANCED_AR Authorized Groups ACCOUNTING Instructions (Txt)AR Program Used ALMOST_BALANCED Description AR - Accounts Receivable Execution Method Batch The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 34 ALMOST_BALANCED_OE Authorized Groups ACCOUNTING, SALES Instructions (Txt)OE Program Used ALMOST_BALANCED Description OE - Order Entry Execution Method Batch COUNT_143 Authorized Groups SALES Instructions (Txt)COUNT Program Used COUNT_143 Description Count 143 Execution Method Exec WWW Authorized Groups MANAGEMENT, SECRETARIES, SALES, ACCOUNTING Instructions (Txt)WWW Data Drives (RelCre)F:=WWW Default Drive F Program Used WWW Description Words, Words, Words Execution Method Exec SLOW_BLUE_LOAD Authorized Users MG Instructions (Txt)SB Program Used SLOW_BLUE Description Slow Blue Load Execution Method Batch SLOW_BLUE_UNLOAD Authorized Users MG Instructions (Txt)SB -U Program Used SLOW_BLUE Description Slow Blue Unload Execution Method Batch TP_TRACKER Authorized Users GG, JJ Instructions (Txt)SB -U Program Used TP_TRACKER Description TP Tracker Execution Method Exec The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 35 After we have decided that all the items should appear on an Applications Menu, except for the Accounting programs, which should appear on a separate Accounting Menu, we use the Menu Information option and create the following menus: APPLICATIONS Description Applications Authorized Groups EVERYONE Menu Structure MAKE_EM_FAST_MAIN(Item) MAKE_EM_FAST_MGT(Item) COUNT_143(Item) WWW(Item) SLOW_BLUE_LOAD(Item) SLOW_BLUE_UNLOAD(Item) TP_TRACKER(Item) Menus Used In BASE_MENU ACCOUNTING Description Accounting Authorized Groups SALES, ACCOUNTING Menu Structure ALMOST_BALANCED_GL(Item) ALMOST_BALANCED_PR(Item) ALMOST_BALANCED_AP(Item) ALMOST_BALANCED_AR(Item) ALMOST_BALANCED_OE(Item) Menus Used In BASE_MENU This setup will result in the following menu structures: Ken Verybery: Wadgets Int'l Main Menu Applications Words, Words, Words Ken Killum: Wadgets Int'l Main Menu Accounting OE - Order Entry Applications Count 143 Words, Words, Words The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 36 Robert Realslick & Yakov Wecandothat: Wadgets Int'l Main Menu Accounting OE - Order Entry Applications Count 143 Words, Words, Words Sara Sweetness & Gloria Holley: Wadgets Int'l Main Menu Applications Words, Words, Words Jay Justjoshin: Wadgets Int'l Main Menu Accounting AP - Accounts Payable AR - Accounts Receivable GL - General Ledger OE - Order Entry PR - Payroll Applications TP Tracker Words, Words, Words Mary Mixitup: Wadgets Int'l Main Menu Accounting AP - Accounts Payable AR - Accounts Receivable GL - General Ledger OE - Order Entry PR - Payroll Applications Words, Words, Words The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 37 Mike Gleeful: Wadgets Int'l Main Menu Applications Make Em Fast Make Em Fast - Management Slow Blue Load Slow Blue Unload Words, Words, Words Charles Chuckster, Andy Able & Jerry Kindaslow: Wadgets Int'l Main Menu Applications Make Em Fast George Geewhiz: Wadgets Int'l Main Menu Applications TP Tracker Words, Words, Words The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Chapter 3 - The Wadget Example Page 38 After we turn the users loose, we soon have a few complaints: Ken Verybery - I need to use the Almost Balanced GL to get reports. Also, I think that Accounting and Management should be able to use Count 143. Sales staff - Why do I have to go back to the Accounting menu just to get to OE? It would be easier if we could get to OE from the Applications Menu. It's now 11:00 am and everyone is busy on the network. But wait, we don't need to get everyone off to make our changes! We load MnuCon. First, let's take care of Ken's GL. We use Item information and add KV as an authorized object for ALMOST_BALANCED_GL. Also, Ken will need access to the Accounting menu to get at the item, so we add KV as an Authorized User for menu ACCOUNTING. That's that, except we need to get Ken access to the accounting files. Anticipating future requests from other management for access to accounting, we use SysCon to make a trustee assignment for group MANAGEMENT in SYS:DATA\ALMSTBAL. Our job is saved! We intercom Ken and ask him to look at his menu. He turns on his machine and logs in --- there it is! OK, next we'll take care of Count 143. Still in MnuCon, we add MANAGEMENT and ACCOUNTING to the Authorized Groups for the COUNT_143 item. Now we'll take care of the Sales Staff -- we add APPLICATIONS to Menus Used In for the ALMOST_BALANCED_OE item. Mission accomplished! Note that this will make the Order Entry available on the Application menu for everyone. If this becomes a problem, we will remove SALES from the Authorized Groups for the ALMOST_BALANCED_OE item and for the ACCOUNTING menu. Then we would create an item: ALMOST_BALANCED_OE_SALES Authorized Groups SALES Instructions (Txt)OE Program Used ALMOST_BALANCED Description OE - Order Entry Execution Method Batch Menus Used In APPLICATIONS The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix A - License Agreement Page 39 Appendix A - License Agreement ---------------------------------- Software License Agreement The Mnu is not public domain software nor is it free software. The Mnu program and all accompanying documentation is Copyright (c) 1989 by Bonsai Technologies. All Rights Reserved. Non-registered users are granted a limited license to install and use The Mnu for a period not to exceed 21 days for the purpose of determining its suitability for their needs. Use of The Mnu by non-registered users, except for this purpose, is strictly prohibited. Registration grants the user a license to install and use the program on a single file server. There is no restriction on the number of workstations the program may be operated on simultaneously provided that the above restriction of a single file server is not violated. Registered users may make as many archival copies as deemed necessary. No user may modify The Mnu programs in any way, including, but not limited to, decompiling, disassembling or otherwise reverse engineering the programs. All users are granted a limited license to copy and distribute The Mnu to others subject to the following conditions: Those who receive the program are subject to all conditions of this license agreement. The program may not be represented as being "Free" or "Public Domain". The program must be distributed in unmodified form, complete with the file containing license information and full program documentation. No fee, charge or compensation may be accepted, given or requested except a nominal charge not to exceed $10 Anyone who copies and distributes this program must also comply with the above conditions. This includes, but is not limited to, Dealers, Consultants, Distributors and BBS Sysops. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix A - License Agreement Page 40 Warranty Disclaimer Bonsai Technologies hereby disclaims any and all warranties relating to The Mnu, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Bonsai Technologies will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Bonsai Technologies has been notified of the possibility of such damages. In no event shall Bonsai Technologies' liability for any damages ever exceed the price paid for the license to use The Mnu, regardless of the form of the claim. The person using The Mnu bears all risk as to the quality and performance of The Mnu. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 41 Appendix B - Registration Information ---------------------------------- Registration Shareware ------------------------- Shareware is method of marketing software that allows you, the user, to evaluate the software on your own system to determine whether or not it meets your needs before you make an investment. In addition, shareware allows authors to charge much less for their programs than their retail counterparts because there are little or no marketing expenses. Note that while both authors and users benefit from successful shareware, that success is entirely dependent on you. Your registration allows us to continue supporting and enhancing the program. The Mnu is a copyrighted program being marketed as shareware. It is NOT public domain nor "freeware". If you decide to use The Mnu after the 21-day evaluation period you are required to register. Continued use of The Mnu after the evaluation period is over is a violation of copyright law. Even if The Mnu does not meet all of your needs, you must register IF you continue to use the program after the 21-day evaluation period is over. Note that while you are legally required to register, in practice you are on your honor to register. Price Schedule ------------------------- Basic Registration $85 per server Update Mail Service $20/yr On registration, you will receive a perpetual license to use the programs on one file server. You will also receive the most current version of the program. You will be provided with a serial number and registration code to entered onto your system via MnuInst. Update/Upgrade Policies ------------------------- All updates are provided at no cost. Please note that an update is a minor revision (ex. X.24 to X.25) and will normally contain minor enhancements and bug fixes. All updates will be posted on CompuServe and Indiana On-Line (tm). Registered users who did not purchase the Update Mail Service will be notified via EasyPlex when an update becomes available. Those who purchase the Update Mail Service will have the update shipped to them automatically. Upgrades will be available for an additional fee. Please note The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 42 that an upgrade is a major revision (ex. 1.XX to 2.XX) and will contain major enhancements. Upgrade fees will be determined at the time that the upgrade becomes available. These policies and price schedule are current as of August 1, 1989. We reserve the right to change these policies and prices at any time. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 43 The Mnu Registration Form Name: ________________________________ Address: ________________________________ ________________________________ City,State,Zip: ________________________________ Telephone: Voice: (_____) _____ - ________ Fax: (_____) _____ - ______ CompuServe ID: _________,______ Licensee Name: ____________________________________________ *This should be your Company Name and will appear each time the program is executed. Current Version: ______ Where did you obtain your copy of the software? ___ CompuServe (NOVSOFT) ___ Indiana On-Line (tm) (INDIANA DIGITAL CORP.) ___ Bonsai Technologies ___ Another user ___ Dealer or Consultant: _______________________________ ___ Other: ______________________________________________ I hereby certify that I have read the License Agreement and Warranty Disclaimer and agree to the terms presented therein. Signature: ______________________________ Date: _________ Name: ________________________ Title: ________________________ Enclosed is a check or money order for: _X_ Basic Registration $85 ___ Update Mail Service $20 ___ Completed Survey Enclosed -$5 ========= Subtotal _______ MN Sales Tax(6%) _______ If applicable. ========= Total Enclosed _______ Send to: Bonsai Technologies PO Box 6296 Rochester, MN 55903-6296 Thank-you for your business! The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 44 Attention: Dealers and Consultants If you are a Dealer or a Consultant who would like to provide this program to your customers/clients, please contact us via Easyplex (73657,3203) for details about special registration, finders fees and other services. Note that while you may not charge (more than the nominal $10) for the program itself, you may (and should) charge for installation and maintenance. Attention: Shareware Distributors If you are a shareware distributor, please drop us a line and let us know your address and approximate distribution numbers. We will provide you with the mail update service free of charge. Please be advised that this program will ONLY work on a Novell Network and will be of no use whatsoever to stand-alone users. Please note that to comply with the license agreement you MUST: 1) distribute all documentation with the program 2) NOT charge more than a $10 fee for your services. 3) NOT represent the program as "Free" or "Public Domain" If your distribution results in a significant number of registrations, you will be eligible for a finders fee. Attention: BBS Sysops Please drop us a line and let us know your address and phone number. We will provide you with the mail update service free of charge. Please be advised that this program will ONLY work on a Novell Network and will be of no use whatsoever to stand-alone users. If your downloads result in a significant number of registrations, you will be eligible for a finders fee. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 45 Registration Survey 1) Network parameters: Novell Netware version: ___ ELS II v2.12 ___ ELS II v2.15 ___ Advanced v2.10 or 2.11 ___ Advanced v2.12 ___ Advanced v2.15 ___ SFT v2.10 or 2.11 ___ SFT v2.12 ___ SFT v2.15 ___ Other: ___________ Number of servers on network (whether The Mnu is on one or all) ___ One ___ More that One, number ____ Number of workstations: ______ Number of users: _______ 2) How long did you evaluate the program before registering it? ___ 10 days or less ___ 10 to 30 days ___ 30 days or more 3) What other menu systems have you used or considered? 4) What features do you find most important in The Mnu? The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix B - Registration Information Page 46 5) What features would you like to see in future versions of The Mnu? Also, please rate each as Very Important, Important, or Not Very Important. 6) Is the registration fee ___ Too high, should be: _____ ___ Too low, should be: _____ ___ About right 7) If this were a commercial program, how much would you be willing to pay for it? ___ $100 ___ $200 ___ $500 ___ $1000 8) Any other comments: Thank-you for your time. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix C - Program Support Page 47 Appendix C - Program Support ---------------------------------- Program Support Program support is available for both registered and non- registered users. Presently, the best way to get support is through EasyPlex on Compuserve or e-mail on Indiana On-Line (tm). Phone support is not available currently. Mail support is also available. Send your questions/concerns to: Mark Pfeifer Bonsai Technologies PO Box 6296 Rochester, MN 55903-6296 CIS ID: 73657, 3203 The Mnu now has another official support and distribution point: INDIANA ON-LINE (tm) Computer Bulletin Board - Bloomington, IN Phone: (812) 332-RBBS (data) 300/1200/2400/9600-bps (HST & V.32) Indiana On-Line (tm) is a service of Indiana Digital Corporation Enter J)oin command from Main menu and select the MNU subboard! The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix D - Hints Page 48 Appendix D - Hints ---------------------------------- A couple of hints when using The Mnu: Use of Groups: It has been my experience that operational groups are easier to manage than application groups; i.e., an operational group would be SALES, MANAGEMENT, etc. and an application group would be COUNT_143, WWW, etc. Part of the difficulty is that Novell only checks the first 32 objects in the SECURITY_EQUALS property to determine trustee rights. The other part is that if you have both types of groups, the number of groups becomes unwieldy when adding and deleting users and programs. Please note that this classification of groups as operational and application is purely contrived and not part of Novell. Trustee Rights: The Mnu does not make any provisions for trustee rights assignment; i.e., in the previous example, we had to use SysCon to assign the trustee rights for the accounting data. DOS Security: The Mnu is not an airtight shell over DOS -- if a user knows something about DOS, they can Ctrl-Break out of a Batch option and get at the DOS command line. If this is a large problem, let us know and we will consider implementing some safeguards. If you have sensitive files, use Novell's trustee rights to protect them. Execution Method: The Exec execution method is probably the best overall method. It provides very low memory overhead, reasonably fast execution speed and superb return to the menu speed. Also, it is easier on File Server usage than the Batch method because it does not reread the Menu/Item information when the item is finished executing The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 49 Appendix E - Technical Information ---------------------------------- Bindery Usage The Mnu uses the bindery to store all of its data and uses standard Novell function calls to manipulate and access the data. The object types used are outside of the range reserved by Novell. Specifically, the following object types are used: 8000h Control 8001h Menu 8002h Item 8003h Program Environment variables MNU_SEARCH Drive to use as program's search drive. Must be mapped as a search drive. (default X mapped as S1:) MNU_WORK Drive letter to use as work drive for menu. (default W) MNU_USER Drive letter to use as user drive for relative data drive maps. MNU_STATION Connection# of station MNU_VIDEO Controls snow checking and forces BW with color video adapter. CGA Snow & BW w/Color Video The Mnu automatically detects your video adapter. It will only do snow checking if it detects a CGA card, although you may override this with the MNU_VIDEO env var. It will automatically use color with a color-capable video adapter, again you can override this with the MNU_VIDEO env var. The only time you should need to use the MNU_VIDEO env var is with CGA cards, such as Compaq's and a composite monitor on a CGA. It should auto- detect mono/color with EGA and VGA. MNU_VIDEO=xyz x Color 1 to force BW (for use w/CGA w/ mono monitor, not needed otherwise) y Snow 1 to force no-snow checking (for use with CGA that do not need chk) z UseBios 1 to force BIOS video access. For all parameters any other character will cause default value to be used for that parameter. Also, any missing The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 50 values will cause the default to be used. If the MNU_VIDEO envvar is not present, defaults will be used. Example: A BW monitor on an IBM CGA SET MNU_VIDEO=11 Note that snow checking will be the default, but we specify it anyway. We could say, with the same results: SET MNU_VIDEO=1X Example: A CGA card that detects as a CGA but does not need snow chk SET MNU_VIDEO=X0 The following are the defaults, note that UseBios is always No: Snow Color MDA N N Monochrome Display Adapter(IBM) EGAMONO N N EGA w/Monochrome Monitor MCGAMONO N N MCGA w/Monochrome Monitor VGAMONO N N VGA w/Monochrome Monitor HGC N N Hercules Mono w/Monochrome Monitor HGCPLUS N N Hercules Mono Plus w/Monochrome Monitor INCOLOR N Y Hercules InColor w/Color Monitor CGA Y Y CGA w/Color Monitor EGA N Y EGA w/Color Monitor MCGA N Y MCGA w/Color Monitor VGA N Y VGA w/Color Monitor License Control License control is effected with semaphore locking, thus if the file server is downed or a station goes down, the license metering takes care of itself. Note that to use license metering you must use either the Shell or Exec execution methods (with their associated memory overheads). Work Files The Mnu Work directory is used to write temporary files during execution. The possible files are: MNU$GXXX.BAT batch file containing instructions for Exec and Batch methods. MNU$RXXX.RST file containing restart information to allow the mnu to return to the same menu & item after execution of an item. MNU$DXXX.MAP file containing information on the drive The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 51 mapping before an item was executed to allow restoration of the drive mapping. MNU$SXXX.SWP file containing swapped out application memory for Exec method. Note that XXX is replaced by the setting of MNU_STATION (usually the connection number). These file are deleted automatically by the mnu. Dos Versions Because The Mnu uses the DOS Batch command "call", it requires at least dos 3.3. It should function correctly with Dos 4.0, but it has not been tested yet (let me know if you've tried it!). Netware Versions The Mnu was designed for Netware v2.1x. It has been successfully tested with 2.10,2.11,2.12 and 2.15. It may run with 2.0a, but it has not been tested (again, let me know if you've tried it). Also, it has not been tested with NW 386 3.x, but it should run if Novell didn't change the API too much. Future versions WILL support NW 386 3.x fully, including the "fake root" capabilities. Multiple File Servers The Mnu will appropriately handle saving and restoring mapped drives when you are attached to multiple file servers. However, you may specify Search Paths or Drive Mappings only on the default file server. Future versions of The Mnu will fully support multiple file servers, for now, use MAP.EXE in your item instructions to map drives to other file servers. Item Execution The following is description of what happens during Item Execution, after an item is selected from the menu: Shell, Shell & Pause 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) set default drive 6) save screen in memory 7) clear screen and dump header (executing item:) 8) if pgm used has licenses>0, open and check semaphore, if license exceeded, abort execution. 9) shell to command.com, pass first line of The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 52 instructions as command line 10) if Shell&Pause, disp msg & wait for keystroke 11) unlock semaphore, if used. 11) restore screen from memory 12) restore default drive and drive mappings from memory 13) continue menu processing Exec: 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) Open MNU$Mxxx.MAP 6) Open MNU$Gxxx.BAT 7) write saved drive mapppings to MNU$Mxxx.MAP 8) write default drive change to MNU$Gxxx.BAT 9) write instruction to MNU$Gxxx.BAT 10) write saved default drive change to MNU$Gxxx.BAT 11) close MNU$Mxxx.MAP & MNU$Gxxx.BAT 12) save screen to memory 13) if pgm used has licenses>0, open and check semaphore, if license exceeded, abort execution. 14) clear screen and dump header (executing item:) 15) swap out application memory to MNU$Sxxx.SWP 16) shell to command.com, pass MNU$Gxxx.BAT as command line. 17) swap pgm memory in from MNU$Sxxx.SWP 18) delete MNU$Sxxx.SWP 19) unlock semaphore, if used. 20) restore screen from memory 21) restore drive mappings from memory 22) restore screen from memory 23) continue menu processing Batch: 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) Open MNU$Rxxx.RST 6) Write restart information to MNU$Rxxx.RST 7) close MNU$Rxxx.RST 8) Open MNU$Mxxx.MAP 9) write saved drive mapppings to MNU$Mxxx.MAP 10) close MNU$Mxxx.MAP 11) Open MNU$Gxxx.BAT 12) write default drive change to MNU$Gxxx.BAT 13) write instruction to MNU$Gxxx.BAT 14) write saved default drive change to MNU$Gxxx.BAT 15) close MNU$Gxxx.BAT The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 53 16) clear screen and dump header (executing item:) 17) exit with errorlevel 50 (MNU.BAT takes over now) 18) "call" MNU$Gxxx.BAT 19) execute MNU$MAIN.EXE 20) open MNU$Rxxx.RST 21) read restart info from MNU$Rxxx.RST 22) delete MNU$Rxxx.RST 23) open MNU$Mxxx.MAP 24) read saved drive mapping from MNU$Mxxx.MAP 25) close MNU$Mxxx.MAP 26) delete MNU$Mxxx.MAP 27) restore drive mappings 28) reread and realign using restart info 29) continue menu processing Batch&Exit: 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) Open MNU$Gxxx.BAT 6) write default drive change to MNU$Gxxx.BAT 7) write instruction to MNU$Gxxx.BAT 8) close MNU$Gxxx.BAT 9) clear screen and dump header (executing item:) 10) exit with errorlevel 50 (MNU.BAT takes over now) 11) "call" MNU$Gxxx.BAT 12) terminate batch file (MNU.BAT) Exit: 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) exit with errorlevel 50 (MNU.BAT takes over now) 6) terminate batch file (MNU.BAT) Logout: 1) Save current drive mappings in memory 2) Save current drive in memory 3) if pgm used, do search path and drive mappings. 4) do item drive mappings 5) Open MNU$Gxxx.BAT 6) write default drive change to MNU$Gxxx.BAT 7) write instruction to MNU$Gxxx.BAT 8) close MNU$Gxxx.BAT 9) clear screen and dump header (executing item:) 10) exit with errorlevel 40 (MNU.BAT takes over now) 11) "call" MNU$Gxxx.BAT 12) change to drive Z: (MNU.BAT) 13) change directory to \login 14) "chain" to MNU$LOG.BAT The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix E - Technical Information Page 54 The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix F - Cautions Page 55 Appendix F - Cautions ---------------------------------- Cautions on using The Mnu: Be aware that The Mnu uses the Novell bindery to store its information. The Mnu uses ONLY Novell documented API function calls to access the bindery, so bindery integrity is not an issue. The Mnu does manipulate some Novell defined objects, specifically, Users and Groups. Every effort has been made to assure that such manipulations are identical to those done by SysCon. It is for this reason that MnuCon will not add or delete Users -- there is just too much specialized info. The other implication of The Mnu's use of the bindery is that to backup your menu configuration you must back up the bindery. Use of third-party object types Use of third-party object types The menu uses object type 8000h through 8004h. These object type are specified by Novell for use by third party applications. If you are already using an application that uses these object types, do NOT use The Mnu -- contact us for further information. This should be a very rare occurrence, at present we are not aware of any other programs that use these object types. If you are not sure if you are using such an application, be sure you run BINDFIX before installing the Mnu (this step is included in the installation instructions, and should be done for prudence anyway). Then, if either The Mnu or your application do not operate correctly, simple run BINDREST to restore the bindery to its previous state. Also, MnuInst checks the bindery for third- party object types and warns you of their presence before making any changes to the bindery. Use of BINDFIX/BINDREST on an installed system Use of BINDFIX/BINDREST on an installed system The operation of BINDFIX and BINDREST are unaffected by the presence of absence menu information. Actually, because menu information is stored in the bindery according to Novell specifications, BINDFIX and BINDREST actually "understand" the menu information enough to handle it correctly. Bindery limit on objects and properties Bindery limit on objects and properties The bindery has a limit of approximately 65000 objects and properties, one a large install of 20 menus, 150 items and 50 programs, The Mnu will use approximately 1500 of these objects and properties. While this will not even come close to pushing The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix F - Cautions Page 56 the limit, you may see a small degradation in the performance of utilities such as SysCon. One other note regarding the evaluation period. As specified in the License Agreement, you may evaluate the product for 21 days. The Mnu records the date of installation (when Install the Mnu was run in MNUINST) and will print the number of days since it was been installed each time the program has been run (until it is registered. After the 21 day evaluation period has expired, the programs will print a warning message informing you that the evaluation period has expired. The programs WILL continue to work indefinitely, although you are still obligated to register. Note that you may DeInstall the program in or out of the evaluation period with MNUINST. Also, whenever you exit from MnuCon, you will be presented with information regarding the shareware status of the program and be asked if you would like to print a registration form. This screen and question are not presented after the program has been registered. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix G - Installation Page 57 Appendix G - Installation ---------------------------------- The Mnu Installation Instructions The Mnu including all of its program files and documentation is Copyright (c) 1989 by Bonsai Technologies. All rights reserved. Note: You MUST be running PC or MS DOS 3.3 to use The Mnu. Note: The Mnu was written for Netware v2.1x. It is known to operate correctly on 2.1x versions(2.10,2.11,2.12,2.15). It should also operate correctly on v2.0a -- however Bonsai Technologies has not verified this. Installation and Configuration of The Mnu is not a trivial task if you are not familiar with both DOS and Novell. If you are not familiar with both DOS and Novell, we recommend that you enlist the services of someone who is. 1) Read the file LICENSE.DOC and agree to the terms presented for non-registered users. 2) Login as SUPERVISOR or equivalent. 3) Copy MNUCON.EXE, MNU$HLP.HLP, MNU.BAT, MNU$EXEC.EXE, MNU$MAIN.EXE and MNUINST.EXE to SYS:PUBLIC. Flag these files as Shareable Read-Only. 4) Copy MNU$LOG.BAT to SYS:LOGIN and flag as Shareable Read-Only. Also, make sure the group EVERYONE has ROS rights to SYS:LOGIN. 5) Run BINDFIX in SYS:SYSTEM to backup the bindery files. This step is necessary to allow you to restore your system to its original state in the unlikely event that you are using another application that uses the same non-standard object types as The Mnu. 6) Create a work directory for The Mnu and give EVERYONE all rights except parental to it. We suggest that the work directory be SYS:MNU_WORK. 7) Modify the system login script. The Mnu must have a drive mapped out to its work directory. Also, the environment variables must be set if the defaults are not used. Here is a sample script: MAP F:=SYS:USERS\%LOGIN_NAME MAP S1:=SYS:PUBLIC The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix G - Installation Page 58 MAP S2:=SYS:PUBLIC\%MACHINE\%OS\%OS_VERSION MAP ins S1:=SYS:APPS MAP W:=SYS:MNU_WORK SET MNU_STATION=STATION * These values are defaults, but we'll set them * anyway. SET MNU_WORK="W" SET MNU_SEARCH="X" SET MNU_USER="F" See the Installation Reference section of the manual for more information. Please note the MNU_WORK environment variable must _always_ be set. Also note that the syntax given is correct for Novell login scripts, if you are setting the env vars from a batch file, omit the "s (SET MNU_WORK=W). 8) Run MNUINST and select Install The Mnu. 9) Run MNUCON. a) Use Menu Information to create a base menu. We suggest that you name it BASE_MENU, put in your company name as the Description and make EVERYONE an Authorized Object. b) Use Other Information to set options. Set Base Menu to the menu created in #7(BASE_MENU). Set the Allow User Authorization and Allow Escape to DOS as desired. See the Other Information section of the manual for more information on these options. c) Create a Logout item: use Item Information to create an item named LOGOUT per the following: Description Logout Authorized Groups EVERYONE Menus Used In BASE_MENU Execution Method Logout 10) The Mnu is now useable. If you wish users to load the menu automatically when they login, put the command EXIT "MNU" in each user's login script. 11) You may now create your full menu structure with MnuCon. Please note that you must be SUPERVISOR or equivalent to run MnuCon. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix H - Future Enhancements Page 59 Appendix H - Future Enhancements ---------------------------------- The Mnu is continually evolving. The following is a list of possible enhancements for future versions. If any of these appeal to you, please let me know. Also, let me know if you have any specific ideas of how you would prefer to see these implemented. Automatic printer selection/capture. Automatic hardware detection (video,mouse etc) for programs! Monitoring utility. Import/Export of menu structures. Usage logging. Elimination of the MNU_xxx environment variables Elimination of need for pre-done drive mappings for MNU_WORK, MNU_SEARCH and MNU_USER. Color choices avail globally and by menu. Definable help for menus/items. A version for use on stand-alone machines. We appreciate any comments and suggestions, especially those regarding features you would like to see in The Mnu. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix I - Version History Page 60 Appendix I - Version History ---------------------------------- 14Dec89 v1.26 Time-limit has been removed. Programs will now work indefinitely. Previous versions would cease functioning 75 days after installation if not registered (this fact was present in the documentation and presented on the sign-on screen). 01Nov89 v1.25 Bugs fixed: MNU$EXEC.EXE would crash if a large dos environment was present. MNU$EXEC.EXE has been eliminated and the current method for Exec handles environments of any size (tho a large environment will increase the memory overhead). When executing a submenu, the selection bar stayed visible on the parent menu. v1.25 highlights the submenu choice on the parent menu, leaving the selection bar visible only on the current menu. Snow checking for CGA. v1.24 never did any snow checking, no matter what. v1.25 now does snow checking with CGA, although this may be overridden with the MNU_VIDEO env var. v1.24 would always use color with a color-capable video adapter. This would cause problems with CGA & composite monitors and with Compaq's. The use of color may be overridden the MNU_VIDEO env var. v1.24 was time limited to approx 70 days, however this fact was never explicitly stated in the docs. Also, no warning was given when your evaluation period was about to expire. v1.25 displays how many days into the evaluation period you are and also counts down the last 15 days of program operation after the evaluation period has expired. New Features Connection Number is optionally displayed in title block. Menus may now (optionally) be separated from Items when displayed. Logout Item - executes instructions before ending with MNU$LOG.BAT The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix I - Version History Page 61 Exec Item - no longer uses MNU$EXEC, decreases memory requirements to about 10k Screen-Saver and Automatic Logout available Instructions may prompt for user input Drive mappings are saved/restored correctly with multiple file servers. Note that you CANNOT specify Drive Mappings and Search Paths on other file servers. You must use the novell MAP command in the Instructions to map a drive to a file server other than the default. Novell Users and Groups may be manipulated while in MnuCon. Instruction Edit window is larger so that long lines may be read directly. Reports menu is new. Summary options have been rewritten and now include complete info. Programs now know which items they are used in (used in reporting only). A screen location may be specified for menus. 12Sep89 v1.24 First shareware release of The Mnu! Also see the file VERSION.TXT for information regarding revison levels for each program. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix J - System Config Report Page 62 Appendix J - System Config Report ---------------------------------- See the file APPNDX_J.TXT for the System Configuration Report. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved. Appendix K - Upgrade Instructions Page 63 Appendix K - Upgrade Instructions ---------------------------------- General upgrade instructions 1) Backup the bindery (just in case). 2) Copy the new program files into SYS:PUBLIC, this will include MNU$MAIN.EXE, MNU.BAT, MNUCON.EXE, MNUINST.EXE and MNU$HLP.HLP. Also, copy MNU$LOG.BAT into SYS:LOGIN. 3) Run MnuInst and select the Upgrade option. 4) Everything will now work as it did before (or better!), take a look at the Version History appendix in the manual to see what's new! Note that it is NOT necessary to have the users log-off while an upgrade is performed. However, be aware that it is possible for an old version program to become somewhat confused when there is a new version data. At worst, this will cause an error for a user executing a menu. Logging out an back in will cure any difficulties that might occure. Note that there is NO possiblity of such problems affecting users who are in application programs, although they may encounter difficulties when the menu tries to reload AFTER the application is finished. Extra Note for those upgrading from The Mnu v1.24 The Mnu v1.24 used an extra program (MNU$EXEC.EXE) for use with Exec method Items. This program is obsolete beginning with v1.25. While leaving the program in PUBLIC will not cause any problems, it is no longer used and may be deleted. The Mnu v1.26 Copyright 1989 Bonsai Technologies. All rights reserved.