Date: 11-17-2006 Subject: Patch RELEASE 9.1C Runtime Files These release notes pertain to the following programs: SUNFM.EXE 9.1C 17 Nov 2006 9,1,3,0 SUNWSRV.DLL 9.1C 17 Nov 2006 9,1,3,0 *============================================================================== The following files have been changed as follows: ------------------------------------------------------------------------------- SUNFM - Added the new log entries to clarify 10057 errors that are forced by SUNFM file manager. "Soft shutdown of child when switching to Primary!" "Quit action detected!" "Admin forced shutdown!" - Modified the client runtimes to send the client user serial number to the SUNFM file manager. When the SUNFM file manager sets the ADMIN_LOGLEVEL to 2, then the client serial number is logged in the SUNFM log file when the SUNFM child task starts. If a client runtime version older than 9.1C is being used, then the logged serial number is zero. - Added a new keyword named 'ADMIN_SHELLICON={on|off}' for the file manager. When this keyword is turned on, then the SUNFM Icon is inserted into the Windows taskbar Icon Tray area. If a user executes a right-click on the SUNFM Icon, then the user can select a menu option to display SUNFM statistics or the user can select a menu option to terminate the SUNFM file manager. - Corrected a GPF error that occurred in the ADMIN support thread. This GPF error was occurring when the ADMGETINFO was used to retrieve the SUNFM log data. - Corrected a GPF error that could occur while using TRANSACTION operations. The cause for the GPF error depended on the sequence of file IO instructions and the location of data in the files being written. The nature of the causes for the problem makes the problem unpredictable. ------------------------------------------------------------------------------- SUNFM - Corrected a problem for the threaded version of SUNFM for Unix (Unix) where all of the threads were using the same GPF error routine. This change causes each SUNFM thread to execute a crash handler routine that is specialized for the thread being executed. Please notice that this change only affects the server execution when an abnormal situation is occurs that causes a premature termination of a SUNFM thread. - Made a change to prevent a possible SEGV error that might occur in a child thread when a forced shutdown is executed. - Corrected a problem where an I80 was being reported to the user application instead of an I10 error when opening a file for the first time via SUNFM. This problem could occur when the file was already opened directly (not through SUNFM) by a PLB runtime. This problem only occurred when the SUNFM file manager was opening files in an open once mode. ------------------------------------------------------------------------------- SUNFM REPLICATION SUPPORT - There is a keyword named PUBLIC that can be placed in the [replication] section of the SUNFM file manager. This keyword identifies a public encryption key that is used to encrypt all data that is transmitted between the primary, backup, and secondary file managers. Format: PUBLIC={publickey} Where: {publickey} - This parameter must be specified as a hexadecimal data string. Otherwise, a default public key is used. Example: [replication] PUBLIC=be8245 Note: 1. If the PUBLIC encryption key is not specified, a default key is used. All transmissions are encrypted and secured using the default key in this case. 2. If this public key changes for any reason, all replicators accessing the primary file manager must use the new public key. Otherwise, the replicators can not log on to the primary file manager. - The Secondary/Backup Sunfm replicator systems have been modified to allow all data written on the Secondary/Backup side to be grouped as determined by FILEPI usage. By default, this feature is turned ON and it can be turned off by using the keyword named 'TRANSACTIONAL_IO=OFF'. This keyword must be placed in the '[Replication]' section of the SUNFM CFG file for the Secondary/Backup Sunfm systems when needed. The implementation for the TRANSACTION_IO capability is to minimize the possibility of allowing partial data to be written at the Secondary/Backup Sunfm system when a Primary to Secondary connection is lost and the Primary has gone down. Also, this change allows the data/file integrity at the Secondary/Backup system to be maintained when it is allowing users to logon. - The Secondary/Backup Sunfm replicator systems have been modified to allow users to logon when the new keyword 'ALLOW_CHILD_LOGON=ON' is specified in the '[Replication]' section for the SUNFM CFG file. If the 'ALLOW_CHILD_LOGON' keyword is set to OFF or it is not specified in the Secondary/Backup Sunfm CFG file, then PL/B user applications can not logon to the Secondary/Backup Sunfm server. Note: 1. This capability is implemented to allow users to read the data files on a Secondary/Backup Sunfm replicator server. If any PL/B application attempts to write data at the Secondary/Backup Sunfm replicator server for a file opened as a managed file, then an access denied IO error occurs. - Corrected a problem where non-managed files with READ ONLY attribute were not being replicated when the Primary Sunfm replicator was a Unix version.