================================================================================ README IBM Tivoli Storage Manager, Server & Storage Agent Version 5, Release 2, Modification Level 1. Licensed Materials - Property of IBM 5698-ISX (C) Copyright International Business Machines Corp. 1990, 2003. All rights rese US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp *=============================================================================| * This README is divided into the following sections: | *=============================================================================| * | | * | S=Server A=Storage Agent| * | B=Both | * |---------------------------| * | P | * FLG Section | A H L M A S W | * | I P N V S U I | * | X X X S E N N | *-------------------------------------------------|---|---|---|---|---|-- |---| * $$1 AIX OS level correction to Quickstart manual| B | | | | | | | * $$1 Win Language Pack Installation Changes | | | | | | | S | * Host Bus Adapter Recommendation | B | B | B | | | B | B | * Installation Notes - ALL | B | B | B | S | S | B | B | * Installation notes - AIX | B | | | | | | | * Installation notes - HPX | | B | | | | | | * Installation notes - LNX | | | B | | | | | * Installation notes - MVS | | | | S | | | | * Installation notes - PASE | | | | | S | | | * Installation notes - SUN | | | | | | B | | * Installation notes - WIN Server | | | | | | | S | * Installation notes - WIN Storage Agent | | | | | | | A | *-------------------------------------------------|---|---|---|---|---|---|---| * Java GUI client warning message | S | S | S | S | S | S | S | * Cancel Process notes | S | S | S | S | S | S | S | * 64-Bit Windows 2003 notes | | | | | | | B | * 3592 Support | B | | B | | | | B | * 3592 Support for z/OS | | | | S | | | | * 3494 library particulars/changes | S | S | S | | | S | S | * UTF8 TEC events | S | S | S | S | S | S | S | * LTO Generation 2 Support for PASE | | | | | S | | | * Unique TEC Events | S | S | S | S | S | S | S | * Summary Records Creation Functionality | B | B | B | S | S | B | B | * Summary Records Missing for Lan based | S | S | S | S | S | S | S | * Node DataWrite|ReadPath clarification | B | B | B | S | S | B | B | * QLogic 2300 support with Q SAN | | | | | | | B | * Windows SNIA License Agreement | | | | | | | B | * SUN DISK PERFORMANCE | | | | | | S | | * Automatic Labeling of Tape Volumes | S | S | S | | | S | S | * Label Libvol Listing for Scsi Libraries | S | S | S | | | S | S | * LanFree particulars | B | B | B | S | | B | B | * Display Limitations | B | B | B | | S | B | B | * Simultaneous Write Limitations | S | S | S | S | S | S | S | * Simultaneous Write may not remove failing | | | | | | | | * copy storage pool. | S | S | S | S | S | S | S | * NDMP File-Level Restore support for | | | | | | | | * international characters | S | S | S | | | S | S | * IBM Devices 3570, 3590, and Ultrium: | | | | | | | | * Required Minimum Level for Device Drivers | B | B | B | | | B | B | * Library Sharing and LAN-Free Upgrade | | | | | | | | * Considerations. | B | B | B | | | B | B | * Concurrent NDMP Backups of EMC Celerra Data | | | | | | | | * Movers using fibre attached DLT drives | S | S | S | | | S | S | * Archive Utilities Provided | S | S | S | S | S | S | S | * APARs fixed in 5.2.0, and not in 5.1.7 | S | S | S | S | S | S | S | *-------------------------------------------------|---|---|---|---|---|-- |---| * Fixed APARs from prior releases | B | B | B | S | S | B | B | * $$1 APARS fixed in service level 5.2.1 | B | B | B | S | S | B | B | * $$1 Admin Client Incorrect Server Level Display | B | B | B | B | B | B | B | *-------------------------------------------------|---|---|---|---|---|-- |---| * Where to find Documentation | B | B | B | S | S | B | B | * Getting Help | B | B | B | S | S | B | B | * Trademarks | B | B | B | S | S | B | B | *-------------------------------------------------|---|---|---|---|---|-- |---| * | A H L M P S W | * | I P N V A U I | * | X X X S S N N | * | E | *=============================================================================| * | * FLG Legend | * $$1 = Changes made for Modification level 1 | * | *-------------------------------------------------- ******************************************************************************** * $$1 AIX OS level correction to Quickstart manual ******************************************************************************** For IBM Tivoli Storage Manager v5r2 and later releases, AIX Operating System version 4 is not supported since it is scheduled to go out of service at the end of 2003. The Publications for IBM Tivoli Storage Manager v5r2 were frozen before the decision was made to not support AIX 4.3 with this release if the Storage Manager. We neglected to add this change to the "GA" README. ******************************************************************************** * $$1 Win Language Pack Installation Changes ******************************************************************************** As part of the ITSM 5.2.0 release, both the client and server moved all language support to separately installable language packages. This change has resulted in two issues with the Windows ITSM 5.2.0 Server package. The ITSM Server package does not include the language packages for the ITSM 5.2. Client. The language packages are located on the ITSM 5.2.0 Client CD. If you obtained the ITSM Server package electronically, the complete ITSM 5.2.0 Client package can be obtained from the same location and it contains the language packages. Installing a language package does not change the LANGUAGE option of any already existing ITSM server instances. For example: If you have a server running in English and install the Japanese language package the server will continue to ru in English. You must update the server's options file, stop and restart the serv to have the serve run in Japanese. Any new server instance defined after the appropriate language package is instal should default to the correct language. ******************************************************************************** * Host Bus Adapter recommendation ******************************************************************************** It is highly recommended that Tape Drives and Tape Libraries be connected to the system on their own host bus adapter and not share with other devices types (DIS CDROM, etc.). ******************************************************************************** * Installation Notes - ALL ******************************************************************************** There are no clarifications or corrections for this section. ******************************************************************************** * Installation Notes - AIX ******************************************************************************** Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level Atape device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers ******************************************************************************** * Installation Notes - HPX ******************************************************************************** 1. Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level ATDD device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers 2. Install HP-UX patch PHXK_27839: It is highly recommended to install the HP-UX kernel patch PHKL_27839 to correct a hang problem related to the TSM device driver (tsmscsi) and the manner in whic HP-UX locks storage for p-threaded applications. Here is the synopsis of this patch from HP: PHKL_27839: Symptoms: In a multi-threaded process, if one thread is doing raw or character device I/O, other threads in the process may fail to make forward progress until the I/O completes. Defect Description: The raw I/O routine was holding the process' virtual address space (vas) lock for the duration of the I/O, even though it was not needed for the normal case and only rarely needed for an exception case. This effectively blocked any other thread in the process which needed access to the vas lock, such as for another I/O, thread creation, mmap, thread exit, etc., for the duration of the I/O. When the I/O was to a slow device, such as a tape drive, this could be a considerable delay. Resolution: Eliminated use of the vas lock in the normal raw or character device I/O path, retaining its usage only for the rare exception case. ******************************************************************************** * Installation Notes - LNX ******************************************************************************** Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level IBMtape device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers ******************************************************************************** * Installation Notes - MVS ******************************************************************************** There are no clarifications or corrections for this section. ******************************************************************************** * Installation Notes - PASE ******************************************************************************** CHECKIN LIBVOLUME ----------------- There is a known problem with the CHECKIN LIBVOLUME command. The CHECKIN LIBVOLUME of a tape containing EXPORT data fails when using an LTO library volume from a TSM server other than the OS/400 PASE server. TSM servers on platforms other than OS/400 PASE may place additional labels on a tape if the barcode of the tape cartridge contains more than 6 characters. The TSM OS/400 PASE server can not read these extra labels. You can avoid the problem by using server-to-server export. If you must use an LTO device to create the export tape, you can do the following. 1) Define a TSM library of type MANUAL 2) Define an LTO tape drive into the manual library 3) Label a tape with 6 or less characters 4) Perform the export. SERVER CONSOLE -------------- There are limitations with the PASE screen session being used on the iSeries as the TSM console. The visible screen width is only 77 columns. If TSM outputs strings that are longer than the screen width, PASE will wrap the output. The F11 function key permits a user to toggle the PASE screen session between wrap and truncate. However, there are no function keys that permit a user to view output that has been truncated by PASE. Some output may not be formatted properly. This is being caused by the fact that both the TSM server and PASE are breaking up the line. When the server computes the amount of space for a line, it uses a value that assumes that the font is monospaced (all characters are the same width). However, the actual output characters vary in width and the longer lines are being wrapped by the PASE screen session. TSM has attempted to eliminate the case in which both PASE and TSM perform line breaks. However, the issue could not be completely resolved. TSM could only reduced the cases in which occurred. If TSM makes the console width too small, there are problems outputting the results of QUERY commands whe one or more of the column header strings is longer than the console width of the PASE screen session. The column header names in the output from a TSM QUERY command may not be formatted properly. When the server computes the amount of space for a line, it uses a value that assumes that the font is monospaced (all characters are the sa width). However, the actual output of the characters may vary in width sometime causing the output from QUERY commands to not appear to align correctly. Given the limitations of the PASE screen session, the TSM server can not generat output that can to be displayed properly in all cases. Therefore, the PASE scree session is not the recommended as the normal interface for the server and should only be used as the server console in a limited form. Instead, it is recommend that either the TSM WEB Administrative client or the TSM Command Line client be used as the interface to the TSM OS/400 PASE server. REQUIRED OS/400 V5R1 PTFs ------------------------- The following OS/400 V5R1 PTFs are required for TSM. SI04612 SI04626 SI03939 MF28967 SI01968 MF27490 MF27780 MF28208 Improving iSeries Disk Storage Pool Performance ----------------------------------------------- An enhancement was made for TSM in PASE for OS/400 V5R2, PTF MF30245. This enhancement allows greater write speed to disk storage pool volumes (i.e. backup performance.) With the above code the following OS/400 command must be run for all disk storage pool volumes. The command is: CHGATR OBJ('/path/stgpoolfile') ATR(*MAINSTGOPT) VALUE(*MINIMIZE) Prior to this PTF, OS/400 would read the portion of disk to be written to (due to the single level store architecture of OS/400) before the write, doubling the I/O required with a read that is not needed. DRIVESELECTION=OPERATOR ----------------------------------------------- If the device configuration file has "DRIVESELECTION=OPERATOR" for a library of type manual, a RESTORE DB fails. A message requesting a mount of a tape volume repeats until the resource timeout is reached, then a failure message is posted. This happens even though the required tape is mounted. Currently there is no way to reply that the volume is mounted. The error will occur on other stand alone server operations that make use of the device configuration. To avoid this problem, use "DRIVESELECTION=AUTOAMTIC" which is the default for the TSM DEFINE LIBRARY command. ******************************************************************************** * Installation Notes - SUN ******************************************************************************** 1. If the server package (TIVsmS) is installed before the Sun Language Support, and the locale is set to a non-english setting, these errors will be displayed: ANR0915E Unable to open language JA_JP for message formatting. Error opening catalog ./dsmja_jp.cat, for language ja_jp If the server package (TIVsmS) is installed before the Sun Server LICENSES, this warning will be displayed: ANR9613W Error loading /opt/tivoli/tsm/server/bin//./dsmreg64.sl for Licensing function: ld.so.1: ./dsmserv: fatal error: /opt/tivoli/tsm/server/bin//./dsmreg64.sl: open failure: No file nor directory exists. These messages can be ignored, the order the packages are installed does not affect the success of the install. 2. To users wishing to run the TSM Solaris server in a TSM supported language other than the default language, en_US: The LANGUAGE option in the server options file is not a valid option for the TSM Solaris server. If the LANGUAGE option is specified, it will be ignored by the server. The server trys to start the language specified in the system language environment variable. This environment variable can be specified by issuing from the system prompt, 'export LC_ALL=xx', where 'xx' is the locale. The server will run with the specified language if 1) The locale has been installed on the system. 2) The locale is supported by TSM. 3) The appropriate TSM Server language package has been installed. With V5.2.0, the description for using the LANGUAGE option in the sample file, 'dsmserv.opt.smp', is removed. The "Administrator's Reference" manual will be updated in a future release of the publication to also remove the LANGUAGE option description. Refer to the TSM Solaris Server "Quick Start" manual, Appendix 'C' for instructions of how to start the server in a language other than the server's default language. 3. Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level IBMTape device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers ******************************************************************************** * Installation Notes - WIN Server ******************************************************************************** NLS Limitations --------------- When a DBCS character is specified in the description field of a schedule, the schedule cannot be created from scheduling wizard of the TSM Management Console. There is currently a TSM restriction on the type of strings that can be used in various supplemental information fields of TSM objects such as schedules. This is to be addressed in a future release of TSM. To avoid such errors, do not use DBCS characters in the supplemental information fields of TSM objects. Users can avoid the problem by creating schedules from WEB Administrative Client Extra empty directories are created when characters, which have x5C in their character codes, are specified at server volume creation in the Server Initialization Wizard. of the TSM Management console. For example when specifying following location; ( + means a DBCS character which has x5C in its character code) Initial database volume = c:\+ab+ab+ab+ab+\server3\db1.dsm TSM server initialization fails and server is not configured in this case. To avoid this problem, users should not specify DBCS characters which have x5C in their character codes during server volume creation. In additions, if you were to install the TSM server into directory d:\xyz\tivoli\tsm (where xyz are three DBCS characters) by selecting custom install, the TSM Management Console encounters problems. Given the complex nature and size of this issue, it will be addressed in the next release of TSM. To avoid such errors, do not use DBCS characters in the names on directories used by the TSM server. Windows Media Labeling Wizard ----------------------------- The Media Labeling wizard of the TSM Management Console for Windows does not support the labeling of tapes in non-IBM LTO devices. The TSM LABEL LIBVOLUME command should be used to label tapes in such devices. Minimum Level for Device Drivers -------------------------------- Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level IBM device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers Minimum Level for Device Drivers -------------------------------- Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives: The minimum level IBM device driver must be installed BEFORE installing TSM 5.2. See the section of this readme entitled IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Drivers ******************************************************************************** * Installation Notes - WIN Storage Agent ******************************************************************************** The .msc file that controls the TSM Management Console has been updated as part of this release. In the prior version, the "Device Manager" snapin was not translated into the appropriate language. However, the new version of the .msc file is not automatically installed by the Windows Installer. Because the .msc is modified each time you invoke the TSM Management Console, the Windows Installer will not replace it. In addition, the file also contains information about storage agents and machines you have added. If you choose to use the updated .msc file, you must copy it from the product CD and then add again any storage agents and machines you had previously added to the earlier version of the console. ******************************************************************************** * Java GUI client warning message ******************************************************************************** The following warning may appear on the server console each time an operation button is chosen on the Java GUI client. The Java GUI client will function correctly despite this message: " ANR0530W Transaction failed at node xxxxx (xxxxx) session x. Internal server e ******************************************************************************** * Cancel Process notes ******************************************************************************** Cancelling a process with pending mount requests: Some processes, such as reclamation, will generate mount requests in order to complete processing. A mount request indicates that a volume is needed for the current process but the volume is not available in the library. The move media command, checkout libvolume, and manually removing the volume from the library are some of the ways to put a volume into this situation. The background process typically will not continue processing until the mount request has been resolved If a process has a pending mount request, the process may not respond to a cance process command until the mount request has been answered (replied) or cancelled This is due to the process code waiting on a response from the volume repository and the volume repository is waiting on a response from the administrator to the mount request. If a process does not respond to the cancel process command, it may be blocked a described above. Query Request will list the open requests. Querying the activity log will also help in determining if a given process has a pending moun request. The cancel process command will be handled only after the mount reques has been answered by using either of the Reply or Cancel Request commands, or th mount request has timed out. In order to cancel a process with a pending mount request, it is recommended tha the cancel process command is issued before the cancel request command. By issuing the cancel process first, a timing window is avoided where another mount request could be issued before the cancel process command is issued. ******************************************************************************** * 64-Bit Windows 2003 notes ******************************************************************************** The TSM server was ported from Windows 32-bit to Windows 64-bit to allow optimum performance in the Windows 64-bit environment. The TSM Storage Agent and MMC Console Snapin will remain Windows 32-bit applications. The 64-bit TSM server requires appropriate 64-bit hardware and the Windows 2003 64-bit operating system. Windows XP 64-bit is not supported. The 64-bit TSM server is functionally identical to the 32-bit TSM server with the following exceptions: 1) ACSLS libraries are not supported. 2) The IBM 3494 library is currently not supported on the 64-Bit version of Windows 2003. IBM 3494 support is limited to Windows 2000 and 32-Bit versions of Windows 2003. 3) The SNMP interface is not supported. 4) The Windows system functions, such as Device Manager, are not available with the 32-bit Console. Normal Windows system functions are still available using Windows "Manage Computer". 5) User written "Exit" DLL's must be 64-bit. A Windows 64-bit process cannot load a 32-bit DLL. ******************************************************************************** * 3592 Support ******************************************************************************** Support for 3592 drives is now included. Capacity: The new drives have a media capacity of 300GB per cartridge of uncompressed data and a media capacity of ~900GB per cartridge for compressed data. Device Class Information: In order to utilize this new hardware through TSM, the devtype and format values need to be known. Thus, when defining a devclass that uses 3592 drives, use: - devtype=3592 - format= NOTE: The 3592 format is uncompressed. If this format uses the tape drive hardware compression feature, depending on the effectiveness of compression, the actual capacity may be greater than 300GB. >>-DEFine DEVclass--device_class_name---------------------------> >--LIBRary--=--library_name--DEVType--=--3592-------------------> .-FORMAT--=--DRIVE-----. >--+----------------------+--+----------------------+-----------> '-FORMAT--=--+-DRIVE-+-' '-ESTCAPacity--=--size-' +-3592--+ '-3592C-' .-PREFIX--=--ADSM-------------------. >--+-----------------------------------+------------------------> '-PREFIX--=--+-ADSM---------------+-' '-tape_volume_prefix-' .-MOUNTRetention--=--60------. .-MOUNTWait--=--60------. >--+----------------------------+--+-----------------------+----> '-MOUNTRetention--=--minutes-' '-MOUNTWait--=--minutes-' .-MOUNTLimit--=--DRIVES-----. >--+---------------------------+------------------------------->< '-MOUNTLimit--=--+-DRIVES-+-' +-number-+ '-0------' ******************************************************************************** * 3592 Support for z/OS ******************************************************************************** Support for IBM 3592 tape drive on ITSM for z/OS is available with the 3592 device class. Look for 3592 hardware announcement material and availability dates on ibm.com Note: Web help for 3592 device class will be available in subsequent service deliverables. DEFINE DEVCLASS -- 3592 Authorization To issue this command, you must have system privilege or unrestricted storage privilege. Format >>-DEFine DEVclass--device_class_name---------------------------> >--+--------------------------+--DEVType--=--3592---------------> '-LIBRary--=--library_name-' .-FORMAT--=--3592C-----. .-ESTCAPacity--=--300G-. >--+----------------------+--+----------------------+-----------> '-FORMAT--=--+-3592C-+-' '-ESTCAPacity--=--size-' +-3592--+ '-DRIVE-' .-MAXCAPacity--=--0----. >--+----------------------+-------------------------------------> '-MAXCAPacity--=--size-' .-PREFIX--=--ADSM-------------------. >--+-----------------------------------+------------------------> '-PREFIX--=--+-ADSM---------------+-' '-tape_volume_prefix-' .-MOUNTRetention--=--60------. .-MOUNTWait--=--60------. >--+----------------------------+--+-----------------------+----> '-MOUNTRetention--=--minutes-' '-MOUNTWait--=--minutes-' .-MOUNTLimit--=--2------. >--+-----------------------+--+------------------------+--------> '-MOUNTLimit--=--number-' '-EXPiration--=--yyyyddd-' .-PROtection--=--No------------. >--+--------------------+--+------------------------------+-----> '-RETention--=--days-' '-PROtection--=--+-No--------+-' +-Yes-------+ '-Automatic-' .-UNIT--=--3592------. >--+--------------------+-------------------------------------->< '-UNIT--=--unit_name-' Parameters device_class_name (Required) Specifies the name of the device class to be defined. The maximum length of the device class name is 30 characters. LIBRary Specifies the name of the defined library object that contains the tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command. Notes: 1. Use this field for a LAN-free configuration. 2. If the library has a library type of SHARED, the primary library manager server must have a matching device class definition. DEVType=3592 (Required) Specifies the 3592 device type is assigned to the device class. FORMAT Specifies the recording format to be used when writing data to sequential access media. This parameter is optional. The default value is 3592C. Note: For LAN-free configurations, you must specify the exact drive type in the FORMAT parameter. This drive type corresponds to the drives used by the storage agent in an external library configuration. The following table lists the recording format options for 3592 devices: Table 1. Recording Formats for 3592 +----------------+----------------------------------------------------+ | Format | Description | +----------------+----------------------------------------------------+ | 3592C | Compressed format | +----------------+----------------------------------------------------+ | 3592 | Uncompressed (basic) format | +----------------+----------------------------------------------------+ | DRIVE | The server selects the highest format that is | | | supported by the drive on which a volume is | | | mounted. Attention: Avoid specifying DRIVE when a | | | mixture of drives is used within the same library. | | | For example, do not use this option for a library | | | containing some drives that support recording | | | formats superior to other drives. | +---------------------------------------------------------------------+ | Note: If this format uses the tape drive hardware compression | | feature, depending on the effectiveness of compression, the actual | | capacity may be greater than the listed value. | +---------------------------------------------------------------------+ If the drives are in a library that includes drives of different tape technology, do not use the DRIVE value. Use the specific format that the drives use. Note: You must specify the exact drive type in the FORMAT parameter. This drive type corresponds to the drives used by the storage agent in an external library configuration. ESTCAPacity Specifies the estimated capacity for the volumes assigned to this device class. This parameter is optional. You can specify this parameter if the default estimated capacity for the device class is inaccurate due to compression of data. The default estimated capacity is 300GB. Note: This value is ignored if you specify a value other than 0 in the MAXCAPACITY parameter. If the server uses the value specified in the ESTCAPACITY parameter, this value does not determine the amount of data stored on the volume, but only determines the usage before the volume is filled. After a volume is full, the actual amount of data stored on the tape is used for these calculations. You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K). For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. MAXCAPacity Specifies the maximum amount of data the server can store in the volumes categorized by this device class. This parameter is optional. The default is 0. If the MAXCAPACITY parameter is chosen and the server detects an end-of-tape situation for the specified volume, a warning message is issued and the tape is treated as full. 0 Specifies that the volume will be filled to the physical end of the volume. size Specify the maximum capacity of the volume. The capacity must be specified as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). Set the capacity to a nonzero value less than the maximum capacity of the tape to avoid an end-of-tape situation. PREFIX Specifies the high-level qualifier of the data set name that the server writes into the sequential access media labels. For each sequential access volume assigned to this device class, the server uses this prefix to create the data set name. This parameter is optional. The default value is ADSM. The maximum length of this prefix is 8 characters. If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions. An example of a tape volume data set name using the default prefix is ADSM.BFS. MOUNTRetention Specifies the amount of time, in minutes, to retain an idle tape volume before dismounting it. Mount retention time begins after the idle time-out period has expired. This parameter is optional. The default value is 60. You can specify a number from 0 to 9999. This parameter can improve response time for tape mounts by leaving the previously mounted volume online. MOUNTWait Specifies the maximum number of minutes to wait for a sequential access volume to be mounted. This parameter is optional. If the mount request is not satisfied within the specified amount of time, the mount request is canceled. The default value is 60 minutes. You can specify a number from 0 to 9999. MOUNTLimit Specifies the maximum number of tape volumes that can be simultaneously mounted for a device class. This parameter is optional. The default value is 2. You can specify a number from 1 to 256. You cannot share drives between device classes (that is, the sum of your mount limits should not be more than the number of physical drives allocated to the server). EXPiration Specifies the expiration date that is placed on the tape labels for this device class. This parameter is optional. There is no default value. If you specify this parameter, enter the expiration date when the server no longer requires the tape. The server does not use this information, however; this information is passed to the operating system for use by MVS or tape management systems. If you specify this parameter, you cannot specify the RETENTION parameter. Enter the value as shown: yyyyddd Specifies the expiration date for this device class, in YYYYDDD format. For example, January 7, 2004 is 2004007 (the seventh day of year 2004). RETention Specifies the number of days to retain the tape. This parameter is optional. You can specify a number from 1 to 9999. If you specify this parameter, enter the number of days that equals the length of time the server is expected to use the tape. The server does not use this information, but the information is passed to the operating system for use by MVS or tape management systems. If you specify this parameter, you cannot specify the EXPIRATION parameter. PROtection Specifies whether RACF, if installed, protects volumes assigned to this device class. If protection is provided, RACF profiles are created for the volumes. This parameter is optional. The default value is NO. Possible values are: No Specifies that RACF does not protect 3592 volumes assigned to this device class. Yes Specifies that RACF protects 3592 volumes assigned to this device class. RACF profiles are created for volumes when the server first uses the volumes, but the profiles are not deleted when volumes are deleted from the server. Profiles will have to be manually deleted. Automatic Specifies that RACF protects 3592 volumes assigned to this device class. RACF profiles are deleted when volumes are deleted from the server. Important: If you specify PROTECTION=AUTOMATIC, volumes deleted from the server will no longer be RACF-protected and the data on these volumes will be accessible by other users. If you specify PROTECTION=AUTOMATIC, the server will issue RACROUTE commands to delete profiles when a volume is deleted from the server. The deletion commands issued will depend on the current system settings for TAPEVOL and TAPEDSN. If the system settings are changed, the server may not delete existing profiles. See the following note for more information on this parameter. Note: If sensitive data is stored on volumes assigned to this device class, it is recommended that PROTECTION=YES be specified and that RACF profiles be manually deleted after tape cartridges have been erased. The profiles created when you specify PROTECTION=YES or PROTECTION=AUTOMATIC depend on the system RACF settings. The protection provided is the same as using PROTECT=YES in JCL. If RACF is active and both TAPEVOL and TAPEDSN are inactive, allocation of tapes will fail. See RACF Security Administrator's Guide for more information on the TAPEVOL and TAPEDSN settings and the profiles that will be created when they are active. Profile creation and deletion occur based on the protection setting when the volume is first used and when it is deleted. The server does not attempt to create profiles for volumes that it has already used. If protection is set to AUTOMATIC, the server will attempt to delete profiles when volumes are deleted. It is not recommended that you change protection to AUTOMATIC for a device class that has been set to NO. Volumes without profiles may exist and error messages will be generated when volumes are deleted. If a different value is required, a new device class should be defined. UNIT Specifies an esoteric unit name to specify a group of tape devices that support 3592 tape. This parameter is optional. The default value is 3592. This name can be as many as 8 characters. For LAN-free configuration, use the unit name that represents the subset of drives that are attached to z/OS in the library. UPDATE DEVCLASS -- 3592 Authorization To issue this command, you must have system privilege or unrestricted storage privilege. Format (1) >>-UPDate DEVclass--device_class_name---------------------------> >--+--------------------------+--+----------------------+-------> '-LIBRary--=--library_name-' '-FORMAT--=--+-3592C-+-' +-3592--+ '-DRIVE-' >--+----------------------+--+----------------------+-----------> '-ESTCAPacity--=--size-' '-MAXCAPacity--=--size-' >--+----------------------------+--+-----------------------+----> '-MOUNTRetention--=--minutes-' '-MOUNTWait--=--minutes-' >--+-----------------------+--+------------------------+--------> '-MOUNTLimit--=--number-' '-EXPiration--=--yyyyddd-' >--+--------------------+--+------------------------------+-----> '-RETention--=--days-' '-PROtection--=--+-No--------+-' +-Yes-------+ '-Automatic-' >--+--------------------+-------------------------------------->< '-UNIT--=--unit_name-' Notes: 1. You must specify at least one optional parameter on this command. Parameters device_class_name (Required) Specifies the name of the device class to be updated. The maximum length of the device class name is 30 characters. LIBRary Specifies the name of the defined library object that contains the tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command. Notes: 1. Use this field for a LAN-free configuration. 2. If the library has a library type of SHARED, the primary library manager server must have a matching device class definition. FORMAT Specifies the recording format to be used when writing data to sequential access media. This parameter is optional. The following table lists the recording format options for 3592 devices: Table 1. Recording Formats for 3592 +----------------+----------------------------------------------------+ | Format | Description | +----------------+----------------------------------------------------+ | 3592C | Compressed format | +----------------+----------------------------------------------------+ | 3592 | Uncompressed (basic) format | +----------------+----------------------------------------------------+ | DRIVE | The server selects the highest format that is | | | supported by the drive on which a volume is | | | mounted. Attention: Avoid specifying DRIVE when a | | | mixture of drives is used within the same library. | | | For example, do not use this option for a library | | | containing some drives that support recording | | | formats superior to other drives. | +---------------------------------------------------------------------+ | Note: If this format uses the tape drive hardware compression | | feature, depending on the effectiveness of compression, the actual | | capacity may be greater than the listed value. | +---------------------------------------------------------------------+ If the drives are in a library that includes drives of different tape technology, do not use the DRIVE value. Use the specific format that the drives use. ESTCAPacity Specifies the estimated capacity for the volumes assigned to this device class. This parameter is optional. You can specify this parameter if the default estimated capacity for the device class is inaccurate due to compression of data. Note: This value is ignored if you specify a value other than 0 in the MAXCAPACITY parameter. If the server uses the value specified in the ESTCAPACITY parameter, this value does not determine the amount of data stored on the volume, but only determines the usage before the volume is filled. After a volume is full, the actual amount of data stored on the tape is used for these calculations. You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K). For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. MAXCAPacity Specifies the maximum amount of data the server can store in the volumes categorized by this device class. This parameter is optional. If the MAXCAPACITY parameter is chosen and the server detects an end-of-tape situation for the specified volume, a warning message is issued and the tape is treated as full. 0 Specifies that the volume will be filled to the physical end of the volume. size Specify the maximum capacity of the volume. The capacity must be specified as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). Set the capacity to a nonzero value less than the maximum capacity of the tape to avoid an end-of-tape situation. MOUNTRetention Specifies the amount of time, in minutes, to retain an idle tape volume before dismounting it. Mount retention time begins after the idle time-out period has expired. This parameter is optional. You can specify a number from 0 to 9999. This parameter can improve response time for tape mounts by leaving the previously mounted volume online. MOUNTWait Specifies the maximum number of minutes to wait for a sequential access volume to be mounted. This parameter is optional. If the mount request is not satisfied within the specified amount of time, the mount request is canceled. You can specify a number from 0 to 9999. MOUNTLimit Specifies the maximum number of tape volumes that can be simultaneously mounted for a device class. This parameter is optional. You can specify a number from 1 to 256. You cannot share drives between device classes (that is, the sum of your mount limits should not be more than the number of physical drives allocated to the server). EXPiration Specifies the expiration date that is placed on the tape labels for this device class. This parameter is optional. There is no default value. If you specify this parameter, enter the expiration date when the server no longer requires the tape. The server does not use this information, however; this information is passed to the operating system for use by MVS or tape management systems. If you specify this parameter, you cannot specify the RETENTION parameter. Enter the value as shown: yyyyddd Specifies the expiration date for this device class, in YYYYDDD format. For example, January 7, 2004 is 2004007 (the seventh day of year 2004). RETention Specifies the number of days to retain the tape. This parameter is optional. You can specify a number from 1 to 9999. If you specify this parameter, enter the number of days that equals the length of time the server is expected to use the tape. The server does not use this information, but the information is passed to the operating system for use by MVS or tape management systems. If you specify this parameter, you cannot specify the EXPIRATION parameter. PROtection Specifies whether RACF, if installed, protects volumes assigned to this device class. If protection is provided, RACF profiles are created for the volumes. This parameter is optional. Possible values are: No Specifies that RACF does not protect 3592 volumes assigned to this device class. Yes Specifies that RACF protects 3592 volumes assigned to this device class. RACF profiles are created for volumes when the server first uses the volumes, but the profiles are not deleted when volumes are deleted from the server. Profiles will have to be manually deleted. Automatic Specifies that RACF protects 3592 volumes assigned to this device class. RACF profiles are deleted when volumes are deleted from the server. Important: If you specify PROTECTION=AUTOMATIC, volumes deleted from the server will no longer be RACF-protected and the data on these volumes will be accessible by other users. If you specify PROTECTION=AUTOMATIC, the server will issue RACROUTE commands to delete profiles when a volume is deleted from the server. The deletion commands issued will depend on the current system settings for TAPEVOL and TAPEDSN. If the system settings are changed, the server may not delete existing profiles. See the following note for more information on this parameter. Note: If sensitive data is stored on volumes assigned to this device class, it is recommended that PROTECTION=YES be specified and that RACF profiles be manually deleted after tape cartridges have been erased. The profiles created when you specify PROTECTION=YES or PROTECTION=AUTOMATIC depend on the system RACF settings. The protection provided is the same as using PROTECT=YES in JCL. If RACF is active and both TAPEVOL and TAPEDSN are inactive, allocation of tapes will fail. See RACF Security Administrator's Guide for more information on the TAPEVOL and TAPEDSN settings and the profiles that will be created when they are active. Profile creation and deletion occur based on the protection setting when the volume is first used and when it is deleted. The server does not attempt to create profiles for volumes that it has already used. If protection is set to AUTOMATIC, the server will attempt to delete profiles when volumes are deleted. It is not recommended that you change protection to AUTOMATIC for a device class that has been set to NO. Volumes without profiles may exist and error messages will be generated when volumes are deleted. If a different value is required, a new device class should be defined. UNIT Specifies an esoteric unit name to specify a group of tape devices that support 3592 tape. This parameter is optional. This name can be as many as 8 characters. For LAN-free configuration, use the unit name that represents the subset of drives that are attached to z/OS in the library. ******************************************************************************** * 3494 library particulars/changes ******************************************************************************** Support for the 3494 library has been altered to make the support more robust. The changes made affect how 3494 library objects should be defined and used. These changes, outlined below, should be transparent except to those with both 3490 and 3590 drives in their library. However, for 3494 libraries with two device types (any combination of 3490, 3590, and 3592) the following idea has to be followed: one device type per library object. Thus, for 3592 support, a new library object will have to be made for these drives. Refer to the below three bullets for more information. Users with 3490s and 3590s currently defined to t same library object also need to pay close attention to the upgrade procedures below. 1) 3494 library objects now only support one unique device type at a time. Therefore, if you have a 3494 library with both 3490 and 3590 drives, you nee two library objects that have paths to the same physical library (same device parameter), but each with separate drives - one for 3490 drives, and one for 3590 drives. Each of these library objects need separate and distinct private and scratch categories - this is a necessity for scratch categories. These categories should not overlap with any other library on TSM and neither category should overlap with another application that is manipulating the 349 library or the volumes in the library. For previously defined libraries this new distinction will not require any us intervention or changes to update the library objects that only contain 3590 3490 drives (not both). Library objects that do currently have 3490 and 3590 drives defined will need to follow steps to separate this object into two distinct library objects. These upgrade steps are described under upgrade procedures. 2) Because a library object will now only have one device type of drives, the devType parameter in both LABEL LIBVOL and CHECKIN LIBVOL commands is no long necessary unless there are no drives defined in the library object. In this case, where no drives are defined, the devType parameter must be given or els the LABEL LIBVOL and CHECKIN LIBVOL commands will fail. The devType paramete can still be provided in all cases, it is just not needed when drives are defined in the library. 3) The scratch category for 3590 drives is now the scratch category provided whe the library object is defined. It is no longer implicitly one greater than the 3490 scratch category (enabled by the ENABLE3590SUPPORT option). Thus, ENABLE3590SUPPORT is no longer needed in the options file, and this option is ignored. For previously defined libraries with 3590 drives that used this implicit scratch category, all queries on the library object will reflect the correct 3590 scratch category explicitly. Therefore, if you used the default 300 for private, 301 for 3490 scratch, and implicit 302 3590 scratch, then queries previously would show 301 as the library's scratch category. Now, 302 would be shown as the scratch category. UPGRADE PROCEDURE: ------------------ The following steps below describe the upgrade procedure when a defined librar object from a previous release had both 3490 and 3590 drives defined. In this situation the current library object will be updated as your 3590 library object. The following additional steps by the user must be implemented to continue use of 3490 drives and volumes. Again, these steps need only be take if your current library has both 3490 and 3590 drives. 1) Checkout all of your 3490 scratch volumes from the TSM library object. Now 2) Delete all 3490 drives and 3490 drive paths pertaining to this library. 3) Define a new TSM library object which you will use for 3490 drives and volumes. Make sure this new library has a different scratch category and t SAME private category as your original library. If you want your new libra to have a different private category as well you will have to repeat step 1 with your private 3490 volumes. 4) Redefine all of the 3490 drives and paths deleted in step 2 to your new library. 5) Checkin all of the 3490 scratch volumes previously checked out in step 1. 6) Checkin all of the 3490 private volumes. 7) Update your 3490 device class to point to the new library. ******************************************************************************** * UTF8 TEC events ******************************************************************************** IC35676 -- TSM now sends UTF8 encoded events to TEC. Some patches for the Tivoli Enterprise Console (TEC) now require UTF8 encod events to support some locales. Patch 0004 for TEC v3.6.2 is an example. TSM now supports the option to send UTF8 encoded events. To enable this option, add the following to the server options file (dsmserv.opt): TECUTF8event Yes This will enable the TSM server to encode the TEC event into UTF8 before issuing the event to the TEC server. Syntax: TECUTF8event Yes | No default: No Query OPTion will display whether or not this option is enabled. ******************************************************************************** * LTO Generation 2 Support for PASE ******************************************************************************** TSM now includes support for the second generation of LTO hardware. This suppor was introduced at 5.1.7.0 and is supported by any level released later; however, any attempt to use LTO2 devices on a lower level than 5.1.7.0 is not supported. Capacity: The new drives have a media capacity of 200GB per cartridge of uncompressed data and a media capacity of 400GB per cartridge for compressed data. Device Class Information: In order to utilize this new hardware through TSM, keep in mind that this is sti an LTO device. Thus, when defining a devclass that uses LTO2 drives, use: - devtype=LTO - format= NOTE: The ULTRIUM2 format is uncompressed. If this format uses the tape drive hardware compression feature, depending on the effectiveness of compression, the actual capacity may be greater than 200GB. >>-DEFine DEVclass--device_class_name---------------------------> >--LIBRary--=--library_name--DEVType--=--LTO--------------------> .-FORMAT--=--DRIVE---------. >--+--------------------------+--+----------------------+-------> '-FORMAT--=--+-DRIVE-----+-' '-ESTCAPacity--=--size-' +-ULTRIUM---+ '-ULTRIUM2--' .-PREFIX--=--ADSM-------------------. >--+-----------------------------------+------------------------> '-PREFIX--=--+-ADSM---------------+-' '-tape_volume_prefix-' .-MOUNTRetention--=--60------. .-MOUNTWait--=--60------. >--+----------------------------+--+-----------------------+----> '-MOUNTRetention--=--minutes-' '-MOUNTWait--=--minutes-' .-MOUNTLimit--=----1--------. >--+---------------------------+------------------------------->< '-MOUNTLimit--=--+-number-+-' Upgrading from LTO to LTO2 devices: When migrating from LTO to LTO2 devices, you need to follow one of the set of steps below: - If you are maintaining both generations simultaneously, LTO gen1 and LTO gen2, then you need to logically partition your library such that the drives of these two generations are disjoint. - If you are upgrading all your drives to LTO gen2, then 1. Delete all your old LTO gen1 drive definitions as well as any paths associated with these old drive definitions. 2. Define the new LTO2 drives and paths associated with the new hardware NOTE: LTO gen2 drives are backwards read compatible as well as backwards write compatible. Therefore, you do NOT need to mark your LTO gen1 media as "read only". ******************************************************************************** * Unique TEC Events ******************************************************************************** Two server options have been added to control the format of events sent from Tivoli Storage Manager (TSM) to the Tivoli Enterprise Console (TEC). UNIQUETECevents YES | NO -and- UNIQUETDPtecevents YES | NO The default setting for both options is "NO" Setting UNIQUETDPtecevents to YES will dynamically set UNIQUETECevents to YES. The server options file will not be updated to reflect this change, though. Enabling either option changes the event class format for events sent to the TEC by the TSM server. By enabling either option, a unique event class will be generated for each individual TSM message. This includes client and TDP agent messages in addition to the server messages. Enabling one or both of these options may facilitate rule evaluation performance on the TEC server. Enabling one or both of these options may also incur a performance penalty during event reception on the TEC server. Different customers have encountered differing results, so evaluation of end effects on your environment will be required. Not all customers will realize benefit from enabling either of these two new options. Unique events will have an event class format of: TSM_SERVER_ANR#### TSM_CLIENT_ANE#### TSM_TDP_DOMINO_ACD#### etc... where #### represents the message number if the UNIQUETDPtecevents option is enabled, the following TDP agents will have unique events generated for their messages logged to the TSM Server as follows: TSM_TDP_SAP_R3_BKI#### (also covers TDP for ESS for SAP R3 messages) TSM_TDP_ESS_DB2_EEP#### TSM_TDP_ESS_ORACLE_EEO#### Please examine the appropriate BAROC file for exact details of the event class format. TDP Agents may issues unique events in the following ranges: Note - all events follow the IBM3.4 naming convention of a three character prefix followed by four digits. EXCHANGE -- ACN3500 -> ACN3649 DOMINO -- ACD5200 -> ACD5299 SQL -- ACO3000 -> ACO3999 ORACLE -- ANS0500 -> ACO0599 INFORMIX -- ANS0600 -> ANS0699 if UNIQUETDPtecevents is enabled: SAP R3 -- BKI0000 -> BKI9999 (also includes ESS for SAP R3 messages) ESS DB2 -- EEP0000 -> EEP9999 ESS ORACLE -- EEO0000 -> EEO0000 Again, please note that enabling UNIQUETDPtecevents will also enable UNIQUETECevents, and all recognized TDP messages will be sent as unique events from the TSM Server. The TEC administrator must create a rule base using the appropriate BAROC file for the option(s) selected on the TSM Server. * If neither of these options are selected, or are set to "NO" use the ibmtsm.baroc file. * If only the UNIQUETECevents option is set to "YES" use the itsmuniq.baroc file. * If the UNIQUETDPtecevents option is set to "YES" use the itsmdpex.baroc file. Each successive baroc file accepts the events of the previous baroc file. In other words, "itsmuniq" accepts all events in "ibmtsm". "itsmdpex" accepts all events contained in "itsmuniq". Note for MVS users: itsmuniq.baroc and itsmdpex.baroc are listed as ANRBARUN and ANRBARDP in the SAMPLIB. ******************************************************************************** * Summary Records Creation Functionality ******************************************************************************** When using the lan based TSM Backup/Archive client, one summary record is create for each client operation (Backup/Restore/Archive/Retrieve). For example, if a backup operation uses multiple sessions to accomplish the backup, only one recor is created. When using TDP or an API client, one record is created for each session that moves data. For example, if a backup via a TDP has 3 sessions, 3 records are created. When data is backed up via the LAN-free mechanism, (either via the TSM Backup/Archive client or a TDP or API client) one record is created for each session that moves data. In this example, if a LAN-free backup had 3 sessions, 3 records would be created. ******************************************************************************** * Summary Records Missing for Lan based TSM Backup-Archive Client Sessions ******************************************************************************** TSM Summary table problems are corrected with the application of fixes for Serve APAR IC35693 (4.2.3.4 or 5.1.6.3) and Client APAR IC34693. Both must be applied to resolve existing issues with Summary Table processing. Notes: Client events must be enabled to the Activity log or Console receivers for Lan based TSM Backup/Archive clients to generate Activity.Summary table records. By default, events are enabled and will only be disabled if actions have been taken to disable events. This is unique to Lan based TSM Backup/Archive clients only. TDP, API and Lan-free client processing is not activated by the client events. To verify if events are enabled for a client node, issue the following query command on the TSM server: query enabled actlog node= or query enabled console node= To enable events for a client node, issue the following command on the TSM serve enable events actlog all node= or enable events console all node= Apar IC35693 provides additional tracing capability for Summary Table processing and tracing should be enabled if problems are encountered with summary tables. order to collect the enhanced diagnostic data, tracing should be enabled with trace classes 'systime session txn accnt' during the entire timeframe the proble node is executing an operation (Backup/Restore/Archive/Retrieve). ******************************************************************************** * Node DataWrite|ReadPath clarification ******************************************************************************** Two parameters have been added to node definitions to control data operations. DATAWritepath= default: ANY DATAReadpath= default: ANY These two parameters control whether data is allowed to be written or read by a node for a specific data path. "ANY" will allow any type of data movement to occur for the node. 'Any' is is the default behavior. "LAN" restricts data flow to the classic LAN path only. "LANFree" restricts data flow to LanFree operations. "SERVerfree" restricts data flow to either LAN or ServerFree operations. For example, setting a Node's DATAWritepath to "LAN" and DATAReadpath to "ANY" will only allow LAN store operations, but will allow any type of operation for a read. These parameters are part of the Register Node & Udate Node commands. A Query Node format=detailed command will show the current values for the parameters. ******************************************************************************** * QLogic 2300 support with Q SAN ******************************************************************************** The QLogic 2300 is now supported with the Query SAN command, the San Device Mapping feature, and with the Server-Free function all on Windows. ******************************************************************************** * Windows SNIA License Agreement ******************************************************************************** THIRD PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. All third party components, including third party components included or embedded in the product, are provided to you by IBM on an "AS-IS" basis. IBM expressly disclaims all implied warranties, including the implied warranties of merchantability, fitness for a particular purpose and non-infringement. IBM will not indemnify you or be liable for any incidental, indirect, special, exemplary, punitive or consequential damages resulting from third-party claims alleging patent or copyright infringement by any third party components; including but not limited to costs, damages, attorney's fees, costs of court, settlement fees, judgments, lost profits and related damages. ==================================================================== SNIA HBA API IMPLEMENTATION: The HBAAPI.dll file in the Program's installation directory consists of software developed by the Storage Networking Industry Association ("SNIA") (http://www.snia.org/). This file is provided to you in binary code form only under the terms of the following license from the SNIA, and the additional license from Troika Networks, Inc. which follows the license from the SNIA. IBM did not modify this software, and the source code for this software is available from http://sourceforge.net/ under the terms and conditions of the following licenses: STORAGE NETWORKING INDUSTRY ASSOCIATION PUBLIC LICENSE Version 1.1 ________________________ 1. Definitions. 1.1 "Commercial Use" means distribution or otherwise making the Covered Code available to a third party. 1.2 "Contributor" means each entity that creates or contributes to the creation of Modifications. 1.3 "Contributor Version" means the combination of the Original Code, prior Modifications used by a Contributor, and the Modifications made by that particular Contributor. 1.4 "Covered Code" means the Original Code or Modifications or the combination of the Original Code and Modifications, in each case including portions thereof. 1.5 "Electronic Distribution Mechanism" means a mechanism generally accepted in the software development community for the electronic transfer of data. 1.6 "Executable" means Covered Code in any form other than Source Code. 1.7 "Initial Developer" means the individual or entity identified as the Initial Developer in the Source Code notice required by Exhibit A. 1.8 "Larger Work" means a work which combines Covered Code or portions thereof with code not governed by the terms of this License. 1.9 "License" means this document. 1.10 "Licensable" means having the right to grant, to the maximum extent possible, whether at the time of the initial grant or subsequently acquired, any and all of the rights conveyed herein. 1.11 "Modifications" means any addition to or deletion from the substance or structure of either the Original Code or any previous Modifications. When Covered Code is released as a series of files, a Modification is: A. Any addition to or deletion from the contents of a file containing Original Code or previous Modifications. B. Any new file that contains any part of the Original Code or previous Modifications. 1.12 "Original Code" means Source Code of computer software code which is described in the Source Code notice required by Exhibit A as Original Code, and which, at the time of its release under this License is not already Covered Code governed by this License. 1.13 "Patent Claims" means any patent claim(s), now owned or hereafter acquired, including without limitation, method, process, and apparatus claims, in any patent Licensable by grantor. 1.14 "Source Code" means the preferred form of the Covered Code for making modifications to it, including all modules it contains, plus any associated interface definition files, scripts used to control compilation and installation of an Executable, or source code differential comparisons against either the Original Code or another well known, available Covered Code of the Contributor's choice. The Source Code can be in a compressed or archival form, provided the appropriate decompression or de-archiving software is widely available for no charge. 1.15 "You" (or "Your") means an individual or a legal entity exercising rights under, and complying with all of the terms of, this License or a future version of this License issued under Section 6.1. For legal entities, "You" includes any entity which controls, is controlled by, or is under common control with You. For purposes of this definition, "control" means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity. 2. Source Code License. 2.1 The Initial Developer Grant. The Initial Developer hereby grants You a world-wide, royalty-free, non-exclusive license, subject to third party intellectual property claims: (a) under intellectual property rights (other than patent or trademark) Licensable by Initial Developer to use, reproduce, modify, display, perform, sublicense and distribute the Original Code (or portions thereof) with or without Modifications, and/or as part of a Larger Work; and (b) under Patents Claims infringed by the making, using or selling of Original Code, to make, have made, use, practice, sell, and offer for sale, and/or otherwise dispose of the Original Code (or portions thereof). (c) the licenses granted in this Section 2.1(a) and (b) are effective on the date Initial Developer first distributes Original Code under the terms of this License. (d) Notwithstanding Section 2.1(b) above, no patent license is granted: 1) for code that You delete from the Original Code; 2) separate from the Original Code; or 3) for infringements caused by: i) the modification of the Original Code or ii) the combination of the Original Code with other software or devices. 2.2 Contributor Grant. Subject to third party intellectual property claims, each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license (a) under intellectual property rights (other than patent or trademark) Licensable by Contributor, to use, reproduce, modify, display, perform, sublicense and distribute the Modifications created by such Contributor (or portions thereof) either on an unmodified basis, with other Modifications, as Covered Code and/or as part of a Larger Work; and (b) under Patent Claims infringed by the making, using, or selling of Modifications made by that Contributor either alone and/or in combination with its Contributor Version (or portions of such combination), to make, use, sell, offer for sale, have made, and/or otherwise dispose of: 1) Modifications made by that Contributor (or portions thereof); and 2) the combination of Modifications made by that Contributor with its Contributor Version (or portions of such combination). (c) the licenses granted in Sections 2.2(a) and 2.2(b) are effective on the date Contributor first makes Commercial Use of the Covered Code. (d) Notwithstanding Section 2.2(b) above, no patent license is granted: 1) for any code that Contributor has deleted from the Contributor Version; 2) separate from the Contributor Version; 3) for infringements caused by: i) third party modifications of Contributor Version or ii) the combination of Modifications made by that Contributor with other software (except as part of the Contributor Version) or other devices; or 4) under Patent Claims infringed by Covered Code in the absence of Modifications made by that Contributor. 3. Distribution Obligations. 3.1 Application of License. The Modifications which You create or to which You contribute are governed by the terms of this License, including without limitation Section 2.2. The Source Code version of Covered Code may be distributed only under the terms of this License or a future version of this License released under Section 6.1, and You must include a copy of this License with every copy of the Source Code You distribute. You may not offer or impose any terms on any Source Code version that alters or restricts the applicable version of this License or the recipients' rights hereunder. However, You may include an additional document offering the additional rights described in Section 3.5. 3.2 Availability of Source Code. Any Modification which You create or to which You contribute must be made available in Source Code form under the terms of this License either on the same media as an Executable version or via an accepted Electronic Distribution Mechanism to anyone to whom you made an Executable version available; and if made available via Electronic Distribution Mechanism, must remain available for at least twelve (12) months after the date it initially became available, or at least six (6) months after a subsequent version of that particular Modification has been made available to such recipients. You are responsible for ensuring that the Source Code version remains available even if the Electronic Distribution Mechanism is maintained by a third party. 3.3 Description of Modifications. You must cause all Covered Code to which You contribute to contain a file documenting the changes You made to create that Covered Code and the date of any change. You must include a prominent statement that the Modification is derived, directly or indirectly, from Original Code provided by the Initial Developer and including the name of the Initial Developer in (a) the Source Code, and (b) in any notice in an Executable version or related documentation in which You describe the origin or ownership of the Covered Code. 3.4 Intellectual Property Matters. (a) Third Party Claims. If Contributor has actual knowledge that a license under a third party's intellectual property rights is required to exercise the rights granted by such Contributor under Sections 2.1 or 2.2, Contributor must include a text file with the Source Code distribution titled "LEGAL" which describes the claim and the party making the claim in sufficient detail that a recipient will know whom to contact. If Contributor obtains such knowledge after the Modification is made available as described in Section 3.2, Contributor shall promptly modify the LEGAL file in all copies Contributor makes available thereafter. (b) Contributor API's. If Contributor's Modifications include an application programming interface and Contributor has actual knowledge of patent licenses which are reasonably necessary to implement that API, Contributor must also include this information in the LEGAL file. (c) Representations. Contributor represents that, except as disclosed pursuant to Section 3.4(a) above, Contributor believes that Contributor's Modifications are Contributor's original creation(s) and/or Contributor has sufficient rights to grant the rights conveyed by this License. 3.5 Required Notices. You must duplicate the notice in Exhibit A in each file of the Source Code. If it is not possible to put such notice in a particular Source Code file due to its structure, then You must include such notice in a location (such as a relevant directory) where a user would be most likely to look for such a notice. If You created one or more Modification(s) You may add your name as a Contributor to the notice described in Exhibit A. You must also duplicate this License in any documentation for the Source Code where You describe recipients' rights or ownership rights relating to Covered Code. You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Covered Code. However, You may do so only on Your own behalf, and not on behalf of the Initial Developer or any Contributor. You must make it absolutely clear that any such warranty, support, indemnity or liability obligation is offered by You alone, and You hereby agree to indemnify the Initial Developer and every Contributor for any liability (excluding any liability arising from intellectual property claims relating to the Covered Code) incurred by the Initial Developer or such Contributor as a result of warranty, support, indemnity or liability terms You offer. 3.6 Distribution of Executable Versions. You may distribute Covered Code in Executable form only if the requirements of Section 3.1-3.5 have been met for that Covered Code, and if You include a notice stating that the Source Code version of the Covered Code is available under the terms of this License, including a description of how and where You have fulfilled the obligation of Section 3.2. The notice must be conspicuously included in any notice in an Executable version, related documentation or collateral in which You describe recipients' rights relating to the Covered Code. You may distribute the Executable version of Covered Code or ownership rights under a license of Your choice, which may contain terms different from this License, provided that You are in compliance with the terms of this License and that the license for the Executable version does not attempt to limit or alter the recipient's rights in the Source Code version from the rights set forth in this License. If You distribute the Executable version under a different license You must make it absolutely clear that any terms which differ from this License are offered by You alone, not by the Initial Developer or any Contributor. You hereby agree to indemnify the Initial Developer and every Contributor for any liability (excluding any liability arising from intellectual property claims relating to the Covered Code) incurred by the Initial Developer or such Contributor as a result of any such terms You offer. 3.7 Larger Works. You may create a Larger Work by combining Covered Code with other code not governed by the terms of this License and distribute the Larger Work as a single product. In such a case, You must make sure the requirements of this License are fulfilled for the Covered Code. 4. Inability to Comply Due to Statute or Regulation. If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Code due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be included in the LEGAL file described in Section 3.4 and must be included with all distributions of the Source Code. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it. 5. Application of this License. This License applies to code to which the Initial Developer has attached the notice in Exhibit A and to related Covered Code. 6. Versions of the License. 6.1 New Versions. The Storage Networking Industry Association (the "SNIA") may publish revised and/or new versions of the License from time to time. Each version will be given a distinguishing version number. 6.2 Effect of New Versions. Once Covered Code has been published under a particular version of the License, You may always continue to use it under the terms of that version. You may also choose to use such Covered Code under the terms of any subsequent version of the License published by the SNIA. No one other than the SNIA has the right to modify the terms applicable to Covered Code created under this License. 6.3 Derivative Works. If You create or use a modified version of this License (which you may only do in order to apply it to code which is not already Covered Code governed by this License), You must (a) rename Your license so that the phrases "Storage Networking Industry Association," "SNIA," or any confusingly similar phrase do not appear in your license (except to note that your license differs from this License) and (b) otherwise make it clear that Your version of the license contains terms which differ from the SNIA Public License. (Filling in the name of the Initial Developer, Original Code or Contributor in the notice described in Exhibit A shall not of themselves be deemed to be modifications of this License.) 7. DISCLAIMER OF WARRANTY. COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE COVERED CODE IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER. 8. TERMINATION. 8.1 This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such breach within a reasonable time after becoming aware of the breach. All sublicenses to the Covered Code which are properly granted shall survive any termination of this License. Provisions which, by their nature, must remain in effect beyond the termination of this License shall survive. 8.2 If You initiate litigation by asserting a patent infringement claim (excluding declaratory judgment actions) against Initial Developer or a Contributor (the Initial Developer or Contributor against whom You file such action is referred to as "Participant") alleging that: (a) such Participant's Contributor Version directly or indirectly infringes any patent, then any and all rights granted by such Participant to You under Sections 2.1 and/or 2.2 of this License shall, upon 60 days notice from Participant terminate prospectively, unless if within 60 days after receipt of notice You either: (i) agree in writing to pay Participant a mutually agreeable reasonable royalty for Your past and future use of Modifications made by such Participant, or (ii) withdraw Your litigation claim with respect to the Contributor Version against such Participant. If within 60 days of notice, a reasonable royalty and payment arrangement are not mutually agreed upon in writing by the parties or the litigation claim is not withdrawn, the rights granted by Participant to You under Sections 2.1 and/or 2.2 automatically terminate at the expiration of the 60 day notice period specified above. 8.3 If You assert a patent infringement claim against Participant alleging that such Participant's Contributor Version directly or indirectly infringes any patent where such claim is resolved (such as by license or settlement) prior to the initiation of patent infringement litigation, then the reasonable value of the licenses granted by such Participant under Sections 2.1 or 2.2 shall be taken into account in determining the amount or value of any payment or license. 8.4 In the event of termination under Sections 8.1 or 8.2 above, all end user license agreements (excluding distributors and resellers) which have been validly granted by You or any distributor hereunder prior to termination shall survive termination. 9. LIMITATION OF LIABILITY. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF COVERED CODE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND LIMITATION MAY NOT APPLY TO YOU. 10. U.S. GOVERNMENT END USERS. The Covered Code is a "commercial item," as that term is defined in 48 C.F.R. 2.101 (Oct. 1995), consisting of "commercial computer software" and "commercial computer software documentation," as such terms are used in 48 C.F.R. 12.212 (Sept. 1995). Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995), all U.S. Government End Users acquire Covered Code with only those rights set forth herein. 11. MISCELLANEOUS This License represents the complete agreement concerning subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This License shall be governed by California law provisions (except to the extent applicable law, if any, provides otherwise), excluding its conflict-of-law provisions. The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not apply to this License. 12. RESPONSIBILITY FOR CLAIMS. As between Initial Developer and the Contributors, each party is responsible for claims and damages arising, directly or indirectly, out of its utilization of rights under this License and You agree to work with Initial Developer and Contributors to distribute such responsibility on an equitable basis. Nothing herein is intended or shall be deemed to constitute any admission of liability. 13. MULTIPLE-LICENSED CODE. Initial Developer may designate portions of the Covered Code as "Multiple-Licensed". "Multiple-Licensed" means that the Initial Developer permits you to utilize portions of the Covered Code under Your choice of this License or the alternative licenses, if any, specified by the Initial Developer in the file described in Exhibit A. 14. ACCEPTANCE. This License is accepted by You if You retain, use, or distribute the Covered Code for any purpose. EXHIBIT A The SNIA Public License. The contents of this file are subject to the SNIA Public License Version 1.0 (the "License"); you may not use this file except in compliance with the License. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. The Original Code is . The Initial Developer of the Original Code is [COMPLETE THIS] . Contributor(s): ______________________________________. ______________________________ Copyright (c) 2000 Troika Networks, Inc. All Rights Reserved. Troika Networks, Inc., hereby grants a non-exclusive license under Troika Networks' copyright to copy, modify and distribute this software for any purpose and without fee, provided that the above copyright notice and the following paragraphs appear on all copies. Troika Networks, Inc.. makes no representation that this source code is correct or is an accurate representation of any standard. IN NO EVENT SHALL TROIKA NETWORKS HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, OR SPECULATIVE DAMAGES, (INCLUDING WITHOUT LIMITING THE FORGOING, CONSEQUENTIAL, INCIDENTAL AND SPECIAL DAMAGES) INCLUDING, BUT NOT LIMITED TO INFRINGEMENT, LOSS OF USE, BUSINESS INTERRUPTIONS, AND LOSS OF PROFITS, IRRESPECTIVE OF WHETHER TROIKA NETWORKS HAS ADVANCE NOTICE OF THE POSSIBILITY OF ANY SUCH DAMAGES. TROIKA NETWORKS INC. SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS AND TROIKA NETWORKS INC HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR MODIFICATIONS. ******************************************************************************** * Last minute changes to Documentation ALL ******************************************************************************** There are no clarifications or corrections for this section. ******************************************************************************** * TAPEAlertmsg default value ******************************************************************************** The default value of TAPEAlertmsg (see SET TAPEAlertmsg and Query TAPEAlertmsg commands) is OFF. This corrects the Administrator's Reference which falsely states that the default value is ON. ******************************************************************************** * SUN DISK PERFORMANCE ******************************************************************************** Best performance will be realized by using either native or Veritas raw partitions when defining disk storage pool, database or log volumes. See the command reference under each of the define volume(dbvol, logvol, volume)commands ******************************************************************************** * z/OS Reverse DNS Lookups ******************************************************************************** Connection information and schedule contact information for clients using TCP/IP continues to be maintained using TCP/IP dotted decimal notation. Reverse DNS Lookup functions are not available for the z/OS server. ******************************************************************************** * ACSLS volume locking limitation ******************************************************************************** TSM Server users may encounter problems with ACSLS defined volumes when lockid's get out of sync between the TSM Server and the ACSLS Server. This is a known limitation of the interface and can be circumvented by following STK's guidelines. The guidelines consist of manually unlocking the volumes(using the ACSLS server console) and recycling the TSM Server. ******************************************************************************** * Automatic Labeling of Tape Volumes ******************************************************************************** TSM now provides the option to have the server automatically label tape volumes in TSM library of type SCSI. This option takes a "label when first used" approac The server will label both blank and incorrectly labeled tapes when they are initially mounted. This eliminates the need to prelabel a set of tapes. You need only to checkin the tapes specifying that only the barcode label should be used. Both scratch and private volumes are candidates for the labeling operation. Both blank and incorrectly labeled tapes will be labeled if they are NOT already known to the server. In the case of a private mount request, the server must als show the volume to be in an empty state or the server must be able to determine that the tape is blank. If the server can not make such a determination, the volume will not be labeled. In the case of a labeling failure (I/O Error writing Label etc.), the server will handle it in the following manner. The server will issue one or more error messages describing the problem encountered during the failed attempt to write a label to the tape volume. If the volume status is scratch, the server will change the status of the volume to private so that it can not be selected for future scratch mounts. Server processing will continue with another scratch volume. Note that although the status has become private, the volume is not defined to a storage pool. When such an error occurs, you can review the error messages to determine the cause of the failure, and correct the problem. You can attempt to relabel the scratch volume with the LABEL LIBVOLUME command. Once the problem is corrected, you can update the status of the volume to scratch by using the UPDATE LIBVOLUME command. If it is determined that the problem can not be corrected, the volume can be removed from the library with the CHECKOUT LIBVOLUME command. When checking in blank tapes, you must specify CHECKLABEL=BARCODE on the CHECKIN LIBVOLUME command. This will permit the checkin to occur without errors. When auditing a library which contains blanks tapes, you must also specify CHECKLABEL=BARCODE to have the server ignore the blank tapes. To support this option, the define, update and query library commands have been modified. The define and update library commands have be updated to allow you to indicate when labeling should be performed. The query library command has been updated to provide the state of automatic labeling. DEFINE LIBRARY -------------- >>-DEFine LIBRary--library_name---------------------------------> .-LIBType--=--MANUAL-----------. >--+------------------------------+---------------------------->< '-LIBType--=--+-MANUAL-------+-' +-SCSI--| A |--+ +-349X--| B |--+ +-EXTernal-----+ +-ACSLS--| C |-+ '-RSM--| D |---' A (SCSI) .---AUTOLabel--=--No-----------. |--+------------------------------+------------------| +---AUTOLabel--=--No-----------+ +---AUTOLabel--=--Yes----------+ '---AUTOLabel--=--OVERWRITE----' ..... AUTOLabel Specifies whether the server attempts to automatically label tape volumes. This parameter is optional. The default is NO. Possible values are: No Specifies that the server can not attempt to label any volumes. Yes Specifies that the server only labels unlabeled volumes. OVERWRITE Specifies that the server should attempt to overwrite existing labels. The server will overwrite existing labels only if both the existing label and barcode label are not already defined in any server storage pool or the volume history list. UPDATE LIBRARY -------------- >>-UPDate LIBRary--library_name---------------------------------> >------| A (SCSI) |-------------------------------------------->< A (SCSI) .---AUTOLabel--=--No-----------. |--+------------------------------+------------------| +---AUTOLabel--=--No-----------+ +---AUTOLabel--=--Yes----------+ '---AUTOLabel--=--OVERWRITE----' .... AUTOLabel Specifies whether the server attempts to automatically label tape volumes. This parameter is optional. The default is NO. Possible values are: No Specifies that the server can not attempt to label any volumes. Yes Specifies that the server only labels unlabeled volumes. OVERWRITE Specifies that the server should attempt to overwrite existing labels. The server will overwrite existing labels only if both the existing label and barcode label are not already defined in any server storage pool or the volume history list. QUERY LIBRARY ------------- Shows value of AUTOLabel in the results. ******************************************************************************** * LABEL LIBVOL Listing for Scsi libraries ******************************************************************************** TSM now provides a new option and capability in the LABEL LIBVOL command for Scs libraries. This new capability allows you to specify an entire list of volume names to label either in the command or in a file. To support this option, the LABELSource parameter of the LABEL LIBVOL command ha been altered. Now the LABELSource parameter can be set to Vollist. When this option is utilized the Vollist parameter must be specified: either to a list of names or a file name containing a list of names. LABEL LIBVOL (SCSI) ------------------- >>-LABel LIBVolume--library_name--------------------------------> >----+-volume_name------------------------------------------------------+----> '-SEARCH--=--+-Yes--+-------+-+--LABELSource--=--+-Barcode-+-------+ | '-| A |-' | +-Prompt--+ | '-Bulk-----------' '-Vollist-+-| B |-' .-OVERWRITE--=--No------. >--+-------------------------+--+-----------------------+------>< '-CHECKIN--=--+-SCRatch-+-' '-OVERWRITE--=--+-No--+-' '-PRIvate-' '-Yes-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' B (LABELSource=Vollist) .-,-----------. V | |----VOLList--=--+---volume_name-+--+---------------------------| '-FILE:--file_name-' .... LABELSource Specifies how or whether the server reads sequential media labels of volume This option is only valid for SCSI libraries. Specify this parameter only when SEARCH=YES or SEARCH=BULK. Barcode The server attempts to read the bar-code label. If the attempt fails, the server will not label the volume and will display a message. Prompt The server prompts for volume names as necessary. Vollist The server uses the list of names in the command or if a file was specified, attempts to read the file for the list of names. If the attempt to read the file fails, the server will not label the volumes and will display a message. VOLList Specifies a list of volumes. Use this parameter to limit the search for volumes to be labeled when you specify SEARCH=YES. If there are no volumes in the library that are in the list, the command completes without errors. This parameter must be used if LABELSource=Vollist. volume_name Specifies the names of one or more values that are used for the command For example: VOLList=TAPE01,TAPE02 FILE:file_name Specifies the name of a file that contains a list of volumes for the command. In the file, each volume name must be on a separate line. Blan lines and comment lines that begin with an asterisk are ignored. For example, to use volume TAPE01, TAPE02 and TAPE03, create a file, TAPEVO that contains these lines: TAPE01 TAPE02 TAPE03 You can specify the volumes for the command as follows: VOLList=FILE:TAPEVOL NOTE: The file name is case-sensitive. .... The LABEL LIBVOL command remains the same for Manual, ACSLS, and 349X libraries. All other parameters and fields of LABEL LIBVOL also remain the same. ******************************************************************************** * LanFree Particulars ******************************************************************************** Restarting Storage Agent: In most cases, it is no longer necessary to halt and restart a LanFree Storage Agent to pickup changes in the Data Manager server. For example: Changing the ExternalManager attribute of the path definition for an External Library; it is not necessary to stop and restart the Storage Agent. For each new client session, the Storage Agent refreshes the Library and associa path information on the Storage Agent. For Shared Libraries, changes to the designated Primary Manager are reflected on the Storage Agent when the next client session begins. There are times however, when the Storage Agent must be restarted to obtain changes for a small variety of reasons. * If the Server attributes of the Primary Library Manager for a Shared Library changes, restarting the Storage Agent is required to get these changes. This would be necessary if the password or highlevel/lowlevel address of the server definition were changed on the Data Manager server and the Storage Age is using that specific Library. The Storage Agent must also be restarted if authorization is turned off on the Primary Library Manager. * If the REName STGpool command is used on a Lan-Free Storage Pool, restarting Storage Agent is required to discern this change. * Deleting or deleting and redefining a Lan-Free Storage Pool with the same nam but different attributes will not be reflected on the Storage Agent without and restarting it. * Updating Stg Pool attributes are not reflected on the Storage Agent. Stoppin and restarting the Storage Agent is required to pick-up the changes. Note: The affects on LanFree Storage Pools outlined above are not critical enough to instigate serious problems. StgPools, Libraries and Device Classes stored in core memory on Storage Agents are used to determine potential LanFree destinations. Final arbitration and target volume selection occurs on the Data Manager Server. Certain Storage Pool attribute updates may result in failed request rather than the desired LAN failover by the Storage Agent. If the Storage Agent accurately predicts a LanFree destination, the LanFree operation will most likely be successful. However if the Storage Agent inaccurately predicts a LanFree destination exists and the server is unable to substantiate the request the operation has advanced past the point where LAN failover will occur and the storage request is unsuccessful. z/OS Shared Library support. Limitations: If the Primary Library Manager is unavailable when a Storage Agent loaded with Policy applicable to LanFree, the Storage Agent will continue the LanFree storage operation until the Library Client function on the Storage Agent attempts to contact the Library Manager at which point the client operation will complete unsuccessfully. For successful LanFree operational support, the Library Manager nominated as the Primary Library Manager for the shared library must be available and properly configured. z/OS LanFree Volume selection: Limitations: SCRATCH tape mounts are not supported in z/OS LanFree configuratio For LanFree volume selection to satisfy a Storage Agent request for a target vol the volume must have first been written to by the z/OS Version 5.2 ITSM server a once. Once a volume entry has been recorded in the z/OS ITSM server database as Version 5.2 z/OS volume, the volume becomes eligible for LanFree Storage Agent u When volumes transition from filled or filling to empty, the volume remains elig LanFree volume selection. It becomes imperative that volumes destined for LanFr requests be DEFINE rather than allowing the z/OS ITSM server to allocate a SCRAT when populating a LanFree Storage Pool. DEFINEd volumes remain in the Storage P emptied thus making the volume a candidate for LanFree volume acquisition. ******************************************************************************** * Display Limitations ******************************************************************************** 1. The length of text that is displayed in the output for some QUERY commands ( for example QUERY SCHEDULE ) may not fit in the column width of the output table. This causes some words or phrases to wrap to the next line within the column. This kind of output depends on the length of the text and varies depending on the language the server is running in. When this kind of wrapping occurs, an alternative to viewing the text is to issue the QUERY with FORMAT=DETAIL option. 2. For the Web administrator interface, you must use a browser that supports the codepage of the server. If the browser does not support the codepage of the server, the Web Adminstrator panels may be unreadable. In this case it is recommended to use a WEB browser that supports the code page of the server. 3. Server messages that wrap to the next line may display with an extra blank li between the line. 4. It is possible for a word to be split to the next line in the middle. This may occur in the following examples: - The text needs to wrap to the next line but the last word on the line is long in length. Typically the server will try to split the text at a blank space but if the word at the end of the line is long then the server may break in the middle of the word and wrap the rest of the word/text onto the next line. - There is not enough space on the present line to fit the word. 5. Users running the server in a language other than 'en_US' and using the 'SHOW EVENTS' feature from the Web Administrator client will see garbage characters in the WEB event console. This is due to a problem with the feature not setting the locale and displaying the characters correctly. The workaround is to see the messages on the server console. ******************************************************************************** * Simultaneous Write Limitations ******************************************************************************** A problem has been discovered with the Simultaneous Write function that could potentially cause the server to abort. The abort could occur if the storage hierarchy meets all of the following criteria: 1. Contains more than one primary storage pool in the hierarchy. This is defined as having the NEXTPOOL parameter of a primary storage pool defined to another primary storage pool. For example, DISKPOOL has the NEXTPOOL parameter set to TAPEPOOL. 2. One of the primary storage pools has at least one copy storage pool defined. Using the example in criteria 1, either DISKPOOL may have the COPYSTGPOOL parameter set to COPYPOOL or TAPEPOOL may have the COPYSTGPOOL parameter set to COPYPOOL, but not both. 3. There exists at least a primary storage pool in the storage hierarchy that has a different copy storage pool list. This includes having no copy storage pools defined. Using the example above, TAPEPOOL could have no copy storage pools defined or a different copy storage pool other than COPYPOOL. Apar PQ70788 has been opened to address this problem. Until such time that PQ70788 is available, ensure that all primary storage pools in a storage hierarchy have the same copy storage pools defined in the COPYSTGPOOL parameter. Using the example above, if one intends to use the Simultaneous Write function, DISKPOOL and TAPEPOOL must both have COPYPOOL defined. Use the QUERY STGPOOL and UPDATE STGPOOL commands to correct the hierarchy if necessary. ******************************************************************************* * Simultaneous Write may not remove failing copy storage pool. * ******************************************************************************* There are error conditions that may occur during Simultaneous Write operations in which the copy storage pool may not be removed within the session. In some cases, if an error occurs writing to a copy storage pool during a simultaneous write operation, the server will examine the COPYCONTINUE parameter to determine how to proceed. Customers using the COPYCONTINUE parameter set to YES may find that the failing copy storage pool is not excluded from futher writes while the specific client session is active. Work around: - Examine the error messages and correct any problems, if possible. Retry the operation when the problem has been corrected. or - Use UPDATE STGPOOL command to eliminate the failing copy storage pool. For example, 1. The primary storage pool BACKUPPOOL has a copy pool defined. Assume that the name of the copy storage pool is COPYPOOL. 2. Copy storage pool COPYPOOL uses a shared library to store data. 3. A client backup operation starts but the TSM server cannot establish a communication session with the primary library manager. 4. The backup operation fails since the library manager was found to be unavailable. 5. The copy storage pool COPYPOOL is NOT excluded from any further writes. 6. Work around: - Start the library manager. Once the library manager is up and operational, retry the backup operation. or - Issue the UPDATE STGPOOL BACKUPPOOL COPYSTGPOOL="" command to remove the failing copy storage pool. IMPORTANT NOTE: When removing the copy storage pool from the copy storage pool list, it is very important to ensure that a storage pool backup is scheduled. It is recommended in the TSM Users Guide to establish a schedule that includes a storage pool backup for any primary storage pool that has a copy storage pools defined. This is necessary in the event that the Simultaneous Write operation removes the copy storage pool as the result of an error. ******************************************************************************** * NDMP File-Level Restore support for international characters ******************************************************************************** IBM Tivoli Storage Manager (ITSM) 5.2 introduces file-level operations for backu and restore of NAS file servers. During backup of data on a NAS file server, yo may request that ITSM create a table of contents (TOC). The TOC will be stored o the ITSM server and will be accessible during a restore of data on a NAS file server, allowing you to select specific files to restore. For Network Appliance NAS file servers, full functionality requires that you also install Data OnTap 6.4.1, when available, on your NAS file server. Please note the following restrictions: If your level of Data OnTap is prior to 6.4.1, you must have one of the followin configurations in order to take advantage of the new support: 1. Your data (the data on your Network Appliance NAS file server that you intend to back up with ITSM) has filenames that contain only English (7-bit ASCII) characters. 2. Your data has filenames that contain non-English characters and the volume language is set to the UTF-8 version of the proper locale (for example, de.UTF-8 for German). For any configuration where the level of Data OnTap is prior to 6.4.1, the ITSM server will print a warning message (ANR4946W) during backup operations indicating that the character encoding of NDMP file history messages is unknown and UTF-8 will be assumed in order to build a TOC. In the above configurations, it is safe to ignore this message. If your level of Data OnTap is 6.4.1 or later, you must have one of the followin configurations in order to take advantage of the new support: 3. Your data has filenames that contain only English (7-bit ASCII) characters and the volume language is not set or is set to one of: C (POSIX), en, en_US, en.UTF-8 or en_US.UTF-8. 4. Your data has filenames that contain non-English characters and the volume language is set to the proper locale (for example, de.UTF-8 or de for German). Note that using the UTF-8 version of the volume language setting is more efficient in terms of ITSM processing and TOC storage space. 5. You only use CIFS to create and access your data. Note that all systems that create or access data on a particular NAS file server volume must do so in a manner compatible with the volume language setting. Results with configurations other than the above are unpredictable. ******************************************************************************** * IBM Devices 3570, 3590, and Ultrium: Required Minimum Level for Device Driver ******************************************************************************** Customers who own IBM 3570, 3590, or Ultrium tape libraries and/or drives should upgrade their IBM SSG Open Systems Device Driver which support those devices. The following table lists the minimum levels that are required to function with TSM 5.2.0.0, but it is recommended to install the latest current driver that is available. In some cases the current-latest driver supercedes all others and is the only one available. The device driver software is installed separately and should be installed prior to installing the TSM Server or Storage Agent. These can be found at ftp://ftp.software.ibm.com/storage/devdrvr OS Driver Name Minimum Level for TSM 5.2.0.0 ================= =================== ============================= AIX Atape 8.2.8.0 Solaris IBMtape 4.0.7.5 Windows 2000 IBMMag.Win2K 5.0.4.5 IBMUltrium.Win2K 5.0.4.5 Windows 2003 IBMTape.W2K3 6.0.0.4 HP-UX 11.00 atdd 1.9.0.3 HP-UX 11.11 (aka 11i) atdd 3.1.0.3 Linux RHAS 2.1 IBMtape 1.3.3 Linux SLES 8 xSeries IBMtape 1.3.3 Linux SLES 8 zSeries IBMtape 1.3.2 Linux SLES 7 IBMtape 1.3.2 Linux SLES 8 pSeries IBMtape 1.3.4 when available ******************************************************************************** * Library Sharing and LAN-Free Upgrade Considerations * ******************************************************************************** Compatibility ------------------------- Version 5.2 and above of the Server and Storage Agent are not backwards compatible with version 5.1 and below of the Server and Storage Agent when in a Library Sharing or LAN-Free environment. All Servers and Storage Agents in a Library Sharing or LAN-Free environment must be upgraded to 5.2 in order to function properly. Common Configuration Problems ----------------------------- The handling of idle volumes for library sharing has been improved in 5.2. Volumes now go into the idle state on both the library client and library manager. The library manager then needs to contact the library client or storage agent to dismount the volume. The following error messages can occur if the hladdress or lladdress from the DEFINE SERVER command are incorrect. ANR8214E Session open with libclient.tucson.ibm.com failed due to connection refusal. ANR0454E Session rejected by server LIBCLIENT, reason: Communication Failure. ANR8779E Unable to open drive /dev/rmt0, error number=16. Issue the UPDATE SERVER command on the library manager for the library client or storage agent definitions to resolve the problem. Path Definitions ---------------- In version 5.1 and above DEFINE PATH and DEFINE DRIVE are not allowed on the library client. These definitions are now done on the library manager server. Definitions from 4.2 and below need to be migrated over to the library manager server by following these steps: 1. Retrieve the path information from the library client through the device configuration(DEVCONFIG) file or the QUERY PATH command. 2. Use the data gathered in step 1 to issue the DEFINE PATH commands on the library manager server. 3. Delete the path definitions on the library client with DELETE PATH. 4. Delete the drive definitions on the library client with DELETE DRIVE. ******************************************************************************** * Concurrent NDMP Backups of EMC Celerra Data Movers using fibre attached DLT * * drives * ******************************************************************************** Limitation: Starting concurrent NDMP backups on an EMC Celerra data mover is not supported where the target backup devices are DLT drives on the same SCSI bus and the drives are attached to an IBM 2108 SAN Data Gateway (all models) or an ADIC Pathlight 5000. Concurrent NDMP Backups of Celerra data movers to direct SCSI attached DLT drives is supported. ******************************************************************************** * Archive utilities provided * ******************************************************************************** APAR IC34521 requested that the IBM Tivoli Storage Manager server provide function to allow customers to manage archive usage and improve archive performance, which was degrading over time. The function requested is being provided now in the form of two commands to help experienced storage administrators manage space utilization and performance for archive operations: UPDate ARCHIve UNDO ARCHConversion The functions also provide a means to audit the archive descriptions. Customers who archive hundreds or thousands of files everyday, or who currently have hundreds of thousands of archive entries for a given node, might benefit from the information provided below and the new commands. Background: IBM Tivoli Storage Manager allows clients to organize archive files into packages. The description field of an archive request allows users to group files, and serves as the way to identify the package. To support the packages: - All archive requests using the same description become members of an archive package. If the user does not specify a description, the client provides a default description with each archive request. The default description includes the date. - The server has description tables for archives to boost performance for clients that query, retrieve, or delete archive files using the description option. The description tables are secondary tables designed to search more efficiently for archive packages. Clients also archive the paths (directories) to the files to preserve platform- specific access permissions. The directories are also included in the packages. If the same path specification is archived with different descriptions, the directory is entered into each package. The GUI and Web clients navigate through the descriptions and the directories to ultimately display archived files. They always use descriptions to query, retrieve, or delete archive directories and files. The command line client does not navigate through a node's archive space during display, but users can specify a description (and the directory) to query, retrieve, or delete a group of files. When a node archives a file: - If the package is new, or if the description exists but the file's directory is not already a member, the directory is entered into the primary archive table. - Files are always entered into the primary archive table. - If the node is "converted", entries are also made for the directory (if needed) and the files in the secondary description tables. Recommendations for archive operations: - Clients that query, retrieve, or delete using the description should be "converted" to search in the description tables. GUI and Web clients are always converted. CONVERT ARCHIVE should be issued for command line clients. - If most of the files for a node have unique names, searches can be performed efficiently without a description. - If a node archives files with the same directory many times (tens of thousands) with different descriptions, the node should be converted. If this node issues a "query archive" from the command line, multiple entries for the directory will appear. Closer inspection will show that the entries have different descriptions. - If a node archives the same directory and file name many times (tens of thousands), search performance will be improved if they are archived with different descriptions and the node is converted. The client could try to use FROMDate and TODate options to distinguish a set of files, however the date options are always inefficient search options. - The description tables require extra database space. Managing performance and storage for archives: - Users who always use the command line interface and never intend to use the description option to group their files can reduce storage requirements needed for the directory entries by always specifying the same description. This description must be at least one character in length. - There is no need to convert the node - There will be one archive package, thus one copy of a directory entry is kept. The savings will be noticeable when the same path specification is archived multiple times over multiple days. Notes: - Use this technique only when the node's files have unique names. - The technique is not recommended if the user might use the GUI or Web interface for the node in the future. - Command line users who do not need the directory level access permissions can reduce storage requirements by using the -v2Archive option with the archive request. Notes: The GUI and Web clients use the directories in the archive navigation scheme. This option is not recommended for GUI or Web users. New Commands: UPDATE ARCHIVE -------------- Use this command to reduce the space used by existing archive and description tables for nodes that have large numbers of archive entries (hundreds of thousands). Use this command only when the users of the node always use the Tivoli Storage Manager command-line client interface. Do not use this command for a node if the user has used or might use the GUI or Web client interface to work with archived files. Privilege class: Policy privilege for the policy domain for the node. .-SHOWstats----------. .-Wait--=--No-----. >>-UPDate ARCHIve--node_name--+--------------------+--+-----------------+--->< +-SHOWstats----------+ '-Wait--=--+-No---+ +-RESETDescriptions--+ '-Yes--' '-DELETEDirs---------' Parameters: node_name Specify the node name for the operation. (operation) SHOWstats Specifies that statistics about the node should be displayed. This is the default value if you do not specify either RESETDESCRIPTIONS or DELETEDIRS. The statistics include the number of directory and file entries, the number of entries for directories with the same path specification but different descriptions, and whether the node is converted. RESETDescriptions Resets the description field to the same description for all archive entries for a node. This reduces the number of archive packages, thus the number of entries for a given directory specification, to one. After you update the descriptions for a node by using this option, a user of that node should specify the same description when archiving subsequent files. If the same description is not specified, the number of directory entries with the same path specification for the node's archives will continue to increase. ATTENTION: This option is destructive. Once the descriptions are changed, they cannot be restored. DELETEDirs Deletes all archive directory entries for the node. The option should be used if restoring archive directory access permissions when retrieving archive files is not important to the user. If the directory entries are removed, subsequent archives should specify the -v2Archive option. If the option is not specified, the number of directory entries will continue to increase. ATTENTION: This option is destructive. Once the directory entries are removed, they cannot be restored. Wait Specifies whether the command runs in the background. The default is NO. No Perform the command in the background. Yes Perform the command in the foreground. You can specify this value only from an administrative client, not from the server console. UNDO ARCHCONVERSION ------------------- Use this command to remove all directory and file entries for a node from the archive description tables. Because the description tables are secondary tables, the UNDO ARCHCONVERSION command does not lose archive directory or file data; the command does not affect the primary archive table entries. Use this command: - To reduce the database space needed to support the description tables. Use this only for nodes that use the command line interface, which does not use archive packages for retrieving archives. - To audit the description tables. Issue the UNDO ARCHCONVERSION command, then convert the node again (CONVERT ARCHIVE). Privilege class: Policy privilege for the policy domain for the node. >>-UNDO ARCHConversion--node_name--------------------------------->< Parameters: node_name Specify the node name for the UNDO ARCHCONVERSION operation. ******************************************************************************** * APARs only fixed in 5.2.0 ******************************************************************************** IC30129 - Library Sharing Issues IC34621 - LABEL LIBVOL PROCESS COMPLETES WITH STATUS SUCCESS DESPITE IC35232 - TSM LIBRARY SHARING ANR8463E WRITE PROTECTED ANR9779E ANR1401W IC35560 - Issuing select * from DRMCSTGPOOL can cause srv hang. IC35713 - AUDITDB DISKSTORAGE TERMINATING IN ERROR NOT FIXING IC35809 - CACHE HIT PCT MAY INCORRECTLY REPORT GREATER THAN 100% IC35814 - LIBRARY MANAGER/CLIENT ENVIRONMENT CAN CAUSE DRIVES DEADLOCK IC35896 - TSM DOES NOT HONOR "UPDATE SCHEDULE" WITHIN A RUNNING SCHEDULE IC36080 - DATABASE RESTORE OF TSM 5.1.6 SERVER FAILS, AIX IF LANG IC36460 - SELECT FROM NODES TABLE MAY YIELD INCORRECT OUTPUT, IC36462 - copy storage pool missing data PQ65777 - Performance Degradation backing up system objects from windows PQ71960 - AUDIT DB ANR9999D ENTRY INSERTED FOR GROUPID ******************************************************************************** * $$1 APARS fixed in service level 5.2.1 ******************************************************************************** <@> IC35402 (GA+,5.1.8)ACCESS MODE FOR VOLUME SET TO "UNAVAILABLE" ### Sysroutes for APAR ### IC35402 5698ISMSV 51A <@> IC35524 CHECKOUT LIBVOL CHECKLABEL=NO REMOVE=NO FAILS ANR8437E ### Sysroutes for APAR ### IC35524 5698ISMSV 51A <@> IC35615 (518,52x) WEB aDMIN GETS "ERROR 404 PAGE NOT FOUND" WHEN TRYING ### Sysroutes for APAR ### IC35615 5698ISMWP 510 <@> IC35728 SET DRMPRIM THROUGH WEB ADMIN DOES NOT ACCEPT MORE THAN 50 ### Sysroutes for APAR ### PQ77735 5698ISMVS 521 IC35728 5698ISMSV 51A IC37160 5698ISMSV 51W <@> IC35765 SELECT DRMEDIA IS STARTING BUT NOT ENDING EXTERNAL LIBRARY MGR ### Sysroutes for APAR ### IC37227 5698ISMSV 51A IC35765 5698ISMSV 52A <@> IC35809 CACHE HIT PCT MAY INCORRECTLY REPORT GREATER THAN 100% ### Sysroutes for APAR ### IC35809 5698TSMAX 420 <@> IC35896 TSM DOES NOT HONOR "UPDATE SCHEDULE" WITHIN A RUNNING SCHEDULE ### Sysroutes for APAR ### IC35896 5698ISMSV 51W <@> IC36367 tSM AUDIT DB AND LOAD DB FAIL EXCEPTION CODE: C0000005 ACCESS_V ### Sysroutes for APAR ### PQ77687 5698ISMVS 510 PQ77694 5698ISMVS 520 IC36367 5698ISMSV 51W <@> IC36385 TSM LIBRARY HANG CAUSED BY MICROCODE BUG INCORRECT DRIVE ### Sysroutes for APAR ### IC36385 5698ISMSV 51A IC36444 5698ISMSV 51H IC36445 5698ISMSV 51L IC36446 5698ISMSV 51S IC36447 5698ISMSV 51W <@> IC36386 (GA+)TSM SERVER TO SERVER HANG / DEaDLOCK CAUSED BY NOT RELE ### Sysroutes for APAR ### IC36386 5698ISMSV 51A <@> IC36460 (5.2.1) SELECT FROM NODES TABLE MAY YIELD INCORRECT OUTPUT, ### Sysroutes for APAR ### PQ77688 5698ISMVS 520 IC36460 5698ISMSV 51A <@> PQ70579 ANR2705E SCHEDULER MANAGER DISABLED LOCK FAILURE ### Sysroutes for APAR ### PQ70579 5698ISMVS 510 PQ77689 5698ISMVS 520 IC37127 5698ISMSV 52A IC36062 5698ISMSV 51A <@> PQ70977 LOADDB PREMATURE END OF DUMP WHEN USING DD FOR DSNAME ### Sysroutes for APAR ### PQ70977 5698ISMVS 510 IC37128 5698ISMSV 51A PQ77690 5698ISMVS 520 <@> PQ71960 (518,52x)AUDIT DB ANR9999D ENTRY INSERTED FOR GROUPID ### Sysroutes for APAR ### PQ77749 5698ISMVS 520 IC36296 5698ISMSV 51A PQ71960 5698ISMVS 510 <@> PQ72342 ABEND0C4 OUTGETNEXT QUERY STGPOOL ### Sysroutes for APAR ### PQ72342 5698ISMVS 510 IC37161 5698ISMSV 51A <@> PQ72811 TRACE ENABLE LOCK TM ABEND0C4 SEGMENT VIOLATION ADDRESSING ### Sysroutes for APAR ### IC36118 5698ISMSV 51A PQ72811 5698ISMVS 510 <@> PQ73337 (GA+) ANR9999D ASVOLACQ ERROR 262 GETTING VOLUME NAME ### Sysroutes for APAR ### PQ73337 5698ISMVS 510 IC36536 5698ISMSV 51A <@> PQ73447 UNLOADDB APPARENT LOOP ### Sysroutes for APAR ### IC36399 5698ISMSV 51A PQ73447 5698ISMVS 510 PQ77701 5698ISMVS 520 <@> PQ73384 USING WEB ADMIN TO ADJUST BUFPOOLSIZE FAILS WITH MSGANR2020E ### Sysroutes for APAR ### IC37163 5698ISMSV 51A PQ73384 5698ISMVS 510 PQ77741 5698ISMVS 511 <@> IC34520 IN AN HACMP ENV, TSM 5.1 NOT RELEASING RESOURCES IN FAILOVER ### Sysroutes for APAR ### IC34520 5698ISMSV 51A IC34797 5698TSMAX 420 <@> IC36292 (5.1.8,5.2.1)SNMP MSG STRINGS FORMAT CHANGED BTWN 5152 & 5164 ### Sysroutes for APAR ### IC36292 5698ISMSV 51A PQ76326 5698ISMVS 520 <@> IC36508 DEF VOL FOR LARGE DISK VOL (200+GIG) FAIL WITH ANR7820W ### Sysroutes for APAR ### IC37162 5698ISMSV 52W IC36508 5698ISMSV 51W <@> IC36540 TSM SERVER CAN CRASH IF A SQL SELECT STATEMENT IS ISSUED THAT ### Sysroutes for APAR ### PQ76055 5698ISMVS 510 IC36540 5698ISMSV 51W <@> IC36566 THE TSM 5.X SERVER MAY GENERATE "INVALID FORMAT CODE" ERRORS ### Sysroutes for APAR ### IC36566 5698ISMSV 51A <@> IC36581 TSM SERVER CORE DUMP USING THE TRACEFLAG "THREAD". ### Sysroutes for APAR ### IC36581 5698ISMSV 51A <@> IC36636 THE 5.1.5.X TSM SERVER IS UNABLE TO RECONIGNIZE THE ### Sysroutes for APAR ### IC36636 5698ISMSV 51W <@> IC36651 Cancelling a lanfree session that is performing a restore or ### Sysroutes for APAR ### IC36651 5698ISMSV 52A <@> IC36653 The TSM server may abend when waiters exist for a volume that ### Sysroutes for APAR ### IC36653 5698ISMSV 51W <@> IC36675 External library support is now included in the ITSM Server for ### Sysroutes for APAR ### IC36675 5698ISMSV 52L <@> IC36678 TSM SERVER 5.1.7.0 DOES NOT POLL DRIVE INDEFINITELY IN ### Sysroutes for APAR ### <@> PQ76186 Problems with MVS 5.2 devclass DEFINE, UPDATE and QUERY ### Sysroutes for APAR ### PQ76186 5698ISMVS 520 <@> IC36154 DEFINE BACKUPSET W/ DEVCLASS REMOVABLEFILE TO TSM SERVER ERRORS ### Sysroutes for APAR ### IC36154 5698ISMSV 51W <@> IC36183 TSM DSMCAD RUNS SCHEDULE AFTER SCHEDULE DURATION WINDOW HAS EXP ### Sysroutes for APAR ### PQ76553 5698ISMVS 510 IC36183 5698ISMSV 51A <@> IC36510 STORAGE AGENT SESSIONS IN RUN STATE DO NOT CLEAR EVEN WITH ### Sysroutes for APAR ### IC36510 5698ISMSV 51Z <@> IC36597 TSM SERVER IS COREDUMPING DURING UNLOAD DB PROCESS ### Sysroutes for APAR ### PQ77742 5698ISMVS 510 PQ77743 5698ISMVS 520 IC36597 5698ISMSV 51S <@> IC36609 TSM SERVER CRASHES DURING AUDIT VOLUME IF THERE IS AN AGGREGATE ### Sysroutes for APAR ### IC36609 5698ISMSV 51W PQ77610 5698ISMVS 510 PQ77612 5698ISMVS 520 <@> IC36619 AUDITDB Process Terminates with Error ### Sysroutes for APAR ### IC36619 5698ISMSV 51W <@> IC36767 TSM EXCESSIVE ANR2997W MESSAGES LOGGED IN THE TSM ACTIVITY LOG ### Sysroutes for APAR ### IC36767 5698ISMSV 51A <@> IC36814 SERVER CRASH WITH Q PROC AND LARGE EXPORT JOBS (SYMPTOM AS ### Sysroutes for APAR ### PQ77111 5698ISMVS 520 IC36814 5698ISMSV 51A <@> IC36560 TSM Server core dumps when the ACSLS is being traced with pvr m ### Sysroutes for APAR ### IC36560 5698ISMSV 51S <@> IC36613 QUERY SCRIPT COMMAND WITH FORMAT=RAW CORES TSM SERVER ON SOLARI ### Sysroutes for APAR ### IC36613 5698ISMSV 51S <@> IC36766 TSM SERVER MAY CRASH DURING CLIENT BACKUP/ARCHIVE OPERATIONS ### Sysroutes for APAR ### PQ77609 5698ISMVS 520 PQ77103 5698ISMVS 510 IC36766 5698ISMSV 51A <@> IC36798 PLASMON M SERIES LIBRARIES (M20/M32/M52) HAVE CHANGED STARTING ### Sysroutes for APAR ### IC36798 5698ISMSV 51W <@> IC36845 TSM startserver script missing closing bracket ### Sysroutes for APAR ### IC36845 5698ISMSV 51A <@> IC36876 AIX TSM Server memory limitation ### Sysroutes for APAR ### IC36876 5698ISMSV 52A <@> IC36499 MOVE NODEDATA REPORTS SUCCESS WITH O BYTES TRANSFERRED ### Sysroutes for APAR ### PQ77326 5698ISMVS 510 IC36499 5698ISMSV 51A <@> IC36790 TSM VIRTUAL VOLUMES DO NOT EXPIRE AFTER IMPORT SERVER. SERVER ### Sysroutes for APAR ### PQ77094 5698ISMVS 510 PQ77095 5698ISMVS 520 IC36790 5698ISMSV 51A <@> IC36963 Storage agent aborts when no scratch volumes are available. ### Sysroutes for APAR ### IC36963 5698ISMSV 51Z <@> IC37052 NDMP Restore of a Celerra file server which involves a Full ### Sysroutes for APAR ### IC37052 5698ISMSV 52W <@> IC37107 QUERY TOC of a Network Appliance filesystem may not display ### Sysroutes for APAR ### IC37107 5698ISMSV 52L <@> IC37109 ANR9999D Buffer overrun detected while freeing memory; called ### Sysroutes for APAR ### IC37109 5698ISMSV 52L <@> IC37171 The COPYCONTINUE=YES may not be honored during ### Sysroutes for APAR ### IC37171 5698ISMSV 51A PQ77813 5698ISMVS 510 <@> IC37187 Two new features are included in tsm5.1.8 & tsm5.2.1. ### Sysroutes for APAR ### IC37187 5698ISMSV 52L <@> IC37251 LIBRARY MANAGER CRASHES WHEN RESTARTED ### Sysroutes for APAR ### IC37251 5698ISMSV 52S <@> IC37254 SPECTRA LOGIC GATOR LIBRARIES PERFORM SERIALIZED DISMOUNT AND ### Sysroutes for APAR ### IC37254 5698ISMSV 51S <@> IC37293 Crash during Q Process when DB backup to a shared library is ### Sysroutes for APAR ### IC37293 5698ISMSV 52S ******************************************************************************** * $$1 Admin Client Incorrect Server Level Display ******************************************************************************** The command line administrative client will not accurately report the current level of the storage agent or the server. An example of the version information displayed by the command line administrative client is: "Server Version 5, Release 2, Level 0.0" The display should actually be: "Server Version 5, Release 2, Level 1.0" To accurately display the server or storage agent level that the administrative client is connected to, issue the command "QUERY STATUS". The version information reported on the query is accurate. An example of the the version information displayed on this query is: "Storage Management Server for - Version 5, Release 2, Level 1.0" This display limitation will apply to the administrative client for future PTFs and patches for Version 5 Release 2 of the server or storage agent. This will be corrected at the next version or release of the product. ******************************************************************************** * WHERE TO FIND DOCUMENTATION ******************************************************************************** The BOOK CD contains the IBM Tivoli Storage Manager Version 5 Release 2 manuals in HTML and PDF format. 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://publib.boulder.ibm.com/tividd/td/tdmktlist.html ******************************************************************************** * Getting Help * ******************************************************************************** - To receive technical support for Tivoli Storage Manager: + Contact your administrator. This should be your first step when having problems with Tivoli Storage Manager. + Your administrator will know how to contact IBM for Technical Support on your behalf. + For the latest information about Tivoli Storage Manager, visit the home page on World Wide Web. The URL is: http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManag - 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 - Password protected server for z/OS & OS/390 ITSM PTF and patch deliverables .................... IBM also supports a password protected server where you can find PTF maintenance, patches and other related materials. This server is service2.boulder.ibm.com Userid is tsm4mvs Password is xxxxxxx Where xxxxxxx is password. Contact IBM service for password. FTP syntax for most Web Browsers ftp://tsm4mvs:xxxxxxx@service2.boulder.ibm.com The following directory contains ITSM for z/OS & OS/390 PTF's /storage/tivoli-storage-management/maintenance/server The following directory contains ITSM for z/OS & OS/390 patches /storage/tivoli-storage-management/patches/server/MVS-OS390 - Anonymous FTP server .................... IBM also supports an anonymous FTP server where you can find PTF maintenance and other related materials. This server is service.boulder.ibm.com Three other anonymous servers are unofficially maintained by non-IBM volunteers. These servers are: ftp.rz.uni-karlsruhe.de (mirror - Germany) ftp.wu-wien.ac.at (mirror - Austria) ftp.cac.psu.edu (mirror - Pennsylvania) Trademarks __________ (*) Trademark of the IBM Corporation in the United States and other countries.