iMenu Files

===============================================================================

iMenu - A data-driven menu utility for the IBM i.

===============================================================================


Please submit any issues or requests via:
   https://sourceforge.net/p/i-menu/tickets/


================================================================================
Installation Instructions
================================================================================
- Create library IMENU.
- Upload all source files and members from the zip file.
- Compile the installation script program INSTALL from source file INSTALL
  into the library.
- Run the command to build the utility:
    CALL IMENU/INSTALL PARM('IMENU')



================================================================================
Change Log
================================================================================
2.1.7     07/11/2025
* FIX: Corrected the INSTALL script so that it will compile without having to
       compile the BUILD command manually first.
* FIX: Corrected the copy book reference in LSMNTRR so it will compile!

================================================================================
2.1.6     27/10/2025
* NEW: Added 'R=References' option to IWRKMNUF screen as a short-cut to filter
       the list of menus to those which reference the selected menu.
* NEW: Added Help Text support to link into an existing application's help text
       system using exit program LSEXGETHLP.
* NEW: Created an install script requiring the compilation and running of just
       one CL program to create the entire tool.

================================================================================
2.1.5     01/06/2023
* NEW: Added object type of 'PCO' (PC Object) to allow the menu to launch PC
       programs such as CHROME, WINWORD, EXCEL, NOTEPAD, etc.
       Also increased the length of the parameters field from 132 to 212 to
       cater for long parameters such as URLs.
* NEW: Allow the copying of the current menu using the shortcut code '*C'.
* NEW: Allow the editing of the current menu file using the shortcut code '*F'.
* NEW: Allow the viewing of the menu tree using the shortcut code '*T'.
* NEW: Added an option to edit the new menu after copying.
* NEW: When editing a menu, the menu can now be displayed in full screen mode.
* NEW: IWRKMNUF now shows the number of references for each menu.
* NEW: Deleting a menu via IWRKMNUF now provides the option to remove redundant
       references to the menu to be deleted.
* NEW: Added new parameter DSPASUSR to the IGO command which displays the menus
       as a specific user would see them.  This provides the ability to test how
       a suite of menus would operate for that user.
* FIX: HHT and Wrist scanner menus now display F10 for previous screen instead
       of F12.
* FIX: HHT and Wrist Scanner menus now adhere to ALWEXT parameter on the IGO
       command.
* FIX: Using F4 to prompt the editing of a menu option now works on all versions
       of the menu editing screen.

================================================================================
2.1.4     24/12/2022
* NEW: Menus now have an exit option which can be run when exiting the menu.
* NEW: When editing Handheld Terminal (HHT) or Wrist Scanner (WRS) menus, the
       edit screen is now laid out as per the relevant screen type.
* NEW: When editing menus, if an option leading to another menu has the menu
       file left blank, it will default to *CURRENT instead of IMMNUFIL, meaning
  that the menu should be located in the current menu file.
* FIX: If a menu option leads to an inactive menu, the option is also treated as
       being inactive.
* FIX: Add product library back into the library list after executing either the
       entry or exit options.
* FIX: When editing the current menu using the *M shortcut, upon exiting the
       edit screen, sometimes the menu displayed was not the one being edited.
================================================================================
2.1.3     19/09/2022
* NEW: When editing the current menu using the *M shortcut, the menu is now
       refreshed upon exit of the maintenance screen to show any changes.
* NEW: Taking a menu option which leads to a non-existent menu will now load
       into the IEDTMNU command for the missing menu providing that:
       - The user is not LMTCPB(YES).
       - The user is authorised to the IEDTMNU command.
       - The current menu is a 1-column or 2-column menu.
* NEW: IWRKMNUFIL now checks the user's authority to the menu file, and
       disables all editing options if they have insufficient data rights.
* NEW: IEDTMNU command now checks the user's authority to the menu file, and
       produces an error if the user has insufficient data rights.
* FIX: Options requiring a confirmation prompt no longer result in a blank
       screen, and any value other than 'Y' will stop the action.
* FIX: Exiting a new menu without making any changes no longer prompts for the
       new menu to be saved.
* FIX: ICRTMNUF command was failing when compiled on some machines.

================================================================================
2.1.2     01/08/2022
* NEW: When a menu is loaded, options leading to other menus are now checked to
       see if the destination menu actually exists, and the appropriate
       attributes are used if they don't exist.
* NEW: Duplicate menu options are now renumbered instead of forcing the menu
       system to exit.
* FIX: Prompting a command for a menu option now uses QCMDCHK API instead of the
       old QCACHECK API.
* FIX: F9 to retrive previous commands now uses a different method to do so, and
       is much quicker.
* FIX: The Status for new menus and options is now set to Active by default.
* FIX: Menus files created with ICRTMNUF now have their correct column headings.

================================================================================
2.1.1     05/06/2022
* FIX: Prompting a command with fewer than 3 characters was causing a crash.
* FIX: 2-Column menus not using full-screen mode was causing a crash.

================================================================================
2.1.0     30/04/2022
* NEW: Menus and Options can now be made inactive rather than having to delete
       them.  A new parameter on the IGO command is used to determine how to
       treat inactive options visually (Blanks, HIDE or Error).
* NEW: Added a 'full screen' option (valid only for 1CL and 2CL menus) which
       adds an additional 3 lines to the available menu options.
* NEW: Users with LMTCPB(*YES) are prohibited from using commands or a command
       line by default.
* NEW: Menus and menu options now have a Status setting (Active/Inactive) and
       the IGO command has an option to dictate how to treat inactive options.
* FIX: Prompting for command on the menu entry now works.
* FIX: Prompting for command on an option entry no longer generates an error
       message.
* FIX: Improved the F9 retrieval and F4 prompting of commands on the command
       line.
* FIX: Entering anything other than 'X' against the Menu Title row in IEDTMNU
       was causing a crash.

================================================================================
2.0.0     08/08/2021     Initial public release of re-worked version in free-
                         form RPG and SQL database.

================================================================================
1.0.0     ??/09/1990     Initial version in RPGIII.
================================================================================