Preface
Who Should Read This Publication
What You Should Know before Reading This Publication
Tivoli Storage Manager Web Site
Conventions Used in This Book
Tivoli Storage Manager Publications
Referenced MVS System Publications
Related IBM Hardware Products Publications
IBM International Technical Support Center Publications (Redbooks)
Do You Have Comments or Suggestions?
Translations
Summary of Changes for Tivoli Storage Manager
Product Repackaging Changes--September 1999
Technical Changes for Version 3 Release 7--September 1999
Part 1. Tivoli Storage Manager Basics
Chapter 1. Introducing Tivoli Storage Manager
How Tivoli Storage Manager Stores Client Data
How Tivoli Storage Manager Represents Storage Devices
Disk and Tape Devices
Files on Disk as Sequential Volumes
Sequential Volumes on Another Tivoli Storage Manager Server
How Tivoli Storage Manager Represents Storage Media
The Tivoli Storage Manager Storage Objects
Device Class
Storage Pool
Storage Pool Volume
Server
More on the Contents of the Device Class
Putting It All Together
Planning for Server Storage
Evaluating Your Storage Environment
Mapping Devices to Device Classes
Mapping Storage Pools to Device Classes and Devices
Configuring Devices
Automating Client Operations
Working with a Network of Tivoli Storage Manager Servers
Chapter 2. Administrator Tasks
Interfaces to Tivoli Storage Manager
Using Magnetic Disk Devices with Tivoli Storage Manager
Using Removable Media Devices with Tivoli Storage Manager
Managing Tape Operations
Defining Device Classes
Managing Storage Pools
Adding Nodes
Managing Client Nodes
Managing Client Data Using Policies
Scheduling Operations for Clients
Performing Operations for Clients
Working with a Network of Tivoli Storage Manager Servers
Managing Server Operations
Automating Server Operations
Managing the Database and Recovery Log
Monitoring the Tivoli Storage Manager Server
Exporting and Importing Data
Protecting and Recovering Your Server
Using Tivoli Disaster Recovery Manager
Part 2. Configuring and Managing Server Storage
Chapter 3. Using Magnetic Disk Devices with Tivoli Storage Manager
Setting Up Storage Pools on Disk Devices
Using Random Access Volumes on Disk Devices
Using Disk for FILE Sequential Devices
Varying Disk Volumes Online or Offline
Notes on Operations
Using Cache
Freeing Space on Disk
FILE Volumes Used for Database Backups and Export Operations
Chapter 4. Using Tape Devices with Tivoli Storage Manager
Overview of Using Tape Devices with Tivoli Storage Manager
Example of Setting Up Two 3490E Drives
Define the Tivoli Storage Manager Objects
Update Tivoli Storage Manager Policy
Register Clients to the Policy Domain
Notes on Operations
Collocation
Maintaining the Volume Inventory
Chapter 5. Managing Tape Operations
Understanding Tivoli Storage Manager Server Tape Processing
Processing Tapes
Understanding How the Server Selects and Handles Tapes
Querying and Dismounting Tapes
Querying Mounted Tapes
Dismounting Tapes
Setting Up Tivoli Storage Manager with Your Tape Management System
Defining Tivoli Storage Manager to Your Tape Management System
Specifying Permanent Tape Retention
Setting Up Tape Installation-Wide Exits
Chapter 6. Managing Device Classes
How to Choose Device Classes
Defining and Updating Tape Device Classes
Mount Limit
Mount Wait Period
Mount Retention Period
Maximum Capacity
File Expiration Date
MVS Device Unit Name
Data Compression
Tape Volume Prefix
Protection Status
File Retention Period
Estimated Capacity
Example: 3480 Devices
Defining FILE Device Classes
Device Type
Mount Limit
Maximum Capacity
Prefix
Defining and Updating SERVER Device Classes
Server Name
Mount Limit
Maximum Capacity Value
Prefix
Retry Period
Retry Interval
Requesting Information about Device Classes
Deleting Device Classes
How TSM Fills Volumes
Using Data Compression
Tape Volume Capacity and Data Compression
Chapter 7. Managing Storage Pools and Volumes
Storage Pools
An Example of Server Storage
Defining or Updating Primary Storage Pools
Task Tips for Storage Pools
Volumes in Storage Pools
Preparing Volumes for Random Access Storage Pools
Preparing Volumes for Sequential Access Storage Pools
Updating Storage Pool Volumes
The Storage Pool Hierarchy
How the Server Stores Files in a Storage Pool Hierarchy
Using Copy Storage Pools to Back Up a Storage Hierarchy
Using the Hierarchy to Stage Client Data from Disk to Tape
Migration of Files in a Storage Pool Hierarchy
Migration for Disk Storage Pools
Migration for Sequential Access Storage Pools
Migration and Copy Storage Pools
The Use of Cache on Disk Storage Pools
How the Server Removes Cached Files
Effect of Caching on Storage Pool Statistics
Grouping Client Files: Collocation on Sequential Access Storage Pools
The Effects of Collocation on Operations
How the Server Selects Volumes with Collocation Enabled
How the Server Selects Volumes with Collocation Disabled
Turning Collocation On or Off
Collocation on Copy Storage Pools
Reclaiming Space in Sequential Access Storage Pools
How Tivoli Storage Manager Reclamation Works
Choosing a Reclamation Threshold
Reclaiming Volumes in a Storage Pool with One Drive
Reclamation of Volumes with the Device Type of SERVER
Reclamation for Copy Storage Pools
How Collocation Affects Reclamation
Estimating Space Needs for Storage Pools
Estimating Space Needs in Random Access Storage Pools
Estimating Space Needs in Sequential Access Storage Pools
Monitoring Storage Pools and Volumes
Monitoring Space Available in a Storage Pool
Monitoring the Use of Storage Pool Volumes
Monitoring Migration Processes
Monitoring the Use of Cache Space on Disk Storage
Requesting Information on the Use of Storage Space
Moving Files from One Volume to Another Volume
Moving Data to Other Volumes in the Same Storage Pool
Moving Data to Another Storage Pool
Moving Data from an Offsite Volume in a Copy Storage Pool
Procedure for Moving Data
Renaming a Storage Pool
Defining a Copy Storage Pool
Example: Defining a Copy Storage Pool
Comparing Primary and Copy Storage Pools
Deleting a Storage Pool
Deleting Storage Pool Volumes
Deleting an Empty Storage Pool Volume
Deleting a Storage Pool Volume with Data
Part 3. Managing Client Operations
Chapter 8. Adding Nodes
Overview of Clients and Servers as Nodes
Installing Client Node Software
Registering Nodes with the Server
Accepting Default Closed Registration or Enabling Open Registration
Registering Nodes with Client Options Sets
Registering a Source Server as a Node on a Target Server
Registering an Application Programming Interface to the Server
Connecting Nodes with the Server
Required Client Options
Non-Required Client Options
UNIX Client Options
Adding Clients from the Administrative Command Line Client
Enabling Open Registration
Configuring the Client Options File to Connect with the Server
Example: Register Three Client Nodes Using the Administrative Command Line
Chapter 9. Managing Client Nodes
Managing Clients
Defining Client Options from the Server
Managing Client Node Access
Accessing Clients with Client Access User IDs
Requesting Information about Client Nodes
Requesting Information about File Spaces
Deleting File Spaces and Client Nodes
Controlling Administrator and Client Node Passwords
Setting Password Authentication
Setting the Administrative Web Interface Authentication
Setting User Password Expiration
Setting Invalid Password Limit
Setting a Minimum Password Length
Managing Client Sessions
Requesting Information about Client Sessions
Canceling a Client Session
Managing Client Restartable Restore Sessions
Controlling Administrator Access to the Server and Clients
Registering Administrators or Updating Information
Granting Administrative Authority
Renaming an Administrator
Changing Administrative Authority
Removing Administrators
Locking and Unlocking Administrators from the Server
Requesting Information about Administrators
Disabling or Enabling Access to the Server
Chapter 10. Managing Client Data Using Policies
Client Operations Controlled by Policy
Backup and Restore
Archive and Retrieve
Client Migration and Recall
The Parts of a Policy
More on Management Classes
Contents of a Management Class
Default Management Classes
The Include-Exclude List
How Files and Directories Are Associated with a Management Class
How Files Are Deleted
How Tivoli Storage Manager Selects Files for Policy Operations
Incremental Backup
Selective Backup
Logical Volume Backup
Archive
Automatic Migration from a Client Node
How Client Migration Works with Backup and Archive
Getting Users Started
Using the Standard Policy
Creating Your Own Policies
Example: Sample Policy Objects
Defining and Updating a Policy Domain
Defining and Updating a Policy Set
Defining and Updating a Management Class
Defining and Updating a Backup Copy Group
Defining and Updating an Archive Copy Group
Assigning a Default Management Class
Validating and Activating a Policy Set
Running Expiration Processing to Delete Expired Files
Changing Policy with the Active Policy Set
Setting Policy to Enable Point-in-Time Restore for Clients
Policy for Tivoli Storage Manager Servers as Clients
Configuring Policy for Tivoli Data Protection Application Clients
Policy for Logical Volume Backups
Distributing Policy Using Enterprise Configuration
Querying Policy
Querying Copy Groups
Querying Management Classes
Querying Policy Sets
Querying Policy Domains
Deleting Policy
Deleting Copy Groups
Deleting Management Classes
Deleting Policy Sets
Deleting Policy Domains
Chapter 11. Scheduling Operations for Clients
Automating a Basic Client Operation
Defining Client Schedules
Associating Client Nodes with Schedules
Starting the Scheduler on the Clients
Creating Command Files to Run on Schedules
Displaying the Scheduling Information
Updating the Client Options File to Automatically Generate a New Password
Comparing Tivoli Storage Manager Scheduling Across Platforms and Components
Scheduling Tivoli Storage Manager Commands
Chapter 12. Performing Operations for Clients
Issuing Commands for Immediate Processing on a Client Node
Coordinating Client Schedules
Setting the Scheduling Mode
Specifying the Schedule Period for Incremental Backup Operations
Controlling the Server's Scheduled Workload
Controlling Contact with the Server
Tailoring Schedules
Example: Defining a New Client Schedule
Example: Updating an Existing Client Schedule
Copying Schedules
Deleting Schedules
Managing Scheduled Event Records
Querying Event Records
Removing Event Records from the Database
Managing Client Associations with Schedules
Querying Associations
Deleting Associations
What are Client Backup Sets?
Generating Client Backup Sets on the Server
Selecting a Name for the Backup Set
Choosing Media for the Backup Set
Setting a Retention Period for the Backup Set
Example: Generating a Client Backup Set
Understanding How Backup Sets are Managed
Moving Backup Sets to Other Servers
Managing Client Backup Sets
Updating the Retention Period of a Backup Set
Deleting Backup Sets
Displaying Backup Sets
Part 4. Maintaining the Server
Chapter 13. Working with a Network of Tivoli Storage Manager Servers
Concepts for Working with a Network of Servers
Configuring and Managing Servers: Enterprise Configuration
Performing Tasks on Multiple Servers
Central Monitoring
Storing Data on Another Server
Example Scenarios
Planning for Enterprise Administration
Setting Up Communications Among Servers
Setting Up Communications for Enterprise Configuration and Enterprise Event Logging
Setting Up Communications for Command Routing
Updating and Deleting Servers
Setting Up an Enterprise Configuration
Enterprise Configuration Scenario
Creating the Default Profile on a Configuration Manager
Creating and Changing Configuration Profiles
Getting Information about Profiles
Subscribing to a Profile
Refreshing Configuration Information
Returning Managed Objects to Local Control
Setting Up Administrators for the Servers
Handling Problems with Synchronization of Profiles
Switching a Managed Server to a Different Configuration Manager
Deleting Subscribers from a Configuration Manager
Renaming a Managed Server
Performing Tasks on Multiple Servers
Using Tivoli Storage Manager Enterprise Logon
Routing Commands
Setting Up Server Groups
Querying Server Availability
Using Virtual Volumes to Store Data on Another Server
Setting Up Source and Target Servers for Virtual Volumes
Performing Operations at the Source Server
Reconciling Virtual Volumes and Archive Files
Chapter 14. Managing Server Operations
Tivoli Storage Manager Licensing
Licensed Features
License Compliance
Registering Licensed Features
Monitoring Licenses
Starting, Halting, and Restarting the Server
Starting the Server
Halting the Server
Restarting the Server
Managing Server Processes
Requesting Information about Server Processes
Canceling Server Processes
Preemption of Client or Server Operations
Setting the Server Name
Adding or Updating Server Options
Adding or Updating a Server Option without Restarting the Server
Automatic Tuning of Server Options
Getting Help on Commands and Error Messages
Chapter 15. Automating Server Operations
Automating a Basic Administrative Command Schedule
Defining the Schedule
Verifying the Schedule
Tailoring Schedules
Example: Defining and Updating an Administrative Command Schedule
Copying Schedules
Deleting Schedules
Managing Scheduled Event Records
Querying Events
Removing Event Records from the Database
Tivoli Storage Manager Server Scripts
Defining a Server Script
Managing Server Scripts
Running a Server Script
Using Macros
Writing Commands in a Macro
Writing Comments in a Macro
Using Continuation Characters
Using Substitution Variables in a Macro
Running a Macro
Controlling Command Processing in a Macro
Chapter 16. Managing the Database and Recovery Log
Database and Recovery Log
How Tivoli Storage Manager Processes Transactions
How Space Is Managed by the Server
Estimating and Monitoring Database and Recovery Log Space Requirements
Monitoring the Database and Recovery Log
Increasing the Size of the Database or Recovery Log
Automating the Increase of the Database or Recovery Log
Manually Increasing the Database or Recovery Log
Decreasing the Size of the Database or Recovery Log
Step 1: Determining If Volumes Can Be Deleted
Step 2: Reducing the Capacity of the Database or Recovery Log
Step 3: Deleting a Volume from the Database or Recovery Log
Optimizing the Performance of the Database and Recovery Log
Dynamically Adjusting the Database Buffer Pool Size
Improving VSAM and Tivoli Storage Manager Performance
Manually Adjusting the Database Buffer Pool Size
Adjusting the Recovery Log Buffer Pool Size
Compressing the Database
Chapter 17. Monitoring the Tivoli Storage Manager Server
Using Tivoli Storage Manager Queries to Display Information
Requesting Information about Tivoli Storage Manager Definitions
Requesting Information about Client Sessions
Requesting Information about Server Processes
Requesting Information about Server Settings
Querying Server Options
Querying the System
Using SQL to Query the Tivoli Storage Manager Database
Using the ODBC Driver
Issuing SELECT Commands
Using SELECT Commands in Tivoli Storage Manager Scripts
Canceling a SELECT Command
Controlling the Format of SELECT Results
Querying the SQL Activity Summary Table
Creating Output for Use by Another Application
Using the Tivoli Storage Manager Activity Log
Changing the Size of the Activity Log
Setting the Activity Log Retention Period
Requesting Information from the Activity Log
Logging Tivoli Storage Manager Events to Receivers
Controlling Event Logging
Logging Events to the Tivoli Storage Manager Server Console and Activity Log
Logging Events to a File Exit and a User Exit
Logging Events to NetView for MVS
Logging Events to the Tivoli Event Console
Enterprise Event Logging: Logging Events to Another Server
Querying Event Logging
Monitoring Errors and Diagnosing Problems
Monitoring Tivoli Storage Manager Accounting Records
Chapter 18. Exporting and Importing Data
Data That Can Be Exported and Imported
Preparing to Export or Import Data
Using Preview before Exporting or Importing Data
Planning for Sequential Media Used to Export Data
Monitoring Export and Import Processes
Requesting Information about an Export or Import Process
Viewing Information from an Administrative Client
Querying the Activity Log for Export or Import Information
Exporting Data to Sequential Media Volumes
Deciding When to Export Data
Exporting Server Data
Exporting Administrator Information
Exporting Client Node Information
Exporting Policy Information
Importing Data from Sequential Media Volumes
Step 1: Previewing Information before You Import Data
Step 2: Importing Definitions
Step 3: Tailoring Server Storage Definitions on the Target Server
Step 4: Importing File Data Information
Considerations When Importing Data
Recovering from Errors during the Import Process
Exporting and Importing Data from Virtual Volumes
Part 5. Protecting the Server
Chapter 19. Protecting and Recovering Your Server
Levels of Protection
Storage Pool Protection
Database and Recovery Log Protection
Protecting and Recovering Data: An Overview
Protecting Your Database and Storage Pool
Recovering to a Point-in-Time
Recovering a Lost or Damaged Storage Pool Volume
Mirroring the Database and Recovery Log
Allocating Volume Copies to Separate Physical Disks
Defining Database or Recovery Log Mirrored Volumes
Specifying Mirroring and Database Page Shadowing Server Options
Requesting Information about Mirrored Volumes
Backing Up Storage Pools
Delaying Reuse of Sequential Access Volumes
Using Copy Storage Pools to Improve Data Availability
Example: Simple Hierarchy with One Copy Storage Pool
Backing Up the Database
Defining Device Classes for Backups
Setting the Recovery Log Mode
Scheduling Database Backups
Estimating the Size of the Recovery Log
Automating Database Backups
Saving the Volume History File
Saving the Device Configuration File
Doing Full and Incremental Backups
Doing Snapshot Database Backups
Recovering by Using Mirrored Volumes
Recovering by Using Database and Storage Pool Backups
Restoring a Database to a Point-in-Time
Restoring a Database to its Most Current State
Restoring Storage Pools
Restoring Storage Pool Volumes
What Happens When a Volume Is Restored
When a Volume Restoration Is Incomplete
Auditing a Storage Pool Volume
What Happens When You Audit Storage Pool Volumes
Auditing a Volume in a Disk Storage Pool
Auditing Multiple Volumes in a Sequential Access Storage Pool
Auditing a Single Volume in a Sequential Access Storage Pool
Correcting Damaged Files
Maintaining the Integrity of Files
Restoring Damaged Files
Backup and Recovery Scenarios
Protecting Your Database and Storage Pool
Recovering to a Point-in-Time from a Disaster
Recovering a Lost or Damaged Storage Pool Volume
Chapter 20. Using Tivoli Disaster Recovery Manager
Features of Tivoli Disaster Recovery Manager
Automated Generation of a Server Disaster Recovery Plan
Offsite Recovery Media Management
Storage of Client Recovery Information
Setting Up and Using Tivoli Disaster Recovery Manager
Licensing Tivoli Disaster Recovery Manager
Defining Tivoli Storage Manager Server Machine Information
Backing up the Primary Storage Pools and the Database
Creating and Storing the Disaster Recovery Plan
Querying, Displaying, and Expiring Recovery Plan Files Saved on a Target Server
Storing Client Recovery Information
Customizing Tivoli Disaster Recovery Manager
Customizing the Contents of Disaster Recovery Plan Files
Customizing the Management of Offsite Recovery Media
Querying the Tivoli Disaster Recovery Manager System Parameters
Customizing the Site-Specific Recovery Instructions
Performing Routine Operations
Sending Server Backup Volumes Offsite
Moving Reclaimed or Expired Volumes Back Onsite
Recovering Your Tivoli Disaster Recovery Manager System
Recovering the Server
Recovering the Clients
Using Tivoli Disaster Recovery Manager without a Tape Management Product
Tivoli Disaster Recovery Manager Controls Volume Movement without the Tape Management Product
Routine Operations
Using Tivoli Disaster Recovery Manager with a Tape Management Product
DRM User Scenarios
Scenario 1: Tivoli Disaster Recovery Manager Controls Volume Movement
Scenario 2: Removable Media Management Controls Volume Movement
Recovering the Server Scenario
Recovering Clients Scenario
Summary of Tivoli Disaster Recovery Manager Use
Tivoli Disaster Recovery Manager Checklist
The Disaster Recovery Plan
Breaking Out a Disaster Recovery Plan File
Structure of the Disaster Recovery Plan File
Example Disaster Recovery Plan File
Example SMS Version of the Disaster Recovery Plan File
Part 6. Appendixes
Appendix A. User Exit and File Exit Receivers
Sample User Exit Declarations (ANRUSRXH.H)
Sample User Exit Program (ANRUSRXC.C)
Sample Assembler User Exit DSECT (ANRUSRXA)
Readable Text File Exit (FILETEXTEXIT) Format
Appendix B. Notices
Programming Interface
Trademarks
Glossary
Index