================================================================================ Licensed Materials - Property of IBM 5698-TSM (C) Copyright IBM Corporation 1990, 2000. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp ================================================================================ Welcome to the Tivoli Storage Manager, Version 4, Release 1. This README documents improvements and service to Tivoli Storage Manager Version 4, Release 1 delivered in service update 4.1.2.0 (ptf2) The README is divided into the following sections: o Installation notes o Versioning for service levels. o Last minute changes to Documentation $$1 o Support for IBM 3590 Model Exx Tape Drives $$1 o Changes to Tivoli Storage Manager to support future DTF models $$1 o Support for IBM LTO Ultrium (358x) devices $$1 o Atape upgrade required $$1 o Database page shadowing is now available $$1 o Retry options for shared 3494 Libraries $$1 o New SQL table for Licensing $$1 o License counting changes for "in use" $$1 o Managing the growth of the Activity Summary Table o Tips for SAN Management o Temporary options for Library Sharing $$1 o Temporary options for Library Sharing - Updates o Possible performance degradation due to threading o If you are using a disk controller ... o APARs not fixed in time for this release $$1 o APARs fixed in Service level 4.1.1.0 $$2 o APARs fixed in Service level 4.1.2.0 o WHERE TO FIND DOCUMENTATION o Getting Help $$1 indicates a change provided in ptf1 (service level 4.1.1.0) $$2 indicates a change provided in ptf2 (service level 4.1.2.0) ********************************************************************** * Installation Notes * ********************************************************************** Tivoli Storage Manager server Version 4.1 installation is designed for both new installations and as a replacement (migrate installation) to Tivoli Storage Manager Version 3.7 and ADSTAR Distributed Storage Manager (ADSM). For a Migrate Install --- - ------- ------- o No device definitions are saved. Record all of your current definitions because you will have to redefine all devices after the installation of Version 4.1 o If ADSM is installed, a migrate install will be performed: - ADSM will be deinstalled. - If the ADSM log and database are in /usr/lpp/adsmserv/bin, the file pointing to them (dsmserv.dsk) will be copied to the Tivoli Storage Manager server installation directory (/usr/tivoli/tsm/server/bin). Do NOT move your log, database or storage pool volumes. - If a dsmserv.opt file is found in /usr/lpp/adsmserv/bin, it is copied to /usr/tivoli/tsm/server/bin. - If any of the files "dsmaccnt.log", "devconfig" or "volhist" are found in /usr/lpp/adsmserv/bin, they will be copied to the Tivoli Storage Manager install location /usr/tivoli/server/bin. - The VOLUMEHistory and DEVCONfig options in the dsmserv.opt file will be updated if the volhist and devconfig files are successfully copied. - If any environment variables, such as DSMSERV_ACCOUNTING_DIR , DSMSERV_CONFIG or DSMSERV_DIR were set they must be changed to reflect the new location of the server o If a prior version of Tivoli Storage Manager is installed, a migrate install will be performed. No files will be moved. o An "upgradedb" will be executed for a migrate install. For a New Install --- - --- ------- o If there is enough free space in the /usr filesystem, default recovery log, database and storage pool volumes will be created in /usr/tivoli/tsm/server/bin Please refer to the Quick Start manual for more information. o If you intend to run the server in a language other than US English, you must install the LANGUAGE related filesets. It appears that packaging of language filesets does not work with "Include corresponding LANGUAGE filesets" option when using "Install and Update from Latest Available Software" installation option. To install LANGUAGE related filesets ( for example tivoli.tsm.msg.it_IT.server) you must use the "Install and Update from ALL Available filesets" and select the LANGUAGE related filesets to be installed. ********************************************************************** * Versioning for Service Levels * ********************************************************************** o Beginning with Tivoli Storage Manager, version 3, release 7, "versioning" was changed such that the third field ("m") of the vrmf string will be used to indicate a PTF and the fourth field ("f") will be used to indicate an installable patch. This scheme will be used for Verson 4 as well. For example, the initial release of version 4 will have a "vrmf" of 4.1.0.0. The first PTF will have a "vrmf" of 4.1.1.0. If patches are needed after PTF 4.1.1.0 is released, the first one will be 4.1.1.1. ********************************************************************** * Last minute changes to Documentation * ********************************************************************** o Late changes to the Tivoli Storage Manager for AIX Quick Start. Library Sharing It is no longer recommended to use low mount retention times for device classes in shared SAN-attached SCSI libraries because of changes in TSM's library sharing. $$1 Version 4.1 servers cannot participate in SCSI library sharing with $$1 version 3.7 servers. Managed System for SAN (LAN-free) When modifying drive mappings, device classes, or storage pools used by storage agents, restart the storage agents for the changes to take effect. Drive mapping When defining drive mappings for a storage agent it is recommended to define a drive mapping for all of the drives in the library to the storage agent. ********************************************************************** * $$1 Support for IBM 3590 Model Exx Tape Drives * ********************************************************************** TSM now supports the IBM 3590E Tape drive. The 3590E tape drive writes data in a new 256 track data tape format. 3590E drives can not write in 3590 128 track format however, they can read data from the tapes previously written in 128 track format on 3590 drives. With new 3590E drives available, the existing 3494 libraries with 3590 drives may either be completely upgraded with 3590E drives or they may have an intermix configuration (3590 and 3590E drives). TSM administrators must follow certain rules to transition from old 3590 drives to new 3590E drives and/or maintain both kinds of drives within the same physical library. Minimum Configurations: Device Driver level: Atape.4.4.0.0 (ftp://service.boulder.ibm.com/storage/devdrvr/AIX) Microcode level: 3590E - EC F23200 D01C_502 NOTE: To convert a 3590E volume to 3590 must have microcode level EC D19328 D01A_2FC Tape formats for 3590E: - 3590E-B - uncompressed mode (similar to 3590B) - 3590E-C - compressed mode (similar to 3590C) - DRIVE - the most advanced available format Note: For 3590 and 3590E tape drives the most advanced formats are respectively 3590C and 3590E-C 1. All 3590 drives within physical library are upgraded with 3590E drives at the same time. Consider an example with one 3590 drive physically defined as /dev/rmt0. Assume that there were originally defined devclass, logical library, and storage pool for 3590 drive. There were also some volumes (tape cartridges) checked in the library with data written on that drive. Replaced 3590 drive with 3590E drive. Steps below will allow you to use the new 3590E drives with minimum changes to TSM server: - Using SMIT utility or manually, remove /dev/rmt0 device example: rmdev -l 'rmt0' '-d; - Using SMIT utility or manually, define the 3590E device example: mkdev -c tape -t '3590' -s 'scsi' -p 'scsi0' -w '0,0' -l 'rmt0'; - Run TSM server (dsmserv); - Issue TSM command: UPDate DEVclass devclassname FORMAT=DRIVE update devclass devclass_3590 FORMAT=DRIVE; - Issue TSM command: DELete DRive libname drivename delete drive lib_3590 drive_3590; - Issue TSM command: DEFine DRive libname drivename DEVIce=devicename define drive lib_3590 drive_3590 device=/dev/rmt0; - Users must update storage pool volumes to have ACCESS=READONLY under the following conditions. Users do not have to follow this procedure for database backup, dump or export volumes. For storage pool volumes: 1) The volume currently has READWRITE access. 2) The volume was previously written on 3590 drive. For example, UDPATE VOLUME volname ACCESS=READONLY WHEREACCESS=READWRITE This also applies to DRM-managed copy storage pool volumes that are in the MOUNTABLE state. For DRM-managed volumes that are not available to the TSM server (i.e., the volumes are not in MOUNTABLE state), the user does not need to take any action. If copy storage pool volumes are brought back on-site to recover the ADSM server, the COPYSTGPOOL VOLUMES AVAILABLE macro will update the access of the copy storage pool volumes to READONLY. For any other off-site volume (ACCESS=OFFSITE), the user must update the access to READONLY after the volumes are brought back on-site. 2. Intermix of 3590 and 3590E drives in a single 3494 library environment. Consider an example of a physical library with one 3590 drive defined on /dev/rmt0 and a new 3590E drive defined on /dev/rmt1. Assume that there were originally defined devclass, logical library, and storage pool for 3590 drives. With addition of a new 3590E drive to the library that already has 3590 drives in it, new DEVCLASS, new logical LIBRARY, and new STORAGE pool MUST be defined. Defining new devclass, logical library, and storage pool for 3590E drive: DEFINE LOGICAL LIBRARY define library lib_3590E libtype=3494 device=/dev/lmcp0 scratchcategory=lib_3590_scratch privatecategory=lib_3590_scratch+3 DEFINE DEVCLASS define devclass devclass_3590E devtype=3590 format=3590E-C library=lib_3590E format=3590E-B format=DRIVE DEFINE STORAGE POOL define stgpool stg_3590E devclass_3590E other parameters Defining separate devclass for each type of drives will allow the user to specify the format for the drive and insure that 3590 volumes will not be mounted on 3590E drives and that 3590E volumes will not be mounted on 3590 drives. Defining a logical library for each type of drives will allow to define two separate storage pools of scratch volumes. It is necessary to allow write the label for the volume in the appropriate format. Moving a scratch volume from 3590 scratch pool to 3590E scratch pool: - TSM command: CHECKOut LIBVolume libraryname volname REMove=No - TSM command: CHECKIn LIBVolume libraryname SEARCH=Yes Note: In order to move volume from 3590 scratch pool to 3590E scratch pool issue above commands and RELABEL the volume after it has been checked in the 3590 library. IN ORDER TO READ THE VOLUME PREVIOUSLY WRITTEN IN 3590 FORMAT ON 3590E DRIVE (THE STORAGE POOL THAT OWNS THE VOLUME POINTS TO A DEVCLASS THAT USES 3590E drive): - UPDATE ACCESS MODE TO THAT VOLUME TO READONLY update volume volumename access=readonly whereaccess=readwrite - CHECKOUT THE VOLUME FROM THE LOGICAL 3590 LIBRARY (THE DEVCLASS' OLD LIBRARY THAT HAD 3590 DRIVES); - CHECKIN THE VOLUME TO THE LOGICAL 3590E LIBRARY (THE DEVCLASS' NEW LIBRARY THAT CONTAINS 3590E DRIVES). Private volumes defined in private categories: The volumes defined in private category have to be marked READONLY in order to read data from them on 3590E drives. After data is expired and volume becomes empty its access type is still READONLY because this volume was directly defined in the private category. In order to reuse volumes with expired data on 3590E drives the access type of these volumes must be updated to READWRITE type. The user may update all volumes to READWRITE type with the following TSM command: update volume volumename/ *(all of them) access=readwrite whereaccess=readonly wherestatus=empty There are also SQL scripts that will allow the user to query all volumes with above mentioned attributes. Next time the empty volume is mounted on 3590E drive for writing, it will be AUTOMATICALLY relabeled using 3590E format. This volume can be used neither for reading nor for writing on 3590 drives. Scratch volumes: Next time the empty volume is mounted on 3590E drive for writing, it will be AUTOMATICALLY relabeled using 3590E format. This volume can be used neither for reading nor for writing on 3590 drives. *************************************************************************** * $$1 Changes to Tivoli Storage Manager to support future DTF models * *************************************************************************** Some internal changes have been made to the TSM server and device driver support for future DTF models on AIX and NT platforms To be ready for future models of DTF we recommend that you apply this service update. TSM server and device driver will automatically resynchronize when the server is started. No other action is required. ********************************************************************** * $$1 Support for IBM LTO Ultrium (358x) devices * ********************************************************************** TSM supports the IBM 3580, 3581, 3583 and 3584 LTO Ultrium products on the AIX, NT 4.0 and NT 5.0 platforms. - The IBM 3580 is a stand-alone drive. - The IBM 3581, 3583 and 3584 are automated libraries. Users must use the SSD RMSS device drivers on these platforms to recognize and configure the IBM 3580, 3581, 3583 and 3584. To obtain the correct level of the device driver, review the README files in the ftp.software.ibm.com/storage/devdrvr. To define the device class, users should use the following: DEFINE DEVCLASS device_class_name DEVTYPE=LTO FORMAT=[DRIVE or ULTRIUM or ULTRIUMC] LIBRARY=library_name NOTE: For RSM, the DEVTYPE is LTO instead of GENERICTAPE. All other devices will continue to be defined with DEVTYPE=GENERICTAPE. On the AIX and NT 4.0 platforms, users should define the IBM 3581, 3583 and 3584 automated libraries as follows: DEFINE LIBRARY library_name LIBTYPE=SCSI DEVICE= On the AIX and NT 4.0 platforms, users should define the drives within those libraries as follows: DEFINE DRIVE library_name drive_name DEVICE= ELEMENT= On Windows 2000 platform, users should define the IBM 3581, 3583 and 3584 automated libraries as follows: DEFINE LIBRARY library_name LIBTYPE=RSM MEDIATYPE="LTO Ultrium" Note that the quotes around "LTO Ultrium" are required. Users should use standard RSM configuration techniques. Examples: On AIX, assuming AIX recognized and configured the medium changer as /dev/smc0 and the drive as /dev/rmt0: DEFINE LIBRARY 3584LIB LIBTYPE=SCSI DEVICE=/dev/smc0 DEFINE DRIVE 3584lib rmt0 DEVICE=/dev/rmt0 ELEMENT=104 On the NT 4.0, assuming NT recognized and configured the medium changer as \\.\lb3.1.0.2 and the drive as \\.\Tape0: DEFINE LIBRARY 3584LIB LIBTYPE=SCSI DEVICE=\\.\lb3.1.0.2 DEFINE DRIVE 3584lib tape0 DEVICE=\\.\Tape0 ELEMENT=104 On Windows 2000, assuming Windows 2000 recognized and configured the medium changer as \\.\Changer0 and the drive as \\.\Tape0: DEFINE LIBRARY 3584LIB LIBTYPE=RSM MEDIATYPE="LTO Ultrium" Note that the quotes around "LTO Ultrium" are required. ATTENTION: At this time the DSMLABEL utility and the Tape Labeling Wizard do not support this new family of products. Users should use the LABEL LIBVOLUME command. ATTENTION: When inserting cartriges into the entry exit ports of the IBM 3584 library wait several seconds for the library to scan the barcodes before issuing a reply to a server request to insert a cartrige in an entry exit port. This problem will be fixed in a future level of microcode for the IBM 3584 library. ********************************************************************** * $$1 Atape upgrade required * ********************************************************************** Customers using 3570 and 3590 drives need to upgrade to at least Atape 5.3.2.0 level because of changes in the Atape device driver and TSM to support the IBM Linear Tape Open devices. With the Atape upgrade, both the device driver and TSM are synchronized again. Without the upgrade, existing 3570 and 3590 customers will encounter harmless but annoying I/O errors during the dismount processing. The I/O error will be as follows: ANR8311E An I/O error occurred while accessing drive for GETLOGSENSE operation, errno = 22. This error message does not cause the operation to fail. However, it does indicate that TSM is not able to obtain diagnostic information from the 3570 and 3590 drives that TSM uses to determine the health of the drive and the media. Customers can obtain the latest version of Atape from ftp://service.boulder.ibm.com/storage/devdrvr/AIX ********************************************************************** * $$1 Database page shadowing is now available * ********************************************************************** The server option DBPAGESHADOW has been enabled. This function provides a means of mirroring the last batch of information written to the server database. By enabling this option, the server will mirror the pages to the file specified by DBPAGESHADOWFILE option. On restart, the server will use the contents of this file to validate the information in the server database and if needed take corrective action if the information in the actual server database volumes is not correct as verified by the information in the page shadow file. See the dsmserv.opt.smp file for an explanation of the DBPAGESHADOW and DBPAGESHADOWFILE options. Please note that the DBPAGESHADOWFILE description differs from what is documented in the TSM publications. This option does NOT prepend the server name to the file name. The file name used is simply the name specified on the option. ********************************************************************** * $$1 Retry options for shared 3494 Libraries * ********************************************************************** Customers that have 3494 libraries and use the 3494SHARED YES option in the dsmserv.opt file can control how the server will retry to acquire a shared drive resource before failing the request. Customers can use the following options: DRIVEACQUIRERETRY This option allows an administrator to set the number of times the server will retry to acquire a drive. Possible values: 0 -- To retry forever. This is the default value. -1 -- To never retry. 1 to 9999 -- The number of times the server will retry. MPTIMEOUT This option specifies the maximum time in seconds the server will retry before failing the request. The minimum and maximum values allowed are 30 seconds and 9999 seconds. The default is 30 seconds. Refer to the sample options file for Syntax and examples ********************************************************************** * $$1 New SQL table for Licensing * ********************************************************************** A new license SQL table has been added. The name of the table is LICENSE_DETAILS and the format of the table is: TABSCHEMA: ADSM TABNAME: LICENSE_DETAILS COLNAME: LICENSE_NAME COLNO: 1 INDEX_KEYSEQ: 1 INDEX_ORDER: A TYPENAME: VARCHAR LENGTH: 10 SCALE: 0 NULLS: FALSE REMARKS: License Type TABSCHEMA: ADSM TABNAME: LICENSE_DETAILS COLNAME: NODE_NAME COLNO: 2 INDEX_KEYSEQ: 2 INDEX_ORDER: A TYPENAME: VARCHAR LENGTH: 64 SCALE: 0 NULLS: FALSE REMARKS: Node Name TABSCHEMA: ADSM TABNAME: LICENSE_DETAILS COLNAME: LAST_USED COLNO: 3 INDEX_KEYSEQ: INDEX_ORDER: TYPENAME: TIMESTAMP LENGTH: 0 SCALE: 0 NULLS: FALSE REMARKS: Last Access Date/Time The LICENSE_NAME is the name of a license feature. The license names in this table are: SPACEMGMT ORACLE MSSQL MSEXCH LNOTES DOMINO INFORMIX SAPR3 ESS ESSR3 EMCSYMM EMCSYMR3 MGSYSLAN MGSYSSAN LIBRARY The NODE_NAME will be either the name of a Backup/Archive client or the name of a library. The LAST_USED will be set to the time the library was last initialized or the last time that client session ended using that feature. ********************************************************************** *$$1 License counting changes for "in use" * ********************************************************************** With this service level the following changes to in use license counting are introduced. - License Expiration. A license feature that has not been used for more than 30 day will be expired from the in use license count. This will not change the registered licenses, only the count of the in use licenses. Libraries in use will not be expired, only client license features. - License actuals update. The number of licenses in use will now be updated when the client session ends. An audit license is no longer required for the number of in use licenses to get updated. ********************************************************************** $$1 Managing the growth of the Activity Summary Table ********************************************************************** In Tivoli Storage Manager Version 3.7 a new data base table, SUMMARY, was added. Once you migrate from a version of ADSM prior to 3.7 to version 3.7 or later, some data base growth can be expected over time as a result of this table. The SUMMARY table contains an entry for every backup/archive/spacemanagement client session and every server process. Thus the size of the table, and your database will depend on the server activity. The default retention period for this table is 30 days thus a heavily used server would likely have a rather large Summary table. To manage the size of this table, use the SET SUMMARYRETENTION command. A shorter retention period will result in a smaller SUMMARY table. The command QUERY STATUS can be used to see what the current setting is. If you are using TDS you need to make sure the summary retention is set high enough to pull the information from the TSM server before the information gets purged from the TSM database. If you are not using TDS and do not need the information from the SUMMARY SQL table, you can set this value to 0 to prevent the additional data base usage. Information on the SET SUMMARYRETENTION command follows. SET SUMMARYRETENTION (Set Days to Keep Data in Activity Summary Table) Use this command to specify the number of days to keep information in the SQL activity summary table. The SQL activity summary table contains statistics about each client session and server processes. For a description of the information in the SQL activity summary table, use the following command: select colname, remarks from columns, where tabname='SUMMARY' Issue the QUERY STATUS command to display the number of days the information is kept. At installation, TSM allows each server to determine its own number of days for keeping information in the SQL activity summary table. Privilege Class To issue this command, you must have system privilege. Syntax >>-Set SUMmaryretention--+------+------------------------------>< '-days-' Parameters days Specifies the number of days to keep information in the activity summary table. You can specify a number from 0 to 9999. A value of 0 means that information in the activity summary table is not kept. A value of 1 specifies to keep the activity summary table for the current day. Examples Task Set the server to retain the activity summary table information for 15 days. Command: set summaryretention 15 ********************************************************************** * Tips for SAN Management * ********************************************************************** We have experienced several things in our testing that may be of help managing your SAN environment. For the latest information regarding devices supported on a SAN, see http://www.tivoli.com/support/storage_mgr/san/solution_device.html. 1. Make sure that all of your device drivers and microcode levels are at the latest version. Down-level device drivers or microcode can result in read/write errors or failure to see the devices on the SAN. See the vendor's web site for their latest device driver or microcode. 2. When installing fibre channel cards on Windows 2000 make sure to update the device driver to the one provided on the manufacturer's website. The drivers shipped with Windows 2000 are down level. 3. We have had many problems with the Emulex 7000E Fibre Channel card in an arbitrated loop environment on a Window 2000 server. We have seen a blue screen error caused by the device driver provided by Microsoft in the Windows 2000 install CD. The other problem we have seen is write failure and/or a read failure. We are currently attempting to figure out why there are problems on Windows 2000 and not on Windows NT 4.0 4. When all else fails, try rebooting your SAN. To reboot your SAN power down all devices on the SAN. To bring the SAN back online, power on your libraries and disk arrays first. After those devices have initialized, power on your bridge boxes and routers. Once the bridge boxes have initialized, power on your fibre channel hub or fibre channel switches. Now that the devices are all running, reboot your host systems. If hardware problems still exist, please call your hardware vendor. 5. If you are using a IBM SAN Data Gateway (SDG) or Pathlight router or bridge box on AIX, ensure that you configure the box correctly. You will need to issue the disableCC and setHost commands on the service port or through a telnet session with the SDG. See the IBM SAN Data Gateway Installation and User Guide for more information on the disableCC and setHost commands, or consult the online help. ********************************************************************** * Temporary options for Library Sharing * ********************************************************************** The following server options only apply to servers that have SCSI libraries that are shared with library client servers or storage agents. It is recommended to leave these options at their default values unless ANR9790W messages are occurring. The ANR9790W messages indicate a failed mount request for a library client. These options are temporary and will be removed in a future ptf. SHAREDMOUNTRETRIES - The number of times a mount request from a library client or storage agent is retried if all the drives are busy. This option should be increased if ANR9790W messages are occurring. The default value is 60. The minimum value is 0 for which the mount will not be retried. For example, adding the option SHAREDMOUNTRETRIES 120 to your dsmserv.opt file will cause 120 retries before failing the server mount request and issueing message ANR9790W. SHAREDMOUNTRETRYINTERVAL - The number of minutes to wait between mount retries if all drives are busy. Increase this option if the drive most likely will not be available after the current interval. The mount will be retried every minute by default if all drives are busy. The minimum value is 0 for which the mount will be retried immediately. For example, adding the option SHAREDMOUNTRETRYINTERVAL 2 to your dsmserv.opt file will cause a retry every 2 minutes. ********************************************************************** * $$1 Temporary options for Library Sharing - update * ********************************************************************** Beginning with service level 4.1.1.0, The SHAREDMOUNTRETRIES and SHAREDMOUNTRETRYINTERVAL server options no longer have an effect due to changes in SCSI library sharing. ********************************************************************** * Possible performance degradation due to threading * ********************************************************************** On some systems Tivoli Storage Manager for AIX may exhibit significant performance degradation due to TSM using user threads instead of kernel threads. This may be an AIX problem however, to avoid the performance degradation you should set the following environment variables before you start the server. export AIXTHREAD_MNRATIO=1:1 export AIXTHREAD_SCOPE=S ********************************************************************** * If you are using a disk controller ... * ********************************************************************** The database used by the Tivoli Storage Manager server has a requirement that data be consistent at all time. To ensure the integrity of the server database and recovery log, Tivoli Storage Manager requires that write operations be complete regardless of subsequent logical or physical events. In particular, the server opens database, recovery log, and storage pool volumes explicitly with file attributes that specify that information be written directly to disk, bypassing any cache. By having the data on disk, the server is better able to recover from an application or system crash because the server database technology allows for this. However, if data that the server expected to be to disk was not actually written, the integrity of the server and the user data stored on the server may be in jeopardy and result in loss of data. The Tivoli Storage Manager server uses operating system provided means for opening volumes so that we will bypass any cache on a write operation. However, if a storage subsystem does not recognize or support these operating system settings, the configuration and data protection provided by the storage subsystem itself must ensure that write operations be complete, even in the face of such events as power loss or subsystem reboot. With the advent of newer technology disk controllers, disk drives, and SAN hardware, more devices have cache and are managing I/O operations through their own embedded cache. It is imperative that these storage subsystems either be configured to allow write operations to go direct to the disk or else that the cache is protected. To ensure the protection of the data in the cache, the cache would require an uninterruptable power supply (UPS) or battery backup that guarantees the cache is flushed to disk before the system is shutdown. The other protection that the cache must provide is that the data in the cache is preserved if the system crashes, there is a bus reset, or a subsystem reboot. If you are using a disk controller, disk drive, SAN attached storage subsystems, or other storage subsytem that uses cache or is configured to not write through the cache direct to disk, please ensure that the subsystem is configured such that the cache is protected and/or the write operations bypass the cache and go direct to disk. ********************************************************************** * APARs not fixed in time for this Release * ********************************************************************** Fixes for the following APARs were not available in time for this release. Fixes will be available with the first service update (PTF) PQ36324 FILEEXIT AND FILETEXTEXT OPTIONS FAIL WITH AN ANR5450E ON TSM FOR MVS When the option FILETEXTEXIT YES "SB9AX.AXTSTO.ADSMCLI.EVENTS" APPEND is placed in the server option file, for dynamic allocation, an ANR5450E ERROR OPENING SB8AX.AXTSTO.ADSMCLI.EVENTS occurs. The syslog has no error messages associated with the ANR5450E error. This message is issued after an ANR0900I is issued. The test file was preallocated and different parameters were changed with the same ANR5450E being issued by TSM. A MVS fully qualified name was also tested. Incorrect data is being written to the FILETEXTEXIT dataset when the FILETEXT event receiver is enabled and started. PLATFORMS AFFECTED: MVS CIRCUMVENTION: Use a receiver other than FILETEXT for eventlogging. RECOVERY: End eventlogging to the FILETEXT receiver, and remove the FILETEXTEXIT from the options file before the next restart. <@> PQ37125 ABEND0C4 AUDITDB ANR4257E DELETEARCHIVE FORCEMODE=YES The server "AUDITDB" process could cause the server to crash. PLATFORMS AFFECTED: All CIRCUMVENTION: None RECOVERY: Restart server. <@> IC27022 TSM SERVER CRASHES WITH DR. WATSON ERROR, EXCEPTION:ACCESS VIOLATION During expiration processing the server may encounter a segmentation violation or server may crash. PLATFORMS AFFECTED: All CIRCUMVENTION: None RECOVERY: Restart server. <@> IC27050 SERVER STARTUP MIGRATION PROCESS CAN FAIL WITH CORE IF AN INVALID ENTRY IN DF.CLUSTERS IS DETECTED. During TSM server startup a crash can occur after ANR9999D Error obtaining attributes for pool. PLATFORMS AFFECTED: All CIRCUMVENTION: Disable migration checking (set NOMIGRRECL in options file) and restart server. RECOVERY: Contact TSM Service to remove the bad entry in the DF.Clusters table and restart the server. <@> PQ38971 RECLAMATION PROCESS APPEARS TO 'HANG' AND WILL NOT END ON ITS OWN During reconstruction (reclamation of aggregates), if either of the read or write threads has an error, it is possible that the other thread does not receive the signal to end. Symptoms: a reclamation process starts, but does not end nor does it appear to be moving data. The recl. process also will not respond to a cancel process request. PLATFORMS AFFECTED: All CIRCUMVENTION: None RECOVERY: Restart server. <@> ********************************************************************** * $$1 APARs fixed in Service level 4.1.1.0 * ********************************************************************** IC25945 OPEN DEVICE DESCRIPTORS INHERITED BY CHILD EMM PROCESS SYSROUTES: IC25945(SUN),IC27585(SUN37),IC27586(SUN41) When using the External Library Manager support the server may not close all the server file handles in the child process used to by the ELM exit. When this happens the ELM exit my unknowingly use a file handle already in use by the server. <@> IC26928 CRASH / CORE ON COMMAND SHOW CONFIG WITH S2S COMMUNICATION SYSROUTES: IC26928(AIX37),PQ40132(MVS37),IC27414(NT37),IC27415(HP37),IC27416(SUN37), IC27417(AIX41),PQ40133(MVS41),IC27418(NT41),IC27419(HP41),IC27420(SUN41) When command SHOW CONFIG is issued on a server to server (S2S) communication, the server issuing the command will crash / core dump. <@> IC26965 MOUNT WINDOW TERMINATES IF YOU MOUNT AN INCORRECT TAPE IN THE D SYSROUTES: IY12032(AIX),PQ40134(MVS),IC26965(NT),IC27421(HP),IC27422(SUN),PQ40135(VM), IC27423(AIX37),PQ40136(MVS37),IC27424(NT37),IC27425(HP37),IC27426(SUN37), IC27427(AIX41),PQ40138(MVS41),IC27428(NT41),IC27430(HP41),IC27431(SUN41) If an incorrect tape is mounted in response to a call for scratch, an event is being sent to mount consoles which they are unprepared for. The console sessions are terminated. <@> IC27022 TSM SERVER CRASHES WITH DR. WATSON ERROR, EXCEPTION:ACCESS VIOL SYSROUTES: IY12033(AIX),PQ40139(MVS),IC27432(NT),IC27433(HP),IC27434(SUN),PQ40140(VM), IC27435(AIX37),PQ40141(MVS37),IC27436(NT37),IC27437(HP37),IC27438(SUN37), IC27439(AIX41),PQ40142(MVS41),IC27440(NT41),IC27441(HP41),IC27442(SUN41) The server may encounter a segmentation violation or server crash during expiration. <@> IC27032 TIVOLI CONSOLE REPORTS TSM SERVER NAMES IN LOWERCASE REGARDLESS SYSROUTES: IC27032(AIX37),PQ40143(MVS37),IC27443(NT37),IC27444(HP37),IC27445(SUN37), IC27446(AIX41),PQ40144(MVS41),IC27447(NT41),IC27448(HP41),IC27449(SUN41) Tivoli Storage Manager changed the hostname of the host on which it was running to lower case when sending events to the Tivoli Event Console. <@> IC27039 ISSUING THE 'SELECT MIGR_SECONDS FROM STGPOOLS' STATEMENT WILL SYSROUTES: IC27039(AIX37),PQ40146(MVS37),IC27450(NT37),IC27451(HP37),IC27452(SUN37), IC27453(AIX41),PQ40147(MVS41),IC27454(NT41),IC27455(HP41),IC27456(SUN41) Issuing the command SELECT MIGR_SECONDS FROM STGPOOLS causes the server to abend if a copy storage pool is defined. <@> IC27050 SERVER STARTUP MIGRATION PROCESS CAN FAIL WITH CORE IF AN INVAL SYSROUTES: IC27050(AIX37),PQ40148(MVS37),IC27457(NT37),IC27458(HP37),IC27459(SUN37), IC27460(AIX41),PQ40149(MVS41),IC27461(NT41),IC27462(HP41),IC27463(SUN41) TSM server can crash after ANR9999D Error obtaining attributes for pool because of trying to release a mutex that is not held. <@> IC27072 ISSUING THE 'CHECKOUT LIBVOLUME' COMMAND WITH THE CAP PARAMETER SYSROUTES: IC27072(AIX37),IC27464(NT37),IC27466(SUN37), IC27467(AIX41),IC27468(NT41),IC27469(SUN41) The TSM server may abend if the CAP parameter is specified in the CHECKOUT LIBVOLUME command. <@> IC27077 ISSUING THE UPDATE DRIVE COMMAND WITHOUT SPECIFYING THE DEVICE SYSROUTES: IC27077(AIX),IC27470(NT),IC27471(HP),IC27472(SUN), IC27473(AIX37),IC27474(NT37),IC27475(HP37),IC27476(SUN37), IC27477(AIX41),IC27478(NT41),IC27479(HP41),IC27480(SUN41) After an UPDATE DRIVE command without the DEVICE parameter, the TSM server looses the device number for the given drive. The TSM server needs that device number to specify the drive when communicating to the 3494 Library Manager. The TSM server may abend when attempting to communicate to the 3494 Library Manager to perform a mount/demount activity or to obtain information about the given drive. Otherwise, there may be I/O errors in the activity log; that is, ANR8301E messages with a completion code of 0x023. <@> IC27123 BACKUPSETS DON'T EXPIRE PROPERLY SYSROUTES: IC27123(AIX37),PQ40150(MVS37),IC27481(NT37),IC27482(HP37),IC27483(SUN37), IC27484(AIX41),PQ40151(MVS41),IC27485(NT41),IC27486(HP41),IC27487(SUN41) Backupsets with finite retention periods do not expire. <@> IC27154 3.7.3 SERVERS WILL NOT CHANGE THE STATUS OF A DRIVE FROM LOADED SYSROUTES: IC27154(AIX37),IC27488(NT37),IC27489(HP37),IC27490(SUN37), IC27587(AIX41),IC27588(NT41),IC27589(HP41),IC27590(SUN41) TSM 3.7.3.0 does not change its state of the drive to empty after the drive cleaning completes. TSM tracks the state of a drive as it uses that drive for a tape operation. Because the state of the drive indicates the drive is still in use, TSM does not select that drive for another tape operation. <@> IC27235 GENERATE BACKUPSET MAY CAUSE THE TSM SERVER TO CORE DUMP IF MOR SYSROUTES: IC27235(AIX37),PQ40153(MVS37),IC27491(NT37),IC27492(HP37),IC27493(SUN37), IC27591(AIX41),PQ40330(MVS41),IC27592(NT41),IC27593(HP41),IC27594(SUN41) While running the GENERATE BACKUPSET command the server may crash or have unpredicatable results. Typically, this occurs just after the first OUTPUT volume is mounted while the server process is initializing the tape volume. <@> IY05341 SERVER WITH TWO LIBRARIES WILL OCCASIONALLY HANG OR CRASH WITH SYSROUTES: IY05341(AIX),IC27626(NT),IC27627(HP),IC27628(SUN), IC27629(AIX37),IC27630(NT37),IC27631(HP37),IC27632(SUN37), IC27633(AIX41),IC27634(NT41),IC27635(HP41),IC27636(SUN41) The server occasionally hang or crash. The root of the problem is in the STK toolkit code where the common library component is not multithread safe. This problem can occur with only one ACSLS library but the symptom is more apparent and noticeable when more than one ACSLS libraries are configured. <@> IY08870 ANR9999D AFMIGR.C(2805): ERROR DELETING TRANSACTION FOR 0 BYTES SYSROUTES: IY08870(AIX),PQ40154(MVS),IC27494(NT),IC27495(HP),IC27496(SUN),PQ40155(VM), IC27497(AIX37),PQ40156(MVS37),IC27498(NT37),IC27499(HP37),IC27500(SUN37), IC27501(AIX41),PQ40157(MVS41),IC27502(NT41),IC27503(HP41),IC27504(SUN41) The problem occurs when both on and off site reclaimation are running at the sametime and both need the same volume. When this occurs one of the reclaimations will fail with an error reporting zero bytes moved, and on the Sun and NT platform the server will abort. <@> IY11007 ADSM SERVER CAN FAIL WITH CORE WHEN BACKUP STG WAIT=YES IS USED SYSROUTES: IY11007(AIX),PQ40158(MVS),IC27505(NT),IC27506(HP),IC27507(SUN),PQ40159(VM), IC27508(AIX37),PQ40160(MVS37),IC27509(NT37),IC27510(HP37),IC27511(SUN37), IC27512(AIX41),PQ40161(MVS41),IC27513(NT41),IC27514(HP41),IC27515(SUN41) The 'BACKUP STGPOOL' command with 'WAIT=YES' specified can encounter a race condition causing the server to crash. <@> IY11485 ANR7837S TBUNDO096 ANR9999D TBUNDO.C RESTORE DB UNDO PASS SYSROUTES: IY11485(AIX),PQ40162(MVS),IC27516(NT),IC27517(HP),IC27518(SUN),PQ40163(VM), IC27519(AIX37),PQ40164(MVS37),IC27520(NT37),IC27521(HP37),IC27522(SUN37), IC27523(AIX41),PQ40165(MVS41),IC27524(NT41),IC27525(HP41),IC27526(SUN41) During the restore of a database backup, this may sometimes result in a TBUNDO096 server assertion. This assertion typically reports an error "2" deleting an entry from a given database table. This error does not always happen against the same database table but it is always an error code of "2" for the operation. <@> PQ36324 FILEEXIT AND FILETEXTEXT OPTIONS FAIL WITH AN ANR5450E ON TSM F SYSROUTES: PQ36324(MVS37),PQ40166(MVS41) Incorrect data is being written to the FILETEXTEXIT dataset when the FILETEXT event receiver is enabled and started. <@> PQ36770 SMPE APPLY GIVES IEW2416W MSG(S) AND RC=4 SYSROUTES: MVS only This APAR is being closed SUGG because of the lack of a better code. The problem reported by this APAR was fixed by giving long names used for C functions to unique 1-8 character short names. This is done at the time the server object is built for shipment. There was no change to server code. <@> PQ37125 ABEND0C4 AUDITDB ANR4257E DELETEARCHIVE FORCEMODE=YES SYSROUTES: IC27532(AIX37),PQ37125(MVS37),IC27533(NT37),IC27534(HP37),IC27535(SUN37), IC27536(AIX41),PQ40186(MVS41),IC27537(NT41),IC27538(HP41),IC27539(SUN41) The server "AUDITDB" process could cause the server to crash. <@> PQ37168 VM SERVER ABENDS WITH OC4 WHEN USING IUCVTCPIP OPTION SYSROUTES: PQ40187(MVS),PQ37168(VM), PQ40188(MVS37), PQ40189(MVS41) Abend 0C4 occurred on VM server after a session was terminated because the client did not respond within the specified time. Even tho this problem was reported against the VM server, it is possible for a similar abend to occur on the MVS and OS/390 server. <@> PQ37997 MESSAGES OF 78-79 CHARS CAUSE A BLANK CONTINUATION LINE TO SYSL SYSROUTES: Closed FIN, can't be sysrouted Message of 78 chars ending with a blank, or 79 ending with a non-blank have a leftover carraige return (x'15') that gets output on a separate line. MESSAGEFORMAT has no effect, and the line is blank. Even if the MPFLST00 member of SYS1.PARMLIB is used to suppress the msgid, the blank line is displayed with a TYPE=N, meaning "single line message with no reply". Since the limit is 79 chars, and the 80th is a x'15', it should not cause a multiline message. <@> PQ38261 FIXEDIOBUFSIZE DATA-INTEGRITY ERRORS PRIMARY STORAGE POOLS SYSROUTES: PQ38261(MVS37),PQ40383(MVS41) A new option, FIXEDIOBUFSIZE, was introduced in V3.7 of Tivoli Storage Manager for MVS and OS/390. The default value for this option is 0. It has recently been determined that data-integrity problems can occur if customers use a non-zero value for FIXEDIOBUFSIZE and then store or transfer files into a disk storage pool. . This problem may be detected if an attempt is made to restore/retrieve the files to the client or to audit the volume on which the files are stored. The problem may also be detected if reclamation attempts to reconstruct a file aggregate. The corrupted files are not detected during move or copy operations such as migration or storage pool backup. . When corrupted files are detected as described above, a message is issued indicating an invalid frame header or object header. A new option, FIXEDIOBUFSIZE, was introduced in V3.7 of Tivoli Storage Manager for MVS and OS/390. The default value for this option is 0. It has recently been determined that data-integrity problems can occur if customers use a non-zero value for FIXEDIOBUFSIZE and then store or transfer files into a disk storage pool. . This problem may be detected if an attempt is made to restore/retrieve the files to the client or to audit the volume on which the files are stored. The problem may also be detected if reclamation attempts to reconstruct a file aggregate. The corrupted files are not detected during move or copy operations such as migration or storage pool backup. . When corrupted files are detected as described above, a message is issued indicating an invalid frame header or object header. A new option, FIXEDIOBUFSIZE, was introduced in V3.7 of Tivoli Storage Manager for MVS and OS/390. The default value for this option is 0. It has recently been determined that data-integrity problems can occur if customers use a non-zero value for FIXEDIOBUFSIZE and then store files into a disk storage pool. . This problem may be detected if an attempt is made to restore/retrieve the files to the client or to audit the volume on which the files are stored. The problem may also be detected if reclamation attempts to reconstruct a file aggregate. The corrupted files are not detected during move or copy operations such as migration or storage pool backup. . When corrupted files are detected as described above, a message is issued indicating an invalid frame header or object header. <@> PQ38971 RECLAMATION PROCESS APPEARS TO 'HANG' AND WILL NOT END ON ITS O SYSROUTES: IY12047(AIX),PQ40192(MVS),IC27540(NT),IC27541(HP),IC27542(SUN),PQ40193(VM), IC27543(AIX37),PQ38971(MVS37),IC27544(NT37),IC27545(HP37),IC27546(SUN37), IC27547(AIX41),PQ40194(MVS41),IC27548(NT41),IC27549(HP41),IC27550(SUN41) During reconstruction (reclamation of aggregates), if either of the read or write threads has an error, it is possible that the other thread does not receive the signal to end. Symptoms: a reclamation process starts, but does not end nor does it appear to be moving data. The recl. process also will not respond to a cancel process request. <@> PQ39162 RESTORE DB SOURCE=DBS SNAPSHOT VOLUMES NOT RECOGNIZED SYSROUTES: Closed FIN, can't be sysrouted /RESTORE DB TOD=TODAY SOURCE=DBS results in messages: 08:08:21 ANR0301I Recovery log format in progress; 112 megaby 08:08:21 EDG4029I VOLUME 601483 REJECTED. DATA SET NAME DOES 08:08:21 EDG4006E VOLUME 601483 ON 0529 REJECTED FOR USE BY 08:08:22 ANR5036E Open of tape unit TAPEN (ddname SYS00014) 08:08:22 IEF234E K 0529,601483,PVT,ADSMT,TIVSM 08:08:22 ANR1401W Mount request denied for volume 601483 - m 08:08:22 ANR4578E Database backup/restore terminated - requi -- EDGxxx error messages being returned from DFSMS RMM -- DBsnapshot volumes not being recognized - looking for ADSM.DBB <@> IC27277 SECURE WEB PROXY FAILS ON HP WITH INTERNAL SERVER ERROR SYSROUTES: IC27552(AIX37),PQ40196(MVS37),IC27553(NT37),IC27554(HP37),IC27555(SUN37), IC27556(AIX41),PQ40197(MVS41),IC27557(NT41),IC27558(HP41),IC27559(SUN41) The reported problem is that the web proxy abends when a a request for an item in the Web administrator interface object tree is expanded (e.g. Expand the Network View). As it turns out this problem can occur on any requested web page being proxied from the Tivoil Storage Manager server. <@> IC27307 3.7.3.3 FIXTEST ABENDS WHEN DELETE VOLUME OR SPACE RECLAMATION SYSROUTES: IY12111(AIX),PQ40332(MVS),IC27595(NT),IC27596(HP),IC27597(SUN),PQ40333(VM), IC27598(AIX37),PQ40334(MVS37),IC27599(NT37),IC27600(HP37),IC27307(SUN37), IC27601(AIX41),PQ40335(MVS41),IC27602(NT41),IC27603(HP41),IC27604(SUN41) Server abends if an aggregate alias is deleted during reclamation processing. <@> PQ37584 SELECT IN A MACRO DS PRODUCES RC=3 IF NOT IN COLUMN 1. SYSROUTES: Closed FIN, can't be sysrouted Coding a SELECT statement in a dataset for use in a MACRO in TSO batch will not work correctly if the "SELECT" command does not start in column one. <@> IC27348 USING DEVCLASS OF 'GENERICTAPE' IN TSM 3.7.3 SERVER,APPENDING T SYSROUTES: IC27348(AIX37),IC27606(NT37),IC27607(HP37), IC27608(AIX41),IC27609(HP41) When using a generic tape device class appending to tapes fails with errno=5 on HP and AIX, and rc=1104 on NT. This only occurs if the tape is dismounted before it is appended to. <@> IC27402 ONLY 1 SIDE IS BEING UTILIZED ON WORM AND OPTICAL PLATTERS AFTE SYSROUTES: TSM server detects when an OPTICAL or WORM media is two-sided. For OPTICAL or WORM media introduced into the storage pool since upgrading to TSM 3.7.3.0, TSM will only use one side of the media. For OPTICAL media, the customer can after applying the fix peform the following steps: 1) Move the data to other OPTICAL media. 2) Relabel the OPTICAL media after it is returned to SCRATCH. The next time the OPTICAL media is selected TSM will use both sides of the platter. If the customer used the DSMLABEL utility to label the OPTICAL platters, there is no other action required. <@> IC27397 TEXT UPDATE AND INFORMATION REQUIRED IN THE OP.CONF, MT.CONF AN SYSROUTES: Incorrect and/or insufficient information in the driver.conf file <@> IY11101 IF ADSM DEVICES BEGIN NUMERICALLY HIGHER THAN 0 (IE. /DEV.MT6 O SYSROUTES: Devices defined to ADSM or TSM with addresses starting higher then 0. For example a device defined as MT16 may be redefined as MT0 when a UPDATE is done on AIX. <@> PQ38991 IMPORT OF A CLIENT WITH FILE DATA FROM MORE THAN 1 3590 VOLUME FAILS WITH AN INVALID RECORD FORMAT ERROR SYSROUTES: On MVS Export, Backup Db, Generate Backupset and DSMSERV UNLOADDB operations that create multiple volume output tapes may fail on the corresponding input operation. <@> PQ39436 ANR5092E AFTER UPGRADE TO OS/390 2.10 SYSROUTES: MVS only TCP/IP level for OS/390 2.10 is not recognized by Tivoli Storage Manager for MVS. Server unable to complete TCP/IP communications method initialization. <@> IC27723 DEVELOPMENT APAR TO INFORM THAT DATABASE PAGE SHADOWING IS ENABLED. The TSM V3.7 server introduced a new function for protecting the server database. The feature is call "database page shadowing". This provides a mirror file for the last batch of pages written to the server database. This function was announced to be availa ble in the TSM V3.7 server. The function was not available at GA of the TSM V3.7 product and was disabled from customer use. <@> IC27751 NEW LICENSE SQL TABLE ADDED. This development APAR created to inform users of TSM V4.1 of a new license SQL table added to the server. <@> IC27741 TSM WEB Help JAvascript links to glossary terms broken. Javascript links to glossary terms were broken when help files were updated in support of product enhancements. <@> IC27749 NEW DEVICE SUPPORT IN TIVOLI STORAGE MANAGER SERVER FOR AIX This is a development APAR to inform users of new TSM AIX device support for ADIC Scalar 100, HP proton autoloader, ATL P2000, HP SureStore 818, MagFile 40. <@> ********************************************************************** * $$2 APARs fixed in Service level 4.1.2.0 * ********************************************************************** IC29061 'DSMSERV UNLOADDB' HANG WHEN USING TAPE DEVICE SYSROUTES: IC29061(AIX41),PQ44190(MVS41),IC29064(NT41),IC29065(HP41),IC29066(SUN41) The server unloaddb process may hang at the end of processing after dismounting the last tape volume used and before reporting the unloaddb completion statistics. <@> IC24451 'BACKUP STORAGEPOOL WAIT=Y' RETURNS RC=0, AFTER IT FAILED SYSROUTES: IY12950(AIX),PQ41315(MVS),IC24451(NT),IC27893(HP),IC27894(SUN),PQ41316(VM), IC27895(AIX37),PQ41317(MVS37),IC27896(NT37),IC27897(HP37),IC27902(SUN37), IC27898(AIX41), PQ41318(MVS41),IC27899(NT41),IC27900(HP41),IC27901(SUN41) The BACKUP STGPOOL command with the WAIT=YES parameter specified does not return a valid return code in cases where the process failed. The command returns return code 0 regardless of the outcome of the command. <@> IC26629 OUTPUT IS NOT FORMATTED CORRECTLY WITH TSM WEBADMIN SYSROUTES: IC26629(AIX37),PQ41966(MVS37),IC28287(NT37),IC28288(HP37),IC28289(SUN37), IC28290(AIX41),PQ41967(MVS41),IC28291(NT41),IC28292(HP41),IC28293(SUN41) Wrong output format when "Q Proc" against a full db backup. be affected. There is no option for the search 'BULK" at the dsmadmc label li Meaning that customer can not label libvol/checkin libvol volume for library such as 3575 via the browser. There is no option for the search 'BULK" at the dsmadmc label li Meaning that customer can not label libvol/checkin libvol volume for library such as 3575 via the browser. <@> IC26898 ACTIVITY SUMMARY TABLE IS NOT UPDATED CORRECTLY IN CASE OF BACK SYSROUTES: IC26898(AIX37),PQ41707(MVS37),IC28024(NT37),IC28025(HP37),IC28026(SUN37), IC28634(AIX41),PQ43171(MVS41),IC28635(NT41),IC28636(HP41),IC28637(SUN41) In certain situations, the SUMMARY table can show that a storage pool backup operation was successful even though message ANR0985I reported that a backup process failed. <@> IC27027 ANR4391I DOES NOT APPEAR IN THE ACTLOG WELL RUNNING EXPIRE INVE SYSROUTES: IC27027(AIX37),IC28213(NT37),IC28214(HP37),IC28215(SUN37), IC28216(AIX41),IC28217(NT41),IC28218(HP41),IC28219(SUN41) The expiration process is not reporting the progress as it expires inventory records. PROBLEM KEYWORDS: EXPIRATION, MESSAGE, ANR4391I <@> IC27044 NO BULK OPTION FOR LABEL LIBVOL SYSROUTES: IC28280(AIX37),IC27044(NT37),IC28281(HP37),IC28282(SUN37), IC28283(AIX41),IC28284(NT41),IC28285(HP41),IC28286(SUN41) There is no option for the search 'BULK" at the dsmadmc label li Meaning that customer can not label libvol/checkin libvol volume for library such as 3575 via the browser. <@> IC27126 THE EXPORT NODE COMMAND WILL CAUSE THE SERVER TO ABEND IF A FIL SYSROUTES: IC27126(AIX37),PQ41311(MVS37),IC27878(NT37),IC27879(HP37),IC27880(SUN37), IC27881(AIX41),PQ41312(MVS41),IC27882(NT41),IC27883(HP41),IC27884(SUN41) The EXPORT NODE command will cause the TSM Server to abend if a filedata type of ARCHIVE or SPACEMANAGED is specified. The command completes successfully with any of the remaining filedata types are specified. <@> IC27197 ANR0986I INFORMATIONAL FOR IMPORT NODE DISPLAYS SIZE IN BYTES I SYSROUTES: IC27197(AIX37),PQ41307(MVS37),IC27871(NT37),IC27872(HP37),IC27873(SUN37), IC27874(AIX41),PQ41308(MVS41),IC27875(NT41),IC27876(HP41),IC27877(SUN41) On Import, the server displays the number of bytes transferred twice. However, they are different numbers when the total bytes transfered is greater than 4 Gigabytes. <@> IC27297 WELL RUNNING SQL SELECT QUERY TSM SERVER CAN ABEND WITH INTERNA SYSROUTES: IC27297(AIX37),PQ41715(MVS37),IC28044(NT37),IC28045(HP37),IC28046(SUN37), IC28047(AIX41),PQ41716(MVS41),IC28048(NT41),IC28049(HP41),IC28050(SUN41) The problem is that the server abort when an admin session recieves bad data on a private stream. This results in the server aborting with abort message containing the word SMADMIN001. <@> IC27364 EXCLAMATION MARK CHARACTER '!' TRANSFERED TO SERVER AS SPACE ' SYSROUTES: IC27364(AIX37),PQ41718(MVS37),IC28051(NT37),IC28052(HP37),IC28053(SUN37), IC28054(AIX41),PQ41719(MVS41),IC28055(NT41),IC28056(HP41),IC28057(SUN41) The web administrator interface does not accept the ! mark of as part of input to any parameter where the character is valid. For example, when defining a client schedule the client object to be backed up is c:!TEMP!. This results in the client object being set for this schedule as c: TEMP . <@> IC27372 MESSAGE ANR2395I IS MISSLEADING AFTER ATTEMPT TO RESTORE A SYSROUTES: IC27372(AIX37),PQ41872(MVS37),IC28220(NT37),IC28221(HP37),IC2822(SUN37), IC28223(AIX41),PQ41873(MVS41),IC28224(NT41),IC28225(HP41),IC28226(SUN41) After attempting to restore a database using 'dsmserv restore db', without first having defined the devconfig location, message ANR2395I is issued. According to the manuals, the subject message is issued by BACKUP DEVCONFIG command. This message is not appropriate for the action being performed. <@> IC27640 ADSM NT SERVER DOES NOT RECOGNIZE A VOLUME HAS BEEN DISMOUNTED SYSROUTES: IC27640(NT), IC28058(NT37), IC28059(NT41) ADSM/TSM may not detect dismounted volumes when using an External Library Manager. <@> IC27646 TSM 3.7.3 AND 4.1.0/4.1.1 SCHEME FOR TEC MESSAGING ADVERSELY AF SYSROUTES: IC27646(AIX37),PQ41958(MVS37),IC28249(NT37),IC28250(HP37),IC28251(SUN37), IC28252(AIX41),PQ41959(MVS41),IC28253(NT41),IC28254(HP41),IC28256(SUN41) The baroc file associated with the unique event class per message scheme creates too many entries into the databases for the TEC server and adversely affects the performance at the TEC server. TSM performance is not affected. <@> IC27742 TIVOLI STORAGE MANAGER SERVER MAY HANG DURING UNLOAD PROCESSING SYSROUTES: IC28186(AIX37),PQ41832(MVS37),IC27742(NT37),IC28187(HP37),IC28188(SUN37), IC28189(AIX41),PQ41834(MVS41),IC28190(NT41),IC28191(HP41),IC28192(SUN41) The server "dsmserv unload db" process may hang. This appears towards the end of the processing, typically, after a number of status messages have been issued indicating the progress of the unload process. <@> IC27815 GENERATE BACKUPSET LEADS TO A CORE DUMP SYSROUTES: IC27885(AIX37),PQ41313(MVS37),IC27886(NT37),IC27887(HP37),IC27815(SUN37), IC27888(AIX41),PQ41314(MVS41),IC27889(NT41),IC27890(HP41),IC27892(SUN41) The TSM server was improperly processing copy storage pool volumes when generating a backup set. <@> IC27865 NEW COMMAND TO FORCE ARCHIVE CONVERSION SYSROUTES: IC27865(AIX37),PQ41658(MVS37),IC27993(NT37),IC27994(HP37),IC27995(SUN37), IC27996(AIX41),PQ41659(MVS41),IC27998(NT41),IC27999(HP41),IC28000(SUN41) API clients also have need to query archive by description <@> IC28255 STORAGE AGENT HANG. SYSROUTES: IC28255(NT41) Certain resources that the storage agent uses were not being freed synchronously. The request was sitting in an internal buffer and was not flushed until later in the session. This produced the potential for deadlock. Sessions in the storage agent were deadlocked trying to access resources on the server. <@> IY10448 ANR4359W CAN OCCUR DURING RECONCILE VOLUME PROCESS WHEN 0 LENGT SYSROUTES: IY10448(AIX),PQ41803(MVS),IC28100(NT),IC28101(HP),IC28102(SUN),PQ41804(VM), IC28103(AIX37),PQ41805(MVS37),IC28104(NT37),IC28105(HP37),IC28106(SUN37), IC28107(AIX41),PQ41807(MVS41),IC28108(NT41),IC28109(HP41),IC28110(SUN41) The source server may report an error against a virtual volume when performing a "RECONCILE VOLUME" process. In particular, message ANR4359W is issued indicating the size on the target volume does not match the size on the source volume. <@> IY10656 MIGRATION FAILS ON DISK STORAGE POOL WITH ANR9999D DFTXN.C(795) SYSROUTES: IY10656(AIX),PQ39851(MVS),IC27360(NT),IC27361(HP),IC27362(SUN),PQ39852(VM), IY10656(AIX37),PQ39868(MVS37),IC27366(AIX37),IC27367(NT37),IC27368(HP37),IC27369(SUN37), IC28649(AIX41),PQ43177(MVS41),IC28650(NT41),IC28651(HP41),IC28652(SUN41) During processing that may delete files from disk storage pools (expiration, migration, reclamation, etc.) it is possible to receive the following error: ANR9999D dftxn.c (795): file count went negative for poolX, ck1=Y ck2=Z As a result of the error, the db transaction in use will abort and the server function will fail. <@> IY11433 WHEN A DURATION IS SET FOR THE EXPIRE INVENTORY THE RESTART CHE SYSROUTES: IY11433(AIX),PQ41813(MVS),IC28122(NT),IC28123(HP),IC28124(SUN),PQ41814(VM), IC28125(AIX37),PQ41815(MVS37),IC28126(NT37),IC28127(HP37),IC28128(SUN37), IC28129(AIX41),PQ41816(MVS41),IC28130(NT41),IC28131(HP41),IC28132(SUN41) When running expiration with the "DURATION" parameter, the expiration will not set the restart position properly if the expiration process ends as a result of the DURATION being exceeded. <@> IY12604 TCPIP REC/WAIT MEDIA/WAIT SOURCE SERVER TO SERVER SYSROUTES: IY12604(AIX),PQ41875(MVS),IC28227(NT),IC28228(HP),IC28229(SUN),PQ41876(VM), IC28230(AIX37),PQ41877(MVS37),IC28231(NT37),IC28232(HP37),IC28233(SUN37), IC28234(AIX41),PQ41878(MVS41),IC28235(NT41),IC28236(HP41),IC28237(SUN41) When there is a network interruption during server to server connection the target server will not recognize the break in the connection and the thread will hang. Meanwhile the source server will recognize the break and will terminate the thread. <@> PQ38544 GENERATE BACKUPSET FAILS ON SEVER TO SERVER VIRTUAL VOLUMES. SYSROUTES: PQ38544(MVS37), PQ40814(MVS41) Could not generate a backup set on MVS when the target device class uses server-to-server virtual volumes. <@> PQ39896 ABENDU301 MSGDM0001S LOGSEG014 ADSM MVS SERVER SYSROUTES: IY13292(AIX),PQ39896(MVS),IC28163(NT),IC28164(HP),IC28165(SUN),PQ41828(VM), IC28166(AIX37),PQ41829(MVS37),IC28167(NT37),IC28168(HP37),IC28169(SUN37), IC28170(AIX41),PQ41830(MVS41),IC28171(NT41),IC28172(HP41),IC28173(SUN41) Server crashes during database/log checkpoint when database backup is happening concurrently. <@> SA89596 ANR ANR9999D INVALID STREAM DESCRIPTION IN OUTCANCELSTREAM(). SYSROUTES: IY14564(AIX),PQ43540(MVS),IC28855(NT),IC28856(HP),IC28857(SUN),PQ41320(VM), IC28306(AIX37),PQ41974(MVS37),IC28299(NT37),IC28300(HP37),IC27835(SUN37), IC28301(AIX41),PQ41970(MVS41),IC28302(NT41),IC28303(HP41),IC28304(SUN41) When canceling a web session that appears to be hung and is in the receive state, a ANR9999D error message appears stating you can not close a NULL stream. <@> IC26860 WHEN THE TSM SERVER LOSES CONNECTION TO THE TEC SERVER IT FAILS SYSROUTES: IC26860(AIX37), IC28654(AIX41) If an enterprise's TEC server goes down, the TSM server will poll the TEC for 10 minutes before disabling event logging to the tivoli event receiver. The TSM Server will then issue an error message stating it was unable to flush the current message to the TEC. The user must re-enable the tivoli event receiver (begin eventlogging tivoli) when the TEC server comes back online. <@> IC27581 MULTIPLE SERVER INSTANCES ARE UNABLE TO START ON REBOOT IF SET SYSROUTES: IC27581(NT37), IC28594(NT41) When running multiple server instances on one NT machine, the servers will not restart upon a reboot if they are set to automatic. <@> IC27584 THE DELETE VOLUME COMMAND RESULTS IN AN ANR0104E ERROR 2 DELETI SYSROUTES: IC27584(AIX37),PQ43181(MVS37),IC28655(NT37),IC28656(HP37),IC28657(SUN37), IC28658(AIX41),PQ43182(MVS41),IC28659(NT41),IC28660(HP41),IC28661(SUN41) Message ANR0104E "Error 2 deleting row from table "AF.Segments" attempting to delete a volume. <@> IC27623 SERVER FAILS TO HANDLE CLEANING REQUESTS FROM 3590 TAPE DRIVES SYSROUTES: IC27623(AIX37), IC28366(AIX41) This is an intermittent problem that affects the TSM Drive Cleaning function when the user specifies ASNEEDED for the cleaning frequency. TSM may not receive the drive cleaning indication in the SIM/MIM Log Page because the log page has been cleared. As a result TSM may not clean the drive. <@> IC27716 BLUESCREEN MAY OCCUR ON WINDOWS 2000 WITH 0X000000B8 EXCEPTION SYSROUTES: IC27716(NT37), IC28374(NT41) When a device returns a busy status or when there's a problem with a SCSI adapter, the device driver delays the thread execution by invoking the KeDelayExecutionThread function. However, in the Windows 2000 environment, this function can not be called with the thread is in IRQL DISPATCH_LEVEL or higher, otherwise blue screen. <@> IC27747 DEADLOCK SITUATION CAUSING SERVER TO HANG DURING BACKUPS SYSROUTES: IY14255(AIX),PQ43183(MVS),IC28662(NT),IC28663(HP),IC28664(SUN),PQ43184(VM), IC28665(AIX37),PQ43185(MVS37),IC28666(NT37),IC28667(HP37),IC28668(SUN37), IC27747(AIX41),PQ43186(MVS41),IC28669(NT41),IC28670(HP41),IC28671(SUN41) Server deadlock situation may occur when performing normal client backups and DELETE VOLHISTORY command. <@> IC27833 DEVCONFIG DOES NOT ALLOW SPACES IN THE PATH FOR EXTERNAL MANAGE SYSROUTES: IC27833(NT37), IC28595(NT41) The DEVCONFIG file does not allow spaces in the path for the EXTERNALMANAGER specification. <@> IC27855 WEB ADMIN DEFINE DEVCLASS 5200MB MISSING FROM FORMAT DROP DOWN SYSROUTES: IC27855(AIX37),PQ43187(MVS37),IC28673(NT37),IC28674(HP37),IC28675(SUN37), IC28676(AIX41),IC28677(NT41),IC28678(HP41),IC28679(SUN41) No 5200MB option for optical device format in webadmin <@> IC27988 WHEN PERFORMING A BACKUP OF ON BKUPCPY STGPOOL, USING OPTIONS M SYSROUTES: IY14257(AIX),PQ43188(MVS),IC28681(NT),IC28682(HP),IC28683(SUN),PQ43189(VM), IC27988(AIX37),PQ43190(MVS37),IC28684(NT37),IC28685(HP(37),IC28686(SUN37), IC28687(AIX41),PQ43191(MVS41),IC28689(NT41),IC28690(HP41),IC28691(SUN41) During a "BACKUP STGPOOL WAIT=YES" the server may crash if there was no data eligible to be backed up from fromStgpool on the command. <@> IC28066 VOLUME AND MOUNTPOINT ARE NOT FREED WHEN ANR8469E DISMOUNT FAIL SYSROUTES: IC28066(AIX37),PQ42183(MVS37),IC28377(NT37),IC28379(HP37),IC28380(SUN37), IC28381(AIX41),PQ42184(MVS41),IC28382(NT41),IC28383(HP41),IC28384(SUN41) Failed dismounts to External Library Manager are not cleaned up properly. <@> IC28068 WEB ADMIN DOES NOT ALLOW OR INCLUDE HELP FILES FOR THE SEARCH = SYSROUTES: IC28068(AIX37),PQ43193(MVS37),IC28692(NT37),IC28693(HP37),IC28694(SUN37), IC28695(AIX41),PQ43194(MVS41),IC28696(NT41),IC28697(HP41),IC28698(SUN41) There is no usr help for bulk option at webadmin for define tape <@> IC28133 MSGANR8355E I/O ERROR READING LABEL FOR VOLUME SYSROUTES: IC28133(AIX37),IC28361(HP37),IC28362(SUN37), IC28363(AIX41),IC28364(HP41),IC28365(SUN41) The problem may appear intermittently depending on the operating system level. The problem only occurs after TSM reached the end-of-volume while writing data to the tape cartridge. If TSM immediately dismounts the volume, there may be an erroneous ANR8355E message while verifying the internal tape label. If TSM leaves the volume mounted and there are drive or media problems when TSM attempts to read the data, TSM may not issue an ANR8302E or ANR8311E message. <@> IC28349 WEB ADMIN SESSIONS HANG. APPEARS TO BE LOOP IN PAGE FETCH CAUSI SYSROUTES: IY14258(AIX),PQ43195(MVS),IC28699(NT),IC28700(HP),IC28701(SUN),PQ43196(VM), IC28349(AIX37),PQ43197(MVS37),IC28702(NT37),IC28703(HP37),IC28704(SUN37), IC28705(AIX41),PQ43198(MVS41),IC28706(NT41),IC28707(HP41),IC28708(SUN41) WEB ADMIN session hang and CPU utilization increases. The problem is caused by a LOOP in the buffer prefetcher. <@> IC28419 SESSION HANGS WHEN MIXED DRIVE TYPES IN 349X/ACSLS LIBRARY SYSROUTES: IC28619(AIX37),IC28620(NT37),IC28621(HP37),IC28622(SUN37), IC28419(AIX41),IC28624(NT41),IC28625(HP41),IC28626(SUN41) If a customer has mixed drive types in a 3494/ACSLS library, TSM 4.1 server will enter an infinite loop when attempting to select a drive for a tape operation. The session appears to hang. The problem only happens when the customer has two drives in the library -- one of each drive type. <@> IC28426 CHECKIN LIBV WHEN SPECIFYING VOLUME NAME WILL LOOP IF THE WRONG SYSROUTES: IC28426(AIX37),IC28709(NT37),IC28710(HP37),IC28711(SUN37), IC28712(AIX41),IC28713(NT41),IC28714(HP41),IC28715(SUN41) This problem only occurs when the syntax of the command is as follows and the user inserted the wrong volume: checkin libvol status.... The customer will be asked to insert the correct volume even though they have already inserted the correct volume. This loop will continue until the process is cancelled. <@> IC28459 MOUNT FAILURES WHEN RUNNING CHECKIN/LABEL/CHECKOUT AND OTHER TA SYSROUTES: IC28459(AIX37),IC28627(NT37),IC28628(HP37),IC28629(SUN37), IC28630(AIX41),IC28631(NT41),IC28632(HP41),IC28633(SUN41) On a 3494 or ACSLS library, there is a potential for mounts to fail when there is a CHECKIN, LABEL, or CHECKOUT LIBVOLUME command running and other tape activity. The mounts fail because the same drive is reserved for multiple processes. <@> IC28688 INSTALLATION RMTX DEVICE DEFINITIONS DELETED SYSROUTES: Tape devices defined as rmt are removed in error by the TSM ODM scripts when installing TSM ptfs. <@> PQ39307 LE RUNTIME OPTIONS NOT PASSED TO ALL TCBS SYSROUTES: PQ39307(MVS), PQ43200(MVS37), PQ43201(MVS41) Server will abend with out-of-storage indication. A request for storage below the line is made and the operating system is unable to satisfy the request. This occurs when the server option MPTHREADING YES is in effect. <@> PQ40633 UNLOAD LOAD ANR9999D ANR1310E VARY-ON FAILED FOR DISK VOLUME ER SYSROUTES: IC28385(AIX37),PQ40633(MVS37),IC28386(NT37),IC28387(HP37),IC28388(SUN37), IC28389(AIX41),PQ42186(MVS41),IC28390(NT41),IC28391(HP41),IC28392(SUN41) The server unloaddb utility does not accurately report the success or failure of the process. Because of this, there are cases where the unloaddb db image may be incomplete. <@> PQ41030 ABEND0C4 ANRQAMUT CANCEL SESSION SYSROUTES: IY13362(AIX),PQ41030(MVS),IC28269(NT),IC28270(HP),IC28271(SUN),PQ41962(VM), IC28272(AIX37),PQ41963(MVS37),IC28273(NT37),IC28274(HP37),IC28275(SUN37), IC28276(AIX41),PQ41964(MVS41),IC28277(NT41),IC28278(HP41),IC28279(SUN41) A client was restoring files using no query restore. An administrator issued "cancel session" for that client. Then the server crashed. <@> PQ41418 OBJECT NAMES WITH EMBEDDED BLANK CHARS WITH WEB ADMIN USING MSI SYSROUTES: IC28257(AIX37),PQ41418(MVS37),IC28258(NT37),IC28259(HP37),IC28260(SUN37), IC28261(AIX41),PQ41961(MVS41),IC28262(NT41),IC28263(HP41),IC28264(SUN41) Object name in the web administrator interface that have blank spaces in their names such as "System Objects" cause the TSM Server to run a CPU at 100%. The problem only occurs with Internet Explorer 5.X and not the Netscape browser family. KEYWORDS: WEB ADMIN, SYSTEM OBJECTS, OBJECTS, SPACES IE 5.0, IE 5.5, %C2%, %C3% <@> PQ41429 NO SCHEDULE RETURNED BY SERVER WHEN CLIENT CONNECTS BEFORE CENT SYSROUTES: IC28265(AIX41),PQ41429(MVS41),IC28266(NT41),IC28267(HP41),IC28268(SUN41) Server returns no schedules when client connects while server is initializing IC26617 TRACING ON SERVER USING TRACECLASS LOCKS (TM) BRINGS DOWN SERVE SYSROUTES: IY14248(AIX),PQ43172(MVS),IC28638(NT),IC28639(HP),IC26617(SUN),PQ43173(VM), IC28641(AIX37),PQ43174(MVS37),IC28642(NT37),IC28643(HP37),IC28644(SUN37), IC28645(AIX41),PQ43175(MVS41),IC28646(NT41),IC28647(HP41),IC28648(SUN41) The server can crash if the LOCK or DEADLOCK trace flag is in use and tracing has begun. <@> IC28328 WEB ADMIN CLIENT MISSING ECARTRIDGE DEVICE CLASS ENTRY SYSROUTES: Ecartridge is not defined in the webadmin. <@> IC28615 DATABASE AUDIT FAILS ANR999D BFAGGRUT.C UNEXPECTED UPDATE FOR N SYSROUTES: IY14716(AIX),PQ43740(MVS),IC28615(NT),IC28950(HP),IC28951(SUN),PQ43741(VM), IC28952(AIX37),PQ43742(MVS37),IC28953(NT37),IC28954(HP37),IC28955(SUN37), IC28956(AIX41),PQ43743(MVS41),IC28957(NT41),IC28958(HP41),IC28959(SUN41) Under certain circumstances, a database audit can fail and produce messages such as the following. ANR999D bfaggrut.c(754): Unexpected update for number of files (1 >=1) in aggregated bitfile 0.2710540. ANR2184W bfaudit.c631: Transaction 0:2583296 was aborted for command AUDITDB. ANR4142I AUDITDB: Database audit process terminated in error. . A message such as the following may also be observed. Illegal update for logical size (0.1234567 > 0.123456) of aggregated bitfile 0.123456. <@> IC28688 INSTALLATION RMTX DEVICE DEFINITIONS DELETED SYSROUTES: IC28688(AIX37), IC28984(AIX41) Tape devices defined as rmt are removed in error by the TSM ODM scripts when installing TSM ptfs. <@> IC29061 UNLOADDB SERVER HANG SYSROUTES: IC29061(AIX41),PQ44190(MVS41),IC29064(NT41),IC29065(HP41),IC29066(SUN41) The server 'dsmserv unloaddb' command can hang when being done to a tape device. The unload command dismounts the volume and then the server process never terminates. <@> IC29072 ANR9999D INVALID BLOCK HEADER MESSAGE ISSUED MULTIPLE TIMES SYSROUTES: TSM does not track the next block to read/write on the tape correctly when a drive is experiencing hardware problems and cannot locate on a tape. In the activity log you should see the ANR9999D Invalid Block Header message. This message is expected and informs the user of the hardware problems. Before taking any further action, dismount the volume from the drive and then attempt an AUDIT VOLUME. <@> IC29073 ANR9999D ALREADY REACHED EOV ONCE ON LTO DEVICES ON NT PLATFORM SYSROUTES: For LTO devices on the NT platforms, TSM does not handle the end-of-volume correctly under the following conditions: 1. TSM has written volumes to end-of-tape on this drive at least one time before. 2. TSM has written the current volume to the end-of-tape and encountered errors. In the activity log you should see the ANR9999D already reached EOV once message. <@> ********************************************************************** * WHERE TO FIND DOCUMENTATION * ********************************************************************** The BOOK CD contains the Tivoli Storage Manager Version 4 Release 1 Server and Client on-line library, in HTML and PDF format, for AIX, MVS, Windows NT, Sun Solaris and HP-UX. If you wish to use the PDF format, you can obtain the Adobe Acrobat Reader from the following site. http://www.adobe.com/prodindex/acrobat/readstep.html To install the Adobe Acrobat Reader on your platform, run the appropriate installation file, and follow the on-line installation instructions. Use the Adobe Acrobat Reader to view the index.pdf file. This file contains links to the 28 product pdf files. Click on the book title you want to view. To navigate back to the index.pdf file, press and hold the right mouse button, move the cursor to the "Go Back" selection, and release the mouse button. The books can also be obtained at the site http://www.tivoli.com/support/storage_mgr/tivolimain.html ******************************************************************************** * Getting Help * ******************************************************************************** For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: * Visit the Tivoli Storage Manager technical support Web site at http://www.tivoli.com/support/storage_mgr/tivolimain.html. * Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. You can access IBMLINK at http://www2.ibmlink.ibm.com. * Submit a problem management record (PMR) electronically at http://www.tivoli.com/support. See Reporting a Problem for details. * Send e-mail to support@tivoli.com. Customers in the United States can also call 1-800-TIVOLI8 (1-800-848-6548). For product numbers 5697-TS9, 5697-DRS or 5697-DPM call 1-800-237-5511. International customers should consult the Web site for customer support telephone numbers. You can also review the Customer Support Handbook, which is available on our Web site at http://www.tivoli.com/support/handbook/. When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site. The support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases. You can order documentation by e-mail at swdist@tivoli.com. Please provide the publication number, part number, or order number of the desired document. Alternatively, you can provide the document title, version number, and date of publication. We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please contact us in one of the following ways: * Send e-mail to pubs@tivoli.com. * Complete our customer feedback survey at http://www.tivoli.com/support/feedback. --------------------------------------------------------------------------- Reporting a Problem Please have the following information ready when you report a problem: * The Tivoli Storage Manager server version, release, modification, and service level number. You can get this information by entering the QUERY STATUS command at the TSM command line. * The Tivoli Storage Manager client version, release, modification, and service level number. You can get this information by entering dsmc at the command line. * The communication protocol (for example, TCP/IP), version, and release number you are using. * The activity you were doing when the problem occurred, listing the steps you followed before the problem occurred. * The exact text of any error messages. --------------------------------------------------------------------------- For the latest information about Tivoli Storage Manager, visit the home page on World Wide Web. The URL is: http://www.tivoli.com/support/storage_mgr/tivolimain.html --------------------------------------------------------------------------- To participate in user discussions of Tivoli Storage Manager: Subscribe to an Internet listserv forum. This is not officially supported by IBM, but IBM support people do participate in the discussions, along with other users. You can subscribe by sending a note to listserv@vm.marist.edu that contains the following command in the message body: SUBSCRIBE ADSM-L yourfirstname yourlastname Posts can then be sent to: adsm-l@vm.marist.edu --------------------------------------------------------------------------- Anonymous FTP server .................... IBM also supports an anonymous FTP server where you can find PTF maintenance and other related materials. Three other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are: service.boulder.ibm.com (primary - Colorado, IBM) ftp.rz.uni-karlsruhe.de (mirror - Germany) ftp.wu-wien.ac.at (mirror - Austria) ftp.cac.psu.edu (mirror - Pennsylvania) --------------------------------------------------------------------------- Performance Tuning for Tivoli Storage Manager The Tivoli Storage Manager V4.1 Performance Tuning Guide will be available on the home page. Point your web browser to this address: http://www.tivoli.com/support/storage_mgr/tivolimain.html ---------- Trademarks __________ (*) Trademark of the IBM Corporation in the United States and other countries.