************************************************************************ ** U458129 FILE ** ** DATE = 11/18/98 ** PHONE = 44-1962-815955 ** CONTACT = ROGER FREEMANTLE ** C/T = HU0427 ** USER = DT6LVL3 NODE = HURSLEY ** ******************PTF/APAR INFORMATION********************************** APARTXT IX83144 = RESTOREDT SCRIPT ERRORS ON CONVERT_ADM_R41 & CONVERT_ADM_R6 ENDSET COMPID FOR PTF U458129 = 576500100,210 PRODID FOR PTF U458129 = 5765001,DirectTalk for AIX PREREQ FOR U458129 = U461608 ENDSET COREQ FOR U458129 = NONE ENDSET SUP FOR U458129 = U458585 U461668 ENDSET IFREQ FOR U458129 = U461500 U461505 U461506 U459212 U461541 U461543 U461605 U461667 U459494 ENDSET MEMO TO USERS = ********************************** Instructions for Using PTF U458129 ********************************** This PTF contains fixes for problems for the following release of DirectTalk for AIX: Version 2.1.0 02.01.0000.0100 To determine your current product level, enter the following command at the AIX command line: lslpp -L "dirTalk*" If you want to display the APAR descriptions of defects which are addressed by this PTF, type the following command: instfix -T -d devicename where "devicename" is the name of the device containing the media on which the PTF is distributed (eg /dev/rmt0.1) CAUTION: To avoid downtime due to accidents or errors, back up your entire system image prior to installing this PTF. Refer to the DirectTalk for AIX Installation guide for the information on backing up a system image. To install this PTF, use the System Management Interface Tool (SMIT) as instructed in the following steps. Note that the SMIT panels that are described are those which are supported on AIX 4.2, and may differ slightly on your system. However, you should still be able to use SMIT to navigate to the correct menu. If you need additional information about using SMIT and installing software, please refer to your AIX Installation Guide. A certain amount of free disk space is required for the installation of this PTF. If there is not enough space available, then SMIT will advise you of this prior to attempting the install process. To install this update: 1. Shut down the DirectTalk for AIX system using the Quiesce Shutdown pulldown menu option from the Administration menu option. 2. Log on to AIX as 'root'. 3. Type 'smit' and press Enter. 4. Select 'Software Installation and Maintenance' and press Enter. 5. Select 'Install and Update Software' and press Enter. 6. Select 'Install Fileset Updates by Fix' and press Enter. 7. Press F4 to list the available devices and select the device where the update media is loaded and press Enter. Alternatively, overtype the field with the device name. 8. A panel is then displayed where additional install options may be specified. It is recommended that you press F4 to review the list of APARs (fixes) packaged on the media. You may then select the APARs from the list. The remainder of the options can be left as the default values. However, it is recommended that "COMMIT software updates?" option is set to "NO", since it is not possible to remove the update once it has been committed. You can commit the update at a later date, if you wish, once you are satisfied with it. If you do decide to do set this field to "NO", then it will be necessary to set "SAVE replaced files?" to "YES". Note: Some of the options may need to be altered if there is not enough free disk space available for the install. See your AIX Installation Guide for more details. Finally, ensure that the media is loaded correctly, and press Enter to start the install. 9. When the installation process is complete, exit 'smit' and run 'vae.setuser' to refresh file ownership. Enter the following command: /usr/lpp/dirTalk/tools/vae.setuser At the prompt for a user ID, enter your DirectTalk for AIX user ID. This concludes the update installation. New fixes contained in this PTF ( Fix Level 230 ) 1.This PTF contains changes to the DirectTalk v2.1 saveDT and restoreDT utilities. These changes allow you to save your DirectTalk v2.1 data and restore to either a DirectTalk v2.1 system or a DirectTalk v2.2 system. Also included in this PTF are two new tools : DTlsapobj and DTlsvmobj. These two tools allow you to list your DirectTalk objects via the command line. For example, if you typed : DTlsapobj -o stab you would see the list of state tables that are stored in your DirectTalk system. Similarly, if you typed DTlsvmobj -o prof you would see the list of application profiles that are stored in your DirectTalk system. These tools are intended to help you to plan your migration strategy from a DT v2.1 system to a DT v2.2 SSI cluster. A SSI (Single System Image) cluster is a collection of DirectTalk systems which are ystems which are database. You should use the DTlsapobj and DTlsvmobj tools to decide which applications and objects you need to export from each system and then import them onto one machine. After importing all your data, you should carry out a saveDT to save all your DirectTalk data and then restore the data to the DT v2.2 system. Please see the DirectTalk for AIX version 2 'Managing and Monitoring the System' book to see a complete description of the DTlsapobj and DTlsvmobj tools. (APAR IX83144) Previous fixes in this PTF 1.If you are using a large voice messaging system, you may see that every hour error_id 1000 is logged for failed database accesses. This appears to be related to the UPSERVER process being unable to respond due to its processing of "future delivery" messages. This fix ensures that failed database accesses do not occur in this situation. (APAR IX82680) 2.While using DirectTalk v2.1 or v2.2 to display dependencies for objects via the Application Manager, you may have noticed that not all the object dependencies were being displayed. This also affected a partial export when trying to export an object and all its dependencies. This fix ensures that you can see all the dependencies for a DirectTalk object and you can export these dependencies as well using partial export. (APAR IX82855) 3.If a custom server contains functions which, between them, contained more than 753 arguments, a "System generated main" which was created when attempting to build the custom server from DirectTalk would contain invalid data. The exact symptom is that, although the "C" syntax is correct, the arguments passed to the custom servers would be blank. This would produce either linker errors or problems when running the custom server. The fix involves: a) increasing the size of an internal buffer to increase the limit to more than 1100 arguments. b) if the limit is encountered in future, the custom server will now fail to build. (APAR IX69648) 4.While developing on a DirectTalk v2.1 or v2.2 system, you may have noticed that the lastupdate timestamp for prompt directories and voice directories is not updated even if prompts and voice segments are updated, created or deleted. This would have cause delta export of prompt directories and voice directories to behave incorrectly. This fix ensures that prompt directories and voice directories have their lastupdate timestamp updated whenever prompts and voice segments are manipulated and ensures that delta export works correctly for these objects. (APARs IX83001, IX82994) 5.While importing & previewing applications that contain application profiles (with active mailboxes), the import may fail with the message : 'ERROR: Import aborted - DB2 errors generated during import'. This fix ensures that you can import and preview applications that contain application profiles safely. (APAR IX83454) 6.After importing a version 1 voice directory (which was empty when exported), you may have found that the SaveVoiceSegment state table action returns edge 2 (Invalid Request) when saving a voice segment in that directory. This fix ensures that version 1 voice directories (which were empty when exported) are imported correctly to DirectTalk version 2. (APAR IX83487) 7.While attempting to import custom server objects, you may have seen that no custom servers are imported. This could have been caused if you had issued a delta export on these custom servers after re-building the custom servers, but no actual custom servers were exported. This fix ensures that affected custom servers are exported when a delta export is carried out. (Internal Defect 25111) 8.You may have seen that the 'replace' option for Import & Preview was not importing voice segments correctly. After import was complete, you may not have been able to view the voice segemnts in the voice segment editor. This fix ensures that you can safely select the 'replace' option for Import & Preview to import voice data. (Internal Defect 25123) ENDSET LABELTXT 576500100 DirectTalk for AIX PTF U458129 updates for 2.1.0 ENDSET