Software Release Notice Application Management Utility (AMU) Version 02.06.01 Part Number 195-147A/B/C April 21, 1999 001185 VS Application Management Utility (AMU) SRN Page 1 Release 2.06.01 -- April 1999 TABLE OF CONTENTS Section Page 1.0 Release Abstract . . . . . . . . . . . . . . . . 3 2.0 Prerequisites 2.1 Hardware . . . . . . . . . . . . . . . . . . 3 2.2 Software . . . . . . . . . . . . . . . . . . 3 3.0 Restrictions and Special Considerations . . . . . 3 4.0 Documentation Corrections . . . . . . . . . . . . 4 5.0 Enhancements and Changes . . . . . . . . . . . . 4 6.0 Problems Corrected . . . . . . . . . . . . . . . 5 7.0 Special Conditions . . . . . . . . . . . . . . . 5 8.0 Media Contents . . . . . . . . . . . . . . . . . 6 9.0 Software Installation . . . . . . . . . . . . . . 6 Page 2 VS Application Management Utility (AMU) SRN Release 2.06.01 -- April 1999 1.0 Release Abstract The Application Management Utility (AMU) is a menu presentation service designed to provide maximum flexibility and security for end user applications. The software consists of several runtime modules which can either be called by an application program or run directly, as well as a maintenance module to maintain the Menu Definitions, the Function Key Definitions, and the User Definition Records. This is a general release providing Year 2000 (and beyond) support. It is a complete release of AMU which incorporates all maintenance releases since general release 02.05.00. 2.0 Prerequisites 2.1 Hardware 1. None 2.2 Software 1. None 3.0 Restrictions and Special Considerations 1. If running prior to release 06.30.00 of the operating system, the Function Key Definitions and the User Definitions can not be assigned to the same physical file as the Menu Definitions. 2. The runtime software open its definition files in Special Input mode if running under a version of the operating system which supports Special Input. If not, the software opens its definition files Shared. The Special I/O Mode option for the SHARER in the VS Configuration File must be set to YES to allow concurrent access to a file by the Maintenance program and the Runtime modules. 3. The ITM port created by the AMU Runtime software has a buffer size of 2014 bytes. Some customers have experienced GETMEM exhaustion if they have a large number of users running AMU. The AMU software can be patched to create a smaller buffer. The files that need to be patched are AMU, AMULINK and AMUROOT. For the files AMU and AMUROOT, to locate the data to be patched, perform a hex search for the hex string '010025AE07DE'. This hex string should occur once and only once. In the file AMU, this should be found in block (not record) 57 - offset 1905. In the file AMUROOT, this should be found in block 53 - offset 1197. The hex value '07DE' at the end of this string is the Port Size as a two byte binary number. This can be patched to any value between hex '0050' (decimal 80) and '07DE' (decimal 2014). VS Application Management Utility (AMU) SRN Page 3 Release 2.06.01 -- April 1999 For the file AMULINK, to locate the data to be patched, perform a hex search for the hex string '010000E207DE'. This hex string should occur once and only once. It should be found in block 12 - offset 141. The hex value '07DE' at the end of this string is the Port Size as a two byte binary number. This can be patched to any value between hex '0050' (decimal 80) and '07DE' (decimal 2014). 4.0 Corrections to Documentation The following errors or omissions have been discovered in the VS Application Management Utility (AMU) User's Reference manual - 2nd edition (715-0246A). o In Table 2-2 on page 2-24, the token "[---NAME-OF-USER---]" should be listed as "[-----NAME-OF-USER-----]". o On page 2-26, the fourth sentence of the first paragraph should read "The size of the two Instruction Window sets must be the same, ....." rather than "The size of the two Instruction windows within a set must be the same, .....". o The first line on page 5-12 should begin "U (Unlink) ..." instead of "R (Unlink) ...". o In Table H-1 on page H-15, the size of the field AMU-RUP-FLV should be listed as "22" instead of "20". o In Table H-1 on page H-17, the description of the field AMU-TIMEOUT-ACTION should indicate that blank (spaces) is also a valid value for the field, indicating that the driver program does not require any control of the Inactivity Timeout condition and the entire process is to be controlled by AMUROOT. The description should also note the restriction that the I or P options must not result in an Unlink of AMUROOT occurring. 5.0 Enhancements and Changes since Release 02.05.00 o The software has support for a special 'patch' which can be field applied that will allow the global Function Keys (Record Key @@@) to be active on PF Key style menus. The patch itself is not included with this release. It is available from AMU or Wang OFFICE PP&M. o With release 02.05.04, the software now allows specification of the Security Class and Special Link Processing fields on Function Key definitions. The Security Class field is identified by a column heading of 'S/C'. Valid values for the field are blank, the letters A to Z, and the pound sign (#) character. A complete description of the Security Class field can be found on page 5-10 of the VS Application Management Utility (AMU) User's Reference manual (715-0246A). Page 4 VS Application Management Utility (AMU) SRN Release 2.06.01 -- April 1999 The Special Link Processing field is identified by a column heading of 'SLP'. Valid values for the field are N (None), R (Restricted), U (Unlink) and blank (Default). If the field is left blank, the default value taken is specified by the driver program which has invoked AMUROOT. With the AMU driver, the default value is N (None). With the AMULINK driver, the default value is U (Unlink). For a complete description of the N, R, and U options, refer to page 5-11 of the VS Application Management Utility (AMU) User's Reference manual (715-0246A). No conversion is required for files created prior to release 02.05.04. Both fields default to a value of blank. 6.0 Problems Corrected since Release 02.05.00 6.1 Problems Corrected in Release 02.05.02 o PTR Number P210000468 If a User Definition Record caused the help key to be disabled, an attempt to update time on a menu or display an ITM message resulted in a cancel condition within the VSSUBS routine MESSAGE. The software has been linked with version 6.40.09 of MESSAGE, which corrects this problem. 6.2 Problems Corrected in Release 02.05.03 o Release 02.05.01 of AMU contained support for a 'patch' to allow Global PF Keys to be active on PF Key style menus. The check for duplicate PF Key definitions was checking the Global PF Keys record, even if the patch had not been activated. The software has been corrected to perform this check only if the patch has been activated. 6.3 Problems Corrected in Release 02.06.01 o Release 02.06.01 of AMU contains fixes necessary for correct operation in the 21st Century. Note that this does not include changes to the display format of dates within menus. The original design intention was for a two digit year and this has been retained. 7.0 Special Conditions o Date support changes include adding the Century prefix to the primary key of the Logfile. This extends the size of the logfile by two characters. The Key format was originally a 6 character date (YYMMDD) concatenated with a time stamp. This is now a 8 character date (CCYYMMDD) concatenated with the time stamp. Consequent changes have been made to the AMUCTL control file. Users who have external applications which access the logfile will need to update their applications to reflect this change. VS Application Management Utility (AMU) SRN Page 5 Release 2.06.01 -- April 1999 8.0 Media Contents Library = @SYSTEM@ Blocks File Version Class Allocated Description @AMUDEF 02.06.01 $ 3 AMU Installation Defaults File AMU 02.06.01 @ 73 AMU Runtime Call Driver Program AMUCTL none $ 3 Control File definition of the AMU Logging File AMUEDIT 02.06.01 @ 102 AMU Maintenance Program AMUERRS 02.06.01 $ 9 AMU Error Messages File AMULINK 02.06.01 @ 15 AMU Runtime Link Driver Program AMUROOT 02.06.01 $ 66 AMU Runtime Root Program Library = @DOCLIB@ Blocks File Version Class Allocated Description AMUHELP 02.06.00 $ 239 AMU Help Text Library = CSRNLIB Blocks File Version Class Allocated Description AMU20601 02.06.01 7 AMU Release Notice print file 9.0 Software Installation 1. Because AMU may be accessed by several applications, it is recommended that the software be stored in the system library. However, the software can be stored in any library or volume. 2. Run the BACKUP program to restore the software from the installation media to the desired library and volume. To install the software in the system library, run BACKUP and do a volume restore from the installation volume to the system volume. To install the AMU software on a volume other than the system volume or to change the library name for the AMU software, run BACKUP twice, doing a library restore of @DOCLIB@ to @DOCLIB@ on the system volume and a library restore of @SYSTEM@ to the desired library on the desired volume. 3. Run INFO, selecting Topic Utilities to regenerate the Topic Directory. 4. Users upgrading from a prior version of AMU, who also use the log function, will need to rename their current log file. The logfile used with AMU 2.06.01 has a 64 character record length whereas previous versions used a 62 character record length file (refer to Special Conditions). If the 62 character record length logfile remains in place then logging will cease to function. Page 6 VS Application Management Utility (AMU) SRN Release 2.06.01 -- April 1999