Tivoli Header

Tivoli Storage Manager Using the Application Program Interface

Version 5 Release 1 Level 0 March 2002

Functional Enhancements

LAN-free
The Tivoli Storage Manager API 4.2 and above now supports the LAN-free function. For more information, see Tivoli Storage Manager Installation and Using Guide for your operating system.

Notes:

  1. To use the LAN-free function, dsmSetup must be called with the DSM_MULTITHREAD flag.

  2. The API returns the existence of a LAN-free destination in the version 5.1 MC response structure.

  3. The version 5.1 API returns the number of bytes that were transferred LAN-free on the dsmEndSendObjEx call and on the dsmEndGetDataEx call.

HACMP
TSM 5.1.0 supports HACMP. For more information, see Tivoli Storage Manager Installation and Using Guide for your operating system.

CRC
TSM 5.1.0 supports CRC. A new server option enables new return codes on EndTrxn. For more information, see Tivoli Storage Manager Installation and Using Guide for your operating system.

Logical File Grouping
TSM 5.1.0 supports logical file grouping. See "File Grouping" for more information.

Cross-Platform Backup-Restore
TSM 5.1.0 supports cross-platform backup-restores. See "Understanding Interoperability" for more information.

Unicode Interface
Available on Windows only.

New Function Calls

dsmEndGetDataEx
The dsmEndGetData function was extended to provide total LAN-free bytes received.

dsmEndSendObjEx
The dsmEndSendObj function was extended to provide compression information and the total of bytes sent, for both normal backup and LAN-free.

dsmEndTxnEx
The dsmEndTxn function was extended to provide a group leader object ID for those transactions that call dsmGroupHandler with an actionType of DSM_GROUP_OPEN.

dsmGroupHandler
New function call to provide logical file grouping.

Updated Structures

dsmQueryType
Updated to include qtBackupGroups and qtOpenGroups for group queries.

DataBlk
Updated to include a new field, numBytesCompressed, to show actual number of bytes compressed.

archDetailCG
Updated to include Boolean flags bLanFreeDest and bSrvFreeDest for LAN and server-free destinations.

backupDetailCG
Updated to include Boolean flags bLanFreeDest and bSrvFreeDest for LAN and server-free destinations.

qryRespArchiveData
Updated to include compressType, the compression type.

qryRespBackupData
Updated to include compression and group information.

dsmInitExIn_t
Updated to include fields used in cross platform backup and restore.

The Tivoli Storage Manager API for OS/400 has been upgraded to version 4.2.1. The 4.2.1 OS/400 TSM API supports the OS/400 version 5.1.0 and later. The OS/400 API option processing now uses the UNIX model of dsm.sys and dsm.opt files. These files reside in the root (/) file system. You can use environment variables to identify them. For compatibility, the former options processing that uses a file member in a QSYS library also are provided. However, we recommend that your applications move their options to the dsm.sys and dsm.opt files for more flexibility. The sample API C programs, the Include files, the readme.api, and the sample options files are located in the root (/) file system. The install directory is located in /usr/tivoli/tsm/client/api/bin, and the sample API files are located in the /usr/tivoli/tsm/client/api/bin/sample directory.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]