Figures
Tables
Expanded About This Book
Who Should Read This Manual
Conventions Used in This Manual
Reading Syntax Diagrams
Expanded Related Information
Accessing Publications Online
How to Contact Us
Expanded Summary of Code Changes
Version 5 Release 1 Level 0 March 2002
Version 4 Release 2 Level 1 November 2001
Version 4 Release 2 Level 0 June 2001
Version 4 Release 1 Level 0 July 2000
Version 3 Release 7 Level 0 September 1999
Version 3 Release 1 Level 7 May 1999
Version 3 Release 1 Level 6 January 1999
Version 3 Release 1 Level 5 August 1998
Version 3 Release 1 Level 3 March 1998
Version 3 Release 1 Level 0 October 1997
Expanded Introducing the API
Understanding Configuration Files and Options Files
Setting Up the API Environment
Expanded Building and Running the Sample Application
Expanded Building the Sample Application
NetWare Operating System
OS/400 Operating System
UNIX Operating System
Windows 32-bit Operating System
Windows 64-bit Operating System
Running the Sample Application
Expanded Using the Application Program Interface
Key Design Recommendations
Determining Size Limits
Maintaining Version Control in the API
Using Multi-Threading
Using Signals
Expanded Starting or Ending a Session
Session Security
Using Passwordaccess Generate Without TCA
Administrative User
Expanded Identifying the Object
Filespace Name
High-Level and Low-Level Names
Object Type
Object ID
Accessing Objects
Accessing Across Nodes and Across Owners
Managing Filespaces
Expanded Associating a Management Class With Objects
Query Management Classes
Expanded Querying the TSM System
An Example
Expanded Sending Data to a Server
The Transaction Model
File Aggregation
Expanded Sending Objects to the Server
Understand Backup And Archive Objects
Compression
Expanded Reading State Diagrams and Flowcharts
An Example
File Grouping
Expanded Receiving Data from a Server
Perform a Partial Object Restore or Retrieve
Receive Data With a Restore or Retrieve Procedure
State Diagrams and Flowcharts
An Example
Updating Objects on the Server
Deleting Objects from the Server
Logging Events
Putting It All Together
Expanded Understanding Interoperability
Expanded Backup-Archive Client Interoperability
Naming Your API Objects
Using Commands
Operating System Interoperability
Expanded Using the API With Unicode
Who Should Use Unicode
Setting Up Unicode
Expanded API Function Calls
dsmBeginGetData
dsmBeginQuery
dsmBeginTxn
dsmBindMC
dsmChangePW
dsmCleanUp
dsmDeleteAccess
dsmDeleteFS
dsmDeleteObj
dsmEndGetData
dsmEndGetDataEx
dsmEndGetObj
dsmEndQuery
dsmEndSendObj
dsmEndSendObjEx
dsmEndTxn
dsmEndTxnEx
dsmGetData
dsmGetNextQObj
dsmGetObj
dsmGroupHandler
dsmInit
dsmInitEx
dsmLogEvent
dsmLogEventEx
dsmQueryAccess
dsmQueryApiVersion
dsmQueryApiVersionEx
dsmQueryCliOptions
dsmQuerySessInfo
dsmQuerySessOptions
dsmRCMsg
dsmRegisterFS
dsmRenameObj
dsmSendData
dsmSendObj
dsmSetAccess
dsmSetUp
dsmTerminate
dsmUpdateFS
dsmUpdateObj
Appendix A. API Type Definitions Source File
Appendix B. API Function Definitions Source File
Appendix C. API Return Codes Source File
Appendix D. API Return Codes With Explanations
Expanded Appendix E. The X/Open API
Introduction
Version 3.7.2 Changes
Setting Up Options Files
Expanded Using the TSM X/Open API Sample Application
Build the Sample Application
Expanded Using the TSM X/Open API
Data Field Mapping
Maintaining Version Control in the API
Starting Or Ending a Session
Session Security
Determining the Session Parameters
Associating a Management Class With Objects
The Transaction Model
Querying the TSM System
Sending Data to a Server
Receiving Data from a Server
Deleting Objects from the Server
Identifying the Object
Setting the Owner Name
Using XOpen Functions With TSM
Expanded TSM Changes to the XBSA Header Files
Changes to custom.h
Changes to xbsa.h
Changes to policy.h
Expanded Appendix F. Notices
Trademarks
Glossary
Index