OMI, PROGRAMMING, A feature rich and well documented menu development tool OMI v2.3 - ©1997-2004, Oscar van Eijk, support@oveas.com ======================================================== Oscar's Menu Interface is a DCL procedure that reads menu files and represents the menu structure on a ChUI based window. OMI does not perform any actions on its own. Additional procedures are required to handle upon the users input. OMI is strictly created to create a standard user interface for all kinds of actions, with a clear structure, support for different security levels and password protection. The additional procedures that are required for any actions are referred to 'callable jobs'. A section in the help file describes how several commands, defined in OMI, can be used to create such procedures. Documentation and support ------------------------- Full documentation for OMI can be found (PostScript or PDF) or viewed online (HTML) at the OMI site: http://freeware.oveas.com/omi. An online HELP is also provided, but since v2.0 the printable documentation is completely reviewed. This has not (yet?) been done with the online HELP, except for the interactive OMI command section. This site also offers a forum (http://freeware.oveas.com/omi/forum.html) where you can get support. Please note OMI comes without any warranty, but I'll try to give as much support as possible via this forum. New in this version ------------------- * Added keywords DCLERRORS and DCLFATALS to the /IGNORE qualifier * The keyword BLANKS in STRING formatting type is now deprecated, it's replaced by COLLAPSE * Added the keyword ALFANUM in the STRING formatting type * Made the answers 'Yes' and 'No' configurable using the values ANSWER_YES and ANSWER_NO in the [QUESTIONS] section of the configuration file. NOTES: - The default answer when using OMI$CONFIRM should be changed in your applications from "Y" to 'QUESTIONS$ANSWER_YES' and from "N" to 'QUESTIONS$ANSWER_NO' is you want to change the values in the configuration file as well. - The message %OMI-W-IVANS now requires 2 parameters. If you use this message in your software, you will need to change it to: OMI$SIGNAL OMI IVANS,QUESTIONS$ANSWER_YES,QUESTIONS$ANSWER_NO Refer to the documentation for more information. * Bugfix the last page when scrolling select lists * Bugfix in the INFO command * Added the commands CLS and OMI$CLEAR_SCREEN * Added the option NOWAIT to the OMI$POPUP command * Bugfix in reading TAG- and SELect lists from a file; files where not found when they located in the OMI$MENU_DIRECTORY searchpath, but not in the first index. This is because the VMS lexical F$PARSE() expands to the first index only. * Allow submenus on-the-fly menus. * Added the error messages OUTOFRA and PROOUTRA that signals when an intermediate value in the calculater is or might be out of range. This prevents random result when a temporary value exceeds the DCL limit (2,147,483,647) Installation instructions ------------------------- To install OMI, download one of the distributions: either the ZIP file (download in BINary format) or the COM file (download in ASCII format). Also, download OMI$INSTALL.COM in ASCII format. Next, set default to the directory where the installation script is located, and issue the command: $ @OMI$INSTALL Follow the instruction to install OMI. The procedure extracts the distribution and moves all files to the desired location (that you will be prompted for). Site specific files will not be overwritten. If the file OMI$TOOLBOX.INI exists, it will be patched. The installation procedure also creates the HELP library, and repairs message datafiles, which have been corrupted by the distribution. If this is a new installtion, let all the users who will be using OMI execute the procedure OMI$USER_INSTALL once. This is not required for upgrades of existing OMI installations. Installation is now complete. All users can optionally change the behaviour of OMI by modifying the file OMI$MENU.CFG, located in their SYS$LOGIN:. To test OMI, you can use the example menu file OMI$EXAMPLE.MNU which comes with this distribution. Start this menu with the command OMI OMI$EXAMPLE. This menu performs no other action than displaying information. The 'Protected menu' is protected with the password "test123456789". (Note: passwords are case sensitive!) More information can be obtained from the online HELP and the documentation.