IBM Tivoli Storage Manager

Version 6.3.0

Client Messages and Application

Programming Interface Return Codes



SC27-2878-01

IBM Tivoli Storage Manager

Version 6.3.0

Client Messages and Application

Programming Interface Return Codes



SC27-2878-01

Note:
Before using this information and the product it supports, read the information in Notices on page 319.

This edition applies to Version 6.3.0 of the IBM Tivoli Storage Manager (product numbers 5608-E01, 5608-E02,
5608-E03, 5608-E07, 5608-E12) and to all subsequent releases and modification until otherwise indicated in new
editions or technical newsletters. This edition replaces SC27-2877-01.
Copyright IBM Corporation 1993, 2011.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
About this publication

. . . . . . . . v

Who should read this guide . . . . . . . .

Publications . . . . . . . . . . . . .
Tivoli Storage Manager publications . . . .
Support information . . . . . . . . . .

. v
. v
. vi
viii

Chapter 1. Introduction to messages . . 1

Message format . . . . . . . . . . . .
Interpreting return code messages . . . . . .
Example one for QUERY EVENT command . .
Example two for DEFINE VOLUME command .

.
.
.
.

1
2
3
3

Chapter 2. ANS 0001-9999: Client

messages, version 6.3 . . . . . . . . 5
ANS 0000-9999: Version 6.3.0 changes from the
previous version . . . . . . . . . . . .
ANS 0000-9999: Version 6.3.0 deletions from the
previous version . . . . . . . . . . . .
Version 6.3.0 client messages (ANS0001-ANS9999)

Copyright IBM Corp. 1993, 2011

. 5
. 9
10

Chapter 3. API return codes, version

6.3 . . . . . . . . . . . . . . . . 273
API return code format . . . . . . . .
API return codes: Changes from the previous
version . . . . . . . . . . . . .
API return codes: Deletions from the previous
version . . . . . . . . . . . . .
Version 6.3.0 API return codes . . . . . .

. 273

. 273

.
.

. 274
. 274

Appendix. Accessibility features for

the Tivoli Storage Manager product
family. . . . . . . . . . . . . . . 317
Notices . . . . . . . . . . . . . . 319
Trademarks .

. 321

Glossary . . . . . . . . . . . . . 323

iii

iv

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

About this publication

Tivoli Storage Manager is an enterprise-wide storage management application for
the network. It provides automated storage management services to multi-vendor
workstations, personal computers, and local area network (LAN) file servers.
This publication contains explanations and suggested actions for messages issued
by the following Tivoli Storage Manager components:
v Administrative client
v Backup-Archive client
v Space Management (Hierarchical storage management (HSM) client for UNIX
and Linux)
v Application programming interface (API)

Who should read this guide

The target audience for this publication is system administrators who service the
Tivoli Storage Manager components.

Publications
Publications for the IBM Tivoli Storage Manager family of products are available
online. The IBM Tivoli Storage Manager product family includes IBM Tivoli
Storage FlashCopy Manager, IBM Tivoli Storage Manager for Space Management,
IBM Tivoli Storage Manager for Databases, and several other storage management
products from IBM Tivoli.
To search all publications, go to the Tivoli Storage Manager information center at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3.
You can download PDF versions of publications from the Tivoli Storage Manager
information center or from the IBM Publications Center at http://www.ibm.com/
shop/publications/order/.
Go to Tivoli Documentation Central to find information centers that contain official
product documentation for current and previous versions of Tivoli products,
including the Tivoli Storage Manager product family. You can find Tivoli
Documentation Central at https://www.ibm.com/developerworks/wikis/display/
tivolidoccentral/Home.
You can also order some related publications from the IBM Publications Center
website. The website provides information about ordering publications from
countries other than the United States. In the United States, you can order
publications by calling 1-800-879-2755.

Copyright IBM Corp. 1993, 2011

Tivoli Storage Manager publications

The following tables list the publications that make up the Tivoli Storage Manager
library.
Table 1. Tivoli Storage Manager server publications
Publication title

Order number

IBM Tivoli Storage Manager for AIX Installation Guide

GC23-9781

IBM Tivoli Storage Manager for AIX Administrator's Guide

SC23-9769

IBM Tivoli Storage Manager for AIX Administrator's Reference

SC23-9775

IBM Tivoli Storage Manager for HP-UX Installation Guide

GC23-9782

IBM Tivoli Storage Manager for HP-UX Administrator's Guide

SC23-9770

IBM Tivoli Storage Manager for HP-UX Administrator's Reference

SC23-9776

IBM Tivoli Storage Manager for Linux Installation Guide

GC23-9783

IBM Tivoli Storage Manager for Linux Administrator's Guide

SC23-9771

IBM Tivoli Storage Manager for Linux Administrator's Reference

SC23-9777

IBM Tivoli Storage Manager for Oracle Solaris Installation Guide

GC23-9784

IBM Tivoli Storage Manager for Oracle Solaris Administrator's Guide

SC23-9772

IBM Tivoli Storage Manager for Oracle Solaris Administrator's Reference

SC23-9778

IBM Tivoli Storage Manager for Windows Installation Guide

GC23-9785

IBM Tivoli Storage Manager for Windows Administrator's Guide

SC23-9773

IBM Tivoli Storage Manager for Windows Administrator's Reference

SC23-9779

IBM Tivoli Storage Manager for z/OS Media Installation and User's
Guide

SC27-4018

IBM Tivoli Storage Manager Upgrade and Migration Guide for V5

Servers

GC27-4017

IBM Tivoli Storage Manager Integration Guide for Tivoli Storage

Manager FastBack

SC27-2828

Table 2. Tivoli Storage Manager storage agent publications

Publication title

Order number

IBM Tivoli Storage Manager for SAN for AIX Storage Agent User's
Guide

SC23-9797

IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User's
Guide

SC23-9798

IBM Tivoli Storage Manager for SAN for Linux Storage Agent User's
Guide

SC23-9799

IBM Tivoli Storage Manager for SAN for Oracle Solaris Storage Agent
User's Guide

SC23-9800

IBM Tivoli Storage Manager for SAN for Windows Storage Agent User's
Guide

SC23-9553

Table 3. Tivoli Storage Manager client publications

vi

Publication title

Order number

IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive

Clients Installation and User's Guide

SC23-9791

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Table 3. Tivoli Storage Manager client publications (continued)

Publication title

Order number

IBM Tivoli Storage Manager for Windows: Backup-Archive Clients

Installation and User's Guide

SC23-9792

IBM Tivoli Storage Manager Using the Application Programming

Interface

SC23-9793

IBM Tivoli Storage Manager for Space Management for UNIX and Linux: SC23-9794
Users Guide
IBM Tivoli Storage Manager HSM for Windows Administration Guide

SC23-9795

Table 4. Tivoli Storage Manager data protection publications

Publication title

Order number

IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft
SQL Server Installation and Users Guide

GC27-4010

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC27-4019
UNIX and Linux Installation and Users Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC27-4020
Windows Installation and Users Guide
IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft
Exchange Server Installation and Users Guide

GC27-4009

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino
UNIX and Linux Installation and Users Guide

SC27-4021

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino
for Windows Installation and Users Guide

SC27-4022

IBM Tivoli Storage Manager for Enterprise Resource Planning: Data

Protection for SAP Installation and Users Guide for DB2

SC33-6341

IBM Tivoli Storage Manager for Enterprise Resource Planning: Data

Protection for SAP Installation and Users Guide for Oracle

SC33-6340

IBM Tivoli Storage Manager for Virtual Environments Installation and

Users Guide

SC27-2898

IBM Tivoli Storage Manager for Microsoft SharePoint Guide

N/A

Table 5. IBM Tivoli Storage Manager troubleshooting and tuning publications

Publication title

Order number

IBM Tivoli Storage Manager Problem Determination Guide

GC23-9789

IBM Tivoli Storage Manager Performance Tuning Guide

GC23-9788

IBM Tivoli Storage Manager Client Messages and Application

Programming Interface Return Codes

SC27-2878

IBM Tivoli Storage Manager Server Messages and Error Codes

SC27-2877

IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft
Exchange Server Messages

GC27-4011

IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft
SQL Server Messages

GC27-4012

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle
Messages

SC27-4014

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino
Messages

SC27-4015

About this publication

vii

Table 5. IBM Tivoli Storage Manager troubleshooting and tuning publications (continued)
Publication title

Order number

IBM Tivoli Storage Manager for Enterprise Resource Planning: Data

Protection for SAP Messages

SC27-4016

Note: You can find information about IBM System Storage Archive Manager at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3/
c_complydataretention_ovr.html.

Support information
You can find support information for IBM products from various sources.
Start at the IBM Support Portal: http://www.ibm.com/support/entry/portal/. You
can select the products that you are interested in and search for a wide variety of
relevant information.

Getting technical training

Information about Tivoli technical training courses is available online.
Go to the following websites to sign up for training, ask questions, and interact
with others who use IBM storage products.
Tivoli software training and certification
Choose from instructor led, online classroom training, self-paced Web
classes, Tivoli certification preparation, and other training options at
http://www.ibm.com/software/tivoli/education/
Tivoli Support Technical Exchange
Technical experts share their knowledge and answer your questions in
webcasts at http://www.ibm.com/software/sysmgmt/products/support/
supp_tech_exch.html.
Storage Management community
Interact with others who use IBM storage management products at
http://www.ibm.com/developerworks/servicemanagement/sm/
index.html
Global Tivoli User Community
Share information and learn from other Tivoli users throughout the world
at http://www.tivoli-ug.org/.
IBM Education Assistant
View short "how to" recordings designed to help you use IBM software
products more effectively at http://publib.boulder.ibm.com/infocenter/
ieduasst/tivv1r0/index.jsp

viii

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Searching knowledge bases

If you have a problem with your Tivoli Storage Manager family product, there are
several knowledge bases that you can search.
Begin by searching the Tivoli Storage Manager Information Center at
http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3. From this website, you
can search the current Tivoli Storage Manager documentation.
Searching the Internet:
If you cannot find an answer to your question in the IBM Tivoli Storage Manager
information center, search the Internet for the information that might help you
resolve your problem.
To search multiple Internet resources, go to the IBM support website at
http://www.ibm.com/support/entry/portal/.
You can search for information without signing in. Sign in using your IBM ID and
password if you want to customize the site based on your product usage and
information needs. If you do not already have an IBM ID and password, click Sign
in at the top of the page and follow the instructions to register.
From the support website, you can search various resources including:
v
v
v
v

IBM technotes
IBM downloads
IBM Redbooks publications
IBM Authorized Program Analysis Reports (APARs)

Select the product and click Downloads to search the APAR list.
If you still cannot find a solution to the problem, you can search forums and
newsgroups on the Internet for the latest information that might help you find
problem resolution.
An independent user discussion list, ADSM-L, is hosted by Marist College. You can
subscribe by sending an email to [email protected]. The body of the message
must contain the following text: SUBSCRIBE ADSM-L your_first_name
your_family_name.
To share your experiences and learn from others in the Tivoli Storage Manager and
Tivoli Storage FlashCopy Manager user communities, go to the following wikis:
Tivoli Storage Manager wiki
http://www.ibm.com/developerworks/wikis/display/
tivolistoragemanager
Tivoli Storage FlashCopy Manager wiki
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home/
wiki/Tivoli Storage FlashCopy Manager

About this publication

ix

Using IBM Support Assistant:

IBM Support Assistant is a complimentary software product that can help you with
problem determination. It is available for some Tivoli Storage Manager and Tivoli
Storage FlashCopy Manager products.
To learn about which products are supported, go to the IBM Support Assistant
download web page at http://www.ibm.com/software/support/isa/
download.html.
IBM Support Assistant helps you gather support information when you must open
a problem management record (PMR), which you can then use to track the
problem. The product-specific plug-in modules provide you with the following
resources:
v Support links
v Education links
v Ability to submit problem management reports
You can find more information at the IBM Support Assistant website:
http://www.ibm.com/software/support/isa/
You can also install the stand-alone IBM Support Assistant application on any
workstation. You can then enhance the application by installing product-specific
plug-in modules for the IBM products that you use. Find add-ons for specific
products at http://www.ibm.com/support/docview.wss?uid=swg27012689.
Finding product fixes:
A product fix to resolve your problem might be available from the IBM software
support website.
You can determine what fixes are available by checking the IBM software support
website at http://www.ibm.com/support/entry/portal/.
v If you previously customized the site based on your product usage:
1. Click the link for your product, or a component for which you want to find a
fix.
2. Click Downloads, and then click Fixes by version.
v If you have not customized the site based on your product usage, click
Downloads and search for your product.
Receiving notification of product fixes:
You can receive notifications about fixes, flashes, upgrades, and other news about
IBM products.
To sign up to receive notifications about IBM products, follow these steps:
1. From the support page at http://www.ibm.com/support/entry/portal/, click
Sign in to create, manage, or view your subscriptions in the Notifications
pane.
2. Sign in using your IBM ID and password. If you do not have an ID and
password, click register now and complete the registration process.
3. Click Manage all my subscriptions in the Notifications pane.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

4. Click the Subscribe tab and then click Tivoli.

5. Select the products for which you want to receive notifications and click
Continue.
6. Specify your notification preferences and click Submit.

Contacting IBM Software Support

You can contact IBM Software Support if you have an active IBM subscription and
support contract and if you are authorized to submit problems to IBM.
To obtain help from IBM Software Support, complete the following steps:
1. Ensure that you have completed the following prerequisites:
a. Set up a subscription and support contract.
b. Determine the business impact of your problem.
c. Describe your problem and gather background information.
2. Follow the instructions in Submitting the problem to IBM Software Support
on page xii.
Setting up a subscription and support contract:
Set up a subscription and support contract. The type of contract that you need
depends on the type of product you have.
For IBM distributed software products (including, but not limited to, IBM Tivoli,
Lotus, and Rational products, as well as IBM DB2 and IBM WebSphere
products that run on Microsoft Windows or on operating systems such as AIX or
Linux), enroll in IBM Passport Advantage in one of the following ways:
v Online: Go to the Passport Advantage website at http://www.ibm.com/
software/lotus/passportadvantage/, click How to enroll, and follow the
instructions.
v By telephone: You can call 1-800-IBMSERV (1-800-426-7378) in the United States.
For the telephone number to call in your country, go to the IBM Software
Support Handbook web page at http://www14.software.ibm.com/webapp/
set2/sas/f/handbook/home.html and click Contacts.
Determining the business impact:
When you report a problem to IBM, you are asked to supply a severity level.
Therefore, you must understand and assess the business impact of the problem
you are reporting.
Severity 1

Critical business impact: You are unable to use the program,

resulting in a critical impact on operations. This condition
requires an immediate solution.

Severity 2

Significant business impact: The program is usable but is

severely limited.

Severity 3

Some business impact: The program is usable with less

significant features (not critical to operations) unavailable.

Severity 4

Minimal business impact: The problem causes little impact on

operations, or a reasonable circumvention to the problem has
been implemented.

About this publication

xi

Describing the problem and gathering background information:

When explaining a problem to IBM, it is helpful to be as specific as possible.
Include all relevant background information so that IBM Software Support
specialists can help you solve the problem efficiently.
To save time, know the answers to these questions:
v What software versions were you running when the problem occurred?
v Do you have logs, traces, and messages that are related to the problem
symptoms? IBM Software Support is likely to ask for this information.
v Can the problem be re-created? If so, what steps led to the failure?
v Have any changes been made to the system? For example, hardware, operating
system, networking software, and so on.
v Are you using a workaround for this problem? If so, be prepared to explain it
when you report the problem.
Submitting the problem to IBM Software Support:
You can submit the problem to IBM Software Support online or by telephone.
Online
Go to the IBM Software Support website at http://www.ibm.com/
support/entry/portal/Open_service_request/Software/
Software_support_(general). Sign in to access IBM Service Requests and
enter your information into the problem submission tool.
By telephone
For the telephone number to call in your country, go to the IBM Software
Support Handbook at http://www14.software.ibm.com/webapp/set2/sas/
f/handbook/home.html and click Contacts.

xii

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Chapter 1. Introduction to messages

This information contains explanations and suggested actions for messages issued
by Tivoli Storage Manager products and components.
This introduction contains information to help you understand the messages.
The client can send statistics to the server providing information about a backup or
restore. These statistics are informational messages that can be enabled or disabled
to the various event logging receivers. These messages are not documented.
Messages can appear on the server console, the administrative client, an operator
terminal, the administrative graphical user interface, the backup-archive client, or
the HSM (Hierarchical Storage Management) client.
Tivoli Storage Manager provides an activity log to help the administrator track
server activity and monitor the system. The activity log contains messages
generated by the server, and is stored in the database. The server automatically
deletes messages from the activity log after they have passed the specified
retention period. Any messages sent to the server console are stored in the activity
log. Examples of the types of messages stored in the activity log include:
v
v
v
v

When client sessions start or end

When migration starts or ends
When backed up files are expired from server storage
Any output generated from background processes

See the Tivoli Storage Manager Administrator's Guide for more information about
activity logs.

Message format
Messages consist of the following elements:
v A three-letter prefix. Messages have different prefixes to help you identify the
Tivoli Storage Manager component that issues the message. Typically, all
messages for a component have the same prefix. Sometimes a component issues
messages with two or three different prefixes.
For example, clients issue messages with ANS prefix. Client events that are
logged to server have ANE prefix. And server common and platform-specific
messages have ANR prefix.
v A numeric message identifier.
v A one-letter severity code. The following letters give an indication of the severity
of the action that generated the message. The severity codes and their meanings
are as follows:
E
W
I

Error
Warning
Information

Processing cannot continue.

Processing can continue, but problems may occur later.
Processing continues. User response is not necessary.

v Message text that is displayed on screen and written to message logs.

v Explanation, System Action, and User Response texts. These texts elaborate on
the message text, and are accessible only in documentation.
Copyright IBM Corp. 1993, 2011

The image below presents a typical message.

The callouts on the right of the image identify each element of the message.
Message Prefix
Message Number
Message Type*
ANR 0992 I
Server installation complete.

Message Text

Explanation: The server installation procedure

has completed successfully. The server is now
available for normal operation.

Explanation

System Action: Server completes installation

processing.

System Action

User Response: None.

User Response

* I = Information
E = Error
S = Severe Error
W = Warning
K = Kernel message that originates from the
hierarchical storage management (HSM) client

Message variables in the message text appear in italics.

Interpreting return code messages

Many different commands can generate the same return code. The following
examples are illustrations of two different commands issued that result in the same
return code; therefore, you must read the descriptive message for the command.
In these examples, two different commands yield the same return code, but they
also return descriptive messages that are unique to each command. The two
commands are q event standard dddd and def vol cstg05 primary. Both yield a
generic message with return code:
ANS5102I: Return Code 11.

But the first command also yields a descriptive message:

ANR2034I: QUERY EVENT: No match found for this query.

And the second command also yields a unique, descriptive message:

ANRxxxx: DEFINE VOLUME: Storage pool CSTG05 is not defined.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Example one for QUERY EVENT command

Example two for DEFINE VOLUME command

Chapter 1. Introduction to messages

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Chapter 2. ANS 0001-9999: Client messages, version 6.3

This section contains messages for the following clients:
v Administrative clients
v Application program interface clients
v Backuparchive and space management (HSM) clients
Messages with prefix ANS and in the range 0001-9999 are issued by these clients.
Version 6.3.0 client messages that are new, changed, or deleted since the previous
version are listed in one section. All version 6.3.0 client messages are documented
in another section.

ANS 0000-9999: Version 6.3.0 changes from the previous version

This section lists the version 6.3.0 ANS messages that are new or changed since the
previous version. Only the message ID is listed.
ANS0993E
ANS1015E
ANS1031E
ANS1035S
ANS1075E
ANS1101E
ANS1105E
ANS1120E
ANS1140E
ANS1145E
ANS1198E
ANS1209E
ANS1243E
ANS1259E
ANS1273E
ANS1300E
ANS1319E
ANS1333I
ANS1371E
ANS1470E
ANS1513E
ANS1587W
ANS1589W
ANS1696E
ANS1700W
ANS1704W
ANS1706E
ANS1711W
Copyright IBM Corp. 1993, 2011

ANS1729E
ANS1730E
ANS1731E
ANS1732W
ANS1733I
ANS1734W
ANS1735W
ANS1736I
ANS1737E
ANS1738W
ANS1739E
ANS1740W
ANS1741W
ANS1742E
ANS1743E
ANS1744E
ANS1745I
ANS1746E
ANS1747W
ANS1748E
ANS1770E
ANS1773W
ANS1774W
ANS1779I
ANS1780E
ANS1781I
ANS1782E
ANS1783I
ANS1784E
ANS1787I
ANS1788I
ANS1789I
ANS1790E
ANS1795I
ANS1818E
ANS1836I
ANS1947W
ANS1987E
ANS2032I
ANS2033I
ANS2034I
ANS2035I
ANS2039E
ANS2045I
ANS2102E

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2103E
ANS2104E
ANS2105I
ANS2808W
ANS2809E
ANS2810E
ANS2811E
ANS2812E
ANS2813E
ANS2814E
ANS2815E
ANS2816E
ANS2817E
ANS2818E
ANS2824E
ANS2825E
ANS2826E
ANS2827E
ANS2828E
ANS2832E
ANS2833E
ANS2838W
ANS2839E
ANS2842E
ANS2888E
ANS4020E
ANS4077E
ANS4164W
ANS4166E
ANS4168E
ANS4169E
ANS4170E
ANS4171E
ANS4174E
ANS4177E
ANS4199W
ANS4223E
ANS4254E
ANS4255E
ANS4256E
ANS4257E
ANS4258E
ANS4259E
ANS4260E
ANS4261E
Chapter 2. ANS 0001-9999: Client messages, version 6.3

ANS4262E
ANS4263E
ANS4264E
ANS4265I
ANS4266I
ANS4267I
ANS4268I
ANS4269W
ANS4270I
ANS4271E
ANS4272E
ANS4273E
ANS4274E
ANS4275E
ANS4276E
ANS4277E
ANS4278E
ANS4280E
ANS4281E
ANS4282E
ANS4283E
ANS4284E
ANS4297W
ANS4298E
ANS4299E
ANS4901E
ANS4999I
ANS5176W
ANS5177E
ANS5224W
ANS5225W
ANS5226E
ANS5227E
ANS5279E
ANS5280E
ANS5307E
ANS7422E
ANS7526E
ANS7534W
ANS7552I
ANS7641I
ANS8005E
ANS8062E
ANS8063E
ANS8106E

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS8512W
ANS8809E
ANS8810E
ANS8811E
ANS9355E
ANS9356E
ANS9370W
ANS9372E
ANS9384W
ANS9385W
ANS9386W
ANS9387W
ANS9388E
ANS9389W
ANS9390W
ANS9391W
ANS9402E
ANS9404E
ANS9418W
ANS9510E
ANS9892E
ANS9951I
ANS9959W
ANS9987W

ANS 0000-9999: Version 6.3.0 deletions from the previous version

This section lists the messages that are deleted since the previous version. Only the
message ID is listed.
ANS4053E
ANS9288I
ANS9289I
ANS9290I
ANS9297I
ANS9298I
ANS9950E
ANS9951E
ANS15016T
ANS15017T
ANS15018T
ANS15019T
ANS15178T
ANS15179T
ANS16022T

Chapter 2. ANS 0001-9999: Client messages, version 6.3

Version 6.3.0 client messages (ANS0001-ANS9999)

This section documents the Tivoli Storage Manager version 6.3.0 client messages.
The messages are listed in ascending numeric order. The complete message is
documented, including message ID, message text, explanation, system action, and
user response.
ANS0101E

Unable to open English message

repository file name.

Explanation: The default English message repository

file cannot be opened. Either the file access permissions
prevent reading the file or the file is not present in the
expected location.

system administrator for further help.

ANS0106E

Message index not found for message

number.

Explanation: The message repository file does not

contain the message text for the message number.

System action: TSM is unable to complete the

requested operation. Processing is terminated.

System action: TSM is unable to complete the

requested operation.

User response: Make sure the file in your DSM_DIR is

set up properly. If the problem continues, see your
system administrator for further help.

User response: Make sure the DSM_DIR is set up

properly and it does not point to an old copy. If the
problem continues, see your system administrator for
further help.

ANS0102W

Unable to open the message repository

file name. The American English
repository will be used instead.

ANS0107E

Error trying to read header for message

number from repository file name.

Explanation: The default message repository file for

the current locale cannot be opened. Either the file
access permissions prevent reading the file, the file is
not present in the expected location, or the language
specified in the option file is not supported on this
workstation.

Explanation: The message header information cannot

be obtained for the message number in the message
file.

System action: TSM continues processing using the

English language message repository.

User response: Make sure the file has not been altered
from the installation. If the problem continues, see your
system administrator for further help.

User response: Make sure the file in your DSM_DIR is

set up properly. If the problem continues, see your
system administrator for further help.
ANS0103E

Error trying to read header record from

message repository file name.

System action: TSM is unable to complete the

requested operation.

ANS0108E

Error trying to read text for message

number from repository file name.

Explanation: The message text cannot be obtained for

the message number in the message file.

Explanation: The message repository file header

record cannot be obtained.

System action: TSM is unable to complete the

requested operation.

System action: TSM is unable to complete the

requested operation.

User response: Make sure the file has not been altered
from the installation. If the problem continues, see your
system administrator for further help.

User response: Make sure the file has not been altered
from the installation. If the problem continues, see your
system administrator for further help.
ANS0105E

Error trying to read index for message

number from repository file name.

Explanation: The message text for the specified

message number cannot be read.
System action: TSM is unable to complete the
requested operation.
User response: Make sure the file has not been altered
from the installation. If the problem continues, see your

10

ANS0109E

Insufficient memory for allocation of

message structure.

Explanation: There is not enough memory in your

system to allocate the storage needed for the message
text.
System action: TSM is unable to complete the
requested operation.
User response: Stop TSM and restart TSM. Then retry
the operation. If unsuccessful, close all unneeded
applications and retry the operation.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0110E

Unable to open error log file file name

for output.

Explanation: The error log cannot be opened for

output.
System action: TSM is unable to complete the
requested operation. File permissions may be set such
that writing is not allowed.
User response: Stop and restart TSM. Then retry the
operation. If unsuccessful, make sure the file is not
being locked by another application and that file
permissions allow write access.
ANS0113E

Message repository file name has an

invalid control record.

Explanation: The message repository file contains an

incorrect control information.
System action: TSM is unable to complete the
requested operation.

language other than that of the current locale.

System action: TSM is unable to complete the
requested operation.
User response: If the message repository is not
corrupted, process the operation in the supported
locale.
ANS0121W

Unable to open the iconv converter for

the message repository file name. The
American English repository will be
used instead.

Explanation: The iconv converter for the default

message repository for the current locale cannot be
opened. The iconv converter used to convert from
UTF-8 to the current locale is not installed on this work
station.
System action: TSM continues processing using the
English language message repository.

User response: Make sure the message file was not

altered from the installation. Check DSM_DIR to make
sure it is set up properly.

User response: Make sure the required iconv

converter is installed properly. If the problem
continues, see your system administrator for further
help.

ANS0118E

ANS0201E

Unable to open schedule log file 'file

name' for output.

Explanation: The schedule log file cannot be opened

for output.
System action: TSM is unable to complete the
requested operation.
User response: Stop TSM and restart TSM. Then retry
the operation. If unsuccessful, make sure the file has
not been locked by another application.
ANS0119E

Error trying to read response string for

message number from repository file
name.

Explanation: The response string information for the

message number cannot be obtained from the message
repository file. It is possible the message repository has
been corrupted.

Invalid parameter was found.

Explanation: The system encountered an internal

program error due to an invalid parameter.
System action: The system returns to the calling
procedure.
User response: Ask your service representative to
check the error log.
ANS0202E

Not authorized to restore the other

node's data.

Explanation: The client is not authorized to restore the

other node's data.
System action: The system returns to the calling
procedure.
User response: Get authorization from the other node.

System action: TSM is unable to complete the

requested operation.

ANS0203E

User response: Make sure the message file was not

altered from the installation. Check DSM_DIR to make
sure it is set up properly.

Explanation: The objName field does not have a

leading directory separator.

ANS0120E

Message number number contains an

invalid multibyte sequence for the
current locale.

The objName field has no leading

directory separator.

System action: The system returns to the calling

procedure.
User response: Correct the value for the objName.

Explanation: An illegal multibyte sequence for the

current locale was found in the message. Either the
message repository has been corrupted or is coded in a
Chapter 2. ANS 0001-9999: Client messages, version 6.3

11

ANS0204E

Wildcards are not allowed in the

objName directory path.

ANS0209E

An error occurred while loading a

library.

Explanation: Wildcards are not allowed in the

objName directory path.

Explanation: An error occurred while loading a

library. The TCP/IP DLL load failed.

System action: The system returns to the calling

procedure.

System action: Processing stopped.

User response: Verify your TCP/IP installation.

User response: Correct the value for the objName.

ANS0210E
ANS0205E

Unable to open error log file.

Explanation: The system is unable to open the error

log file.
System action: The system returns to the calling
procedure.
User response: Verify the DSMI_LOG value and
access permission. On the AS/400 platform, verify the
value specified for ERRORLOGNAME in the API
options file.
ANS0206E

The log file cannot be written to.

The TCP/IP load function failed.

Explanation: An error occurred while locating a

function. The TCP/IP load function failed.
System action: Processing stopped.
User response: Verify your TCP/IP installation.
ANS0211E

The object name pointer is NULL.

Explanation: There is no value provided for the object

name pointer.
System action: The system returns to the calling
procedure.

Explanation: There was an error writing to the log

file.

User response: Provide an address for the

dsmObjName structure.

System action: The system returns to the calling

procedure.

ANS0212E

The data block pointer is NULL.

User response: Verify the DSMI_LOG value and

access permission. on the AS/400 platform, verify the
value specified for ERRORLOGNAME in the API
options file.

Explanation: There is no value provided for the data

block pointer.

ANS0207E

User response: Provide an address for the DataBlk

structure.

The log file name was not specified.

Explanation: The system is unable to open the error

log file.
System action: The system returns to the calling
procedure.
User response: Verify the DSMI_LOG value and
access permission. On the AS/400 platform, verify the
value specified for ERRORLOGNAME in the API
options file.
ANS0208E

The TCP/IP WINSOCK.DLL file cannot

be found.

System action: The system returns to the calling

procedure.

ANS0213E

The object attribute pointer is NULL.

Explanation: There is no value provided for the object

attribute pointer.
System action: The system returns to the calling
procedure.
User response: Provide an address for the ObjAttr
structure.
ANS0214E

There is no server session information.

Explanation: The TCP/IP WINSOCK.DLL file cannot

be found.

Explanation: The server did not respond with the

session information.

System action: Processing stopped.

System action: The system returns to the calling

procedure.

User response: Verify your TCP/IP installation.

User response: Verify the server status.

12

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0215E

There is no server policy information.

Explanation: The server did not respond with the

policy information.
System action: The system returns to the calling
procedure.
User response: Verify the server policy definitions.

ANS0221E

There was an error in the TSM API

internals.

Explanation: The system encountered an error in the

API internals.
System action: The system returns to the calling
procedure.

Explanation: The value for the dataBlk bufferLen is

zero.

User response: Shut down the process and retry the

operation. Verify that any previous dsmInit calls were
cleaned up and terminated by a dsmTerminate call. If
the problem continues, contact your system
administrator or service representative.

System action: The system returns to the calling

procedure.

ANS0222E

ANS0216E

The dataBlk bufferLen value is zero.

User response: Provide a non-zero value for the

bufferLen.
ANS0217E

The dataBlk bufferPtr is NULL.

Explanation: There is no value provided for the

dataBlk bufferPtr.
System action: The system returns to the calling
procedure.

The repository type is invalid.

Explanation: The repository type is invalid.

System action: The system returns to the calling
procedure.
User response: For dsmDeleteFS the repository must
be one of the following:
v DSM_ARCHIVE_REP
v DSM_BACKUP_REP
v DSM_REPOS_ALL.

User response: Provide an address for the bufferPtr.

ANS0223E
ANS0218E

The objType is invalid.

Filespace name should start with the

directory delimiter.

Explanation: The value for the objType is invalid.

Explanation: The filespace name is invalid.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: The value for dsmObjName.objType

must be:

User response: Filespace name should start with the

directory delimiter.

DSM_OBJ_FILE or DSM_OBJ_DIRECTORY for

Backup, or

ANS0224E

DSM_OBJ_FILE for Archive.

ANS0219E

The dsmEndTxn vote is invalid.

Explanation: The dsmEndTxn vote is invalid.

System action: The system returns to the calling
procedure.
User response: The vote must be
DSM_VOTE_COMMIT or DSM_VOTE_ABORT.
ANS0220E

An invalid option was found during

option parsing.

Explanation: An invalid option was found.

System action: The system returns to the calling
procedure.
User response: Verify the options in dsm.opt, dsm.sys,
and the options string. Check the error log for more
details about the error. on the AS/400 platform, verify
the options in *LIB/QOPTTSM(APIOPT).

The object name is either an empty

string or has no leading delimiter.

Explanation: The object name is invalid because of an

empty string or there is no leading delimiter.
System action: The system returns to the calling
procedure.
User response: Verify the format of the dsmObjName
full path.
ANS0225E

Low level qualifier of the object name

should start with the directory delimiter.

Explanation: The low level qualifier for the object

name is invalid.
System action: The system returns to the calling
procedure.
User response: Start the low level qualifier of the
object name with the directory delimiter.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

13

ANS0226E

The object owner is invalid.

ANS0231E

The management class name was not

found.

Explanation: The object owner must be either the root

user, or the object owner must be the same as the
session owner.

Explanation: A query or send operation is unable to

find the management class name.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Verify the session owner and object

owner.

User response: Verify the management class name.

ANS0232E

ANS0227E

The dsmBindMC sendType is invalid.

Explanation: The dsmBindMC sendType is invalid.

System action: The system returns to the calling
procedure.
User response: The sendType must be one of the
following:
stBackup
stArchive
stBackupMountWait
stArchiveMountWait
ANS0228E

The dsmSendObj sendType is invalid.

Explanation: The dsmSendObj sendType is invalid.

System action: The system returns to the calling
procedure.
User response: The sendType must be one of the
following:
stBackup

Explanation: The drive letter is not an alphabetic

character. This return code is valid on Microsoft
Windows only.
System action: The system returns to the calling
procedure.
User response: Verify that the drive designation is an
alphabetic character. The referenced field is
dsmDosFSAttrib.driveLetter.
ANS0233E

System action: The system returns to the calling

procedure.
User response: Provide a filespace name on
dsmRegisterFS.
ANS0234E

stArchiveMountWait
ANS0229E

The dsmDeleteObj delType is invalid.

Explanation: The dsmDeleteObj delType is invalid.

System action: The system returns to the calling
procedure.
User response: The delType must be dtBackup or
dtArchive.
ANS0230E

The query Backup objState is invalid.

The Register Filespace name is NULL.

Explanation: There is no value provided for the

Register Filespace name.

stArchive
stBackupMountWait

The drive letter is not an alphabetic

character.

The new password value is NULL or

blank.

Explanation: There is no value provided for new

password.
System action: The system returns to the calling
procedure.
User response: Provide a new password on
dsmChangePW.
ANS0235E

The old password value is NULL or

blank.

Explanation: There is no value provided for old

password.

Explanation: The query Backup objState is invalid.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Provide an old password on

dsmChangePW.

User response: The qryBackupData.objState must be

one of the following:
DSM_ACTIVE
DSM_INACTIVE
DSM_ANY_MATCH

14

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0236E

On dsmInit, the owner is not allowed to

establish a session when
PASSWORDACCESS=generate.

Explanation: PASSWORDACCESS=GENERATE
establishes a session with the current login user as the
owner. The application should set clientOwnerNameP
to NULL when PASSWORDACCESS=GENERATE is in
effect.
System action: The system returns to the calling
procedure. Whether the application can continue
processing depends on how the application handles the
error.
User response: This message applies to applications
that utilize the TSM API, and is intended primarily for
the vendor of the application for which the message is
issued. Depending on the application, this could be a
configuration issue.
Consult the documentation for the application and
verify that the application is configured correctly. If the
problem persists, contact the application vendor for
further assistance.
ANS0237E

On dsmInit, the node is not allowed

when PASSWORDACCESS=generate.

Explanation: PASSWORDACCESS=generate
establishes a session with the current hostname as the
node.

ANS0240E

The filespace to delete/set access cannot

be found.

Explanation: The filespace to delete cannot be found.

System action: The system returns to the calling
procedure.
User response: Verify the filespace name.
ANS0241E

On dsmSendObj, dsmDeleteObj, or
dsmUpdateFS the filespace is not
registered.

Explanation: On dsmSendObj, dsmDeleteObj, or

dsmUpdateFS, the filespace is not registered.
System action: The system returns to the calling
procedure.
User response: Verify the filespace name.
ANS0242W

On dsmRegisterFS the filespace is

already registered.

Explanation: On dsmRegisterFS the filespace is

already registered.
System action: The system returns to the calling
procedure.
User response: Verify the filespace name.

System action: The system returns to the calling

procedure.

ANS0243E

User response: When using

PASSWORDACCESS=generate, set clientNodeNameP to
NULL.

Explanation: On dsmBeginGetData, the objID is

NULL.

ANS0238E

User response: Verify the following:

The sequence of calls is invalid.

On dsmBeginGetData the objID is

NULL.

System action: The system returns to the calling

procedure.

Explanation: The sequence of calls is invalid.

The dsmGetList is not NULL.

System action: The system returns to the calling

procedure.

Each objID is not NULL.

The dsmGetList numObjId is not zero.

User response: Verify the transaction call sequence.

ANS0244E
ANS0239E

On dsmSendObj, wildcards are not

allowed for the objName.

Explanation: On dsmSendObj, wildcards are not

allowed for the objName.
System action: The system returns to the calling
procedure.
User response: Provide a fs, hl, and ll on the
dsmObjName.

On dsmInit the caller's API version is

different than the TSM library version.

Explanation: On dsmInit the caller's API version has a

higher value than the TSM library version.
System action: The system returns to the calling
procedure.
User response: Install the latest TSM API library and
trusted agent module.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

15

ANS0245E

The caller's structure version is different

than the TSM library version.

ANS0250E

Memory used by the TSM API has been

corrupted.

Explanation: The caller's structure version is different

than the TSM library version.

Explanation: Memory used by the TSM API has been

corrupted.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Ensure that the stVersion field is set

with the value in the header file. Recompile the
application with the latest header files.

User response: Retry the operation. If the problem

continues, contact your system administrator or service
representative.

ANS0246E

ANS0251E

Issue dsmEndTxn and then begin a new

transaction session.

Explanation: This transaction must be ended and a

new one must be started due to one of the following
reasons:
The destination changed.
The byte limit is exceeded
The maximum number of objects is exceeded.

The sendObj Archive description is too

long.

Explanation: The sendObj Archive description is too

long.
System action: The system returns to the calling
procedure.
User response: The sndArchiveData.descr string must
be less than or equal to DSM_MAX_DESCR_LENGTH.

System action: The system returns to the calling

procedure.

ANS0252E

User response: Issue dsmEndTxn and start a new

transaction session.

Explanation: The sendObj ObjAttr.objInfo is too long.

ANS0247E

System action: The system returns to the calling

procedure.

The backup or archive object is

excluded from processing.

Explanation: The backup or archive object is excluded

from processing.

The sendObj ObjAttr.objInfo is too

long.

User response: The objInfo field must be less than or

equal to DSM_MAX_OBJINFO_LENGTH.

System action: The system returns to the calling

procedure.

ANS0253E

User response: Verify the objName and Exclude lists.

Explanation: The sendObj dsmObjName.hl is too long.

ANS0248E

System action: The system returns to the calling

procedure.

The backup object does not have a copy

group.

Explanation: The backup object does not have a copy

group.

The sendObj dsmObjName.hl is too

long.

User response: The hl field must be less than or equal

to DSM_MAX_HL_LENGTH.

System action: The system returns to the calling

procedure.

ANS0254E

User response: Verify server policy definitions.

Explanation: The value provided for password or

encryptionPassword is too long.

ANS0249E

System action: The system returns to the calling

procedure.

The archive object does not have a copy

group.

Explanation: The archive object does not have a copy

group.
System action: The system returns to the calling
procedure.

The password, or encryptionPassword

string provided is too long.

User response: The password or encrypionPassword

field must be less than
DSM_MAX_VERIFIER_LENGTH.

User response: Verify server policy definitions.

16

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0255E

The sendObj dsmObjName.fs is too

long.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Correct the spelling of the option

keywords. Verify that the dsmInit configuration file
only has a subset of the dsm.sys options. Check the
error log for more details about the error.

User response: The fs field must be less than or equal

to DSM_MAX_FS_LENGTH.

ANS0261E

Explanation: The sendObj dsmObjName.fs is too long.

ANS0256E

The sendObj dsmObjName.ll is too

long.

Explanation: The sendObj dsmObjName.ll is too long.

System action: The system returns to the calling
procedure.
User response: The ll field must be less than or equal
to DSM_MAX_LL_LENGTH.
ANS0257E

On RegisterFS or UpdateFS the fsAttr's

fsInfo is too long.

The configuration file specified on

dsmInit cannot be opened.

Explanation: The configuration file specified on

dsmInit cannot be opened.
System action: The system returns to the calling
procedure.
User response: Verify the file name.
ANS0262E

The Include/Exclude definition file was

not found.

Explanation: The Include/Exclude definition file was

not found.

Explanation: On RegisterFS or UpdateFS the fsAttr's

fsInfo is too long.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Verify the file name on the Inclexcl

option.

User response: The fsInfo field must be less than or

equal to DSM_MAX_FSINFO_LENGTH.

ANS0263E

ANS0258I

On dsmGetNextQObj or dsmGetData
there is more available data.

Explanation: On dsmGetNextQObj or dsmGetData

there is more available data.
System action: The system returns to the calling
procedure.
User response: Call the function again.
ANS0259E

The dataBlk buffer is too small for the

query response.

Explanation: The dataBlk buffer is too small for the

query response.
System action: The system returns to the calling
procedure.
User response: On dsmGetNextQObj ensure that the
dataBlk buffer is at least as big as the query response
structure.
ANS0260E

An invalid option keyword was found

during option parsing.

Explanation: An invalid option keyword was found in

the dsmInit configuration file, the option string,
dsm.sys, or dsm.opt.

Either the dsm.sys file was not found, or

the Inclexcl file specified in dsm.sys
was not found.

Explanation: Either the dsm.sys file was not found, or

the Inclexcl file specified in dsm.sys was not found.
System action: The system returns to the calling
procedure.
User response: The dsm.sys file must be in the
directory referenced by the environment variable
DSMI_DIR. Verify the file name on the Inclexcl option
in the dsm.sys file.
ANS0264E

Only a UNIX root user can execute

dsmChangePW or dsmDeleteFS.

Explanation: Only a UNIX root user can execute

dsmChangePW or dsmDeleteFS.
System action: The system returns to the calling
procedure.
User response: Run this program as a root user.
ANS0265E

You must issue dsmBindMC before

dsmSendObj.

Explanation: You must issue dsmBindMC before

dsmSendObj.
System action: The system returns to the calling
procedure.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

17

User response: Modify your program.

ANS0266I

The dsmEndTxn vote is ABORT, so

check the reason field.

Explanation: After a dsmEndTxn call, the transaction

is aborted by either the server or client with a
DSM_VOTE_ABORT and the reason is returned.
System action: The system returns to the calling
procedure.
User response: Check the reason field for the code
which explains why the transaction has been aborted.

ANS0271E

No more files can be restored or

retrieved since the destination directory
is full.

Explanation: No more files can be restored or

retrieved since the destination directory is full.
System action: Processing stopped.
User response: Free up disk space, or restore or
retrieve the file to another disk.
ANS0272I

The operation is finished.

Explanation: The operation is finished.

ANS0267E

Invalid command line option/value:

'option'

System action: The system returns to the calling

procedure.

Explanation: The option is not valid on this command

line.

User response: Proceed with next function call.

System action: Processing stops

ANS0273E

User response: Verify that the option and value are

not misspelled and are valid with the current
command.

Explanation: The trusted agent execution/owner

permissions are invalid.

The trusted agent execution/owner

permissions are invalid.

System action: Processing stopped.

ANS0268E

Server problem: Destination not

defined.

Explanation: Server problem: Destination not defined.

User response: Have your system administrator check

the installation instructions for the client to ensure that
the trusted agent permissions are set correctly.

System action: Processing stopped.

User response: Have your service representative check
the error log.
ANS0269S

The structured file data type is

unknown.

Explanation: An unknown and unexpected error code

occurred within the client program. The structured file
data type is unknown. This is a programming failure
and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

ANS0274S

Process killed.

Explanation: Processing stopped. This is a

programming failure and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.
ANS0275S

Trusted agent would block the

operation.

Explanation: The trusted agent blocks the operation.

This is a programming failure and the client program
ends.
System action: Processing stopped.

ANS0270S

The data buffer overflowed.

Explanation: The data buffer overflowed. This is a

programming failure and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

User response: Retry the operation. If the problem

continues, contact your system administrator.
ANS0276S

The area for the include/exclude pattern

is too small.

Explanation: The area for the include/exclude pattern

is too small. This is a programming failure and the
client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

18

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0277S

There is no closing bracket in the

pattern.

Explanation: There is no closing bracket in the

pattern. This is a programming failure and the client
program ends.

ANS0283E

High level qualifier of the object name

should start with the directory delimiter.

Explanation: The high level qualifier for the object

name is invalid.

System action: Processing stopped.

System action: The system returns to the calling

procedure.

User response: Retry the operation. If the problem

continues, contact your system administrator.

User response: High level qualifier of the object name

should start with the directory delimiter.

ANS0278S

ANS0284E

The transaction will be aborted.

Explanation: The server encountered an error and will

abort the transaction.
System action: The transaction will be aborted. The
reason code is passed on the dsmEndTxn call.

The number of objects on

dsmBeginGetData exceeds
DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ.

User response: Issue the dsmEndTxn with a vote of

DSM_VOTE_COMMIT and examine the reason code.

Explanation: The number of objects (numObjId)

specified on the dsmBeginGetData call exceeds
DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ.

ANS0279I

System action: The system returns to the calling

procedure.

A file was skipped during a restore

operation because the file is off line and
the application has chosen not to wait
for a tape mount.

Explanation: A file was skipped during a restore

operation because the file is off line and the application
has chosen not to wait for a tape mount.

User response: Check the number of objects before

calling dsmBeginGetData. If it is greater than
DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ, then issue multiple
Get call sequences.

System action: File skipped.

ANS0285E

User response: Verify the application sets the

mountWait value correctly on dsmBeginGetData.

Explanation: The dsmUpdateFS or dsmUpdateObj

action is invalid.

ANS0280E

System action: The system returns to the calling

procedure.

Unable to find Trusted Agent module.

Explanation: TSM was unable to find the TSM Trusted

Agent module in the specified directory. The name of
the TSM Trusted Agent module is dsmtca.

The update action is invalid.

User response: Correct the action value. Valid values

are defined in dsmapitd.h and documented in our
Using the API book.

System action: TSM ends.

User response: Make sure the Trusted Agent module
is in the directory specified by DSMI_DIR.
ANS0281E

Access denied for dsmapitca.

Explanation: An attempt to access a system function

has been denied.
System action: Processing stopped.

ANS0286E

The key file is missing.

Explanation: The key file for Tivoli Data Protection

application client for Oracle cannot be found.
System action: The system returns to the calling
procedure.
User response: Ensure that you have ordered the
Tivoli Data Protection application client which contains
TDP for Oracle, and install the key file.

User response: Contact your system administrator.

ANS0287E
ANS0282E

Password file is not available.

Explanation: The file containing the stored password

for the specified server-name is unavailable.

The key file content is invalid.

Explanation: The key file content for Tivoli Data

Protection application client for Oracle is invalid.

System action: TSM ends.

System action: The system returns to the calling

procedure.

User response: The root user must set and store a new
password.

User response: Ensure that you have ordered the

Tivoli Data Protection application client which contains
Chapter 2. ANS 0001-9999: Client messages, version 6.3

19

the TDP for Oracle, and install the key file.

ANS0296I

Encryption key passwords are not the

same. Please try again...

ANS0302I

Successfully done.

Explanation: The operation successfully completed.

System action: None.

Explanation: TSM found that the encryption key

passwords do not match.

User response: None.

System action: You are prompted for the encryption

key password.

ANS0304E

User response: Enter the correct encryption key

password.
ANS0297E

Error opening specified file.

Explanation: The specified file could not be located or

opened.
System action: Attempts to open file failed.
User response: Make sure the file exists.
ANS0298E

Session Rejected: The specified user id

is currently locked

Explanation: The user id you specified is currently

locked on the server.
System action: Session was not started.
User response: Check with your system administrator
to find out why your user id is locked.

Explanation: User issued the Generate Password

command, but password access is not set to
GENERATE in the options file.
System action: TSM none.
User response: Add PASSWORDACCESS GENERATE
to your dsm.opt file .
ANS0305E

Scheduler cannot be started manually

because the value of
MANAGEDSERVICES option is
SCHEDULE.

Explanation: if MANAGEDSERVICES SCHEDULE is

indicated in the option file, the TSM scheduler cannot
be started in the traditional manner.
System action: Scheduler stopped.
User response: If you are not going to use dsmcad to
manage the schedule anymore, stop dsmcad and
remove MANAGEDSERVICES option from the option
file.

Unable to generate password because no

NAS Node was specified.

Explanation: User issued the Generate Password

command with class=NAS, but no NAS node was
specified.
System action: None.
User response: Retry the command and use the
-nasnodename option.
ANS0306E

ANS0299E

Unable to generate password because

password access is not set to
GENERATE.

Unable to generate password because

Class type is invalid or unknown.

Explanation: User issued the Generate Password

command with an invalid or unknown class.
System action: None.
User response: Retry the command and use a
supported class type option (class=CLIENT or
class=NAS).
ANS0307I

Password generated.

Explanation: User issued the Generate Password

command and it was successful.
System action: None.

ANS0301E

The TSM DLL dsm3270.dll cannot be

found in the user's path.

Explanation: The TSM DLL dsm3270.dll cannot be

found in the user's path.
System action: Communications link is not
established.
User response: Make sure that the TSM DLL
dsm3270.dll is in a directory that is included in the
user's path.

User response: None.

ANS0308E

Remote operation failed to start on

obj-name. Status: status reason: reason

Explanation: The request to start a remote operation

has failed for the indicated node and filespace. The
status and the reason for the failure are shown.
System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.

20

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0309E

Remote operation failed to start on

obj-name. Status: status

Explanation: The request to start a remote operation

has failed for the indicated node and filespace. The
status of the failure is shown.
System action: IBM Tivoli Storage Manager ended the
current operation.
User response: Contact your system administrator for
more information.
ANS0311E

The tsmBuffHandle is invalid, or the

value of dataPtr is invalid.

Explanation: An invalid value for a handle or dataPtr

has been passed into the API.
System action: The system returns to the calling
procedure.

continues, contact your system administrator or service

representative.
ANS0315E

Unable to open message text file.

Explanation: The system is unable to open the

message txt file (dscenu.txt or dsmclientV3.cat for
AIX). On the AS/400 platform this file is
QANSAPI/QAANSENU(TXT).
System action: The system returns to the calling
procedure.
User response: Verify that the dscenu.txt file is in the
directory pointed to by DSMI_DIR. For AIX, verify that
the dsmclientV3.cat file has a symbolic link to
/usr/lib/nls/msg/<locale>/dsmclientV3.cat .
ANS0316E

Unable to use message text file.

User response: There is a problem with the calling

application. Verify the values of the tsmBuffHandle and
dataptr passed to the API.

Explanation: The system is unable to use the message

text file (dscenu.txt or dsmclientV3.cat for AIX) because
of an invalid header. On the AS/400 platform this file
is QANSAPI/QAANSENU(TXT).

ANS0312E

System action: The system returns to the calling

procedure.

The number of bytes copied into the

tsmBuffer is larger than the allowed
value.

Explanation: An invalid number of bytes was copied

to a tsmBuffer.
System action: The system returns to the calling
procedure.
User response: There is a problem with the calling
application. Verify the number of bytes copied into the
tsmBuffer.
ANS0313E

dsmTerminate cannot finish because the

application is holding on to 1 or more
tsmBuffers.

Explanation: An application is trying to terminate a

session, but is still holding some tsmBuffers.
System action: The system returns to the calling
procedure.
User response: The application must return all buffers
for this session by calling tsmReleaseBuffer, and then
issue dsmTerminate.

User response: Install the message text file again.

ANS0317E

Explanation: The system is unable to use the message

txt file (dscenu.txt or dsmclientV3.cat for AIX) because
of an invalid control record. On the AS/400 platform
this file is QANSAPI/QAANSENU(TXT).
System action: The system returns to the calling
procedure.
User response: Install the message text file again.
ANS0318E

An internal error occurred in the

tsmBuffer array.

Explanation: An internal API buffer array error

occurred.
System action: The system returns to the calling
procedure.

Invalid value for DATEFORMAT

specified.

Explanation: An invalid value is specified for

DATEFORMAT.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.
ANS0319E

ANS0314E

Unable to use message text file.

Invalid value for TIMEFORMAT

specified.

Explanation: An invalid value is specified for

TIMEFORMAT.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.

User response: Try the operation again. If the problem

Chapter 2. ANS 0001-9999: Client messages, version 6.3

21

ANS0320E

Invalid value for NUMBERFORMAT

specified.

Explanation: An invalid value is specified for

NUMBERFORMAT.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.
ANS0321E

msg parameter for dsmRCMsg is a

NULL pointer.

Explanation: The message parameter for dsmRCMsg

is a NULL pointer.
System action: The system returns to the calling
procedure.

ANS0326E

This node has exceeded its maximum

number of mount points.

Explanation: Either no tape or sequential disk mount

points are permitted for this operation, or the
maximum number of mount points allowed are already
in use. The operation can not be completed. The TSM
administrator defines the maximum number of mount
points with the MAXNUMMP property of your node
definition.
System action: The object is skipped
User response: If you are performing any other TSM
operations that might be using mount points, wait until
those operations are complete, then try the failed
operation again. Otherwise contact your TSM
administrator for further assistance

User response: Allocate enough space for the message

parameter.

ANS0327E

ANS0322E

Explanation: A duplicate object was found, operation

cannot complete.

no text available for this return code.

Explanation: The dsmRC parameter for dsmRCMsg is

an unsupported return code.
System action: The system returns to the calling
procedure.

A duplicate object was found, operation

cannot complete.

System action: The requested operation failed.

User response: Try the operation with a different file
specification.

User response: Specify a valid value.

ANS0328E

ANS0323E

Explanation: The specified objects failed the merge

test, operation cannot complete.

partialObjOffset value for partial object

retrieve is invalid.

Explanation: The partialObjOffset value for partial

object retrieve is invalid.
System action: The system returns to the calling
procedure.

The specified objects failed the merge

test.

System action: The requested operation failed.

User response: See documentation for the merge test
parameters.

User response: Specify a valid value.

ANS0330E

ANS0324E

Explanation: The dsmSetAccess accessType is invalid.

partialObjLength value for partial object

retrieve is invalid.

Explanation: partialObjLength value for partial object

retrieve is invalid.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.
ANS0325E

Partial Object Retrieve is not supported

on this server.

Explanation: The TSM server specified by the user

does not support partial object retrieve.
System action: The system returns to the calling
procedure.
User response: Specify a TSM server which supports
the partial object retrieve function.

22

The dsmSetAccess access Type is

invalid.

System action: The system returns to the calling

procedure.
User response: The accessType must be one of the
following:
atBackup
atArchive
ANS0331E

No files have been previously backed

up for this filename/filespace.

Explanation: You tried to set access to files when no

files for the specified filename, drive or file system
were previously backed up.
System action: Processing stopped.
User response: Ensure that the correct drive or file

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

system was specified and that files are backed up for

you to set access.

User response: Contact your system administrator for

more information.

ANS0332E

ANS0338E

No files have been previously archived

for this filename/filespace.

Explanation: You tried to set access to files when no

files for the specified filename, drive or file system
were previously archived.
System action: Processing stopped.
User response: Ensure that the correct drive or file
system was specified and that files are archived for you
to set access.
ANS0333E

Unknown Remote Mover type

Explanation: The specified Remote Mover type is

unknown.
System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS0334E

An Operation for the requested node

and filespace is already in progress.

Explanation: A request has been made to use a data

mover to perform an operation for the indicated node
and filespace. Since an operation for this node and
filespace is already in progress, the new operation
cannot be performed.

Explanation: The operation is not valid.

System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS0339E

The specified target storage pool is not

defined.

Explanation: The storage pool is not defined.

System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS0340E

A target storage pool does not have the

correct data format for the given node
type.

Explanation: none
System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS0341E

System action: TSM ended the current operation.

User response: Retry the operation at a later time.

An invalid operation was attempted on

a node

No associated data mover is defined for

the given node.

Explanation: none
System action: TSM ended the current operation.

ANS0335E

System resource in use

Explanation: A required resource is in use by another

command or process.
System action: TSM ended the current operation.
User response: Retry the operation at a later time.
ANS0336E

Server plugin communication error

Explanation: Communication between a server plugin

module and a NAS filer failed.
System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS0337E

Server plugin detected unsupported

NAS filer operating system.

User response: Contact your system administrator for

more information.
ANS0342E

The CRC received from the Server does

not match the CRC calculated by the
client.

Explanation: The server sent a CRC for a buffer. The

client calculated a CRC for the same buffer. These did
not match. The mismatch indicates a communication
failure.
System action: In some cases, the client can indicate
the failure to the server and retry the operation.
User response: Check the trace log for additional
information and retry the operation. If the problem
persists, contact your system administrator.

Explanation: A plugin module detected that a NAS

filer is running an unsupported operating system or
operating system level.
System action: TSM ended the current operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

23

ANS0343E

An invalid operation was attempted on

a group leader or group member.

Explanation: An invalid operation was attempted on a

logical group.
System action: The current operation stops.
User response: Retry a valid operation.

ANS0349E

Transaction failed because of a problem

during a store operation.

Explanation: Transaction failed because of a problem

during a store operation. This error is typical when the
next storage pool has a different copy storage pool list
and we switch to this pool in the middle of a
transaction.
System action: Transaction is aborted.

ANS0344E

Cannot Send data with a zero byte

sizeEstimate.

Explanation: You cannot send data for an object with

size estimate = 0.

User response: Resend objects in separate transactions.

ANS0350E

System action: The system returns to the calling

procedure.
User response: Set size estimate greater than 0 in
dsmSendObj.

The current client configuration does

not comply with the value of the
DATAWRITEPATH or
DATAREADPATH server option for this
node.

System action: The current operation stops.

Explanation: The values of the DATAWRITEPATH

and DATAREADPATH server options specify where the
client is allowed to send data, and where data is read
from. The values for the specified node name should
correspond with the client configuration. For example,
you will get this error message if DATAWRITEPATH
contains a LAN value and the client is configured to
use LAN-free protocol, or vice versa.

User response: Define the proper remote disk.

System action: Processing stopped.

ANS0345E

Remote disk not defined.

Explanation: An operation was attempted on a remote

disk that is not defined.

ANS0346E

Input destination does not match

expected destination.

Explanation: Input destination does not match

expected destination.
System action: The current operation stops.
User response: Retry operation with proper
destination.
ANS0347E

Data mover is not available.

Explanation: Data mover is not available.

System action: The current operation stops.

User response: Check the client, server, and storage

agent logs to determine why the client was not able to
send data LAN-free. Make sure the client configuration
and server options are compatible.
ANS0351E

The node or user does not have proper

authority to perform this operation

Explanation: The node or user does not have proper

authority to perform this operation.
System action: The transaction is ended.
User response: Check the authority for the specified
object.

User response: Retry operation with a proper Data

mover.

ANS0352E

ANS0348E

Explanation: The node or user is trying to perform an

operation that either exceeds license values, or is not
licensed.

Operation failed because the copy

continue option was set to NO.

The operation is not permitted due to

server licenses values.

Explanation: Operation failed because the copy

continue option was set to NO.

System action: The session is rejected or the

transaction is cancelled, ending the current operation.

System action: The current operation stops.

User response: See your system administrator.

User response: This abort code indicates that a store

operation, like backup or archive failed because the
copy continue option was set to NO. The sysadmin will
need to resolve the problem on the server end.

ANS0353E

When using useTsmBuffers, dataBlk

must be NULL in calls to dsmSendObj
and dsmGetObj.

Explanation: The value for dataBlk must be NULL

when using useTsmBuffers.

24

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: The system returns to the calling

procedure.

the password file, or no key was provided by the

application.

User response: There is a problem with the calling

application. Contact your application provider

System action: The system returns to the calling

procedure.

ANS0354E

User response: If you are using -encryptkey=prompt,

make sure there is a value in encryptionPasswordP and
that bEncryptKeyEnabled is set to true.

Encryption is not allowed when using

useTsmBuffers.

Explanation: useTsmBuffers does not support

encryption.
System action: The system returns to the calling
procedure.
User response: Try the operation again, without using
useTsmBuffers, or disable encryption for this operation.
ANS0355E

This object cannot be restored/retrieved

using useTsmBuffers, because it is
compressed.

Explanation: useTsmBuffers does not support

compression.
System action: The system returns to the calling
procedure.

ANS0359E

Explanation: When using the ENABLEENCRYPTKEY

option, the parameter bEncryptKeyEnabled for the TSM
API dsmInitExIn_t and tsmInitExIn_t structures cannot
be set to bTrue.
System action: The system returns to the calling
procedure.
User response: Either remove the
ENABLEENCRYPTKEY option from the options file, or
set the parameter bEncryptKeyEnabled to bFalse in the
program using the TSM API.
ANS0360E

User response: Try the operation again, without using

useTsmBuffers.
ANS0356E

This object cannot be restored/retrieved

using useTsmBuffers, because it is
encrypted.

Explanation: useTsmBuffers does not support

encryption.
System action: The system returns to the calling
procedure.
User response: Try the operation again, without using
useTsmBuffers.
When using useTsmBuffers, a
restore/retrieve with partial object
restore is not allowed.

Explanation: useTsmBuffers does not support partial

object restore.
System action: The system returns to the calling
procedure.
User response: Make sure the calling application is
either using Partial object restore or useTsmBuffers.
ANS0358E

No encryption key was found. If you

are using -encryptkey=prompt make
sure there is a value in the
encryptionPasswordP field and that
bEncryptKeyEnabled is set to true.

The CAD cannot start because the value

of the MANAGEDSERVICES option is
NONE.

Explanation: The CAD will not start if

MANAGEDSERVICES NONE is set in the option file.
The CAD is designed to manage the web client or TSM
schedules. By specifying NONE, the CAD will not
manage any services.
System action: The CAD will stop processing.
User response: Specify either WEBCLIENT or
SCHEDULER for the MANAGEDSERVICES option in
the option file then restart the CAD.
ANS0361I

ANS0357E

Conflicting encryption key options have

been specified.

DIAG:

Explanation: The message text is provided for

diagnostic purposes and is meant to provide
information to IBM support in problem determination.
System action: None.
User response: None.
ANS0400E

License file could not be opened.

Explanation: The license file was not found, or could

not be opened because of permissions or the file is
corrupted.
System action: The system returns to the calling
procedure.
User response: Check permissions on file. See if the
license file is in the correct place.

Explanation: There was no encryption key found in

Chapter 2. ANS 0001-9999: Client messages, version 6.3

25

ANS0401E

Read failure on the license file.

Explanation: The license file was not found, or could

not be opened because of permissions, or the file is
corrupted.

ANS0411E

Oracle passed null file name

Explanation: Null filename passed by Oracle.

System action: The system returns to the calling
procedure.

System action: The system returns to the calling

procedure.

User response: Contact your system administrator.

User response: Check permissions on file. See if the

license file is in the correct place.

ANS0412E

Wrong data block size

Explanation: Wrong Block Size

ANS0402E

Write failure on the license file.

Explanation: The license file was not found, or could

not be opened because of permissions or the file is
corrupted.
System action: The system returns to the calling
procedure.
User response: Check permissions on file. See if
license file is in the correct place.
ANS0403E

Data in the license file is not in a valid

format.

Explanation: The license file is not valid.

System action: The system returns to the calling
procedure.
User response: User needs to obtain a new license.
ANS0404E

The checksum in the license file does

not match the licenseregistration string.

Explanation: The registration string is not valid.

System action: The system returns to the calling

procedure.
User response: Contact your system administrator.
ANS0413E

Object exists

Explanation: Backup or Restore Object already exists.

System action: The system returns to the calling
procedure.
User response: If backing up an object, be sure to
generate a unique object name.
ANS0414E

Not same Oracle handle

Explanation: The handle passed from Oracle is not the

same handle that TSM passed back.
System action: The system returns to the calling
procedure.
User response: Contact your system administrator.
ANS0415E

End of file reached

System action: The system returns to the calling

procedure.

Explanation: End of file reached.

User response: User needs to obtain a new license.

System action: The system returns to the calling

procedure.

ANS0405E

User response: None

This is an expired try and buy license.

Explanation: The registration string is not valid.

ANS0416E

Wrong Read State

System action: The system returns to the calling

procedure.

Explanation: The operation must be in READ state.

User response: User needs to obtain a new license.

System action: The system returns to the calling

procedure.

ANS0410E

User response: Contact your service representative.

Oracle passed invalid mode

Explanation: Invalid mode passed by Oracle.

System action: The system returns to the calling
procedure.
User response: Contact your system administrator.

ANS0417E

Runtime API version is outdated

Explanation: Runtime API is lower than compile time

API.
System action: The system returns to the calling
procedure.
User response: Use the WHAT command to find out
the compile time API level. Obtain the same or higher
level of API library.

26

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS0418E

Wrong write state

ANS0990W

Explanation: The operation must be in WRITE state.

System action: The system returns to the calling
procedure.

Options file 'file-name' could not be

found. Default option values will be
used.

Explanation: Common reasons for this warning

include:

User response: Contact your service representative.

v The default options file does not exist, and

ANS0419E

v You did not specify the -OPTFILE option when

starting the TSM client, and

Invalid flag passed

Explanation: Invalid flag passed from Oracle.

v the environment variable DSM_CONFIG was not set.

System action: The system returns to the calling

procedure.

System action: TSM client assumes default values for

all client options and continues processing, using the
default server name and associated options found in
the dsm.sys file.

User response: Contact your system administrator.

ANS0420W

Warning! Restoring inactive system state

objects is not recommended. Do you
wish to continue?

Explanation: Restoring inactive system state objects

may cause system instability. Examples of possible
problems include:
v Applications that were installed after the time the
system state was backed up cannot function properly
after restoring the inactive system state
v Critical operating system updates installed after the
inactive system state backup was made can no
longer be available, or may not function correctly.
Restoring inactive system state objects is not
recommended unless you are certain that this is what
you need to do.
System action: If user responds with yes, the client
will restore the object. If user responds with no, the
client will cancel the operation.
User response: Reply to the prompt. If you are
unsure, reply no, and consult your system
administrator or operating system vendor before
proceeding further.
ANS0422W

The selected journal location is a

network drive and might not be
accessible from the journal service.
Select a location on a local drive.

Explanation: It is not recommended to use a network

device as the location where journal databases are
stored. Placing journal databases on a network device
can prevent the journal service from running.
System action: Processing continues.
User response: Choose a local drive where journal
databases will be stored.

User response: If the default system action is

acceptable, you can eliminate this message by creating
an empty dsm.opt file in the installation directory.
If you have a client user options file (dsm.opt), either
place it in the installation directory or set the
DSM_CONFIG environment variable to the
fully-qualified path and file name of your options file.
Review the information on configuring TSM in the
TSM client manual specific to your operating system. If
the problem persists, ask your TSM administrator for
further assistance.
ANS0991I

TSM scheduler is listening for server

requests on port port number

Explanation: This message indicates the port number

on which the clients is listens for server requests. If the
port number in the message differs from the default
value or what you specified with the TCPCLIENTPORT
option, it is because the port was in use by a different
process.
System action: Processing continues.
User response: Normally no further action is required.
If you require TSM to use a specific port number, you
need to configure your system or applications so the
number is avaible. Restart the TSM client and confirm
it uses the desired port.
ANS0992E

The destination filespace or drive letter

is unavailable. For more details please
see dsmerror.log.

Explanation: The system is trying to restore or retrieve

to a destination that cannot be reached. The specified
filespace name or drive letter is not valid, or does not
exist, or you are specifying a local share name that
cannot be resolved.
System action: Objects which are part of this filespace
are not processed.
User response: Try the command again, and specify a
different destination for the object that was not
processed.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

27

ANS0993E

The source specification "source" has

invalid format.

Explanation: The file system must be enclosed in

curly braces and wildcards cannot be used except at
the lower level.
System action: The command processing is
terminated.
User response: Correct the specification and try the
command again.

ANS1003E

Explanation: An attempt to start backup for remote

node failed.
System action: Backup fails.
User response: Retry the operation. If the problem
persists, contact the server administrator.
ANS1004W

ANS0994E

Invalid string 'string' for virtual file

space name or group name specification.

Explanation: You entered a virtual file space name or

a group name specification that contains wildcard
characters.
System action: Processing stopped.
User response: Enter a correct virtual file space name
and a group name and try again. Use the pick option
to display a list of groups from which you can select
one group.
ANS1000E

An unsupported communications
method was specified.

Explanation: None.
System action: processing stops.
User response: Specify a communications interface
that is supported by the TSM client on your operating
system. See the TSM client manual for your operating
system for further information on configuring TSM
client communications.
ANS1001E

Volume being backed up was not a

system volume. Skipped.

Explanation: User specified to back up system volume

only. This volume was not backed up since this volume
is not a system volume.

Backup failed to start for node =

node-name, file system = fs-name, errno =
error-code, reason : error-reason

Node has exceeded max tape mounts

allowed. Operation for 'filespace-name'
will be tried again later.

Explanation: Node has exceeded max tape mounts

allowed. The operation will be tried again later.
System action: The operation will be retried.
User response: Increase the number of allowed tape
mounts for this node on the server to avoid this
situation again.
ANS1005I

TCP/IP read error on socket = socket-id,

errno = error-code, reason : 'error-reason'.

Explanation: An attempt to receive data using TCP/IP

connection failed. If reason : 'Connection reset by peer',
it is possible that the server control connection timed
out. This can occur if the file transfer time is greater
than the IDLETIMEOUT value set on the server.
System action: TCP/IP connection to server fails.
User response: If the timeout was due to a large file
transfer time, you can ignore this message. The client
will reconnect with the server automatically, finish
transferring the data, and send statistics. You can also
consider increasing the IDLETIMEOUT value in the
server options file.
ANS1006I

TCP/IP write error on socket = socket-id,

errno = error-code, reason : error-reason

System action: Volume was not backed up.

Explanation: An attempt to send data using TCP/IP

connection failed.

User response: Use All option or use image backup

command to backup this volume.

System action: Connection to server fails.

ANS1002I

MOS image is being created. It may

take a while.

Explanation: Mini Operating System image is being

created. It may take a while to create it.
System action: TSM is gathering necessary
information.
User response: None.

28

User response: Retry the operation. If the problem

persists, contact your system administrator.
ANS1007E

Sending of object 'object-nameobjectnameobject-name' failed. There is no

backup copy group.

Explanation: The management class for this file

(object-name) does not have a backup copy group. Either
the default management class does not have a backup
copy group, or an INCLUDE statement is attempting to
bind the file to a management class that does not have
a backup copy group.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: TSM did not back up the file.

User response: Run DSMC QUERY MGMTCLASS
-DETAIL to view information about available
management classes.
v If the file is being bound to the default management
class, make sure the management class has a backup
copy group.
v If the file is being bound to a management class
specified in an INCLUDE statement, make sure that
the management class has a backup copy group.
v If you have more than one TSM server, make sure
you are connecting to the correct server.
v If you are unable to find a suitable management
class, contact your TSM administrator for further
assistance.
ANS1008E

Sending of object 'object-nameobjectnameobject-name' failed: No Archive Copy

Group

Explanation: The management class for this file

(object-name) did not have an archive copy group
specified.

ANS1010E

Error processing 'filespace-name':

Unsupported file system operation.

Explanation: The file system does not support an

operation required to process the file or directory.
System action: The file or directory is skipped.
Depending on the specific error encountered,
processing on Solaris clients might stop.
User response: Verify that the file system is supported
by the TSM client. If a restore or retrieve failed, retry
the operation to another location. If the problem
persists, look for other indications of system problems.
It may be necessary to run the operating system utility
that checks and repairs file system inconsistencies. If
the problem still cannot be resolved, contact your TSM
administrator for further assistance.
ANS1015E

The session is rejected. The server does

not allow a signon of a client that is not
archive-retention protection enabled.

System action: TSM did not back up the file.

Explanation: The client cannot establish a connection

to the server because the server is enabled for
archive-retention protection enabled and the client is
not.

User response: See your system administrator.

System action: The session is not started.

User response: See your system administrator.

ANS1009W

An error occurred processing the

operating system include/exclude
statements. The error was detected
while processing: subsystemname.

Explanation: The client encountered an error while

obtaining the automatic include/exclude statements
from the operating system. Possible reasons for this
error include:
v The specified registry key cannot be opened for
reading
v The entry under this key has incorrect data
System action: Processing continues without the full
list of operating system include/exclude statements.
User response: Ensure that you have access to the
specified registry key and that entries are a MULTISZ
values that contain:
v Individual files
v Directories
v Wild card entries
v Environment variables
v /s switch (the /s switch is used on directory and/or
wild card entries and signifies that all subdirectories
of this directory should be excluded)
If the cause of this message can not be determined or
resolved, contact IBM technical support for further
assistance.

ANS1016I

No eligible files were found.

Explanation: The backup or archive operation

completed, but no files were processed. Possible
reasons for this include:
The directory that was backed up or archived
contains no files
The files are excluded from backup or archive
System action: None
User response: Check the path you entered.
ANS1017E

Session rejected: TCP/IP connection

failure

Explanation: An attempt to connect to the server

using TCP/IP communications failed. This can be a
result of incorrect TCP/IP option settings in your client
options file. This error can also occur if the LAN
connection went down or if your system administrator
canceled a backup operation.
System action: Session rejected. Processing stopped.
User response: Retry the operation, or wait until the
server comes back up and retry the operation. If the
problem continues, see your system administrator for
further help.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

29

ANS1018E

Port port number is already in use

ANS1023E

Session rejected: Node type mismatch

Explanation: The port specified by the

TCPCLIENTPORT option is in use by a different
process.

Explanation: Your node name is associated with a

different type of operating system (such as OS/2 or
AIX) and cannot be used on this system.

System action: Processing stopped.

System action: TSM canceled the current operation.

User response: Contact the server administrator to set

up a different port for server-initiated connections.
Update the TCPCLIENTPORT with this new port
number.

User response: If you need a new node name, see

your system administrator to assign a new one to you.
Generally, you have a unique node name for each
machine and operating system pair that requires access
to the server.

ANS1019E

The volume could not be opened.

Explanation: An error occurred when TSM tried to

open the volume for a backup or restore operation.

ANS1024E

System action: The requested operation does not run.

User response: Examine the client error log for
additional messages related to this error. Verify that the
volume is available, and is not locked by another
process. Try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS1020E

System object backup failed.

Explanation: An error occurred while backing up

Windows system object files. The backup did not
complete.
System action: Processing stopped.
User response: Ask your system administrator to
check the error log. Restart the Windows service
associated with the system object indicated in the error
log, and retry the backup operation
ANS1021E

Explanation: TSM failed to update attributes for the

named backup object on the server. The server may not
reflect correct state of the backup.
System action: Processing continues.
User response: Check preceding error messages in
error log for more information. Retry the operation. If
problem continues, contact your TSM administrator.
ANS1025E

Session rejected: Authentication failure

Explanation: Authentication failure. You entered an

incorrect password.
System action: TSM canceled the current operation.
User response: Enter your correct password. If you
cannot remember the correct password, see your
system administrator to have a new one assigned for
your node name.

System object restore failed.

Explanation: An error occurred while restoring

Windows system object files. The restore did not
complete.
System action: Processing stopped.
User response: Ask your system administrator to
check the error log. Restart the machine, and then
restore the system object indicated in the error log
again.
ANS1022E

Failed to update backup attributes on

server for 'backup type' backup for
'filespace namepath-namefile-name', object id
'object-id:object-id' return code 'return code'.

Cancel failed for node: node-name

filesystem: fs-name operation: op-type
error: error

ANS1026E

The session is rejected: There was a

communications protocol error.

Explanation: An unexpected network message was

received by the client. This could be caused by network
problems or a programming error.
System action: TSM canceled the current operation.
User response: Verify that your communication path
is functioning properly and try the operation again. If
the problem persists, contact your TSM administrator
for further assistance.
ANS1028S

An internal program error occurred.

Explanation: The request to cancel a remote operation

has failed. The node, filespace, operation and reason for
the failure are shown.

Explanation: TSM encountered an unexpected

condition and can not continue the operation. This
might be a programming error.

System action: TSM operation not cancelled.

System action: processing stops.

User response: Contact your system administrator for

more information.

User response: Try the operation again. If the problem

persists, contact your TSM administrator or IBM

30

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

technical support for further assistance.

ANS1029E

Communication with the TSM server is

lost.

Explanation: This message is issued after the session

with the TSM server is unexpectedly lost. The client
error log might contain additional information
regarding this problem.

failed to respond within the the allotted wait time. In

the case of the B/A client, this message is preceded in
dsmerror.log by message ANS5216E that gives details
of the connection that failed. The condition may be
temporary.
System action: processing stops.
User response:
v Restart the TSM client and retry the operation.

v Restart the TSM client and retry the operation.

v Check the client options file and verify that

TCPSERVERADDRESS and TCPPORT specify the
correct TCP/IP address and port number for your
TSM server.

v If the problem persists, review the client error log for

other messages that might be related to this problem.

v Verify that network connectivity exists between the

TSM client machine and the TSM server machine.

v Verify that network connectivity exists between the

TSM client machine and the TSM server machine.

v If the problem persists, see your TSM administrator

for further assistance.

v Contact your TSM administrator for further

assistance. The TSM administrator can review the
TSM server activity log for additional information
about the problem.

ANS1032E

System action: processing stops.

User response:

ANS1030E

The operating system refused a TSM

request for memory allocation.

Explanation: TSM requires access to memory in order

to store information as processing proceeds. In this
case, more memory was requested than the operating
system would allocate. Possible reasons include:
The system is low on memory.
The process in which the program runs has
exceeded the maximum memory that it is allowed
to allocate.
Some other error condition occurred that caused the
program to think it is out of memory.
System action: TSM cannot complete the requested
operation.
User response: Close all unneeded applications and
try the operation again. If the operation still fails, try
dividing the task into several smaller units. For
example, if a file specification contains several high
level directories, run the TSM task serially for each
directory. If the TSM task is an incremental backup, use
the option "-memoryefficientbackup=yes".
For UNIX systems that support resource limits, check
to see b if the memory resource limit is too low by
entering the following command: ulimit -a
Based on the resulting data, you can ask the UNIX
system root user to increase resource limits so that it
will override the current default. The UNIX system root
user has the authority to increase resource limits.
ANS1031E

The attempt to establish a TCP/IP

connection timed out before the
connection was made.

An attempt to establish a TCP/IP

connection was rejected by the host

Explanation: An attempt to establish a TCP/IP

connection was rejected by the server.
System action: Processing stopped.
User response: The server was not fully initialized, is
not currently running, was not enabled for TCP/IP
communications, or an incorrect TCP/IP port number
was specified. If the problem continues, see your
system administrator.
ANS1033E

An invalid TCP/IP address was

specified.

Explanation: The TCP/IP address specified by the

TSM client's TCPSERVERADDRESS setting could not
be found on the network. Common reasons for this
error include:
v The TCPSERVERADDRESS client option specifies the
wrong TCP/IP address for the TSM server".
v The machine that hosts the TSM server is not on the
network.
v A network problem is preventing the TSM client
from reaching the machine that hosts the TSM server.
System action: processing stops.
User response: Verify that the TCPSERVERADDRESS
and TCPPORT settings have the correct values for your
TSM server. Use your operating system's "ping" (or
similar) utility to ensure that your machine can locate
the machine that hosts the TSM server across the
network. Try the operating again. If the problem
persists, ask your TSM administrator for further
assistance.

Explanation: The Object of the connection attempt

Chapter 2. ANS 0001-9999: Client messages, version 6.3

31

ANS1034E

The specified TCP/IP host name is

unreachable

Explanation: The TCP/IP host name specified in the

TCPSERVERADDRESS statement cannot be reached.
System action: Processing stopped.
User response: Check your options file for the correct
TCPSERVERADDRESS statement. See your
administrator for the correct name of the server.
ANS1035S

Options file 'file-name' could not be

found, or it cannot be read.

Explanation: Common reasons for this error include:

v The default options file does not exist.
v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file you provided does not exist.
v The DSM_CONFIG (or DSMI_CONFIG if you are
using the IBM Tivoli Storage Manager API)
environment variable specifies an options file that
does not exist.
v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file that you provided is not in the standard file
encoding of the system. For example, on Windows
the expected file encoding is ANSI.
v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file that you provided does not have appropriate
read permissions for the user that is running the
operation.
System action: IBM Tivoli Storage Manager client
processing stops.
User response: Make sure that the options file you
want to use exists, it has the read rights set for the user
that is running the operation, and it is in the standard
file encoding of the system. For example, on Windows
the expected file encoding is ANSI. Review the
configuration information in the IBM Tivoli Storage
Manager client manual specific to your operating
system. If the problem persists, ask your IBM Tivoli
Storage Manager administrator for further assistance.

ANS1037S

Invalid keyword specified

Explanation: TSM found an incorrect keyword in the

options file.
System action: Processing stopped.
User response: Correct the options file with valid
entries.
ANS1038S

Invalid option specified

Explanation: An incorrect option was specified to

TSM.
System action: Processing stopped.
User response: Correct the options used for running
TSM.
ANS1039S

The include or exclude pattern cannot

be parsed.

Explanation: The pattern is formatted incorrectly or is

too complex for TSM to interpret.
System action: Processing stopped.
User response: Verify that the include or exclude
pattern is specified correctly. If the pattern is correct,
then contact IBM technical support for further
assistance.
ANS1040S

Include/Exclude pattern is missing a

closing bracket

Explanation: The include or exclude pattern is

incorrectly constructed. The closing bracket is missing.
System action: Processing stopped.
User response: Correct the syntax for the pattern.
ANS1041S

Include/Exclude pattern must start with

a directory delimiter

Explanation: The include or exclude pattern must start

with a directory delimiter.
System action: Processing stopped.
User response: Correct the syntax for the pattern.

ANS1036S

The option 'option' or the value supplied

for it is not valid. It was found in
options file 'file-name' at line number:
number The complete entry: 'entry'

ANS1042S

A beginning or ending directory

delimiter is missing from the
Include/Exclude pattern.

Explanation: The specified option in the TSM options

file (file-name) is in error. Either the option itself or its
value are invalid.

Explanation:

System action: Processing stopped.

2. For Windows, the drive seperator is not

immediately followed by a directory delimiter.

User response: Correct the options file entry.

1. The include/exclude pattern has a '...' without a

beginning or ending directory delimiter.

System action: Processing stopped.

User response: Correct the syntax for the pattern.

32

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1043S

Quotes are not matched

Explanation: The quotes specified in the pattern are

not the same and do not make a set.
System action: Processing stopped.
User response: Correct the pattern by using matching
quotes in the syntax.
ANS1044S

Unresolved environment name

'environment-name'.This filespace is being
ignored. Processing Continues.

Explanation: The specified environment-name in the

options file is invalid.
System action: TSM attempts to continue the current
operation.
User response: Check the environment variable in the
options file and use a valid environment variable. Retry
the operation.
ANS1045S

Environment variable syntax error.

Explanation: Incorrect syntax is specified in the

options file. Make sure that the variable is enclosed in
curly braces.
System action: TSM attempts to continue the current
operation.
User response: Check the syntax of environment
variable in the options file. Correct it and retry the
operation.
ANS1046S

Environment string for variable

'environment-name' too long. Anything
beyond 1024 characters is being ignored

Explanation: Environment variable expanded to a

string which is too long. Make sure that the string is no
more than 1023 characters long.
System action: TSM attempts to continue the current
operation.
User response: Check the length of environment
string and break it up into smaller strings using
multiple environment variables.
ANS1047E

The destination file system is

unavailable. The following object was
skipped: File space:'filespace-name'
Pathname:' path-name' Filename:'file-name'

Explanation: The client is trying to restore or retrieve

the specified object to a destination that is not valid,
does not exist, or cannot be reached.

User response: Try the command again using a

different destination.
ANS1048E

Device 'volname' is not local

Explanation: The selected path is not a local device

and therefore is not a valid object for image operations.
System action: The requested logical volume
operation is not performed.
User response: Choose another object.
ANS1049E

'filename' is not a valid destination file

for image restore

Explanation: The filename you specified is not a valid

name for a file or it is a directory.
System action: Restore processing stopped.
User response: Specify a correct filename for image
restore.
ANS1050E

The volume volume-name could not be

locked.

Explanation: An error occurred when TSM tried to

open the volume for a backup or restore operation.
System action: The requested operation does not run.
User response: Examine the client error log for
additional messages related to this error. Verify that the
volume is available, and is not locked by another
process. Try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS1051I

Invalid password

Explanation: You entered an invalid password.

System action: TSM cannot connect to the server
without the correct password.
User response: Enter the password, or ask your
system administrator for the correct password.
ANS1052E

Direct connection to the Storage Agent

is not allowed.

Explanation: You cannot connect directly to the

Storage Agent.
System action: Processing stopped.
User response: To perform Lanfree operations using
the Storage Agent, specify the ENABLELANFREE
option in your options file, and restart the process.

System action: The object is not restored or retrieved.

Processing continues with the next object.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

33

ANS1053I

Existing file space filespace-name has

been renamed to filespace-name

Explanation: If the file space is for Windows system

state, this message is issued when the TSM
backup-archive client detects multiple system state file
spaces where the names differ only in case. The
existence of multiple system state file spaces can occur
if, at some earlier time, your TSM administrator
renamed the system state file space to the same name
but with a different case or the computer's name was
changed from all upper case characters to lower case or
mixed case characters. If the file space name represents
a drive volume label, then this file space was created
by an older TSM backup-archive client.
System action: If the file space is for Windows system
state, TSM will back up system state to the file space
containing the most recent backup. The older file space
is renamed as specified in this message. Subsequent
system state backups will continue to back up system
state to the same (most recently used) file space. If the
file space name represents a drive volume label, TSM
renames the file space to the corresponding UNC name
and continues to back up the drive to this renamed file
space.
User response: No further action is necessary.
However, if the file space is for Windows system state,
then at some future time when you have determined
you no longer need the older renamed system state file
space, you can ask your TSM administrator to delete
the older file space from TSM storage.
ANS1054E

Existing filespace filespace-name cannot

be renamed to new filespace
filespace-name. TSM return code = retcode.

System action: Processing continues.

User response: None.
ANS1056E

Share/network path share cannot be

resolved. Path does not exist.

Explanation: For backup: Trying to backup

share/network, which either does not exist or does not
have the correct privilege to access the share. For
restore : Trying to restore to a share/network path that
cannot be resolved. The directory path does not exist.
System action: Processing stopped.
User response: Retry the command and specify a
destination, or restore the directory tree first before
trying to restore the share point.
ANS1057I

File space filespace-name cannot be

renamed to new file space filespace-name,
because the new file space already
exists.

Explanation: The client was unable to migrate a file

space name from the volume label naming convention
to the UNC naming convention because the new file
space already exists on the TSM server.
System action: The operation proceeds using the new
file space. The old file space is ignored.
User response: No action is necessary, but if the data
in the old file space is no longer needed, it can be
deleted from the TSM server.
ANS1058E

The restore destination cannot be

reached.

Explanation: The client was unable to migrate a file

space name from the volume label naming convention
to the UNC naming convention.

Explanation: Either the destination file system is

invalid or it cannot be reached.

System action: Processing stopped.

User response: Try the command again using a

different destination.

User response: Check the client error log and the TSM
server activity log for any other messages that might
help identify the problem. If the problem cannot be
resolved, contact IBM technical support for additional
assistance.
ANS1055I

Trying to rename existing filespace

filespace-name to new filespace
filespace-name, but drive letters do not
match, old=drive-letter, new=drive-letter.
Ignore the old filespace and backup to
the new filespace.

Explanation: Trying to rename the existing filespace

name using the volume label to the UNC format
naming convention but the drive letters do not match.
Leave the existing filespace alone and create a new
filespace.

34

System action: Processing stopped.

ANS1059E

Two inactive objects with the same

image name were selected. Process
terminates

Explanation: You selected more than one inactive

version of the same image object (logical volume). The
system has no way to decide which you want to
restore.
System action: The requested logical volume restore is
not performed.
User response: Retry the operation, selecting an active
version or only one inactive version of the volume you
wish to restore.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1060E

The specified path is not a mounted

filesystem

Explanation: You entered a file system name that does

not correspond to a mounted file system for this
system. It is possible the file system name is
misspelled, or simply that the file system is not
currently mounted.
System action: The requested logical volume
operation is not performed.
User response: Retry the operation, using name of a
mounted file system.
ANS1061E

The specified device corresponds to a

mounted file system; you must specify
the file system by name.

Explanation: You entered a logical device name that is

mapped to a mounted file system. This volume must
only be referenced by its file system name.
System action: The requested logical volume
operation is not performed.

additional messages that may have been issued before

or after this message. Correct any problems, if possible.
If the cause of this message can not be determined or
resolved, contact IBM technical support for further
assistance.
ANS1065E

Library version of the image utility does

not match that of the TSM API

Explanation: The current system has a mix of installed

components.
System action: The requested logical volume
operation is not performed.
User response: Re-install all TSM components
ANS1066E

The restore operation completed

successfully, but the file system could
not be remounted.

Explanation: None.
System action: The file system is left unmounted.

User response: Try the operation again, using the file

system name instead of the device name.

User response: Use the mount command to mount the

file system. On AIX, run fsck if requested by the
operating system.

ANS1062E

ANS1067E

Only a single image may be selected

when a destination is entered.

A call to a system function returned an

unexpected error.

Explanation: You selected more than one image object

(logical volume) to be restored. You also specified a
destination. The system cannot place more than one
image into a single destination volume. When more
than one object is selected, each must be restored to its
original location.

Explanation: If you are performing a JFS2 snapshot

based operation, it is possible that the snapshot was not
large enough to contain all the changes made to the
filesystem after the snapshot was created. This could
cause the snapshot to become invalid thereby
preventing TSM client from reading the snapshot.

System action: The requested logical volume restore is

not performed.

System action: The requested operation does not run.

User response: Retry the operation, selecting one

object to be restored to the given destination, or retry
the operation without entering the destination.
ANS1063E

The specified path is not a valid file

system or logical volume name.

Explanation: None.
System action: The logical volume operation is not
performed.
User response: Try the operation again using a valid
path.
ANS1064E

An unexpected error occurred while

processing the image operation.

Explanation: None.

User response: Examine the client error log for

additional messages related to this error. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
If you are performing a JFS2 snapshot based operation,
please use the default snapshotcachesize of 100% and
ensure that the volume group has sufficient disk space
to allocate snapshots at least as large as the file system
and retry the operation.
ANS1068E

Device is not local

Explanation: The selected path is not a local device

and therefore is not a valid object for image operations
System action: The requested logical volume
operation is not performed.
User response: Choose another object.

System action: The requested operation does not run.

User response: Examine the client error log for any
Chapter 2. ANS 0001-9999: Client messages, version 6.3

35

ANS1069E

An error occurred while reading data

from the device

Explanation: An error occurred while reading data

from the device. Windows Only: This could be due to
bad sectors on the drive.
System action: The requested logical volume
operation is not performed.
User response: Retry the operation, then check the
error log for more information. Windows Only: Please
run chkdsk /r and retry the operation. If the problem
persists, a possible workaround is to back up the entire
drive using a regular (non-image) backup. Please
ensure that all your data is backed up. Then format the
drive using a full format (without the /q quick format
option). Then restore the data and retry the image
backup operation.

space from the server while the current operation was

in progress.
System action: TSM processing stops.
User response: Try the operation again. If the problem
recurs, check the error log for any other messages that
might indicate a reason for the failure. Try to correct
any indicated problems, then try the operation again. If
the problem persists, contact IBM technical support for
further assistance.
ANS1074W

The operation was stopped by the user.

Explanation: The operation was stopped at the request

of the user. This usually occurs when the 'Q' key is
pressed two times.
System action: Processing stopped.
User response: None.

ANS1070E

Write error

Explanation: An error occurred while writing data to

the device.
System action: The requested logical volume
operation is not performed.
User response: Re-try the operation, check error log
for more information.
ANS1071E

Invalid domain name entered:

'domain-name'

Explanation: You entered an invalid domain

domain-name. Check whether the domain name is a file
system and the file system is mounted. A directory
cannot be specified in the domain option, unless it is a
virtual mount point.
System action: Processing continues if there are other
file systems in the domain option to back up.
User response: Enter a valid drive or file system name
(domain).
ANS1072E

Unable to continue operation; Drive

'drive-name' has no volume label.

Explanation: The specified drive-name in the domain

list does not have a volume label.
System action: Processing stopped.

ANS1075E

file name(line number)The operating

system refused a IBM Tivoli Storage
Manager request for memory allocation.

Explanation: IBM Tivoli Storage Manager requires

access to memory in order to store information as
processing proceeds. In this case, more memory was
requested than the operating system would allocate.
Possible reasons include:
The system is low on memory.
The process in which the program runs has
exceeded the maximum allocated memory.
Some other error condition occurred. No memory is
available.
System action: IBM Tivoli Storage Manager cannot
complete the requested operation.
User response: Close all unneeded applications and
try the operation again. If the operation still fails, try
dividing the task into several smaller units. For
example, if a file specification contains several
high-level directories, run the IBM Tivoli Storage
Manager task serially for each directory. If the IBM
Tivoli Storage Manager task is an incremental backup,
use the option "-memoryefficientbackup=yes".
For UNIX systems that support resource limits, you can
check if the memory resource limit is too low by
entering the following command: ulimit -a

User response: Use the system format utility to place

a unique volume label on all drives on which you
intend to run TSM.

Based on the resulting data, you can ask the UNIX

system root user to increase the resource limit above
the current default limit. The UNIX system root user
has the authority to increase resource limits.

ANS1073E

ANS1076E

The file space for domain 'domain-name'

could not be found on the TSM server.

Explanation: The specified file space was expected to

be found on the server, but it no longer exists. It is
possible that a command was issued to delete the file

36

The specified directory path could not

be found.

Explanation: An invalid or unreachable directory path

was specified.
System action: Processing stopped.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Try the operation again using a valid

directory path.
ANS1078S

Unknown system error error-code

occurred.

system was specified and that files are archived for you
to retrieve.
ANS1084E

Explanation: An error unknown to TSM error-code

occurred within the client program.
System action: The client stops.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Try to correct any indicated problems, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

Explanation: You cannot restore files. Either the file

space or drive is invalid, or no backup copies exist.
System action: Processing stops.
User response: Specify a valid drive or file space.
Verify that backup copies exist.
ANS1085E

ANS1079E

No files have previously been backed

up for 'filespace-name' or the specified file
space is invalid for the current operating
system.

No file specification entered

No memory available to store Archive

Management Class override name

Explanation: You did not enter a file specification as

prompted.

Explanation: Not enough memory was available for

the operation.

System action: TSM did not continue with the

requested operation.

System action: Processing stopped.

User response: Enter a file specification to continue.

User response: Retry the operation or restart the

system with fewer programs in memory.

ANS1081E

ANS1086E

Invalid search file specification 'string'

entered

File not found during Backup, Archive

or Migrate processing

Explanation: You entered a file specification or search

string that contains incorrect characters or contains
wildcard characters in the drive specification or file
system name.

Explanation: The file being processed for backup,

archive or migrate no longer exists on the client.
Another process deleted the file before it could be
backed up, archived or migrated by TSM.

System action: Processing stopped.

System action: File skipped.

User response: Enter a correct file specification as

described in the appropriate Using the Backup-Archive
Client book for the particular operating system.

User response: None.

ANS1082E

Invalid destination file specification

'file-name' entered

Explanation: You entered a destination file-name

specification that contains incorrect characters or has
wildcard characters in the specification.
System action: Processing stopped.
User response: Enter a correct file specification as
described in the appropriate Using the Backup-Archive
Client book for the particular operating system.

ANS1087E

Explanation: Access to the specified file or directory is

denied. You tried to read from or write to a file and
you do not have access permission for either the file or
the directory.
System action: Processing stopped.
User response: Ensure that you specified the correct
file or directory name, correct the permissions, or
specify a new location.
ANS1088E

ANS1083E

No files have previously been archived

for 'filespace-name'

Explanation: You tried to retrieve files when no files

for the specified drive or file system (filespace-name)
were previously archived.
System action: Processing stopped.

Access to the specified file or directory

is denied

File space 'filespace-name' does not exist

Explanation: The specified file space (domain) is

incorrect or does not exist on the machine.
System action: Processing stopped.
User response: Retry the operation specifying an
existing domain (drive letter or file system name).

User response: Ensure that the correct drive or file

Chapter 2. ANS 0001-9999: Client messages, version 6.3

37

ANS1089E

Destination directory path length

exceeds system maximum

Explanation: The path name specified plus the path

name in the restored file name combine to create a
name whose length exceeds the system maximum.

correct server, then try the command again without

specifying any point-in-time options.
ANS1094E

Server does not support Query Node

command.

System action: Processing stopped.

Explanation: The server to which you are connected

does not support Query Node command.

User response: Specify a destination path that, when

combined, is less than the system maximum.

System action: Processing stopped.

ANS1090E

The LVM1 device is no longer

supported by this client.

Explanation: The selected path refers to a volume

device managed by LVM version 1. LVM 1 is no longer
supported by this version of client and therefore is not
a valid object for image operations.
System action: The requested logical volume
operation is not performed.
User response: Use earlier versions of the client that
support LVM1 to perform the logical volume operation.
Alternatively, you can upgrade to LVM2 and migrate
the volume to LVM2. LVM2 is supported by this client
for logical volume operations.
ANS1091E

Communications error with server

during object query

Explanation: An unexpected communications error

occurred during an object query to the server.
System action: Processing stopped.
User response: Verify that communications are active
between the client and server machines. Server outages,
processor outages, and communication controller
outages can cause this error.
ANS1092W

No files matching search criteria were

found

Explanation: You entered a search pattern or file name

that cannot be found in the server database.

User response: Use a TSM Server that supports Query

Node command.
ANS1096S

Either the node does not exist on the

server or there is no active policy set for
the node.

Explanation: This error occurs when you try to access

another node's data. Either the node is not registered
with the TSM server, or there is no active policy set for
the node.
System action: Processing stops.
User response: Verify that the node whose data you
are trying to access is registered with the TSM server. If
you have more than one TSM server, make sure you
are connecting to the correct server, then try the
operation again. If the problem persists, contact your
TSM administrator for further assistance.
ANS1097E

The client help text cannot be read from

the help file.

Explanation: The help file was opened successfully

and its table of contents are available, but there is a
problem reading the text from the help file.
System action: Processing stopped.
User response: If the DSM_DIR environment variable
is set, verify that it points to the directory containing
the current level of TSM program files, then try the
operation again. If the problem recurs, re-install the
TSM client software. If the problem persists, IBM
technical support for further assistance.

System action: Processing stopped.

User response: Ensure that your search pattern is
correct, or specify a new search string.

ANS1098E

Process terminated; Program memory

exhausted.

Explanation: The program used all available storage.

ANS1093E

Your TSM server does not support

point-in-time processing.

Explanation: The client has requested a point-in-time

query or restore operation, but the TSM server to
which the client is connected does not support
point-in-time operations.

System action: Processing stopped.

User response: Free any unnecessary programs (TSRs)
that are running, and retry the operation. Reducing the
scope of queries and the amount of data returned can
also solve the problem.

System action: Processing stopped.

User response: Make sure that you are connected to
the correct TSM server. If you are connected to the

38

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1099E

File 'filename' not previously archived

Explanation: You tried to give access to a file, which

is not stored on the server.
System action: Processing stopped.
User response: Ensure that the correct filename is
specified.
ANS1100E

File 'filename' not previously backed up

Explanation: You tried to give access to a file, which

is not stored on the server.
System action: Processing stopped.

on the failing archive, incremental, or selective

command.
ANS1103E

Explanation: You entered an invalid management

class.
System action: TSM is unable to do the requested
operation.
User response: Retry the operation using a valid
management class.
ANS1104E

User response: Ensure that the correct filename is

specified.
ANS1101E

User is not authorized to encrypt

file-space namedirectory_pathfile_name.

Explanation: The user is not authorized to encrypt the

file. Normally, only a IBM Tivoli Storage Manager
authorized user or a root user can use IBM Tivoli
Storage Manager encryption. However, a certain
combination of PASSWORDACCESS and
ENCRYPTKEY options may allow encryption
operations by a non-authorized user.
System action: The file is not backed up or restored.
User response: Log in as a root or IBM Tivoli Storage
Manager authorized user and try the operation again.
See IBM Tivoli Storage Manager Backup-Archive Client
Installation and User's Guide for the correct usage of
the ENCRYPTKEY option.
ANS1102E

An excessive number of command line

arguments are passed to the program.

Explanation: This command processing routine

received more operands than it can use. The rules are:
v Query can contain only one file specification.
v Restore and Retrieve can contain two file
specifications.
v Archive, Incremental, and Selective can contain a
maximum of 20 file specifications. To bypass the
20-operand limit, use the -REMOVEOPERANDLIMIT
option on the failing archive, incremental, or
selective command.
Note: The TSM Client operates much more efficiently if
it expands wild cards internally, rather than accepting
the expanded list from the shell.
System action: Processing stopped.
User response: Reduce the number of arguments and
retry the operation. For UNIX-based systems, ensure
that you have surrounded the specification containing
pattern matching characters with quotes. As an
alternative, use the -REMOVEOPERANDLIMIT option

Invalid management class entered

The management class for this file does

not have a valid archive copy group.
This file will not be archived.

Explanation: The management class for this file does

not have an archive copy group specified. This file will
not be archived.
System action: Processing stopped.
User response: Add a valid archive copy group to the
management class, and then retry the operation.
ANS1105E

The management class for this file does

not have a valid backup copy group.
This file will not be backed up.

Explanation: The management class for this file does

not have a backup copy group specified. This file will
not be backed up.
System action: Processing stopped.
User response: Add a valid backup copy group to the
management class, and then retry the operation.
ANS1106E

ENCRYPTKEY SAVE not configured

correctly. Encryption not used.

Explanation: This message is issued for TSM

Authorized Users and root users when ENCRYPTKEY
SAVE and PASSWORDACCESS PROMPT options are
set. Please note that these are the default values. These
values do not allow encryption.
System action: The file is not encrypted.
User response: To save encryption keys, you must
change configuration values. Add PASSWORDACCESS
GENERATE to your system option file.
ANS1107E

Invalid option/value: 'option'

Explanation: You specified an incorrect TSM option or

option value option.
System action: For the command line client:
Processing stops.
For the native GUI client: There is a small set of
options critical to the initialization of the client. If an
Chapter 2. ANS 0001-9999: Client messages, version 6.3

39

error is found in one of these, this message is presented

and the client terminates without further processing.
User response: Specify a correct TSM option as
defined in the appropriate Using the Backup-Archive
Client book for the particular operating system.
ANS1108E

Invalid option (option) for the function

command

Explanation: There are two possible reasons for this

message:
v The option option was specified for a command or
subcommand (function) that cannot make use of that
option.
v The option appears on the initial command line and
is not valid there.
System action: Processing stopped.
User response: See the Backup-Archive Client
Installation and User's Guide for correct use of the
named option.
ANS1109E

User is not authorized to encrypt the

file.

Explanation: The user is not authorized to encrypt the

file. Normally, only a TSM authorized user or a root
user can use TSM encryption. However, a certain
combination of PASSWORDACCESS and
ENCRYPTKEY options may allow encryption
operations by a non-authorized user.
System action: The file is not backed up or restored.
User response: Log in as a root or TSM authorized
user and retry the operation. Refer to Backup-Archive
Client Installation and User's Guide for the correct usage
of the ENCRYPTKEY option.
ANS1110E

The client help file file-name could not

be opened.

Explanation: This usually occurs when the help file

file-name cannot be found.
System action: Processing stopped.
User response: If the DSM_DIR environment variable
is set, verify that it points to the directory containing
the current level of TSM program files, then try the
operation again. If the problem recurs, re-install the
TSM client software. If the problem persists, IBM
technical support for further assistance.
ANS1111E

The table of contents cannot be read

from the help file.

Explanation: The help file was opened successfully

but there was a problem reading the table of contents.

User response: If the DSM_DIR environment variable

is set, verify that it points to the directory containing
the current level of TSM program files, then try the
operation again. If the problem recurs, re-install the
TSM client software. If the problem persists, IBM
technical support for further assistance.
ANS1113E

The snapshot cache location is not valid.

Explanation: The snapshot cache location must point

to a local volume that is formatted with NTFS. The
default cache location is on the same volume where the
snapshot is being performed. The operation will
continue without snapshot support.
System action: The client does not execute the
snapshot backup operation.
User response: Specify a different snapshot cache
location using the SNAPSHOTCACHELOCATION
option.
ANS1114I

Waiting for mount of offline media.

Explanation: The server is waiting for the requested

media to become available before the operation can
continue.
System action: TSM waits for requested data.
User response: None.
ANS1115W

File 'file-namefile-namefile-name' excluded

by Include/Exclude list

Explanation: You can not back up, archive, or migrate

files that are excluded.
System action: TSM does not process the file.
User response: If the file is intentionally excluded,
then this message can be ignored. Otherwise modify
the include/exclude list, restart the client, and try the
operation again. Contact your TSM administrator for
further assistance.
ANS1116E

The process is running in a

non-interactive mode, but requires user
input.

Explanation: This process requires keyboard input,

but non-interactive processes are unable to read input
from keyboard.
System action: processing stops.
User response: Perform the following actions to
resolve this error:
v Run the product in interactive mode.
v Ensure your password is set correctly.

System action: Processing stopped.

40

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1117E

The PICK and LATEST options are not

valid together

Explanation: During a restore, PICK and LATEST

options cannot be used together.
System action: Processing stopped.
User response: Try again using either the PICK or the
LATEST option.
ANS1118I

System action: TSM waits for your specification.

User response: Enter a correct file space number.
Initiating the removal of 'filespace-name'
file space.

Explanation: Indicates that file space deletion has

started on the specified filespace-name.
System action: None.
User response: None.
ANS1120E

System action: None.

User response: None.
ANS1122W

Invalid file space number entered. Try

again.

Explanation: The number that represents a file space

was incorrect while you were using the PICK option.

ANS1119I

the deletion process, or the file space might contain

archive objects in deletion-hold status. In either case,
the file space will not be deleted.

Removal of file space 'filespace-name'

failed

File space 'filespace-name' does not exist

on the server. The file space might have
been deleted by another client using
your client's node name or an
administrator.

Explanation: The specified filespace-name does not exist

on the server. Your system administrator deleted the
file space or another client using your clients node
name might have deleted it.
System action: None.
User response: None.
ANS1123E

The vertical screen dimension is too

small to display the Help directory.
Increase your window height.

Explanation: Execution of the HELP command

requires space for both the user prompts and at least
one line of the HELP directory.
System action: The help directory is not displayed,
and the help command cannot complete.

Explanation: An attempt was made to delete a

filespace (either NAS or normal) and it was
unsuccessful.

User response: Increase the size of your display

window to allow more rows of text to be displayed.

v Your client registration may not be authorized to

delete filspaces on the server. Look for message
ANS1126E.

ANS1125E

v The named filespace does not exist on the server.

Look for message ANS1122W.
v Other causes which will be made known in messages
following this one

Unmatched Quotes: 'string'

Explanation: The quotes specified in the pattern are

not the same and do not make a set.
System action: Processing stopped.
User response: Correct the pattern using matching
quotes in the syntax.

System action: processing stops.

User response: Take action as recommended by other
messages that accompanies this one. If so indicated, try
to remove the file space again. If the problem
continues, your TSM administrator has the authority to
delete the file space for you.
ANS1121I

A request for removal of file space

'filespace-name' has been successfully sent
to the server.

Explanation: TSM has requested deletion of the

specified filespace-name. The deletion process may not
have actually been completed when this message is
displayed. To verify successful deletion, consult the
server logs.

ANS1126E

The file space cannot be deleted because

this node does not have permission to
delete archived or backed up data.

Explanation: You cannot delete the file space data

unless your TSM administrator has authorized your
node to do so. Authorization permits you to delete
backup data, archive data, or both.
System action: Delete processing fails.
User response: Use the DSMC QUERY SESSION
command to verify your authorization. Ask your TSM
administrator to provide the necessary authorization or
to delete the file space for you.

It is possible for errors to occur on the server during

Chapter 2. ANS 0001-9999: Client messages, version 6.3

41

ANS1127E

Your node does not have permission to

delete archived files.

Explanation: You cannot delete archived files unless

your TSM administrator has authorized your node to
do so.
System action: TSM does not delete the archived files.
User response: Use the DSMC QUERY SESSION
command to verify your authorization. Ask your TSM
administrator to provide the necessary authorization.
ANS1128S

The management class assigned to

directories does not exist.

Explanation: The management class named on the

DIRMC option does not exist in your assigned policy
set on the server. The error log contains an entry
showing the invalid management class name.
System action: processing stops.
User response: Remove the current DIRMC option
from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.

ANS1131E

Explanation: For removable media, TSM uses the

volume label as the file space name. To prevent data
from different volumes being stored in the same file
space on the TSM server, backup or archive of
removable media volumes having duplicate volume
labels is not allowed.
System action: The requested operation does not run.
User response: Change the volume labels on the
removable media volumes so that there are no
duplicate labels. Then restart TSM and try the
operation again.
ANS1132E

There is no backup copy group in the

management class used for directories.

Explanation: The DIRMC option names a

management class that contains no backup copy group.
System action: processing stops.
User response: Remove the current DIRMC option
from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.
ANS1130E

The drive has no label. The operation

cannot continue.

Explanation: Backup or archive of removable media

requires that the media have a volume label. An
attempt was made to back up or archive data on a
removable volume that has no label.
System action: The requested operation does not run.
User response: Create a volume label on the
removable media, then try the operation again.

42

'Access rule' Access Rule already defined

for node 'node'. Old rule must be deleted
before new one can be defined.

Explanation: You are trying to define authorization for

the specified node, which already has authorization
defined.
System action: TSM did not redefine authorization for
the specified node.
User response: Update the authorization, or delete the
old rule and define a new one, or use the current
authorization.
ANS1133W

ANS1129S

A duplicate volume label exists. The

operation cannot continue.

An expression might contain a wildcard

not enclosed in quotes.

Explanation: The command cannot be processed

because a UNIX shell expands a wildcard expression,
such as an asterisk (*) or a question mark (?), that has
no quotes.
If the expression contains no wildcard characters and
you wish to place more than the stated limit of
operands on the Archive, Selective, or Incremental
command, add the -REMOVEOPERANDLIMIT option
to the command, and try it again.
System action: Command dependent.
User response: Enclose the wildcard expression in
quotes, or add the -REMOVEOPERANDLIMIT option
and enter the command again.
ANS1134E

Drive drive-name is an invalid drive

specification

Explanation: The specified drive-name was found to be

invalid; the drive probably has not been defined.
System action: TSM skips the invalid drive and
continues to the next drive.
User response: Check the invalid drive.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1135E

Drive drive-name1 is a virtual drive of

drive-name2. It cannot be backed up or
archived.

Explanation: Drive drive-name1 was found to be a

substitute (SUBST) of drive drive-name2. The SUBST
drive cannot be backed up or archived.
System action: The SUBST drive is skipped.
Processing continues with the next drive.
User response: Do not specify any file specifications
for a drive that is a substitute of another drive. Remove
any explicit substitute drives from the DOMAIN
statement or use the -<drive:> notation to remove a
substitute drive if ALL-LOCAL is specified.
ANS1136E

Not file owner

Explanation: The file cannot be backed up because the

client is not the file owner.
System action: TSM skips the file.

User response: Reboot the machine as soon as

possible after the TSM restore operation ends.
ANS1140E

Invalid format for Set Access command.

Explanation: The SET ACCESS command must have

at least three operands, the first of which must be
either BACKUP or ARCHIVE. A validly formed file
specification must follow.
System action: Processing stopped, the command is
not executed.
User response: Use the HELP SET ACCESS command
for complete details of usage, then enter the SET
ACCESS command using the correct syntax.
ANS1141W

Unknown command - command-name

Explanation: You entered an incorrect command-name.

System action: None.
User response: Enter the correct command.

User response: None.

ANS1143E
ANS1137W

Invalid Index 'number' skipped.

The DIRSONLY and FILESONLY

options are not valid together

Explanation: An incorrect number was entered for the

Index.

Explanation: The DIRSONLY and FILESONLY options

cannot be used together.

System action: Processing stopped.

System action: Processing stopped.

User response: Correct the Index entry and retry the

operation.

User response: Try again using either the DIRSONLY

or the FILESONLY option.

ANS1138E

ANS1144W

The 'command-name' command must be

followed by a subcommand

Explanation: You entered an incomplete

command-name.
System action: Processing stopped.

Password authentication not active on

server

Explanation: None.
System action: Processing stopped.

User response: Enter the correct syntax of the

command and continue.

User response: Because password authentication is

turned off on the server, you do not need to update the
password.

ANS1139W

ANS1145E

'object-nameobject-nameobject-name' was
restored as 'temp-name'. A reboot is
required to complete the restore.

The maximum macro nesting level has

been exceeded. Macros may be nested
up to 10 levels.

Explanation: The file being restored was in use by

another application, so it could not be immediately
replaced. The file will be replaced during the next
reboot of the operating system. It is important to note
that until the reboot occurs, the system or its
applications might be unstable. The degree of
instability depends on the criticality of the file to the
operating system or applications.

Explanation: TSM allows macros to invoke other

macros, for example, macro 'A' invokes macro 'B'
which, in turn, invokes macro 'C'. This is nesting to 3
levels. The limit is 10 levels (the inital macro plus nine
levels of calls within macros currently executng). There
is no limit to the number of different macro calls that
may be made within a macro as long as the calls are
not nested.

System action: TSM restored the file with a temporary

name, and instructed the operating system to replace
the original file with the restored file during the next
boot of the operating system.

System action: The macro is ignored and an error is

returned.
User response: Reduce the level of macro nesting.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

43

ANS1146E

Macro file 'file spec' cannot be opened.

ANS1151E

'drive-name1' is not a cluster disk.

Explanation: A macro command has been entered that

specifies the macro file name shown. However, that file
cannot be opened for reading.

Explanation: The indicated file system is not a cluster

disk. Because the CLUSTERNODE option is set to YES,
the file system cannot be backed up or archived.

System action: The macro is ignored and an error is

returned.

System action: Processing stops.

User response: Enter the command with the proper

macro name.
ANS1147E

File is temporarily unavailable.

Explanation: File is temporarily unavailable.

User response: If the CLUSTERNODE option is

incorrectly set to YES, then change the option to NO
and try the operation again. Otherwise see the client
manual for further information about configuring the
TSM client to run in a cluster environment.
ANS1152W

System action: File skipped.

User response: Check and see if file is locked by other
process. If not, retry the command.
ANS1148I

'Command-name' command successfully

completed

Explanation: The specified command-name was

successfully completed.
System action: TSM completed the command.
User response: Continue with normal operations.
ANS1149E

No domain is available for incremental

backup. The domain may be empty or
all file systems in the domain are
excluded.

Explanation: An incremental backup was started, but

no domain was selected. There are two possible reasons
for this message:
v The client is a diskless workstation for which no
local file systems exist.
v An attempt was made to back up a file system that is
excluded with the EXCLUDE.FS option.
System action: processing stops.
User response: Choose a domain and restart the
incremental backup. Make sure that the DOMAIN
statement specifies the file systems you wish to back
up. Prevent this message by not trying to back up the
file system that is excluded with EXCLUDE.FS. If this
file system should be backed up, then remove the
EXCLUDE.FS option.
ANS1150E

Unable to restore current user profile

because you are running as a local
system account.

Explanation: The local system account does not have a

profile. Therefore you cannot restore its profile.

The kernel level is below the required

level for LVM support. No LVM
volumes will be available for image
operations.

Explanation: The LVM support for image operations

requires kernel level to be minimum at 2.6. LVM
volumes will not be recognized by the TSM client.
System action: All subsequent logical volume
operations on LVM volumes will fail.
User response: Use earlier versions of the client that
support LVM1 to perform the logical volume
operations. Alternatively, you can upgrade the kernel to
the required level to fully utilize logical volume
operations on LVM2.
ANS1153E

'drive-name1' is a cluster disk.

Explanation: The indicated file system is a cluster

disk. Because the CLUSTERNODE option is set to NO,
the file system cannot be backed up or archived.
System action: Processing stops.
User response: If the CLUSTERNODE option is
incorrectly set to NO, then change the option to YES
and try the operation again. Otherwise see the client
manual for further information about configuring the
TSM client to run in a cluster environment.
ANS1154E

Object name 'filespace

namepath-namefile-name' contains an
invalid multibyte sequence for the
current locale.

Explanation: An illegal multibyte sequence for the

current locale was found in the object name. Either the
path or file name has been corrupted or is coded in a
language other than that of the current locale.
System action: Object skipped.
User response: If the file name and path are not
corrupted, process the file in the locale for which it is
valid.

System action: Processing stops.

User response: Log on to the user whose profile you
want to restore.

44

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1155E

No domain is available for image

backup.

Explanation: An image backup was started, but no

domain was specified.
System action: Processing stopped.
User response: Choose a domain and restart the
image backup. Set the image domain using the
domain.image option in your dsm.opt file, either
manually, or by using the GUI preferences editor.
ANS1156E

NODENAME cannot be the local

machine name when CLUSTERNODE is
set to YES

User response: Ensure that you specified the correct

file or directory name, correct the permissions, or
specify a new location.
ANS1162E

Filesystem could not be mounted

Explanation: The system call to mount the file system

failed.
System action: The file system remains unmounted.
User response: Use the mount command to mount the
file system. On AIX, run fsck if requested by the
operating system.
ANS1163E

Filesystem could not be unmounted.

Explanation: When TSM is running as a cluster node,

the node name cannot be the local machine name.

Explanation: The system call to unmount the file

system failed.

System action: Processing stops.

System action: The logical volume operation is not

performed.

User response: Change the node name either to the

cluster name or to any other name, and restart TSM.
ANS1157E

The registry cannot be backed up or

restored when the client is running as a
cluster node.

User response: Make sure the device or file system is

not being accessed, then retry the operation.
ANS1164E

Filesystem is not mounted

Explanation: When the CLUSTERNODE option is set

to YES, the registry cannot be backed up or restored.

Explanation: The named file system is not currently

mounted. It must be mounted for TSM to perform an
image backup.

System action: The registry is not backed up or

restored.

System action: The logical volume operation is not

performed.

User response: If the CLUSTERNODE option is

incorrectly set to YES, then change the option to NO
and try the operation again. Otherwise see the client
manual for further information about configuring the
TSM client to run in a cluster environment.

User response: Mount the file system.

ANS1158E

System action: The restore operation is not performed.

The event logs cannot be backed up or

restored when the client is running as a
cluster node.

Explanation: When the CLUSTERNODE option is set

to YES, the event logs cannot be backed up or restored.
System action: The event logs are not backed up or
restored.
User response: If the CLUSTERNODE option is
incorrectly set to YES, then change the option to NO
and try the operation again. Otherwise see the client
manual for further information about configuring the
TSM client to run in a cluster environment.
ANS1159E

The specified file is being used by

another process

Explanation: The specified file is being used by

another process. You tried to read from or write to a
file that is currently being used by another process.
System action: Processing stopped.

ANS1165E

Destination is smaller than source

Explanation: The space allocation for the selected

destination is smaller than the source.

User response: Choose a different, bigger destination

or increase the size of the destination file space.
ANS1166E

Source and destination are not the same

file system type.

Explanation: The source and destination file system

types do not match.
System action: The requested logical volume
operation is not performed.
User response: Choose a destination that has the same
file system type as the source.
ANS1168E

ERROR: could not create image object.

Explanation: Creation of the image object failed for

one of the following reasons:
v The image command was executed by a non-root
user
Chapter 2. ANS 0001-9999: Client messages, version 6.3

45

v The image plugin library was not found.

User response: Retry the operation after correcting the
cause for failure.
System action: The requested logical volume function
is not performed.
ANS1169W

There is no table of contents for

image-name.

Explanation: The image item for which a table of

contents was requested is either a RAW logical volume
or it was backed up without the -TOC option.
System action: No table of contents is displayed.

User response: Contact your system administrator for

more information.
ANS1184W

Explanation: The command subcommand command is

not supported for the client running on this operating
system on this computer.
User response: None.
System action: The command is not processed.
ANS1185E

User response: Select another image object for TOC

display.
ANS1170I

Invalid selection number entered. Try

again.

Explanation: You entered a number not shown in the

list of images. It is either less than one or greater than
the highest item number displayed.
System action: TSM waits for you to enter a valid
selection.
User response: Enter a number from the list or 'Q' to
quit.
ANS1177E

System action: The help request is not executed and

you are given another chance to enter a valid
argument, display the table of contents, or exit help.
User response: Respond to the subsequent prompt as
directed.
ANS1186I

Explanation: A path must be specified for this

operation to execute successfully.
System action: Processing stops.

ANS1181E

There was a communication failure with

the journal service.

Explanation: An error occurred using named pipe

communication with the journal service.
System action: Processing stops.
User response: Restart the journal service, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1183E

An unknown error occurred while

processing system object 'sys-obj-name':
MS API function 'func-name' failed with
error error (error)

Explanation: An unknown error occurred while

processing a system object. The error information
captured indicates the reason for the failure. This
information can be used to diagnose the problem.
System action: TSM ended the current operation.

46

The help search argument you supplied

"string" is either too long or contains
unmatched quotes.

Explanation: Valid arguments are the names of things

like section numbers, command names, option names
and message numbers. All of these search arguments
are short and none requires quoting.

Must specify a path for this operation.

User response: Specify a valid path and execute the

command again.

The command subcommand command is

not supported on this client.

The help file contains no message help

section. Requests for message help will
all result in topic not found. Enter a
section number, option name, command
name, or a command and subcommand.
Otherwise press enter or 't' to display
the table of contents or 'q' to exit help:

Explanation: The named file does not have the proper

content to support the help command for messages.
The initial scan of the help file found no messages
section.
System action: The help command pauses and allows
you to make another selection.
User response: During installation of TSM a proper
help file was created. Your system administrator can
assist you with retrieving the original help file to
replace the named invalid file.
ANS1187E

The named helpfile "filename" has

invalid content.

Explanation: The named file does not have the proper

content to support the help command. One or more
sections could not be identified.
System action: The help command is terminated.
User response: During installation of TSM a proper
help file was created. Your system administrator can
assist you with retrieving the original help file to
replace the named invalid file.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1188E

The selected filesystem is managed by

HSM, and therefore is not a valid object
for image operations

Explanation: Due to the nature of HSM, image backup

is not allowed on managed filesystems.
System action: The requested logical volume
operation is not performed.
User response: None.
ANS1189E

The DIRSONLY and V2ARCHIVE

options are not valid together

Explanation: The DIRSONLY and V2ARCHIVE

options cannot be used together.

System action: The symbolic link 'linkname' is deleted,

the trace file is recreated, and processing stops.
User response: Use the TRACEFILE option to specify
the actual trace file location without the use of
symbolic links.
ANS1194E

Specifying the schedule log 'link' as a

symbolic link is not allowed.

Explanation: Schedule log 'linkname' cannot be a

symbolic link.
System action: The symbolic link 'linkname' is deleted,
the schedule log is recreated, and processing stops.

System action: Processing stopped.

User response: Check the location of the new schedule

log. To specify the location of the schedule log, refer to
the user's manual for the 'schedlogname' option.

User response: Try again using either the DIRSONLY

or the V2ARCHIVE option.

ANS1197E

ANS1190E

Symbolic link 'linkname' to 'target' was

successfully deleted.

Explanation: Log 'linkname' cannot be a symbolic link.

System action: The symbolic link 'linkname' is deleted,
the log is recreated, and processing stops.
User response: Check the location of the new file. To
specify the location of log files, refer to the user's
manual for the 'errorlogname' option, the
'schedlogname' option, and the 'DSM_LOG'
environmental variable.
ANS1191E

Unable to delete symbolic link 'link'.

Explanation: Log 'linkname' cannot be a symbolic link.

System action: Processing stops.
User response: Delete the symbolic link 'linkname'.
ANS1192E

Specifying the error log 'link' as a

symbolic link is not allowed.

Explanation: Error log 'linkname' cannot be a symbolic

link.
System action: The symbolic link 'linkname' is deleted,
the error log is recreated, and processing stops.
User response: Check the location of the new error
log. To specify the location of the error logs, refer to the
user's manual for the 'errorlogname' option and
'DSM_LOG' environmental variable.
ANS1193E

Specifying the trace file 'link' as a

symbolic link is not allowed.

Explanation: For reasons of security and system

integrity, the trace file 'linkname' cannot be a symbolic
link.

The snapshot cache size was exceeded

during the snapshot backup.

Explanation: The image snapshot backup was not able

to complete because while creating the snapshot TSM
exceeded the snapshot cache size allowed via the
SNAPSHOTCACHESize option.
System action: Processing stopped.
User response: Increase the SNAPSHOTCACHESize
value for this volume and retry the operation.
ANS1198E

An invalid snapshot cache location was

entered: path.

Explanation: The SNAPSHOTCACHELocation option

value entered for this volume is not valid. The value
for this option must be an existing, full directory path.
System action: Processing stopped.
User response: Enter a valid
SNAPSHOTCACHELocation value and try the
operation again.
ANS1199E

The PRESNAPSHOTCMD command

failed. The image snapshot backup will
not be executed.

Explanation: The command specified by the

PRESNAPSHOTCMD option must complete
successfully in order to execute the image snapshot
backup. If the command completed with a return code
of 0 (zero), it is considered to have completed
successfully. If the command completed with any other
return code, it is considered to have failed. If the
command failed then the image snapshot backup is not
executed.
System action: The client does not execute the image
snapshot backup operation.
User response: Identify and repair the problem that
caused the command to fail. If a non-zero return code
Chapter 2. ANS 0001-9999: Client messages, version 6.3

47

is normal for this command, then consider wrapping

the command in a script that always exits with a return
code of zero.

regenerate TOC for backup set before backup set can be

expanded.
ANS1204E

ANS1200W

The POSTSNAPSHOTCMD command

completed with a non-zero return code.

Explanation: If the command specified by the

POSTSNAPSHOTCMD option completed with a
non-zero return code, then the image snapshot backup
operation will continue, but with a warning-level
result. Note that the result of the
POSTSNAPSHOTCMD command will not supercede a
higher result from the image snapshot backup
command. For example, if the image snapshot backup
command completed with a return code of 12, the
image snapshot backup will be considered to have
completed with a return code of 12, regardless of the
outcome of the POSTSNAPSHOTCMD command.
System action: The image snapshot backup continues,
but with a warning return code of at least 8.
User response: Identify and repair the problem that
caused the command to fail. If a non-zero return code
is normal for this command, then consider wrapping
the command in a script that always exits with a return
code of zero.
ANS1201E

TSM cannot build a directory path

because a file exists with the same name
as the directory.

Explanation: None
System action: Processing stopped.
User response: Remove or rename the file that has the
same name as the directory. Alternatively, you can
restore the directory to a different location.
ANS1202E

TOC backup for the image failed. Check

log files.

This client is not supported by the TSM

express server

Explanation: This client is not supported by the TSM

express server. This can occur if:
1. the client is configured as an TSM express client
using the CLIENTVIEW option
2. the client is trying to connect to an TSM express
server.
System action: Processing stops.
User response: Log in using a supported TSM express
client.
ANS1205E

This is not a supported TSM express

platform

Explanation: This is not a supported TSM express

platform.
System action: Processing stops.
User response: Log in using a supported TSM express
client.
ANS1206E

TOC backup of a raw device is not

supported. But the raw device is backed
up.

Explanation: TOC backup of a raw device is not

supported. But the raw device is backed up.
System action: Raw device is backed up with no TOC
object.
User response: NONE.
ANS1207E

No TOC has been previously backed up

for this file system.

Explanation: An error occurred during backup of the

table of contents. Check the error log for more
information.

Explanation: The user is trying to query the TOC of a

file system. TOC backup for that file system has not
been previously done.

System action: The requested logical volume

operation is not performed.

System action: Query stopped.

User response: Check error log.

User response: Backup the file system again with

-TOC option.

ANS1203E

ANS1209E

Table of Contents not available for

selected backup set. Please contact
server administrator.

Explanation: There is no TOC for selected backup set

System action: Expansion of selected backup set will
not be possible. Will only be able to restore the whole
backup set.
User response: Please contact server administrator to

48

The option_name option is not supported

with the command_name command using
the -FILELIST option.

Explanation: The specified option is not supported

with the specified command when the -FILELIST
option is also specified.
User response: >Do not specify the offending option
when the -FILELIST option is specified with this
command.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: The command is not processed.

ANS1212I

Invalid Process number entered. Try

again.

Explanation: You entered a number not shown in the

list of processes. It is either less than one or greater
than the highest item number displayed.
System action: TSM waits for you to enter a valid
selection.
User response: Enter a number from the list or 'Q' to
quit.
ANS1213W

Snapshot image backup is not possible

for device device-name. starting static
image backup.

Explanation: On Linux platforms, snapshot image

backup is only possible for logical volumes created by
the Linux logical volume manager (LVM). Since the
default image backup type is snapshot, backing up a
partition which is not created using LVM automatically
leads to a static image backup.

location using the SNAPSHOTCACHELOCATION

option.
ANS1216E

Not authorized to run TSM. See the

administrator for your system.

Explanation: The system options file for the server

that you are attempting to connect to contains a user
entry, a group entry, or both a user and group entry.
Your user ID, or group ID, was not found in any of the
entries. You are currently not authorized to run TSM to
this server.
System action: TSM initialization fails and the
program ends.
User response: See the TSM administrator for your
system, and ask to be added to the user or group list
for this server.
ANS1217E

Server name not found in System

Options File

Explanation: The system options file does not contain

the SERVERNAME option.

System action: Snapshot image backup will failover to

static image backup

System action: TSM initialization fails and the

program ends.

User response: To avoid this message, use the

imagetype option to specify static or dynamic image
backup.

User response: See the TSM administrator for your

system, and make sure that the system options file
contains the server name.

ANS1214E

ANS1218E

The logical volume group does not have

enough free space to contain the volume
snapshot.

Explanation: The snapshot is created in the volume

group that contains the logical volume being backed
up. There is insufficient free space in the volume group
to contain the snapshot.
System action: The operation ends.

TCPSERVERADDRESS not defined for

this server in the System Options File

Explanation: The TCPSERVERADDRESS for this

server is not defined in the server name stanza in the
system options file.
System action: TSM initialization fails and the
program ends.

User response: Decrease the SNAPSHOTCACHESIZE

value or make additional space available in the logical
volume group. Then try the operation again.

User response: See the TSM administrator for your

system, and make sure that the server to which you are
trying to connect, has a valid TCPSERVERADDRESS
defined in the system options file.

ANS1215E

ANS1219E

On volumes that are RAW or formatted

FAT32 the snapshot cache location
cannot be located on the same volume
that is being backed up.

Explanation: When the snapshot cache location is

located on the same volume that is being backed up the
volume must be formatted with NTFS. The default
cache location is on the same volume where the
snapshot is being performed.
System action: The client does not execute the image
snapshot backup operation.
User response: Specify a different snapshot cache

A virtual node name must not equal

either a node name or the system host
name.

Explanation: A VIRTUALNODENAME option was

entered with a name the same as either a NODENAME
option or the system host name.
System action: Initialization fails and the program
ends.
User response: If the virtual node name entered was
the same as the host name, remove the virtual node
name option. If it was the same as the node name
option, you can remove either one, depending upon the
intended usage. Node name is used to assign an
Chapter 2. ANS 0001-9999: Client messages, version 6.3

49

alternate name to your system. Virtual node name is

used to access another system's server data.
ANS1220E

The TSM server is out of resources.

Explanation: A lack of a storage resource or a

maximum value condition does not allow any new
activity.
System action: TSM canceled the current operation.
User response: Try the operation again at a later time.
If the problem continues, contact your TSM
administrator to isolate what resource is unavailable.
The TSM administrator can check the TSM server
activity log for messages that might explain the
problem.
ANS1221E

Transaction aborted

Explanation: The current transaction between the

server and the client stopped. A server, client, or
communication failure cannot be recovered.
System action: TSM canceled the current operation.
User response: Retry the operation. If the problem
continues, see your system administrator to isolate the
problem.
ANS1222E

Insufficient memory for file

compression/expansion

Explanation: Not enough memory is available to do

data compression or expansion. For a restore or
retrieve, the file cannot be recalled from the server until
more storage is made available. For a backup or
archive, try running without compression if storage
cannot be made available.
System action: Processing stopped.
User response: Free up extra storage for the operation
to continue, or run the backup or archive process
without compression enabled.
ANS1226E

Destination file or directory is write

locked

Explanation: The file or directory being restored or

retrieved from the server cannot be written to because
the destination is write locked. Another operation
might have the file open and will not allow it to be
updated.
System action: File skipped.
User response: Either determine which operation has
the file write locked, or restore the file to another name
or location.

Disk space limit for this process reached

Explanation: The disk space allocated for the client

owner is full.
System action: Processing stopped.
User response: Free up disk space and retry the
restore or retrieve operation.
ANS1223E

ANS1225E

ANS1227E

Processing stopped; Disk full condition

Explanation: No more files can be restored or

retrieved because the destination disk is full.
System action: Processing stopped.
User response: Free up disk space, or restore or
retrieve the file to another disk.

File is not compressed; System failure.

Explanation: A file that was flagged as compressed

was not compressed, and the system failed.
System action: Processing stopped.
User response: See your system administrator to
report this problem. This error is a system failure.

ANS1228E

Sending of object 'object-nameobjectnameobject-name' failed

Explanation: The specified file (object-name) cannot be

sent to the server. This message is accompanied by at
least one other message that has more specific
information about why the file could not be processed.
System action: File skipped.

ANS1224E

File compressed on a different client

machine that has more memory

Explanation: You are trying to restore a file that was

backed up and compressed on another client
workstation that had more memory than your client
workstation. You cannot restore this file. When the file
is restored, it is expanded and your workstation does
not have enough memory.
System action: TSM canceled the operation.
User response: Obtain a machine with more memory
and retry the operation.

50

User response: Check previous messages pertaining to

this file that indicate the reason for the failure. Where
applicable, correct the conditions that prevented the file
from being sent to the server. The specific corrective
actions will depend on the reason for the failure.
ANS1229E

MODE=INCREMENTAL is not valid on

file-space. Image backup not processed.

Explanation: Because the file space has been the

subject of at least one progressive incremental backup,
the MODE=INCREMENTAL option (incremental by

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

image date) cannot be used with the backup image

command.
System action: File system skipped.
User response: If an image backup of the named file
space is desired, retry the command without the
MODE=INCREMENTAL option. To prevent this
behavior in the future, delete the file space from the
server and do only BACKUP IMAGE -mode=selective
and BACKUP IMAGE -mode=incremental from that
point on.

ANS1234E

Explanation: A communications protocol error

occurred. The communication subsystem is not
properly defined or is itself in error.
System action: TSM ended the current operation.
User response: Verify that the communication
processes are operating properly, and then retry the
operation.
ANS1235E

ANS1230E

Stale NFS File Handle

Explanation: An NFS file system becomes stale.

System action: File system skipped.
User response: Check the NFS mounted filesystem.
ANS1231E

No file handles available

Explanation: All file handles for your system are

currently in use. No more are available.
System action: Processing stopped.
User response: Either free some file handles by ending
other processes, or modify your system setup to allow
for more files to be open at the same time.
ANS1232E

The file exists and cannot be

overwritten.

Explanation: The file being restored or retrieved exists

and cannot be overwritten due to lack of authority or
access permissions.
System action: The file is skipped.
User response: Verify that you have sufficient access
permissions to overwrite the file, then try the operation
again. If the problem persists, contact your system
administrator or TSM administrator for further
assistance.
ANS1233E

An invalid file handle was passed;

system error.

Explanation: An internal system error occurred: A file

operation failed because of an invalid file handle.
System action: processing stops.
User response: Try the operation again. If the failure
persists, obtain a service trace that captures the
problem and contact IBM technical support for
additional assistance. Your TSM administrator can help
you configure the trace.

Protocol violation

An unknown system error has occurred

from which TSM cannot recover.

Explanation: An unknown error occurred. This might

be a low-level system or communication error from
which TSM cannot recover.
System action: Processing stops.
User response: Try the operation again. If the problem
persists, review the TSM error log for any related
messages. Obtain a service trace that captures the
problem and contact IBM technical support for
additional assistance. Your TSM administrator can help
you configure the trace.
ANS1236E

An unexpected error occurred.

Explanation: This is usually caused by a low-level

system error or communication error from which TSM
cannot recover.
System action: Processing stopped.
User response: Examine the client error log for any
additional messages that might be related to this
problem. Try the operation again. If the problem
persists, contact TSM technical support for further
assistance.
ANS1237E

A problem has occurred on the TSM

server.

Explanation: The TSM client error log and the TSM

server activity log might contain additional information
about this error.
System action: Processing stops.
User response: Try the operation again. If the problem
persists, examine the TSM client error log and TSM
server activity log for additional information about this
error. If the problem cannot be resolved, then obtain a
SERVICE trace that captures the problem and contact
IBM technical support for additional assistance. Your
TSM administrator can help you configure the trace.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

51

ANS1238S

A policy management problem has

occurred on the TSM server.

Explanation: The TSM client error log and TSM server

activity log may contain additional information about
this error.
System action: Processing is stops.
User response: Try the operation again. If the problem
persists, examine the TSM client error log and TSM
server activity log for additional information about this
error. If the problem cannot be resolved, then obtain a
SERVICE trace that captures the problem and contact
IBM technical support for additional assistance. Your
TSM administrator can help you configure the trace.
ANS1241E

File is in use; Write permission denied.

Explanation: The current file cannot be opened to

write to because it is currently being run by another
operation.
System action: File skipped.
User response: Stop the operation that is running the
file and retry the operation, or restore or retrieve the
file to a different name or directory.
ANS1242E

Too many symbolic links were detected

while resolving name

Explanation: While trying to resolve the file name, too

many symbolic links were found.

ANS1245E

The file has an unknown format.

Explanation: TSM tried to restore or retrieve a file, but

it had an unknown format.
System action: The file is skipped.
User response: The file was either backed up by
another application, or the data is invalid. If the file
belongs to this system, try the operation again. If the
problem persists, contact IBM technical support for
further assistance.
ANS1246E

A command-line argument exceeded the

maximum length (maximum length) for a
single token.

Explanation: Command-line arguments may not

exceed maximum length characters.
System action: The command is not processed.
User response: Correct the command and retry the
operation.
ANS1247I

Waiting for files from the server...

Explanation: Restore request has been sent to the

server. The wait time depends on how many files you
are restoring.
System action: TSM waits for files to restore from the
server.
User response: None.

System action: File skipped.

User response: Ensure that you do not have a looping
symbolic link for the file.
ANS1243E

The file name is too long and can not be

processed by TSM

Explanation: The size limit for file names may vary by

operating system. The most common limit is 256
characters. The file name being processed exceeds the
limit supported by TSM on this system.

ANS1248E

An active restore for the same source

file specification exists. Unable to
continue with this request.

Explanation: Currently, there is an active restore for

the same source file specification. Another restore of the
same source file specification cannot be started.
System action: The requested restore fails.
User response: Start another restore with a different
source file specification.

System action: The file is skipped.

User response: Enter HELP FILE SPEC or see the
client manual for the operating system on which you
are receiving this error. The "File specification syntax"
section of the manual explains file name lengths
supported by TSM.
ANS1244E

File system is locked by system

Explanation: File system cannot be accessed because it

is locked by the system.
System action: TSM cannot complete the operation.

ANS1249W

Server cannot restart the last restore

request. Do you want to restore without
restart or abort the request?

Explanation: The restart restore token has expired.

The server cannot restart the restore from where it last
ended.
System action: Processing stopped; waiting for user
intervention.
User response: Retry the request without restart or
abort the request.

User response: See your system administrator.

52

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1251E

File system/drive not ready

Explanation: The file system/drive was not ready for

access.
System action: Processing stopped.
User response: Ensure that the drive is available to
TSM, and then retry the operation.
ANS1252W

The server that you are connected to

does not support this function.

Explanation: You attempted to run a backup-archive

client operation when connected to the virtual server.
Backup-archive client operations are not supported
when connected to the virtual server.

ANS1257E

An error occurred while preparing the

system object for restore.

Explanation: This message is typically issued when

the client is unable to delete the ADSM.SYS staging
directory in preparation for restoring the system object.
System action: The system object is not restored.
User response: Check the error log for any other
messages that might indicate a reason for the failure,
correct any indicated problems, then try the operation
again. If the problem occurs again, manually delete the
ADSM.SYS directory, then try the operation again. If
the problem cannot be resolved, contact IBM technical
support for further assistance.

System action: The operation fails.

ANS1258E

The image snapshot operation failed.

User response: Connect to a valid server before

attempting this function.

Explanation: TSM was not able to take a snapshot of

the specified volume.
System action: Processing stopped.

ANS1253E

File input/output error

Explanation: An error was found while reading from

or writing to the file.
System action: File or file system is skipped.

User response: Check the error log for any other

messages that might indicate a reason for the failure.
Try to correct any indicated problems, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

User response: Check your system to ensure that it is

operating properly. For OS/2, run CHKDSK /F for the
failing drive which can be found in dsmerror.log.

ANS1259E

ANS1254E

Explanation: An error was encountered during image

backup snapshot processing. The diagnostic text can
vary, depending on the error.

File write error

Explanation: An error was found while writing to the

file.
System action: File skipped.
User response: Check your system to ensure that it is
operating properly.
ANS1255E

File exceeds system/user file limits

Explanation: A file being restored or retrieved exceeds

system set limits for this user.

System action: The operation ends.

User response: Examine the client error log for
additional messages that might indicate the reason for
the problem. Take any corrective action suggested by
the messages, then try the operation again. If the
problem persists, contact IBM technical support for
further assistance.
ANS1260E

System action: File skipped.

User response: Ensure that the system limits are set
properly.

The image snapshot operation failed.

Diagnostic text: diag_text.

File is being recalled or has been

recalled.

Explanation: The file is being recalled by another

process or has been recalled.
System action: File skipped.

ANS1256E

Cannot make file/directory

Explanation: The directory path for files being

restored or retrieved cannot be created.
System action: File skipped.
User response: Ensure that you have the proper
authorization to create the directory for file being
restored or retrieved. Make sure that you have write
access.

User response: None

ANS1261W

The archive description you specified is

the empty string. TSM will use the
default description (Archive Date:
current date).

Explanation: The description option on the archive

command may not specify a null string.
System action: Processing continues, and the
Chapter 2. ANS 0001-9999: Client messages, version 6.3

53

description option is ignored.

User response: None. Specify at least one character in
the description
ANS1262E

The password is not updated. Either an

invalid current password was supplied
or the new password does not fulfill the
server password requirements.

Explanation: The password is not updated because of

one of the following reasons:
v You entered an incorrect current password or
v You entered a new password that does not fulfill the
password length requirements. The length
requirements are set on the server.
System action: The password is not updated on the
server.
User response: Enter another password.

point on your system. Look at file systems and mounts,

and correct any errors. If unsuccessful, see your system
administrator for more information.
ANS1266E

Encountered bad mount or filesystem,

processing stopped.

Explanation: An error was encountered trying to

determine what the mounted file systems are.
System action: Processing stopped. Cannot recover.
User response: Please, see your system administrator
for more information.
ANS1267E

The management class for file file-name

does not allow migration. This file will
not be migrated.

Explanation: The management class for this file does

not allow migration
System action: File is skipped.

ANS1263E

The active policy set does not contain

any backup copy groups. The backup
operation can not continue.

Explanation: In order to back up files, the policy set

must contain at last one backup copy group.
System action: TSM did not backup the file.
User response: The TSM administrator needs to
update or define at least one management class in your
policy set that contains a backup copy group, or else
assign you to a different policy domain that contains at
least one backup copy group. Contact your TSM
administrator for further assistance.
ANS1264E

The active policy set does not contain

any archive copy group. The archive
operation cannot continue.

User response: Either have the TSM administrator

change the Space Management Technique within the
management class to a value other than NONE or
change the include/exclude list to specify a
management class with the appropriate Space
Management Technique value.
ANS1268E

This file has been migrated.

Explanation: File has been migrated. If files that are

hard linked together are migrated then files subsequent
to the first one encountered get this.
System action: File is skipped.
User response: None.
ANS1269I

File is implicitly excluded.

Explanation: In order to archive files, the policy set

must contain at least one archive copy group.

Explanation: You tried to back up or migrate a file

that is implicitly excluded.

System action: TSM did not archive the file.

System action: TSM will not back up or migrate an

implicitly excluded file.

User response: The TSM administrator needs to

update or define at least one management class in your
policy set that contains an archive copy group, or else
assign you to a different policy domain that contains at
least one archive copy group. Contact your TSM
administrator for further assistance.
ANS1265E

Encountered bad mount or filesystem,

processing stopped.

Explanation: The getmnt system call returned an error

indication. Error was encountered trying to determine
what the mounted file systems are.
System action: Processing stopped. Cannot recover.
User response: There is a bad file system or mount

54

User response: None.

ANS1270I

Forcing compression off to enable future

server-free restore.

Explanation: Because ENABLESERVERFREE had been

specified, and an attempted server-free data movement
fell back to non-server-free, the TSM client is forcing
compression off. This is to enable future server-free
restore of the object backed up, when the problems
preventing a server-free backup from occurring have
been resolved.
System action: The operation continues without
compression.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Either Remove the

ENABLESERVERFREE option from the system option
file, or set COMPRESSION off in the option file.

Tivoli Storage Manager must have exclusive use of the

volume.
ANS1274E

ANS1271E

The compressed file is corrupted and

cannot be expanded correctly.

Explanation: The compressed file cannot be expanded

correctly due to one of the following reasons:
There is a problem on the tape.
There is a communications problem.
The compressed file was corrupted on the TSM
Server.

Error Loading WINSOCK.DLL

Explanation: Error loading the Windows socket

support file into memory. This error only applies when
using TCP/IP communications.
System action: Connection to server fails.
User response: Because this error is caused by
insufficient memory, shut down running applications
and retry. If the problem persists, see your system
administrator.

System action: File skipped.

User response: 1) The compressed file is corrupted
because there is a problem on the tape. To know if this
is the problem, please issue the following command on
the TSM Server: audit volume <volume_name> fix=no
If there is any problem reported, you could move the
data from that volume to a new one (see command
MOVE DATA) and try again the restore. 2) There are
communications problems between the TSM Server and
the TSM Client and the results is that the file is
corrupted during the transmission. If you use a gigabit
Ethernet adapter on the Server please upgrade the card
driver (AIX platform) or add provided by SUN
suggested changes to some system network options
which have resolved this problem (SUN platform). 3)
Please verify with your network support if during the
restore there are no any problems between the TSM
Client/Server that is originating the file corruption.
ANS1272W

Adaptive subfile backup has been

configured on the client but the server
doesn't allow this type of backup.
Adaptive subfile backup will not be
used for this operation.

Explanation: Adaptive subfile backup forced off by

the server.
System action: Processing continues.
User response: Set up the server to allow clients to
back up subfiles.
ANS1273E

The image plug-in was not able to

acquire an exclusive lock on volume:
volume_name

Explanation: To perform an offline image backup or

an image restore, IBM Tivoli Storage Manager requires
exclusive use of the volume.

ANS1275E

Error Loading Function(s) from

WINSOCK.DLL

Explanation: Error loading one or more functions

from the Windows socket support file.
System action: Connection to server fails.
User response: Since this might possibly be caused by
insufficient memory, shut down running applications
and retry. If the problem persists, see your system
administrator.
ANS1276I

\"Log on as a service\" right granted to

account

Explanation: You specified a Windows user account

which did not have the security right to run as a
service
System action: TSM granted the "log on as a service"
right to the account you specified.
User response: No action required.
ANS1277E

Error occurred while granting \"log on

as a service\" right to account

Explanation: You specified a Windows user account

which did not have the security right to run as a
service. TSM encountered a problem attempting to
grant this right automatically.
System action: The "log on as a service" right is not
granted to the account specified.
User response: Insure the account from which you are
configuring the service has authority to grant rights
and retry the request. Alternatively run the Windows
policy editor from an administrative account to grant
the "log on as a service" right to the account that is
associated with the service you are configuring.

System action: Processing stopped.

User response: Verify that no other application is
accessing the volume. If this volume is being accessed
by applications that can not be shut down during
backup then perform an online image backup (snapshot
with LVSA) instead. During restore of an image, IBM
Chapter 2. ANS 0001-9999: Client messages, version 6.3

55

ANS1278W

Virtual mount point 'filespace-name' is a

file system. It will be backed up as a
file system.

ANS1289W

Bad areas on 'volume' between sectors

hi:lo and hi:lo

Explanation: A virtual mount point that is a file

system is invalid and should be deleted.

Explanation: Some bad sectors within the specified

range were detected on the volume during image
operation.

System action: The virtual mount point is ignored.

System action: Processing continues.

User response: Delete the virtual mount point.

User response: Make sure the volume data is not

corrupt by using system tools like chkdsk (Windows)
or fsck (UNIX).

ANS1279W

Virtual mount point 'filespace-name'

cannot be used in a file system handled
by automounter and is ignored.

Explanation: Virtual mount points cannot be used in a

file system handled by automounter. If virtual mount
points reside in a file system that is processed from an
automounter, the backed up files underneath the
virtual mount points will be expired when the file
system is unmounted.
System action: The virtual mount point is ignored.
User response: Delete the virtual mount point.
ANS1286E

-nasnodename option required for this

operation.

Explanation: User issued a NAS related command and

NASNodename option is missing.
System action: Operation aborted.
User response: Use -nasnodename option with the
command or place nasnodename option in the option
file.
ANS1287E

Volume could not be locked.

Explanation: The system call to lock the volume

failed.
System action: Processing stopped.
User response: Please verify that no other application
is accessing the volume. If this volume is being
accessed by applications that can not be shutdown
during backup then perform an online image backup
(snapshot with LVSA) instead. During restore of an
image TSM must have exclusive use of the volume.
ANS1288E

The (-TYPE) option is required with the

SET EVENT command.

Explanation: There is no default value for the -TYPE

option. It must be explicitly entered with the command.

ANS1300E

File 'file_name' cannot be reconstructed

because a necessary component was not
restored.

Explanation: The subfile backup technique was used

to back up this file. During the restore, a portion of the
file was not be obtained from the server.
System action: The file indicated in the message is not
restored. Restore for all other files continues.
User response: Try to restore the file again by
selecting the file for restore from the user interface. You
can also check the client error log and the server
activity log for any messages related to the file
indicated in the message.
ANS1301E

Server detected system error

Explanation: The server detected a system error and

notified the clients.
System action: Processing stopped.
User response: See your system administrator for
further information on server activity.
ANS1302E

No objects on server match query

Explanation: No objects on the server match the query

operation being performed. If this object is part of a
backupset generated on a node, and the node name is
changed on the server, any backup set objects that were
generated prior to the name change will not match the
new node name.
System action: Processing stopped.
User response: Ensure the names are properly
entered. If the object is part of a backupset generated
prior to a node name change, ensure that the node
name is the same as the node for which the backup set
was generated.

System action: Current command ends.

ANS1303E

Client ended transaction

User response: Enter the SET EVENT command again

with the TYPE option and a value of HOLD, RELEASE,
or ACTIVATERETENTION.

Explanation: The client system ended the operation

with the server and ended the current transaction.
System action: Processing stopped.
User response: Restart the session.

56

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1304W

An active backup version could not be

found.

Explanation: An attempt was made to expire an

object, but the TSM server was unable to find an active
backup version of the object. This message is preceded
by message ANS1228E which specifies the object name.
For instance, this message could be issued if two
separate client processes are backing up the same file
system at the same time. If one of the processes expires
a file, then the TSM server will make that file inactive.
If the second process subsequently attempts to expire
that same file, the TSM server will not find an active
version of the file, so the second process will issue this
message for that file.
System action: The object is not expired. Processing
continues with the next object.
User response:
v Review the console output, schedule log, or error log
and locate the ANS1228E message that immediately
precedes this message. ANS1228E will identify the
object that could not be expired.
v Examine the conditions under which the problem
occurred and assess whether those conditions explain
the occurrence of this message. For example, this
message could appear if multiple instances of the
client were attempting to back up the file system
concurrently.
v If the reason this message occurred can not be
determined and the message occurs when the
operation is tried again, then contact IBM support for
further assistance. Also try searching for this message
number on http://www.ibm.com for possible
solutions.
ANS1305E

The TSM server has no data for the

object.

Explanation: TSM tried to do a restore or retrieve on

an object that has no data associated with it. If a
corrective action is possible, it is with the TSM server.

ANS1307E

Node in use

Explanation: The node you are running on is in use

by another operation on the server. This might be from
another client or from some activity on the server.
System action: Processing stopped.
User response: Retry the operation, or see your
system administrator to see what other operations are
running for your node.
ANS1308E

Expiration date must be greater than

today's date

Explanation: Archive expiration date is too low, the

date must be greater than todays date.
System action: TSM canceled the current operation.
User response: Retry archiving the file with an
expiration date that is higher than todays date.
ANS1309I

The requested data is offline.

Explanation: For the restore or retrieve operation, one

or more of the requested files must be recalled from
offline storage media (generally tape). The wait time
depends on your sites offline storage management
policies.
System action: TSM waits for offline storage media to
become available and then continues.
User response: None.
ANS1310E

Object too large for server limits

Explanation: The object is too large. The configuration

of the server does not have any data storage space that
accepts the object.
System action: File skipped.
User response: See your system administrator to
determine the maximum file (object) size for which
your sites server is configured.

System action: TSM ends the current operation.

User response: Ask the TSM administrator to check
the TSM activity log for any messages related to this
error that might help identify the problem.

ANS1311E

ANS1306E

System action: TSM ended the current operation.

You entered an incorrect password.

Server out of data storage space

Explanation: The server does not have any space

available to store the object.

Explanation: You entered an incorrect current

password or you entered a new password that does not
fulfill the password length requirements set on the
server.

User response: You can take any of the following

actions:

System action: Processing stops.

v For TSM client, set COMPRESSALWAYS=NO and

COMPRESSIon=YES in the options file (DSM.OPT),
then the file will be resent uncompressed if it grows
during compression.

User response: Retry the session with the correct

password. If this fails or you have forgotten your
password, ask the TSM administrator to assign a new
password.

v Request the system administrator to add space to the

storage pool.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

57

v For API Applications, consult the application's

documentation for recommendations regarding
compression.
v Turn off disk caching in the disk storage pool, and
issue MOVE DATA commands to each disk pool
volume to clear out the cached bitfiles.
ANS1312E

ANS1315W

Explanation: None.
System action: The client retries the operation.
User response: None.

Server media mount not possible

Explanation: Server media mount not possible. The

server timed out waiting for a mount of an offline
volume.
System action: File skipped.
User response: Retry later when server volumes can
be mounted. Ensure that the MAXNUMMP (maximum
number of mount points) defined on the server for this
node is greater than 0.

ANS1316E

System action: TSM ended the current operation.

User response: This error is a temporary problem.
Retry later or see your system administrator.

Size estimate exceeded

Explanation: The total amount of data for a backup or

archive operation exceeds the estimated size originally
sent to the server for allocating data storage space. This
happens when many files are growing by large
amounts while the backup or archive operation is in
session.

The server does not have enough

recovery log space to continue the
current operation

Explanation: The server ran out of recovery log space.

ANS1317E
ANS1313E

Unexpected retry request. The server

found an error while writing the data.

The server does not have enough

database space to continue the current
operation

Explanation: The server ran out of database space.

System action: TSM ended the current operation.
User response: See your system administrator.

System action: Processing stopped.

ANS1318E

User response: Retry the operation. If the problem

continues, check what other processes are running on
the client machine that are generating large amounts of
data. Disable those operations while the backup or
archive operation is taking place.

Explanation: The server ran out of memory.

ANS1314E

File data currently unavailable on server

Explanation: The file data is currently unavailable on

the server. A retrieve or restore operation was
attempted. Possible causes are:
v Data was corrupted at the server
v Server found a read error
v File is temporarily involved in a reclaim operation at
the server
v Server requested a tape volume that was marked
unavailable.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, see your system administrator to determine
the problem from the server console or the activity log.
Check whether any requests were made for a tape
volume that was unavailable. A tape volume may be
marked unavailable if prior read errors were
encountered or the volume is checked out of the tape
library.

The server does not have enough

memory to continue the current
operation.

System action: TSM ended the current operation.

User response: This is a temporary problem. Retry
later or see your system administrator.
ANS1319E

An error occurred on the IBM Tivoli

Storage Manager server while trying to
rename file space file_space_name

Explanation: None.
System action: Because the file space cannot be
renamed, the operation stops.
User response: Check the client error log and the IBM
Tivoli Storage Manager server activity log for any other
messages that might help identify the problem. If the
problem cannot be resolved, contact IBM technical
support for additional assistance.
ANS1320E

The specified file space does not exist

on the server. The file space might have
been deleted by another client or an
administrator.

Explanation: The specified file space does not exist on

the server. Your system administrator deleted the file
space or another client using your clients node name
deleted it.

58

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: TSM canceled the current operation.

support for additional assistance.

User response: Check the file space name to see if it is

correct, and retry the operation.

ANS1328W

ANS1321S

Open Registration failed because the

specified node name is defined in the
server

Explanation: Open registration failed because a node

is defined in the server with the same name.
System action: TSM canceled the current operation.
User response: Retry with another node name.
ANS1322S

Open Registration failed because no

default domain exists

Explanation: Open registration failed because a

default policy domain does not exist for you to place
your node.
System action: TSM canceled the current operation.
User response: See your system administrator.
ANS1323S

Open Registration failed because an

invalid node name was specified

Explanation: Open registration failed because the

specified node name contains invalid characters.
System action: TSM canceled the current operation.
User response: Retry with another node name that
does not have any invalid characters.
ANS1326S

The TSM server does not currently have

space in the storage pool for this file.
This may be a temporary condition.

Explanation: This message is typically issued when

the storage pool in which the data is being placed does
not have sufficient space to store the data, but the
space will be available soon. For example, a storage
pool migration might free up sufficient space to store
the data.
System action: TSM ends the current operation.
User response: Try the operation at a later time. If this
fails, contact the TSM administrator and request more
storage pool space.
ANS1327W

The snapshot operation for 'volname'

failed with error code: retcode.

Explanation: A snapshot could not be taken of the

specified volume.
System action: Snapshot processing stopped.
User response: Check the client error log for any other
messages that might help identify the problem. If the
problem cannot be resolved, contact IBM technical

An error occurred generating delta file

for 'file-name'. The return code is retcode.

Explanation: An error occurred that prevented the

creation of the delta file. Possible reasons for this error
include:
v The base file cannot be opened for reading
v The file being backed up cannot be opened for
reading
v The delta file cannot be opened for writing
v The file being backed up has grown to a size larger
than 2 GB
v A memory file mapping of the file cannot be created
System action: A full backup of the file is made, and a
new version of the reference file is stored in the subfile
cache.
User response: If the message indicates return code
4504, check the delta subfile cache directory for any
residual delta files. The delta subfile cache directory is
specified by the client option SUBFILECACHEPATH.
Search the directory for files named \".dXXXXXXXX\"
where \"XXXXXXXX"\ is an eight-digit number. If
there are no backup operations in progress, there
should not be any files in the SUBFILECACHEPATH
with this name. If there are no backup operations in
progress and these files exist, they can safely be
removed. If you continue to receive this message but
there are no residual delta files in the subfile cache
directory and the file has not grown to a size larger
than 2 GB, then contact IBM technical support for
further assistance.
ANS1329S

Server out of data storage space

Explanation: The server does not have space available

to store the object.
System action: TSM ended the current operation.
User response: Report to your system administrator
that a storage pool on the server is full.
ANS1330S

This node currently has a pending

restartable restore session. The
requested operation cannot complete
until this session either completes or is
canceled.

Explanation: This operation can not be completed

because a restartable restore session is pending. The
operation is not allowed because the restartable session
and the current operation affect the same file space.
System action: TSM ended the current operation.
User response: Issue a query restore to see the
conflict. Issue the cancel restore command to delete any
unneeded restartable restore sessions.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

59

ANS1331E

Only a TSM authorized user can

perform this Action.

Explanation: User must be a TSM authorized user to

perform this action. User is not password authorized
and this action requires authorization.

a volume mount point that resides in the SYSVOL,

since an incomplete SYSVOL restore can result in
system stability problems. See the reference information
for the RESTORE command in the client manual for
additional information about restoring volume mount
points.

System action: Processing stopped.

User response: User must be root user, or user must
be the owner of the executable and the set effective
user id bit is set to 'on' ('s' bit).
ANS1332E

Run the '... for Administrators' version

of the application.

Explanation: The user must be root or a system

administrator and use the provided authorization tools
to start IBM Tivoli Storage Manager
System action: IBM Tivoli Storage Manager
terminates.
User response: The user must login as the root user or
be a system administrator and use one of the following
authorization tools to start IBM Tivoli Storage Manager:
v "TSM Backup for Administrators"
v "TSM Scheduler for Administrators"
v "TSM Scheduler Daemon for Administrators"

ANS1335E

The RSM database files could not be

restored.

Explanation: None.
System action: The RSM database is not restored.
Otherwise, processing continues.
User response: Check the client error log for any other
messages that might help identify the problem. Reboot
the system, then try the RSM restore operation again. If
the problem cannot be resolved, contact IBM technical
support for further assistance.
ANS1336I

RSM service must be restarted for

changes to become effective.

Explanation: RSM database files have been restored

from the server and imported. The RSM service must
be restarted for the updates to become effective.
System action: Processing continues.
User response: None.

ANS1333I

The used-block list used for the

snapshot image backup of volume_name
is different than list acquired before the
start of snapshot.

Explanation: The snapshot image backup used-block

list is taken before and after the start of the snapshot
for informational purposes.
System action: Processing continues.
User response: None.
ANS1334W

Volume mount point 'filespace

namepath-namedir-name' was not restored
because the target directory is not
empty.

Explanation: Volume mount points can only be

restored if the target directory does not already exist, or
if the target directory exists but is empty. If the target
directory exists and is not empty, or already is a
junction point, then the volume mount point cannot be
restored. On Windows Vista, it is normal to see these
warnings during system drive restore as there are
many junction points that point to the
'%systemroot%\Users' folder.
System action: The volume mount point is not
restored. Processing continues with the next object.
User response: Correct the conflict with the
non-empty directory, then try the operation again. This
is especially important when this message is issued for

60

ANS1337I

Restarting the RSM service...

Explanation: RSM database files have been restored

from the server and imported. TSM is about to stop
then restart the RSM service.
System action: Processing continues.
User response: None.
ANS1338I

Restart of the RSM service is completed.

Explanation: RSM database files have been restored

from the server and imported. TSM has restarted the
RSM service on the user's behalf.
System action: Processing continues.
User response: None.
ANS1339E

Restart of the RSM service failed.

Restart the RSM service manually.

Explanation: RSM database files have been restored

from the TSM server and imported. TSM has tried to
restart the RSM service on the user's behalf but has run
into a problem.
System action: Processing stopped.
User response: Restart the RSM service manually.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1340E

An error occurred while backing up the

RSM database.

Explanation: An error occurred while backing up the

RSM database files. The database will not be backed
up.
System action: Processing stopped.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

ANS1345E

Explanation: The specified file (object-name) does not

have a match on the server.
System action: File skipped.
User response: Backup the file and retry the
operation. If the problem continues, see your system
administrator to isolate the problem through use of the
server console.
ANS1346E

ANS1341E

An invalid character appears in the

operand: operand.

Explanation: The operand contains a character that is

not valid in the current locale and code page. It cannot
be translated to its internal wide-character format.
System action: Processing stops.
User response: Change the locale of the workstation
to match the language in which the operand is
recorded, and try the command again.
ANS1342E

Client cache is locked; unable to

continue with operation.

Explanation: The client cache is currently locked by

another process.
System action: Processing stopped.
User response: Report the program error to your
service representative.
ANS1343E

The option 'specified-option' can only be

entered when 'other-option' has been
entered.

Explanation: The command failed because the

specified option (specified-option) option was entered,
but the other option (other-option) was not.

No objects on server match

'object-nameobject-nameobject-name'

The image snapshot operation failed.

The SNAPSHOTCACHELocation does
not contain enough space for this
snapshot image backup.

Explanation: TSM was not able to take a snapshot of

the specified volume. The SNAPSHOTCACHELocation
points to a location which does not contain the space
necessary to manage the snapshot. This could be due to
an unexpected amount of disk activity which is
generating more changes than can be contained in the
available space at this particular point in time, or the
SNAPSHOTCACHELocation needs to be changed
because the specified location is not large enough to
handle the usual amount of changes to the volume.
Another reason for this failure can be that the specified
SNAPSHOTCACHESize is not set to a large enough
value to handle the usual amount of changes to the
volume during snapshot image backup.
System action: Processing stopped.
User response: If the problem persists please increase
the SNAPSHOTCACHESize and/or change the value
of the SNAPSHOTCACHELocation.
ANS1347E

The image snapshot operation failed.

The percent of space to use, specified
via the SNAPSHOTCACHESize, has
been exceeded.

Explanation: When jobs are run in the background,

the client cannot prompt for the key.

Explanation: TSM was not able to take a snapshot of

the specified volume. The percent of space allotted via
the SNAPSHOTCACHESize option was not enough to
perform this snapshot image backup. This could be due
to an unexpected amount of disk activity which is
generating more changes than can be contained in the
allotted space at this particular point in time. Another
reason for this failure can be that the specified
SNAPSHOTCACHESize is not set to a large enough
value to handle the usual amount of changes to the
volume during snapshot image backup.

System action: Processing stopped.

System action: Processing stopped.

User response: Run the Job in the foreground.

User response: If the problem persists please increase

the SNAPSHOTCACHESize or, for Windows, change
the value of the SNAPSHOTCACHELocation.

System action: The command is terminated.

User response: Run the command without the
specified option. Alternatively, run the command with
the other option added.
ANS1344E

Job is running in the background.

Cannot prompt for the Key.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

61

ANS1348E

Unable to satisfy the

SNAPSHOTFSIDLEWait and
SNAPSHOTFSIDLERetries options due
to volume write activity.

Explanation: TSM was not able to take a snapshot of

the specified volume. The Logical Volume Snapshot
Agent was not able to satisfy the
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
options before starting the snapshot of the specified
volume.

ANS1352E

The session is rejected. Your password

has expired.

Explanation: Your TSM password has expired.

System action: TSM canceled the current operation.
You are not allowed to connect to the server until the
password is updated.
User response: Update your password. You may use
the SET PASSWORD command, or have the TSM
administrator update your node.

System action: Processing stopped.

User response: If the problem persists please modify
the SNAPSHOTFSIDLEWait and
SNAPSHOTFSIDLERetries options to better fit the
normal disk write activity of the volume being backed
up.
ANS1349E

An error occurred during Logical

Volume Snapshot Agent snapshot
processing.

Explanation: An unrecoverable error occurred during

snapshot processing. This can be caused by a variety of
errors, so the error and system event logs should be
checked for additional messages.
System action: Processing stopped.
User response: Check the client error log and the
system event log for any other messages that might
help identify the problem. Try the operation again. If
the problem persists, contact IBM technical support for
further assistance.
ANS1350E

The logical volume snapshot agent

(LVSA) is currently busy performing a
snapshot on this same volume.

Explanation: Another IBM Tivoli Storage Manager

process is already performing a snapshot of this
volume.
System action: The operation is stopped.
User response: Please wait until the other IBM Tivoli
Storage Manager process finishes with the volume and
then retry the operation.
ANS1351E

Session rejected: All server sessions are

currently in use

Explanation: TSM has all available sessions in use and

cannot accept a new one at this time.

ANS1353E

Session rejected: Unknown or incorrect

ID entered

Explanation: The node name you entered is not

known by the server, or you are attempting to access a
file migrated to a different node.
System action: TSM canceled the current operation.
You are not allowed to connect to the server until your
node name is registered with the server. If attempting
to access a migrated file, your node name must be the
same node which migrated the file.
User response: Ensure that you entered your TSM
node name correctly. If yes, see your system
administrator. Verify that the server is using closed
registration and that your node name is registered with
the server.
ANS1354E

Session rejected: Duplicate ID entered

Explanation: Another process using this node name is

active with the server.
System action: TSM cannot connect to the server. TSM
canceled the current operation.
User response: If you are running a UNIX-based
system, ensure that another process is not active with
TSM under the same name. Also, ensure that your
node name is unique to the server so that it cannot be
used by another person. See your system administrator
to identify the owner of that node name.
ANS1355E

Session rejected: Server disabled

Explanation: The server is in a disabled state and

cannot be accessed for normal activity.
System action: TSM canceled the current operation.
User response: Retry the operation after the server
returns to an enabled state. If the problem continues,
see your system administrator.

System action: TSM canceled the current operation.

User response: Retry the operation. If the problem
continues, see your system administrator to increase the
number of concurrently active sessions to the server.

62

ANS1356E

The server is not configured to allow

open registration

Explanation: No authorization. Registration is

required by your system administrator. The server is
not configured to allow open registration.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Session not started.

ANS1362S

User response: You must obtain a TSM node and

password from your system administrator.
ANS1357S

Session rejected: Downlevel client code

version

Explanation: The server version and your client

version do not match. The client code is downlevel.

SLM LICENSE EXCEEDED: The client

licenses for TSM are exceeded. See your
system administrator.

Explanation: Adding a new enrollment will exceed the

product license count for TSM.
System action: Execution of the client enrollment or
connection request ends.
User response: See your system administrator.

System action: TSM canceled the current operation.

User response: See your system administrator to see
what version of TSM to run for your location.

ANS1363E

ANS1358S

Explanation: The server does not have enough

memory to allow your client to establish a connection
with the server.

Session rejected: Downlevel server code

version

Explanation: The server version and your client

version do not match. The server code is downlevel.
System action: TSM canceled the current operation.
User response: See your system administrator to see
what version of TSM to run for your location.

System action: Session was not started.

User response: Retry later or see your system
administrator.
ANS1364E

ANS1359E

Session Rejected: The specified node

name is currently in use

Explanation: The node name you specified is in use

on the server.
System action: Session was not started.
User response: The server is probably performing a
task that prevents your node from establishing a
session. Retry later or check with your system
administrator.
ANS1360I

Compressed Data Grew

Explanation: The size of the file after compression is

greater than the size of the file before compressed.
System action: Even though the size of the file
increased, the file is compressed.

Session Rejected: The specified node

name is currently locked

Explanation: The node name you specified is currently

locked on the server.

Session Rejected: The server does not

have enough recovery log space to allow
a connection to be established.

Explanation: The server ran out of recovery log space.

System action: Session was not started.
User response: This error is a temporary problem.
Retry later or see your system administrator.
ANS1365E

Session Rejected: The server does not

have enough database space to allow a
connection to be established.

Explanation: The server ran out of database space.

System action: Session was not started.
User response: See your system administrator.
ANS1366E

User response: None.

ANS1361E

Session Rejected: The server does not

have enough memory to allow a
connection to be established.

The session is rejected. The TSM server

has an internal error.

Explanation: The client cannot establish a connection

to the TSM server because of an internal server error.
System action: The session was not started.
User response: Notify your TSM administrator of this
error.

System action: Session was not started.

User response: Check with your system administrator
to find out why your node name is locked.

ANS1367E

The client is unable to sign on to the

TSM server because the server does not
allow sign-on of Unicode clients.

Explanation: The client is not allowed to connect to

the TSM server.
System action: The session does not start.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

63

User response: Contact your TSM administrator for

assistance in configuring a working TSM client for your
environment.

User response: Ensure that the node name is correct

in the client options file. Make sure to use a node of
type NAS only with the nasnodename option.

ANS1368S

ANS1373W

Session Rejected: The server is not

licensed for this platform type. See your
system administrator.

Explanation: The server is not licensed for the

requesting client type.
System action: Execution of the client enrollment or
connection request ends.
User response: See your system administrator.
ANS1369E

Session Rejected: The session was

canceled by the server administrator.

Explanation: The server administrator canceled the

current client session.
System action: Execution of the client connection
request ends.
User response: See your system administrator.
ANS1370E

The user ID entered does not have the

correct level of authority to access the
client machine.

Explanation: The user ID entered cannot access this

TSM client.
System action: The TSM operation ends.
User response: Grant authority to this user ID on the
TSM server so that it can access this TSM client.
ANS1371E

File '' cannot be reconstructed from

subfile components.

Explanation: An error occurred while reconstructing

this file from its subfile components.
System action: The file indicated in the message is not
restored. Restore for all other files continues.
User response: Try to restore the file again by
selecting the file for restore from the user interface. You
can also check the client error log and the server
activity log for any messages related to the file
indicated in the message.
ANS1372E

An inconsistency was detected between

the client node and the node that is
registered to the TSM server.

Explanation: The user has probably coded the node

option incorrectly. For instance, the node that is
registered to the TSM server might be a type of NAS,
but the node is actually a non-NAS client.
System action: The TSM operation ends.

64

The PRESNAPSHOTCMD command for

volume filespace completed with a
non-zero return code.

Explanation: The command specified by the

PRESNAPSHOTCMD option must complete
successfully in order to perform the snapshot
backup/archive operation. If the command completed
with a return code of 0 (zero), it has completed
successfully. If the command completed with any other
return code, it has failed. If the command failed, then
the backup is still performed, but without the benefit of
the snapshot technology.
System action: The client executes the backup/archive
operation, but without using a snapshot.
User response: Identify and fix the problem that
caused the command to fail. If a non-zero return code
is normal for this command, then consider wrapping
the command in a script that always exits with a return
code of zero.
ANS1374W

The POSTSNAPSHOTCMD command

for volume filespace completed with a
non-zero return code.

Explanation: The command specified by the

POSTSNAPSHOTCMD option completed with a
non-zero return code. The snapshot-based backup
operation yields a return code of at least 8.
System action: The snapshot-based backup operation
continues.
User response: Identify and resolve the problem that
caused the post-snapshot command to fail. If a
non-zero return code is normal for this command, then
consider wrapping the post-snapshot command in a
script that always exits with a return code of zero.
ANS1375W

File FilesystemPathFileName skipped by

user

Explanation: You requested that this file be skipped

during the current operation.
System action: The file is skipped during the current
operation
User response: None.
ANS1376E

Error processing 'filespace

namepath-namefile-name'; end-to-end
digest validation failed.

Explanation: Cryptographic digest of the restored or

retrieved data did not match the digest generated
during the backup or archive operation. Possible causes

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

are a transmission error, data corruption, or a hash

collision.
System action: Processing stops
User response: Try the restore operation again. If the
problem persists, contact IBM technical support for
additional assistance.
ANS1377W

The client was unable to obtain a

snapshot of 'volname'. The operation will
continue without snapshot support.

Explanation: TSM client was unable to create a

snapshot of the volume due to some reason. Instead of
failing the operation, TSM client will perform a
non-snapshot based backup.

v The SNAPSHOTCACHELocation is not large enough

to handle the usual amount of changes to the
volume.
v The specified SNAPSHOTCACHESize is not set to a
large enough value to handle the usual amount of
changes to the volume during snapshot backup or
archive operation.
System action: Processing stopped.
User response: If the problem persists, increase the
SNAPSHOTCACHESize or change the value of the
SNAPSHOTCACHELocation.
ANS1380W

System action: Snapshot processing stops.

User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1378E

The snapshot operation failed. The

SNAPSHOTCACHELocation does not
contain enough space for this snapshot
operation.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume. The
SNAPSHOTCACHELocation points to a location which
does not contain the space necessary to manage the
snapshot. Reasons for failure include:
v An unexpected amount of disk activity which is
generating more changes than can be contained in
the available space at this particular point in time.
v The SNAPSHOTCACHELocation is not large enough
to handle the usual amount of changes to the
volume.
v The specified SNAPSHOTCACHESize is not set to a
large enough value to handle the usual amount of
changes to the volume during snapshot backup or
archive operation.
System action: Processing stopped.
User response: If the problem persists, increase the
SNAPSHOTCACHESize or change the value of the
SNAPSHOTCACHELocation.
ANS1379E

The snapshot operation failed. The

percent of space to use for the
SNAPSHOTCACHELocation, specified
via the SNAPSHOTCACHESize, has
been exceeded.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume. The percent
of space allotted via the SNAPSHOTCACHESize option
was not enough to perform this snapshot
backup/archive operation. Reasons for failure include:

The snapshot operation failed. The

filesystem write activity prevented the
Logical Volume Snapshot Agent from
satisfying the SNAPSHOTFSIDLEWait
and SNAPSHOTFSIDLERetries options.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume. The Logical
Volume Snapshot Agent was not able to satisfy the
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
options before starting the snapshot of the specified
volume.
System action: Snapshot processing stops.
User response: If the problem persists, modify the
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
options to better fit the normal disk write activity of
the volume being backed up.
ANS1381W

On volumes that are RAW or formatted

FAT32 the snapshot cache location
cannot be located on the same volume
that is being backed up.

Explanation: When the snapshot cache location is

located on the same volume that is being backed up the
volume must be formatted with NTFS. The default
cache location is on the same volume where the
snapshot is being performed. The operation will
continue without snapshot support.
System action: The client does not execute the
snapshot operation.
User response: Specify a different snapshot cache
location, using the SNAPSHOTCACHELOCATION
option.
ANS1382E

Server does not allow client-initiated

connections for this node.

Explanation: The node is not allowed to initiate

connections due to the configuration parameters for
this node on the server. Server is able to initiate
connections to the client scheduler running in
prompted mode.
System action: The IBM Tivoli Storage Manager
operation ends.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

65

User response: Contact your systems administrator to

enable client-initiated sessions for your node or update
the SESSIONINITIATION option and run the client
scheduler.

User response: Try the operation again with fewer

objects in the transaction, or increase the
TXNGROUPMAX value on the server.
ANS1388E

ANS1383E

Wrong server port.

Explanation: You were trying to open a

backup/archive client session on the server port set up
for administrative sessions only.
System action: The IBM Tivoli Storage Manager
operation ends.
User response: Contact your systems administrator
and/or use the correct values for TCP port and TCP
Admin Port.
ANS1384E

An object in the transaction has been

bound to an invalid management class.

Explanation: One of the objects in the transaction is

bound to a management class that is not part of this
node's policy, or the management class type is not
supported for this client level.
System action: The current operation ends.
User response: Make sure all objects are bound to a
valid management class, or upgrade the client to the
proper level.
ANS1385E

This server does not support backup

operations.

Explanation: This server only supports archive

operations, backup is not allowed.
System action: Current operation ends.
User response: Use only archive operations with this
server.
ANS1386E

Deleting this object: "fshlll" is not

allowed.

Explanation: The object is either under a hold and

cannot be deleted, or it is on a retention-protection
enabled server and has not expired.
System action: The object is skipped and processing
continues.

fshlll is already under hold.

Explanation: The specified object is already under

hold, and it cannot be placed under a new hold.
System action: This object is skipped and processing
continues.
User response: Issue a query to see the status of the
objects, and try the operation again, without the object
that is already held.
ANS1389W

Invalid option (option) for the scheduled

function command

Explanation: There are two possible reasons for this

message:
v The option option was specified for a scheduled
command or subcommand (function) that cannot
make use of that option.
v The option appears on a scheduled command but is
valid only on the client scheduler initial command
line, not on commands in a schedule from the server.
System action: The option is ignored.
User response: See the Backup-Archive Client
Installation and User's Guide for correct use of the
named option. The system administrator should
remove the invalid option from the schedule definition
on the server.
ANS1390I

A TSM authorized user must configure

the TSM client acceptor daemon and the
TSM client scheduler.

Explanation: The installation of the TSM client

acceptor daemon requires access to system locations,
which require full access to the system. The TSM client
acceptor daemon is installed as a startup item in
/Library/StartupItems, and a link is added to /usr/bin
for the dsmcad tool.
System action: The setup assistant cannot be used to
configure the IBM Tivoli Storage Manager scheduler or
the TSM client acceptor daemon.

User response: Check the status of the object through

a query to see if it is held, or when it expires.

User response: To acquire this access, system

administrators must use the "TSM Backup for
Administrators" application.

ANS1387E

ANS1391W

The number of objects in this

transaction exceed TXNGROUPMAX
values.

Explanation: There are too many objects in this

transaction.
System action: Current operation ends.

66

The TCA file permissions are not

correct.

Explanation: The TCA is a tool used by TSM to

provide secure access to the password file for
non-administrators. If the permissions are not set
correctly, and PASSWORDACCESS GENERATE is set,
TSM cannot be used.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Processing continues.

User response: Contact your system administrator so
the permissions can be corrected. A System
Administrator should use the "TSM Backup for
Administrators" application to update the permissions.
ANS1392W

The TCA file permissions are not

correct. Would you like to update the
permissions?

Explanation: The TCA is a tool used by TSM to

provide secure access to the password file for
non-administrators. If the permissions are not set
correctly, TSM cannot be used. The dsmtca application
needs to be owned by root and have 4755 permissions.
System action: If you select yes, TSM will set the
owner of the TCA to root and the permissions to 4755.
If you select no, the permissions will not be changed.
In either case, processing continues.
User response: Select yes when you are prompted so
TSM can repair the permissions of the file. If you select
no, PASSWORDACCESS GENERATE will not work for
non-TSM Authorized users.
ANS1393W

The command line tools are not

installed. The command line tools
include the TSM client acceptor daemon
and the TSM client scheduler.

Explanation: The command line tools are required for

the IBM Tivoli Storage Manager scheduler. The
'dsmcad' application or the 'put in /Library/
Startupitems' folder could not be located.
System action: The setup assistant cannot be used to
configure the IBM Tivoli Storage Manager scheduler.
User response: A System Administrator must reinstall
IBM Tivoli Storage Manager the command line tools.
ANS1394E

The node name contains periods. Would

you like to remove them? Select "no" if
this is an existing node name.

Explanation: A node name with periods complicates

the management of the node.
System action: IBM Tivoli Storage Manager prompts
to remove the periods.
User response: Respond to the prompt. If this is a
new node, select "yes", so the node is created without
the periods in the name. For existing nodes, select "no",
so the node name is not changed.
ANS1395E

The destination filespace or drive letter

is unavailable. The following object was
not processed: Filespace:'filespace-name'

Explanation: The system is trying to restore or retrieve

to a destination that cannot be reached. The specified

filespace name or drive letter is not valid, or does not

exist, or you are specifying a local share name that
cannot be resolved.
System action: Objects which are part of this filespace
are not processed.
User response: Try the command again, and specify a
different destination for the object that was not
processed.
ANS1396E

Access to the specified log or trace file

(filename) is denied.

Explanation: Access to the specified file is denied. You

specified a log or trace file name that cannot be written
by the current user.
System action: Processing stops.
User response: Ensure that you specified the correct
file or directory name, correct the permissions, or
specify a new location.
ANS1397W

The snapshot cannot be taken because

the SNAPSHOTCACHELocation does
not have enough space for this snapshot
operation.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume. The
SNAPSHOTCACHELocation points to a location which
does not contain the space necessary to create the
snapshot; the disk is probably full. The operation
continues without snapshot support.
System action: The client does not execute the
snapshot operation.
User response: Change the value of the
SNAPSHOTCACHELocation, or clean the disk to which
the SNAPSHOTCACHELocation points.
ANS1398E

Initialization functions cannot open one

of the Tivoli Storage Manager logs or a
related file: log-name. errno = errno-value,
reason

Explanation: The file "log-name" could not be opened

during initialization. The system set the error code
errno-value. If the reason given is "access denied," the
current user does not have permission to write to the
log in the directory specified. It is also possible that no
space is available at the given log location.
On Unix systems, the log must not be in the root
directory. Attempts to do so will result in an "access
denied" error.
System action: Processing terminates.
User response: Set the DSM_LOG (or DSMI_LOG)
environment variable to a directory into which the
current user can write. You may also use the
ERRORLOGNAME option to specify a file to which the
Chapter 2. ANS 0001-9999: Client messages, version 6.3

67

current user has write permission.

ANS1399W

The logical volume snapshot agent

(LVSA) is currently busy performing a
snapshot on this same volume.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume because
another process is already performing a snapshot of
this volume. The operation continues without snapshot
support.

ANS1403E

Explanation: An error occurred while loading a

dynamic link library. The DLL load failed.
System action: Processing stopped.
User response: Verify that your system software is up
to date and that all DLLs required by the TSM client
are present.
ANS1404E

System action: Snapshot processing stops.

User response: Wait until the other IBM Tivoli Storage
Manager process finishes with the volume and then try
the operation again.

Error loading a required filename DLL

Error loading one or more functions

from a required filename DLL

Explanation: An error occurred while loading a

function from a dynamic link library. The DLL load
failed.
System action: Processing stopped.

ANS1400W

The snapshot cache location is not valid.

Explanation: The snapshot cache location must point

to a local volume that is formatted with NTFS. The
default cache location is on the same volume where the
snapshot is being performed. The operation will
continue without snapshot support.
System action: Snapshot processing stops.
User response: Specify a different snapshot cache
location using the SNAPSHOTCACHELOCATION
option.
ANS1401W

The snapshot virtual volume is not

accessible.

Explanation: The logical volume snapshot agent

(LVSA) cannot access the virtual volume during
OFS-enabled backup/archive operation because IBM
Tivoli Storage Manager was probably started via
terminal services. The operation continues without
snapshot support.
System action: Snapshot processing stops.
User response: Do not use terminal services for the
snapshot. Try the operation again on the local machine.
ANS1402W

The snapshot is not supported on a

remote, removable, or SAN drive.

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume because
open file support is only supported on local fixed
volumes, including volume mountpoints. The operation
continues without snapshot support.
System action: The client does not execute the
snapshot operation.
User response: To take advantage of the open file
support, you may try the operation again on the local
machine.

User response: Verify that your system software is up

to date.
ANS1405I

'service-name' service needs to be

restarted.

Explanation: The service must be restarted for the

restored changes to take effect.
System action: Changes are not effected.
User response: Restart the service.
ANS1406I

Performing operation using

point-in-time copy of the filesystem:
'volname'.

Explanation: IBM Tivoli Storage Manager is taking a

snapshot of the specified volume during the backup or
archive operation. This allows the IBM Tivoli Storage
Manager to access locked or in-use files.
System action: Operation proceeds.
User response: None.
ANS1407I

Performing operation using

point-in-time copy of the filesystem.

Explanation: IBM Tivoli Storage Manager is taking a

snapshot of the specified volume during the backup or
archive operation. This allows the IBM Tivoli Storage
Manager to access locked or in-use files.
System action: Operation proceeds.
User response: None.
ANS1408W

Previous changes have not been

commited. The machine must be
restarted before the snapshot can be
taken

Explanation: IBM Tivoli Storage Manager was not able

to take a snapshot of the specified volume because a

68

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

previous operation required the machine to be restarted

for the changes to take effect, but the machine has not
been restarted. The operation will continue without
snapshot support.
System action: The client does not execute the
snapshot operation.
User response: Restart the machine and then try the
operation again.
ANS1409E

The remote copy process process ID on

server could not be canceled.

Explanation: A remote copy operation with process id

process ID, which is in progress on server, could not be
canceled. Check your error log to see cause of failure.
System action: None.

include AUX, CON, NUL, PRN, COMx or LPTx, where

'x' is any digit from 1 to 9 (for example, COM1, LPT3,
etc.).
System action: The file is skipped.
User response: Either delete the file if you do not
need it, or else use an EXCLUDE statement in the client
options to prevent the client from trying to process the
file. In the Windows environment, normal delete
commands will most likely not work. You will need to
prefix the file name with the characters '\\.\'. For
example, "del c:\mydir\lpt4" will not work, but "del
\\.\c:\mydir\lpt4" will work.
ANS1414W

Don't have sufficient authority to delete

open group on server.

User response: Contact your TSM administrator.

Explanation: An open image group exists on the TSM

server and cannot be deleted due to missing backup
delete rights for this node.

ANS1410E

System action: Processing continues.

Unable to access the network path.

Explanation: The network path cannot be accessed

due to a possible network problem.

User response: Ask your TSM administrator to grant

backup delete rights for your node.

System action: The client terminates.

User response: Ensure that the network is up and the
path can be accessed using a system command, and
retry the operation.
ANS1411E

A communication session was dropped.

Explanation: A communication session was dropped

due to a possible network problem.
System action: The client terminates.
User response: Ensure that the network is up and
retry the operation.
ANS1412E

Directory or file has bad EA data or

inconsistent data.

Explanation: Directory or file has bad EA data or

inconsistent data.
System action: The client terminates.
User response: Check failing directory or file for bad
EA data. Copy the directory to a new location and retry
the operation.
ANS1413W

File 'filespace namepath-namefile-name' is

not recognized by the system as a disk
file and cannot be processed. The file is
skipped.

Explanation: The client is unable to process file types

that are not 'disk', such as 'character' and 'pipe'. This
message is typically, but not always, issued for file
names that are normally reserved for the operating
system. In the Windows environment, reserved names

ANS1417W

Protected system state file 'filename' is

backed up to the drive file space, not
system state file space.

Explanation: Files protected by Microsoft Windows

File Protection (WFP) or Microsoft Windows Resource
Protection (WRP) are part of the Microsoft Volume
ShadowCopy Services (VSS) System Writer which is
part of the system state. These files are normally
backed up as part of the system state, not the file
system on which the files reside. A problem in the
operating system environment prevented the protected
file named in the message text from being enumerated
as a system state file and thus backed up as part of the
system state. The conditions that lead to this message
are not normal. In order to ensure that the file is
protected, it is backed up as part of the file system on
which it resides.
System action: The file is backed up as part of the file
system on which it resides.
User response: It is possible to restore the system
using the file system and system state backups.
However the conditions that prevent the system state
files from being correctly enumerated should be
addressed. On Microsoft Windows 2008 and Microsoft
Windows 2008 R2 you can use the DiskShadow utility
sub-command LIST WRITERS DETAILED to enumerate
the system state files. On other versions of Microsoft
Windows you can use the vshadow utility with the
-wm2 option to enumerate the system state files. Verify
that the file indicated in this message is not listed.
Note: vshadow is a utility that you can obtain from
Microsoft. After confirming that the files are not
enumerated, contact your operating system technical
support for help to diagnose and resolve the issue that
Chapter 2. ANS 0001-9999: Client messages, version 6.3

69

prevents the file from being correctly enumerated as

part of the system state.
ANS1418W

A call to TSM API API-name failed.

without server-free data movement.

User response: None.
ANS1423W

Explanation: An unexpected error occurred while

performing server-free data movement.
System action: The requested operation will be retried
with out server-free data movement.
User response: Contact your TSM administrator to
correct problems with server-free data movement.
ANS1419W

Remote copy operation for volume

filespace-name failed or could not be
restarted, return code retcode.

Explanation: An error occurred on server when

starting or during the remote copy operation for
volume filespace-name.
System action: The requested operation will be retried
with out server-free data movement.
User response: Contact your TSM administrator to
correct problems with server-free data movement.
ANS1420E

Volume map document (tsmvolmap.txt)

not found.

Explanation: An error occurred while performing VSS

Automated System Recovery (ASR). Check
dsmerror.log for more information.

Explanation: Tivoli Storage Manager HSM does not

support virtual mount points within managed file
systems. Files in the virtual mount point folder can not
be migrated.
System action: Tivoli Storage Manager attempts to
continue the current operation.
User response: Do not use virtual mount points
within file systems that are managed by HSM. Use
include/exclude rules instead.
ANS1424W

ANS1421E

The image object 'object-type' was not

found on server.

Explanation: The specified image object of type

object-type could not be located on the server. The
operation cannot complete without this object.
System action: The operation ends.
User response: Examine the client error log for
additional messages that might indicate the reason for
the problem. Take any corrective action suggested by
the messages, then try the operation again. If the
problem persists, contact IBM technical support for
further assistance.
ANS1422W

The image data for volume filespace-name

is either compressed or its compression
information can not be determined.

Explanation: The image data was backed up either

with compression or by an older client version. This
data format cannot be restored on server-free path.
System action: The requested operation will be retried

70

Retrying failed image operation for

volume filespace-name.

Explanation: The transaction for image operation for

volume filespace-name failed due to reason described by
earlier message(s).
System action: The requested image operation will be
retried again.
User response: None.
ANS1425E

System action: Processing stops.

User response: Ask your system administrator to
check the error log.

'filesystem' is a virtual mount point.

Migration is not supported on virtual
mount points.

The image operation for volume

filespace-name cannot be retried because
of a severe error.

Explanation: None.
System action: The image operation fails for the
indicated volume.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1426E

An error occurred creating the Registry

backup directory structure

Explanation: The TSM client uses an intermediate

directory structure on the client machine as part of the
Windows Registry backup process. The client was
unable to create this intermediate directory structure, so
the Windows Registry could not be backed up. This
problem can occur if you do not have sufficient
privileges to perform the backup operations, if the
client is unable to allocate more memory from the
system, or if a component within the directory
structure already exists as a file.
System action: The Windows Registry is not backed
up.
User response: Check the client error log for any other
messages that might have been logged when this

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

message was written, and take the corrective action (if

any) suggested by those messages. Make sure that
account under which the operation runs has sufficient
privileges. Ensure that the system has sufficient
memory to run TSM. Remove the ADSM.SYS directory
from the root of your system drive, then try the
operation again. If the problem persists, contact IBM
support for further assistance.
ANS1427I

Registry Backup function completed

successfully.

ANS1432E

Explanation: A registry command was incorrectly

entered.
System action: Registry function is not invoked.
User response: Refer to the command reference for
this command.
ANS1433E

Explanation: Registry backup was successful.

System action: None.
User response: Continue with normal operations.
ANS1428E

Backup of the registry failed.

Keyword Expected after keyword

'keyword'.

Extraneous argument 'input' after

keyword 'keyword'

Explanation: A registry command was incorrectly

entered.
System action: Registry function not invoked.
User response: Refer to the command reference for
this command.

Explanation: None.
System action: The registry is not backed up.

ANS1434E

User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

Explanation: A registry command was incorrectly

entered.

ANS1429I

User response: Refer to the command reference for

this command.

Registry Restore function completed

successfully.

Explanation: Registry Restore was successful.

System action: None.
User response: Continue with normal operations.
ANS1430W

The machine must be rebooted for the

changes to take effect.

Explanation: The TSM restore operation made changes

that will not be in effect until the machine is rebooted.
It is important to note that until the reboot occurs, the
system or its applications might be unstable.
System action: None
User response: Reboot the machine as soon as
possible after the TSM restore operation ends.
ANS1431E

Restore of the registry failed.

Explanation: None.
System action: The registry is not restored.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

Invalid argument 'input' after keyword

'keyword'

System action: Registry function not invoked.

ANS1435E

An error occurred saving a registry key.

Explanation: None.
System action: The registry is not backed up.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1436E

An error occurred replacing a registry

key.

Explanation: None.
System action: The registry key is restored from the
server, but cannot be activated in the registry. The
current registry key remains active.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1437I

Event Log Backup function completed

successfully.

Explanation: Event Log backup was successful.

System action: None.
User response: Continue with normal operations.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

71

ANS1438E

Backup of the event logs failed.

ANS1444E

Explanation: None.
System action: The event logs are not backed up.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1439I

Event Log Restore function completed

successfully.

Explanation: Event Log Restore was successful.

System action: None.
User response: Continue with normal operations.
ANS1440E

Restore of the event logs failed.

Explanation: None.
System action: The event logs are not restored.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.

Explanation: The TSM client uses an intermediate

directory structure on the client machine as part of the
Windows Event Log backup process. The client was
unable to create this intermediate directory structure, so
the Windows Event Logs could not be backed up. This
problem can occur if you do not have sufficient
privileges to perform the backup operations, if the
client is unable to allocate more memory from the
system, or if a component within the directory
structure already exists as a file.
System action: The Windows Event Logs are not
backed up.
User response: Check the client error log for any other
messages that might have been logged when this
message was written, and take the corrective action (if
any) suggested by those messages. Make sure that
account under which the operation runs has sufficient
privileges. Ensure that the system has sufficient
memory to run TSM. Remove the ADSM.SYS directory
from the root of your system drive, then try the
operation again. If the problem persists, contact IBM
support for further assistance.
ANS1445E

ANS1441E

Keyword Expected after keyword

'keyword'.

Explanation: A event log command was incorrectly

entered.

An error occurred creating the Event Log

backup directory structure

ERROR: could not create NAS image

object.

Explanation: Creation of the NAS image object failed

for one of following reasons:
v An unauthorized user invoked the NAS command

System action: Event Log function is not invoked.

v NAS operations are not supported on the current

platform

User response: Refer to the command reference for

this command.

v Cannot find the NAS plugin library.

ANS1442E

Extraneous argument 'input' after

keyword 'keyword'

Explanation: A event log command was incorrectly

entered.
System action: Event Log function not invoked.
User response: Refer to the command reference for
this command.
ANS1443E

Invalid argument 'input' after keyword

'keyword'

Explanation: A event log command was incorrectly

entered.
System action: Event Log function not invoked.
User response: Refer to the command reference for
this command.

System action: The requested NAS operation is not

performed.
User response: Retry the operation after correcting the
cause for failure.
ANS1446E

VSS ASR backup document

(ASRBackupDoc.xml) not found.

Explanation: An error occurred while performing VSS

Automated System Recovery (ASR). Check
dsmerror.log for more information. Possible causes for
the error are the following:
v You are trying to recover a machine running a legacy
operating system such as windows XP or windows
2003. VSS ASR Restore is not supported for legacy
operating systems.
v You are trying to run ASR recovery from a backup
created by a client earlier than version 6.2.2. Such
backups do not have ASRBackupDoc.xml file.
System action: Processing stops.

72

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Ask your system administrator to

check the error log.
ANS1447I

Current user does not need to back up

the default profile.

Explanation: You are currently using the default

profile, and there is no need to back it up.
System action: None.

ANS1453W

The IMAGEGAPSIZE option is not

supported for non-NTFS file systems.
The entire volume will be backed up.

Explanation: None.
System action: The entire volume is backed up.
User response: Refer to the client manual for
additional information regarding the IMAGEGAPSIZE
option.

User response: None.

ANS1454W
ANS1448E

The command command is not supported

by the current server.

Explanation: The server to which the client is

connected does not support the command.
1. If the command is "set event," the server does not
support event-based policy. This command requires
that the server support event-based policy. That
support is available only at TSM Server levels 5.2.2
and above.
2. If the message displays any other command, the
server is configured to support archive retention
protection and cannot process operations not
associated with that facility.
System action: The command is skipped and other
processing continues.
User response: Log in to an appropriate server and
retry the command.
ANS1449W

A non-critical, unexpected error was

encountered. Deletion of a
snapshot(Set/Volume) failed. Probable
cause, snapshot does not exists anymore.
Continuing Process... TSM snapShot ID
: snapshot-id TSM function name :
function-name TSM function :
function-desc TSM return code : TSM-rc
TSM file : file-name (line-number)

Explanation: None.
System action: Processing continues.
User response: Contact the TSM administrator with
the information provided in this message.
ANS1450W

The -FILENAME option was specified

without a file name. Output will be
written to filename.

Explanation: The -FILENAME option was specified,

but the file name was omitted.
System action: The output is written to the default
file.
User response: Reissue the command and specify a
valid file name, or use the information that was written
to the default file.

Used blocks information could not be

obtained for name. The entire volume
will be backed up.

Explanation: None.
System action: The entire volume is backed up.
User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS1455I

Resynching mirrors. Please wait.

Explanation: The destination volume for server-free

restore has mirrored layout. The mirrors are being
resynched after the data restored.
System action: Processing continues.
User response:
ANS1456I

Mirror synchronization completed.

Explanation: Synchronization of the volume's mirrors

completed successfully.
System action: Processing continues.
User response:
ANS1457E

Mirror synchronization failed.

Explanation: Synchronization of the volume's mirrors

failed.
System action: Processing stopped.
User response: Check the error log for more errors.
Contact your systems administrator.
ANS1458I

OBF file for volume name is too small

for server-free data transfer.

Explanation: The OBF file for volume is very small to

initiate a server-free data transfer. Hence this file will
not be transferred via a server-free data path.
System action: Processing continues.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

73

ANS1459E

VSS Automated System Recovery (ASR)

failed.

Explanation: An error occurred while performing VSS

Automated System Recovery (ASR). Check
dsmerror.log for more information.
System action: Processing stops.
User response: Ask your system administrator to
check the error log.
ANS1460W

The file segment size entered is greater

than the max size. Please increase the
max size or decrease the file segment
size.

Explanation: The user has enabled both trace

wrapping and trace spanning but has entered a
segment size greater than the max size.
System action: Allow the user to re-enter the max size
or reduce the segment size.
User response: The user should either increase the
max size or reduce the segment size.

API. If the problem still exists, contact TSM technical

support.
ANS1464S

Cannot load ICC encryption library.

Explanation: TSM is using cryptography library which

is installed automatically with the client and is being
loaded at runtime. The client cannot proceed if the
library is not loaded.
System action: Client exits.
User response: Check the error log for ANS1467E to
determine the cause of failure. Verify you TSM client is
installed properly. If needed, reinstall client and/or
API. If the problem still exists, contact TSM technical
support.
ANS1465E

Conflicting options ERRORLOGMAX

and ERRORLOGRETENTION were
specified.

Explanation: Values were specified for both the

ERRORLOGMAX and the ERRORLOGRETENTION
options. These options are mutually exclusive.
System action: Processing stops.

ANS1461E

Error processing 'filespace

namepath-namefile-name': unsupported
encryption type.

Explanation: The files you are trying to restore or

retrieve have been backed up or archived by a later
version of the TSM client. The file encryption method is
not supported by the current client.
System action: Object skipped.

User response: Specify a nonzero value for

ERRORLOGMAX if you wish to have the TSM error
log wrap when it reaches the specified maximum
value. Use ERRORLOGRETENTION if you wish you
have the error log limited in size on a time-based
schedule.
ANS1466E

User response: Restore or retrieve the file with the

most recent version of the TSM client.
ANS1462E

Unsupported encryption type

Explanation: The files you are trying to restore or

retrieve have been backed up or archived by a later
version of the TSM client. The file encryption method is
not supported by the current client.

Conflicting options SCHEDLOGMAX

and SCHEDLOGRETENTION were
specified.

Explanation: Values were specified for both the

SCHEDLOGMAX and the SCHEDLOGRETENTION
options. These options are mutually exclusive.
System action: Processing stops.

User response: Restore or retrieve the file with the

most recent version of the TSM client.

User response: Specify a nonzero value for

SCHEDLOGMAX if you wish to have the TSM
scheduler log wrap when it reaches the specified
maximum value. Use SCHEDLOGRETENTION if you
wish you have the scheduler log limited in size on a
time-based schedule.

ANS1463E

ANS1467E

System action: Object skipped.

Unexpected error in cryptography

library.

Explanation: There was an unexpected error in the

cryptography library. See the error log for more
information.
System action: processing stops.
User response: Check the error log for ANS1467E to
determine the cause of failure. Verify you TSM client is
installed properly. If needed, reinstall client and/or

74

ICC routine icc-routine returned: majRC

= majRC, minRC = minRC, desc = 'desc'.

Explanation: There was an error within an ICC

cryptography library. This message reports return codes
and problem description which can be used by TSM
technical support personnel to determine the cause of
the error.
System action: Client exits.
User response: Verify you TSM client is installed

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

properly. If needed, reinstall client and/or API. If the

problem still exists, contact TSM technical support.
ANS1468E

Backing up Automated System Recovery

(ASR) files failed. No files will be
backed up.

Explanation: An error occurred while backing up the

files needed for Automated System Recovery (ASR). No
files were backed up.
System action: Processing stops.
User response: Ask your system administrator to
check the error log. Verify that the Windows account
from which you are running this command has
administrator authority and try the command again.
ANS1469E

Error processing 'filespace

namepath-namefile-name'; invalid
encryption key.

Explanation: The key you entered does not match the

key that was used to encrypt the file during backup.
The file can not be restored unless the matching key is
entered.

ANS1472E

Could not add entry to the ASR system

information file. ASR backup is
unsuccessful.

Explanation: An error occurred while adding an entry

to the system information file (asr.sif) needed for
Automated System Recovery (ASR). The ASR backup is
unsuccessful.
System action: Processing stops.
User response: Ask your system administrator to
check the error log. Verify that the Windows account
from which you are running this command has
administrator authority and try the command again.
ANS1473E

Session rejected: TCP/IP connection

failure for Shared Memory

Explanation: An attempt to connect to the local server

using the Shared Memory protocol has failed during
initial TCP/IP communications. This error can occur if
the server is not listening on the correct port, or if the
server is down.
System action: Session rejected. Processing stopped.

User response: Try the restore operation again and

provide the correct key.

User response: Retry the operation, or wait until the

server comes back up and retry the operation. If the
problem continues, see your system administrator for
further help.

ANS1470E

ANS1474E

System action: processing stops.

Unable to load GPFS functions needed

for ACL and extended attributes
support: skip path_name

An error occurred using the Shared

Memory protocol

Explanation: The GPFS functions that handle the

GPFS ACL and extended attributes were not loaded.

Explanation: An error has occurred while reading or

writing data through the Shared Memory
communications protocol.

System action: The object is skipped. Processing

continues with the next object.

System action: TSM cannot complete the requested

operation.

User response: Ensure that the GPFS software is

installed on the system and try the operation again. On
Linux, iensure that there has been an appropriate
symbolic link created in /usr/lib/ directory for the
GPFS libgpfs.so shared library.

User response: Check the trace log for additional

information and retry the operation. If the problem
continues, see your system administrator for further
help.
ANS1475E

ANS1471E

ASR system information file creation

failed. ASR backup is unsuccessful.

Explanation: An error occurred while creating the

system information file (asr.sif) needed for Automated
System Recovery (ASR). The ASR backup is
unsuccessful.
System action: Processing stops.
User response: Ask your system administrator to
check the error log. Verify that the Windows account
from which you are running this command has
administrator authority and that you have access to the
system object staging directory <system drive>
:\adsm.sys. Try the command again.

Insufficient authority to connect to the

shared memory region

Explanation: The user issuing the command does not

have authority to connect to the shared memory
segment. When the shared memory segment is created
by the server, it will be owned by the effective uid of
the server process (dsmserv). Only processes running
under this uid or root will be allowed to connect to the
segment (and thus to the server).
System action: The session is rejected and processing
stops.
User response: Run the command under the uid of
the processing running dsmserv, if possible. Otherwise
contact your system administrator for further help.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

75

ANS1476E

CLUSTERNODE is set to YES but the

Cluster Information Daemon is
notstarted.

Explanation: The HACMP Cluster Information

Daemon must be started in order to specify the
CLUSTERNODE option.
System action: Processing ends.
User response: Start the HACMP Cluster Information
Dameon.
ANS1477E

CLUSTERNODE is set to YES but the

cluster load library is not valid.

Explanation: The load library that the operating

system provides to obtain the cluster name is not valid.
A possible cause is an out-of-date load library which
does not contain the proper routines this product
expects.
System action: Processing ends.
User response: Ensure that the latest cluster software
is installed on the system.
ANS1478E

CLUSTERNODE is set to YES but the

cluster software is not availableon this
system.

Explanation: The load library that the operating

systems provides to obtain the cluster name is not
available on this system.
System action: Processing ends.

ANS1481E

The CLUSTERNODE option is not

supported on this system.

Explanation: This option is not supported on this

system.
System action: Processing ends.
User response: Disable the CLUSTERNODE option in
the local options file.
ANS1482E

An unexpected error (retcode) occurred

while the program was trying to obtain
the cluster name from the system.

Explanation: An unknown error occurred while the

program was trying to obtain the cluster name from the
cluster service. The error code is the reason code
provided directly from the cluster service being used in
this operating system environment.
System action: Processing ends.
User response: Consult the documentation for your
clustering software for an explanation of the reason
code. Insure that your clustering service is operational,
then try the TSM operation again.
ANS1483I

Schedule log pruning started.

Explanation: The schedule log pruning function has

begun.
System action: The schedule log is pruned.
User response: None.

User response: Ensure that the cluster software is

installed on the system.

ANS1484I

ANS1479E

Explanation: The schedule log pruning function

completed with no errors.

CLUSTERNODE is set to YES but this

machine is not a member of acluster.

Explanation: This machine is not a member of a

cluster node. Possible causes are that the cluster service
has not been configured correctly, or that the cluster is
in the process of initialization.
System action: Processing ends.
User response: Ensure that the cluster software is
configured properly. If the cluster is in the process of
initialization, retry the operation at a later time.
ANS1480E

CLUSTERNODE is set to YES but the

cluster service is not enabledon this
system.

Explanation: The cluster service has not been enabled

on this system.

Schedule log pruning finished

successfully.

System action: None.

User response: None.
ANS1486E

An error occurred while restoring the

WMI repository. The database will not
be updated.

Explanation: The Windows event log and TSM error

log might contain additional information related to this
error.
System action: processing stops.
User response: Examine the Windows event log and
TSM error log for messages related to Windows
Management Instrumentation (WMI). Ensure that the
WMI is started.

System action: Processing ends.

User response: Enable the cluster service on the
system.

76

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1487E

An error occurred while backing up the

WMI repository. The database will not
be backed up.

Explanation: The Windows event log and TSM error

log might contain additional information related to this
error.
System action: processing stops.
User response: Examine the Windows event log and
TSM error log for messages related to WMI. Ensure
that the Windows Management Instrumentation service
is started.
ANS1489E

The WMI service failed to stop. No files

will be restored.

Explanation: An error occurred while stopping the

Windows Management Instrumentation (WMI) service.
The database will not be restored.
System action: processing stops.
User response: Examine the Windows event log and
TSM error log for messages related to Windows
Management Instrumentation (WMI). You might need
to quiesce WMI activity or reboot the machine in order
to free resources which are preventing the WMI service
from stopping.

system options file and make sure it exists in the file

system. Retry the operation.
ANS1493S

Explanation: The specified VIRTUALMOUNTPOINT

in the system options file is invalid because access to it
is denied.
System action: TSM attempts to continue the current
operation.
User response: Check the VIRTUALMOUNTPOINT in
the system options file and make sure it is accessible.
Retry the operation.
ANS1494S

File specification 'file-spec' ignored. A

file list has already been specified.

Explanation: A non-option argument (file

specification) was encountered after the -FILELIST has
been processed.
System action: The argument is ignored.
User response: You may have either a -FILELIST or
explicit file specifications on this command, but not
both.

System action: TSM attempts to continue the current

operation.
User response: Set the option FOLLOWSYMBOLIC to
YES in the user options file. Retry the operation.

System action: TSM attempts to continue the current

operation.
User response: Make sure the virtual mountpoint is a
directory and accessible from the shell, and retry the
operation.

Only one -FILELIST option allowed.

Explanation: The -FILELIST option may only be

specified once per command
System action: The command is not executed.
User response: Enter only one -FILELIST option on
the command.
ANS1492S

Invalid virtual mountpoint filespace-name:

File not found.

Explanation: The specified VIRTUALMOUNTPOINT

in the system options file is invalid because it could not
be found in the file system.
System action: TSM attempts to continue the current
operation.
User response: Check the virtual mountpoint in the

Invalid virtual mountpoint filespace-name:

Other error, rc = return-code.

Explanation: The specified VIRTUALMOUNTPOINT

in the system options file is invalid.

ANS1496W
ANS1491E

Invalid virtual mountpoint filespace-name:

Symbolic link.

Explanation: The specified VIRTUALMOUNTPOINT

in the system options file is invalid because it is a
symbolic link and FOLLOWSYMBOLIC is not set.

ANS1495S
ANS1490W

Invalid virtual mountpoint filespace-name:

Access denied.

Duplicate include/exclude option 'option

file-name' found while processing the
client options file. This might produce
unexpected results.

Explanation: TSM found a duplicate statement while

processing the client options file, which might produce
unexpected results.
System action: Processing continues.
User response: Verify if you obtained the desired
results. If not, you need to correct the client options file
by removing the duplicate option statement.
ANS1497W

Duplicate include/exclude option 'option

file-name' found while processing the
client options passed by the server. This
might produce unexpected results.

Explanation: TSM found a duplicate statement while

Chapter 2. ANS 0001-9999: Client messages, version 6.3

77

processing the client options by the server, which might

produce unexpected results.

dsm.install while logged in as the root user.

System action: Processing continues.

ANS1502E

User response: Verify if you obtained the desired

results. If not, you need to correct either the client
options file or the client options passed by the server.
ANS1498E

The IIS services failed to stop. No files

will be restored.

Explanation: An error occurred while stopping the

Internet Information Services (IIS) services. The
metabase will not be restored.

Explanation: The permissions of the Trusted

Communication Agent do not allow it to be accessed
by the user of the TSM client.
System action: TSM ends.
User response: See your system administrator.
ANS1503E

System action: processing stops.

User response: Examine the Windows event log and
TSM error log for messages related to Internet
Information Services (IIS). You might need to quiesce
IIS activity or reboot the machine in order to free
resources which are preventing the IIS service from
stopping.
ANS1499E

System action: The table of contents was not created.

User response: This abort code indicates there was a
problem creating a table of contents on the server. The
sysadmin will need to consult the activity log on the
server to determine the cause.

Explanation: The file containing the stored password

for the specified server server-name is unavailable.
System action: TSM ends.
User response: The administrator for your system
must set and store a new password.

Module dsmtca not found in secure

directory.

ANS1504E

System action: TSM ends.

User response: Probable system error. If the problem
persists, restart the workstation.
ANS1505W

System action: TSM ends.

User response: Log on as root user, then create a link
to dsmtca module in /usr/bin with the command: ln -s
/usr/tivoli/tsm/client/ba/bin/dsmtca
/usr/bin/dsmtca
Trusted agent execution/owner
permissions are invalid

Explanation: The Trusted Communication Agent

execution/owner permissions are invalid.
System action: TSM ends.
User response: Have your system administrator check
the installation instructions for the client to ensure that
the Trusted Communication Agent permissions are set
correctly. This error can be caused by installing TSM as
a non-root user. For the UNIX platforms that have the
installation program (dsm.install), you must run

78

Error starting the Trusted

Communication Agent process.

Explanation: An error has occurred starting the

Trusted Communication Agent process; specifically, the
fork() function has failed.

Explanation: TSM cannot find the Trusted

Communication Agent module (dsmtca) in the
appropriate directory.

ANS1501E

Valid password not available for server

'server-name'. The administrator for your
system must run TSM and enter the
password to store it locally.

Creation of table of contents failed.

Explanation: A failure occurred on the server during

creation of the table of contents.

ANS1500E

Access to system function required to

run has been denied

Performing image backup of the entire

volume for volume name. The
IMAGEGAPSIZE option value of image
gap size is being ignored as this level of
the operating system does not support
used block image backup. Please
upgrade to AIX 5.3 Maintenance Level 7
or later in order to perform used block
image backup.

Explanation: AIX 5.3 Maintenance Level 7 or later has

some necessary fixes that are required to support used
block image backup.
System action: The entire volume is backed up.
User response: Please upgrade to AIX 5.3
Maintenance Level 7 or later in order to perform used
block image backup.
ANS1506E

The TSM Trusted Communication Agent

received an invalid request.

Explanation: The Trusted Communication Agent is

invoked by the TSM client and has received an
unknown request argument in the call.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: TSM ends.

User response: It is possible the Trusted
Communication Agent was mistakenly invoked by a
process other than the TSM client. If that is not the
case, then this is an internal error. If the problem
recurs, contact your IBM service representative.
ANS1507E

This action requires TSM administrative

authority on this system.

Explanation: An activity has been attempted that must

be performed by the TSM administrator (for example,
open registration, filespace delete or password update).
System action: TSM ends.
User response: If the activity is required, the
administrator for this system must perform it.
ANS1508E

Error allocating semaphores.

Explanation: An error has occurred because the

semaphores you are attempting to allocate have become
insufficient.

ANS1511I

Invalid Restore session number entered.

Try again.

Explanation: You entered a number not shown in the

list of restartable restores. The number you entered is
either less than one or greater than the highest item
number displayed.
System action: TSM waits for you to enter a valid
selection.
User response: Enter a number from the list or 'Q' to
quit.
ANS1512E

Scheduled event 'event' failed. Return

code = value.

Explanation: One or more error conditions were

encountered that prevented the schedule from
completing successfully. This message is preceded by
other messages that indicate the specific problems
encountered during the operation.
System action: Scheduled event failed.

User response: Ask your system administrator for

assistance, and possibly increase the number of
semaphores in your system.

User response: Check the schedule and error log files

for the messages that specify what problems were
encountered during the operation. Correct the
conditions that caused those messages to be issued. The
specific corrective actions will depend on the specific
errors encountered.

ANS1509E

ANS1513E

System action: Processing ends.

Error setting semaphore value or

waiting on semaphore.

Explanation: An error has occurred while attempting

to set or wait on a semaphore.
System action: Processing ends.
User response: Probable system error. If the problem
persists, restart the workstation.
ANS1510I

The specified backupset either does not

exist, or does not contain file data.

Explanation: The specified backupset either does not

exist, or does not contain file data for the node name
specified. The restore backupset command is limited to
backupsets that contain file data. To restore an image
backup from a backupset, use the restore image
command.
System action: Processing stopped.
User response: If an incorrect backupset name was
specified, retry the command with the correct
backupset name. If you are trying to restore an image
from a backupset, refer to the restore image command
for the correct syntax.

The object 'object_name' is skipped from

rename. Error_condition.

Explanation: IBM Tivoli Storage Manager skips the

specified object from renaming because the object with
the same long name but with different attributes exists
on the server.
System action: The backup operation continues. The
specified object will expire during the next incremental
backup.
User response: The object is skipped if one of the
following condition occurs:
The long name object(LN) has a more recent insert
date than the short name object(SN).
The management classes for LN and SN do not
match.
The copy groups for LN and SN do not match.
LN and SN have different owners.
The creation date for LN and SN do not match.
The short name attribute for LN does not match
SN.
If you are unable to determine what is wrong, report
the problem to your service representative.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

79

ANS1514W

Encryption key passwords are not the

same.

ANS1522E

Explanation: The key passwords are different.

System action: TSM allows you to try again.
User response: Enter the correct password.

It is not possible to authenticate with

the client node client-node ! The Space
Management Agent version agent-version
running on client-node does not match
with the Space Management Console
version console-version you are running !

Explanation: A failure occurred on the server during

loading of the table of contents.

Explanation: The version of the Space Management

Console does not match with the version of the Space
Management Agent running on the client node
machine. To avoid incompatibleness it is necessary to
run the console and the agent with the same version.

System action: The table of contents was not loaded.

System action: The Space Management Console exits.

User response: This abort code indicates there was a

problem loading a table of contents on the server. The
sysadmin will need to consult the activity log on the
server to determine the cause.

User response: Use Space Management Console with

the same version like the Space Management Agent
running on the HSM node you want to manage.

ANS1515E

Loading a table of contents failed.

ANS1523E
ANS1519E

Your node does not have permission to

delete backup files

Explanation: The server does not allow your node to

delete backup files.
System action: TSM did not delete the backup files.
User response: See your system administrator.
ANS1520E

Failure writing to the Tivoli Storage

Manager error log: errno = errno-value,

Explanation: A failure was encountered when writing

to the dsmerror log or dsierror log. The system set the
error code errno-value. It is possible that no space is
available at the given log location.

Explanation: An error was encountered during a call

to the TSA/SMDR service. This message usually
follows previous messages that contain more specific
information about the problem.
System action: Processing stopped.
User response: Refer to previous messages in
dsmerror.log for further information. If those messages
are not helpful in identifying the cause of the problem,
see your system administrator for further assistance.
ANS1528I

System action: Processing terminates.

User response: Set the DSM_LOG (or DSMI_LOG)
environment variable to a directory with adequate
space to write the log data.
ANS1521E

Failure writing to a Tivoli Storage

Manager log or log-related file: file-name,
errno = errno-value, reason

Explanation: A failure was encountered when writing

to one of the log files or a related file named file-name.
The system set the error code errno-value. reason is the
system explanation of that error code. Among other
things, it is possible that no space is available at the
given log location.
System action: Processing terminates.
User response: Set the DSM_LOG (or DSMI_LOG)
environment variable to a directory with adequate
space to write the log data.

An error occurred while connecting to

TSA/SMDR service.

TSM is converting the log-file from

continuous (pruning) mode to wrapping
mode. This process may take several
minutes.

Explanation: The log-file was previously in continuous

mode where the only size control was through the use
of ERRORLOGRETENTION or
SCHEDLOGRETENTION option. This is the first
occasion where ERRORLOGMAX or SCHEDLOGMAX
is specified for this log, so its format must be changed
and old data saved.
System action: Transition processing continues.
User response: None.
ANS1529I

TSM is converting the log-file from

wrapping mode to continuous (pruning)
mode. This process may take several
minutes.

Explanation: The log-file was previously in wrapping

mode where the size control was through the use of the
ERRORLOGMAX or SCHEDLOGMAX option. This is
the first occasion where ERRORLOGMAX or
SCHEDLOGMAX is not specified for this log, so its
format must be changed and old data saved.
System action: Transition processing continues.

80

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: None.

ANS1530I

count log records processed.

ANS1536E

Proxy Rejected: The server has an

internal error.

Explanation: This is just a progress report to let you

know the process is still ongoing.

Explanation: The client cannot proxy to the node

named by the ASNODENAME option because of an
internal server error.

System action: Transition processing continues.

System action: TSM canceled the current operation.

User response: None.

User response: See your system administrator

immediately.

ANS1532E

Proxy Rejected: Proxy authority has not

been granted to this node.

Explanation: The node has not been granted proxy

authority to access the node named by the
ASNODENAME option. The TSM administrator must
first grant proxy authority.
System action: The TSM operation ends.
User response: The TSM server administrator must
grant proxy authority for this node. See the
administrator command "Grant Proxynode".
ANS1533E

Proxy Rejected: The node name you

specified in the ASNODENAME option
is locked.

Explanation: The TSM administrator has locked the

node you specified as the ASNODENAME option.
System action: The TSM operation ends.
User response: The TSM server administrator must
unlock the node before you can access it. Try the
operation later, or check with your TSM administrator.

ANS1537E

The ASNODENAME option is not valid

with the FROMNODE option.

Explanation: None.
System action: Processing stops.
User response: Remove the ASNODENAME option
from the options file or do not use the FROMNODE
option.
ANS1538E

The operation that is being attempted

cannot be invoked using the
ASNODENAME option.

Explanation: None.
System action: Processing stops.
User response: Remove the ASNODENAME option
and retry the operation.
ANS1539E

The ASNODENAME option cannot be

used with the CLUSTERNODE option.

Explanation: None.
ANS1534E

Proxy Rejected: The TSM server has run

out of memory.

Explanation: There is not enough memory available to

allow this operation to continue.
System action: TSM canceled the current operation.
User response: Try the operation again. If the problem
continues, see your system administrator to increase the
amount of memory of the server.
ANS1535E

Proxy Rejected: ASNODENAME and

NODENAME are identical.

Explanation: TSM does not allow the ASNODENAME

and NODENAME option values to be the same.
System action: TSM canceled the current operation.
User response: Use the ASNODENAME option only
to access another node. It is not necessary to set
ASNODENAME option to access your own node.
Remove ASNODENAME from your option file unless
you are actually trying to access a node that you have
been granted authority to access with the
administrative command "Grant Proxynode".

System action: Processing stops.

User response: Remove the ASNODENAME option
and retry the operation.
ANS1540E

Incremental backups using snapshot

difference is not supported on this
version of the NetApp file server.

Explanation: Incremental backup using Snapshot

difference requires Data ONTAP V7.3 or later. To back
up unicode file names, upgrade to Data ONTAP V7.3.3
or later or V8.1 or later.
System action: Processing stops.
User response: Upgrade the file server to a supported
level of Data ONTAP, then retry the operation.
ANS1541E

Node entered has been federated into a

Network Deployment, federated nodes
cannot be backed up.

Explanation: Node entered has been federated into a

Network Deployment, federated nodes cannot be
backed up.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

81

System action: None

User response: Run 'dsmc q was -wastype=local' to
see the nodes that may be backed up.
ANS1542E

Incorrect WAS backup type entered, no

node of that name and type exists.

Explanation: There is no node with the WAS backup

type that was entered.
System action: None
User response: Check the wastype that was entered.
Run 'dsmc q was -wastype=local' to see the nodes that
may be backed up.
ANS1543E

Incorrect WAS node entered, no node

exists with that name.

Explanation: There is no node with the WAS backup

type that was entered.
System action: None
User response: Check the node name that was
entered. Run 'dsmc q was -wastype=local' to see the
nodes that may be backed up.

is running. If the repository is locked, then unlock it

and try the operation again. Ensure that the correct
node is being backed up. To see a list of available
nodes that can be backed up, run: 'dsmc q was
-wastype=local'.
ANS1548E

Explanation: A supported version of WebSphere is not

installed on this machine. The only version of
WebSphere that is supported is 5.0.x.
System action: None
User response: Install WebSphere 5.0 on the machine.
ANS1549E

An error in WAS processing has

occurred.

Explanation: None.
System action: None
User response: Run the following command to see the
nodes that can be backed up: dsmc query was
-wastype=local Make sure the results are correct for
your environment, then try the operation again. If the
problem persists, contact TSM technical support for
further assistance.
ANS1546W

TSM failed to lock the WebSphere

configuration repository.

No application server instances were

found. Unable to perform backup.

Explanation: The application server is not installed on

this machine.
System action: Backup is not performed.
User response: Install the application server.
ANS1550E

ANS1544E

A supported version of WebSphere is

not installed on this machine.

No network deployment manager

instances were found to back up.

Explanation: Deployment manager is not installed on

this machine.
System action: Back up is not performed.
User response: Install the network deployment
manager.
ANS1551E

A TSM authorized user must configure

IBM Tivoli Storage Manager before
individual users can use it.

Explanation: IBM Tivoli Storage Manager was not

started by a TSM authorized user and the 'TSM System
Preferences' file could not be located.

Explanation: None.

System action: IBM Tivoli Storage Manager exits.

System action: The lock of the WebSphere

configuration repository fails.

User response: The initial setup and configuration of

IBM Tivoli Storage Manager must be done by a TSM
authorized user. To become a TSM authorized user,
system administrators must use the "TSM Backup for
Administrators" application. Refer to the Backup-Archive
Client Installation and User's Guide for a complete
discussion of the TSM authorized user.

User response: Ensure that the WebSphere server is

running. If the server is already running, ensure that
the repository is unlocked. Ensure that you are backing
up the correct node. To see a list of available nodes that
can be backed up, enter: 'dsmc q was -wastype=local'.
ANS1547W

TSM failed to unlock the WebSphere

Configuration Repository.

Explanation: None.
System action: The unlock of the WebSphere
Configuration Repository fails.
User response: Make sure that the WebSphere server

82

ANS1552W

A user name and a password have not

been provided to Data Protection for
WebSphere.

Explanation: The dsmc set WASPassword command

has not been run to provide the user name and the
password for Data Protection for WebSphere. Data
Protection for WebSphere needs the user name and

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

password to be able to run when WebSphere security is

turned on.
System action: Data Protection for WebSphere cannot
run.
User response: Run the dsmc set WASPassword
command to set the WebSphere security user name and
password.
ANS1553W

The user name and password that have

been provided to Data Protection for
WebSphere are invalid.

ANS1557W

The WAS Server was not running, and

the password file was saved without
validation.

Explanation: If the WAS server is down, then it is not

possible to connect to the server and validate the
user-entered password. The password has still been
saved, but no validation has been performed.
System action: The set WAS password command did
not validate the password. The password has still been
saved, but no validation has been performed. The
password may be incorrect.

Explanation: None.

User response: There are two options:

System action: Data Protection for WebSphere cannot

run.

v Try a backup. If the backup performs a failover, and

there is a incorrect password message in the error
log, then the password that was entered is incorrect.

User response: Run the dsmc set WASPassword

command to set the WebSphere security user name and
password.

v Start the WAS server and rerun the set password

command. Since the server is now up, validation will
be performed as normal and the user notified if a
good/bad password was entered.

ANS1554W

The WASOffline option has been

ignored.

ANS1558W

The WebSphere backup is failing over

to an offline backup.

Explanation: When a WebSphere server is running,

Data Protection for WebSphere contacts WebSphere and
locks the Configuration Repository. The WASOffline
option is only valid when a WebSphere server is not
running. If a WebSphere server is running, then
WASOffline is ignored.

Explanation: If there is an error locking the

WebSphere configuration repository, then Data
Protection for WAS will still get a backup and not lock
the repository.

System action: The WASOffline option is ignored.

System action: The WebSphere backup fails over to an

offline backup.

User response: Remove the WASOffline option from

the options file.

User response: Check the error log to see the nature

of the lock error. The lock operation can fail because:
v The WAS server is not running

ANS1555E

The WebSphere Application Server

(WAS) plug-in level must be at 5.2.1 or
greater to set the WebSphere user and
password.

Explanation: You must have the backup-archive client

and the WAS plug-in at a level of 5.2.1 or higher to be
able to connect to WebSphere when security is enabled.
System action: WebSphere does not set the user and
password.

v The repository is already locked

v Security is turned on and there is no WAS
user/password file
v Security is turned on and the information in the
WAS user/password file is bad.
Correct the lock error.
ANS1559I

Set WAS password completed

successfully.

ANS1560W

The WebSphere server is not running.

User response: Upgrade the WAS plug-in to 5.2.1 or

greater.
ANS1556E

Setting the WAS user and password

failed.

Explanation: The WebSphere server is not running.

The WAS server is running for backup operations.

Explanation: Password validation for the WAS user

and password failed.

System action: The WebSphere server is not running.

System action: WAS password validation fails.

User response: Start the WAS server and run the

backup again.

User response: Rerun the set WASPassword command

with the correct values for user and password.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

83

ANS1561I

Loading the Oracle Java Runtime

Environment, please wait.

ANS1562E

WAS Restore failed during EAR

Expansion.

Explanation: EAR Expansion is performed for a

WebSphere Application server after the files have been
restored.
System action: WAS restore fails.
User response: Run the restore again.

ANS1567I

A 5.2.2 or higher client is restoring data

backed up from a 5.2.0 client. No
version check can be performed before
the restore.

Explanation: WebSphere's version information was not

stored as part of the backup for 5.2.0. So, a 5.2.2 client
cannot ensure that the version of WAS that is being
restored is the same version of WAS that is on the
machine. A version of WAS that is restored may be
incompatible with the version of WAS on the machine
and can cause errors in WAS.
System action: No version check is performed.

ANS1563W

The itsm.was.properties file does not

exist.

Explanation: The itsm.was.properties file is used to

store the WebSphere security user name and password.
System action: None.
User response: Run the dsmc set waspassword
command to create this file.
ANS1564I

Running the WebSphere EAR

expansion, please wait.

Explanation: An APP server must have the restored

EARS expanded for the server to work.
ANS1565E

No WebSphere EARExpander was

found. Copy the EARExpander tool
from the base WebSphere bin directory
to the instance bin directory, then run
the restore operation again.

Explanation: The EAR files are expanded for an

instance of an Application server and the EARExpander
tool does not exist in the instance bin directory.
System action: No WebSphere EARExpander found.
User response: Copy the WAS EARExpander tool
from the base install's bin directory to the bin directory
of the instance. Then run the WAS restore operation
again, after the EARExpander tool has been copied.
ANS1566E

The version of WebSphere on the

machine does not match the version of
WebSphere that was backed up. These
versions must match for a WAS restore
operation.

Explanation: The version of WebSphere on the

machine does not match the version of WebSphere that
was backed up. These versions must match for a WAS
restore operation.

User response: Make sure that the version of WAS

that is being restored is the same as the version of WAS
that is installed on the machine.
ANS1568E

The CAD attempted to register it's

tcpport and tcpip address without using
the TCPCADADDRESS option.

Explanation: The CAD sent the port and address

information to the server, however, there was a
problem registering the information with the server.
The problem occurred because no default value for the
tcpip address was provided. The server was unable to
determine a default value for the tcpip address because
the communication method was not tcpip.
System action: The server cannot register the
information for the CAD. CAD processing will
continue, but some functions of the CAD may not be
working properly.
User response: Use TCPCADADDRESS in the client
option file to indicate the proper TCP/IP address for
this CAD.
ANS1569E

The CAD attempted to register it's

tcpport and tcpip address but the
TCP/IP address resolved to the loopback
address and was rejected by the server.

Explanation: The CAD sent the port and address

information to the server, however, there was a
problem registering the information with the server.
The problem occurred because the server detected that
the address provided resolved to the loopback address.
System action: The server did not register the
information for the CAD. CAD processing will
continue, but some functions of the CAD may not be
working properly.
User response: Use TCPCADADDRESS in the client
option file to indicate the proper TCP/IP address for
this CAD. Loopback address is not valid.

System action: The WAS restore operation fails.

User response: Install the correct version of
WebSphere on the machine before performing the
restore operation.

84

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1570E

Registering this instance of the Cad

with the server failed. Cad process
continues.

Explanation: The CAD failed to register address

information to the server, due to an error. There should
be a message immediately preceding this message that
would indicate the problem more precisely.
System action: The server did not register the
information for the CAD. CAD processing will
continue, but some functions of the CAD may not be
working properly.
User response: Look at messages immediately
preceding this message to help determine what error
occurred.
ANS1571E

The time-option option cannot be used

without specifying the date-option option

Explanation: If the to/from/pit time options is

specified then the corresponding to/from/pit date
MUST also be specified.

ANS1574E

Explanation: The journal daemon was unable to

process the requested journal query.
System action: Journal backup processing is
interrupted.
User response: Retry the backup, check the journal
daemon errorlog for the cause of the failure. Backup of
other file systems in the domain will continue.
ANS1575E

System action: Journal backup processing is

interrupted.
User response: Retry the backup, check the journal
daemon and client errorlogs for the cause of the failure.
ANS1576W

User response: Either remove the to/from/pit time

option or add the corresponding to/from/pit date
option.
An unexpected error was received from
the server query, RC=re tcode.

Explanation: An unexpected error was received by the

client. This could be caused by network problems or a
programming error.
System action: TSM canceled the current operation.
User response: Verify that your communication path
is functioning properly and try the operation again. If
the problem persists, contact your TSM administrator
for further assistance.
ANS1573E

FROMDATE and TODATE cannot be

used with PITDATE.

Explanation: The PITDATE option specifies different

and conflicting date selection criteria from the
FROMDATE and TODATE options. Therefore these
options cannot be combined.
System action: The restore operation is not performed.
User response: Determine whether you require the
functionality of PITDATE or FROMDATE and
TODATE, then try the operation again. If you want to
restore files as of a certain date and time, use PITDATE
and PITTIME. If you want to restore files from a given
range of dates, use FROMDATE, TODATE,
FROMTIME, and TOTIME. Refer to the TSM client
manual for your operating system for additional
information about these options.

Journal Daemon Communications Error.

Explanation: An error occurred communicating with

the journal daemon.

System action: Processing stopped.

ANS1572E

Journal Query Failed.

Space Management Agent version

mismatch. The Space Management
Agent (hsmagent) version agent-version
running on 'client-node' client node does
not match with the Space Management
Console (GUI) version console-version
you are running! To avoid compatibility
problems, please use the same version
for the Space Management Console and
the Space Management Agent. Do you
want to proceed?

Explanation: The version of the Space Management

Console does not match with the version of the Space
Management Agent running on the client node
machine. To avoid compatibility problems, please use
the same version for the Space Management Console
(GUI) and the Space Management Agent (hsmagent).
System action: Prompt the user to exit or continue.
User response: Use Space Management Console (GUI)
with the same version like the Space Management
Agent (hsmagent) running on the HSM node you want
to manage.
ANS1577I

The Windows console event handler

received a 'event' console event.

Explanation: A console event was received by one of

the IBM Tivoli Storage Manager processes or programs.
The following events can be received:
v Ctrl-C - This indicates either the user entered the
ctrl-c sequence or that one of the Windows services
was stopped.
System action: None.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

85

ANS1578E

The specified path 'path' is not valid for

backup or archive.

Explanation: The specified path is a special file system

or part of a special file system. Special file systems
contain dynamic information generated by the
operating system and should not be backed up or
archived. Refer to the TSM client manual for a
complete list of special file systems for your operating
system.
System action: Processing continues if there are other
file systems to back up.
User response: Do not specify special file systems for
backup or archive.
ANS1579E

GSKit function func-name failed with

error-code: session

possible after the TSM restore operation ends.

ANS1583E

The Hardware Utility plug-in module

was not found or could not be loaded.

Explanation: Processing stops.

System action: None.
User response: Run "dsmc show plugins" at the TSM
command-line client prompt to see the available
plug-ins on the system and verify the path which is
being used to load the plug-ins. If the plugin path is
available and the Hardware Utility plug-in,
libPiHDW.a, is present, ensure that the LIBPATH
variable is set to the Hardware product's library path,
for example, LIBPTH=/usr/opt/db2_08_01/lib.
ANS1584E

Explanation: A GSKit function has failed with the

specified error code.

Error loading system library

'libdevmapper.so' required for image
operations for LVM2 volumes.

User response: Make sure you have configured the

key database for SSL communication as described in
the documentation. If the problem persists, contact TSM
customer support.

Explanation: The system library libdevmapper.so

required for LVM2 image operations could not be
loaded. This error can occur when library does not
exist on the system, or it is an earlier level than is
required, or it could not be opened by the TSM clienti
process.

ANS1580W

System action: The image operations for LVM2

volumes will not be available.

System action: Processing stopped

An Include.Fs statement with

performance algorithm set already exists
for the drive specified. Do you want to
replace the statement?

Explanation: The user tried to create a duplicate

Include.Fs entry on a drive that already has a
performance algorithm associated with it. This is
applicable to the Preference Editor on the MFC GUI
System action: The user can replace the statement
with the new one or they can cancel out of this
operation
User response: The user is prompted to replace the
statement with the new one or they can say No to
cancel out of this operation.
ANS1581W

'object-name' was restored as 'temp-name'.

A reboot is required to complete the
restore.

Explanation: This is a system file restored and could

not be immediately replaced. The file will be replaced
during the next reboot of the operating system. It is
important to note that until the reboot occurs, the
changes will not be in effect.
System action: TSM restored the file with a temporary
name, and instructed the operating system to replace
the original file with the restored file during the next
boot of the operating system.

User response: Check the installed packages and the

library versions on the system. If correct versions is
installed, check for access related issues. If system does
not have these library installed please contact your
Linux OS distributer.
ANS1587W

Unable to read extended attributes for

object object-full-name due to errno:
errno-value, reason: errno-explanation

Explanation: The extended attributes of the object

could not be read. The system set the error code
errno-value and the reason errno-explanation. If the
reason errno-explanation is either "access denied" or
"permission denied", the current user does not have
permission to read the extended attributes of the object.
System action: The object is skipped. Processing
continues with the next object.
User response: The error is expected if the operation
tries to read extended attributes of an object that you
do not own or do not have access to. If the reason
indicates an input/output error, perform the file system
consistency check procedure and try the operation
again. If the problem persists, contact IBM technical
support for further assistance.

User response: Reboot the machine as soon as

86

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1588W

I/O error reading file attribute: attr-name

for: file-name. errno = errno-value,

Explanation: The attribute attr-name of the file

file-name could not be retrieved. The system set the
error code errno-value. If the reason given is "access
denied," the current user does not have permission to
read the file attributes.
System action: Processing continues without backing
up the specified file attribute.
User response: Correct the condition causing the
physical error.
ANS1589W

Unable to write extended attributes for

object-full-name due to errno: errno-value,
reason: errno-explanation

ANS1593E

Cannot open the key database.

Explanation: TSM was unable to open the keyfile that

is expected to contain the server certificate for SSL
communications.
System action: Processing stopped
User response: Make sure you have configured the
key database for SSL communication as described in
the documentation. If the problem persists, contact TSM
customer support.
ANS1594E

Wrong key database password.

Explanation: The key database that contains the server

certificate has been set up with the wrong password.
System action: Processing stopped

Explanation: The extended attributes of the object

could not be written. The system set the error code
errno-value and the reason errno-explanation. If the
reason is either "access denied" or "permission denied",
the current user does not have permission to write the
extended attributes of the object.

User response: Make sure you have configured the

key database for SSL communication as described in
the documentation.

System action: Processing continues without restoring

the extended attributes.

Explanation: TSM was unable to open SSL connection

to server because of a bad certificate. This error usually
occurs when the server certificate cannot be verified by
the client.

User response: The error is expected if the operation

tries to write extended attributes to an object that you
do not own or do not have access to. If the reason
indicates an input/output error, perform the file system
consistency check procedure and retry the operation. If
the problem persists, contact IBM technical support for
further assistance.
ANS1590W

I/O error writing file attribute: attr-name

for: file-name. errno = errno-value,

Explanation: The attribute attr-name of the file

file-name could not be set. The system set the error code
errno-value. If the reason given is "access denied," the
current user does not have permission to set the file
attributes.
System action: Processing continues without restoring
the specified file attribute.
User response: Correct the condition causing the
physical error.
ANS1592E

Failed to initialize SSL protocol.

Explanation: TSM was unable to initialize SSL

protocol.
System action: Processing stopped
User response: Check for GSKit related messages in
the error log. Make sure you have configured the key
database for SSL communication as described in the
documentation. If the problem persists, contact TSM
customer support.

ANS1595E

Bad server certificate.

System action: Processing stopped

User response: Make sure you have configured the
key database for SSL communication as described in
the documentation. Make sure to import the correct
certificate from the TSM server you are trying to
connect to.
ANS1596E

SSL protocol is not supported.

Explanation: SSL protocol is not supported on this

platform.
System action: Processing stopped
User response: Refer to TSM documentation for the
list of supported platforms.
ANS1597E

The -pick and -deltype=all options are

not valid together.

Explanation: -deltype=all is used to delete an entire

directory tree. You cannot use -pick to select individual
objects from the tree. -pick is valid only with
-deltype=active or -deltype=inactive.
System action: Processing stopped.
User response: Try the operation again with a valid
combination of options. If you want to delete an entire
tree, use -deltype=all, but do not use -pick. If you want
to select which backup versions to delete, specify
-deltype=active or -deltype=inactive, and use the -pick
option. Also use -subdir=yes if you want the file
Chapter 2. ANS 0001-9999: Client messages, version 6.3

87

selection to include files in subdirectories of the file

specification. See the client manual or command line
help for additional information.
ANS1598E

-deltype=all is not valid for this file

specification.

Explanation: -deltype=all is used to delete an entire

directory tree. You must specify a fully wildcard
directory when using -deltype=all.
System action: Processing stopped.
User response: Try the operation again with a valid
combination of options. If you want to delete all
backup versions of an entire directory tree, use
-deltype=all and a fully wildcarded file specification. If
you want to delete backup versions of partially
qualified file names, use -deltype=inactive or
-deltype=active. Also use -subdir=yes if you want to
delete backup versions in subdirectories of the file
specification. See the client manual or command line
help for additional information.

System action: Processing ends.

User response: The Data Protection for Lotus for
Domino configuration file (default name domdsm.cfg)
could not be found. Check the error log on the client
machine for more information.
ANS1603E

The Domino plugin operation failed

because of an internal TCP/IP error.

Explanation: A TCP/IP error has occurred.

System action: Processing ends.
User response: Check the error log on the client
machine for more information.
ANS1604E

The Domino plugin operation failed

trying to start the dsmdomp address
space.

Explanation: The dsmdomp address space could not

be started. This is probably an installation error.
System action: Processing ends.

ANS1599E

Cannot load SSL runtime library.

Explanation: TSM failed to dynamically load SSL

runtime library necessary for SSL protocol
System action: Processing stopped
User response: Make sure TSM client is properly
installed. Try to reinstall the client software. If the
problem persists, contact TSM customer support.
ANS1600E

Unable to load the Data Protection for

Lotus Domino library.

Explanation: The Datt Protection for Lotus Domino

library could not be loaded.
System action: Processing ends.
User response: Ensure that Domino plugin is properly
configured and check the error log on the client
machine for more information.
ANS1601E

The Domino plugin operation failed

because of an internal error.

Explanation: A Domino plugin internal error has

occurred.
System action: Processing ends.
User response: Check the error log on the client
machine for more information.
ANS1602E

The Domino plugin operation failed

because the preferences file was not
found.

Explanation: The Data Protection for Lotus Domino

preference file could not be found.

88

User response: Ensure that the lotus/bin directory has

a symbolic link to the tools directory for dsmdomp and
the lotus/notes directory has a symbolic link to the
dsmdomp executable. If the problem persists, contact
your System Administrator for further assistance.
ANS1605E

The Domino plugin operation failed

while initializing communications with
the dsmdomp address space.

Explanation: The Domino plugin communication

initialization failed.
System action: Processing ends.
User response: The dsmdomp address space failed
during its initialization. This is likely to be an
installation error. Ensure that the lotus/bin directory
has a symbolic link to the tools directory for dsmdomp
and the lotus/notes directory has a symbolic link to the
dsmdomp executable. If the problem persists, contact
your System Administrator for further assistance.
ANS1606E

The Domino plugin operation failed

while starting up the dsmdomp address
space.

Explanation: The dsmdomp address space could not

be started.
System action: The TDP for Domino processing stops.
User response: The dsmdomp address space failed
during its initialization. This is likely to be an
installation error. Ensure that the lotus/bin directory
has a symbolic link to the tools directory for dsmdomp
and the lotus/notes directory has a symbolic link to the
dsmdomp executable. Examine the file
/tmp/dsmdomp* for more information. If the problem

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

persists, contact your System Administrator for further

assistance.
ANS1607E

A plugin found in the plugins library is

not supported by the current level of the
TSM client.

Explanation: The plugin is not loaded, and processing

continues.
System action: The plugin is not loaded, and
processing continues.
User response: This probably is an installation error.
Ensure that the plugins directory contains valid plugin
libraries, and that the correct level of the TSM client
has been installed. If the problem persists, contact your
System Administrator for further assistance.
ANS1608E

Domino plugin operation failed with

the following message: messsage

Explanation: A Domino plugin operation error

occurred.
System action: Processing ends.
User response: Correct the error that caused the
operation to fail.
ANS1609E

Domino plugin process failed. The

following messages are associated with
the error. messsage.

Explanation: A Domino plugin operation error

occurred.
System action: Processing ends.

User response: If the error persists, run with tracing

enabled and contact your System Administrator and
IBM for further assistance.
ANS1612E

The Domino plugin operation failed

because of a TSM API error.

Explanation: An TSM API error occurred .

System action: Processing ends.
User response: Check error log on the client machine
for more information.
ANS1613E

>Could not load the TSM API.

Explanation: The TSM API could not be loaded.

System action: Processing ends.
User response: Check error log on the client machine
for more information.
ANS1614E

The Domino plugin 'Try and Buy'

license has expired.

Explanation: The 'Try and Buy' license that was

detected has expired.
System action: Processing ends.
User response: This product is no longer valid for use.
A valid license must be obtained before running the
product.
ANS1615E

The Domino plugin operation failed

due to a license error.

Explanation: Domino plugin license verification failed.

User response: Correct the error that caused the

operation to fail.

System action: Processing ends.

ANS1610E

User response: Check the error log for further

information.

The domnode option has not been

properly specified for the node
'node_name'.

Explanation: The domnode option has not been

properly specified in the dsm.sys file for the node
shown.
System action: Processing for this request stops.
User response: This is likely to be an installation error.
Ensure that the domnode option has been properly
specified for the node in question. If the problem
persists, contact your System Administrator for further
assistance.
ANS1611E

A plugin operation failed because of an

internal error.

ANS1616E

The Domino plugin operation failed

because the Lotus Domino API could
not be loaded.

Explanation: The Lotus Domino API could not be

loaded.
System action: Processing ends.
User response: Ensure the Lotus Domino Server is
installed correctly.
ANS1617E

The Domino plugin operation failed

because of a Data Protection for Domino
API error.

Explanation: A plugin internal error has occurred.

Explanation: A Data Protection for Domino API error

occurred during a Domino plugin operation.

System action: The plugin operation stops.

System action: Processing ends.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

89

User response: For more details, view the following

Tivoli Storage Manager error logs.
The API error log (dsierror.log) and the log of Data
Protection for Domino activity (domdsm.log). The
default location of these logs is the Data Protection for
Domino installation directory.
The backup-archive client error log (dsmerror.log), the
web client error log (dsmwebcl.log), and the log of
scheduler activite (dsmsched.log). The default location
of these logs is the backup-archive installation
directory.
ANS1618E

A Domino plugin operation is already

in progress. Please wait for operation to
complete.

ANS1621E

Explanation: TSM failed to update attributes for the

named backup object on the server. The server may not
reflect correct state of the backup.
System action: Processing continues.
User response: Check preceding error messages in
error log for more information. Retry the operation. If
problem continues, contact your TSM administrator.
ANS1622I

Explanation: A Domino plugin operation is in

progress.
System action: The Domino plugin operation stops.
User response: Please wait for the Domino plugin
operation to complete before starting a new Domino
plugin operation.
ANS1619E

The IBM Tivoli Storage Manager

application client cannot work with the
version of the Domino plugin you have
installed.

Explanation: The version of the Domino plugin

currently installed on the system is older than the
version used to build the IBM Tivoli Storage Manager
application client.

Failed to update backup attributes on

server for local backup for 'filespace
namepath-namefile-name', object id 'object-id':'object-id' return code 'return
code'.

Number of backup objects cleaned up

on server: 'number' number of local
snapshot resources made available
:'number'.

Explanation: While performing consistency check for

server's database and the local repository maintained
on the client system, reported inconsistencies were
found. Inconsistent backups cannot be restored,
therefore TSM deletes all inconsistent backup objects
and frees the space occupied in the local repository.
System action: Processing continues.
User response: Check error log for further details on
which objects on server were deleted. If numbers look
unusually high check your configuration and if it
continues, contact your TSM administrator.
ANS1623W

System action: Processing ends.

Backup of NSF DB2 database was

skipped. NSF DB2 databases not
supported.

User response: Install a version of the Domino plugin

at or later than the level of the IBM Tivoli Storage
Manager application client.

Explanation: This version of DP for Domino plugin

does not support NSF DB2 databases.

ANS1620I

System action: Backup of NSF DB2 databases is

skipped.

Backup version for 'filespace

namepath-namefile-name', object id 'object-id':'object-id' is not consistent with
local repository. Its being deleted.

Explanation: The specified backup instance of the

named object is not valid with local repository contents.
This could happen if local repository is modified or got
corrupted on the client system. This backup can not be
restored, therefore it will be deleted on the server.
System action: The specified backup object will be
deleted on the server. Processing will continue.
User response: None.

90

User response: Exclude NSF DB2 databases from

backup.
ANS1624W

You have chosen to proceed with the

restore operation.New logical volumes
added after backup will be removed
during this restore process. Please
restore these logical volumes manually
before performing rollforward recovery.

Explanation: Database configuration has been changed

since the previous backup by the addition of new
logical volumes. User has requested a local restore
operation which will remove these newly added logical
volumes. Please restore them after the local restore
command has completed, before performing
rollforward recovery. You can find the list of logical
volumes removed in the dsmerror.log file.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: This message is a warning to the user

to perform certain action after the local restore
command completes successfully.

ANS1630E

User response: User MUST take the action specified in

this warning before proceeding with rollforward
recovery.
ANS1625I

Number of volumes to be FlashCopied:

v1

An error was returned calling an

operation of the Common Interface
Model(CIM). TSM function name :
function-name TSM function :
function-desc TSM CIM return code:
0xCIM-rc TSM file : file-name
(line-number)

Explanation: An error occurred when calling a CIM

operation of the disk subsystem.

Explanation: Number of volumes to be flashcopied.

System action: Processing stops.

System action: None.

User response: None.

User response: Please see the section about the CIM

return codes and their descriptions in the product
publication.

ANS1626E

ANS1631E

An unexpected error was encountered

when processing a TSM operation using
a hardware or snapshot function. TSM
function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM file : file-name (line-number)

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.

Explanation: Enough memory was not available to

continue processing.
System action: Processing ends.
User response: Ensure that your system has sufficient
real and virtual memory. Close unnecessary
applications.
ANS1632I

ANS1627E

SVC virtual disk v1 is not valid.

Explanation: The specified virtual disk is not found in

the list of virtual disks provided by the connected SVC
cluster.
System action: Process stops.
User response: Ensure that this virtual disk exists in
the SVC.
ANS1628E

The source v1 and target v2 virtual disks

are in different SVC clusters.

Explanation: The SVC source and target virtual disks

have to be assigned to the same SVC cluster.

System action: This message is informational.

User response: Do not specify "incremental" option for
LOCAL backups when using SAN Volume Controller
or use "any". This will allow TSM to pick the
appropriate default value of copyType.
ANS1647I

User response: Ensure that the source and target

virtual disks are in the same SVC.
The source v1 and target v2 virtual disks
are of different size.

Changing copyType to "copy" for

LOCAL SAN Volume Controller
incremental backup operation.

Explanation: When backup destination is LOCAL,

snapshot incremental type defaults to COPY type
operation. This is due to the lack of INCREMENTAL
snapshot support on SAN Volume Controller.

System action: Process stops.

ANS1629E

A memory allocation error has occurred

in file filename, line number linenumber.

DB2 Partition Volume Information:

Database configuration Name: db2 cfg
name Database Partition Number: db2
partition num DB2 Host Name: db2 host
name TSM Node Name: tsm node name
Volume List: volume list

Explanation: None.
System action: This message is informational.

Explanation: The SVC source and target virtual disks

have to be of the same size.

User response: None.

System action: Process stops.

ANS1648I

User response: Ensure that the source and target

virtual disks are the same size.

DB2 Backup Host Volume Information:

Database configuration Name: db2 cfg
name Backup Host Machine Name: db2
partition num Backup TSM Node Name:
db2 host name Volume List: volume list

Chapter 2. ANS 0001-9999: Client messages, version 6.3

91

Explanation: None.
System action: This message is informational.

ANS1654E

Failed: fshlll

User response: None.

Explanation: The backup, archive, restore or retrieve

operation for the object failed.

ANS1649E

System action: This message is for auditing purposes

only.

The option 'specified-option' is

inconsistent with the option
'other-option'.

Explanation: The command failed because the

specified option (specified-option) can not be specified in
combination with the option (other-option), which is also
specified.

User response: This message is for auditing purposes

only. For information about the failure refer to the TSM
Backup-Archive Client error log.
ANS1655I

Restored: fshlll

System action: The command is terminated.

Explanation: The restore operation for the object was

successful.

User response: Run the command without the

specified option. Alternatively, run the command
without the other option.

System action: This message is for auditing purposes

only.

ANS1650I

Command: command-string

Explanation: The command string listed in the

messagewas issued by the TSM Backup-Archive client.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1651I

Backed Up: fshlll

Explanation: The backup operation for the object was

successful.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1652I

Archived: fshlll

Explanation: The archive operation for the object was

successful.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1653I

Updated: fshlll

Explanation: The update operation for the object was

successful.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.

User response: This message is for auditing purposes

only.
ANS1656I

Retrieved: fshlll

Explanation: The retrieve operation for the object was

successful.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1657I

Expired: fshlll

Explanation: The active version of the object was

expired in the TSM database.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1658I

Deleted: fshlll

Explanation: The object was deleted from the TSM

database.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1659I

Skipped: fshlll

Explanation: The object was skipped by the user

during backup or archive processing.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.

92

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1660I

Excluded: fshlll

Explanation: The object was excluded from backup or

archive processing.

newer snapshots are not used in other applications or

in volume clones.
ANS1665W

System action: This message is for auditing purposes

only.
User response: This message is for auditing purposes
only.

TSM for ACS did not find any

snapshots for volume volname on the N
series filer.

Explanation: No snapshots were found for this

volume on the N series filer.
System action: Process continues.

ANS1661I

Unchanged: fshlll

Explanation: The object has not changed since the last

incremental backup was performed and does not need
to be resent.
System action: This message is for auditing purposes
only.
User response: This message is for auditing purposes
only.
ANS1662I

Agent Node: 'agent_node' Target Node:

'target_node'

Explanation: Proxy nodes information.

User response: None.

ANS1666W

TSM for ACS did not find any

information about the N series volume
volname.

Explanation: The query for information about this

volume did not return any data.
System action: Process continues.
User response: None.
ANS1667E

System action: None

The snapshot name snapname for volume

volname was not found in the snapshot
list on the N series filer.

User response: None

Explanation: Snapshot identified by this name does

not exist.

ANS1663W

System action: Process stops.

The option fractional reserve on volume

vol_name was reduced to less than 100
percent.

Explanation: Network Appliance strongly

recommends that when the fractional reserve is set to
less than 100 percent you actively monitor space
consumption and the rate of change of data in the
volume to ensure you do not run out of space reserved
for overwrites. In that case, if you run out of overwrite
reserve space, writes to the active file system fail and
the host application or operating system might crash.
System action: Process continues.
User response: Ensure that you monitor the space
consumption. Consult Network Appliance for tools to
monitor available space in your volumes.
ANS1664E

The snap restore for volume volname

with snapshot name snapname would
destroy later snapshots that are required
for other applications or for volume
clones.

Explanation: ONTAP will delete newer snapshots of a

volume when a specific snapshot is used for snap
restore.
System action: Process stops.

User response: None.

ANS1668E

The 'drive-name1' is not a local disk.

Explanation: The specified file system is network disk

or network share. Because the CLUSTERNODE option
is set to YES, the file system cannot be backed up or
archived.
System action: Processing stops.
User response: If the CLUSTERNODE option is
incorrectly set to YES, then change the option to NO
and try the operation again. Otherwise see the client
manual for further information about configuring the
TSM client to run in a cluster environment.
ANS1669W

The command subcommand command can

only be run in Windows WinPE mode.

Explanation: The command subcommand command is

not supported on a currently running operating system.
You must reboot to Windows WinPE mode to run this
command.
User response: None.
System action: The command is not processed.

User response: Prior to a snap restore, ensure that

Chapter 2. ANS 0001-9999: Client messages, version 6.3

93

ANS1670E

The file specification is not valid.

Specify a valid Network Appliance or
N-Series NFS (AIX, Linux) or CIFS
(Windows) volume.

ANS1674I

The cluster database has been restored

but the cluster service on some nodes
could not be started. Use the Failover
Cluster Management tool to manually
start the nodes.

Explanation: The file specification is not valid.

Incremental backup using snapshot difference using the
-SNAPDIFF option can only be performed on Network
Appliance or N-Series NFS volumes on AIX and Linux,
and on CIFS volumes on Windows. Do not specify
either Network Appliance or N-Series Qtrees or a path
within the Network Appliance or N-Series volume.
Only full volumes are supported.

Explanation: The cluster database has been restored.

During the restore, the cluster services were taken
offline except for the node being restored. Tivoli
Storage Manager failed to automatically start these
cluster services. You need to start them manually. The
nodes whose services failed to start are logged in the
client error log.

System action: Processing stops.

System action: Processing continues.

User response: Retry the incremental backup

operation using the -SNAPDIFF option. Specify a valid
Network Appliance or N-Series NFS volume on AIX or
Linux, or a CIFS volume on Windows.

User response: You can manually start the cluster

services.

ANS1671I

The cluster database has been restored.

Restarting the cluster services on all
nodes. This will take a few minutes.

Explanation: After the cluster database is restored, the

cluster service on the restoring node is in a paused
state. The cluster service on other nodes were
shutdown. All services need to be restarted. If some of
the services cannot be started automatically, restart
them manually.
System action: Processing continues.
User response: No action.
ANS1672I

Could not take the cluster resource

resource name offline. MS rc retcode. Error
is ignored.

Explanation: Microsoft recommends taking the cluster

resources offline during an authoritative cluster
database restore. However, the restore can still be done
if the resources cannot be taken offline. The error is
ignored.
System action: Processing continues.
User response: No action.
ANS1673W

ANS1675W

Cluster service on node node name could

not be started. You must manually start
the service.

Explanation: The cluster database has been restored.

During the restore, the cluster service was taken offline.
Tivoli Storage Manager failed to restart the cluster
service.
System action: Processing continues.
User response: You can manually start the service for
this node.

Unable to obtain a list of cluster nodes

to restart after the cluster database is
restored. The call 'cmd' returned with
MS rc retcode. You must restart the
cluster service on all the nodes after the
restore is finished.

Explanation: Due to an error, Tivoli Storage Manager

could not retrieve a list of nodes in the cluster to
restart. The cluster services on these nodes need to be
started manually. The client error log might contain
additional information depending on where the failure
occured.
System action: Processing continues.
User response: Manually start the cluster services on
all nodes.
ANS1676W

You are doing an authoritative cluster

database restore. The process may seem
to be hang before and after the file is
restored. This is because it may need to
start the cluster service if it is not up
and take all the resources offline. After
the cluster database is restored, the
cluster service will be restarted for
changes to be in effect. The cluster
service on all other nodes also have
been shutdown. They will be restarted.
This may take a few minutes.

Explanation: The restore will seem to be paused at

time because before the restore, Tivoli Storage Manager
ensures the cluster service is up on the restoring node
and all the resources are taken offline. After the cluster
database is restored, the cluster service on the restoring
node is in a paused state. The cluster service on other
nodes were shutdown. All services need to be retarted.
If some of the services cannot be started automatically,
you can try to restart them.
System action: Processing continues.
User response: No action.

94

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1677W

Tivoli Storage Manager failed to set the

disks for quick formatting because of an
error. See the error log for more details.
The disks will be slow formatted which
will cause a slower restore process.

Explanation: By default, Tivoli Storage Manager tries

to set the QuickFormat value of the
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\
Windows NT\CurrentVersion\ASR\RestoreSession key
to perform quick formatted on all the disks. Due to an
error, a slow format will be performed on the
re-creation of the disks. This process will cause a
slower restore process.

ANS1681E

Explanation: The ASR files can be in put in the

DSM_DIR path by default or overriden with the
ASRFILESPATH option. Either one is being set.
System action: Processing stops.
User response: Set the DSM_DIR environment
variable or specify the ASRFILESPATH option on the
"RESTORE MACHINEASR" command.
ANS1682W

System action: None

User response: None
ANS1678E

ASR path 'path': not found.

Explanation: You have specified a directory that does

not exist.
System action: Processing stops.
User response: Recheck all spelling and punctuation,
particularly the placement of directory delimiters (for
example, "\"). Correct the syntax if it is incorrect, then
retry the operation.
ANS1679W

Updating the registry to identify which

volumes have been restored has failed.
This does not affect the volumes that
have already been restored. See the
error log for more details. The error is
being ignored and processing continues.

Explanation: After restoring the critical volumes,

Tivoli Storage Manager tries to update the
RestoredVolumes value of the
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\
Windows NT\CurrentVersion\ASR\RestoreSession key
to indicate which volumes have been restored. Due to
an error accessing the registry, the error is logged but
processing continues.

DSM_DIR was not set and the

ASRFILESPATH option was not
specified.

No FlashCopy relationships found in

the storage system.

Explanation: The copy services server (mostly a CIM

Object Manager) does not have any FlashCopy relation
objects.
System action: Process may stop.
User response: This is not necessarily a message that
implies the stop of the process.
ANS1683E

The state status of the consistency group

is bad to achive a valid disk backup.

Explanation: TSM ACS function monitoring will

expect that the FlashCopy are in one of the state
Idle_Copied or Copying.
System action: Process will stop.
User response: Verify using the storage GUI the state
of the FlashCopy. If this state was generated by an user
action, try to start the copy process through the storage
GUI, then re-start the TSM ACS moniotoring fuction.
ANS1684W

Disk Full Error Accessing Subfile

Cache: exception-name

Explanation: A disk full error occurred attempting to

access or write to the specified subfile cache file during
a subfile incremental backup. See the client error log
for more detailed information. TSM.

System action: Processing continues.

System action: Processing continues without subfile.

User response: None

User response: None.

ANS1680W

ANS1685E

Function refresh incremental FlashCopy

cannot be accomplish because no
consistency group found for these
volumes.

Incremental backup operation using

snapshot difference is only available for
N series/NetApp filer volumes, is not a
NetApp volume.

Explanation: A refresh of the incremental FlashCopy

can only be done when the consistency group and the
correspondent FlashCopy relation were established
previously.

Explanation: Cannot perform NAS NFS/CIFS

incremental backup operation using snapshot difference
on the mounted or mapped volume because the
volume is not a N series/NetApp filer volume.

System action: None.

System action: Processing stops.

User response: None.

User response: Retry the incremental backup

Chapter 2. ANS 0001-9999: Client messages, version 6.3

95

operation by specifying an entire NAS NFS or CIFS

volume.
ANS1686I

Single Instance Store link 'file-name' will

be restored or retrieved as a normal file.

Explanation: TSM restores Single Instance Store (SIS)

links as normal files. If the restored version is a
duplicate of of the copy in the SIS Common Store, then
the SIS Groveler will eventually recreate the SIS link.
System action: TSM creates normal files instead of the
reparse point.

ANS1689E

Explanation: An error occurred while updating the

registry after VSS Automated System Recovery (ASR).
Check dsmerror.log for more information.
System action: Processing stops.
User response: Ask your system administrator to
check the error log.
ANS1690E

User response: None

ANS1687E

VSS Instant Restore operation failed.

Please examine the TSM Client error log
file (DSMERROR.LOG) for more
details.

The registry was not updated after VSS

ASR restore.

The list of volumes passed contain pairs

which belong to different consistency
groups in the scope of one single
cluster.

Explanation: VSS hardware provider failed while

performing volume-level copy restore operation.

Explanation: TSM ACS handles for each operation

only one consistency group per cluster at the same
time. If the set of volumes in a backup or restore
operation contain pairs that belong to different
consistency group inside one single cluster, then the
process of the operation will be stopped.

System action: Processing stopped.

System action: Process stopped.

User response: Attempt to determine the source of the

error by examining the Application Client log file, the
TSM Client error log file (DSMERROR.LOG), the
Windows Application Event Log, the Windows System
Event Log, and the VSS provider log file, if applicable.
Additional instructions for Windows VSS operations
are located in the TSM Problem Determination Guide.
Correct the problem and retry the operation. If this
error persists, contact your service representative.

User response: If you added volumes to the

production database or to the target set, ensure that
they are not in any FlashCopy relation.

ANS1688I

Sparse attributes for 'file-name' cannot be

backed up correctly because the volume
from which the file is backed up does
not support sparse files.

Explanation: If the volume from which a file is backed

up does not support sparse files, then the allocated
ranges for the sparse file cannot be backed up. This is
true even if a file has its sparse attribute set. One
example where this can occur is if a sparse file is
created on a NAS volume, but the volume is backed up
over CIFS, where CIFS does not support sparse files.
System action: The sparse attribute and allocated
ranges for the file are not backed up. If the file is
restored, the restored file will not be sparse.
User response: No action is required if you do not
need the sparse attribute and allocated ranges backed
up. If you require backup of the file's sparse attribute
and allocated ranges, then the volume from which IBM
Tivoli Storage Manager backs up the file must support
sparse files.

96

ANS1691I

The option 'option' that was found in the

options file 'file-name' at the line
number: number is not supported and
will be ignored by the client.

Explanation: The specified option is valid but not

supported on the current platform and will be ignored
by the client.
System action: Processing continues.
User response: You can ignore the message or remove
the option from the option file.
ANS1692E

The certificate is not trusted.

Explanation: The client was unable to open SSL

connection to the server because the server certificate
was not trusted.
System action: Processing stopped
User response: Make sure that you have configured
the key database for SSL communication as described
in the documentation. If the TSM server is using a
self-signed certificate, make sure that you import the
correct certificate from the server you are trying to
connect to. When the server is using a certificate signed
by an authority, make sure that the root certificate of
the authority is imported into the client key database.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1693E

The certificate validity period is

incorrect.

ANS1704W

Option 'option-name' can not be supplied

by application and is ignored.

Explanation: The client was unable to open an SSL

connection to the server because the certificate validity
period is incorrect.

Explanation: An API application supplied option. The

option cannot be specified by an application. The
option can be specified only in the dsm.sys options file.

System action: Processing stopped

System action: The supplied option is ignored.

Processing continues.

User response: Report this to the TSM server

administrator. The server must have the correct
certificate installed.

User response: Correct the application configuration.

ANS1705E

ANS1694E

The certificate identity could not be

verified.

Explanation: TSM was unable to open an SSL

connection to the server because the certificate identity
could not be verified. This happens when the certificate
ownership information does not match the TSM
domain name or IP address.
System action: Processing stopped

System Writers writersname do not exist.

Explanation: These writers are an essential part of the

operating system. When they are not available the
backup will complete successfully but the data for
those writers will not get backed up to the IBM Tivoli
Storage Manager server. This can result in the computer
not booting after a restore of the system state.
System action: System state backup stopped.

User response: Make sure that the server domain

name or the IP address (the value of the
TCPSERVERADDRESS option) is correct. If the problem
persists, report it to your TSM server administrator.

User response: Verify that these writers exist using

'vssadmin list writers' command. Try the operation
again. If the problem persists, contact your system
administrator or IBM Tivoli Storage Manager
administrator for further help.

ANS1695E

ANS1706E

The certificate is not valid.

Explanation: TSM was unable to open an SSL

connection to the server because of an invalid
certificate. The client was unable to determine the exact
cause of the failure.
System action: Processing stopped
User response: Further analysis of the server
certificate, the client key database, or both, is needed.
Refer to TSM documentation for more information.
ANS1696E

Only root can perform this action.

Explanation: User must be root to perform this action.

System action: Processing stopped.
User response: Log in as root and try the operation
again.
ANS1700W

Database 'database' (save date=date) was

successfully recovered.

Explanation: The specified database (which was saved

on the specified date) was successfuly recovered.
System action: The specified database was recovered
with the last saved version.
User response: none.

Error creating directory ' directory'.

Explanation: The system was unable to create the

specified directory.
System action: Processing terminates.
User response: Verify that the system has the
appropriate permissions to create this directory, and
then restart the operation.
ANS1707E

Hard link 'new-file-name' could not be

created for existing file 'exist-file-name'.
Microsoft Windows return code:
'windows-return-code' 'windows-error-text'

Explanation: Some system state files are hard links

that point to another file. During system state restore,
IBM Tivoli Storage Manager recreates the hard links for
restored system state files. If a file with the same name
as the hard link already exists at the time of the restore,
IBM Tivoli Storage Manager attempts to replace the file
with the hard link. This message is issued when IBM
Tivoli Storage Manager is unable to replace an existing
file with a hard link. The message includes the hard
link name, the system state file name to which the hard
link points and the Microsoft Windows return code
information. The return code information indicates why
the file could not be replaced. It is possible for the
operating system or applications to behave erratically if
the hard link cannot be recreated.
System action: The hard link is skipped, system state
restore continues.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

97

User response: Use the Microsoft Windows return

code information provided in the message to determine
the underlying cause of the error. Based on the
underlying cause of the error and the reason you are
restoring the system state, you can choose to either
correct the underlying cause and perform the restore
again, or you can attempt to manually create the hard
link. Because this error message represents an unusual
and unexpected condition, you should give careful
consideration to the potential consequences of either
choice. The hard link can be created manually as
follows: Rename the file that has the same name as the
hard link. Then use the Microsoft Windows utility
fsutil.exe as follows: FSUTIL HARDLINK CREATE
hardlinkname originalfilename
ANS1708E

Backup operation failed. Only a root

user can do this operation.

User response: None

ANS1712I

Changed block tracking not supported

for disk disk name; Performing FULL
backup of disk.

Explanation: Changed block tracking is not enabled or

supported for the specified disk, so a full backup of the
disk will be performed.
System action: A full backup of the disk is performed.
User response: None
ANS1713W

There was a problem getting changed

block tracking information for disk disk
name; Performing FULL backup of disk.

Explanation: Backups initiated by non-root users are

disabled by IBM Tivoli Storage Manager administrator.

Explanation: Changed block tracking is supported for

the specified disk, but there was a problem getting the
changed block tracking information, so a full backup of
the disk will be performed.

System action: The operation stops.

System action: A full backup of the disk is performed.

User response: Request the IBM Tivoli Storage

Manager administrator to enable non-root backups.

User response: Review the error log for messages as

to why the changed block tracking information could
not be obtained.

ANS1709W

An ISO backed CDrom devices will not

be backup with the Virtual Machine.

Explanation: The Virtual Machine create on restore

would fail if the ISO CDrom images was not available
or on-line.
System action: The Virtual Machine backup will
continue minus the CDrom device.
User response: Once the Virtual Machine is created
you may add a CDrom device to it.
ANS1710W

Image backed floppy devices will not be

backup with the Virtual Machine.

ANS1714I

Explanation: No changed extents were found for the

specified disk, so there is nothing to backup; The disk
will be skipped.
System action: No data is backed up for the specified
disk so no data has changed.
User response: None.
ANS1715E

Explanation: The Virtual Machine create on restore

would fail if the floppy images was not available.
System action: The Virtual Machine backup will
continue minus the floppy device.
User response: Once the Virtual Machine is created
you may add a Floppy device to it.
ANS1711W

Incremental backup selected for 'VM

name', but a Full backup has not yet
been performed. Performing a Full
backup instead.

No changed extents found for disk disk

name - skipping disk.

A filespace already exists for VM (VM

name), but with a different VM uuid
(VM Uuid) than the current one (VM
Uuid).

Explanation: No changed extents were found for the

specified disk, so there is nothing to backup; The disk
will be skipped.
System action: No data is backed up for the specified
disk so no data has changed.
User response: None.
ANS1716E

A VMware vStorage web service task

timed-out.

Explanation: An incremental backup of the specified

virtual machine was selected, but no full backup of that
virtual machine exists; A full backup must exist before
an incremental backup can be performed.

Explanation: The TSM client timed-out waiting for

VMware vCenter or ESX host to complete a requested
web service task. Resources could be low or the system
could be busy.

System action: A full backup of the virtual machine is

performed instead of an incremental backup.

System action: Processing stopped

98

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Please check the VMware vCenter or

ESX host for errors.
ANS1717E

A VMware vStorage web service task

failed.

ANS1731E

Tape optimized recall for file list 'file-list'

failed with rc = code.

Explanation: Tape optimized recall was not able to

retrieve ordering information from the IBM Tivoli
Storage Manager server.

Explanation: A VMware vCenter or ESX host web

service task failed.

System action: Processing stops.

System action: Processing stopped

User response: Check all error messages above this

message to get details about the problem.

User response: Please check the VMware vCenter or

ESX host for errors.
ANS1718E

VMware vStorage create snapshot

failed.

Explanation: VMware vStorage failed to create the

requested snapshot.
System action: Processing stopped
User response: Please check the TSM error logs and
VMware vCenter or ESX host for errors.
ANS1719E

VMware vStorage remove snapshot

failed.

Explanation: VMware vStorage failed to remove the

requested snapshot.

ANS1732W

File 'file' is from a different file system.

writing file to list of unprocessed files:
'file-list'.

Explanation: The dsmrecall command specifies a file

system to process. Files from other file systems are
skipped and written into a unprocessed list.
System action: File is skipped and information is
written to a list of unprocessed files
User response: Check that all files in the input file list
are from the correct file system.
ANS1733I

A collection file was specified 'file-list'

The ordering process is skipped.

System action: Processing stopped

Explanation: A collection file was passed as the input

file list. Ordering is not necessary since it the file is
already ordered. Only the recall is started.

User response: Please check the TSM error logs and

VMware vCenter or ESX host for errors.

System action: The ordering processed is not started,

only recall started.

ANS1729E

The passed file list 'file-list' is not a valid

input file list. Pass standard file list or
collection file list to the dsmrecall
command.

User response: No further action needed.

ANS1734W

Explanation: User has passed a invalid file list type to

the dsmrecall command
System action: Processing stopped
User response: pass standard file list or collection file
list to dsmrecall command.
ANS1730E

The IBM Tivoli Storage Manager server

query for ordering information failed.

Explanation: Tape optimized recall was not able to

retrieve ordering information from the IBM Tivoli
Storage Manager server.
System action: Processing stopped
User response: Check the connection to the IBM Tivoli
Storage Manager server to see if the IBM Tivoli Storage
Manager server is available and you have the correct
access rights configured.

The virtual machine contains one or

more independent disks. Backups are
not supported in this configuration.
Specify the
'-vmprocessvmwithindependent=yes'
option to exclude these disks from the
backup.

Explanation: Independent disks are not affected by

snapshots so the IBM Tivoli Storage Manager client
does not support backing them up.
System action: The virtual machine is not backed up.
User response: Power off the virtual machine and
change the disk independent mode or remove them
from the virtual machine. Or specify the
'-vmprocessvmwithindependent=yes' option to exclude
these disks from the backup.
ANS1735W

The virtual machine contains one or

more physical Raw Device Mappings
(RDMs). Backups are not supported in
this configuration. Specify the
'-vmprocessvmwithprdm=yes' option to
exclude these disks from the backup.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

99

Explanation: Physical RDMs are not included in

snapshots so the TSM client does not support backing
them up.

caused the command to fail. Consider wrapping the

command in a script that always exits with a return
code of zero.

System action: The virtual machine is not backed up.

User response: Power off the virtual machine and
change the RDMs to virtual mode or remove them
from the virtual machine. Or specify the
'-vmprocessvmwithprdm=yes' option to exclude these
disks from the backup.
ANS1736I

Change block tracking is not supported

for virtual machine VM.

Explanation: RDM disks in physical mode, virtual

disks attached to shared virtual SCSI bus, and VMs
with hardware version 6 or earlier are not supported.
System action: The full disk is not backed up.
User response: None.
ANS1737E

The PRESNAPSHOTCMD command

failed.

Explanation: The command specified by the

PRESNAPSHOTCMD option must complete
successfully in order to perform the VSS snapshot
backup. If the command completed with a return code
of 0 (zero), it is considered to have completed
successfully. If the command completed with any other
return code, it is considered to have failed. If the
command failed then the VSS snapshot backup is not
performed.

ANS1739E

Restore of a system drive is not

permitted.

Explanation: The drive to which you are restoring

contains the operating system.
System action: Processing stops.
User response: Try the operation again without
specifying a system drive.
ANS1740W

Unable to read ACLs for object:

file_system path name. Check dsmerror.log
for more information.

Explanation: The ACLs of the object are not read.

System action: The object is skipped. Processing
continues with the next object.
User response: Examine the client error log for
additional messages that might indicate the reason for
the problem. Try to follow the suggested corrective
actions (if any) and try the operation again.
ANS1741W

Unable to read extended attributes for

file_system path name. Check dsmerror.log
for more information.

Explanation: The extended attributes of the object are

not read.

System action: The client does not perform the VSS

snapshot backup operation.

System action: The object is skipped. Processing

continues with the next object.

User response: Identify and repair the problem that

caused the command to fail. If a non-zero return code
is normal for this command, consider wrapping the
command in a script that always exits with a return
code of zero.

User response: Examine the client error log for

additional messages that might indicate the reason for
the problem. Follow the suggested corrective actions (if
any) and try the operation again.
ANS1742E

ANS1738W

The POSTSNAPSHOTCMD command

failed.

Explanation: If the command specified by the

POSTSNAPSHOTCMD option completed with a
non-zero return code, the VSS snapshot backup
operation continues. The operation continues with a
warning-level result. The result of the
POSTSNAPSHOTCMD command does not supersede a
higher result from the VSS snapshot backup command.
For example, if the VSS snapshot backup command
completed with code 12, a lower return code from the
POSTSNAPSHOTCMD command does not alter the
return code.
System action: The VSS snapshot backup continues,
but with a warning return code of at least 8.

Expose Snapshot failed for backup

'backup-name'.

Explanation: Expose snapshot failed.

System action: Processing stops
User response: See the dsmerror.log file for further
details.
ANS1743E

Unexpose snapshot failed for backup

'backup-name'.

Explanation: Unexpose snapshot failed.

System action: Processing stops
User response: See the dsmerror.log file for further
details.

User response: Identify and repair the problem that

100

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1744E

One or more of the snapshots(volumes)

needed for the restore operation were
not found. See dsmerror.log for further
details.

Explanation: One or more of the snapshots needed for

restore were not found on the system.
System action: Processing stops
User response: See the dsmerror.log file for further
details.
ANS1745I

The virtual machine to restore has one

or more distributed port groups. Further
configuration might be necessary to
select a port number after the restore is
complete.

Explanation: The virtual machine was saved with one

or more NIC cards backed by distributed port groups.
Due to conflicts on restore the port number(s) were not
saved.
System action: The restore continues.
User response: Edit the virtual machine settings and
select a port if needed.

ANS1748E

The virtual machine was stored with a

Raw Device Mappings disk backed by a
LUN. The required LUN is missing or
still mapped to another virtual machine:
LUN UUID lun.

Explanation: The virtual machine was stored with a

Raw Device Mappings disk backed by a LUN. The
required LUN is missing or still mapped to another
virtual machine.
System action: The virtual machine cannot be
restored.
User response: Find the required LUN and make it
available to the virtual machine.
ANS1749W

Object 'filespace-namehl-namell-name' was

backed up with invalid file system type
attribute.

Explanation: File system type is used by the client to

determine if an object name is case sensitive or not.
Wrong file system type may result in incorrect sort
order of the server tree for case sensitive file systems.
Finally some unchanged files may expire and then
re-backed up during full incremental backup.
System action: Processing continues.

ANS1746E

No available LUNs were found.

Confirm that the storage adapters are
configured correctly on the host and that
the LUNs are not mapped to another
virtual machine.

Explanation: The virtual machine was stored with a

Raw Device Mappings disk backed by a LUN. The
required LUN is missing or still mapped to another
virtual machine.
System action: The virtual machine cannot be
restored.
User response: Confirm that the Storage Adapters are
configured correctly on the host and that the LUNs are
not mapped to another virtual machine.

User response: It is recommended to rename the

correspondent filespace on TSM server and do the full
incremental backup again.
ANS1750I

Explanation: The volume mount point resolved to a

volume that has been snapped. The same snapshot
volume will be used.
System action: Processing continues.
User response: None.
ANS1751E

ANS1747W

The virtual machine contains one or

more Version 2 Raw Device Mappings
(RDMs). Backups are not supported in
this configuration.

Explanation: Version 2 RDMs are not supported.

System action: The virtual machine is not backed up.
User response: Power off the virtual machine and
remove the version 2 RDMs from the virtual machine.

Volume mount point 'volumemountpoint'

is mounted to volume 'volume'. Using
snapshot volume for 'volume' to backup.

Error processing 'filespace name': The file

system can not be accessed.

Explanation: The client is unable to access the file

system. Two common reasons for this are the account
under which the client is running does not have access
to the root of the file system, or the file system does
not exist.
System action: The inaccessible file system is skipped.
Processing continues with the next file system.
User response: Check the error log for additional
messages that might yield additional information about
the problem that prevents access to the file system.
Correct the problem, then retry the operation. If the
account does not have access to the file system, then
either the system administrator needs to grant access,
Chapter 2. ANS 0001-9999: Client messages, version 6.3

101

or an account that has access to the file system must be

used. If the file system does not exist, then remove or
correct the file system specification.
ANS1752E

The file system can not be accessed.

Explanation: The client is unable to access the file

system. Two common reasons for this are the account
under which the client is running does not have access
to the root of the file system, or the file system does
not exist.
System action: The inaccessible file system is ignored.
User response: Check the error log for additional
messages that might yield additional information about
the problem that prevents access to the file system.
Correct the problem, then retry the operation. If the
account does not have access to the file system, then
either the system administrator needs to grant access,
or an account that has access to the file system must be
used. If the file system does not exist, then remove or
correct the file system specification.
ANS1753E

File space 'filespace name' was backed up

by an older client version, and cannot
be restored with this client version. The
file space will be skipped.

Explanation: The backup set format in earlier client

versions for SYSTEM STATE and SYSTEM SERVICES is
incompatible with the current client version. Those file
spaces will be skipped. The restore might appear to
pause while the client skips past the objects in those
file spaces. Other remaining file space data will be
restored.
System action: Objects in this file space are skipped.
Other remaining file space data will be restored.
User response: Restore this specific file space in the
backupset with a prior level client.
ANS1754E

File space 'filespace name' cannot be

restored when ASNODENAME option
is in affect. The file space will be
skipped.

Explanation: System state data of another node should

not be restored to a different node. Those file spaces
will be skipped. The restore might appear to pause
while the client skips past the objects in those file
spaces. Other remaining file space data will be restored.
System action: Objects in this file space are skipped.
Other remaining file space data will be restored.
User response: Remove ASNODENAME option before
restoring this specific file space in the backupset or use
the node name that was used to backup system state
data to restore.

102

ANS1755W

An error communicating with Active

Directory has occured. USEDIRECTORY
option will be ignored and processing
will continue.

Explanation: TSM attempted to query Active

Directory for TSM Server parameters but an error has
occured. This could be caused by Active Directory or
the TSM Server's setup.
System action: TSM will ignore the USEDIRECTORY
option and continue with client processing.
User response: Make sure your computer is properly
set up to the domain with Active Directory. Also, make
sure your TSM Administrator has properly configured
the TSM Server for your node.
ANS1756W

The Journal for 'backup-specification' has

been reset: The server filespace was
deleted since the last backup completed.

Explanation: The client has reset the journal because

the corresponding server filespace was deleted since
the last backup completed.
System action: The journal is reset, the current backup
won't use the journal, and the journal won't be
available for backup until a full incremental backup
successfully completes.
User response: None.
ANS1757W

The Journal for 'backup-specification' has

been reset: The server filespace was
deleted since the last backup completed.

Explanation: The client has reset the journal because

the corresponding server filespace was deleted since
the last backup completed.
System action: The journal is reset, the current backup
won't use the journal, and the journal won't be
available for backup until a full incremental backup
successfully completes.
User response: None.
ANS1758W

The Journal for 'backup-specification' has

been reset: The server filespace was
deleted since the last backup completed.

Explanation: The client has reset the journal because

the corresponding server filespace was deleted since
the last backup completed.
System action: The journal is reset, the current backup
won't use the journal, and the journal won't be
available for backup until a full incremental backup
successfully completes.
User response: None.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1759W

The Journal for 'backup-specification' has

been reset: The policy set was updated
since the last backup completed.

Explanation: The client has reset the journal for the

specified file system because the node policy set was
updated since the last backup completed.
System action: The journal is reset, the current backup
won't use the journal, and the journal won't be
available for backup until a full incremental backup
successfully completes.

tsmxxxxxxxxxx. Unmount the snapshot: umount -f

tsmxxxxxxxxxx. Remove snapshot mount point: rmdir
tsmxxxxxxxxxx. Delete the snapshot: snapshot -d
/dev/tsmxxxxxxxxxx. If snapshot delete fails with
"Device Busy" or some other error, unmount the
snapshot source filesystem: umount -f <source FS>.
Retry snapshot delete: snapshot -d
/dev/tsmxxxxxxxxxx. Check if any logical volumes are
remaining: ls -l /dev/tsm*. Remove any remaining
logical volumes: rmlv -f tsmxxxxxxxxxx. Remount
source file system, if previously unmounted: mount
<source FS>.

User response: None.

ANS1764W
ANS1760I

Journal for 'backup-specification' enabled

for node 'nodename' and server
'servername'

Explanation: The journal for the specified file system

is now valid and will be used by the next full
incremental backup by the specified TSM node and
server.

Unable to remove the snapshot mount

point directory snapshot mountpoint
during cleanup of snapshot 'snapshot' of
volume 'volume'.Error is 'error'.Operation
will continue. Please manually remove
the snapshot mount directory and delete
the snapshot after backup is completed.

User response: None.

Explanation: During the termination phase of TSM

client operation, it was not possible to remove the
mount point directory for the snapshot for some
reason. However, TSM operation was completed
successfully.

ANS1761I

System action: Processing continues, and the rmdir

error is ignored.

System action: The next full incremental backup of

the file system will use the journal.

Journal for 'backup-specification' will be

enabled upon successful completion of
the backup.

Explanation: An active but invalid journal is present

for the file system being backed up. Once the backup
successfully completes the journal will available for use
by the next full incremental backup of the file system
with the same TSM node and server.
System action: None.
User response: None.
ANS1763W

Unable to unmount snapshot mount

point snapshot mountpoint during cleanup
of snapshot 'snapshot' of volume
'volume'.Error is 'error'.Operation will
continue. Please manually unmount,
remove the snapshot mount point
directory and delete the snapshot after
backup is completed.

Explanation: During the termination phase of TSM

client operation, it was not possible to unmount the
snapshot for some reason. However, TSM operation
was completed successfully.
System action: Processing continues, and the unmount
error is ignored.
User response: Please manually cleanup the snapshots
as follows: Query the snapshot: snapshot -q -c: <source
FS>. Snapshot name will be of the format:
tsmxxxxxxxxxx. Check if it is mounted: df -k | grep

User response: Please manually cleanup the snapshots

as follows: Query the snapshot: snapshot -q -c: <source
FS>. Snapshot name will be of the format:
tsmxxxxxxxxxx. Check if it is mounted: df -k | grep
tsmxxxxxxxxxx. Unmount the snapshot: umount -f
tsmxxxxxxxxxx. Remove snapshot mount point: rmdir
tsmxxxxxxxxxx. Delete the snapshot: snapshot -d
/dev/tsmxxxxxxxxxx. If snapshot delete fails with
"Device Busy" or some other error, unmount the
snapshot source filesystem: umount -f <source FS>.
Retry snapshot delete: snapshot -d
/dev/tsmxxxxxxxxxx. Check if any logical volumes are
remaining: ls -l /dev/tsm*. Remove any remaining
logical volumes: rmlv -f tsmxxxxxxxxxx. Remount
source file system, if previously unmounted: mount
<source FS>.
ANS1765W

Unable to delete the snapshot during

cleanup of snapshot 'snapshot' of volume
'volume'.Error is 'error'.Operation will
continue. Please manually delete the
snapshot after backup is completed.

Explanation: During TSM client operation, it was not

possible to delete the snapshot for some reason.
However, TSM operation was completed successfully.
One of the reasons that the snapshot delete failed
maybe due to the fact that AIX JFS2 expects the
snapshot delete requests for a given filesystem to be
issued in the order of oldest snapshot first, next oldest
snapshot second and so on. If there are other processes
using older snapshots for the same filesystem, it fails
Chapter 2. ANS 0001-9999: Client messages, version 6.3

103

the delete request. Also, TSM only deletes snapshots

that was created by one of its processes. It will not
delete older snapshots created by other applications or
users. In this case, the user will have to manually
delete all the older snapshots so that the next TSM
command can complete successfully.
System action: Processing continues, and the snapshot
delete error is ignored.
User response: Please manually cleanup the snapshots
as follows: Query the snapshot: snapshot -q -c: <source
FS>. Snapshot name will be of the format:
tsmxxxxxxxxxx. Check if it is mounted: df -k | grep
tsmxxxxxxxxxx. Unmount the snapshot: umount -f
tsmxxxxxxxxxx. Remove snapshot mount point: rmdir
tsmxxxxxxxxxx. Delete the snapshot: snapshot -d
/dev/tsmxxxxxxxxxx. If snapshot delete fails with
"Device Busy" or some other error, unmount the
snapshot source filesystem: umount -f <source FS>.
Retry snapshot delete: snapshot -d
/dev/tsmxxxxxxxxxx. Check if any logical volumes are
remaining: ls -l /dev/tsm*. Remove any remaining
logical volumes: rmlv -f tsmxxxxxxxxxx. Remount
source file system, if previously unmounted: mount
<source FS>.
ANS1766W

Unable to remove the snapshot logical

volume during cleanup of snapshot
'snapshot' of volume 'volume'.Error is
'error'.Operation will continue. Please
manually remove the snapshot logical
volume after backup is completed.

ANS1767E

Explanation: During the initialization phase of TSM

client operation, it was not possible to create a logical
volume for the snapshot.
System action: Processing continues, and the create
snapshot logical volume error is ignored. TSM
operation will be performed without the snapshot.
User response: Please ensure that the volume group
has sufficient free partitions to fulfill the mklv
allocation reuest and retry the operation.
ANS1768E

User response: Please manually cleanup the snapshots

as follows: Query the snapshot: snapshot -q -c: <source
FS>. Snapshot name will be of the format:
tsmxxxxxxxxxx. Check if it is mounted: df -k | grep
tsmxxxxxxxxxx. Unmount the snapshot: umount -f
tsmxxxxxxxxxx. Remove snapshot mount point: rmdir
tsmxxxxxxxxxx. Delete the snapshot: snapshot -d
/dev/tsmxxxxxxxxxx. If snapshot delete fails with
"Device Busy" or some other error, unmount the
snapshot source filesystem: umount -f <source FS>.
Retry snapshot delete: snapshot -d
/dev/tsmxxxxxxxxxx. Check if any logical volumes are
remaining: ls -l /dev/tsm*. Remove any remaining
logical volumes: rmlv -f tsmxxxxxxxxxx. Remount
source file system, if previously unmounted: mount
<source FS>.

104

TSM was unable to find space for a new

snapshot. TSM function name :
function-name TSM function :
function-desc TSM return code : TSM-rc
TSM file : file-name (line-number)

Explanation: None.
System action: Processing stops.
User response: Previous backups may still be
pending. If problem persists contact the TSM
administrator with the information provided in this
message.
ANS1769E

Explanation: During the termination phase of TSM

client operation, it was not possible to remove the
snapshot logical volume for some reason. However,
TSM operation was completed successfully.
System action: Processing continues, and the snapshot
logical volume remove error is ignored.

Unable to create a snapshot logical

volume using command: 'cmd'.Error is
'error'.Please ensure that the volume
group has sufficient free partitions to
fulfill the allocation request.

NetApp file server 'server-name' at Data

ONTAP version
'version.modification.submodification' is not
supported for performing incremental
backups using snapshot difference.

Explanation: Incremental backup using Snapshot

difference requires Data ONTAP V7.3 or later. However,
if you are upgrading from Data ONTAP V7.3.3 or later
to V8.0, you will lose snapshot difference support for
unicode file names. Upgrade to Data ONTAP V8.1 or
later.
System action: Processing stops.
User response: Upgrade the file server to a supported
level of Data ONTAP, then retry the operation.
ANS1770E

Unable to resolve address 'tcpip address'.

Error = error code, 'error message'

Explanation: The system was not able to get the

TCP/IP v6 address.
System action: Processing stopped
User response: Verify the address shown is a TCP/IP
v6 address and can be resolved with ping or ping6.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1771W

The system state filespace 'filespace name'

cannot be restored to a different
location.

Explanation: The system state file space cannot be

restored to a different location. This file space is
skipped.
System action: Objects in the system state file space
are skipped. Other remaining file spaces are restored.
The restore might appear to pause while the client
skips past the objects in this file space.
User response: Restore system state to its original
location.
ANS1772E

Error loading the snapshot plugin.

Explanation: On Linux 86/86_64 platform ensure that

the hardware plugin package - TIVsm-BAhdw is
installed.

ANS1780E

writer-name failed to initialize and

subscribe to VSS.

Explanation: IBM Tivoli Storage Manager encountered

an error while creating writer-name under control of the
Windows Volume Shadow Copy Service (VSS).
Examine the IBM Tivoli Storage Manager error log and
Applications Event Log for additional information
about this error.
System action: Processing ends.
User response: Try the operation again. If the error
persists, examine the IBM Tivoli Storage Manager error
log and Windows event log for information related to
this error.
Restart the Windows Volume Shadow Copy Service
(VSS), and try the operation again.
In some cases, it is necessary to restart the machine to
clear the VSS error state.

System action: The snapshot backup is stopped.

User response: On Linux 86/86_64 platform, install
TIVsm-BAhdw package if not already installed. Try the
operation again. If the problem persists, contact the
system administratoror IBM Tivoli Storage Manager
administrator for further help.
ANS1773W

The virtual machine contains one or

more independent disks and these disks
are excluded from the VM backup.

Explanation: You cannot perform a shapshot of

independent disks. Specify the option
'-vmprocessvmwithindependent=yes' to skip these
disks.
System action: The virtual machine independent disks
will not be backed up.
User response: None.
ANS1774W

The virtual machine contains one or

more physical Raw Device Mappings
(RDM) disks and these disks are
excluded from the VM backup.

Explanation: You cannot perform a shapshot of

physical RDM disks. Specify the option
'-vmprocessvmwithprdm=yes' to skip these disks.
System action: The virtual machine physical RDM
disks are not backed up.
User response: None.
ANS1779I

writer-name successfully initialized and

subscribed with VSS.

ANS1781I

writer-name was successfully stopped.

ANS1782E

writer-name failed to be stopped.

Explanation: IBM Tivoli Storage Manager encountered

an error while stopping writer-name. Examine the IBM
Tivoli Storage Manager error log and Applications
Event Log for additional information about this error.
System action: Processing ends.
User response: Try the operation again. If the error
persists, examine the IBM Tivoli Storage Manager error
log and Windows event log for information related to
this error.
Restart the Windows Volume Shadow Copy Service
(VSS), then try the operation again.
In some cases, it is necessary to retart the machine to
clear the VSS error state.
ANS1783I

writer-name was successfully

unsubscribed from VSS.

ANS1784E

Incremental by snapshot difference

cannot be performed on 'volume-name' as
it is a vFiler volume.

Explanation: Snapshot difference incremental backup

is not supported on vFiler volumes.
System action: Processing stops.
User response: Perform snapshot difference
incremental backup on normal NetApp/N-Series
volumes only.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

105

ANS1787I

The virtual machine NIC is backed by a

distributed virtual port group but it is
missing the portgroupKey attribute, The
NIC cannot be restored.

Explanation: The virtual machine NIC is missing the

required portgroupKey attribute.
System action: The virtual machine can be restored
but the NIC cannot be restored.
User response: After the virtual machine has been
restored a new NIC card can be added.
ANS1788I

The target ESX host is missing the

required distributed virtual port group,
the virtual machine NIC cannot be
restored.

Explanation: The virtual machine NIC was backed by

a distributed virtual port group but the target ESX host
is missing this port group.
System action: The virtual machine can be restored
but the NIC cannot be restored.
User response: After the virtual machine has been
restored a new NIC card can be added.
ANS1789I

No Ddistributed virtual port group were

found on the target ESX host. The
virtual machine NIC cannot be restored.

Explanation: The virtual machine NIC was backed by

a distributed virtual port group but the target ESX host
has no port group available.
System action: The virtual machine can be restored
but the NIC cannot be restored.
User response: After the virtual machine has been
restored a new NIC card can be added.
ANS1790E

Volume 'volname' cannot be backed up

because 'nosnapdir=on' is set on the
filer.

Explanation: This message is issued when option

'nosnapdir=on' is in set for the volume indicated in the
message. When this option is set, the volume snapshots
are hidden and thus cannot be backed up.
System action: The volume indicated in the message
is not backed up. Processing continues with the next
volume.
User response: To back up the volume, change the
volume on the filer: Set option 'nosnapdir=off'. Then try
the backup operation for this volume again. If the
volume is not backed up, remove it from the
backup-archive client DOMAIN setting.

ANS1795I

Operation will continue without using

snapshot provider, because file system
'volname' does not have write
permissions.

Explanation: The source file system for a snapshot

should be read-write as by definition a snapshot is a
point-in-time snapshot of changing file system.
Snapshot creation updates the file system superblock
which requires the file system to be read-write
System action: Processing continues without using
snapshot provider.
User response: If the volume needs to be backed up
via snapshot provider, change its permissions to
read-write.
ANS1796I

The short name for 'fullpath-name' could

not be set to original short name
'file-name': Windows function 'func-name'
failed with return code return-code

Explanation: The client cannot set the short name for

the specified object. This is usually because the short
name is already in use by another object located in the
same directory. Another possible reason is that the
account under which the client is running does not
have the SE_RESTORE_NAME privilege.
System action: The short name for the specified object
is not set. The object will retain the default short name.
Otherwise processing continues.
User response: This message is informational and can
be safely ignored. If you require that the object be
restored with its original short name, you will need to
move or delete the conflicting object. From an
operating system command prompt, change to the
directory that contains the object you want to restore.
Then use the \"dir /x\" command to identify the
conflicting object. Also make sure that you have the
SE_RESTORE_NAME privilege. If you need assistance,
see your system administrator. After the conflict has
been resolved, try to restore the file again.
ANS1797E

Function function-name received an

unexpected error from the Microsoft API
MS-function-name: rc=error while
attempting to access the object
'object-name'. Error occurred in file
file-name (line-number).

Explanation: An error occurred while processing the

'object-name'. The error code indicates the reason for the
failure. This information can be used to diagnose the
problem.
System action: The TSM client may or may not fail
the operation, depending on the error code.
User response: Contact your system administrator for
more information.

106

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1798W

An error occurred while accessing

encrypted data of the object 'object-name',
skipping object. Windows system error
code error, reason 'error-reason'

Explanation: An error occurred while processing

encrypted data of the object. The error information
captured indicates the reason for the failure. This
information can be used to diagnose the problem.
System action: Object skipped.

ANS1801E

Unable to register the new ID with

server.

Explanation: The reasons of this problem can be lack

of client system memory or server protocol error. The
TSM activity log might contain a corresponding error
message with further information about the cause.
System action: The new ID is not registered with the
server.

User response: Contact your system administrator for

more information.

User response: Please check your network connection

and try again after time. If the error appears again,
please contact your client machine administrator.

ANS1799I

ANS1802E

The last access date for 'fullpath-name'

could not be reset because the file is
read-only.

Explanation: Option PRESERVELASTACCESSDATE

YES is in effect, but the TSM client was unable to reset
the last access date for the specified file because the
file's "read only" attribute is enabled. The client cannot
reset the last access date for "read only" files.
System action: The last access date for the specified
file is not reset. Otherwise processing continues.
User response: This message is informational and can
be safely ignored. You might want to turn off the "read
only" attribute for the file so that subsequent backups
can reset the last access date. Before turning off the
attribute, you should verify that doing so will not
impact the integrity of the file or the applications that
use the file. You should also make sure that turning off
the attribute will not conflict with the file management
policies of your organization.

Incremental backup of 'file-name'

finished with number failure

Explanation: This message is issued after completion

of an incremental backup operation for the named file
specification when one or more objects in that file
specification could not be backed up.
System action: Processing continues.
User response: Examine the client error log for
additional messages that indicate the reasons that each
failed object could not be backed up. Take any
corrective action as suggested by the messages.
ANS1803E

Archive processing of 'file-space name'

finished with failures.

Explanation: This message is issued after completion

of an archive operation for the named file specification
when one or more objects in that file specification
could not be archived.
System action: Processing continues.

ANS1800W

The last access date for 'fullpath-name'

could not be reset: function 'func-name'
failed with return code return-code

Explanation: Option PRESERVELASTACCESSDATE

YES is in effect, but the TSM client was unable to reset
the last access date for the specified file. The message
includes the name of the function that failed and the
return code from that function.
System action: The last access date for the specified
file is not reset. Otherwise processing continues.
User response: If the problem is reproducible, obtain a
SERVICE trace that captures an instance of this
problem. Run the QUERY SYSTEMINFO command and
collect the dsminfo.txt file. Contact IBM support and
report the exact text of this error message. Be sure to
provide support with the dsminfo.txt and dsmerror.log
files and (if available) the SERVICE trace.

User response: Examine the client error log for

additional messages that indicate the reasons that each
failed object could not be archived. Take corrective
action as suggested by the messages.
ANS1804E

Selective Backup processing of 'file-space

name' finished with failures.

Explanation: This message is issued after completion

of a selective backup operation for the named file
specification when one or more objects in that file
specification could not be backed up.
System action: Processing continues.
User response: Examine the client error log for
additional messages that indicate the reasons that each
failed object could not be backed up. Take any
corrective action suggested by those messages.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

107

ANS1805E

Unable to restore symbolic link

'file-name'.

Explanation: The client operating system is not able to

create a symbolic link because the link points to a
filename that is not given.
System action: Processing continues.
User response: Try the restore on a different operating
system.
ANS1806W

Size exceeded the maximum file size

limit on your system for 'filespace
namepath-namefile-name' of 'file-size'.

Explanation: You tried to restore or retrieve a file that

has exceeded the maximum file size limitation on your
system.
System action: TSM cannot restore or retrieve the file.
User response: Restore or retrieve this file on a system
that supports the file size. See your system
administrator.
ANS1807E

Unable to recall file from server due to

error from recall daemon.

Explanation: Unable to recall file. The recall daemon

reported an error while trying to recall a file. Look in
the recall daemons error log for more information. This
can happen if the server is down, the connection is
broken, or the file is missing on the server. It is also
possible that the migration server in the system option
file has been changed to a different server. The recall
daemon does not check the system option file for
changes once it has started.
System action: File skipped.
User response: See if the server is up, and retry. If the
problem still exists, look in the error log. Also have the
workstation administrator run dsmreconcile against the
file system and see if the file shows up in the
.SpaceMan/orphan.stubs file. If system option file has
been changed, stop all recall daemons and restart the
master recall daemon to pick up the changes.
ANS1808E

The Logical Volume Snapshot Agent is

not at the correct level. It is possible
that the Client was upgraded to a newer
level but the LVSA driver was not
updated at the same time. Use the Setup
Wizard to configure either Online Image
or Open File support and choose Update
the Logical Volume Snapshot Agent.

Explanation: The selected operation requires the

current level of the Logical Volume Snapshot Agent.
Use the Setup Wizard to update the LVSA.
System action: The selected operation is not
performed.

108

User response: Retry the operation after updating the

Logical Volume Snapshot Agent.
ANS1809W

A session with the TSM server has been

disconnected. An attempt will be made
to reestablish the connection.

Explanation: This message is issued after the session

with the TSM server is unexpectedly lost. Some
possible reasons that this message might be issued: There is a problem with the network. - The TSM server
was shut down. - The TSM server administrator
cancelled the client session.
System action: The client will try to reestablish a
connection with the server. If the TSM server
administrator cancelled the session, then the attempt to
reestablish the connection will fail and message
ANS1369E will be issued. If the attempt to reestablish
the connection is successful, then processing will
continue. If the attempt to reestablish the connection
fails, then the client will continue to try to reestablish a
connection according to the
COMMRESTARTDURATION and
COMMRESTARTINTERVAL client option settings.
User response: If the session was cancelled by the
TSM server administrator and you do not know why,
or if the client is unable to reestablish a session with
the TSM server, then contact your TSM server
administrator for further information. Frequent
occurrences of the ANS1809W message can indicate a
problem with the network. If this message is repeatedly
found in the dsmerror.log, investigate possible
networking trouble, such as a failing network interface
card or router problem. One common problem is the
media speed of the network adaptors: If the network
adaptors are set to "auto-negotiate", try changing them
to "100%% full duplex". If the problem persists, then as
a temporary measure ask your TSM server
administrator increase the COMMTIMEOUT and
IDLETIMEOUT option settings on the TSM server. This
might reduce the frequency of this message.
ANS1810I

A session with the TSM server has been

reestablished.

Explanation: The session with the server has been

reestablished after a connection failure. This message is
usually preceded by message ANS1809W.
System action: Processing will continue.
User response: None. This message is informational
only.
ANS1811S

TSM session could not be reestablished.

Explanation: The session with the server has been

lost. Attempts to reestablish the session were
unsuccessful. Possible causes include, but are not
limited to the following:

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

v The network connection to the server is down.

User response: Enter the correct scheduling mode and

retry the operation.

v The communication program that TSM is interacting

with has encountered some problem.

ANS1817E

v The server has been halted.

System action: Processing is stopped.

User response: Check network connection to the
server. Insure that the TSM server is running. Insure
that the communication program underlying TSM is
working properly.
ANS1813E

Image Backup processing of

'filespace-name' finished with failures.

Explanation: The image backup operation failed. This

message is usually preceded by other messages
indicating the nature of the failure.
System action: The failing file space is skipped and
processing continues.
User response: Examine the messages preceding this
message and the TSM Client error log for more specific
indications about the problem. A common cause is that
a tape could not be mounted on the TSM server,
perhaps due to an insufficient number of mount points.
If there is a problem with the server, contact your
System Administrator for further assistance.
ANS1814E

Unable to start the scheduled event

'event-name'

Explanation: The scheduled event is no longer valid

on the server. Either the window has elapsed or the
schedule has been deleted.
System action: The client scheduler queries the server
to obtain the next scheduled event.
User response: If the problem continues, contact your
system administrator to correct the problem on the
server.
ANS1815E

Either the window has elapsed or the

schedule has been deleted

Explanation: Scheduled event was no longer valid on

the server.
System action: The client scheduler queries the server
to obtain the next scheduled event.
User response: If the problem continues, see your
system administrator to correct the problem on the
server.
ANS1816E

Invalid scheduling mode

Schedule function can only be run by a

TSM authorized user.

Explanation: An attempt to use the schedule function

failed because of improper authority.
System action: Processing stopped.
User response: See the TSM authorized user for
schedule function information.
ANS1818E

The SCHEDULE command is not

allowed in LOOP (interactive) mode.

Explanation: The SCHEDULE command may only be

given on the inital command line. Enter the HELP
SCHED command for a complete description of the
SCHEDULE command.
System action: The client does not execute any
scheduled events.
User response: Start the scheduler from the OS
prompt. For example: dsmc schedule Windows clients
can also use the client scheduler service. Read the client
manual for information on how to use the SCHEDULE
command and how to use the TSM client scheduler
features.
ANS1819E

The TSM server was unable to register

the address for this node.

Explanation: This is a rare situation, and is usually an

indication of a problem with the TSM server.
System action: Processing stopped.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Ask your TSM server administrator to check the TSM
server activity log for any messages that might indicate
a problem on the server. Try to correct any indicated
problems, then try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS1820E

Command line options must be

preceded by a '-'

Explanation: An option was specified without a ''

delimiter.
System action: Processing stopped.
User response: Enter the command again with a dash
preceding each option.

Explanation: The mode entered for the scheduled

event was not correct.
System action: Event does not occur.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

109

ANS1821E

Unable to start POSTSCHEDULECMD/

PRESCHEDULECMD 'command'

ANS1826E

Unable to open trace output file

file-name.

Explanation: The requested action required a new

process to be created. Either an option or a schedule
action that requested an operating system command
to be executed was entered.

Explanation: A TRACEFILE option in the user

configuration file or on the command line used a
directory path and file-name combination to which you
do not have write access.

System action: Request is ignored.

System action: Client program did not initialize.

User response: Remove the request from the options

file or the schedule defined on the server.

User response: Change the TRACEFILE value so that

it is a location to which you have write access.

ANS1822E

ANS1827W

Too many objects were selected for

restore. Please select less than
max_objects objects

Explanation: The restore cannot be performed,

because too many objects were selected.
System action: The restore is not performed.
User response: Retry the operation after reducing the
number of objects selected.
ANS1823E

The TESTFLAGS or TRACEFLAGS

option specifies unknown flag name
'keyword' or the value supplied is invalid
for the named keyword.

Explanation: Either the testflag or traceflag name is

incorrectly spelled, or the value supplied for that flag is
not valid.
System action: If the TESTFLAGS or TRACEFLAGS
option was specified in the client options file or on the
command line during client initialization, the the client
program does not start. If the option was specified
from the command line client while running in LOOP
(interactive) mode, then the operation does not run.
User response: Correct the TESTFLAGS or
TRACEFLAGS flag name or correct the value specified
for the TESTFLAG keyword shown in the message.
These options are typically used at the direction of IBM
technical support or as specified in the TSM Problem
Determination Guide. If you are not sure which flag
names to use, review the TSM Problem Determination
Guide for additional information or contact IBM
technical support for further assistance.
ANS1824E

Invalid trace file name (name too long).

Explanation: A TRACEFILE option in the preferences

files used a file name that is too long.

Directories cannot be selected with the

table of contents currently loaded on the
server.

Explanation: The table of contents that is currently

loaded on the server for this volume does not contain
objects corresponding to the one and only point-in-time
backup. It contains an incomplete point in time or
multiple points in time.
System action: The directory is not selected for
restore.
User response: To be able to select an entire directory
for restore, select "Use Latest" or "Use Point in Time"
from the Point in Time dialog.
ANS1828E

Screen size is too small for using the

PICK option.

Explanation: You cannot use the PICK option on a

workstation that has a screen smaller than 20 characters
across and 10 lines down.
System action: TSM did not complete the operation.
User response: Retry the operation using a
workstation that has a screen with the minimum size,
or do not use the PICK option.
ANS1830E

Unable to write to trace file tracefile.

Tracing disabled.

Explanation: An error occurred when writing to the

specified tracefile.
System action: Tracing is disabled. Processing
continues.
User response: Ensure the device that the tracefile
access is available and has sufficient space for the
tracefile. Retry the command.

System action: Client program did not initialize.

ANS1831E

User response: Change the file name used as the

TRACEFILE so that it is equal to or less than 255
characters in length.

Explanation: The password expired.

Password expired. The administrator for

this system must run TSM to update the
password.

System action: TSM ends.

110

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: The administrator for this system must

update the password.

ANS1837S

ANS1832W

Explanation: The specified filespace-name in the system

options file is invalid.

The option 'option' is no longer

supported and will be ignored by TSM
client in this release. This option will be
removed in the next release and will no
longer be valid. Please remove it from
your option file.

Explanation: The specified option is in the process of

being made obsolete and will be ignored by the client
in this release. This option will be removed in the next
release and will no longer be valid.
System action: Processing continues.
User response: Remove the option from the option
file. Also check the documentation to see if this option
has been replaced by a newer option.
ANS1834S

Unable to write to 'file-name' for storing

password

File space filespace-name is ignored.

Processing continues.

System action: TSM attempts to continue the current

operation.
User response: Check the file space in the system
options file and use a valid file space. Retry the
operation.
ANS1838E

Error opening user specified options file

'filespace-name' .

Explanation: The specified options file-name could not

be located or opened.
System action: TSM attempts to open default option
file.
User response: Make sure specified option file exists
and is valid.

Explanation: TSM cannot write to the specified

file-name.

ANS1839E

System action: Processing continues.

Explanation: An error occurred in setting up the input

file (for example, the terminal) to be read.

User response: Check access permissions and disk

space. If unsuccessful, see your system administrator.

System action: Processing stopped.

Cannot read password.

User response: Check the attributes of the terminal.

ANS1835E

PASSWORDACCESS is GENERATE,
but password needed for server
'server-name'. Either the password is not
stored locally, or it was changed at the
server.

Explanation: Either the password is not stored locally,

or it was changed at the server.
System action: TSM prompts you for the password if
TSM is running in the foreground.
User response: If TSM was running as a background
process, issue any TSM command from the foreground.
Enter the password in answer to the prompt. Then try
your background TSM command again.
ANS1836I

Unable to process Processor Value Unit

hardware scan info file 'file name', errno,
cause.

Explanation: The internal-use data file was not

readable.
System action: Processor Value Unit information is
not sent to the IBM Tivoli Storage Manager server.
Processing continues.

ANS1852E

Server could not load the table of

contents. Status: status reason: reason

Explanation: A failure occurred when the server

attempted to load a file-level Table of contents for an
NDMP volume. No file-level queries can be performed
against the volume until the problem is solved.
System action: The table of contents is not loaded.
User response: Check the server Activity Log to
determine the cause of failure. Retry the operation after
correcting the problem.
ANS1853E

Server could not load the Table of

Contents. Status: status

Explanation: A failure occurred when the server

attempted to load a file-level Table of contents for an
NDMP volume. No file-level queries can be performed
against the volume until the problem is solved.
System action: The table of contents is not loaded.
User response: Check the server Activity Log to
determine the cause of failure. Retry the operation after
correcting the problem.

User response: No response is necessary. This does

not affect regular processing. Correct any file access
permission issues and try the command again. If the
file exists, delete the file and try the command again.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

111

ANS1862W

No table of contents information is

available on the server for this volume.

Explanation: No objects for the selected volume exist

on the server that were backed up with table of
contents information. Consequently no file-level queries
can be performed against the volume.
System action: none
User response: If file-level information is desired, use
TOC option during backup.
ANS1865E

Session rejected: Named Pipes

connection failure.

Explanation: An attempt to connect to the server

using Named Pipes communications failed. This might
have occurred if an incorrect NAMEDPIPENAME was
specified in the options files or if your system
administrator canceled a backup operation.

ANS1870E

Explanation: The failure is reported from the NDS

ResolveName() function. It indicates a communication
failure between TSANDS and the partition on which
the object resides.
System action: Object skipped.
User response: Check the TSM client README file for
information on required NetWare software levels, and
verify that those levels are installed. Reducing the
RESOURCEUTILIZATION client setting might also
help avoid this error. If the problem persists, contact
Novell technical support for further assistance
regarding the FFFDFEAF return code.
ANS1871W

System action: Processing stopped.

User response: Retry the operation, or wait until the
server comes back up and retry the operation. Ensure
that the value specified on the NAMEDPIPENAME
option is the same as the one used by the server. If the
problem continues, contact your system administrator
for further help.
ANS1867E

The server generated a CRC for verb

type CRC verb which does not match the
received verb verb received.

Explanation: A cyclic redundancy check (CRC) failed

between TSM client and server communication.
System action: The current object is skipped.
Processing continues with the next object.
User response: This is an unusual condition, and
could indicate a communications problem between the
TSM client and server. Try the operation again. If the
problem persists, contact IBM for further assistance.
The NDS object requires its parent, or
container, to be present before this
object can be restored. Try first restoring
the parent of this object.

Explanation: SMS requires the parent of the object

(container) to be present before the child or object can
be created.
System action: Processing stops.
User response: Retry restoring, but at least one level
up. For instance, restore 'dir\.o=ibm\*' instead of
'dir\ou=gpl.o=ibm\*'.

The server CRC version is server CRC

version which does not match the client
version client CRC version.

Explanation: This is a rare situation. The server and

client are using different versions of cyclic redundancy
check (CRC) algorithms.
System action: Processing continues without CRC
checking.
User response: Clients can be no more than one
version downlevel from the TSM server. Make sure the
client and server are at compatible levels. The
command line client displays both client and server
versions when the client starts and connects to the
server. The QUERY SESSION command will also
display the server version. From the GUI, use the
\"Help/About\" menu item to identify the client
version, and the \"File/Connection Information\"
menu item to identify the server version. If the client
and server versions are incompatible, then the TSM
server administrator can turn off CRC checking for
your node.
ANS1872E

ANS1869E

NDS transport failure FFFDFEAF has

occurred. Contact Novell technical
support for further assistance.

Unable to connect to NetWare target

service 'server-name'. Make sure the TSA
NLM is loaded on the specified
machine.

Explanation: TSM interacts with the Target Service

Agent (TSA) and the connection cannot be made to the
Netware server-name.
System action: Processing stopped.
User response: Ensure that the TSA is loaded and
retry the TSM command.
ANS1873E

An unknown error occurred while

processing system object 'sys-obj-name':
utility function 'func-name' failed with
error error

Explanation: An unknown error occurred while

112

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

processing a system object. The error information

captured indicates the reason for the failure. This
information can be used to diagnose the problem.
System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.
ANS1874E

Login denied to NetWare Target Service

Agent 'server-name'.

Explanation: The connection to the Target Service

Agent (TSA) requires a NetWare user name and a
password. The password you entered at the prompt
may be incorrect.

exceeds the maximum input string size of 1024 bytes.

System action: TSM truncated the string to the
maximum possible length of 1024, then continued with
the operation. The operation may fail later due to this
truncation.
User response: Check the client error log for other
messages that might have been logged after this
message was written, and take any corrective action
suggested by those messages. If the problem persists,
contact IBM support for further assistance.
ANS1878E

System action: Processing stopped.

User response: Retry the TSM command, supplying
the correct LAN password.
ANS1875E

Unable to connect to target service. Out

of memory.

Explanation: Not enough memory to connect to the

Target Service Agent (TSA).
System action: Processing stopped.

An unknown error occurred while

processing system object 'sys-obj-name':
Service 'service-name' and its dependent
services could not be stopped.

Explanation: An unknown error occurred while

processing a system object. The service listed in the
message and all of its dependent services could not be
stopped. Processing cannot complete until the service is
stopped.
System action: TSM ended the current operation.
User response: Manually stop the service and retry
the operation.

User response: Either add memory to the server or

free memory by unloading some programs, or by
restarting the server.

ANS1879E

ANS1876E

Explanation: TSM received an unexpected error from

the Novell TSA interface. All TSA errors between
0xFFFDFE70 and 0xFFFDFEFF, inclusive, can generate
this error message.

TSM is unable to connect to the

NetWare target service. NetWare SMS
return code = value.

Explanation: The NetWare SMS return code was

unexpected.
System action: Processing stopped.

A NetWare NDS error occurred during

restore processing: object
'nds_objectnds_object' TSA error 'tsa_error',
tsa_error_text

System action: The object is skipped. Processing

continues.

User response: Messages ANS1874E, ANS1876E and

ANS2025E can all be issued due to related problems.
These problems might include: 1) The NetWare server
has an insufficient number of NetWare user licenses. 2)
The NetWare license files are corrupt. The NetWare
license files can be reinstalled. 3) A NetWare typeful
name is not being provided at the NetWare User
prompt. 4) The TSM password file is corrupt. In this
situation, quit all TSM processes, delete or move the
*.PWD files that are located in the TSM installation
directory, then load dsmc and run the following
commands: QUERY SESSION QUERY TSA QUERY
TSA NDS.

User response: Check the Novell web site for any

additional information about the error, as a fix might
already be available. Contact Novell technical support
for further assistance.

ANS1877E

System action: If the failure is a 'Login Denied' the

user will be prompted for a Novell NetWare Userid
and Password, and a password file will be created.

The parsed string is too long for TSM to

process and has been truncated to
prevent a buffer overflow.

Explanation: This is a rare condition. A very long

string would have to be entered by the user in a
command line, dsm.opt file, or filelist. This string

ANS1880E

TSA Connect error,

NWSMConnectToTargetService
'TSA_Target_Service' password file
'password_file'. Userid = 'NetWare_userid'
failed with cc = TSA_ccode

Explanation: TSM received an unexpected error from

the Novell TSA interface while processing the userid
and password from NWPWFILE.

User response: The cc is returned from the TSA which

belongs to Novell NetWare. If you get cc = FFFDFFD7
'Login Denied', please check the following:
Chapter 2. ANS 0001-9999: Client messages, version 6.3

113

The user-id has been disabled.

The user-id/password is invalid or expired.
The user-id has inadequate security access.
The user-id has insufficient rights to files and
directories.
The user-id specified has a login restriction based
on time-0f-day.

ANS1892W

Expire command is not allowed on the

TSM journaled filespace 'filespace'.

Explanation: You cannot expire files from the server

on a TSM journaled filespace.
System action: The expire command will not work on
this filespec

The user-id specified has a Network address

restriction.

User response: If you want to expire this filepec

remove it from the local filesystem.

The user-id specified has a login restriction based

on number of concurrent connections.

ANS1895I

NetWare is not allowing logins (DISABLE LOGIN

was issued at the console).
If you are unable to determine what is wrong, report
the problem to your service representative.
ANS1881E

TSM is unable to use NWPWFILE

'password_file' to connect TSA target
service 'TSA_Target_Service', the file is
corrupted.

Explanation: TSM could not use the NWPWFILE to

connect to Novell TSA interface. The file was
corrupted.
System action: User will be prompted for Novell
NetWare Userid and Password, and password file will
be created.
User response: The file can be corrupted via another
application or hardware failures. If problem is
persistent contact your service representative. A copy of
the corrupted password file will be needed. This
corrupted file must be preserved before you enter a
new userid and password, because TSM will overwrite
the corrupted file with correct information.
ANS1882E

Unable to stop service 'service-name';

error error

Explanation: The service could not be stopped by the

program.
System action: TSM ended the current operation.
User response: Manually stop the service and retry
the operation.
ANS1891W

SUBDIR is not a valid option when

using FILELIST, SUBDIR will be
ignored.

Highest macro return code was return

code value.

Explanation: This message is issued after all

commands in a client macro have completed. The
return code represents the highest return code that was
issued during processing of the macro. In order of
increasing severity, the return code meanings are:
0 - The command completed successfully
4 - One or more files were skipped
8 - One or more warning messages were issued
12 - One or more error messages (except for skipped
files) were issued
System action: None.
User response: For return codes other than 0, the user
may wish to verify the results of the client operation(s)
and take diagnostic and repair actions, as necessary.
ANS1896I

***** Restored number objects *****

Explanation: Indicates the number of objects TSM has

restored. During a restore session, the running total is
periodically printed to the screen of a command line
client.
System action: Continue with restore.
User response: None.
ANS1897I

***** Retrieved number objects *****

Explanation: Indicates the number of objects TSM has

retrieved. During a retrieve session, the running total is
periodically printed to the screen of a command line
client.
System action: Continue with retrieve.
User response: None.
ANS1898I

***** Processed count files *****

Explanation: When Specifying FILELIST each entry is

a single object and so SUBDIR will not apply.

Explanation: TSM has processed the specified number

of files.

System action: The option SUBDIR is ignored.

System action: Processing continues.

User response: You may have either a -FILELIST or

SUBDIR on this command, but not both.

User response: None.

114

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1899I

***** Examined count files *****

Explanation: TSM has examined the specified number

of files.
System action: Processing continues.
User response: None.
ANS1900I

Return code is return code value.

Explanation: The return code has been issued for the

preceding client command. In order of increasing
severity, the return code meanings are:
0 - The command completed successfully
4 - One or more files were skipped
8 - One or more warning messages were issued
12 - One or more error messages (except for skipped
files) were issued
The return code indicates the highest severity message
that was issued during execution of the client
command. For a scheduled event, the event will be
considered successful if the return code is 0, 4, or 8.
The event will be considered to have failed if the return
code is 12.
System action: None.
User response: For return codes other than 0, the user
may wish to verify the results of the client operation
and take diagnostic and repair actions, as necessary.
ANS1901I

Highest return code was return code

value.

Explanation: This message indicates the highest return

code of all the client commands that were executed. In
order of increasing severity, the return code meanings
are:
0 - The command completed successfully
4 - One or more files were skipped
8 - One or more warning messages were issued
12 - One or more error messages (except for skipped
files) were issued
System action: None.
User response: For return codes other than 0, the user
may wish to verify the results of the client operation(s)
and take diagnostic and repair actions, as necessary.
ANS1902E

The PRESCHEDULECMD command

failed. The scheduled event will not be
executed.

Explanation: The command specified by the

PRESCHEDULECMD option must complete
successfully in order to execute the scheduled event. If
the command completed with a return code of 0 (zero),
it is considered to have completed successfully. If the
command completed with any other return code, it is
considered to have failed. If the command failed then
the scheduled event is not executed.

System action: The client does not execute the

scheduled event, and the result code of the scheduled
event will be 12.
User response: Identify and repair the problem that
caused the command to fail. If it is not necessary for
the command to complete before starting the scheduled
event, then consider using the PRENSCHEDULECMD
option, which does not require that the command
complete successfully. If a non-zero return code is
normal for this command, then consider wrapping the
command in a script that always exits with a return
code of zero.
ANS1903W

The POSTCHEDULECMD command

failed.

Explanation: If the command specified by the

POSTSCHEDULECMD option completed with a
non-zero return code, then the scheduled event is
considered to have completed successfully, but with a
warning-level result. Note that the result of the
POSTSCHEDULECMD command will not supercede a
higher result from the scheduled client command. For
example, if the scheduled client command completed
with a return code of 12, the scheduled event will be
considered to have completed with a return code of 12,
regardless of the outcome of the POSTSCHEDULECMD
command.
System action: At a minimum, the result code of the
scheduled event is 8.
User response: Identify and repair the problem that
caused the command to fail. If it is not necessary for
the command to complete before posting the result of
the scheduled event, then consider using the
PRENSCHEDULECMD option. If a non-zero return
code is normal for this command, then consider
wrapping the command in a script that always exits
with a return code of zero.
ANS1904E

The archive description may not contain

any wildcard characters like '?' or '*'.

Explanation: Descriptions for archive files must not

contain wildcard characters.
System action: Processing stopped.
User response: Enter an archive description that does
not contain wildcard characters.
ANS1905E

There was a NetWare SMS error

processing 'filespace-name
path-namefile-name': error-text

Explanation: TSM received an unexpected error from

the Novell SMS interface.
System action: The object is skipped. Processing
continues.
User response: Check the Novell web site for any
Chapter 2. ANS 0001-9999: Client messages, version 6.3

115

additional information about the error, as a fix might

already be available. Contact Novell technical support
for further assistance.
ANS1906I

Destination must be specified for this

operation when using FROMNODE.

Explanation: You must specify a destination with a

Restore/Retrieve command when using FROMNODE
processing.
System action: Processing stops.
User response: Retry the Restore/Retrieve command
with a destination specified.

User response: Identify and repair the problem that

caused the command to fail. If a non-zero return code
is normal for this command, then consider wrapping
the command in a script that always exits with a return
code of zero.
ANS1912E

An invalid registry hive was specified.

Explanation: The specified registry hive is invalid.

System action: Processing stopped.
User response: Correct the command and retry the
operation.

For example, with the Windows backup-archive client:

ANS1913E

restore -fromnode=cougar \\cougar\d$\projx\*

d:\projx\

Explanation: The specified registry subkey is invalid.

Or, with the UNIX and Linux backup-archive clients:

System action: Processing stopped.

restore -fromn=node1 -fromo=ann "/home/proj/*"

/home/gillis/

User response: Correct the command and retry the

operation.

ANS1907E

ANS1914E

An error occurred while trying to

perform an object merge operation on
the server.

Explanation: For NetWare clients: The TSM server is

unable to perform a NetWare long name conversion.
For Unix or Windows image backup: The group used
to store associated image components could not be
closed.

An invalid registry subkey was

specified.

The specified subkey isn't valid for the

specified hive.

Explanation: The specified registry subkey is invalid

for the specified registry hive.
System action: Processing stopped.
User response: Correct the command and retry the
operation.

System action: The operation ends.

User response: For NetWare: It is possible that a more
current level of the TSM server can perform the
conversion. Contact your TSM server administrator for
assistance. For Unix or Windows: This error indicates
an authorization problem. Contact your TSM server
administrator for assistance. If the problem still cannot
be resolved, contact IBM technical support for further
assistance.
ANS1908I

The scheduled command completed

successfully.

ANS1915E

Too many arguments specified for the

BACKUP REGISTRY command.

Explanation: Too many arguments were specified for

the BACKUP REGISTRY command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
ANS1916E

Too many arguments specified for the

RESTORE REGISTRY command.

Explanation: The scheduled command completed with

return code of zero, which is interpreted as success.

Explanation: Too many arguments were specified for

the RESTORE REGISTRY command.

System action: The scheduled event is successful. The

result code for the event is 0.

System action: Processing stopped.

User response: None.

User response: Correct the command and retry the

operation.

ANS1909E

ANS1917E

The scheduled command failed.

Explanation: The scheduled command completed with

a non-zero return code, which is interpreted as failure.
System action: The scheduled event is failed. The
result code for the event is 12.

116

Too few arguments specified for the

BACKUP REGISTRY command.

Explanation: Too few arguments were specified for

the BACKUP REGISTRY command.
System action: Processing stopped.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Correct the command and retry the

operation.

ANS1924E

The specified system object is not valid.

Explanation: The specified system object is not valid.

ANS1918E

Too few arguments specified for the

RESTORE REGISTRY command.

Explanation: Too few arguments were specified for

the RESTORE REGISTRY command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
ANS1919E

The specified eventlog is not valid.

Explanation: The specified eventlog is not valid.

System action: Processing stopped.

System action: Processing stopped.

User response: Correct the command and retry the
operation.
ANS1925E

The specified system object type is not

valid.

Explanation: The specified system object type is not

valid.
System action: Processing stopped.
User response: Correct the command and retry the
operation.

User response: Correct the command and retry the

operation.

ANS1926E

ANS1920E

Explanation: The specified system object type is only

valid on Windows NT.

Too many arguments specified for the

BACKUP EVENTLOG command.

Explanation: Too many arguments were specified for

the BACKUP EVENTLOG command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
ANS1921E

Too many arguments specified for the

RESTORE EVENTLOG command.

The specified system object type is only

valid on Windows NT.

System action: Processing stopped.

User response: Correct the command and retry the
operation.
ANS1928E

Server-initiated sessions are not

available in the LAN-free mode.

Explanation: Conflicting options

SESSIONINIT=serveronly and ENABLELANFREE=yes
were specified. This combination is not allowed.

Explanation: Too many arguments were specified for

the RESTORE EVENTLOG command.

System action: Processing stops.

System action: Processing stopped.

User response: Use client-initiated sessions or disable

LAN-free.

User response: Correct the command and retry the

operation.
ANS1922E

Too few arguments specified for the

BACKUP EVENTLOG command.

Explanation: Too few arguments were specified for

the BACKUP EVENTLOG command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
ANS1923E

Too few arguments specified for the

RESTORE EVENTLOG command.

ANS1929E

An error occurred saving the registry

key.

Explanation: The active registry key cannot be copied

to the ADSM.SYS staging directory.
System action: The registry backup operation stops.
User response: Check the space available on the
Windows boot partition to ensure there is room to
contain a copy of the Windows registry. This might
require several megabytes of free space. Also check the
Windows permissions on the ADSM.SYS staging
directory and ensure that the Windows user which you
are using to run TSM has full access to that directory
and its contents.

Explanation: Too few arguments were specified for

the RESTORE EVENTLOG command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

117

ANS1930W

TSM Express client view not supported

with a TSM Enterprise server.
CLIENTVIEW option ignored.

Explanation: The TSM Express client view is only

supported when going to a TSM Express server. When
a TSM Express client connects to a TSM Enterprise
server, the CLIENTVIEW option is ignored, and the
TSM Standard client view is displayed instead.
System action: The CLIENTVIEW option is ignored
and the TSM Enterprise client view is displayed.

User response: Verify that the backup set name is

correct.
ANS1935E

Too many arguments specified for the

BACKUP NTDS command.

Explanation: Too many arguments were specified for

the BACKUP NTDS command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.

User response: If you intend to use the TSM

Enterprise server, then update your CLIENTVIEW
option to a value of STANDARD. Otherwise, update
your TCPSERVERADDRESS option to point to your
TSM Express server.

ANS1936E

ANS1931E

System action: Processing stopped.

An error saving one or more eventlogs.

Explanation: An error occurred saving one or more

eventlogs.

Not enough arguments specified for the

BACKUP NTDS command.

Explanation: Not enough arguments were specified

for the BACKUP NTDS command.

User response: Correct the command and retry the

operation.

System action: Processing stopped.

User response: Correct the command and retry the
operation.
ANS1932E

An error occurred replacing one or more

registry keys.

Explanation: The registry key or keys being replaced

are exclusively held by another process. The registry
keys were previously restored but the system was not
restarted.
System action: processing stops.

ANS1937E

No NTDS server name specified for the

BACKUP NTDS command.

Explanation: No NTDS server name was specified for

the BACKUP NTDS command.
System action: Processing stopped.
User response: Specify NTDS server name at the
command and retry the operation.
ANS1938E

NT Active Directory is not supported in

this OS level.

User response: This error occurs because the registry

key or keys being replaced are exclusively held by
another process. This can happen if the registry keys
were previously restored but the system was not
rebooted. Reboot the system and attempt the restore
operation again.

Explanation: NT Active Directory is not supported in

this OS level.

ANS1933E

ANS1939E

Error accessing file or device 'name'.

Explanation: An error has occurred while accessing

the file or device.
System action: Backup set operation is not completed.
User response: Verify that the file or device exists and
is accessible.
ANS1934E

Backup set 'name' not found.

Explanation: The backup set name was not found on

the server.

System action: Processing stopped.

User response: Install Active Directory before
performing backup operation.
File Replication Service backup failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while backing up files under control of the
Windows 2000 File Replication Service
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the File
Replication Service is operating properly. Restart the
service and retry the backup operation.

System action: The backup set operation is not

processed.

118

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS1940E

File Replication Service restore failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while restoring files under control of the
Windows 2000 File Replication Service
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the File
Replication Service is operating properly. Restart the
service and retry the restore operation.
ANS1941E

System action: Processing stopped.

User response: Examine the Windows 2000 File
Replication Service Event log to insure the system
volume was successfully initialized. Restart the service
and retry the backup operation
System Volume restore failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while restoring files under control of the
Windows 2000 File Replication Service
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the system
volume was successfully initialized. Restart the service
and retry the restore operation.
ANS1943E

The operation is not supported:

Downlevel server version.

Explanation: The operation cannot be performed

because server version is downlevel.
System action: Processing stopped.
User response: Use correct server version.
ANS1944E

Error accessing file or device.

Explanation: An error has occurred while accessing

the file or device.
System action: Backup set operation is not completed.
User response: Verify that the file or device exists and
is accessible.
ANS1945E

System action: Processing stopped.

User response: Add the long namespace support to
the volume or rename(remove) the corresponding
server filespace.

System Volume backup failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while backing up files of the Windows 2000
System Volume

ANS1942E

Explanation: TSM has detected that the server

namespace is NTW:LONG, but the local volume does
not have long name support. If you would like to back
up the volume using the short names, rename the
filespace on the server. If you would like to back up
using long names, add the long namespace support
back to the volume in question.

The long namespace has been removed

from the local filespace. If you wish to
proceed with the backup/archive
operation, rename your filespace on the
server.

ANS1946W

File exists, skipping

Explanation: The client tried to restore or retrieve the

specified file, but the file already existed in the target
restore location and the user chose not to replace the
existing file.
System action: The file is skipped, a message is
logged in dsmerror.log, and restore or retrieve
processing continues with the next object.
User response: The file was skipped because either
REPLACE NO was in effect, causing all existing files
and directories to be skipped, or REPLACE PROMPT
was in effect, and when prompted, the user chose to
skip this file or all existing directories and files. No
additional action is necessary if the decision to skip the
file was deliberate. Otherwise the operation can be
retried using either REPLACE ALL (automatically
replace existing directories and files) or REPLACE
PROMPT (prompt the user whether to replace the file).
ANS1947W

The following directory exists and is

skipped: file-space_name directory_path
directory_name

Explanation: The client tried to restore or retrieve the

specified directory. The directory exists in the target
restore location and the user chose not to replace the
existing directory.
The directory can be skipped because the option
REPLACE=NO is set, which causes all existing files and
directories to be skipped. The directory can be skipped
because option REPLACE=PROMPT is set, and the user
chooses to skip this directory when prompted.
System action: The directory is skipped, a message is
logged in the dsmerror.log log file, and restore or
retrieve processing continues with the next object.
User response: No additional action is necessary.
To replace the files, try the operation again and set
option REPLACE=ALL. You can set
REPLACE=PROMPT and when prompted, choose to
replace the directory.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

119

ANS1948E

The Microsoft volume shadow copy

system components could not be
queried.

Explanation: IBM Tivoli Storage Manager encountered

an error while querying the system writers under
control of the Windows volume shadow copy service.
The TSM error log and Windows event log might
contain additional information about this error.
System action: Processing stops.
User response: Try the operation again. If the error
persists, review the TSM error log and Windows event
log for information related to this error. You might
need to restart the volume shadow copy service, then
try the operation again. It might be necessary to reboot
the machine to clear the volume shadow copy error
state.

ANS1951E

Explanation: IBM Tivoli Storage Manager encountered

an error while restoring with the Microsoft Volume
Shadow Copy Service.
System action: processing stops.
User response: Review the TSM error log and
Windows event log for information related to this error.
Restart any failing system service indicated in the
Windows event log. Restart the volume shadow copy
Service. You can use the Windows command
VSSADMIN LIST WRITERS to determine the status of
the volume shadow copy service. It might be necessary
to reboot the machine to clear the Volume Shadow
Copy error state.
ANS1952E

ANS1949E

Microsoft volume shadow copy

snapshot initialization failed.

Restore using Microsoft volume shadow

copy failed.

Invalid symbolic link destination

'file-name' entered

Explanation: IBM Tivoli Storage Manager encountered

an error while initializing the Microsoft Volume
Shadow Copy Service for backup or restore. The TSM
error log and Windows event log can contain
additional information about this error.

Explanation: You entered a restore/retrieve

destination file-name specification that is a symbolic
link. To restore to symbolic link, make sure you set the
followsymbolic option to yes. Also, check where this
symbolic link points. You can restore/retrieve to a
symbolic link that points to an existing object.

System action: processing stops.

System action: Processing stopped.

User response: Try the operation again. If the error

persists, review the TSM error log and Windows event
log for information related to this error. Use the
Windows command VSSADMIN LIST WRITERS to
determine the status of the Volume Shadow Copy
service. You can reboot the machine to clear the volume
shadow copy error state. If the system is a Domain
Controller and the Active Directory service is stopped,
restarting the Active Directory service will resolve the
issue.

User response: Enter a correct file specification.

ANS1950E

Backup using Microsoft volume shadow

copy failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while performing a backup operation using the
Microsoft volume shadow copy service. The TSM error
log and Windows event log might contain additional
information about this error.
System action: processing stops.
User response: Review the TSM error log and
Windows event log for information related to this error.
Restart any failing system service indicated in the
Windows event log. Restart the volume shadow copy
Service. You can use the Windows command
VSSADMIN LIST WRITERS to determine the status of
the volume shadow copy service. It might be necessary
to reboot the machine to clear the Volume Shadow
Copy error state.

120

ANS1954E

Backup processing of 'file-space name'

finished with failures.

Explanation: This message indicates that the file

system backup has completed, but encountered errors
during backup processing.
System action: Processing continues.
User response: Examine the client error log for
additional messages related to errors in backing up the
file system. Take any corrective action as suggested by
the messages.
ANS1956E

Too few arguments specified for the

BACKUP GROUP command.

Explanation: Too few arguments were specified for

the BACKUP GROUP command.
System action: Processing stopped.
User response: Correct the command and retry the
operation.
ANS1957E

Showmembers and inactive are

mutually exclusive parameters on a
query.

Explanation: Showmembers and inactive are mutually

exclusive parameters on a query.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Processing terminates.

User response: Specify one of the mutually exclusive
parameters on the query
ANS1958W

No base group found, attempting a full

backup.

Explanation: A differential backup requires a previous

full backup to have been performed.
System action: Processing continues, and a full
backup is attempted.
User response: None. Perform a full backup before
attempting a differential backup

ANS1963E

WAS Filesweep failed for filespec 'name'

Explanation: Could not obtain the list of files to be

backed up for the indicated filespec
System action: Processing stops
User response: Verify that the process has access to
the indicated filespec and retry the operation.
ANS1964E

A failure occurred while contacting the

WebSphere component-name.

Explanation: The attempted operation on the

WebSphere component failed.
System action: Processing stops

ANS1959I

Removing previous incomplete group

'name' Id:hi-lo

User response: Check the error log for more details.

Explanation: A previous group backup failed without

cleaning up the temporary groups correctly.

ANS1971E

System action: The previous incomplete groups are

removed and processing continues.

Explanation: The remote client agent cannot be

started. This error message is usually preceded or
followed by other messages.

User response: None.

The remote client agent (dsmagent)

could not be started.

System action: Processing is stopped.

ANS1960I

Contacting the WebSphere

component-name. This step could take a
few minutes...

Explanation: The application needs to contact the

WebSphere component to obtain configuration
information.
System action: Processing continues

User response: Check the error log for any other

messages that might indicate a reason for the failure.
Verify that the web client is installed correctly. Try to
correct any indicated problems, then try the operation
again. If the problem persists, contact IBM technical
support for further assistance.
ANS1972E

User response: None.

ANS1961E

Could not detect any installation of the

WebSphere Deployment Manager or
Application Server.

Explanation: The application could not detect a

supported WebSphere component installed. At this
time, only the WebSphere Deployment Manager and
Application Server are supported.
System action: Processing stops
User response: Verify that the intended WebSphere
component is installed on this machine, and retry the
operation.
ANS1962E

Operation Failed.

Explanation: The attempted operation on the

WebSphere component failed.

The connection to the remote client

agent (dsmagent) failed. Either the port
number could not be read, or the port
number is invalid.

Explanation: An error occurred when trying to read

the port number. A connection to the remote client
agent cannot be made.
System action: Processing stopped.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Verify that the web client is installed correctly. Try to
correct any indicated problems, then try the operation
again. If the problem persists, contact IBM technical
support for further assistance.
ANS1973I

VSS writer for system object 'name' does

not exist. Restore skipped.

System action: Processing stops

Explanation: Microsoft Volume Shadow Copy Service

does not detect a writer for this system component.
Either the component is not installed or is not running..

User response: Check the error log for more details.

System action: Object skipped.

User response: Install or enable the affected system
service and retry the operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

121

ANS1974W

Error removing previous incomplete

group Id:hi-lo

Explanation: A previous group backup failed without

cleaning up the temporary groups correctly, and the
error still can not be cleaned up.
System action: The previous incomplete groups
remain and processing continues.
User response: None.
ANS1975W

TSM server error reason occurred closing

and renaming the group

Explanation: An error was encountered closing and

renaming the temporary group.

ANS1979E

Explanation: The function being used requires a more

current TSM Storage Agent.
System action: The operation fails.
User response: Upgrade your TSM Storage Agent to a
level that supports this function. See error log for
version information.
ANS1980E

System action: The backup is unsuccessful.

User response: Ensure that the user has the proper
authority to update the group and try the operation
again.
ANS1976E

The specified system service is not

valid.

The TSM Storage Agent is downlevel

and does not support the requested
function. See error log for version
information.

The TSM Server and TSM Storage agent

are downlevel and do not support the
requested function. See error log for
version information.

Explanation: The function being used requires a more

current TSM Server and TSM Storage agent
System action: The operation fails.
User response: Upgrade your TSM Server and TSM
Storage agent to a level that supports this function. See
error log for version information.

Explanation: The specified system service is not valid.

System action: Processing stopped.

ANS1981E

User response: Correct the command and retry the

operation.
ANS1977E

Dsmcad schedule invocation was

unsuccessful. This command will be
tried again in 10 minutes.

Explanation: Dsmcad was unable to get the valid

scheduler information from the dsmc schedule process.
This could be due to some problems during the
scheduler initialization, such as incorrect option usage.
System action: Dsmcad will try to invoke the
scheduler again in 10 minutes in order to get the valid
information.
User response: Check the console and error logs to
determine what kind of error occurred during the dsmc
process and correct the problem.

Server :Version ver, Release rel, Level

lev.subl Storage Agent:Version SAver,
Release SArel, Level SAlev.SAsubl

Explanation: This message supplies extra detail to

downlevel messages.
System action: The operation fails.
User response: This message supplies extra detail to
downlevel messages.
ANS1986E

Initialization functions cannot open the

trace file specified.

Explanation: The file "tracefile-name could not be

opened during initialization. The specified path may be
incorrect. It is also possible that the current user does
not have permission to write to the tracefile in the
directory specified. It is also possible that no space is
available at the given tracefile location.
System action: Processing terminates.

ANS1978E

The TSM server is downlevel and does

not support the requested function. See
error log for version information.

Explanation: The function being used requires a more

current TSM Server.
System action: The operation fails.
User response: Upgrade your TSM Server to a level
that supports this function. See error log for version
information.

User response: Make sure the tracefile option points

to a valid path and that the user has proper
permissions to write to the file specified.
ANS1987E

A destination file specification is not

allowed with this command.

Explanation: Of all the system object restore

commands only RESTORE ASR allows the entry of a
destination file specification.
System action: Processing stopped.

122

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Re-issue the command without a

destination file specification.

Additional information regarding the error is usually

placed in the error log.

ANS1988W

System action: The operation might not execute

correctly, depending on the error.

No filespaces are selected for preview.

Explanation: You requested a preview operation

without selecting a client filespace.
System action: TSM cannot perform a preview
without a filespace selected.
User response: Select the volumes you want to
preview and retry the operation.
ANS1989E

Initialization functions cannot open the

Error Log file specified.

Explanation: The Error Log file could not be opened

during initialization. The specified path may be
incorrect. It is also possible that the current user does
not have permission to write to the logfile in the
directory specified. It is also possible that no space is
available at the given logfile location.
System action: Processing terminates.

User response: Check the client error log for any other
messages that might have been logged when this
message was written, and take any corrective action
suggested by those messages. If the problem persists,
contact IBM support for further assistance.
ANS1995W

Explanation: Deleting objects of different types is not

allowed. For example, deleting Backup Sets and regular
file objects at the same time is not possible.
System action: No processing takes place.
User response: Select objects of the same type to
perform delete operation.
ANS1996W

User response: Make sure the logfile option points to

a valid path and that the user has proper permissions
to write to the file specified.
ANS1990W

The 'filesystem name' volume mount point

can not be accessed. The TSM return
code is 'rc'.

Explanation: The client is unable to access volume

mount point. The common reasons for this are that the
account under which the client is running does not
have access to the volume mount point, or the volume
is mounted onto a cluster volume which is currently
not available.
System action: The inaccessible mount point is
skipped and processing continues. with the next mount
point or volume.
User response: Check the error log for additional
messages that might yield additional information about
the problem that prevents access to the volume mount
point. Ensure that the TSM client is running under an
account which as access to the volume mount point.
Ensure that the mount point is not accessing a clustered
volume. Please refer to Microsoft KB Article 280297 for
more information about how to configure volume
mount points on a clustered server.

Objects of different types cannot be

deleted at the same time.

The volume mount points enumeration

on 'filesystem name' volume failed.
Windows system error code: error;
reason: 'error-reason'.

Explanation: The client was unable to scan the

specified volume for volume mount points. The error
information captured indicates the reason for the
failure. A common reason is that the account under
which the client is running does not have access to the
volume.
System action: The processing continues with the next
volume.
User response: Ensure that the client is running under
an account which has access to the volume and volume
mount points. Correct the condition causing the error
and try the operation again. If the problem persists,
contact your system administrator or TSM
administrator for further help.
ANS1997W

No files have been previously backed

up for the VSS component
'component-name'.

Explanation: You tried to restore the Microsoft Volume

Shadow Copy (VSS) System State component which
does not contain file data. This is not necessarily a
problem.
System action: Processing continues.

ANS1991E

An error occurred processing registry

key 'key-name', data value 'value-name'.
See the client error log for additional
information about this error.

User response: Check the error log for any other

messages that occurred during backup. The logs can
indicate a reason for the failure.

Explanation: An unexpected error occurred when the

client tried to read or update the Windows registry.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

123

ANS1998W

Transaction byte limit 'name' is not

supported by the server. Value reset to
limit

Explanation: The TXNBYTELIMIT is larger than the

server supports. The value will be reset to a supported
limit.
System action: TXNBYTELIMIT is reset, and
processing continues.
User response: Set the option to a value supported by
the server.
ANS1999E

type of the operation processing of

'filespace-name' stopped.

Explanation: The client has encountered a condition

where it can not continue processing the specified file
space. The TSM client error log or schedule log should
contain additional messages related to this error.
System action: Processing stops.
User response: Check the TSM client error log and
schedule log for any additional messages related to this
error. Take any corrective action that might be
suggested by the related messages, then try the
operation again. If the problem persists, contact your
TSM administrator for further assistance.
ANS2000I

Unable to convert file names because

MEMORYEFficientbackup option is ON.

Explanation: TSM has detected that a local name

space change has occurred on the volume that is
currently being backed up. TSM would convert the file
names to the new name space, but cannot because the
option MEMORYEFficientbackup, is on.
System action: TSM continues to backup using the old
name space.
User response: Edit the dsm.opt file, and set
MEMORYEFficientbackup to OFF.
ANS2025E

Login failed to NetWare file server

'server-name'.

Explanation: TSM cannot establish an authorized

connection to the Netware file server through NDS.
Connection numbers might be exhausted.
System action: Processing stopped.
User response: Messages ANS1874E, ANS1876E and
ANS2025E can all be issued due to related problems.
These problems might include: 1) The NetWare server
has an insufficient number of NetWare user licenses. 2)
The NetWare license files are corrupt. The NetWare
license files can be reinstalled. 3) A NetWare typeful
name is not being provided at the NetWare User
prompt. 4) The TSM password file is corrupt. In this
situation, quit all TSM processes, delete or move the

124

*.PWD files that are located in the TSM installation

directory, then load dsmc and run the following
commands: QUERY SESSION QUERY TSA QUERY
TSA NDS.
ANS2026W

Bad sectors were detected on the volume

'volname'.

Explanation: Bad sectors are skipped during image

backup/restore operations.
System action: Processing continues.
User response: Make sure the volume data is not
corrupt by using system tools like chkdsk (Windows)
or fsck (Unix).
ANS2032I

The client VM restore is skipping the

unsupported Independent disk : vmdk

Explanation: The VMware vStorage APIs do not

support snapshoting Independent disks, no backups
were created.
System action: Processing continues.
User response: None.
ANS2033I

The client VM restore is skipping the

unsupported physical Raw Device
Mapping (pRDM) disk : vmdk

Explanation: The VMware vStorage APIs do not

support snapshoting physical Raw Device Mapping
(pRDM) disks, no backups were created.
System action: Processing continues.
User response: None.
ANS2034I

The virtual machine backup is skipping

the unsupported physical Raw Device
Mapping (pRDM) disk : vmdk

Explanation: The VMware vStorage APIs do not

support snapshoting physical Raw Device Mapping
(pRDM) disks, backups are not possible.
System action: Processing continues.
User response: None.
ANS2035I

The virtual machine backup is skipping

the unsupported Independent disk :
vmdk

Explanation: The VMware vStorage APIs do not

support snapshoting Independent disks, backups are
not possible.
System action: Processing continues.
User response: None.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2036W

Pruning functions cannot open one of

the Tivoli Storage Manager prune files:
log-name. errno = errno-value,

Explanation: The file "log-name could not be opened

during pruning. The system set the error code
errno-value. If the reason given is "access denied," the
current user does not have permission to write to the
file in the directory specified. It is also possible that no
space is available at the given file location or another
Tivoli Storage Manager process started by different user
id is performing pruning at the same time.
System action: Pruning stops, processing continues.
User response: Set the DSM_LOG (or DSMI_LOG)
environment variable to a directory into which the
current user can write.
ANS2037W

Schedule log pruning failed.

Explanation: The schedule log pruning function

completed with errors.
System action: Processing continues.
User response: Check error log for possible reasons of
failure.
ANS2038W

Invalid option 'option-name' received

from the TSM server client options set.

Explanation: The client received an invalid option

from the TSM server's client option set. Although most
syntax checking for client option set options is done by
the server, there are still errors that can only be
detected by the client. These errors include:

ANS2045I

Explanation: The VMware vStorage APIs do not

support snapshoting templates so no backups can be
made.
System action: Processing stops for this template
User response: Converting the template to a virtual
machine, then making a backup is possible, once the
backup is complete the virtual machine can be
converted back to a template.
ANS2046S

v Missing brackets or directory delimiters.

v Include and exclude patterns that are too complex.
System action: The option is ignored by the TSM
client.
User response: Contact the TSM server administrator
to determine if the option can be removed from the
client option set.
ANS2039E

Invalid destination file specification

'file-name' entered

Explanation: The destination file specification must

end with directory delimiter when performing a file list
restore, or when the restore specification is for more
than one file, or when the option SUBDIR YES is in
effect.

Error 'errtxt' (errno=errno) occurred

trying to write to audit log 'file-name'.
The audit log function is disabled.

Explanation: There was an error encountered writing

to the audit log (for example, there is not enough space
on the disk).
System action: Audit logging is disabled for the rest
of the operation. The return code for the operation is
set to 12 to indicate that the contents of the audit log
are incomplete.
User response: If this is an out of space condition
either free up space on the volume or try to write the
audit log to a volume with more space.
ANS2047E

v Option value is not correct.

v Options that have been retired by newer versions of
the TSM client.

The virtual machine backup is skipping

the unsupported virtual machine
template : name

An unexpected error was encountered

processing a system state/services
request. TSM function name :
function-name TSM function :
function-desc TSM return code : TSM-rc
TSM explanation : TSM-msg TSM file :
file-name (line-number)

Explanation: None.
System action: Processing the system state stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS2048W

Named stream of object

'object-namepath-name file-name' is corrupt.

Explanation: One or more of the file's named streams

are corrupt.
System action: The named stream is not
restored/retrieved.
User response: The backup copy of the named stream
is damaged. The file is restored to as great an extent as
possible, but the file should be examined to verify that
it is usable.

System action: Processing stopped.

User response: Specify a destination that ends with
directory delimiter.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

125

ANS2049W

Named stream of object 'object-name' may

be corrupt.

Explanation: One or more of the file's named streams

may be corrupt.
System action: The named stream is
restored/retrieved to as great an extent as possible.
User response: The backup copy of the named stream
may be damaged. The file is restored to as great an
extent as possible, but the file should be examined to
verify that it is usable.
ANS2050E

TSM needs to prompt for the password

but cannot prompt because the process
is running in the background.

Explanation: If PASSWORDACCESS=PROMPT or if
the password that is stored locally is incorrect, TSM
attempts to prompt the user for the password. The
attempt to prompt the user fails because TSM is
running in the background. When a process is running
in the background, prompting is not allowed.
System action: Processing stopped.
User response: If RUNASSERVICE=YES, do not set
PASSWORDACCESS=PROMPT. Use
PASSWORDACCESS=GENERATE.
ANS2051W

The local snapshot repository was not

found on location.

Explanation: The specified directory for the local

snapshot location does not exist.

real and virtual memory. Close unnecessary

applications.
ANS2054E

Operating system error errno: messagetext.

Explanation: The application encountered an

unexpected message error during the execution of a
system function. The respective operating system error
and message text will be displayed.
System action: Processing stops.
User response: Check the specific error message.
ANS2055I

The local snapshot manager could not

be locked.

Explanation: The local repository is locked by another

application. This process will proceed when the other
application unlock the local repository.
System action: Processing continues.
User response: None.
ANS2056I

Waiting maximal timeout seconds until

the lock is released by the other
application.

Explanation: While the local repository is locked by

another application, the program will wait a specific
period of time to proceed. For example, in the mySAP
environment, the wait period is 1 hour.
System action: Processing continues.
User response: None.

System action: Processing continues.

User response: A new local snapshot repository will
be build in the specified directory.

ANS2057E

ANS2052E

System action: Processing ends.

Information about the disk subsystem is

missing.

Explanation: The local snapshot repository could not

be initialized due to missing information about the disk
subsystem.
System action: Processing stops.
User response: The application ensures that the disk
subsystem is initialized properly. Check for preceding
error messages.
ANS2053E

A memory allocation error has occurred

in file filename, line number linenumber.

Explanation: Enough memory was not available to

continue processing.

Local snapshot manager not initialized.

Explanation: The local snapshot repository was used

without previous initialization.

User response: The system normally ensures that the

local repository is initialized. Check for preceding error
messages.
ANS2058E

The data container with ID dcID could

not be updated in the local repository.

Explanation: During a FlashCopy backup the target

set record in the local repository is updated with the
correspondent properties. A failure occurred during
that process.
System action: Processing ends.
User response: Check for preceding error messages
like memory allocation error or other system error.

System action: Processing ends.

User response: Ensure that your system has sufficient

126

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2059E

Cannot find a target data container that

match with the source data container.

Explanation: During a snapshot type backup or

hardware function, TSM tries to find a target data
container that match to the source data container to
satisfy the operation. A matching target data container
could not be found.

application will decide whether or not that warning

should end the program.
ANS2063W

The local snapshot repository already

exists on the directory location.

Explanation: An application tried to create the local

repository in a directory that already exists.

System action: Processing ends.

System action: Processing may continue.

User response: See the rules for select one of multiple

target data containers. For example, this message will
be displayed if the user is trying to start a FlashCopy
backup of type 'INCR' and all the target sets are being
used for the FlashCopy type 'COPY'. Make sure also
that the target volumes are available to the backup
system and the syntax is correct for the following setup
file parameters: 1. shark_target_volume 2.
shark_copy_service_code 3. java_home_directory 4.
primary_copyservices_servername 5. shark_username 6.
shark_password

User response: The application will decide whether or

not that warning should end the program. Check for
following messages.

ANS2060W

User response: None.

Cannot find a volume in the target data

container dcID to match with the source
srcvol.

Explanation: This warning message indicates that for

the specific source not any target volume could be
found in this target data container that matches for a
FlashCopy operation. If multiple target data containers
are being used, the processing will continue checking
the volumes of the next target data container.
System action: Processing continues.
User response: None.
ANS2061W

The target data container with ID dcid

was not found in the local repository.

Explanation: An inquire of the data container with the

specified ID could not be satisfied because that target
set does not exists in the local repository.

ANS2064I

The local snapshot repository will be

created on the directory location.

Explanation: The local snapshot repository containing

information about the state of the data containers is
being created.
System action: Processing continues.

ANS2065I

The local snapshot repository could not

be created on the directory location.

Explanation: A failure occurred creating the local

snapshot repository.
System action: Processing ends.
User response: Look for a operating system error
message.
ANS2066E

Cannot read the .fct file filename.

Explanation: The .fct file containing the target data

containers was not found or is not accessible.
System action: Processing ends.
User response: Check the name, the path and the
right of the file.

System action: Processing may continue.

User response: The application that is requesting the
inquire will decide whether or not the error should end
the program. Check for following messages.
ANS2062W

Could not find a target data container in

the state state to fulfill the requested
criteria.

Explanation: A data container in the specified state

was not found in the local repository to satisfy specific
criteria requested by the application.
System action: Processing may continue.
User response: Which criteria have been passed is
application specific. Check for following messages. The

ANS2067E

The exception CLsmException was

thrown. Reason: txt.

Explanation: An unexpected error occurred processing

a function of the local snapshot repository.
System action: Processing ends.
User response: Check the specific reason.
ANS2068E

No target LUNs were found for the data

container dcID in the .fct file filename.

Explanation: The program will search in the .fct file

for each specific data container a list of entries with the
label <PREFIX>TARGET_VOLUME where the prefix
depends on the hardware type. Either you have a
wrong label for the target volumes of the specified data
Chapter 2. ANS 0001-9999: Client messages, version 6.3

127

container or this data container in the .fct file does not

have any target LUNs.

ANS2073E

System action: Processing ends.

User response: This error can only occurred if the
application does not have a GUI where the user
provides the input of the target data containers and the
format will automatically be checked. If so, please
check the format of the .fct file.
ANS2069E

Cannot read the file filename of the local

snapshot repository.

Explanation: The system keeps some information

about the state of the data containers locally in a file.
This file was not found or is not accessible.

The file filename of the local snapshot

repository could not be opened for
writing.

Explanation: The system keeps some information

about the state of the data containers in the local
snapshot repository. Opening a file of this repository
occurred an error.
System action: Processing ends.
User response: Check the rights permission of that
file.
ANS2074E

Cannot open user input FlashCopy

target file 'fct_file'.

System action: Processing ends.

Explanation: The FlashCopy target file that the user

provided cannot be read.

User response: Check the name, the path and the

right of the file.

System action: The operation fails.

ANS2070E

The repository state file filename is

empty or has a wrong format.

Explanation: The system keeps some information

about the state of the data containers locally in a file.
This file was found but the expected format of the data
in not correct.
System action: Processing ends.
User response: Normally the system ensures that the
format of this file is correct. Check for preceding error.
ANS2071E

The data container dcID could not be

inserted in the local snapshot repository.

Explanation: The system keeps some information

about the state of the data containers locally in a file.
Inserting an entry for a new data container occurred an
error.

User response: Run the client configuration utility and

provide a valid FlashCopy target user input file.
ANS2075E

Explanation: The volume disk label type is not VTOC.

It is possible that your disk is formatted with an EFI
label. The TSM client on Solaris currently supports only
VTOC disk labels.
System action: The volume is not backed up.
User response: Do not attempt to backup volumes
formatted with a non-VTOC disk label.
ANS2076E

System action: Processing ends.

User response: This is an unexpected error. Check for
preceding error. If not any other error can be seen,
collect the logs and traces and contact the support.
ANS2072E

An unexpected error was encountered

processing a TSM operation using a
hardware or snapshot function. TSM
function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM file : file-name (line-number)

There is no VTOC data available for the

volume. The volume cannot be backed
up.

program-name: Space Managment can not

be added for file system 'filesystem' The
length of the file system name exceeds
the maximum length of 'maxlength'
which can be stored in a DMAPI
attribute.

Explanation: The DMAPI has a limitation in the size

of data that can be stored in a DMAPI attribute. If the
lenght of the file system name exceeds this limit the
TSM client can not add space management to the file
system.
System action: Space management cannot be added to
file system.
User response: Please make sure that the length of the
file system name does not exceed the DMAPI limit.

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.

128

ANS2077E

program-name: Reconcile for file system

'filesystem' can not be started for the
selected mode in a non-scout
environment. Please use Two Way
Orphan Check Reconcile instead.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Explanation: The TSM client reconciliation program

can not be started in orphan check or stub restore
mode when the HSM system is configured to run
without the scout daemon.
System action: Reconcile can not run in a non scout
environment.
User response: If you have configured a non scout
environment you need to use the Two Way Orphan
Check Reconcile.
ANS2078E

System state backup is not allowed

CLUSTERNODE is set to YES.

Explanation: When the CLUSTERNODE option is set

to YES, the backup systemstate command is not valid.
System action: System state backup is stopped.
User response: If the CLUSTERNODE option is
incorrectly set to YES, then change the option to NO
and try the operation again. Otherwise see the
backup-archive client manual for further information
about configuring the client to run in a cluster
environment.
ANS2093E

The remote file system agent is

downlevel and does not support this
operation. NODENAME : node
MULTI-NODE NAME : multi-node
hostname : host TCP/IP address :
tcpaddr:tcpport version :
version.release.level..mod

Explanation: None.
System action: The operation fails.
User response: Upgrade the remote file system agent
to a supported level.
ANS2094W

Unable to assign any database partitions

for back up by the Backup Worker Node
'bkupWrkr'.

Explanation: The list of target LUNs specified by user

for this backup worker node did not match in size any
of the source LUNs for any of the database partitions.
Hence no database partitions could be assigned for
backup to this backup worker node.
System action: Processing continues.
User response: Please assign target LUNs to backup
worker nodes so that they match in size with all the
source LUNs of a particular database partition. Also
distribute the target LUNs among all the backup
worker nodes so that there is a good load balancing of
the number of database partitions backed up by each
backup worker node.

ANS2095E

JAVA HOME value 'target' specified in

configuration is incorrect.

Explanation: The path name specified for java home is

not correct.
System action: Processing ends.
User response: Please check the value of java home
specified during configuration to make sure it is a valid
path name of the directory where JRE is installed on
master backup node. Use configuration wizard to
update java home value for the configuration.
ANS2096E

Unable to read configuration

information for database name 'dbname'.

Explanation: The system was unable to read

configuration information for the database name
specified in the (-DATABASENAME) option.
System action: Processing ends.
User response: Check the spelling of the
(-DATABASENAME) option specified and ensure the
DB2 UDB configuration wizard has been used to create
the configuration information for this name.
ANS2097E

Unable to establish a session with the

TSM server as target node 'target' using
agent node 'agent'.

Explanation: None.
System action: Processing ends.
User response: Ensure that the multi-node name exists
on the server and that the agent node has the proper
authority to target node listed.
ANS2098E

One or more of the node names in the

DB2 UDB TSM configuration file are
not registered correctly as proxynode
agents.

Explanation: None.
System action: Processing stops.
User response: Check the TSM error log for a list of
node names that have been configured incorrectly.
Correct the problem by executing the DB2 UDB
configuration wizard.
ANS2099W

The node name 'nodename' in the DB2

UDB TSM configuration file is not
registered as an agent for target node
name 'targetnode'.

Explanation: None.
System action: Processing continues.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

129

ANS2100E

Neither source volume id nor target

volume id is in the volume list.

Explanation: None.
System action: Processing ends.

ANS2105I

File list entry not Proceessed: File List

Entry

Explanation: A file list operation encounted an error.

This entry from the file list was not processed.

User response: None.

System action: This message is for auditing purposes

only.

ANS2101E

User response: This message is for auditing purposes

only.

Compressed data grew.

Explanation: The size of data is growing after

compression

ANS2150E

System action: Processing continues.

User response: The application must abort the
transaction.
Please turn off compression and try to resend the
object.
ANS2102E

File list processing not started

Explanation: An error occured before the file list

processing was started.

Set
HSMDISABLEAUTOMIGDAEMONS
YES in the dsm.opt file to use HSM
multi-server functionality.

Explanation: Set HSMDISABLEAUTOMIGDAEMONS

YES in the dsm.opt file to use HSM multi-server
functionality.
System action: HSM multi-server processing stops.
User response: Set
HSMDISABLEAUTOMIGDAEMONS YES in dsm.opt.

System action: Processing stops.

ANS2155W

User response: Examine the client error log for

additional messages that might indicate the reason for
the problem. Try to follow the suggested corrective
actions (if any) and try the operation again.

Explanation: File is already coupled to another server.

ANS2103E

File list processing was interupted

Explanation: An error occured suring file list

processing.

System action: HSM continues with normal operation.

User response: Use the correct server to process the
file.
ANS2156E

System action: Processing stops.

User response: Examine the client error log for
additional messages that might indicate the reason for
the problem. Try to follow the suggested corrective
actions (if any) and try the operation again. The error
log will list all entries that were not processed. If audit
logging is enabled, the audit log will also list the
entries that were not processed.
ANS2104E

An error occured after processing the

file list.

Skipping file 'file-name'. File related to

'server-name'.

The server 'server-name' was not added to

the environment.

Explanation: The requested IBM Tivoli Storage

Manager server was not added to the multi-server
environment. There are several causes for this error:
v The file system is not managed by HSM.
v The HSM management is not active for the file
system.
v The file system is out of space.
v The default IBM Tivoli Storage Manager server for
the file system was not yet added to the multi-server
environment.

Explanation: An error occured after the file list

processing completed.

v The IBM Tivoli Storage Manager server name is not

valid.

System action: Processing stops.

System action: HSM multi-server processing stops.

User response: Examine the client error log for

additional messages that might indicate the reason for
the problem. Try to follow the suggested corrective
actions (if any) and try the operation again.

User response: Eliminate the possible causes for this

issue and retry.
ANS2157E

The server 'server-name' was not removed

from the environment.

Explanation: The requested IBM Tivoli Storage

Manager server was not added to the multi-server
environment. There are several causes for this error:

130

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

v The file system is not managed by HSM.

v The HSM management is not active for the file
system.
v The IBM Tivoli Storage Manager server is the default
server for the file system and must be removed last.
v The IBM Tivoli Storage Manager server name is not
valid.
System action: HSM multi-server processing stops.
User response: Eliminate the possible causes for this
issue and retry.
ANS2158E

The server 'server-name' was not added to

the environment. You must first add the
default IBM Tivoli Storage Manager
server ('default-server-name') for this file
system.

Explanation: The requested IBM Tivoli Storage

Manager server was not added to the multi-server
environment. The requested IBM Tivoli Storage
Manager server is not the default server for the file
system.

User response: Check the dsm.sys file for the correct

IBM Tivoli Storage Manager server name.
ANS2162E

HSM cannot be removed from the file

system. The IBM Tivoli Storage
Manager multi-server list is not empty.

Explanation: HSM management was not removed

from the file system.
System action: HSM processing continues.
User response: Remove all IBM Tivoli Storage
Manager servers from the multi-server list before
removing HSM.
ANS2163E

The default IBM Tivoli Storage Manager

server ('server-name') for the file system
will be removed.

Explanation: The default IBM Tivoli Storage Manager

server will be removed. The IBM Tivoli Storage
Manager server list for multi-server will be empty after
this step.

System action: HSM multi-server processing stops.

System action: HSM processing continues without

multi-server support.

User response: Add the default IBM Tivoli Storage

Manager server first.

User response: nothing.

ANS2159I

The server 'server-name' was added to the

environment.

Explanation: The requested IBM Tivoli Storage

Manager server was added to the multi-server
environment.
System action: HSM multi-server processing
continues.
User response: None.
ANS2160I

The server 'server-name' was removed

from the environment.

ANS2165I

The server 'server-name' is the default

server and has been removed last.

Explanation: The requested IBM Tivoli Storage

Manager server was removed from the multi-server
environment.
System action: HSM multi-server processing
continues.
User response: None
ANS2166I

The IBM Tivoli Storage Manager server

'server-name' is not included in the
multi-server environment.

Explanation: The requested IBM Tivoli Storage

Manager server was removed from the multi-server
environment.

Explanation: The requested IBM Tivoli Storage

Manager server is not part of the multi-server
environment.

System action: HSM multi-server processing

continues.

System action: HSM multi-server processing

continues.

User response: None.

User response: None.

ANS2161E

ANS2167W

The server 'server-name' is not a valid

IBM Tivoli Storage Manager server for
this environment.

Explanation: The requested IBM Tivoli Storage

Manager server was not added to the multi-server
environment.
System action: HSM multi-server processing stops.

Can not read SERVERNAME attribute.

Explanation: IBM Tivoli Storage Manager cannot read

the SERVERNAME attribute from file.
System action: HSM multi-server processing
continues.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

131

ANS2168W

Can not write SERVERNAME attribute.

Explanation: IBM Tivoli Storage Manager cannot write

SERVERNAME attribute to file.
System action: HSM multi-server processing
continues.
User response: None.
ANS2169E

Skipping - Requested server is not

included in multi-server environment
for filesystem 'file-system'.

Explanation: The requested IBM Tivoli Storage

Manager server is not part of the multi-server
environment.
System action: HSM multi-server processing
continues.
User response: None.

ANS2202E

Disk Full Error Accessing Disk Cache.

Explanation: A disk full error occurred attempting to

access or write to the specified disk cache file during a
disk cache incremental backup. See the client error log
for more detailed information.
System action: Processing stops.
User response: This error can be resolved by freeing
up space in the file system containing the cache file, or
specifying a different location for the cache file. Use the
diskcachelocation option to specify the location of the
cache file.
ANS2203E

Error Accessing Disk Cache.

Explanation: An error occurred attempting to access

the specified disk cache file during a disk cache
incremental backup. See the client error log for more
detailed information. TSM.
System action: Processing stops.

ANS2170W

Skipping - file linked to another server.

Explanation: The file is already coupled to another

IBM Tivoli Storage Manager server.
System action: HSM continues with normal operation.
User response: Use the correct server to process the
file.
ANS2171E

The DMAPI version 'dmapi-version' is not

supported.

Explanation: The DMAPI version installed on this

node is not supported from the given TSM client.
System action: Due to this issue the affected HSM
process ends.
User response: Use the documentation to identify the
supported DMAPI versions. Install a supported DMAPI
and retry the HSM command or process.
ANS2200I

***** Filling Cache count files *****

User response: None.

ANS2204E

Disk cache restarted.

Explanation: The length of an object name exceeded

the configured disk cache key length during a disk
cache incremental backup. The backup must be
restarted.. TSM.
System action: Backup is restarted with a larger key
length to accommodate the object name.
User response: None required. The name of the object
that caused the failure can be found in the dsmerror.log
file.
ANS2206W

The user must have root authority to use

the memory efficient backup disk cache
method. The operation will continue
using memory efficient backup method
without disk caching.

Explanation: None.

Explanation: TSM the specified number of files have

been added to the disk cache.

System action: The operation continues without using

disk caching.

System action: Processing continues.

User response: None.

User response: None.

ANS2213E
ANS2201I

***** Inspecting Cache count files *****

Explanation: TSM the specified number of files have

been examined in the disk cache.
System action: Processing continues.
User response: None.

132

Error while querying volume properties

of volume volserial. Please verify that the
volume specified in the target volumes
file exists.

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2218I

The encryption key password for node

node name and server server name has
been migrated.

Explanation: The format of the TSM password file has

recently changed. The option MIGRATEENCRYPTKEY
is set and the stored encryption key password was
automatically migrated to the new format. This
message confirms that the migration was successful.
System action: The encryption key password has been
migrated.
User response: No response.
ANS2219E

Cannot backup or archive files into

filespace because it is owned by a TSM
API application.

Explanation: TSM Client cannot archive or backup

files into a file space that is used a TSM API
application.
System action: Processing stops.
User response: Use separate node names for TSM
Client and TSM API application(s).
ANS2220E

same) for IPv4 and IPv6 communication methods in the

/etc/hosts configuration file. See your system
administrator or TSM administrator for further help.
ANS2223W

Explanation: For security, the client will not accept

server-initiated sessions from servers that have
authentication turned off.
System action: The client-server session is not opened,
and the schedule is not executed. The scheduler
continues to wait for contact by a server that has
authentication turned on.
User response: If the client system is supposed to
accept scheduled events from the prompting TSM
server, either ask the TSM server administrator to turn
authentication on, or do not use server-initiated
sessions. If the client system is not supposed to accept
scheduled events from the prompting server, ask the
TSM server administrator to remove the client node
name from the schedule on the prompting server.
ANS2225W

The cluster disk could not be put in

maintenance mode.

Explanation: The system call to put the cluster disk in

maintenance mode failed.
System action: Processing stopped.
User response: Try the operation again. If the problem
continues, check the client error log for any other
messages that might have been logged when this
message was written, and take the corrective action (if
any) suggested by those messages. Examine the
Windows event log which may contain additional
information. See your system administrator or TSM
administrator for further help.
ANS2221W

Java was not able to resolve the IP

address of your local machine due to
network misconfiguration problems!
Please verify your network and DNS
configuration are setup correctly. Note
that on UNIX machines the hostname
must be reported correctly (the same) for
IPv4 and IPv6 communication methods
in the /etc/hosts configuration file. TSM
processing continues.

Explanation: Java was not able to get the local host

address due to network misconfiguration problems.
System action: Processing continues.
User response: Please verify your network and DNS
configuration are setup correctly. Note that on UNIX
machines the hostname must be reported correctly (the

Rejected unauthenticated
server-initiated session from peer name.

User has specified 'SNAPSHOTROOT'

option. snapshot provider snapshot backup
is not valid in conjunction with this
option. "SNAPSHOTROOT option will
take precedence and processing will
continue without the use of a snapshot
taken internally by TSM.

Explanation: The (-SNAPSHOTROOT) option is

incompatible with TSM snapshot providers such as
Logical Volume Snapshot Agent, VSS snapshot
provider, JFS2 snapshot provider etc. which provide a
comprehensive snapshot solution withot having to use
the (-SNAPSHOTROOT) option. It is strongly
recommended that the snapshot capabilities provided
by the TSM snapshot providers be used instead of
using the (-SNAPSHOTROOT) option. Processing will
continue without the use of the TSM snapshot
providers.
System action: Processing continues without the use
of the TSM snapshot providers.
User response: See the appropriate Using the
Backup-Archive Client book for your operating system
for correct use of the named option.
ANS2226I

Filespace filespace-name is renamed to

old-filespace-name. unicode-filespace-name is
recreated as a Unicode enabled
filespace. The current operation will
continue using the Unicode enabled
filespace.

Explanation: TSM Unicode Client operates with

Unicode enabled filespace. In order to save your data
there needs to be a one time automatic rename of the
existing MBCS filespace on the server. A new Unicode
Chapter 2. ANS 0001-9999: Client messages, version 6.3

133

enabled filespace is created on the server and

backup/archive continues.

ANS2602S

System action: Processing continues.

User response: None.
ANS2227W

Server option 'option-name' 'option-value'

has not been applied on the client due
to the client option
SRVOPTSETENCRYPTIONDISABLED.

Explanation: The client option

SRVOPTSETENCRYPTIONDISABLED has been set to
YES on the client thereby preventing the TSM
administrator from setting one of the following client
options - ENCRYPTKEY GENERATE,
EXCLUDE.ENCRYPT, INCLUDE.ENCRYPT.
System action: The option will be ignored.
User response: None required.

Browser trying to establish connection

to client; received IO exception:
exception-name

Explanation: The browser received the exception

exception-name trying to connect to the TSM client
machine.
System action: The TSM operation ends.
User response: Determine what might be causing this
kind of an exception. Retry the problem, and check if
the LAN is down.
ANS2603S

Browser trying to establish connection

to client; received exception:
exception-name

Explanation: The browser received the exception

exception-name trying to connect to the TSM client
machine.
System action: The TSM operation ends.

ANS2600S

Browser trying to establish connection

to client; received socket exception:
exception-name

Explanation: The browser received the exception

exception-name trying to connect to the TSM client
computer.

User response: Determine what might be causing this

kind of an exception. Determine if the LAN may be
down, or if the TSM Client Acceptor Daemon on the
TSM machine is up and running.
ANS2604S

System action: The TSM operation ends.

The Web client agent was unable to

authenticate with the server.

User response: Validate that the LAN is up and that

you are trying to connect to the correct port number.

Explanation: The TSM Web client agent was unable to

authenticate with the TSM server.

Check error logs for any additional information:

dsmerror.log, dsmwebcl.log, or dsmj.log. The default
location of these logs is the installation directory of the
backup-archive client.

System action: The TSM operation ends.

Ensure that the command line client runs without

problems. Test the command line client with a
command like "dsmc q sess".
ANS2601S

Browser trying to establish connection

to client; received unknown host
exception: exception-name

Explanation: The browser received the exception

exception-name trying to connect to the TSM client
machine.
System action: The TSM operation ends.
User response: Retry the operation. If it persists,
determine what might be causing this kind of a
problem. Determine if your LAN went down.
Determine if you are trying to connect to the correct
TSM client machine.

User response: One possible solution is to run the

command line client so that the client password can be
re-entered. Another approach is to check the error log
on the TSM Web client agent for any relevant messages.
ANS2605S

Browser could not re-establish

connection to client; received protocol
error.

Explanation: The browser received a protocol error

trying to re-connect to the TSM client machine.
System action: The TSM operation ends.
User response: Determine what might be causing this
kind of an error. Determine if the TSM browser and the
TSM client code might be out of sync.
ANS2606S

An invalid password was sent to the

server.

Explanation: The TSM password that was sent to the

TSM server was invalid.
System action: The TSM operation ends.
User response: Make sure that you have the correct

134

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

password. Also make sure that it is valid, for example

it is not too short.

ANS2611S

ANS2607S

Explanation: An unknown error occurred in the

applet running in the browser.

Browser could not establish connection

to client.

Explanation: The TSM browser could not connect to

the TSM client machine.
System action: The TSM operation ends.

An unknown error occurred in the

browser.

System action: The TSM operation ends.

User response: Retry the operation. If the problem
persists, turn on tracing and see if the trace to the
browser console gives the reason for the error.

User response: Determine what might be causing this

kind of a problem. Determine if the LAN is down, or if
the TSM Client Acceptor Daemon on the TSM machine
is up and running.

ANS2612S

ANS2608S

Explanation: An unknown error occurred in the TSM

client.

Nothing was selected so no operation

was performed.

Explanation: No object was selected in the GUI for the

operation to be performed upon.
System action: The TSM operation ends.
User response: Make sure you select one or more
objects (volume, directory or file) in the GUI before
clicking on the operation to be performed.
ANS2609S

TCP/IP communications failure between

the browser and the client machine.

Explanation: This error can occur due to any of the

following:
v The LAN connection to the TSM client machine went
down.
v You are trying to connect to the TSM client machine
using the wrong port number.
v The Client Acceptor Daemon on the TSM client
machine is not up and running and accepting
connections.

An unknown error occurred in the client

Please check the TSM Error Log for any
additional information

System action: The TSM client ends.

User response: Retry the operation. If the problem
persists, check the TSM Error Log for any additional
information.
ANS2613S

A communications protocol error

occurred between the web browser and
the client.

Explanation: None.
System action: The operation ends.
User response: Try the operation again. If the problem
occurs again, verify that the TSM web client is installed
and configured correctly, and make sure you are using
a supported browser. Flush the browser cache. Then try
the operation again. If the problem persists, enable
SERVICE traces on the web client on the target machine
and the TSM Java applet, then reproduce the problem.
Collect the traces and contact IBM for further
assistance.

System action: The TSM operation ends.

User response: Retry the operation and make sure the
LAN is up. Also check that the port number is correct,
and that the Client Acceptor Daemon is started and
running on the TSM client machine, and that it is
listening on the correct port number.
ANS2610S

TCP/IP communications failure between

the client and the server machine.

Explanation: An attempt to connect to the server

using TCP/IP communications failed. This can be a
result of incorrect TCP/IP option settings in your client
options file. This error can also occur if the LAN
connection went down or if your system administrator
canceled a backup operation.
System action: The TSM client ends.
User response: Retry the operation and make sure the
LAN is up. Make sure that both the TSM server and
the TSM client are up and running.

ANS2614S

A protocol error occurred in

communications between the client and
the server.

Explanation: A protocol error happened between the

TSM client and the TSM server.
System action: The TSM client ends.
User response: Retry the operation. If the problem
persists, check the TSM Error Log for any additional
information. Verify that you are running the correct
applet with the appropriate level of the client.
ANS2615S

The user ID entered does not match the

node name configured on the client
machine.

Explanation: The user ID that was entered is not the

same as the node name on this TSM client.
System action: The TSM operation ends.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

135

User response: Verify that the node name entered is

configured correctly on the TSM client.
ANS2616I

The machine must be rebooted for the

changes to take effect

Explanation: The machine must be started for the

restored registry changes to take effect.
System action: None

ANS2621W

This function is not available on the

client platform

Explanation: The browser received a request that is

not available on the TSM client machine. For example,
registry backup and restore are available only on the
Windows platform.
System action: The TSM operation ends.

User response: Reboot the machine

User response: Request only those functions that are

valid for the platform of the TSM client machine.

ANS2617S

ANS2622S

The destination directory specified is

invalid.

Explanation: The user specified a destination target

directory for restore or retrieve which is invalid.
System action: The TSM operation ends.
User response: Retry the operation specifying a valid
directory name.
ANS2618S

Browser trying to retrieve resources;

received resource exception:
exception-name

Explanation: The browser received the exception

exception-name trying to retrieve resources from the
TSM client machine.
System action: The TSM operation ends.

An invalid ID or password submitted.

Explanation: Either the ID is not registered on the

TSM server, or the password for the ID is incorrect.
System action: The TSM operation ends.
User response: Verify that the ID you are using exists
on the TSM server to which the remote client node
connects. The ID must have sufficient privileges to
access the remote client node's data. Also make sure
that you have the correct password for the ID. If the ID
does not exist or if the password is unknown, contact
your TSM administrator. If the ID does not exist, then
the TSM administrator can use the REGISTER ADMIN
and GRANT AUTHORITY commands to register an ID
that can access the remote client node's data. If the
password is unknown, the TSM administrator can use
the UPDATE ADMIN command to reset the password.

User response: Verify that the resources are installed

correctly on the TSM client machine.

ANS2623S

ANS2619S

Explanation: The Web Client applet and Web Client

agents are at incompatible levels.

The Client Acceptor Daemon was

unable to start the Remote Client Agent.

Explanation: The TSM Client Acceptor Daemon could

not start the TSM Remote Client Agent.
System action: The TSM operation ends.
User response: Check the error log on the TSM Web
client agent for any relevant messages. Then correct the
problem and retry.
ANS2620W

The expand entire branch operation may

take a long time, and cannot be canceled
once it has started. Are you willing to
wait for the operation to complete?

Explanation: The expand entire branch operation

could take a long time and cannot be canceled once it
is started.
System action: Processing stopped; waiting for user
intervention.

Web Client applet level is out of sync

with Web Client agent.

System action: The TSM operation ends.

User response: Verify that you have the correct level
of the applet installed with the client, and that an
incorrect level of the applet was not placed in the
install directory.
ANS2624E

This operation requires client owner

authority.

Explanation: Your user ID has insufficient authority to

perform this operation.
System action: Processing continues, but the user is
not allowed to do this operation.
User response: Do not perform this operation, or get a
higher authority level for your user ID in order to
perform this operation.

User response: Answer 'Yes' to start the expand entire

branch operation. If you answer 'No', the current
operation will be canceled.

136

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2625E

Node does not support this image

operation.

Explanation: Node does not support or is not

configured to perform this image operation.
System action: Processing continues, but the user is
not allowed to do this operation.
User response: Verify whether this image related
operation is supported or configured on the target
platform.
ANS2626E

The Include-Exclude statement:

ieStatement contains invalid characters.

Explanation: The specified Include-Exclude statement

has invalid characters.
System action: TSM will not add the specified
Include-Exclude statement to the list.
User response: Retry the operation with another
statement that has valid characters.
ANS2627W

The NTFS security attributes for object

'full-name' could not be set. Windows
system error code: error; reason:
'error-reason'. Default NTFS security
attributes have been set.

Explanation: TSM was unable to set the NTFS security

attributes of the file. The error information captured
indicates the reason for the failure. Default NTFS
security attributes have been set.

ANS2699I

msg

Explanation: This message is reserved for DB2 UDB.

System action: Reserved.
User response: This message is reserved for DB2 UDB.
ANS2700E

The (-DATABASE) option must be

specified with the BACKUP, RESTORE,
QUERY and WITHDRAW DB2UDB
commands.

Explanation: None.
System action: Processing stops.
User response: Refer to the users guide of the
corresponding platform for the correct syntax of the
QUERY UDB command.
ANS2701E

The attempted database operation was

unsuccessful, check the TSM error log
for any additional information.

Explanation: Processing stops.

System action: Reserved.
User response: Check the TSM error log for
information regarding failure and take further action.
ANS2702E

The DB2 UDB Utility plug-in module

was not found or could not be loaded.

Explanation: Processing stops.

System action: Processing continues.

System action: None.

User response: Check the reason field for the code

which explains why the NTFS security attributes have
not been set. Correct the condition causing the error
and try the operation again. If the problem persists,
contact your system administrator or TSM
administrator for further help.

User response: Run "dsmc show plugins" at the TSM

command-line client prompt to see the available
plug-ins on the system and verify the path which is
being used to load the plug-ins. If the plugin path is
available and the DB2 UDB Utility plug-in, libPiDB2.a,
is present, ensure that the LIBPATH variable is set to
the DB2 UDB product's library path, for example,
LIBPTH=/usr/opt/db2_08_01/lib.

ANS2628W

Failed to create named stream of object

'filespace namepath-namefile-name'.

Explanation: TSM was unable to create named stream.

System action: The named stream is not
restored/retrieved.
User response: The object is restored without named
stream, the object should be examined to verify that it
is usable. Check the client error log for ANS5250E error
message that should have been logged when this
message was written, take the corrective action and try
the operation again. If the problem persists, contact
your system administrator or TSM administrator for
further help.

ANS2703E

The (-DBHOSTNAME) option must be

specified when using the
(-DBPARTITIONNAME) option for the
RESTORE DB2UDB command.

Explanation: None.
System action: Processing stops.
User response: Refer to the users guide of the
corresponding platform for the correct syntax of the
RESTORE DB2UDB command.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

137

ANS2704E

The (-BACKUPDESTINATION) option

cannot be "BOTH" when issuing the
RESTORE DB2UDB command.

Explanation: When using the RESTORE DB2UDB

command, the (-BACKUPDESTINATION) option can
be set to "TSM" or "LOCAL", but not "BOTH" unless
using the (-PICK) option. When using the (-PICK)
option the (-BACKUPDESTINATION) option can be
"TSM", "LOCAL", or "BOTH".
System action: Processing stops.
User response: Refer to the users guide of the
corresponding platform for the correct syntax of the
RESTORE DB2UDB command.
ANS2705S

System action: Processing stops.

User response: Issue the TSM client command QUERY
DB2UDB command with the -DETAIL parameter using
the same database, file, and date criteria to see if any
database partitions are available for restore.
Alternatively restore the DB2 UDB database from a
different backup.
A DB2 UDB request failed. TSM
function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM reason code : TSM-reason
DB2 return code : DB2-rc DB2 reason
code : DB2-reason SQL-msg

Explanation: None.
System action: Processing stops.
User response: Contact the DB2 UDB administrator
with the SQL information provided in this message.
ANS2707E

A failure occurred while initializing the

DB2 UDB application for db partition
part-num. The TSM return code is rc.

Explanation: None.
System action: Processing stops.
User response: Check the TSM error log for failures
prior to this message.

An unexpected error was encountered

processing a DB2 UDB request. TSM
function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM file : file-name (line-number)

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS2709W

No DB2 UDB partitions are available for

restore.

Explanation: No DB2 UDB partitions are available on

the TSM server for restore. This is most likely due to a
previous backup that was aborted before the backup
completed. The DB2 UDB database and selected
partitions cannot be restored.

ANS2706E

ANS2708E

A duplicate disk ID 'disk-id' was found

on the following DB2 database
partitions: partition 'partition-prefix1dbnum1' hostname 'host1' partition
'partition-prefix1db-num1' hostname 'host2'
These DB2 partitions cannot be restored
individually.

Explanation: Each DB2 database partition should have

it's own set of physical resources and logical volume
groups. If the logical volume groups are shared by two
database partitions, an artificial dependency between
the two partitions is created at the logical volume
group level. If one DB2 database partition is restored
without restoring the other database partition, the latter
database partition could have information out of synch.
System action: Processing continues. The database
partition backup objects are marked so that they can
not be restored individually, in other words outside the
context of restoring the entire host or entire DB2
database.
User response: Contact the DB2 or storage
administrator to determine if the DB2 database
partitions can be segregated to their own volume
groups.
ANS2710W

A duplicate disk ID 'disk-id' was found

on the following DB2 database
partitions: partition 'partition-prefix1dbnum1' hostname 'host1' partition
'partition-prefix1db-num1' hostname 'host2'
The DB2 partitions and DB2 hosts listed
cannot be restored individually.

Explanation: Each DB2 database partition should have

it's own set of physical resources and logical volume
groups. If the logical volume groups are shared by two
database partitions, an artificial dependency between
the two partitions is created at the logical volume
group level. If one DB2 database partition is restored
without restoring the other database partition, or if one
DB2 database host is restored without restoring the
other database host, the latter database partition or host
could have information out of synch.
System action: Processing continues. The database
partition and database host backup objects are marked
so that they can not be restored individually, in other

138

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

words outside the context of restoring the entire DB2

database.
User response: Contact the DB2 or storage
administrator to determine if the DB2 database
partitions and hosts can be segregated to their own
volume groups.

ANS2715I

The filespace 'filespace' does not exist on

the server.

Explanation: The file system may not yet have been

created on the server or it might have been deleted.
System action: Processing continues.
User response: None.

ANS2711W

Unable to backup configuration files for

DB2 database backup 'db'.

Explanation: The configuration files that are used by

the TSM client for DB2 database backups could not be
processed. Since these files are not critical to the
database backup processing continues normally.
System action: Processing continues.
User response: Retry the operation. If the problem
persists contact the TSM administrator.
ANS2712E

A non-critical, unexpected error was

encountered processing a DB2 UDB
request. TSM function name :
function-name TSM function :
function-desc TSM return code : TSM-rc
TSM file : file-name (line-number)

Explanation: None.
System action: Processing continues.
User response: Contact the TSM administrator with
the information provided in this message.
ANS2713E

An unexpected error was encountered

processing a DB2 UDB request. TSM
function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM explanation : TSM-msg
TSM file : file-name (line-number)

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS2714W

The management class 'mc' specified for

the 'dest' backup destination is invalid.
The default management class will be
used.

Explanation: None.
System action: Processing continues.
User response: Contact the TSM administrator to run
the configuration utility for DB2 UDB and specify a
valid management class.

ANS2716E

A background copy process is still

pending on local hardware. A restore
operation cannot be initiated until the
background copy process is completed.

Explanation: None.
System action: Processing stops.
User response: Wait until the background copy
process completes and retry the restore operation.
ANS2717E

The multi-node definition does not have

permission to delete its own backup
files from the server.

Explanation: All DB2 UDB commands require that the

multi-node definition has permission to delete its own
backup files from the server in order to properly
reconcile the local backup repository with the server
backup repository.
System action: Processing stops.
User response: Have the TSM administrator update
the multi-node definition so that it has permission to
delete its own backup files from the server. For
example, on the TSM administrative command-line
client:. dsmadmc update node <multi-node name>
backdelete=yes
ANS2718E

A previous incremental backup started

on datetime is still in progress.

Explanation: A new incremental local backup can not

be done until previous incremental backup completes.
System action: Processing stops.
User response: Wait until previous backup completes
before starting another incremental local backup.
Alternatively, use different copyType value to perform
a local backup with full copy. TSM local backup policy
only allows one incremental and one full background
copy to be pending at any time, before local backup
resources are reused for a new backup version. A new
local backup would result in a backup with
background copy in pending state.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

139

ANS2719E

A previous backup started on 'datetime',

is using the resources needed for new
backup is still pending.

Explanation: A new backup can not be done until

previous backup completes.

System action: None.

User response: Please validate TSM configuration by
running the configuration wizard.
ANS2723I

System action: Processing stops.

User response: Wait until previous backup completes
before starting another local backup. Alternatively, use
different copyType value to perform a local backup.
TSM local backup policy only allows one incremental
and one full background copy to be pending at any
time, before local backup resources are reused for a
new backup version. A new local backup would result
in a backup with background copy in pending state.
ANS2720E

One or more background copies are still

in progress.

Explanation: A new backup can not be done until all

full background copies are completed.

Explanation: The specified backup instance of the

named object has been deleted on the server and in
local repository because the background copy
operations for this backup version was cancelled. It is
no longer available for restore.
System action: None.
User response: None.
ANS2724E

System action: Processing stops.

User response: Wait until previous backups complete
before starting another local backup. Alternatively, use
different copyType value to perform a local backup.
TSM local backup policy only allows one incremental
and one full background copy to be pending at any
time, before local backup resources are reused for a
new backup version. A new local backup would result
in a backup with background copy in pending state.
ANS2721I

A previous local backup version backup

date 'datetime' copytype 'name' has been
deleted for this backup operation (object
name='filespace namepath-namefile-name',
ID='object-id:object-id').

Explanation: The local resources needed for current

backup operation would be made available by expiring
a previous backup version referenced in the message as
defined in the local backup policy. Refer to TSM
documentation for additional information on local
backup policy.

A local backup version backup date

'datetime' is deleted because background
copy operation has been cancelled
(object name='/filespace
name/path-name/file-name', ID =
'object-id:object-id').

The version of IBM Enterprise Storage

Server is not supported.

Explanation: This product only supports IBM ESS

microcode level 2.3 and 2.4.
System action: Process stops.
User response: Ensure that ESS microcode level 2.3 or
2.4 is installed.
ANS2725W

The backup DB2 UDB preview

command indicates there are not enough
resources for a backup operation.

Explanation: None.
System action: check the TSM error log for additional
information about the problem.
User response: Correct the problem and re-issue the
BACKUP DB2UDB -PREVIEW command.
ANS2726E

The putenv command failed for path =

v1.

System action: None.

Explanation: There was not enough memory in the

environment to successfully set the environment.

User response: None.

System action: Process stops.

ANS2722E

There is not enough space in the local

repository to complete this backup.

Explanation: This space available in the local

repository is not enough to perform snapshot for this
backup operation. It could happen if there is more
number of local versions kept by the management class
than there is space allocated in the local repository at
configuration time or application configuration has
changed such that previously allocated space is not
enough.

140

User response: Close all unneeded applications and

try the operation again. For UNIX systems that support
resource limits, check to see if the memory resource
limit is too low by entering the following command:
ulimit -a
Based on the resulting data, you can ask the UNIX
system root user to increase resource limits so that it
will override the current default. The UNIX system root
user has the authority to increase resource limits.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2727E

ESS Lun ID v1 is not valid.

Explanation: Length of ESS LUN id must be 8

characters.
System action: Process stops.
User response: Make sure the length of ESS Lun id is
8.
ANS2728E

The ESS jar file v1 cannot be found.

Explanation: The Enterprise Storage Sub-system Copy

Services JAR file could not be located.

ANS2732E

Explanation: One or more LUNs specified in the

message are in use by other flashcopy operation.
Therefore this flashcopy operation can not continue.
System action: Process stops.
User response: Release ESS LUN in order to reuse
them.
ANS2733I

System action: Process stops.

User response: In order to complete Enterprise
Storage Sub-system Copy Services functions the Copy
Services command line functions must be available.
Check the Copy Services command line is installed and
your Copy Services option setting is pointing to the
installation directory of the command line.
ANS2729E

System action: Process stops.

User response: Check the return code from the
operating system for more information about the
failure. Issue the failing command manually to see if
the same failure occurs.
ANS2730E

The primary and secondary copy service

servers are down.

Explanation: None.

System action: None.

User response: None.
ANS2734E

ANS2731E

Cannot open the ESS command output

file v1 for writing.

Explanation: Can't open this file for writing.

System action: Process stops.
User response: Make sure you have enough space on
your system and write permission to the file.

Withdraw command failed because a

TSM backup of this database instance is
in progress using the same snapshot
resources.

Explanation: The snapshot established can not be

withdrawn because a 'TSM' backup is in progress from
the same local backup snapshot.
System action: Processing stops.
User response: You must wait until the TSM backup
completes and retry the withdraw command.
Alternatively, you may cancel the TSM backup and
retry the withdraw command.
ANS2735E

System action: Process stops.

User response: Start at least one of the ESS copy
service servers. If copy server is already running, check
the value of java home specified during configuration
to make sure it is a valid path name of the directory
where JRE is installed on master backup node. Use
configuration wizard to update java home value for the
configuration.

The backup DB2 UDB preview

command indicates there are sufficient
resources for a backup operation.

Explanation: None.

Operating system command 'command'

failed; rc=rc.

Explanation: None.

The ESS LUN 'Serial number string' are

already in use.

DB2 UDB is running on different

operating system versions. database
partition 'partition': OS version 'os-1'
catalog partition: OS version 'os-2'

Explanation: DB2 UDB must be running on the same

operating system versions on all hosts.
System action: Processing stops.
User response: Upgrade the operating systems so that
all DB2 UDB hosts are running the same version.
ANS2736E

An unexpected response was received

from a remote TSM file system agent.
verb : verb remote host : host return code
: rc reason code : rs msg. string :
msg-string

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

141

ANS2737E

A DB2 UDB database server is not

available. DB2 instance name: instance
DB2 database name: db db partition :
part

User response: Use the Configuration Wizard to create

the DB2 UDB configuration settings.
ANS2742I

Deleting local incremental backup

version.

ANS2743E

Unable to read configuration file

information for configuration
'configname'.

Explanation: None.
System action: Processing stops.
User response: Contact the DB2 database
administrator to have the database server made
available and retry the operation.
ANS2738E

The DB2 UDB log retain value is not set

to 'recovery'. DB2 instance name:
instance DB2 database name: db db
partition : part

Explanation: None.
System action: Processing stops.
User response: Contact the DB2 database
administrator to have the log retain value set to
'recovery'.

Explanation: One or more of the TSM DB2 UDB

configuration files could not be read. Refer to the TSM
error log for additional information.
System action: Processing stops.
User response: Review the additional messages in the
TSM error log. Launch the TSM configuration wizard
from the DB2 UDB production host which contains the
catalog node to resolve the problem.
ANS2744I

TESTFLAG DB2 enabled with the value

of 'value'.

Explanation: None.
ANS2739E

The DB2 UDB user exit for archiving

logs is not enabled. DB2 instance name:
instance DB2 database name: db db
partition : part

Explanation: None.

System action: This message is informational.

User response: None.
ANS2745I

System action: Processing stops.

User response: Contact the DB2 database
administrator to have the user exits for archiving logs
enabled.
ANS2740E

DB2 UDB is running different versions.

database partition 'partition': version
'os-1' catalog partition: version 'os-2'

Explanation: DB2 UDB must be running on the same

version on all hosts.
System action: Processing stops.
User response: Upgrade the DB2 UDB version so that
all DB2 UDB hosts are running the same version.
ANS2741I

DB2 UDB configuration settings

'filename' have either not been created
using the Configuration Wizard or they
are not readable. The TSM return code
is rc.

Explanation: DB2 UDB configuration settings are

required for the processing of DB2 UDB commands.
They have either not been created using the
Configuration Wizard or they do not have read
permission.
System action: DB2 UDB operations will fail.

142

Volume Group Configuration has been

modified.List of logical volumes added
to the Volume Group configuration of
the database since the time of
backup:'value'.

Explanation: Volume group configuration has been

changed since the time of backup by the addition of
new logical volumes.
System action: User will be prompted to select "Yes"
to continue the restore operation, or to select "No" to
stop the restore.
User response: User can select "Yes" to continue the
restore operation, in which case the newly added
logical volumes will be deleted. Otherwise, he can
select "No" to stop the restore, backup the newly added
logical volumes and then retry the restore. Thus he will
be able to recover the newly added logical volumes
after the restore.
ANS2746I

Volume Group Configuration has been

modified.List of physical volumes
added to the Volume Group
configuration of the database since the
time of backup:'value'.

Explanation: Volume group configuration has been

changed since the time of backup by the addition of
new physical volumes.
System action: User will be prompted to select "Yes"

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

to continue the restore operation, or to select "No" to

stop the restore.

User response: None.

User response: User can select "Yes" to continue the

restore operation, in which case the newly added
physical volumes will be removed from the volume
group. User will have to add the physical volumes
once the restore operation is complete. Otherwise, he
can select "No" to stop the restore.

ANS2751I

ANS2747I

ANS2752I

DB2 storage config has changed since

previous backup. Retrying to find local
resources for this backup.

Verifying multi-node information.

Explanation: None.
System action: This message is informational.
User response: None.
Initializing DB2 UDB application on
part partition(s).

Explanation: None.

Explanation: None.

System action: This message is informational.

System action: This message is informational.

User response: None.

User response: None.

ANS2753I
ANS2748I

Changing copyType to default "any" for

no-copy snapshot for TSM backup
operation.

Explanation: When backup destination is TSM,

snapshot copy type defaults to no-copy operation. The
is done to optimize performance of the snapshot
operation required for TSM backup.

Explanation: None.
System action: This message is informational.
User response: None.
ANS2754I

System action: This message is informational.

User response: Do not specify "copyType" option for
TSM backups or use "any". This will allow TSM to pick
the appropriate default value of copyType.
ANS2749E

The backup host 'backup_host' listed in

the user FlashCopy target input file
cannot be found in the list of
configured backup hosts.

Explanation: The backup hosts specified in the user

FlashCopy target input file must be configured as
backup hosts.

Establishing inter-client communication

with node node(s).

Establishing inter-client communication

session. NODENAME : node
MULTI-NODE NAME : multi-node
hostname : host TCP/IP address :
tcpaddr:tcpport

Explanation: None.
System action: This message is informational.
User response: None.
ANS2755I

Established communications with DB2

catalog partition.

Explanation: None.

System action: Processing stops.

System action: This message is informational.

User response: Check the configuration wizard to

determine which backup host names have been
configured. Ensure that the backup hosts specified in
the user FlashCopy target input file appear in the
configuration wizard. If the backup hosts do not appear
in the configuration wizard, either add the backup host
in the configuration wizard or specify a different
backup host name in the user FlashCopy target input
file.

User response: None.

ANS2750I

func function invoked for DB2

configuration 'db_config'. backup
destination : backupdest copy type :
copytype preview : preview

Explanation: None.
System action: This message is informational.

ANS2756I

Querying database configuration

information from type partition(s).

Explanation: None.
System action: This message is informational.
User response: None.
ANS2757I

Initializing DB2 UDB application on

backup hosts.

Explanation: None.
System action: This message is informational.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

143

ANS2758I

Established communications with

backup worker nodes.

Explanation: None.
System action: This message is informational.

ANS2765I

Quiescing the database partitions.

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2766I
ANS2759I

Policy settings for backup destination

'dest'. Management class : mgmtclass
Backup copygroup : backup_cg Data
versions : data_vers

Creating snapshot-type-name snapshot.

Explanation: None.
System action: This message is informational.
User response: None.

Explanation: None.
System action: This message is informational.

ANS2767I

User response: None.

Explanation: None.

Resuming the database partitions.

System action: This message is informational.

ANS2760I

Querying database tablespaces from

database partitions.

Explanation: None.

User response: None.

ANS2768I

System action: This message is informational.

User response: None.

Collecting metadata files from each

database partition.

Explanation: None.
System action: This message is informational.

ANS2761I

Mapping database tablespaces to logical

volumes.

Explanation: None.

User response: None.

ANS2769I

System action: This message is informational.

User response: None.

Distributing metadata files to backup

hosts.

Explanation: None.
System action: This message is informational.

ANS2762I

Mapping logical volumes to physical

entities.

Explanation: None.

User response: None.

ANS2770I

System action: This message is informational.

User response: None.

Configuring snapshot volumes on

backup nodes.

Explanation: None.
System action: This message is informational.

ANS2763I

Obtaining a list of target devices for

snapshot operation.

Explanation: None.

User response: None.

ANS2771I

System action: This message is informational.

User response: None.

Sending group objects for backup

destination 'dest' to the server.

Explanation: None.
System action: This message is informational.

ANS2764I

Initializing snapshot-provider-name
snapshot.

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2772I

Local backup of DB2 UDB database

'dbname' completed pending completion
of background copy process.

Explanation: None.
System action: This message is informational.

144

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: None.

ANS2773I

ANS2780I

Unconfiguring snapshot volumes.

Explanation: None.

Withdraw requested for database

configuration 'config'. DB2 database :
db2db DB2 instance : dinst Backup size :
bsize Backup date : bdatetime Backup
destination : bdest Active state : activ

System action: This message is informational.

Explanation: None.

User response: None.

System action: This message is informational.

ANS2774I

Unconfiguring snapshot volumes on

backup nodes.

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2781I

- Database 'db' (object id objhi.objlo)

Explanation: None.
System action: This message is informational.
User response: None.

ANS2775I

Starting the backup of TSM

configuration files for DB2 UDB
database ''.

Explanation: None.
System action: This message is informational.

ANS2782I

- Host 'host' (object id objhi.objlo)

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2783I
ANS2776I

Backing up data to TSM server for

'backup_type' backup.

Explanation: None.
System action: This message is informational.
User response: None.
ANS2777I

Monitoring image backup.

Explanation: None.
System action: This message is informational.

- Partition 'part' (object id objhi.objlo)

Explanation: None.
System action: This message is informational.
User response: None.
ANS2784I

Restoring local hardware configuration

file 'filename'.

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2785I
ANS2778I

TSM backup of DB2 UDB database

'db-name' completed successfully.

Explanation: None.
System action: This message is informational.

Gathering current DB2 configuration for

'type' restore.

Explanation: None.
System action: This message is informational.
User response: None.

User response: None.

ANS2786I
ANS2779I

Restore requested for database

configuration 'config'. DB2 database :
db2db DB2 instance : dinst Backup size :
bsize Backup date : bdatetime Backup
destination : bdest Active state : activ

Verifying database configuration

information for type partition(s).

Explanation: None.
System action: This message is informational.
User response: None.

Explanation: None.
System action: This message is informational.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

145

ANS2787I

Sending metadata files to worker nodes.

ANS2795I

Explanation: None.
System action: This message is informational.
User response: None.

Withdraw of DB2 UDB database 'name'

backup completed successfully.

Explanation: None.
System action: This message is informational.
User response: None.

ANS2788I

Verifying hardware configuration

information.

ANS2796I

Explanation: None.
System action: This message is informational.
User response: None.

The DB2 UDB operation has completed

successfully.

Explanation: None.
System action: This message is informational.
User response: None.

ANS2789I

Verifying volume manager configuration

information.

ANS2797I

Explanation: None.
System action: This message is informational.
User response: None.
ANS2790I

Stopping the database manager.

Current statistics for backup host 'host':

Total number of volumes in request:
volumes Total number of volumes
completed: complet Total number of
volumes in progress: inprogr Total
number of volumes remaining: remaing
Currently processing volumes: process
Total number of bytes transferred: totaltr

Explanation: None.

Explanation: None.

System action: This message is informational.

System action: This message is informational.

User response: None.

User response: None.

ANS2791I

ANS2798E

Starting the database manager.

Explanation: None.
System action: This message is informational.
User response: None.

Unable to start a session from client

node 'nodename' multi-node 'multi-node'
to client at address 'ip-address:ip-port'.
The TSM return code is rc.

Explanation: None.
System action: This message is informational.

ANS2792I

Local restore of DB2 UDB database

'dbname' completed pending completion
of background copy process.

Explanation: None.

User response: None.

ANS2799E

System action: This message is informational.

User response: None.
ANS2793I

TSM restore of DB2 UDB database

'dbname' completed.

An error was encountered during a

session with another client. check the
TSM error log for any additional
information

Explanation: This message is reserved for DB2 UDB.

System action: Reserved.
User response: This message is reserved for DB2 UDB.

Explanation: None.
System action: This message is informational.

ANS2800W

User response: None.

Explanation: The QUERY PIDS command was unable

to identify any known TSM processes running on the
system. If the -FILTER option was used, no processes
matching the filter specification were found.

ANS2794I

Monitoring image restore.

No TSM processes were found.

Explanation: None.

System action: None.

System action: This message is informational.

User response: If you need to use dsmtrace to enable

or disable tracing for a running client process, make

User response: None.

146

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

sure that the client is already running. If you used the

-FILTER option, try the command again with a different
filter specification. You can use -FILTER=* to display all
processes running on the system.
ANS2801E

The dsmtrace utility was unable to

connect to the specified process.

Explanation: This message typically occurs when the

specified process ID is not active.
System action: None.
User response: If you need to use dsmtrace to enable
or disable tracing for a running client process, make
sure that the client is already running. Use the
dsmtrace QUERY PIDS command to identify running
client processes, then try the command again.
ANS2802I

Tracing has been disabled.

Explanation: None.

ANS2805I

Explanation: None.
System action: None.
User response: None.
ANS2806E

System action: No changes are made to the trace

status of the specified process.
User response: Review the messages that immediately
precede or follow this message for further information
about this error.
ANS2807E

User response: None.

Tracing could not be disabled.

Explanation: A problem occurred while trying to

disable tracing for the specified process. This message
is usually accompanied by other, more specific
messages immediately preceding or following this
message.
System action: No changes are made to the trace
status of the specified process.

Tracing is already enabled.

-TRACEFILE, -TRACEMAX, and
-TRACESEGSIZE are ignored.

Explanation: When tracing is already enabled for a

client process, only the -TRACEFLAGS option has any
effect.
System action: The -TRACEFLAGS options are set on
the client process. -TRACEFILE, -TRACEMAX, and
-TRACESEGSIZE are ignored.
User response: If you need to modify the
-TRACEFILE, -TRACEMAX, or -TRACESEGSIZE
settings, you must first use the dsmtrace DISABLE
command to disable tracing for the client process. Then
run the dsmtrace ENABLE command to configure the
desired trace settings. If it is not necessary to modify
these settings, then this message may be ignored.

An incorrect number of parameters was

specified for the command-name
command.

Explanation: The specified command was invoked

with too few or too many parameters.
System action: The command is not processed.
User response: Try the command again with the
correct number of parameters. Run \"dsmtrace help\"
for additional information on dsmtrace command
syntax.
ANS2808W

User response: Review the messages that immediately

precede or follow this message for further information
about this error.
ANS2804W

Tracing could not be enabled.

Explanation: A problem occurred while trying to

enable tracing for the specified process. This message is
usually accompanied by other, more specific messages
immediately preceding or following this message.

System action: None.

ANS2803E

Tracing has been enabled.

Incremental by snapshot difference

backup did not locate the registered
base snapshot 'regbase-name' on
NetApp/N-Series filer volume
'volume-name'. Snapshot 'olderbase-name' is
used as the base snapshot.

Explanation: Incremental by snapshot difference

backup did not locate the specified registered base
snapshot on the specified NetApp/N-Series filer
volume. The most recent existing snapshot which is
older than the registered base snapshot is used as the
current base snapshot.
System action: Processing continues.
User response: None.
ANS2809E

The backupid 'backupid:' in the input file

does not match the vmname 'vmname:'
being restored.

Explanation: There is a discrepency between the

backupid and vmname specified in the input file
System action: The virtual machine cannot be
restored.
User response: Confirm that the backupid specified
Chapter 2. ANS 0001-9999: Client messages, version 6.3

147

matches the vmname you are attempting to restore by

re-running the inquire_detail command and make any
necessary corrections before attempting the restore
again.
ANS2810E

The TSM for Virtual Environments

Input File 'input file:' appears to be
empty.

Explanation: While processing the Input File no items

were found to operate on.

a valid Datamover network address and port number.

User response: This is usually the result of a
Datamover Node not being started. Log on to the
Datamover host and start or restart the DSMCAD
service and retry the TSM for Virtual Environments
command again. If the problem persists, work with
your TSM Server Administrator to inspect the TSM
Server activity log to identify the issue.
ANS2814E

System action: The operation cannot continue with an

empty list.
User response: Confirm that the input file is not
empty and has valid input. If the file is not empty it
may be that an error occurred while reading the file,
please check the error log for any errors found during
the reading of the file. If errors are found make the
necessary corrections before attempting the operation
again.
ANS2811E

The TSM for Virtual Environments

could not find a suitable datamover
agent for the DataCenter Node
'datacenter nodename'.

Explanation: While processing Proxy relationships

with the DataCenter Node specified, no appropriate
datamover matches detected
System action: The operation cannot continue without
a valid datamover.
User response: Work with your TSM Administrator to
ensure that your DataCenter Nodes have granted proxy
authority to your DataMover Nodes.
ANS2812E

The TSM for Virtual Environments

could not find Datamover node named
'datamover nodename' on the TSM Server.

Explanation: While processing Proxy relationships

with the DataCenter node and DataMover node
specified, no appropriate Datamover node name
matches detected.
System action: The operation cannot continue without
a valid Datamover Node name.
User response: Make sure the Datamover node name
specified is a valid TSM node name and that the node
has the proper proxy relationships established.
ANS2813E

The TSM Server returned and empty

network address or port number for
'datamover nodename'.

Explanation: While querying the TSM Server for the

Datamover network Address and port number, the
Server returned zero for one of the values.

TSM for Virtual Environments detected

an error while parsing the Input File
'input file'. The 'specifier' appears to be
empty or invalid.

Explanation: While parsing the Input File an error

occurred.
System action: The operation cannot continue without
valid virtual machine specifications.
User response: This is usually the result of an empty
virtual machine name or other identifier. Please check
that the syntax of the Input File is correct for all entries
and that virtual machine names are not empty and
retry the operation.
ANS2815E

TSM for Virtual Environments detected

an error while parsing 'read in line' from
the Input File 'input file'.

Explanation: While parsing the Input File an error

occurred.
System action: The operation cannot continue without
valid specifications in the Input File.
User response: This may be the result of an empty
virtual machine name or other identifier. Please check
that the syntax of the Input File is correct for all entries
and that virtual machine names are not empty and
retry the operation.
ANS2816E

TSM for Virtual Environments detected

that the TSM Server IP address was not
specified.

Explanation: While parsing the command line options,

an empty Server address was detected.
System action: The operation cannot continue without
a valid network address for the TSM Server.
User response: This may be a result of the VMCLI
profile having an empty VE_TSM_SERVER_NAME
entry. Please check that the VMCLI profile is configured
correctly specifying the TSM Server address.
ANS2817E

TSM for Virtual Environments detected

that the vCenter Command-Line
interface node name was not specified.

Explanation: While parsing the command line options,

System action: The operation cannot continue without

148

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

an empty vCenter Command-Line interface node name

was detected.
System action: The operation cannot continue without
a valid vCenter Command-Line interface node name.
User response: This may be a result of the VMCLI
profile having an empty VE__TSMCLI_NODE_NAME
entry. Please check that the VMCLI profile is configured
correctly specifying the vCenter Command-line
interface node name.
ANS2818E

TSM for Virtual Environments detected

that the TSM Server port was not
specified.

Explanation: While parsing the command line options,

an empty TSM Server port was detected.
System action: The operation cannot continue without
a valid TSM Server port.
User response: This may be a result of the VMCLI
profile having an empty VE_TSM_SERVER_PORT
entry. Please check that the VMCLI profile is configured
correctly specifying the TSM Server port.
ANS2820E

An interrupt has occurred. The current

operation will end and the client will
shut down.

Explanation: This message is issued when the process

is interrupted by a break signal such as CTRL-BREAK
or CTRL-C.
System action: The TSM operation and process are
ended immediately.
User response: Restart the operation if desired.
ANS2821E

The function is not supported on the

platform.

Explanation: The specified function isn't supported on

the specified platform.

ANS2825E

TSM for Virtual Environments detected

that the node name representing the
Datacenter is not specified.

Explanation: While parsing the command line options,

an empty datacenter node name was detected.
System action: The operation cannot continue without
a valid datacenter node name.
User response: This is a result of the -d DataCenter
Node Name not being passed in to the Command-line.
Re-try the operation making sure to pass the -d
Datacenter Node Name to the command-line call.
ANS2826E

TSM for Virtual Environments detected

that the node name representing the
vCenter Datamover is not specified.

Explanation: While parsing the command line options,

an empty Datamover node name was detected.
System action: The operation cannot continue without
a valid Datamover node name.
User response: This is a result of the -o Datamover
Node Name not being passed in to the Command-line.
Re-try the operation making sure to pass the -o
Datamover Node Name to the command-line call.
ANS2827E

TSM for Virtual Environments detected

that the input file is not specified.

Explanation: While parsing the command line options,

an empty or non-existing input file name was detected.
System action: The operation cannot continue without
a valid input file name.
User response: This is a result of the -I Inputfile name
not being passed in to the Command-line. Re-try the
operation making sure to pass the -I input file name to
the command-line call.
ANS2828E

System action: Processing stops.

Image operations are not supported for

the specified file system.

User response: Please retry the specified function on a

supported platform.

Explanation: Image backup and restore are not

supported for the specified file system.

ANS2824E

System action: The requested image operation is not

performed.

TSM for Virtual Environments detected

that the node name representing the
vCenter is not specified.

Explanation: While parsing the command line options,

an empty vCenter node name was detected.
System action: The operation cannot continue without
a valid vCenter node name.
User response: This may be a result of the VMCLI
profile having an empty VE_VCENTER_NODE_NAME
entry. Please check that the VMCLI profile is configured
correctly specifying the vCenter node name.

User response: Choose another object.

ANS2829E

Image operations are not supported for

GPFS.

Explanation: Image backup and restore are not

supported for GPFS volumes.
System action: The requested image operation is not
performed.
User response: Choose another object.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

149

ANS2830E

An incorrect number of parameters was

specified.

Explanation: The specified command was invoked

with too few or too many parameters.
System action: Processing stops.
User response: Try the command again with the
correct number of parameters.

ANS2834E

You have to be a root user in order to

perform incremental backup using
snapshot difference.

Explanation: Failed to perform NAS NFS/CIFS

incremental backup operation using snapshot difference
as the user was non root.
System action: Processing stops.
User response: Please retry the operation as root user.

ANS2831E

Incremental by snapshot difference

cannot be performed on 'volume-name' as
it is not a NetApp NFS or CIFS volume.

Explanation: The volume specified cannot be used for

performing NetApp snapshot difference incremental
operation. The volume does not correspond to the NFS
mount point or the CIFS shared drive for a Network
Appliance or N-Series NAS volume. One possible
reason is that the qtree security style for the volume
was incorrectly selected. If the CIFS volume is mapped
on Windows, ensure that the security style is set to
NTFS. If the volume is mounted as NFS, ensure that
the security style is set to UNIX.

ANS2835E

Explanation: NetApp NFS/CIFS incremental backup

operation using snapshot difference is only supported
on AIX, Linux and Windows platforms.
System action: Processing stops.
User response: Retry the incremental operation
without the snapdiff option.
ANS2836E

System action: Processing stops.

User response: Try the command again with a
NetApp NFS or CIFS volume with the correct security
style.
ANS2832E

Incremental by snapshot difference

failed for filespace name. See the error log
for details.

Explanation: Failed to perform NAS NFS/CIFS

Incremental by snapshot difference operation.
System action: Processing stops.
User response: Take appropriate action based on the
information in the error log. If the problem persists
please contact your IBM Tivoli Storage Manager
administrator.
ANS2833E

Incremental backup operation using

snapshot difference failed because the
base snapshot snapshot name is the same
as the latest snapshot for the NAS
volume NAS volume.

Explanation: User specified that the latest snapshot on

the NAS Filer be used as the difference snapshot
during an incremental backup operation using snapshot
difference. However, the previously taken base
snapshot and the latest snapshot on the filer are
identical.

Incremental backup using snapshot

difference is not supported on this
platform.

Incremental backup operation using

snapshot difference is only available for
full volumes. is a partial volume or
qtree.

Explanation: Cannot perform NAS NFS/CIFS

incremental backup operation using snapshot difference
on the mounted or mapped volume due to one of the
following reasons: 1) The volume is actually a qtree. 2)
The volume is not a full volume, it is not mounted or
mapped to the root of the volume.
System action: Processing stops.
User response: Retry the incremental backup
operation by specifying an entire NAS NFS or CIFS
volume.
ANS2837E

Failed to perform incremental backup

operation using snapshot difference as
the user id and password for NAS Filer
'' have not been configured correctly.

Explanation: The user id and password for the

specified NAS Filer have been either not configured or
have been specified incorrectly.
System action: Processing stops.
User response: Use the 'set password -type=filer'
command to define the user id and password for the
specified NAS Filer and retry the incremental backup
operation.

System action: Processing stops.

User response: Try the operation again using the
default value of "create" for the difference snapshot.

150

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS2838W

The file path 'filename' exceeds HSM

maximaum path length.

Explanation: A file that you tried to migrate has a

path name that is too long.
System action: File skipped from migration.
User response: Place files into a shorter path to make
them available for migration.
ANS2839E

Failed with ONTAPI error 'error_code'

while connecting to NetApp Filer
'filer_name' using user id 'id_name'. You
might have provided credentials
incorrectly for this Filer.

Explanation: The user ID and password have been

configured incorrectly for the specified Filer.

Explanation: While parsing the Input File for

FlashCopy Manager for VMWare offload backup, an
error condition was detected with VM Ware snapshot
handling. Specifying a VMWare Snapshot name while
specifying createsnap:yes is not allowed.
System action: The operation cannot continue without
specifying the correct createsnap: and vmsnapname:
combination.
User response: This is a result of the -I Inputfile
containing conflicting input for createsnap: and
vmsnapname: keywords. If you intend to have TSM for
Virtual Environments use a VMWare Snapshot created
by FlashCopy Manager then specify createsnap:no with
a valid VMWare Snapshot for the vmsnapname:
keyword.
ANS2888E

System action: Processing stops.

User response: Make sure that the credentials you
have specified for the Filer are the correct ones. Use the
dsmc set password command to specify the correct
credentials for your Filer and try the command again.
ANS2840E

Incremental backup using snapshot

difference is not supported for Data
ONTAP file server version
'version.modification.submodification'.
Upgrade the file server 'file-server-name'
to Data ONTAP version '7.3' or later in
order to perform incremental backup
operations using snapshot difference.

Explanation: The file server specified is not at the

Data ONTAP version that supports snapshot difference
API.
System action: Processing stops.
User response: Upgrade the file server to Data
ONTAP version 7.3 or later and retry the operation.
ANS2841E

Incremental by snapshot difference is

only supported on AIX 64 bit and Linux
86 bit clients.

Explanation: Incremental backup using snapshot

difference feature is only available on IBM Tivoli
Storage Manager AIX 64 bit and Linux 86 clients.
System action: Processing stops.
User response: Try the command again with an IBM
Tivoli Storage Manager AIX 64 bit or Linux 86 client.
ANS2842E

Backup VM Full VM Incremental is

unable to run. A valid TSM for Virtual
Environments license file (license-file)
cannot be located.

Explanation: The license file was not found, or cannot

be opened because of permissions, or the file is
corrupted.
System action: The system returns to the calling
procedure.
User response: Check permissions on file. See if the
license file is in the correct place.
ANS3000I

communication-type communications
available on port port-number.

Explanation: The specified communications are

available on the specified port number.
System action: None.
User response: None.
ANS3001E

Error initializing HTTPS

communications - Secure HTTP not
available.

Explanation: An error occurred initializing HTTPS

communications. Processing will continue, but secure
HTTP communications will not be available.
System action: Processing continues, but secure HTTP
communications will not be available.
User response: Check the console and error logs to
determine why secure HTTP communications was
unable to start, correct the problem, and restart the
client.

TSM for Virtual Environments detected

an error with the createsnap: keyword.
createsnap:yes is specified while also
specifying vmsnapname:VMWare
Snapshot Name.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

151

ANS3002I

Session started for user userid

(communication-method address).

ANS3008E

Too many symbolic links were detected

while resolving name 'file_name'

Explanation: A session was started for the specified

user.

Explanation: While trying to resolve the file name, too

many symbolic links were found.

System action: None.

System action: File skipped.

User response: None.

User response: Ensure that you do not have a looping

symbolic link for the file.

ANS3003I

Session ended for user userid.

Explanation: A session ended for the specified user.

System action: None.
User response: None.
ANS3004E

Session for user userid terminated invalid password entered.

Explanation: A session was terminated for the

specified user because an invalid password was
entered.
System action: The session with the specified user is
terminated.
User response: Re-start the remote client and enter the
correct password for the specified user.
ANS3005I

Session for user userid terminated - idle

for idle-minutes minutes.

Explanation: A session was terminated for the

specified user because there was no activity on the
session for the specified number of minutes.
System action: The session with the specified user is
terminated.
User response: Re-start the remote client to begin a
new session.
ANS3006I

Processing request for the TSM Web

Client (ip-address).

Explanation: A request for the Web Client is being

processed.
System action: None.
User response: None.
ANS3007I

TSM client-name terminating - idle for

idle-minutes minutes.

Explanation: The specified client is terminating

because it has been idle for the specified time. It will be
automatically started when it is needed.
System action: The client program stops.
User response: None.

ANS3009E

The Logical Volume Snapshot Agent

plugin library was not found.

Explanation: The Logical Volume Snapshot Agent

(LVSA) plugin library should have been installed when
the client was installed, but it cannot be found.
System action: The selected operation is not
performed.
User response: Try the operation again. If the problem
recurs, re-install the TSM client software. If the problem
persists, contact IBM technical support for further
assistance.
ANS3010E

The snapshot wizard operation failed.

Explanation: The snapshot wizard operation failed

with a non-zero return code. Check the error log for
additional information.
System action: The selected operation is not
performed.
User response: Review the error log for any error
messages, and then retry the operation after correcting
the cause for failure.
ANS3011E

Previous changes have not been

commited. The machine must be
rebooted before this operation can be
performed

Explanation: A previous operation required the

machine to be rebooted for the changes to take effect,
but the machine has not been rebooted. The machine
must be rebooted before this selected operation can be
performed.
System action: The selected operation is not
performed.
User response: Reboot the machine and then retry the
operation.
ANS3012E

The Logical Volume Snapshot Agent is

not installed. Use the Setup Wizard to
configure either Online Image or Open
File support and choose the Logical
Volume Snapshot Agent as the snapshot
provider.

Explanation: The selected operation requires the

152

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Logical Volume Snapshot Agent, but it is not installed.

Use the Setup Wizard to install the LVSA.
System action: The selected operation is not
performed.
User response: Retry the operation after installing the
Logical Volume Snapshot Agent.

obtain the description of the error code. Also check the

error log for any other messages that might indicate a
reason for the failure. Try to correct any indicated
problems, then try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS3404W

ANS3013E

The specified snapshot provider is not

supported on this version of the
operating system.

Explanation: The specified snapshot provider is not

supported on the version of the operating system you
are currently running. If another snapshot provider is
available, select it and retry the operation.
System action: The selected operation is not
performed.
User response: If another snapshot provider is
available, select it and retry the operation.
ANS3401W

The entity name is invalid.

Explanation: A volume with this name could not be

found or is not suitable for server-free operations.
System action: Processing stopped.
User response: Specify the correct name.
ANS3402W

name: A system call func failed with code

rc.

Explanation: An error occurred while obtaining

information from the operating system. The volume
information could not be obtained.
System action: Processing can continue if the
information being obtained is not critical for the
operation or if it is expected behaviour in the context of
the operation being performed.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Try to correct any indicated problems, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS3403W

Volume name cannot be opened for

reading. System error code is err.

An error occured reading volume name.

Explanation: The named volume could not be read.

Examples of why this can occur include, but are not
limited to: the data being read is outside the valid
range of the volume, or the device is locked by another
application. The operating system error code shown in
the message indicates the specific reason for the failure.
System action: If server-free data movement is used,
processing continues using non-server-free data
movement. Otherwise processing stops.
User response: Use your operating system's tools to
obtain the description of the error code. Also check the
error log for any other messages that might indicate a
reason for the failure. Try to correct any indicated
problems, then try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS3405W

File system fs on volume name is

unknown.

Explanation: The file system on the volume is not

supported for the operation being performed.
System action: If server-free data movement is used,
processing continues using non-server-free data
movement. Otherwise processing stops.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Try to correct any indicated problems, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS3406W

Physical mapping of the volume name is

not supported.

Explanation: The logical volume layout is not

currently supported for physical mapping.
System action:
User response: Refer to the documentation for
information on what volume layouts are supported for
physical mapping.

Explanation: The named volume could not be opened.

Examples of why this can occur include, but are not
limited to: the device is not a valid system device, the
device is locked by another application, or the user
does not have correct or permissions. The operating
system error code shown in the message indicates the
specific reason for the failure.

ANS3407W

System action: Processing stops.

System action: Processing stopped.

User response: Use your operating system's tools to

User response: Specify a volume that is local.

name is not local.

Explanation: The drive or filesystem is not local and is

not suitable for image backup.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

153

ANS3408E

System call 'umount' failed for volume

'volume' with errno='error'. Please take
suitable action based on errno and retry
the operation.

Explanation: Umount failed for the specified volume

with the indicated errno. Please take suitable action
based on errno and retry the operation.
System action: Processing stopped.
User response: Check errno for umount failure and
take corrective action before retrying the operation.
ANS3409W

An error occurred writing to volume

name.

Explanation: TSM could not write to the named

volume. Examples of why this can occur include, but
are not limited to: the data being written is outside the
valid range of the volume, or the device is locked by
another application. The operating system error code
shown in the message indicates the specific reason for
the failure.
System action: Processing stops.
User response: Use your operating system's tools to
obtain the description of the error code. Also check the
error log for any other messages that might indicate a
reason for the failure. Try to correct any indicated
problems, then try the operation again. If the problem
persists, contact IBM technical support for further
assistance.
ANS3410E

The operating system refused a TSM

request for memory allocation.

Explanation: TSM requires access to memory in order

to store information as processing proceeds. In this
case, more memory was requested than the operating
system would allocate. Possible reasons include:
The system is low on memory.
The process in which the program runs has
exceeded the maximum memory that it is allowed
to allocate.
Some other error condition occurred that caused the
program to think it is out of memory.

system root user to increase resource limits so that it

will override the current default. The UNIX system root
user has the authority to increase resource limits.
ANS3411E

Invalid arguments were passed to

function name.

Explanation: The named function did not receive

correct arguments to proceed. Please check error log for
additional errors following this one for further
explanation.
System action: Processing stops.
User response: Retry the operation. If problem persists
contant your TSM administrator.
ANS3412I

DiskMapper does not support name for

entity name.

Explanation: The requested function is not

implemented in DiskMapper at this time. Please report
this error to your TSM administrator.
System action: Processing stops.
User response: Contact your TSM administrator.
ANS3413I

DiskMapper object 'name' type 'name' is

not valid.

Explanation: The named object is not valid on the

originating client system.
System action: Processing stops.
User response: Retry the operation. If the problem
persists, review the client error log for other messages
that might be related to this problem. Contact your
TSM administrator for additional help.
ANS3414I

Disk 'name' is not part of any container

defined on the system.

Explanation: None.
System action: None. This is informational message.
User response: None.

System action: TSM cannot complete the requested

operation.

ANS3415W

User response: Close all unneeded applications and

try the operation again. If the operation still fails, try
dividing the task into serveral smaller units. For
example, if a file specification contains several high
level directories, run the TSM task serially for each
directory. If the TSM task is an incremental backup, use
the option "-memoryefficientbackup=yes".

Explanation: One or more physical disks containing

data blocks of the above object has bad blocks and the
requested operation can not continue.

For UNIX systems that support resource limits, check

to see b if the memory resource limit is too low by
entering the following command: ulimit -a

At least one of the disk containing data

for 'name' has bad blocks.

System action: The system may find a work-around to

complete the requested operation, pleasecheck console
log and error log for additional information on
corrective actions taken or suggested user action.
User response: Depending on the operation TSM may
suggest an alternate way to complete the operation.

Based on the resulting data, you can ask the UNIX

154

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Check your error log, sched log, or console log for

additional information.

ANS4000E

Error processing 'filespace-name': file

space does not exist.

Explanation: The operation requires exclusive access

to the volume. The most likely cause of this failure is
that other process on the system has the volume
opened.

Explanation: The specified file space (domain) is

incorrect or does not exist on the workstation. If the
message results from the BACKUP IMAGE command
with the -MODE=INCREMENTAL option, it means that
you have entered the name of a raw logical volume.
The MODE=INCREMENTAL option is not valid for
raw logical volumes.

System action: Processing stopped.

System action: Processing stops.

User response: Check applications running on your

system to ensure that volume is not opened by any if
the process and then retry the operation.

User response: Try the operation again, specifying an

existing domain (drive letter or file system name). If
the message resulted from improper use of the
MODE=INCREMENTAL option, try the command
again, omitting that option.

ANS3416E

ANS3417W

The volume 'name' is currently in use by

other process.

name: A system call func failed with code

rc - strerror

Explanation: An error occurred while obtaining

information from the operating system. The volume
information could not be obtained.
System action: Processing can continue if the
information being obtained is not critical for the
operation or if it is expected behaviour in the context of
the operation being performed.
User response: Check the error log for any other
messages that might indicate a reason for the failure.
Try to correct any indicated problems, then try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS3418W

Memory allocation request for image

backup operation was refused by the
operating system.

Explanation: TSM requires access to memory in order

to store information about used blocks of a file system.
In this case, more memory was requested than the
operating system would allocate.
System action: If imagegapsize is too small for a
dedicated filesystem and TSM faces out-of-memory
condition then TSM automatically switches to full
volume backup. Operation continues with
imagegapsize = 0.
User response: Some recommendations to avoid the
out-of-memory condition:
check to see if the memory resource limit is too low
by entering the following command: ulimit -a
Then you can ask the UNIX system root user to
increase memory limit.
increase the value of the imagegapsize option. The
bigger imagegapsize is used, the less memory is
needed for image backup, but more unused data is
sent to server. And vice versa: the smaller
imagegapsize is used, the more memory is needed
for backup, but less unused data is sent to server.
The outcome also depends much on how data is
spread on the volume.

ANS4001E

The file space for domain 'filespace-name'

could not be found on the TSM server.

Explanation: The specified file space was expected to

be found on the server, but it no longer exists. It is
possible that a command was issued to delete the file
space from the server while the current operation was
in progress.
System action: TSM processing stops.
User response: Try the operation again. If the problem
recurs, check the error log for any other messages that
might indicate a reason for the failure. Try to correct
any indicated problems, then try the operation again. If
the problem persists, contact IBM technical support for
further assistance.
ANS4002E

Error processing 'filespace-name': volume

label does not exist

Explanation: The selected drive does not have a label.

System action: TSM is unable to do the requested
operation without a drive or label entered.
User response: If the drive is a floppy drive, place a
disk with a volume label in it and retry the operation.
If the disk is a hard drive, ensure the drive has a
volume label, and retry the operation.
ANS4003E

Error processing 'filespace-name':

duplicate volume label encountered

Explanation: The selected drive has a duplicate

volume label. Because TSM uses the volume label to
keep track of backup/archive information, it cannot
back up or archive files from a drive with a duplicate
volume label.
System action: TSM cannot select the drive.
User response: If the volume needs to be available to
the system, exit TSM, and assign a volume label to the
drive. Restart TSM and retry the operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

155

ANS4004E

Error processing 'filespace

namepath-namefile-name': destination file
or directory is write locked

Explanation: The file or directory being restored or

retrieved from the server cannot be written to because
the destination is write locked. Another operation
might have the file open and will not allow it to be
updated.

User response: Ensure that you specified the correct

file or directory name, correct the permissions, or
specify a new location.
ANS4008E

Error processing 'filespace

namepath-namefile-name': file is
temporarily unavailable

Explanation: File is temporarily unavailable.

System action: File skipped.

System action: File skipped.

User response: Either determine which operation has

the file write locked, or restore the file to another name
or location.

User response: Check and see if file is locked by other

process. If not, retry the command.
ANS4009E

ANS4005E

Error processing 'filespace

namepath-namefile-name': file not found

Explanation: The file being processed for backup,

archive or migrate no longer exists on the client.
Another process deletes the file before it can be backed
up, archived or migrated by TSM.
System action: File skipped.
User response: None.
ANS4006E

Error processing 'filespace

namepath-namefile-name': directory path
not found

Explanation: The operating system returned a "path

not found" status when IBM Tivoli Storage Manager
attempted to access the directory. You either have
specified a directory that does not exist, as shown in
the message (path-name), or the directory being
processed no longer exists on the client because another
process deleted it before it could be backed up or
archived by IBM Tivoli Storage Manager.
System action: The directory is skipped, processing
continues
User response: Recheck all spelling and punctuation,
particularly the placement of directory delimiters (for
example, "\"). Correct the syntax if it is incorrect, then
retry the operation. Ensure that the path is specified
correctly and that the directory actually exists. Retry
the command with the corrected path and directory
name. If you cannot correct the directory name, use the
Exclude option to exclude the directory from the
operation.
ANS4007E

Error processing 'filespace

namepath-namefile-name': access to the
object is denied

Explanation: Access to the specified file or directory is

denied. You tried to read from or write to a file and
you do not have access permission for either the file or
the directory.
System action: Processing stopped.

156

Error processing 'filespace

namepath-namefile-name': disk full
condition

Explanation: No more files can be restored or

retrieved because the destination disk is full.
System action: The client prompts you for action:
v Retry this object
v Skip this object
v Abort the action
User response: Select the appropriate action for this
object. Create some free space on the destination disk
before you retry the operation. Another option is to
restore or retrieve the file to another disk.
ANS4010E

Error processing 'filespace

namepath-namefile-name': stale NFS handle

Explanation: An NFS file system becomes stale.

System action: File system skipped.
User response: Check the NFS mounted filesystem.
ANS4011E

Error processing 'filespace

namepath-namefile-name': no file handles
available

Explanation: All file handles for your system are

currently in use. No more are available.
System action: Processing stopped.
User response: Either free some file handles by ending
other processes, or modify your system setup to allow
for more files to be open at the same time.
ANS4012E

'filespace namepath-namefile-name' already

exists. It will be skipped.

Explanation: The client tried to restore or retrieve the

specified file, but the file already existed in the target
restore location and the user chose not to replace the
existing file.
System action: The file is skipped, a message is
logged in dsmerror.log, and restore or retrieve

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

processing continues with the next object.

System action: File skipped.

User response: The file was skipped because either

REPLACE NO was in effect, causing all existing files
and directories to be skipped, or REPLACE PROMPT
was in effect, and when prompted, the user chose to
skip this file or all existing directories and files. No
additional action is necessary if the decision to skip the
file was deliberate. Otherwise the operation can be
retried using either REPLACE ALL REPLACE
PROMPT.

User response: Stop the operation that is running the

file and retry the operation, or restore or retrieve the
file to a different name or directory.

ANS4013E

Error processing 'filespace

namepath-namefile-name': invalid file
handle

Explanation: An internal system error occurred. A file

operation failed because an invalid file handle was
passed.

ANS4017E

Explanation: While trying to resolve the file name, too

many symbolic links were found.
System action: File skipped.
User response: Ensure that you do not have a looping
symbolic link for the file.
ANS4018E

System action: Processing stopped.

User response: Report the problem to your system
administrator, and then retry the operation.
ANS4014E

Error processing 'filespace

namepath-namefile-name': unknown system
error (error-code) encountered. Program
ending.

Explanation: An unrecognized and unexpected

error-code occurred within the client program. This is a
programming failure and the client program ends.

Error processing 'filespace

namepath-namefile-name': file name too
long

Explanation: The file name specified is too long to be

handled by TSM.
System action: File is skipped.
User response: See the appropriate Using the
Backup-Archive Client book for the particular operating
system, for the file names that are handled by TSM.
ANS4019E

System action: processing stops.

User response: Try the operation again. If the problem
continues, report the error to your TSM administrator.

Error processing 'filespace

namepath-namefile-name': too many
symbolic links were detected while
resolving name

Error processing 'filespace

namepath-namefile-name': file system is
locked by system

Explanation: File system cannot be accessed because it

is locked by the system.
System action: TSM cannot complete the operation.

ANS4015E

Error processing 'filespace

namepath-namefile-name': unexpected TSM
error (error-code) encountered

Explanation: An unexpected error occurred. This

might be a low-level system or communication error
that TSM cannot handle or recover from.
System action: processing stops.
User response: Try the operation again. If the problem
continues, look for other indications of system
problems to determine where the problem exists. Most
systems have error or event logs which may contain
additional information. See your system administrator
or TSM administrator for further help.
ANS4016E

Error processing 'filespace

namepath-namefile-name': file is being
executed; write permission denied

Explanation: The current file cannot be opened to

write to because it is currently being run by another
operation.

User response: See your system administrator.

ANS4020E

The data format for object 'filespace

namepath-namefile-name' is unknown. The
unknown format usually occurs when
the file was backed up or archived by a
later version of IBM Tivoli Storage
Manager.

Explanation: When a file is backed up or archived,

IBM Tivoli Storage Manager includes some additional
information about the file. This message is issued if
IBM Tivoli Storage Manager cannot recognize the
information during a restore or retrieve operation. The
most likely cause is that the file was backed up or
archived with a newer version of IBM Tivoli Storage
Manager. If the file was backed up from a
case-preserving but not case-sensitive file system, the
file name might be displayed with incorrect casing. The
incorrect casing does not otherwise affect processing
since the file is skipped.
System action: The file is not restored or retrieved.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

157

Processing continues with the next file.

HP-UX 1,099,511,627,775 (1TB-1)

User response: Try the restore or retrieve operation

again with a current version of the IBM Tivoli Storage
Manager client software. If the problem persists, contact
IBM technical support for further assistance.

Linux

ANS4021E

Error processing 'filespace

namepath-namefile-name': file system not
ready

2,147,483,647 (2GB)

Mac pre-OS9
2,147,482,624 (2GB-1K)
Mac OS9
18,446,744,073,709,551,616 (16EB)
NetWare
4,294,963,200 (4GB -4KB)

Explanation: The file system/drive was not ready for

access.

NUMA-Q DYNIX/ptx
4.5 1,095,216,660,480 (1TB-4GB)

System action: Processing stopped.

OS/390
4,294,967,295 (4GB)

User response: Ensure that the drive is available to

TSM, and then retry the operation.

SGI

ANS4022E

Solaris 2.6 or higher

1,099,511,627,775 (1TB-1)

Error processing 'filespace

namepath-namefile-name': file system is
invalid.

Explanation: The drive was not available for access.

18,446,744,073,709,551,615 (16EB-1)

Tru64 UNIX
1,099,511,627,776 (1TB)

System action: processing stops.

UnixWare
2,147,483,647 (2GB)

User response: Ensure that the drive is operational,

and then try the operation again. If this is unsuccessful,
check the error log.

Windows ME (FAT32)
4,294,967,295 (4GB)

ANS4023E

Error processing 'filespace

namepath-namefile-name': file input/output
error

Explanation: An error was found while reading from

or writing to the file.
System action: File skipped.
User response: Check your system to ensure that it is
operating properly. For OS/2, run CHKDSK /F for the
failing drive which can be found in dsmerror.log.
ANS4024E

Error processing 'filespace

namepath-namefile-name': file write error

Explanation: An error was found while writing to the

file.

Windows NT/2000 (NTFS)

17,592,185,978,880 (16TB-64K)
System action: File skipped.
User response: Ensure that the system limits are set
properly.
ANS4026W

Error processing 'filespace

namepath-namefile-name': size of 'file-size'
exceeded the maximum file size limit on
your system

Explanation: You tried to restore or retrieve a file that

has exceeded the maximum file size limitation on your
system.
System action: TSM cannot restore or retrieve the file.

System action: File skipped.

User response: Restore or retrieve this file on a system

that supports the file size. See your system
administrator.

User response: Check your system to ensure that it is

operating properly.

ANS4027S

ANS4025E

Error processing 'filespace

namepath-namefile-name': file exceeds user
or system file limit

Explanation: A file being backed up/restored or

archived/retrieved exceeds system set limits for this
user. Shown below are the filesize limits corresponding
to various platforms.
AIX

158

Error processing 'filespace

namepath-namefile-name': internal program
message 'value' encountered

Explanation: An unexpected catastrophic program

failure occurred, indicated by value.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, see your system administrator or service
representative.

68,589,453,312 (64GB)
IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4028E

Error processing 'filespace

namepath-namefile-name': cannot create
file/directory entry

Explanation: The directory path for files being

restored or retrieved cannot be created.

Windows XP/2000/2003
File_space_name
Path_name or directory_name
File_name

1024
248
248

System action: The file is skipped.

System action: File skipped.

User response: Reduce the size of the filename so that

it is smaller that the TSM internal limits.

User response: Ensure that you have the proper

authorization to create the directory for file being
restored or retrieved.

ANS4032E

ANS4029E

Error processing 'filespace

namepath-namefile-name': unable to build
a directory path; a file exists with the
same name as a directory

Error processing 'filespace

namepath-namefile-name': file is not
compressed.

Explanation: A file that was flagged as compressed

was not compressed, and the system failed.
System action: Processing stopped.

Explanation: TSM tried to create a directory path, but

is unable to because a file exists that has the same
name as a directory.

User response: See your system administrator to

report this problem. This error is a system failure.

System action: Processing stopped.

ANS4033E

User response: Remove the file that has the same

name as the directory. Refer to the last restore/retrieve
operation and check all directories along the path.
ANS4030E

Error processing 'filespace

namepath-namefile-name': disk space limit
for this process reached

Explanation: The disk space allocated for the client

owner is full.
System action: Processing stopped.
User response: Free up disk space and retry the
restore or retrieve operation.

Explanation: You are trying to restore a file that was

backed up and compressed on another client
workstation that had more memory than your client
workstation. You cannot restore this file. When the file
is restored, it is expanded and your workstation does
not have enough memory.
System action: TSM canceled the operation.
User response: Obtain a machine with more memory
and retry the operation.
ANS4034E

ANS4031E

Error processing
'file_space_namepath_namefile_name'. Name
exceeds an internal TSM limit.

Explanation: During a file operation, TSM

encountered a filename where at least one component
of the file name (file_space_name, path_name or
directory_name or file_name) exceeded an internal TSM
maximum. The internal TSM limits should not be
confused with the operating system limits for
file_space_name, path_name or directory_name,
file_name.

Error processing 'filespace

namepath-namefile-name': file compressed
on a different client machine that has
more memory

Error processing 'filespace

namepath-namefile-name': unknown system
error

Explanation: An unknown error occurred. This might

be a low-level system or communication error that TSM
cannot handle or recover from.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, determine where the problem exists. See
your system administrator for further help.
File 'filespace namepath-namefile-name'
currently unavailable on server.

Shown below are the TSM internal file name limits for
various platforms.

ANS4035W

AIX HP-UX Solaris

File_space_name
Path_name or directory_name
File_name

Explanation: You tried to restore or retrieve a file that

is currently not available from the TSM server.

Linux
File_space_name
Path_name or directory_name
File_name

1024
1023
256
1024
768
256

System action: TSM Cannot restore or retrieve the file.

User response: Try to restore or retrieve after the file
was made available on the server. See your system
administrator.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

159

ANS4036E

An error occurred saving the registry

key.

Explanation: The active registry key cannot be copied

to the ADSM.SYS staging directory.
System action: Registry backup operation terminates.
User response: Check the space available on the
Windows boot partition to ensure there enough space
to contain a copy of the Windows registry. This might
require several megabytes of free space. Also check the
Windows permissions on the ADSM.SYS staging
directory and ensure that the Windows user under
which you are running TSM has full access to that
directory and its contents.

the TSM Server: audit volume <volume_name> fix=no

If there is any problem reported, you could move the
data from that volume to a new one (see command
MOVE DATA) and try again the restore. 2) There are
communications problems between the TSM Server and
the TSM Client and the results is that the file is
corrupted during the transmission. If you use a gigabit
ethernet adapter on the Server please upgrade the card
driver (AIX platform) or add provided by SUN
suggested changes to some system network options
which have resolved this problem (SUN platform). 3)
Please verify with your network support if during the
restore there are no any problems between the TSM
Client/Server that is originating the file corruption.
ANS4040E

ANS4037E

Object 'file-namefile-namefile-name'
changed during processing. Object
skipped.

Error processing 'filespace

namepath-namefile-name': file system
filespace name has exceeded its space
management quota.

Explanation: The specified file-name was skipped

during backup, archive, or migrate because it was
changing during the attempt to process it.

Explanation: TSM detects that the file system has

exceeded its quota. No more data can be migrated out
of this file system.

System action: TSM skipped the object.

System action: TSM will not migrate files from this

file system.

User response: If you want the file backed up,

archived, or migrated, retry the operation. If it fails,
determine why the object is being changed. For more
information on backing up, archiving, or migrating
changing objects, see your system administrator.
ANS4038E

User response: Recall some files, or ask the system

administrator to increase the quota for this file system.
ANS4041W

An error occurred processing file system

'filespace name'.

Explanation: File system 'filespace name' is corrupted or

contains one or more corrupted directories and cannot
be processed.
System action: File system is skipped.
User response: Check your system to ensure that it is
operating properly. For the Windows environment, run
CHKDSK utility for the failing drive. More information
about corrupted directories can be found in
dsmerror.log.

Explanation: The file system is full. No more free

space or free inodes are available to be allocated for the
transaction file that is needed when a file is being
migrated or recalled.
System action: TSM terminates the current operation
for this file system.
User response: Remove some files in the file system,
and then run reconciliation. Retry the operation.
ANS4042E

ANS4039E

Error processing 'filespace

namepath-namefile-name': compressed file
is corrupted and cannot be expanded.

Explanation: The compressed file cannot be expanded

correctly due to one of the following reasons:
There is a problem on the tape.
There is a communications problem.
The compressed file was corrupted on the TSM
Server.
System action: File skipped.
User response: 1) The compressed file is corrupted
because there is a problem on the tape. To know if this
is the problem, please issue the following command on

160

Error processing 'filespace

namepath-namefile-name': Out of free space
or inodes in file system to migrate or
recall.

Object name 'filespace

namepath-namefile-name' contains one or
more unrecognised characters and is not
valid.

Explanation: The filename, directory name, or volume

label syntax is incorrect.
System action: File skipped.
User response: You need to check the disk for errors.
ANS4044E

Error processing 'filespace-namepathnamefile-name': Case-sensitive name

conflict exists.

Explanation: While processing the specified file on the

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

workstation, another file name was encountered with a

similar name which only differed in case. The
Backup-Archive client does not allow names which
differ only in case on this platform and cannot
guarantee the integrity of the file, so the file is skipped.

please use the default snapshotcachesize of 100% and

ensure that the volume group has sufficient disk space
to allocate snapshots at least as large as the file system
and retry the operation.

System action: This object will be skipped.

ANS4048W

User response: Rename the file in question to a

unique name.

Explanation: ENABLELANFREE option is set to YES

for this session, but an attempt to establish LAN-Free
connection failed.

ANS4045E

System action: The TSM client will failover to non

LAN-Free support.

Error processing 'filespace-namepathnamefile-name': Case-sensitive name

conflict exists. The directory tree will be
skipped.

Explanation: While processing the specified file on the

workstation, another object name was encountered with
a similar name which only differed in case. The
Backup-Archive client does not allow names which
differ only in case on this platform and cannot
guarantee the integrity of the file, so the directory and
all of the objects contained within it are skipped.
System action: This object will be skipped.
User response: Rename the file in question to a
unique name.
ANS4046E

There is an error processing

'filespace-namepath-namefile-name': the
object is corrupted and unreadable.

Explanation: You tried to read from or write to a file

or directory that is corrupted. The corrupted file is
skipped. If this is a directory, the objects contained in
the directory and its subdirectories are skipped.
System action: This object will be skipped.
User response: Check your system to ensure that the
filespace is not corrupted by using system tools like
chkdsk (Windows) or fsck (UNIX).
ANS4047E

There is a read error on

'file-namefile-namefile-name'. The file is
skipped.

Explanation: The specified file-name was skipped

during backup archive because the file could not be
read.
If you are performing a JFS2 snapshot based operation,
it is possible that the snapshot was not large enough to
contain all the changes made to the filesystem after the
snapshot was created. This could cause the snapshot to
become invalid thereby preventing TSM client from
reading the snapshot.
System action: TSM skipped the file.
User response: Check your system to ensure that it is
operating properly.
If you are performing a JFS2 snapshot based operation,

LAN-Free connection failed.

User response: Review the TSM error.log for

LAN-Free failures. Check your LAN-Free setup and
verify that all components are working properly.
ANS4049I

Established LAN-Free connection.

Explanation: ENABLELANFREE option is set to YES

for this session and the TSM client successfully
established LAN-Free connection with server, after the
LAN-Free connection was broken.
System action: The TSM client will communicate with
the server via LAN-Free.
User response: Review the TSM error.log for
LAN-Free errors. Check your LAN-Free setup and
verify that all components are working properly.
ANS4050W

Scheduled action 'schedule-action' did not

execute for schedule 'schedule-name' as
the TSM administrator has been
disabled from executing the scheduled
action on the client.

Explanation: One or more of the client options schedcmddisabled, srvprepostscheddisabled,

srvprepostsnapdisabled, restretrscheddisabled, have
been set to YES on the client thereby preventing the
TSM administrator from executing one of the following
scheduled actions on the client - preschedule,
postschedule, presnapshot, postsnapshot or scheduled
operating system commands, restore or retrieve
operations.
System action: The scheduled operation will not be
executed and a message will be logged to TSM Server
indicating this.
User response: None required.
ANS4051E

Error processing 'filespace

namepath-namefile-name': The decryption
option is in effect, but the user ID
under which back-up or archive is being
run is not authorized to decrypt this
encrypted-file-system (EFS) file.

Explanation: The file being processed is encrypted by

an encrypted file system (EFS). The option is specified
Chapter 2. ANS 0001-9999: Client messages, version 6.3

161

to back-up or archive the file in decrypted form. The

user ID under which the back-up or archive is being
run does not have decryption rights for this file.
System action: The file is skipped.
User response: There are three possible ways to make
decryption work:
v Re-encrypt the file under the encryption key of a
group to which both the owner and the
back-up/archive user IDs belong
v Add the back-up/archive user ID to the list of users
authorized to decrypt this file
v Run the back-up or archive under the owner's user
ID, if possible
ANS4052E

Error processing 'filespace

namepath-namefile-name':
Encrypted-file-system (EFS) file cannot
be restored, because file system does
not support restore from the raw-EFS
back-up data, or possibly because the
restore function does not have write
access to the directory.

Explanation: The file being processed is encrypted by

an encrypted file system (EFS). The file was backed up
in the raw encrypted format. Either the target
filesystem does not support the encrypted format, or
restore does not have write access to the directory to
which the file is to be restored.
System action: The restore is terminated.
User response:
v The file cannot be restored to this location if the file
system is not the AIX Enhanced Journaled File
System (JFS2)
v If the file is JFS2 but EFS is not enabled, then EFS
must be enabled before the file can be restored
v If the user ID under which restore is being run does
not have write permission for the directory, the
permissions must be changed or the restore must be
run under a different user ID
ANS4053E

Error processing 'filespace path filename':

The file cannot be restored because the
file system or operating system does not
support the Encrypting File System
(EFS) data.

Explanation: The specified object was backed-up as

raw Encrypting File System (EFS) data. The client is
trying to restore or retrieve the object to a destination
that does not support the EFS data. The location might
not support the EFS data for one of the following
reasons:

v The target file system does not support the EFS data
System action: The object is not restored or retrieved.
Processing continues with the next object.
User response: If this file must be restored, restore it
to an AIX operating system environment supporting
EFS data.
ANS4054E

Error processing 'filespace

namepath-namefile-name': The encryption
key is not loaded.

Explanation: The file being processed is encrypted by

an encrypted file system (EFS). The option is specified
to backup or archive the file in decrypted form. The
encryption key, required to decrypt the file, is not
loaded in the kernel keyring.
System action: The file is skipped.
User response: There are three situations in which this
problem can occur:
v You just performed initial activation of EFS on the
AIX system, and have not logged out. AIX does load
the keys for the session running at the time of initial
activation. Solution: Logout and login again.
v The login password has been changed recently, and
you normally run with the EFS password the same
as the login password. AIX does not automatically
change the EFS password when you change the login
password. Solution: Issue 'efskeymgr -n' to set the
EFS password to be the same as the login password.
v You need to run the decrypting backup when the
EFS password is different from the login password.
Solution: Issue 'efskeymgr -o ksh' to launch a new
shell with the keys loaded. AIX will prompt you for
the EFS password as you launch the shell. Run the
backup from the new shell.
ANS4055E

Cannot update file space 'filespace-name':

the file space version on the TSM server
is not compatible with this client

Explanation: The file space on the TSM server is not

compatible with this client. This is caused by
performing a backup or archive operation with a client
and then using a down-level client and attempting a
backup or archive operation targeting the same file
space. This problem occurs specifically after a Windows
or AIX client V6.1 or higher performs a backup or
archive operation and then a subsequent backup or
archive operation is attempted with a client V5.5 or
lower.
System action: Processing stops.
User response: Use the correct level of the client.

v The operating system does not provide the support,

or is a release that does not include the support
v EFS support has not been activated on the operating
system

162

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4077E

File 'filespace namepath-namefile-name' is

encrypted by Microsoft EFS and
contains at least one sparse data stream.
The operating system does not support
restore for this file so it is not backed
up or restored.

Explanation: An error in the Microsoft Windows API

prevents successful restore of files that meet the
following conditions:
v The file is encrypted by Microsoft Encrypting File
System (EFS) at the time it was backed up
v The file includes at least one data stream (alternate
"named" stream or unnamed stream) that is sparse
v The operating system is any edition of Microsoft XP,
Microsoft Windows Server 2003, or Microsoft
Windows Server 2003 R2
Because the file cannot be restored, IBM Tivoli Storage
Manager does not back it up. The problem is
documented by Microsoft at http://
support.microsoft.com/kb/2525290.
System action: The file is not backed up or restored.
Processing continues with the next object or ends if
there are no further objects.

System action: Processing continues.

User response: None.
ANS4084E

Explanation: While processing the file, the lstat() call

set EOVERFLOW error code.
System action: This file will be skipped.
User response: The file is skipped. Processing
continues with the next file.
ANS4085I

Assigned 'number' objects from previous

systemstate backup to the new
systemstate backup.

Explanation: Objects in the previous System State

backup have not changed and were assigned to the
new System State backup.
System action: Processing continues.
User response: None.
ANS4086W

User response: If this message is issued during a

backup operation, you can do the following:
v Disable EFS encryption for the file so that it can be
backed up.

Error processing 'filespace-namepathnamefile-name': cannot get file status.

Failed to assign unchanged objects from

previous systemstate backup to the new
systemstate backup. Objects will be
backed up.

v If a backup copy of the file is not necessary, you can

exclude it from backup.

Explanation: Objects in the previous System State

backup have not changed and should be assigned to
the new systemstate backup. Due to error assign
operation failed and objects will be backed up.

ANS4081E

System action: Processing continues.

Error processing 'filespace-name': file

space type is not supported.

Explanation: The specified file space type is not

currently supported by TSM on this platform.
System action: The unsupported file system is
skipped. Processing continues with the next file system.
User response: Refer to the documentation for
information on what file space types are supported.
ANS4082I

Node password has been reset to the

administrative id password.

Explanation: The client logged in using administrative

id rather than node name. The node password has been
reset to be in sync with the administrative password.
System action: Processing continues.
User response: None.

User response: Retry the operation. If the problem

persists, contact TSM technical support.
ANS4089W

File server file-server-name has been

upgraded to Data ONTAP version
'version.modifcation.submodification'.
Perform a full incremental backup by
specifying option
createnewbase=migrate as soon as
possible.

Explanation: The file server has been upgraded to a

version that supports unicode file names for
incremental backup using snapshot difference. Perform
a full incremental in order to backup any files with
unicode names that may have been skipped by the
previous version of the IBM Tivoli Storage Manager
client.
System action: Processing continues.

ANS4083I

New node password has been

generated.

Explanation: The client logged in using administrative

id rather than node name. New random node password
has been generated and recorded.

User response: Perform a full incremental by

specifying the command line option
createnewbase=migrate with the snapdiff option as
soon as possible.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

163

ANS4090I

File server file-server-name has been

upgraded to Data ONTAP version
'version.modifcation.submodification'.
Perform a full incremental backup by
specifying option
createnewbase=migrate as soon as
possible.

Explanation: The file server has been upgraded to a

version that supports unicode file names for
incremental backup using snapshot difference. Perform
a full incremental in order to backup any files with
unicode names that may have been skipped by the
previous version of the IBM Tivoli Storage Manager
client.
System action: Processing continues.
User response: Perform a full incremental backup by
specifying the command line option
createnewbase=migrate with the snapdiff option as
soon as possible.
ANS4099E

The system volume cannot be

identified. Therefore the system state
cannot be backed up.

Explanation: The system volume contains the

hardware-specific system state files that are needed to
start Windows, such as Ntldr, Boot.ini, Ntdetect.com or
Bootmgr. If the system volume cannot be identified,
then these files cannot be backed up. Therefore it is not
possible to back up the system state.
System action: Systemstate backup stops.
User response: Try the operation again. If the problem
persists, obtain a service trace that captures the
problem and contact IBM technical support for
additional assistance. Your TSM administrator can help
you configure the trace.
ANS4148E

Full VM backup of Virtual Machine

'vmname' failed with RC rc

Explanation: The Full VM backup of virtual machine

failed.
System action: The full backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4150E

Incremental backup of Virtual Machine

'vmname' failed with RC rc

vmlist will be processed. The reason for the failure is

written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4151E

Failure mounting Virtual Machine

'vmname'. RC=rc

Explanation: The VMware failed to mount virtual

machine disk.
System action: The backup of the virtual machine can
not continue. The next virtual machine in the vmlist
will be processed. Refer to dsmerror.log for detailed
error message for the reason for the failure.
User response: Refer to dsmerror.log for detailed error
message.
ANS4152E

Failure initializing VMware virtual

machine environment. RC=rc. Refer to
client dsmerror.log for detailed error
messages.

Explanation: Failure initializing VMware virtual

machine environment. Refer to dsmerror.log for
detailed error messages.
System action: The backup can not continue.
User response: Refer to dsmerror.log for detailed error
message.
ANS4153E

Hostname could not be found for

Virtual Machine 'vmname'

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4154E

Possible cause Virtual Machine is not

running and does not have a static IP
address.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.

Explanation: The incremental backup of virtual

machine volumes failed.
System action: The backup of the virtual machine
finished with failures. The next virtual machine in the

164

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4155E

Virtual Machine 'vmname' could not be

found on VMware server.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4156E

File level VM backup of virtual machine

'vmname' not supported. File level VM
backup not support on non Windows
platform guest OS. Platform type:
'platform'.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Backup using Full VM support.
ANS4159E

Backup of Virtual Machine 'vmname'

failed. rc=rc.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4160E

Proxy Rejected: Proxy authority has not

been granted to Agent Node: 'agent_node'
for Target Node: 'target_node'.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
the node has not been granted proxy authority to
access the node named by the backup proxy node. The
TSM administrator must first grant proxy authority.
User response: The TSM server administrator must
grant proxy authority for this node. See the
administrator command "Grant Proxynode".
ANS4161E

Duplicate virtual machine name

'vmname' was detected in the same
backup operation. Backup of virtual
machine 'vmfullname' can not continue
without a unique object name.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Choose a unique name for the virtual
machine.
ANS4162E

The virtual machine

'virtual-machine-name' has not been
previously backed up.

Explanation: The specified virtual machine has not

been previously backed up, so can not be specified for
restore.
System action: The specified virtual machine is
skipped, and the next virtual machine in the restore list
is processed.
User response: Verify the virtual machine name to be
restored, and re-try the operation.
ANS4163I

Encryption is currently enabled, but the

virtual machine backup for
'virtual-machine-name' will not be
encrypted.

Explanation: Virtual Machine files are not encrypted

when backed up to the TSM server.
System action: The virtual machine files are not
encrypted during the backup processing.
User response: No user action is necessary.
ANS4164W

Compression is currently enabled, but

the virtual machine backup for
'virtual-machine-name' is not compressed
because client-side deduplication is not
being used.

Explanation: Virtual machine files are not compressed

because data is stored in a storage pool that is not
enabled for client-side data deduplication. The virtual
machine files are not compressed during the backup
processing unless data is stored in a storage pool that is
enabled for client-data deduplication.
System action: Backup continues, and data is not
compressed.
User response: Ensure that the storage pool is enabled
for client-side data deduplication: Ensure that the
deduplication parameter for the node is
"ClientOrServer" and that deduplication is set for the
client.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

165

ANS4165E

Creating a Virtual Machine, but the

hostname 'virtual-machine-name' was not
found.

ANS4169E

Explanation: The Virtual Machine being creating must

have a valid hostname to be created.
System action: Check the virtual machine hostname
specified for correctness.
User response: Correct the virtual machine hostname
specified and retry the restore.
ANS4166E

Creating a Virtual Machine, but the

datacenter 'virtual-machine-name' was not
found. The name may be incorrect or
may be located in a VMware folder and
require the folder name such as
vmfolder/dcname.

Explanation: The Virtual Machine being created must

have a valid datacenter to be created.
System action: Processing stops.
User response: Check the virtual machine datacenter
specified for correctness. If the datacenter is contained
in a folder then the full datacenter name, complete with
the folder path, must be specified, such as
vmfolder/dcname.

Explanation: There was a write error from the local

disk used to store the virtual machine virtual disk
information. Usually the write error is due to lack of
disk space, lack of write permissions, or some similar
problem with the local disk. The VMBACKDIR option
can be used to assign a different disk location if the
local drive does not have enough free space for the
operation.
System action: A disk write error occurred, and the
operation failed.
User response: Check the local disk for possible
causes of the write error, and use the VMBACKDIR
option to assign another disk if needed.
ANS4170E

ANS4167E

Creating a Virtual Machine, but the

datastore 'virtual-machine-name' was not
found.

Explanation: The Virtual Machine being creating must

have a valid datastore to be created.
System action: Check the virtual machine datastore
specified for correctness.
User response: Correct the virtual machine datastore
specified and retry the restore.
ANS4168E

VMware has reported an error via their

SOAP interface. On the Detailed Status
Report panel, view the last error
message reported. Also check the error
log for more information about the
problem that occurred.

Explanation: The command to VMware failed to

complete. The error returned is displayed on the
Restore or Backup summary panel under the Last Error
Message section.
System action: An error occurred, and the operation
failed.
User response: Check the reported error and correct
the problem. Usually the reason for the error is a
user-supplied value which is not valid for the
operation.

166

A write failure occurred on the local

disk proxy used to temporarily store the
virtual machine virtual disk
information. The write failure can be
caused by the lack of available disk
space on the drive used to store this
information. The VMBACKDIR option
can be used to assign a different disk
location for this purpose. Check the
drive being used and ensure that there
is enough space available for this
operation.

Can not create a Virtual Machine on

VMware release 'release-version-target'
which was backed up from VMware
release 'release-version-source'.

Explanation: The Virtual Machine being created was

backed up from a version of VMware which is not
compatible with the target VMware release version
being used for the restore.
System action: Processing stops.
User response: Restore the Virtual Machine to a
VMware system which is compatible with the level
from which the Virtual Machine was backed up.
ANS4171E

Backup of virtual machine 'vmname'

failed. VM could not be contacted
because of 'vmfullname' connection state.

Explanation: The backup of virtual machine failed.

System action: The backup of the virtual machine
finished with failures. The next virtual machine in list
will be processed.
User response: Correct the connection state from
VMware vCenter and assign VM to an ESX Server.
ANS4174E

Full VM backup of VMware Virtual

Machine 'vmname' failed with RC=rc
mode=full_or_incr, target node
name='target_node_name', data mover
node name='data_mover_node_name'

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Explanation: The Full VM backup of virtual machine

failed.
System action: The full backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.

message from the Deployment Manager. The

architecture of the client, schedule name, and domain
name are identified at the beginning of the message
text.
System action: Deployment Manager continues to
process.
User response: None
ANS4202E

ANS4177E

Full VM restore of VMware Virtual

Machine 'vmname' failed with RC=rc
target node name='target_node_name',
data mover node
name='data_mover_node_name'

Explanation: The Full VM restore of the virtual

machine failed.
System action: The full restore of the the virtual
machine finished with failures. The next virtual
machine in the vmlist will be processed. The reason for
the failure is written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS4199W

File 'file name' is not backed up as part

of the system state because cluster disk
'volume name' is not accessible.

Explanation: The indicated file or directory was

returned by VSS as part of the backup file list of the
writer. However, the cluster disk where the file is
located is not accessible. The reasons for this problem
can be that the cluster disk is offline or belongs to
another node.
System action: The file is not backed up. Processing
continues.
User response: This problem is documented in
Microsoft knowledge base topic 980794
http://support.microsoft.com/default.aspx?scid=kb;ENUS;980794. The topic includes a hotfix. With the hotfix,
you can specify a registry key that contains a list of one
or more files to be excluded from VSS enumeration.
IBM Tivoli Storage Manager does not back up files that
are not enumerated by VSS. If the volume is brought
online to the node performing the system state backup,
then it cannot be backed up. You must remove the
volume from the registry key and restart the system
before you can back up the volume. If you do not want
to implement the hotfix for this problem, IBM Tivoli
Storage Manager continues to issue this message.
ANS4200I

architecture, schedule-name, domain-name:

The Deployment Manager process was
started successfully. Deployment
Manager Version Information: version.

The Deployment Manager failed to

install language pack: language pack
name. The Microsoft Installer error code
was error code.

Explanation: The previous language pack has been

uninstalled, and the installation of the new language
pack failed.
System action: Processing continues.
User response: Check the technote for Microsoft
Installer error code description: http://www01.ibm.com/support/docview.wss?uid=swg21050782
&rs=663
Check the install log on the client computer.
ANS4204E

The Operating System of the client

computer: os name is not supported by
the target version: target version.

Explanation: The operating system level of the client

computer is no longer supported by the target level.
System action: Processing stops.
User response: Check the release documentation for
information on supported operating system levels.
ANS4206E

The Deployment Manager received an

error while extracting from installation
image: image name.

Explanation: The installation image might be missing,

corrupted, or there might be insufficient disk space on
the client computer.
System action: Deployment Manager stops.
User response: Make sure that there is sufficient disk
space on the client computer.
Make sure that all of the Windows self extracting client
images on the client computer are valid.
ANS4208E

The Deployment Manager could not

shut down TSM service: service name.

Explanation: None
System action: Processing continues.
User response: None

Explanation: The Deployment Manager process was

started as a post schedule command. This is the first
Chapter 2. ANS 0001-9999: Client messages, version 6.3

167

ANS4210E

The Deployment Manager failed to

install package: client package name. The
Microsoft Installer error code was error
code.

Explanation: The previous client package has been

uninstalled, and the installation of the new client
package failed.

User response: Refer to the Tivoli Storage Manager

Backup-Archive Client documentation in the
information center.
Reschedule the client deployment with an appropriate
target level.
ANS4216E

System action: Processing stops.

User response: Check the technote for Microsoft
Installer error code description: http://www01.ibm.com/support/docview.wss?uid=swg21050782
&rs=663
Check the install log on the client computer.
ANS4212E

The Deployment Manager failed to

restart service: service name.

Explanation: After the automatic client deployment,

the TSM client services failed to start.

Explanation: The client package for automatic

deployment is invalid. In the client package, the API
version does not match the Deployment Manager
version.
System action: Deployment Manager stops processing.
User response: Please make sure that the installation
package is valid.
ANS4217E

System action: Processing stops.

User response: Log on to the client machine and
check the backup-archive client error log.
ANS4213E

Automatic restart of the client computer

was required because reason

Explanation: The Deployment Manager determined

that the deployment requires restarting the client.
Automatic restart is not enabled. The Deployment
Manager process cancels the deployment.

User response: Reschedule the client deployment.

ANS4214E

The operating system platform of the

client package 'OS platform of package' is
incompatible with the client computer
'OS platform of client computer'.

Explanation: None
System action: Processing stops.
User response: Reschedule the client deployment. Use
a client package with the appropriate operating system
platform.
ANS4215E

The automatic deployment path from

the current client code version 'source
version' to the client package version
'target version' is not supported.

The Deployment Manager received an

error while setting up the client API.
The standard API function being
invoked is API setup function name.

Explanation: The Deployment Manager process failed

when setting up the client API.
System action: Processing stops.
User response: Check the error log on the client
computer.
ANS4218E

The current client is not uninstalled or updated.

System action: Deployment Manager cancels the client
deployment and stops

The TSM API library version API version

is at an earlier version than the version
of the client package package version.

The Deployment Manager received an

error while initializing the client API.
The standard API function being
invoked was API init function name.

Explanation: The Deployment Manager process failed

when initializing the client API.
System action: Processing stops.
User response: Check the error log on the client
computer.
ANS4219E

The Deployment Manager received an

error while creating a pipe for the
standard output of the child process.

Explanation: The Deployment Manager failed to

create a pipe for the standard output of the child
process.
System action: Processing stops.
User response: Check the error log on the client
computer.

Explanation: None
System action: Processing stops.

168

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4220E

The Deployment Manager is unable to

determine if TSM processes are still
running.

Explanation: The Deployment Manager could not

determine whether all TSM processes were shut down
successfully.
System action: If automatic restart (autoreboot) is
enabled, the Deployment Manager continues. If
automatic restart is not enabled, Deployment Manager
stops.
User response: Reschedule with automatic restart
(autoreboot) enabled.
ANS4221E

The architecture of the package: package

architecture does not match the current
client: system architecture.

Explanation: The setup script was unable to retrieve

the matching package from the server.

processing stops and client deployment will not begin.

If the system is slow, processing continues.
User response: Ensure that "PASSWORDACCESS
GENERATE" is set in the client options file and that a
connection to the server has been made without being
prompted for a password. Ignore the warning if the
password has been generated.
ANS4226E

There is at least one error in the post

schedule command of the client
deployment schedule.

Explanation: The Deployment Manager encountered

at least one error while parsing the post schedule
command of the client deployment schedule.
System action: Processing stops, and client
deployment will not begin.
User response: Check the release documentation for
information on the format of the post schedule
command of the client deployment schedule.

System action: Processing stops.

User response: Ensure that the client packages for all
architectures are available on the server.
ANS4222E

The Deployment Manager is unable to

read information in file: file name.

Explanation: Deployment Manager failed to open a

file containing required system information.
System action: Processing stops.
User response: Check the error log on the client
computer.
ANS4223E

The Deployment Manager is missing

required information in file: file_name.

Explanation: The Deployment Manager relies on the

information in this file to complete the client
deployment.
System action: Processing stops.
User response: Check the error log on the client
computer.
ANS4225W

ANS4227E

The setup script is still waiting for the

result of querying system information.
Ensure that "PASSWORDACCESS
GENERATE" is set in the client options
file and that a connection to the server
can be made without being prompted
for a password.

Explanation: The results of querying the system

information has taken longer than expected. This could
be caused by either a slow system or becuase there is
no password saved for the node.

The Deployment Manager failed to

install package: client package name. The
client computer is out of disk space. The
Microsoft Installer error code was error
code.

Explanation: The previous client package has been

uninstalled, and the installation of the new client
package failed because the client computer is out of
disk space.
System action: Processing stops.
User response: Check the technote for Microsoft
Installer error code description: http://www01.ibm.com/support/docview.wss?uid=swg21050782
&rs=663
Check the install log on the client computer.
ANS4228E

The Deployment Manager failed to

install language pack: language pack
name. The client computer is out of disk
space. The Microsoft Installer error code
was error code.

Explanation: The previous language pack has been

uninstalled, and the installation of the new language
pack failed because the client computer is out of disk
space.
System action: Processing continues.
User response: Check the technote for Microsoft
Installer error code description: http://www01.ibm.com/support/docview.wss?uid=swg21050782
&rs=663
Check the install log on the client computer.

System action: If the password is not generated,

Chapter 2. ANS 0001-9999: Client messages, version 6.3

169

ANS4229I

The client computer is required to

restart to complete the new
Backup-Archive client installation.

Explanation: The deployment of the new

backup-archive client will not be complete until the
client computer is restarted. The restart is scheduled to
happen immediately after all language packs are
deployed.
System action: The Deployment Manager process
continues. The client computer will be shut down and
restarted after all language packs are deployed, or
immediately if there are no language pack to install.
User response: None

ANS4234E

The deployment for language packs

failed.

Explanation: The Deployment Manager failed to

install one or more language packs. It is possible the
other messages provide details of the installation.
System action: The Deployment Manager process
continues.
User response: Check the error log and installation on
the client computer. Identify the language packs that
failed to install and manually deploy them.
ANS4235I

The deployment manager cannot log

events to the server.

The client computer will be shut down

and restarted immediately.

Explanation: The Deployment Manager is unable to

log events to the server. It is possible the other
messages provide details of the communications.

Explanation: The Deployment Manager needs to

restart the client computer to complete the client
deployment. It is possible the other messages provide
details of the deployment.

System action: The Deployment Manager process

continues. Events will be logged locally on the client
machine only.

ANS4230I

System action: The Deployment Manager process

continues. The client computer will be shut down and
restarted immediately after all language packs are
deployed, or immediately if there are no language pack
to install.

User response: Check network connection and the

error log on the client computer.
ANS4236E

User response: None

ANS4231E

The deployment for language pack:

image name was cancelled.

Explanation: The Deployment Manager does not

uninstall or update the current language pack. It is
possible the other messages provide details of the
deployment.
System action: Processing stops. The client computer
will be shut down and restarted immediately after all
language packs are deployed, or immediately if there
are no language pack to install.
User response: Check the error log on the client
computer. Manually deploy the language pack.
ANS4232E

Self-extracting installation image: image

name cannot be found.

Explanation: The Deployment Manager could not find

the required installation image.
System action: Processing stops. Client deployment
will be cancelled.
User response: Check the server's activity log or the
scheduler log on the client computer. Reshcedule the
client deployment.

170

The setup script was unable to query

the registry for the Tivoli Storage
Manager client installation directory.

Explanation: The setup script encountered an error

while querying the Windows registry for
[HKLM\SOFTWARE\IBM\ADSM\CurrentVersion\
BackupClient].
System action: Processing stops, and client
deployment will not begin.
User response: Check the release documentation for
information on supported Windows platforms and
ensure the REG.EXE command is available on the client
computer.
ANS4237W

Query system information was

completed with warnings or errors.
ErrorLevel was error level

Explanation: The setup script encountered warnings

or errors while querying system information.
System action: Processing continues. The Deployment
Manager will check to see if required system
information is available. Client deployment could be
cancelled if required information is missing.
User response: Check the error log of the
backup-archive client for warning and error messages.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4238E

Processor Architecture information is

missing in the system information.

Explanation: It is possible the setup script

encountered a warning or error while querying system
information.

ANS4243I

The setup script successfully retrieved

the client package for architecture.

Explanation: The client package that was downloaded

matches the processor architecture of the current client.
System action: Processing continues.

System action: Processing stops. Client deployment

will not start.

User response: None

User response: Check the error log of the

backup-archive client for warning and error messages.

ANS4244E

ANS4239E

Processor Architecture information is

missing in the client package.

Explanation: It is possible the client deployment

package is missing or corrupted.
System action: Processing stops. Client deployment
will not start.
User response: Ensure that the client package is
available and imported to the server correctly.
ANS4240E

Client version information is missing in

the client package.

Explanation: It is possible the client deployment

package is missing or corrupted.
System action: Processing stops. Client deployment
will not start.
User response: Ensure that the client package is
available and imported to the server correctly.
ANS4241I

Architecture of the package: package

architecture does not match the current
client: system architecture. The setup
script is attempting to retrieve the
matching package.

Explanation: The setup script is trying to retrieve the

matching client package from the server.
System action: Processing continues.
User response: Ensure that the client packages for all
architectures are available on the server.
ANS4242E

The setup script encountered a warning

or error while retrieving the client
package for architecture. The error level
is error level.

The setup script failed to install the

Microsoft Visual C++ redistributable
package. Error Level is error level.

Explanation: The Microsoft Visual C++ redistributable

package is required by the new client.
System action: Processing stops.
User response: Check the installation log file for
names with "vcredist*.log" file in system temp directory.
ANS4245I

The setup script successfully installed

the Microsoft Visual C++ redistributable
package.

Explanation: The Microsoft Visual C++ redistributable

package is required by the new client.
System action: Processing continues.
User response: none
ANS4246E

The setup script failed to start the

Deployment Manager program. Error
Level is error level.

Explanation: The setup script could not start the client

deployment process.
System action: Processing stops.
User response: Check the log files on the client
computer for more details. Ensure the client package is
not corrupted.
ANS4247I

The setup script successfully started the

Deployment Manager program.

Explanation: The setup script invokes the Deployment

Manager to manage the deployment process.
System action: Processing continues.
User response: None

Explanation: It is possible the client package is not

available on the server.

ANS4248E

System action: Processing stops.

Explanation: Processing stopped because the

automatic client deployment feature does not support
the installation of a client to a workstation that is
already at its target level.

User response: Ensure that client packages for all

architectures are available on the server. Check the
backup-archive client error log for more detailed error
messages.

The client is already at the target level:

'target version'.

System action: Your current backup-archive client is

not affected.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

171

User response: Refer to the Tivoli Storage Manager

Backup-Archive Client documentation in the
information center.

system event log contains more details about the

failure. Reschedule the client deployment.

Reschedule the client deployment with an appropriate

target level.

ANS4253E

ANS4249E

The setup script was unable to query

the registry for the client scheduler
service name.

Explanation: The setup script encountered an error

while querying the Windows registry for
[HKLM\SOFTWARE\IBM\ADSM\CurrentVersion\
BackupClient\Scheduler Service].
System action: Processing stops, and client
deployment will not begin.
User response: Check the release documentation for
information on supported Windows platforms and
ensure the REG.EXE command is available on the client
computer.
ANS4250E

There is already a deployment manager

running on this computer.

Explanation: Only one instance of client deployment

manager can be active at a time. This client computer
might be configured with multiple node names, but the
new client code only needs to be deployed to one node
per computer. Each client deployment instance can take
a few minutes to complete.
System action: Processing stops.
User response: Ensure only one client deployment
task is scheduled to run at a time.
ANS4251W

writername file 'filename': not found.

Explanation: The indicated VSS writer file or directory

was returned by VSS as part of the backup file list of
the writer. However, the object does not exist on the
disk..
System action: Processing stops if
SKIPMISSINGSYSWFILES option is set to NO.
Processing continues if SKIPMISSINGSYSWFILES
option is set to YES.
User response: Verify that this file can be skipped
during system state backup.
ANS4252E

The deployment manager failed to start

as a scheduled task.

Explanation: The setup script failed to start the

deployment manager as a scheduled task with the
Windows "at" command.

There was not enough disk space on the

client computer. Required space: package
space bytes; available space: system space
bytes.

Explanation: The deployment manager determined

there was insufficient free disk space for the client
deployment.
System action: Processing stops.
User response: Free up required disk space and
reschedule the client deployment.
ANS4254E

The deployment manager detected an

HSM client on the workstation that it
needs to deploy the Backup-Archive
client to.

Explanation: An attempt was made to deploy the

Backup-Archive client to a workstation that already has
the HSM client installed. The Backup-Archive client
cannot be deployed to a workstation that has the HSM
client.
System action: Processing stops.
User response: Uninstall the HSM client and
reschedule the Backup-Archive client deployment.
ANS4255E

There is not enough memory for the

deployment manager to create the
system information object

Explanation: The system information object could not

be created because there is not enough available RAM
to temporarily write the data into.
System action: Processing stops.
User response: Close all unneeded applications on the
client workstation and reschedule the deployment.
ANS4256E

The DSMI_DIR environment variable is

not defined.

Explanation: The deployment manager cannot initiate

a connection to the server because the DSMI_DIR
environment variable is not set. This error can occur if
the deployment manager is started without using the
client scheduler.
System action: Processing stops.
User response: Read the available documentation to
determine how to use the client scheduler to create a
client deployment task.

System action: Processing stops.

User response: Ensure that the Windows Task
Scheduler service is running. It is possible that the

172

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4257E

The deployment manager cannot parse

information in file: file name.

Explanation: The deployment manager could not

parse or extract the required information from the
specified file.
System action: Processing stops.
User response: Check the error log file on the client
workstation.
ANS4258E

The deployment manager received the

Windows "OpenSCManager failed" error
message.

Explanation: The deployment manager could not

connect to the Windows service control manager to
start the client scheduler. In general, this error occurs
because the user who is initiating the task does not
have sufficient authority.
System action: Processing stops.

User response: Check the installation directory of the

current Backup-Archive Client. If the Backup-Archive
Client is not installed in the default location, manually
upgrade the Backup-Archive Client. If the DSM_DIR,
DSMI_DIR, DSM_CONFIG and DSMI_CONFIG
environment variables are defined with a relative path,
define them with an absolute path and try the client
deployment again.
ANS4262E

The preview of the client installation

failed.

Explanation: The deployment manager did not

uninstall the current client. The client code is
unchanged.
System action: Processing stops.
User response: Check the deployment manager log
and trace files on the client workstation for specific
issues identified during the preview. Reschedule a
deployment after any issues are resolved.

User response: Ensure that the user who starts the

client scheduler has administrative privileges.

ANS4263E

ANS4259E

Explanation: The deployment manager received an

error while uninstalling the current client.

The client scheduler is not started as a

root user.

Explanation: The client scheduler requires root user

privileges to upgrade the client code.
System action: Processing stops.
User response: Log in as root and start the client
scheduler.

System action: Processing stops.

User response: Check the deployment manager log
and trace files on the client workstation for more
details on the error. You might have to manually
uninstall the client.
ANS4264E

ANS4260E

The installation file system is not

writeable.

The deployment manager failed to

uninstall the backup-archive client.

The deployment manager failed to

install the backup-archive client.

Explanation: The deployment manager cannot write

to the installation file system.

Explanation: The current client was uninstalled and

the deployment manager received an error while
installing the new client code.

System action: Processing stops.

System action: Processing stops.

User response: Check the installation file system

permissions. It is possible that the current client node
runs in a virtualized environment using the client code
installed in a shared storage of the physical
environment. Reschedule the client deployment with
the client node in the physical environment.

User response: Check the deployment manager log

and trace files on the client workstation for more
details on the error. Manully install the new client after
the issue is resolved.

ANS4261E

The deployment manager cannot

upgrade the Backup-Archive Client.

Explanation: The Backup-Archive Client cannot be

upgraded because either the current location is not the
default installation location or the DSM_DIR,
DSMI_DIR, DSM_CONFIG and DSMI_CONFIG
environment variables are defined with a relative path
and not an absolute path.
System action: Processing stops.

ANS4265I

Client deployment options are not

specified in the scheduler command or
from client services.

Explanation: The default client options file will be

used. The deployment manager might not report the
correct server and node information when reporting
status.
System action: Processing continues.
User response: Configure the client deployment from
the Administration Center and start the client scheduler
as a Windows service.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

173

ANS4266I

The deployment manager failed to

install non-English language pack(s).

Explanation: The previous packages were uninstalled,

and the installation of one or more new language packs
were not successful.
System action: Processing continues.
User response: Check the deployment trace file on the
client workstation for specific language pack
information.
ANS4267I

The deployment manager failed to

install the hardware plugin package.

Explanation: The previous package was uninstalled.

The installation of the new hardware plugin package
failed.

ANS4271E

Explanation: The client deployment package might

not have been imported correctly to the server. It is
possible that the deployment package is not retrieved
completely to the client computer, due to a lack of disk
space.
System action: Processing stops.
User response: Ensure that client packages are
available on the server and there is sufficient disk space
on the client computer. Check the backup-archive client
error log file for more detailed error messages.
ANS4272E

System action: Processing stops.

User response: Check the deployment trace file on the
client workstation.
ANS4268I

The deployment manager failed to

install the journal-based backup
package.

Explanation: The previous journal-based backup

package was uninstalled. The new journal based
backup package installation failed.

The deployment package is missing one

or more required installation image
files.

The processor type of the package:

package processor type does not match the
current client: system processor type. .

Explanation: The processor type supported by the

client package that you want to deploy does not match
the processor type of the workstation that you are
trying to deploy the client to. It is not always possible
for the deployment manager to connect to the server
and report the error.
System action: Processing stops.

System action: Processing stops.

User response: Verify that you are using the correct

client package for the processor architecture of the
computer that you want to upgrade. Then restart the
deployment.

User response: Check the deployment trace file on the

client workstation.

ANS4273E

ANS4269W

The deployment manager is stopping

the scheduler and/or CAD processes.

Explanation: Before deploying the new client, the

deployment manager must stop the scheduler and
CAD processes. After the deployment, the processes
must be restarted.
System action: Processing continues.
User response: The client scheduler is interrupted
during the deployment.
ANS4270I

The deployment manager and the new

client installation packages were
downloaded to directory: file name.

The deployment manager detected a

journal based backup (JBB) client on the
workstation where it needs to deploy
the Backup-Archive Client.

Explanation: An attempt was made to deploy the

Backup-Archive Client to a workstation that already
has the JBB client installed. On some platforms, the
Backup-Archive Client cannot be deployed to a
workstation that has the JBB client installed.
System action: Processing stops.
User response: Uninstall the JBB client and reschedule
the Backup-Archive Client deployment.
ANS4274E

The deployment manager cannot stop

the scheduler or the CAD processes.

Explanation: The download directory contains

everything required to complete the new client
deployment. Deployment log and trace files can be
found in the log/ sub-directory.

Explanation: The deployment manager tried to shut

down the Backup-Archive Client scheduler or CAD
processes but the Backup-Archive Client might be busy
with other tasks.

System action: Processing continues.

System action: Processing stops.

User response: Obtain log and trace files from the

download directory for problem determination. The
files are found within the log/ sub-directory.

User response: Reschedule the Backup-Archive Client

deployment.

174

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS4275E

The deployment manager cannot restart

the scheduler or the CAD processes.

Explanation: Before exiting, the deployment manager

could not restart the Backup-Archive Client scheduler
or CAD processes. The deployment manager stopped
the processes prior to the client upgrade.
System action: Processing continues.
User response: Log on to the Backup-Archive Client
workstation and check the error log file. If you have set
environment variables make sure they are not defined
using relative path.
ANS4276E

The deployment manager cannot obtain

information about the scheduler or the
CAD processes.

Explanation: The deployment manager needs process

information in order to stop and restart the
Backup-Archive Client scheduler or CAD processes.

User response: Change the AUTODEPLOY option on

the client and reschedule the client deployment.
ANS4281E

Explanation: APAR IC57433 prevents the removal of

the TIVsmCapi package on Solaris on a sparse-root,
non-global zone if uninstalling is done from the global
zone.
System action: Processing stops.
User response: Manually uninstall the Tivoli Storage
Manager client directly from the non-global zones and
reschedule the deployment.
ANS4282E

System action: Processing stops.

User response: Log on to the Backup-Archive Client
workstation and check the error log file and the
deployment manager error log file.
ANS4277E

The target operating system version

target operating system does not meet the
minimum required version minimum
required version

Explanation: The operating system version is earlier

than the version required by the automatic deployment
package.
System action: The deployment is canceled.
User response: Ensure that the TSM version being
deployed is supported by the target operating system.
ANS4278E

The deployment manager cannot obtain

information about the Logical Volume
Snapshot Agent (LVSA).

User response: Log on to the Backup-Archive Client

workstation and check the error log file and the
deployment manager error log file.
ANS4280E

Automatic client deployment is not

allowed on the client workstation.

Explanation: One or more of the running client

services include AUTODEPLOY = NO in the option
file.
System action: Processing stops.

Sparse-root non-global zone(s) were

found with Tivoli Storage Manager
Backup-Archive Client that was
installed from the non-global zone: zone
names.

Explanation: One or more non-global zones are

sharing the /usr file system with the global zone. The
Tivoli Storage Manager Backup-Archive Client is
installed in the global zone with the -G parameter and
also installed manually in the non-global zone(s). You
cannot update the Tivoli Storage Manager
Backup-Archive Client in the global zone because it
will update the version of GSKit that is shared with the
sparse-root non-global zones that are not part of the
automatic deployment.
System action: Processing stops.
User response: Manually upgrade the Backup-Archive
Client or install it from the global zone without using
the -G parameter. This ensures that you have the same
version between the global zone and the sparse-root
non-global zones, and you can then deploy the client
automatically on all such zones.
ANS4283E

Explanation: The deployment manager needs to

determine whether an LVSA is installed on the client
workstation.
System action: Processing stops.

The update manager cannot remove the

TIVsmCapi package from non-global
zone(s): zone name.

There is not enough disk space on path

to uncompress GSKit packages.
Required space: req_space bytes;
available space: avail_space bytes.

Explanation: The deployment manager determined

that there is not enough free disk space to uncompress
GSKit packages.
System action: Processing stops.
User response: Free up the required amount of disk
space and reschedule the automatic client deployment.
ANS4284E

The deployment is cancelled because an

automatic client deployment task was
scheduled for a sparse-root, non-global
zone that shares the /usr file system
with the global zone.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

175

Explanation: The automatic client deployment task

that was attempted is not supported and will be
cancelled.

ANS4298E

System action: Processing stops.

User response: Install the Backup-Archive Client from
the global zone or manually upgrade the
Backup-Archive Client.
ANS4295W

architecture, schedule-name, domain-name:

The client deployment was not
completed pending the restart of the
client computer. The deployment
manager did not restart the client
computer automatically because the
AUTODEPLOY option was set to
NOREBOOT.

Explanation: The previous client has been uninstalled,

and the installation of the new client was not
completed pending the restart of the client computer.
The architecture of the client, schedule name, and
domain name are identified at the beginning of the
message text.
System action: The Deployment Manager process
completes.
User response: Manually restart the client computer
as soon as possible.
ANS4296I

architecture, schedule-name, domain-name:

The client deployment was completed
successfully, and the client computer is
being restarted.

Explanation: Restarting the computer is required to

complete the client deployment. The architecture of the
client, schedule name, and domain name are identified
at the beginning of the message text.
System action: The Deployment Manager process
completes. The client computer will be shut down and
restarted.
User response: None
ANS4297W

architecture, schedule-name, domain-name:

Client deployment was completed with
warnings: warnings.

Explanation: This message is a generic warning

message. It is possible that other messages provide
details of the deployment. The architecture of the client,
schedule name, and domain name are identified at the
beginning of the message text.
System action: The Deployment Manager process
completes.
User response: Check the warning messages from the
server administration center, the server activity log, or
error log on the client computer for more information.

176

architecture, schedule-name, domain-name:

The client deployment was canceled.
The previous event causing the
cancellation is: event.

Explanation: This message is a generic message that

the client deployment was canceled. The Deployment
Manager does not uninstall or update the current client.
It is possible that the other messages provide details of
the deployment. The architecture of the client, schedule
name, and domain name are identified at the beginning
of the message text.
System action: Processing stops.
User response: Check the warning messages from the
server administration center, the server activity log, or
error log on the client computer for more information.
ANS4299E

architecture, schedule-name, domain-name:

The client deployment failed. The
previous event causing the failure is:
event.

Explanation: This message is a generic message that

the client deployment failed. It is possible that other
messages provide details of the failure. The architecture
of the client, schedule name, and domain name are
identified at the beginning of the message text.
System action: Processing stops.
User response: Check the warning messages from the
server administration center, the server activity log, or
error log on the client computer for more information.
ANS4300I

architecture, schedule-name, domain-name:

Client deployment was completed
successfully.

Explanation: This is a generic message that the client

deployment was successful. It is possible that other
messages provide details of the deployment. The
architecture of the client, schedule name, and domain
name are identified at the beginning of the message
text.
System action: The Deployment Manager process
completes.
User response: None
ANS4900W

Schedule 'schedule-name' has opened a

new session with the server.

Explanation: A scheduled event endsbecause of a

connection failure. The scheduled event had to be
restarted outside its normal startup window to
continue the operation.
System action: The scheduled event is completed
using more than one session.
User response: None required. If this is a recurrent

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

condition, you may want to check for network

problems.
ANS4901E

The following object contains one or

more unmatched quotation marks and
cannot be processed: 'filespace path
filename'.

Explanation: The file name in the file list contains

unmatched quotes. If a line in the file list begins with a
single or double quotation mark this quotation mark is
considered to be an opening quotation mark. The
corresponding closing quotation mark of the same type
must be at the end of the line. If there is no closing
quotation mark or the closing quotation mark has been
encountered in the middle of the line, it is an invalid
input.
System action: The object is skipped.
User response: Correct the specification of the object.
ANS4942E

ANS4973E

System action: Processing stopped.

User response: Enter a correct file specification as
described in the Using the Backup-Archive Client book
for the particular operating system. Ensure that the file
specification contains valid characters. Verify correct
use of quotation marks for specifications that contain
blanks spaces. If multiple file specifications are used,
make sure that any use of quotation marks does not
cause the file specifications to be treated as a single file
specification.
File server file-server-name has been
upgraded to Data ONTAP version
'version.modifcation.submodification'. This
version does not support unicode file
names for snapshot difference
incremental backup. Upgrade to a
version that supports unicode file names
as soon as possible.

Explanation: The file server has been upgraded from a

version that supports unicode file names for
incremental backup using snapshot difference to a
version that does not. If you have upgraded from Data
ONTAP version 7.3.3 (or later) to 8.0, you lose the
ability to back up files with unicode file names when
performing snapshot difference incremental backup.
System action: Processing continues. However, files
with unicode names are not backed up.

An error occurred accessing NTFS

security information for file 'filespace
namepath-namefile-name'

Explanation: An access denied error occurred while

attempting to access NTFS security info rmation.
System action: The object is skipped.
User response: See your system administrator or
bypass the failing check by using SkipNTSecu rity
option.
ANS4974E

The file specification 'string' is invalid.

Explanation: The operating system indicated that the

file specification is invalid. One possible reason is that
the file specification contains unrecognized characters.
Another possible cause is incorrect use of quotation
marks in the file specification.

ANS4972W

upgraded from Data ONTAP version 7.3.3 (or later) to

8.0, upgrade to 8.1 (or later). If it is not possible to
upgrade at this time, you can suppress this warning
message by renaming the file space on the IBM Tivoli
Storage Manager server and performing a snapshot
difference incremental backup.

Error processing 'filespace

namepath-namefile-name': a required NT
privilege is not held.

Explanation: The user account running TSM does not

possess a required NT user right/pr ivilege for
performing the current operation.
System action: The object is skipped.
User response: Your system administrator has the
authority to grant the needed privilege.
ANS4987E

Error processing 'filespace

namepath-namefile-name': the object is in
use by another process

Explanation: The specified file is being used by

another process. You tried to read from or write to a
file that is currently being used by another process.
System action: File skipped.
User response: Ensure that the file is not locked by
another process. If the file is not locked, retry the
command.
ANS4988W

File 'filespace namepath-namefile-name' is

currently unavailable on server and has
been skipped.

Explanation: You tried to restore or retrieve a file that

is currently not available from the TSM server. This is
most likely a temporary condition.
System action: TSM cannot restore or retrieve the file.
User response: Try to restore or retrieve the file again
after the file becomes available on the server. If the
problem persists, see your TSM administrator for
assistance.

User response: Upgrade to a version that supports

unicode file names as soon as possible. If you have
Chapter 2. ANS 0001-9999: Client messages, version 6.3

177

ANS4989E

Error processing 'filespace

namepath-namefile-name': the directory is
in use by another process. All objects in
the directory and any of its
subdirectories are skipped.

Explanation: The specified directory is being used by

another process. You tried to read from or write to a
directory that is currently being used by another
process. The objects contained in the directory and its
subdirectories are not backed up.
System action: Processing stopped for that directory.
If other files and directories were also specified in this
backup, they are processed
User response: Ensure that you specified the correct
directory name, correct the permissions, or specify a
new location.If the directory name is correct, retry the
backup when no process has exclusive use of the
directory.
ANS4991I

Application Type Application Message Id

Application Message

ANS4997E

Error processing 'filespace

namepath-namefile-name': file system quota
reached condition - no space left.

Explanation: No more files can be restored or

retrieved because the quota of the destination file
system has been reached.
System action: The client prompts you for action:
v Retry this object
v Skip this object
v Abort the action
User response: Select the appropriate action for this
object. Create some free space or increase the quota on
the destination file system before you retry the
operation. Another option is to restore or retrieve the
file to another file system.
ANS4998E

Link information for file 'filename' could

not be obtained: access to the object is
denied.

Explanation: This is a message sent by the application

you are currently running with TSM.

Explanation: Access to the specified file link is denied.

You tried to read information for file link and you do
not have access permission for this object.

System action: TSM logs the application message.

System action: Processing of System State stops.

User response: Refer to the documentation for the

application that you are using.

User response: Try the operation again. If the problem

persists, contact IBM technical support for additional
assistance.

ANS4992W

Application Type Application Message Id

Application Message

Explanation: This is a message sent by the application

you are currently running with TSM.
System action: TSM logs the application message.
User response: Refer to the documentation for the
application that you are using.
ANS4993E

Application Type Application Message Id

Application Message

Explanation: This is a message sent by the application

you are currently running with TSM.

ANS4999I

The following message was too long to

log to the server: 'shortened message with
message number'

Explanation: The message text and inserts are too

large to send to the server in the available internal
buffer.
System action: The message number message is written
to the local client error log, then shortened and sent to
the server as a part of this message. The message is
reduced in length by substituting '...' in the middle of
the original message.

System action: TSM logs the application message.

User response: The message referred to has been

shortened, but describes the error that occurred. See the
documentation for that message for more information.

User response: Refer to the documentation for the

application that you are using.

ANS5000W

ANS4994S

Application Type Application Message Id

Application Message

Explanation: This is a message sent by the application

you are currently running with TSM.
System action: TSM logs the application message.

Unable to update password

Explanation: Intended new password cannot be

registered.
System action: The server did not replace the old
password with the new password.
User response: Update the password again. If
unsuccessful, see your system administrator.

User response: Refer to the documentation for the

application that you are using.

178

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS5001E

Open registration required. Root user

must run TSM to register with server

Explanation: This client must be registered with this

server.
System action: TSM ends.
User response: The root user must register the client
with the server.
ANS5002E

Open registration failed

Explanation: During the change password, update

password, or open register dialog, the open registration
failed.
System action: TSM did not register this system.
User response: Reenter the password, or see your
system administrator to register this system.

ANS5005E

Table of contents information is not

available for the selected images.

Explanation: An error occurred when the server tried

to load a table of contents. Requested image or table of
contents may have expired or been deleted on the
server.
System action: Processing stopped.
User response: Start a new restore window to get
current information.
ANS5006W

The policy set does not contain any

backup copy groups. TSM is unable to
continue the backup.

Explanation: You tried to back up the files using a

policy set that contained no backup management
information.
System action: TSM did not back up the files.

ANS5003S

The management class assigned to

directories does not exist.

Explanation: The management class named on the

DIRMC option does not exist in your assigned policy
set on the server. The error log contains an entry
showing the invalid management class name.

User response: See your TSM administrator for

assistance in associating your node with a policy set
containing a management class that has a backup copy
group. Then try the operation again.
ANS5007W

System action: processing stops.

User response: Remove the current DIRMC option
from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.
ANS5004S

There is no backup copy group in the

management class used for directories.
See the error log.

Explanation: The DIRMC option names a

management class that contains no backup copy group.
System action: processing stops.
User response: Remove the current DIRMC option
from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.

The policy set does not contain any

archive copy groups. TSM is unable to
continue the archive.

Explanation: You tried to archive the files using a

policy set that contains no archive management
information.
System action: TSM did not archive the files.
User response: See your TSM administrator for
assistance in associating your node with a policy set
containing a management class that has an archive
copy group. Then try the operation again.
ANS5008W

Incorrect password entered

Explanation: You entered a password that was

incorrect.
System action: TSM cannot connect to the server
without the correct password.
User response: Reenter the password, or ask your
system administrator for the current password.
ANS5009W

New password entries are not the same

Explanation: During the change password, update

password, or open registration dialog, the two entries
for the new password were not the same.
System action: The password was not changed on the
server.
User response: Backspace over both of the new
passwords and reenter them, ensuring that they match.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

179

ANS5011I

Backup stopped by user

Explanation: You requested to stop the backup

operation.

retry the operation. Reducing the scope of queries and

the amount of data returned can also help, or see your
system administrator.

System action: Backup stopped.

ANS5017I

User response: Continue with normal operations.

Explanation: A restore was completed.

Restore completed

System action: TSM restored the files.

ANS5012E

Server out of backup data storage space

Explanation: The server ran out of space in its backup

data storage.
System action: TSM cannot complete the requested
backup operation. Any files displayed on the lower half
of the backup activity panel were successfully backed
up.
User response: See your system administrator.
ANS5013E

Not enough memory for backup

operation

Explanation: TSM cannot allocate memory for the

specified backup operation.
System action: TSM cannot complete the requested
operation.
User response: Close all unneeded applications and
retry the operation. Reducing the scope of queries and
the amount of data returned might also help, or see
your system administrator.
ANS5014I

Backup completed

User response: Continue with normal operations.

ANS5018E

Explanation: TSM cannot allocate memory for the

requested archive operation.
System action: TSM cannot complete the archive
operation.
User response: Close all unneeded applications and
retry the operation. Reducing the scope of queries and
the amount of data returned might also help, or see
your system administrator.
ANS5019I

User response: Continue with normal operations.

ANS5015I

Restore stopped by user

Explanation: You requested to stop the restore

operation.
Attention: If you were restoring files with overwrite
option specified, the file you restored last can be
damaged (partially overwritten).

Archive stopped by user

Explanation: You requested to stop the archive

operation.
System action: Archive stopped.
User response: Continue with normal operations.
ANS5020E

Explanation: The backup was completed.

System action: TSM backed up the files.

Not enough memory for archive

operation

The TSM server is out of archive data

storage space.

Explanation: The server ran out of space in its archive

data storage.
System action: TSM cannot complete the requested
archive operation.
User response: Report the problem to your TSM
system administrator, who can allocate more resources
to archive storage.
ANS5021I

Archive completed

Explanation: An archive was completed.

System action: Restore stopped.

System action: TSM archived the files.

User response: Continue with normal operations.

User response: Continue with normal operations.

ANS5016E

ANS5022I

Not enough memory for restore

operation

Explanation: TSM cannot allocate memory for the

requested restore operation.
System action: TSM cannot complete the requested
restore operation.

Retrieve stopped by user

Explanation: You requested to stop the retrieve

operation.
Attention: If you were retrieving files with
overwrite option specified, the file you retrieved last
can be damaged (partially overwritten).

User response: Close all unneeded applications and

180

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Retrieve stopped.

ANS5083E

User response: Continue with normal operations.

ANS5023E

Not enough memory for retrieve

operation

Drive specification contains wildcard

character.

Explanation: Drive name shouldn't contain wildcard

character.
System action: Wildcarded objects skipped.

Explanation: TSM cannot allocate memory for the

specified retrieve operation.

User response: Use valid drive specification.

System action: TSM cannot complete the requested

retrieve operation.

ANS5091S

User response: Close all unneeded applications and

retry the operation. Reducing the scope of queries and
the amount of data returned might also help, or see
your system administrator.
ANS5024I

Retrieve completed

The TSM server does not currently have

space in the storage pool for this file.
This might be a temporary condition.

Explanation: This message is typically issued when

the storage pool in which the data is being placed does
not have sufficient to store the data, but that the space
will be available soon. For example, a storage pool
migration may free up sufficient space to store the data.

Explanation: A retrieve was completed.

System action: TSM ends the current operation.

System action: TSM retrieved the files.

User response: This is possibly a temporary condition.

Try the operation again at a later time. If the error
persists, contact your TSM administrator, who can
examine server console and error logs to locate the
cause of the problem.

User response: Continue with normal operations.

ANS5025E

The node name contains invalid

characters.

Explanation: The specified node name has invalid

characters.
System action: TSM canceled the current operation.
User response: Retry with another node name that
has valid characters.
ANS5026W

MatchAllChar and MatchOneChar

options MUST precede Include/Exclude
options

Explanation: The MatchAllChar and MatchOneChar

options must precede any include-exclude options.
System action: The TSM client ends the current
application.
User response: Move the MatchAllChar and
MarchOneChar options before any include-exclude
options.
ANS5062E

ANS5092S

Server out of data storage space.

Explanation: The server does not have any more space

available to store the object.
System action: TSM ended the current operation.
User response: Report to your system administrator
that a storage pool on the server is full.
ANS5093S

SLM_LICENSE_EXCEEDED: The client

licenses for TSM are exceeded. See your
TSM administrator.

Explanation: Adding a new enrollment will exceed the

product license count for this TSM server.
System action: The client enrollment or connection
request ends.
User response: See your TSM administrator to delete
unused enrollments or negotiate an increase in the
number of allowed licenses for your server.

Disk full

Explanation: Operation has stopped because the

destination disk is full.

ANS5094E

System action: Processing stopped.

Explanation: The server does not have enough

memory to allow your client to establish a connection
with the server.

User response: Free up disk space and retry the

operation

Session Rejected. Sufficient server

memory is not available.

System action: Session was not started.

User response: Retry later or see your system
administrator.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

181

ANS5122E

The specified filespace does not exist on

the server. The filespace might have
been deleted by another client or an
administrator.

filespace. Restart TSM and retry the operation.

Otherwise, unmount the duplicate filespace.
ANS5127I

Explanation: The specified filespace does not exist on

the server. Your administrator might have already
deleted the filespace or another client using your
client's node name might have deleted it.
System action: TSM ends the current operation.
User response: The filespace you selected does not
exist any more. See your TSM administrator for help in
finding how the filespace was deleted.
ANS5123S

Open registration failed because the

specified node name is already defined
in the server.

Explanation: Open registration failed because a node

is defined on the server with the same name.

TSM has detected an incomplete setup!

The system options file 'dsm.sys' was
not found, while the client options file
'file-path' exists! The wizard will guide
you through the configuration process
of the initial basic TSM client options
files replacing your current option file.
Would you like to continue?

Explanation: TSM has detected an incomplete setup.

The system options file, dsm.sys, was not found.
Additionally, a user options file, dsm.opt, was found.
To complete the configuration the configuration wizard
will create dsm.sys and replace dsm.opt with minimal
settings.
System action: TSM may stop

User response: Retry with another node name.

User response: If the current version of dsm.opt is

needed, rename the file and restart TSM. If the current
version is not needed, select yes and allow TSM to
replace the file.

ANS5124S

ANS5128E

System action: TSM canceled the current operation.

Open registration failed because there is

no default domain.

Explanation: Open registration failed because a

default policy domain does not exist in which to place
your node. A default policy domain is required to fully
support open node registration.
System action: TSM cancels the current operation.
User response: See your TSM administrator for
assistance in registering your node.
ANS5125S

Open registration failed because an

invalid node name was specified.

Explanation: For backup operations, a file may only

be bound to a management class that has a backup
copy group.
System action: TSM did not back up the file.
User response: See your TSM system administrator
for assistance in finding a management class with the
required copy group. The administrator may also
define such a management class for you.
ANS5129E

Explanation: Open registration failed because the

specified node name has invalid characters.
System action: TSM canceled the current operation.
User response: Retry with another node name that
does not have any invalid characters.
ANS5126S

Filespaces with duplicate names are not

supported. Please unmount the
duplicate filespace.

Explanation: The selected filespace has a duplicate

volume label. Because TSM uses the volume label to
keep track of backup/archive information, it cannot
back up or archive files from a filespace with a
duplicate volume label.
System action: TSM cannot select the volume.
User response: If the filespace needs to be available to
the system, exit TSM, and assign a volume label to the

182

The management class for this file did

not have a backup copy group.

The management class for this file did

not have an archive copy group
specified.

Explanation: For archive operations, a file may only

be bound to a management class that has an archive
copy group.
System action: TSM did not archive the file.
User response: See your TSM system administrator
for assistance in finding a management class with the
required copy group. The administrator may also
define such a management class for you.
ANS5130W

No filespaces selected for deletion

Explanation: You requested a deletion operation

without selecting a client domain.
System action: TSM cannot perform a deletion
without a domain selected.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Select the volumes you want to delete

and retry the operation.
ANS5132I

Filespace deletion canceled by user

Explanation: You requested to cancel the filespace

deletion operation.
System action: The filespace deletion operation
stopped.
User response: Continue with normal operations.
ANS5133I

ANS5139E

Your node does not have permission to

delete archived files.

Explanation: Your node is registered at the server

with the ARCHDELETE option set to 'no'. Therefore
your node is not allowed by the server to delete
archived files.
System action: TSM did not delete the archived files.
User response: See your TSM system administrator.
The administrator has authority to delete archived files,
and can also grant that authority to your node.

Filespace 'filespace' was deleted

Explanation: The specified filespace was successfully

deleted.
System action: TSM deleted the filespace.

ANS5145W

Server cannot restart the last restore

request. Do you want to restore without
restart?

User response: Continue with normal operations.

Explanation: The restart restore token has expired.

The server cannot restart the restore from where it last
ended.

ANS5134E

System action: Processing stopped; waiting for user

intervention.

Unable to delete the filespace because

this node does not have permission to
delete archived data and/or backed up
data.

Explanation: You tried to delete a filespace that you

do not have permission to access.

User response: Retry the request without restart or

abort the request.
ANS5146W

System action: TSM canceled the operation.

User response: Ensure that you specify the correct
filespace, or specify a filespace you have access to.
ANS5135I

Archive delete stopped by user

Explanation: You requested to stop the archive delete

operation.
System action: Archive delete stopped.

You cannot perform this operation while

accessing data for another node. Do you
wish to switch back to accessing your
own node?

Explanation: The user cannot perform the selected

operation while accessing another users data.
System action: Processing stopped; waiting for user
intervention.
User response: Answer "Yes" to switch back to
accessing the server as the original node.

User response: Continue with normal operations.

ANS5148W
ANS5136E

Not enough memory for archive delete

operation

Explanation: TSM cannot allocate memory for the

specified archive delete operation.
System action: TSM cannot continue with the
requested archive delete operation.
User response: Close all unneeded applications and
retry the operation. Reducing the scope of queries and
the amount of data returned might also help, or see
your system administrator.
ANS5138I

Archive delete completed

Explanation: An archive delete was completed.

The server needs to do a one-time

conversion of your archive data before
you can continue. This operation may
take a long time, and cannot be canceled
once it has started. Are you willing to
wait for the conversion to complete?

Explanation: The server must do a conversion of the

archive data before continuing. The conversion could
take a long time, and cannot be canceled once it is
started.
System action: Processing stopped; waiting for user
intervention.
User response: Answer Yes to start the archive data
conversion. If you answer No, the current operation
will be canceled.

System action: TSM deleted the archived files.

User response: Continue with normal operations.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

183

ANS5150E

An active restore for the same source

file specification exists. Unable to
continue with this request.

User response: None.

ANS5155E

Explanation: Currently, there is an active restore for

the same source file specification. Another restore of the
same source file specification cannot be started.

Valid password not available. The TSM

administrator for your system must run
TSM and enter the password to store it
locally.

System action: The requested restore fails.

Explanation: The file containing the stored password

for the specified server server-name is unavailable.

User response: Start another restore with a different

source file specification.

System action: TSM ends.

ANS5151S

This node currently has a pending

restartable restore session. The
requested operation cannot complete
until this session either completes or is
canceled.

Explanation: This operation can not be completed

because a restartable restore session is pending. The
operation is not allowed because the restartable session
and the current operation affect the same file space.
System action: TSM ended the current operation.
User response: Issue a query restart to see the conflict.
Issue the cancel restore command to delete any
unneeded restartable restore sessions.
ANS5152S

Session Rejected: The server is not

licensed for this platform type. See your
TSM administrator.

Explanation: The server license governs the types of

client that can connect to it. The license for this server
does not include the requesting client type.

User response: The TSM administrator for your

system must set and store a new password.
ANS5157E

This action requires TSM administrative

authority on this system.

Explanation: An activity has been attempted that must

be performed by the TSM administrator (for example,
open registration, filespace delete or password update).
System action: TSM canceled the operation.
User response: If the activity is required, the TSM
administrator for this system must perform it.
ANS5158S

Filespace deletion is in progress. Try

again later.

Explanation: The filespace is in the process of being

deleted.
System action: TSM cannot complete the requested
operation.

System action: The client enrollment or connection

request ends.

User response: Try the operation again later. If the

filespace was being deleted, it could take awhile for it
to complete. If the problem continues, report the
problem to your system administrator.

User response: See your TSM administrator who must

upgrade the server license to accept your client type.

ANS5164E

ANS5153E

Session Rejected: The server does not

allow a signon as a Unicode enabled
client.

Explanation: The client cannot establish a connection

to the server because of a unicode enabling mismatch
between server and client.
System action: Session was not started.

Backup or archive of drives with

duplicate volume labels is not allowed.

Explanation: You tried to back up or archive a drive

that has a duplicate volume label. Because TSM uses
the volume label to keep track of backup or archive
information, it cannot back up or archive files from a
drive with a duplicate volume label.
System action: TSM cannot select the drive for backup
or archive operations.

User response: See your system administrator

immediately.

User response: If the volume needs to be available to

the system, exit TSM and assign a unique volume label
to the drive. Restart TSM and try the operation again.

ANS5154I

ANS5165E

File is implicitly excluded

Explanation: You tried to back up or migrate a file

that is implicitly excluded.
System action: TSM will not back up or migrate an
implicitly excluded file.

184

Drive has no volume label.

Backup/Archive not allowed.

Explanation: You tried to backup or archive a drive

that has no volume label.
System action: TSM rejected the selected drive.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: If the drive is a floppy drive, place a

disk with a volume label in it and retry the operation.
If the disk is a hard drive, ensure the drive has a
volume label, and retry the operation.

User response: Wait for the first virtual machine

operation to complete, and then restart the current
request.
ANS5177E

ANS5166E

An error occurred while removing

include-exclude statement 'statement'.
Please try again.

Explanation: There was a problem with removing the

include-exclude statement. Make sure that your
include-exclude statement is valid.
System action: No include-exclude statement was
removed. Waiting for user action.
User response: Retry your operation. If you see this
error message again, contact your system administrator
ANS5169E

The destination path must contain a

drive letter

Explanation: The entered path must begin with a

drive letter, colon, and root slash.
System action: TSM did not continue with the
requested operation.
User response: Enter the destination path in the
correct format.
ANS5173E

An error occurred accessing NTFS

security information.

Client-side deduplication and

server-initiated sessions are mutually
exclusive.

Explanation: Conflicting options

SESSIONINIT=serveronly and DEDUPLICATION=yes
were specified. This combination is not allowed.
System action: Processing stops.
User response: Use client-initiated sessions or disable
client-side deduplication
ANS5178E

Restart of the RSM service failed.

Restart the RSM service manually.

Explanation: RSM database files have been restored

from the TSM server and imported. TSM has tried to
restart the RSM service on the user's behalf but has run
into a problem.
System action: Processing stopped.
User response: Restart the RSM service manually.
ANS5179E

TSM is unable to continue. Exiting

program.

Explanation: An error occurred while attempting to

access NTFS security information.

Explanation: TSM ran into a problem and is unable to

continue. This error message is usually preceded by
other error messages. Resolve those errors and try
again.

System action: Object will not be processed.

System action: Program terminates.

User response: See your system administrator or

bypass by using SkipNTSecurity option.

User response: Fix the problem(s) that preceded this

message and then restart TSM.

ANS5174E

ANS5181E

A required NT privilege is not held.

Explanation: The user account running TSM does not

possess a required NT user right/privilege for
performing the current operation.
System action: Object will not be processed.
User response: See your system administrator.
ANS5176W

The requested virtual machine operation

cannot be performed because a virtual
machine backup or restore operation is
already in progress. Please retry the
operation after the first operation
completes.

Invalid selection; A specific backup set

must be selected.

Explanation: A selection was made that might result

in multiple backup sets being restored at the same
time, but restoring multiple backup sets at the same
time is not supported.
System action: The backup set restore was not
performed.
User response: Select a specific backup set to be
restored.
ANS5182E

Multiple backup sets can not be

restored at the same time.

Explanation: A virtual machine operation is already in

progress, so the requested virtual machine operation
cannot be performed until the first operation complets.

Explanation: Multiple backup sets were selected to be

restored, but restoring multiple backup sets at the same
time is not supported.

System action: Processing stops

System action: The backup set restore was not

performed.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

185

User response: Select a specific backup set to be

restored.
ANS5183W

Objects of different types cannot be

restored at the same time.

Explanation: Restoring objects of different types is not

allowed. For example, restoring Backup Sets and
regular file objects at the same time is not possible.
System action: No processing takes place.
User response: Select objects of the same type to
perform restore operation.
ANS5184E

ANS5189E

Unable to set APF extended attribute for

file:'pathname'Return code: 'returncode'
'strerror'Reason code: 'reasoncode'

Explanation: You must have at least READ access to

the BPX.FILEATTR.APF facility class profile andyou
must be the file owner or have superuser authority.
System action: File processed without setting
attribute.
User response: The attribute must be set manually.
ANS5190E

Illegal Operation On Following Object:

object

Unable to set PROGCTL extended

attribute for file:'pathname'Return code:
'returncode' 'strerror'Reason code:
'reasoncode'

System action: This object will be skipped.

Explanation: You must have at least READ access to

the BPX.FILEATTR.PROGCTL facility class profile
andyou must be the file owner or have superuser
authority.

User response: Try another operation on this object, or

try the same operation on another object.

System action: File processed without setting

attribute.

Explanation: Requested operation cannot be

performed on this object.

ANS5186E

Server is downlevel, System Services

and System State backup disabled for
this session.

Explanation: The operation cannot be performed

because server version is downlevel.
System action: System Service and System State
backup is disabled for this session.
User response: Must use level 5.2.0 or higher server.
ANS5187E

Unable to set SHAREAS extended

attribute for file: 'pathname' Return code:
'returncode' 'strerror' Reason code:
'reasoncode'

Explanation: You must be the file owner or have

superuser authority.
System action: File processed without setting
attribute.
User response: The attribute must be set manually.
ANS5188E

Unable to clear SHAREAS extended

attribute for file: 'pathname' Return code:
'returncode' 'strerror' Reason code:
'reasoncode'

Explanation: You must be the file owner or have

superuser authority.
System action: File processed without setting
attribute.
User response: The attribute must be set manually.

186

User response: The attribute must be set manually.

ANS5191E

NT Active Directory is not online.

Offline backup is not supported.

Explanation: NT Active Directory is not online when

performing a backup operation. Offline backup is not
supported.
System action: Processing stopped.
User response: Reboot computer and turn on Active
Directory, and try the operation again.
ANS5192E

NT Active Directory is online. Online

restore is not supported.

Explanation: NT Active Directory is online when

performing a restore operation. Online restore is not
supported.
System action: Processing stopped.
User response: Reboot computer and enter Active
Directory repair mode, then try the operation again.
ANS5193E

Certificate Services is not online.

Offline backup is not supported.

Explanation: Certificate Services is not online when

performing a backup operation. Offline backup is not
supported.
System action: Processing stopped.
User response: Start Certificate Services and try the
operation again.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS5194E

Certificate Services is online. Online

restore is not supported.

Explanation: Certificate Services is online when

performing a restore operation. Online restore is not
supported.

User response: Select 'YES' to reboot the machine

immediately.
ANS5200I

'service-name' service needs to be

restarted.

System action: Processing stopped.

Explanation: The service must be restarted for the

restored changes to take effect.

User response: Stop Certificate Services and try the

operation again.

System action: Changes are not effected.

User response: Restart the service.

ANS5196W

Invalid encryption key password

entered.

Explanation: The encryption key password supplied

does not meet the TSM requirements. This key can be
up to 63 bytes in length and include the following
characters: A-Z Any letter, A through Z, uppercase or
lowercase 0-9 Any number, 0 through 9 + Plus . Period
_ Underscore - Hyphen & Ampersand

ANS5201E

The specified function is not

implemented

Explanation: The specified function is not

implemented.
System action: Processing stopped.

System action: TSM allows you to try again.

User response: Correct the command and retry the

operation.

User response: Enter the correct encryption key

password.

ANS5202I

ANS5197E

File Replication Service backup failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while backing up files under control of the
Windows 2000 File Replication Service
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the File
Replication Service is operating properly. Restart the
service and retry the backup operation.

One or more system objects were

excluded from processing by entries in
the include-exclude list.

Explanation: One or more system objects were

excluded from processing by entries in the
include-exclude list and the client did not process them.
System action: Excluded objects skipped.
User response: None.
ANS5203E

An error occurred saving one or more

registry keys

Explanation: None.
ANS5198E

File Replication Service restore failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while restoring files under control of the
Windows 2000 File Replication Service
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the File
Replication Service is operating properly. Restart the
service and retry the restore operation.
ANS5199I

The machine must be rebooted for the

changes to take effect. Would you like
to reboot the machine now?

Explanation: The machine must be rebooted for the

changes to take effect. The user can select to have the
program reboot the machine now or can perform this
action manually at a later time.

System action: Processing stopped.

User response: Check the client error log for any other
messages that might help identify the problem. Try the
operation again. If the problem persists, contact IBM
technical support for further assistance.
ANS5204W

Only one backup set may be selected

for restore.

Explanation: Restoring multiple backup sets is not

allowed. Only one backup set may be selected and
restored.
System action: No processing takes place.
User response: Only one backup set may be selected
for restore.

System action: TSM None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

187

ANS5205E

An error saving one or more eventlogs

Explanation: An error occurred saving one or more

eventlogs.

User response: Examine the Windows 2000 File

Replication Service Event log to insure the system
volume was successfully initialized. Restart the service
and retry the restore operation.

System action: Processing stopped.

User response: Correct the command and retry the
operation.
ANS5206E

An error occurred replacing one or more

registry keys.

Explanation: The registry key or keys being replaced

are exclusively held by another process. This can
happen if the registry keys were previously restored
but the system was not restarted.
System action: Processing stops.
User response: Restart the system and try the restore
operation again.
ANS5207I

The machine must be rebooted for the

changes to take effect

ANS5211E

The cluster service is offline. The cluster

service must be online to perform an
authoritative cluster database restore
operation.

Explanation: The cluster service must be online to

restore the cluster database. Tivoli Storage Manager
tried to start the service and failed. It is possible that an
authoritative restore cannot be done.
System action: Processing stops.
User response: Start the cluster service and retry the
operation.
ANS5212E

An error occurred while trying to

rename file space.

Explanation: This operation can not be completed

because the file space could not be renamed.

Explanation: The machine must be started for the

changes to take effect.

System action: TSM ended the current operation.

System action: TSM backed up the files.

User response: Contact system administrator for more

information.

User response: Reboot the machine

ANS5213W
ANS5208E

An invalid date or time was entered.

Explanation: An invalid date or time value was

entered. Either the syntax of the value was not correct,
or an actual value (for example, 45 for month) was
invalid.
System action: Processing stops.
User response: Identify and correct the invalid date or
time value. Refer to the users guide of the
corresponding platform for the correct date syntax.
ANS5209E

System Volume backup failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while backing up files of the Windows 2000
System Volume
System action: Processing stopped.
User response: Examine the Windows 2000 File
Replication Service Event log to insure the system
volume was successfully initialized. Restart the service
and retry the backup operation
ANS5210E

System Volume restore failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while restoring files of the Windows 2000
System Volume
System action: Processing stopped.

188

NAS objects cannot be selected with

other objects for backup.

Explanation: Backing up NAS objects with other types

of objects is not allowed.
System action: No processing takes place.
User response: Select NAS objects without other
objects to perform backup NAS operation.
ANS5214W

NAS objects cannot be selected with

other objects for restore.

Explanation: Restoring NAS objects with other types

of objects is not allowed.
System action: No processing takes place.
User response: Select NAS objects without other
objects to perform restore NAS operation.
ANS5215E

function-type is not allowed on object

'object'. Object is not sent to the server.

Explanation: The operation could not be performed

on this object. For example, if this is an image
operation, the selected path is a file or a directory and
therefore is not a valid object for image operations.
System action: This object is skipped.
User response: Verify that the object named is of a
type supported by the command. For example, if a

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

filespace name is required but a directory name was

given, change the name so it includes only the filespace
name.

User response: Try powering on the restored virtual

machine. If it fails to start, re-try the restore process.
ANS5225W

ANS5216E

Could not establish a TCP/IP connection

with address 'tcp-addr:tcp-port'. The
TCP/IP error is 'tcp-err-string' (errno =
errno).

Explanation: A TCP/IP connection was attempted

with a server or agent program and failed.
System action: Processing stops.
User response: Ensure that the target TCP/IP address
and port number is correct. Check to ensure that a TSM
server or agent has been started at the target TCP/IP
address and is configured to listen at the port listed in
the message.
ANS5217E

Your node does not have permission to

delete backed up files.

Explanation: You cannot delete backed up files unless

your TSM administrator has authorized your node to
do so.
System action: TSM does not delete the backed up
files.
User response: Use the DSMC QUERY SESSION
command to verify your authorization. Ask your TSM
administrator to provide the necessary authorization.
ANS5219W

Objects of different groups cannot be

restored at the same time.

Error error code encountered while

removing the restored snapshot.

Explanation: After the virtual machine disks are

restored, the virtual machine is reverted to the restored
state, and the snapshot is removed. The specified error
was encountered while removing the snapshot.
System action: Processing continues
User response: Try powering on the restored virtual
machine. If it fails to start, re-try the restore process.
ANS5226E

The virtual machine backup operation

failed.

Explanation: The virtual machine backup operation

failed. Check the error log for details on why the
operation failed.
System action: Processing stops
User response: Review the console output and error
logs for the details on the problem. Fix any issues and
restart the operation.
ANS5227E

TSM detected an error where both a

snapshot name was specified, and a
request to create a snapshot were
specified.

Explanation: Either a snapshot name should be

specified, or a request for TSM to create the snapshot
should be specified, but not both.

Explanation: Restoring objects of different groups is

not allowed.

System action: Processing stops.

System action: No processing takes place.

User response: This is an internal error and should be

reported to your service representative.

User response: Select objects of the same group to

perform restore operation.
ANS5222E

ANS5250E

The archive description exceeds 254

characters.

Explanation: TSM places a maximum length of 254

characters on the archive description.
System action: processing stops.
User response: Issue the command again and specify
a shorter valid archive description.

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS5251E

ANS5224W

Error error code encountered while

reverting to the restored snapshot.

Explanation: After the virtual machine disks are

restored, the virtual machine is reverted to the restored
state. The specified error was encountered while
performing this revert operation.
System action: Processing continues

An unexpected error was encountered.

TSM function name : function-name TSM
function : function-desc TSM return code
: TSM-rc TSM file : file-name (line-number)

The snapshot provider is not available

for this operation.

Explanation: TSM was not able to take a snapshot

because the snapshot provider is not available.
System action: Processing stopped.
User response: If you are attempting an operation
using the Microsoft Volume Shadow Copy service make
Chapter 2. ANS 0001-9999: Client messages, version 6.3

189

sure that Volume Shadow Copy service is installed on

the system and also ensure that the TSM snapshot
plugin "pivss.dll" is present.
ANS5252E

TSM attempted to execute a system

command which failed. command :
command rc : rc

Explanation: TSM needed to execute a system

command in conjunction with a snapshot operation.
System action: Processing stops.
User response: See your system administrator.

ANS5257E

The volume 'volume' does not support

the requested VSS operation.

Explanation: The volume does not support the

requested VSS operation. Some reasons for this error
include:
v For off-load backup requests, a hardware provider
cannot be found
v For off-load backup requests, the provider does not
support transportable media
v For local backup requests, the provider does not
support persistent snapshots
System action: Processing stops.

ANS5253W

The system could not create Volume

Shadow Copy Services staging directory
'dir'.

Explanation: The system was unable to create a

user-specified location for the Volume Shadow Copy
Services staging area. The default staging area on the
system drive will be used instead.
System action: Processing continues.
User response: Check the option to specify the staging
area for Volume Shadow Copy Services operations and
specify a valid location.
ANS5254E

The Volume Shadow Copy Services

snapshot plugin 'pivss.dll' was not
found.

Explanation: The system cannot find the VSS snapshot

plugin 'pivss.dll' in any of the plugin locations.
System action: Processing stops.
User response: Check the TSM installation to ensure
the plugin was installed correctly.
ANS5255E

Unable to copy local file 'local-file' to

remote location 'remote-file'.

Explanation: An attempt to transfer a file to a remote

system failed..
System action: Processing stops.
User response: Ensure that the directory path on the
remote system exists and that the TSM application has
the proper authority to write to that location.
ANS5256E

Unable to copy remote file 'remote-file' to

local location 'local-file'.

Explanation: An attempt to transfer a file from a

remote system failed..
System action: Processing stops.
User response: Ensure that the directory path on the
remote system exists and that the TSM application has
the proper authority to read from that location.

190

User response: Retry the request using a supported

backup destination.
ANS5258E

Microsoft volume shadow copy

snapshot initialization failed.

Explanation: IBM Tivoli Storage Manager encountered

an error while initializing the Microsoft Volume
Shadow Copy Service for backup or restore. The IBM
Tivoli Storage Manager error log and Windows event
log can contain additional information about this error.
System action: IBM Tivoli Storage Manager stops the
operation.
User response: Try the operation again. If the error
persists, review the IBM Tivoli Storage Manager error
log and Windows event log for information related to
this error. Use the Windows command VSSADMIN
LIST WRITERS to determine the status of the Volume
Shadow Copy service. Reboot the machine to clear the
volume shadow copy error state. If the system is a
Domain Controller and the Active Directory service is
stopped, restart the Active Directory service.
ANS5259W

Failed to update volume 'volume' for

read-write access used for 'volume'.

Explanation: Changing the volume to read-write

access requires exclusive access to the volume. If the
volume is opened by any application, this operation
will fail.
System action: Processing continues.
User response: Close all the applications using the
volumes and use operating system's interface to mount
failed volume for read-write access.
ANS5260W

Restore object 'volume' has volume either

source 'volume' or target 'volume' volume
that has already been selected for
restore from a different snapshot
volumes. It will be restore using
file-level copy.

Explanation: This error can occur when multiple

objects are selected for snapshot restore and have data

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

overlapping on the volumes and were selected for

restore from different backup versions. Snapshot restore
can only be performed from one local backup.

User response: Contact your TSM administrator to

obtain and install the required plugin module.

System action: The restore object identified in the

message will be restored using the file-level copy after
snapshot restore is completed.

ANS5265W

User response: Retry the restore of identified object

separately for faster restore using snapshot.
ANS5261W

An attempt to create a snapshot has

failed. Another attempt will be made to
create the snapshot in number seconds.

Explanation: An attempt to create a snapshot has

failed with a retryable error. The program will wait for
a short time and retry the operation.
System action: None.
User response: Check the IBM Tivoli Storage Manager
error logs for additional information.

Explanation: This error occurs when restoring

multiple LOCAL backup objects that were created
using different snapshot providers. Snapshot restore
can only be done using one snapshot interface.
System action: Restore will failover to file-level copy
restore from snapshot volume.
User response: If snapshot restore is desired for the
object identified in the message, restore it using a
separate command.
ANS5266E

ANS5262I

Snapshot restore will failover to

file-level copy from snapshot volume.

Explanation: Snapshot restore is not possible due to

an error at this time. TSMwill automatically fails over
to other restore method to complete the restore
operation.
System action: Processing continues.
User response: Check TSM error log for more
information from messages preceding this one to
identify the error condition.
ANS5263E

Snapshot module for 'snapshot provider'

failed with error 'error msg'.

Explanation: The snapshot module for identified

snapshot provider failed to perform the operation and
returned with the identified error.
System action: Restore may automatically failover to
alternate restore method 'file-level copy from snapshot
volume' if possible. Otherwise, processing stops.
User response: Check TSM error log for more
information from messages preceding this one. Use
snapshot provider interface to identify and correct the
problem.
ANS5264W

No snapshot plugin found for 'snapshot

provider' snapshot provider.

Explanation: The snapshot restore requires a plugin

for the specified snapshot provider type. The plugin
must be installed under TSM directory.
System action: Restore will failover to alternate
restore method of 'file-level copy from snapshot
volume'.

Snapshot restore has already been

initialized using 'snapshot provider'
provider module. Another module for
'snapshot provider' provider can not be
loaded at the same time for restore of
'object name'.

File-level copy restore of 'object name'

failed.

Explanation: Data files could not be copied from the

local backup to their destination, causing restore to fail.
System action: Processing continues to another object,
if multiple objects are selected for restore.
User response: Check TSM error log for more
information from messages preceding this one.
ANS5267E

Disk Mapper module failed for the

operation.

Explanation: An underlying TSM operation has failed

to perform the operation due to system error.
System action: Processing stops.
User response: Check TSM error log for more
information from messages preceding this one to
identify cause of the failure. Contact TSM administrator
for more information.
ANS5268W

The Microsoft Volume Shadow Copy

Services writer 'name' current state (state)
is not valid for the current operation.

Explanation: None.
System action: The system will retry the operation
automatically after thirty seconds up to three times to
allow the writer to return to the proper state. If after
three attempts the writer is still in the incorrect state,
the operation will fail.
User response: Determine if there are other Volume
Shadow Copy Services operations that are occurring
concurrently with the current operation.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

191

ANS5269E

The Microsoft Volume Shadow Copy

Services writer 'name' current state (state)
is not valid for the current operation or
cannot be determined. The last error
reported is 'error'.

User response: See the TSM error log for additional

information.
ANS5273E

Explanation: None.
System action: Processing stops.
User response: Check the Microsoft event log to
determine if there are any problems with the writer.
ANS5270E

A VSS restore request with timestamp

'time1' conflicts with a restore request
with timestamp 'time2'

Explanation: A VSS restore request was issued which

requires restoring multiple components which reside in
VSS backup documents with different backup
timestamps. For example, a user backs up Exchange
storage group STG1 on Monday and Exchange storage
group STG2 on Tuesday. On Wednesday, the user tries
to restore STG1 and STG2.

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
after taking a snapshot.

Explanation: None.
System action: Processing stops.
User response: See the TSM error log for additional
information.
ANS5274E

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
after backup completion.

Explanation: None.
System action: Processing stops.
User response: See the TSM error log for additional
information.

System action: Processing stops.

ANS5275E

User response: Resubmit the restore request as

separate requests for each component. For example, if
you receive this error trying to restore Exchange
storage groups STG1 and STG2, resubmit a restore
request for storage group STG1 and a separate restore
request for storage group STG2.

Explanation: None.

ANS5271E

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
before snapshot initialization.

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
before restore initialization.

System action: Processing stops.

User response: See the TSM error log for additional
information.
ANS5276E

Explanation: None.

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
after preparing for a restore operation.

System action: Processing stops.

Explanation: None.

User response: See the IBM Tivoli Storage Manager

error logs for additional information.

System action: Processing stops.

One of the VSS writers is in an invalid or unexpected

state. Try the command "vssadmin list writers" and
check the state of VSS writers. Writers must be in
STABLE state before IBM Tivoli Storage Manager can
continue with VSS operations. Some of the writers can
recover automatically from minor errors. In most cases,
restarting a writer solves the problem. The easiest way
to restart writers is to restart the operating system. It is
possible to restart the specific service that implements a
VSS writer, but it is difficult to determine which service
to restart.
ANS5272E

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
after snapshot initialization.

Explanation: None.
System action: Processing stops.

192

User response: See the TSM error log for additional

information.
ANS5277E

A Microsoft Volume Shadow Copy

Services writer is in an invalid state
after restore termination.

Explanation: None.
System action: Processing stops.
User response: See the TSM error log for additional
information.
ANS5278W

Error processing 'filename': file not

found.

Explanation: The file being processed for backup,

archive or migrate, no longer exists on the client.
Another process deleted the file before it could be
backed up, archived or migrated by TSM.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: File skipped.

ANS5284I

User response: None.

ANS5279E

Error processing 'filename': file not

found.

Explanation: The file being processed for backup,

archive, or migrate, no longer exists on the client.
Another process deleted the file before it was backed
up, archived, or migrated by IBM Tivoli Storage
Manager.
System action: Processing stops.
User response: None.
ANS5280E

Object enumeration from a file set or

file list failed.

Explanation: For more information, see the IBM Tivoli

Storage Manager client error log. This message is
always accompanied by error log message ANS5279E if
the object was not found or by ANS5250E for other
causes, for example, access was denied. These messages
identify the object in question.
System action: Processing stopped.
User response: See the user response based on other
messages in the client error log.
ANS5281E

A remote backup failure has occurred.

remote node name : node remote address
: address multi-node name : multi-node
error message : msg return code : rc

Explanation: For more information, see the IBM Tivoli

Storage Manager client error log on the remote system.
System action: Processing stopped.
User response: See the user response based on other
messages in the client error log.
ANS5282E

A remote backup failure has occurred.

Explanation: For more information, see the IBM Tivoli

Storage Manager client error log.
System action: Processing stopped.
User response: See the user response based on other
messages in the client error log.
ANS5283E

The operation was unsuccessful.

Explanation: None.
System action: Processing stopped.
User response: See the user response based on other
messages in the client error log.

TSM has detected an incomplete setup!

The client options file 'dsm.opt' was not
found, while the system options file
'file-path' exists! The wizard will guide
you through the configuration process
of the initial basic TSM client options
files replacing your current option file.
Would you like to continue?

Explanation: TSM has detected an incomplete setup.

The user options file, dsm.opt, was not found.
Additionally, a system options file, dsm.sys, was found.
To complete the configuration the configuration wizard
will create dsm.opt and replace dsm.sys with minimal
settings.
System action: TSM may stop
User response: If the current version of dsm.sys is
needed, rename the file and restart TSM. If the current
version is not needed, select yes and allow TSM to
replace the file.
ANS5285E

The Microsoft Volume Shadow Copy

Services (VSS) backup XML document
is not valid for restore. For more
information, see the TSM client error
log.

Explanation: Microsoft has released a Volume Shadow

Copy Services (VSS) update in the following operating
system versions:
v Windows 2003 update rollup package KB940349
v Windows Vista Service Pack 1
This new VSS fix packages causes VSS to generates
.xml control files in a format which is not compatible
with the earlier versions of VSS. This error can occur
when a system state restore is being performed from a
base operating system level which does not have the
VSS fixes applied and the system state backup files
were created by an operating system level that did
have the VSS fixes applied.
System action: Processing stops.
User response: The restore procedure for Windows
system state requires that the operating system version
and service pack level used to initiate the restore be at
the same operating system and service pack level used
to create the system state backup. In addition note the
following:
v On Windows 2003 systems you must also apply the
VSS rollup package KB940349 prior to performing
the Ssystem state restore.
v On Windows Vista you must apply the same service
pack that was installed at the time of backup prior to
performing the system state restore.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

193

ANS5286I

The VSS Instant Restore operation was

successful but some existing VSS
snapshots have been deleted by the VSS
provider.

Explanation: A successful VSS Instant Restore

operation was performed for snapshot volumes that
were in a dependent relationship. In order for the
restore process to succeed, it was necessary to remove
the snapshot volumes causing the dependency. Those
snapshot volumes typically represent newer snapshot
backups. This forced TSM to remove the backups that
included the deleted snapshots. This situation is typical
when using SAN Volume Controller (SVC)
space-efficient volumes that have multiple snapshots.
System action: Processing continues.

ANS5300E

Explanation: File list parsing failed because of an

invalid entry.
System action: The operation aborted because of an
file list error.
User response: Correct the invalid file list entry and
restart the operation.
ANS5301E

User response: None.

ANS5287W

VSS restore operation will be performed

using VSS Fast Restore because the XIV
VSS Hardware Provider is at level 2.2.2.

Explanation: XIV VSS Hardware Provider 2.2.2 has

issues with VSS Instant Restore. Please update the XIV
VSS Hardware Provider to version 2.2.3, or later.

Error detected in specified file list 'file

list name' during processing of line line
number: found an invalid external object
ID / inode number / inode generation number
/ restore order number / alias entry: 'invalid
entry'. Invalid line: 'invalid entry'

Error detected in specified file list 'file

list name' during processing of line line
number: found an invalid ordering of
external object IDs. ext. object ID of
previous file: previous external object ID
ext. object ID of current file: current
external object ID

Explanation: File list parsing failed because of an

invalid ordering of the external object IDs.

System action: Processing continues.

System action: The operation aborted because of an

file list error.

User response: Update XIV VSS Hardware Provider to

version 2.2.3, or later.

User response: Correct the invalid file list ordering

and restart the operation.

ANS5298E

ANS5302E

A Flashcopy background copy is in

progress between source volume: and
target volume: .

Explanation: A Flashcopy background copy from a

previous operation is not complete for the given source
and target volumes.

File list stream error to file 'file list name'

detected during processing of line line
number.

Explanation: File list processing failed because of an

stream error.

System action: Command will fail.

System action: The operation aborted because of an

file list stream error.

User response: Please wait until the background copy

is complete and retry the command.

User response: Check the specified file list and restart

the operation.

ANS5299E

ANS5303I

A Flashcopy association exists between

source volume: and a different target
volume: .

Explanation: A Flashcopy association exists between

the source volume and a target other than the
designated target volume.
System action: Restore command will fail.
User response: Please withdraw the Flashcopy
association between the source volume and the target
volume and retry the restore command.

***** date Processed count TSM server

and count file list objects *****

Explanation: TSM has processed the specified number

of TSM server and file list objects.
System action: Processing continues.
User response: None.
ANS5304E

program-name: synchronous file deletion

failed for external object ID: external
object ID.

Explanation: The HSM client could not delete an

object on the TSM Server.
System action: Current file is skipped for synchronous
file deletion and the process will continue.

194

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Check the TSM server log file.

ANS5307E

The session is rejected. The server does

not allow a signon of a client that is not
enabled for space-management
retention-protection.

Explanation: The client cannot establish a connection

to the server because the server is enabled for
space-management retention-protection and the client is
not.

ANS5824E

Explanation: The search specification for Active

Directory objects is not valid.
System action: Processing stops.
User response: Refer to the documentation for
supported Active Directory syntax.
ANS5825E

System action: The session is not started.

User response: See your system administrator.
ANS5821E

Cannot connect to Active Directory.

Explanation: TSM could not connect to Active

Directory. The Active Directory is either not running or
you don't have enough permissions to use it.
System action: Processing stops.
User response: Make sure your system is set up as
Active Directory controller and the the service is active.
Make sure you are logged in as a user with sufficient
rights to administer the Active Directory.
ANS5822E

No Active Directory objects match

query.

Explanation: A search has been performed in Active

Directory; however, no objects matching the query were
found.
System action: Processing stops.
User response: Make sure you specify a valid
distinguished name of Active Directory object or a
container, or a valid wildcarded name, and that you
have sufficient rights to administer the Active Directory.
ANS5823W

Invalid Active Directory search

specification.

Reanimate 'tombstone-name' to
'distinguished-name' failed. See the error
log for more details.

Explanation: An attempt to reanimate Active

Directory tombstone object has been performed, but an
error occurred.
System action: Processing continues to process all
other tombstone objects per user's request.
User response: None.
ANS5826E

Restoring to a read-only domain

controller is not allowed.

Explanation: An attempt to restore to a read-only

domain controller.
System action: Processing stops.
User response: None.
ANS5827E

A backup copy of the Active Directory

database was not found.

Explanation: An attempt to restore Active Directory

objects from a database that was not backed up.
System action: Processing stops.
User response: Verify the Active Directory was backed
up with system state.

Object exists, skipping

Explanation: The client tried to restore the specified

object, but the object already existed in the target
restore location and the user chose not to replace the
existing object.
System action: The object is skipped, a message is
logged in dsmerror.log, and restore processing
continues with the next object.
User response: The object was skipped because either
REPLACE NO was in effect, causing all existing objects
to be skipped, or REPLACE PROMPT was in effect,
and when prompted, the user chose to skip this object.
No additional action is necessary if the decision to skip
the object was deliberate. Otherwise the operation can
be retried using either REPLACE ALL (automatically
replace existing object) or REPLACE PROMPT (prompt
the user whether to replace the object).

ANS5828E

A system state file space was not found

on the server. Active Directory functions
can not be executed.

Explanation: An attempt to restore the Active

Directory database from a system state backup that
does not exist.
System action: Processing stops.
User response: Verify that system state was backed up
or back up the system state then retry the command.
ANS5829E

A system state backup on the specified

date was not found. Active Directory
functions can not be executed.

Explanation: An attempt to restore the Active

Directory database from a system state backup that
does not exist.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

195

System action: Processing stops.

User response: Verify that system state was backed up
on the specified date or specify a new date.
ANS5830E

Restore of object 'tombstone-name' is not

allowed by Active Directory.

Explanation: Object of certain types cannot be

restored. This is a system limitation.
System action: Processing continues to process all
other objects per user's request.

ANS5834E

Explanation: An unexpected error occurred during

Active Directory tombstone reanimation.
System action: Processing continues to process all
other tombstone objects per user's request.
User response: Check the error log for detailed
information on the LDAP error.
ANS5835E

User response: None.

ANS5831E

Restore for this object is not allowed by

Active Directory.

Explanation: Object of certain types cannot be restord.

This is a system limitation.
System action: Processing continues to process all
other objects per user's request.

Reanimate tombstone object failed. See

the error log for more details.

Explanation: An attempt to reanimate Active

Directory tombstone object has been performed, but an
error occurred.
System action: Processing continues to process all
other tombstone objects per user's request.

An LDAP operation returned return code:

'error string'

Explanation: An unexpected error occurred during

Active Directory tombstone reanimation.
System action: Processing continues to process all
other tombstone objects per user's request.
User response: None.
ANS5836W

User response: None.

ANS5832E

Unexpected LDAP error occurred. See

the error log for more details.

One or more attributes were not

restored. See the error log.

Explanation: During processing of an Active Directory

object, one or more object attributes could not be
restored.
System action: Processing continues to process all
other Active Directory objects per user's request.
User response: Check the error log for detailed
information on which attribute(s) could not be restored.
'object name': attribute 'attribute name'
could not be restored.

User response: None.

ANS5837W

ANS5833E

Explanation: The listed attribute could not be restored

during processing on the Active Directory object.

This system is a Domain Controller but

the Active Directory service is stopped.
You can not perform the operation
unless the Active Directory service is
running.

Explanation: The Active Directory service must be

running when you back up or restore the system state
or operate on Active Directory objects. When the Active
Directory service is running, it can be in online state or
in offline state. When you query or restore Active
Directory objects, or back up the system state, the
Active Directory service must be online. When you
restore the system state, the Active Directory service
must be offline (but not stopped).
System action: Processing stopped.
User response: If you are querying or a restoring the
Active Directory objects or backing up the system state,
put the Active Directory service in online state by
starting the Active Directory service. If you are
restoring the system state, put the Active Directory
service in offline state by rebooting to the Active
Directory Restore Mode. When the Active Directory
service is in the appropriate state, retry the operation.

196

System action: Processing continues to process all

other Active Directory objects per user's request.
User response: None.
ANS5838E

The utility dsamain.exe does not exist

on the system. You cannot perform the
operation unless Tivoli Storage Manager
can launch this utility.

Explanation: You attempted to launch dsamain.exe,

but the utility does not exist.
System action: Processing stopped.
User response: Verify that the dsamain.exe utility
exists in the Windows system32 directory. When you
can run the utility independently of Tivoli Storage
Manager, retry the operation.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS5839E

The Active Directory object specification

is not allowed.

Explanation: You attempted to restore the domain

object (starting with "DC="), or you attempted to
restore all objects ("name=*"), or you did not specify
anything.
System action: Processing stops.
User response: Modify the specification then retry the
operation.
ANS5840E

The current user is not a member of the

Administrators group, and cannot
perform this function.

Explanation: You must be a member of the

Administrators group to perform the Active Directory
objects function.

User response: Recreate the failing object manually or

restore it from a backup.
ANS5844E

Explanation: An error happened during the password

update attempt. This error might indicate that your
node is not configured on the TSM server or the TSM
session is disabled.
System action: The password is not updated
User response: Please check if your node is registered
with the server. Check your node name and try to run
dsmc without arguments to register the node. If the
error appears again, contact your TSM server
administrator.
ANS5845E

System action: Processing stops.

User response: Log on with a user who is a member
of the Administrators group or add this user to the
Administrators group then retry the operation.
ANS5841E

Active Directory database could not be

opened.

Explanation: An error occurred while opening the

restored Active Directory database.
System action: Processing stopped.
User response: Make sure ntdsutil.exe utility is
located in the same directory with TSM client
executables. If it doesn't exist, reinstall the client. Verify
that the dsamain.exe utility exists in the Windows
system32 directory. When you can run the utility
independently of Tivoli Storage Manager, retry the
operation. If the problem persists, contact the support.
ANS5842E

'tombstone-name': object class violation.

Explanation: Object class error violation occurred

during tombstone reanimation. This can happen if the
Active Directory schema was modified and is no longer
compatible with the tombstone.

Unable to update password.

Unable to update password because the

maximum number of update attempts
has been exceeded.

Explanation: This message is issued after making 3

unsuccessful attempts to update the password. The
original password for the node was entered incorrectly;
the new password does not meet the length or valid
character requirements for our passwords; or there was
a mismatch between the first and second times the new
password was entered.
System action: The password is not updated.
User response:
v Make sure the original password is entered correctly.
Contact your TSM administrator for further
assistance if you do not know the original password.
v Make sure the new password meets the password
length and character requirements.
v You will be prompted to enter the new password
two times, so make sure it is entered correctly both
times.
ANS5876I

SET EVENT Activate Retention

completed

Explanation: The Data Retention ACTIVATE

transaction has completed.

System action: Processing continues to process all

other objects per user's request.

System action: TSM activated the objects that were

selected.

User response: Recreate the failing object manually or

restore it from a backup.

User response: Continue with normal operations.

ANS5877I

ANS5843E

Object class violation.

Explanation: Object class error violation occurred

during tombstone reanimation. This can happen if the
Active Directory schema was modified and is no longer
compatible with the tombstone.
System action: Processing continues to process all
other objects per user's request.

SET EVENT Hold completed

Explanation: The Data Retention HOLD transaction

has completed.
System action: TSM held the objects that were
selected.
User response: Continue with normal operations.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

197

Explanation: The Data Retention RELEASE transaction

has completed.

to a version that supports running this action as a

scheduled event. Until the client is upgraded, you can
run the action manually if your version of the client
supports it.

System action: TSM released the objects that were

selected.

ANS7500W

ANS5878I

SET EVENT Release completed

User response: Continue with normal operations.

ANS6001S

NULL character found in the name of

folder/file filename.

Explanation: A NULL character was found in the

name of a file or folder. Some products place a NULL
character in a file name so that the file is sorted
alphabetically to the top of a list. TSM cannot
backup/restore such files.
System action: TSM cannot complete the requested
operation.
User response: Remove the NULL character by
renaming the file or folder.
ANS7421W

The archive attribute for file filename

cannot be reset. The return code from
Windows API function
SetFileAttributes() is rc.

Explanation: The client was unable to reset the

archive attribute for the file indicated in the message.
This error is due to an error received from the
Windows API function SetFileAttributes().
System action: processing stops.
User response: Try the operation again. If the problem
persists, it may be indicative of a problem with the file.
Contact your system administrator or TSM
administrator for further assistance.

Explanation: The management class specified in an

include statement was not valid. If the include
statement is an "INCLUDE.SIZE" statement the
warning message will be issued if an appropriate
copygroup is defined for the management class. For
example, this warning will be issued on a backup
operation if no backup copygroup is defined for the
management class or this message will be issued on an
archive operation if no archive copygroup is defined
for the management class.
System action: The management class on the include
statement is ignored and processing continues.
User response: Contact the TSM administrator to
correct the appropriate copygroup definition on the
TSM Server.
ANS7501E

Unsupported action 'action' in schedule

'schedule name'.

Explanation: The scheduled action is unknown to the

current version of the IBM Tivoli Storage Manager
client and cannot be performed by means of a
schedule. The most likely cause is that the scheduled
action requires a later version of the backup-archive
client. The unsupported action is displayed as a
number because the text description is not available.
Scheduled actions and their corresponding action
number can be found by searching for this message on
the IBM Tivoli Storage Manager support site.
System action: The scheduled action is not performed
or queried.
User response: Search the IBM Tivoli Storage Manager
support site for this message to find information about
scheduled actions, their corresponding action numbers
and the client version at which the action is supported.
Then upgrade your IBM Tivoli Storage Manager client

198

An invalid host address was received.

Host address is too long.

Explanation: An invalid host parameter was found in

the HTTP Request. The parameter is too long. The
maximum length for a host address is 64 characters.
System action: TSM returns HTTP error code 400 Bad
Request.
User response: Use a host machine with a
valid/shorter host address.
ANS7502E

ANS7422E

Object 'object-name' could not be bound

to management class 'mgmt-specified'
specified in an 'option' statement.

An invalid filename was received.

Filename is too long.

Explanation: A filename passed to the dsmcad service

is too long and thus invalid.
System action: TSM returns HTTP error code 400 Bad
Request.
User response: Retry connecting to dsmcad but use a
valid/shorter filename.
ANS7503W

Invalid drive entry

Explanation: An invalid entry is entered on the Drive

field.
System action: TSM prompts you to enter a valid
drive letter.
User response: Enter a valid drive letter or see your
system administrator for the correct syntax.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS7504W

Invalid directory entry

Explanation: An invalid entry is entered on the

Directory field.
System action: TSM prompts you to enter a valid
directory.
User response: Enter a valid directory or see your
system administrator for the correct syntax.
ANS7505W

Invalid filename entry

Explanation: An invalid entry is entered on the

Filename field.
System action: TSM prompts you to enter a valid file
name.
User response: Enter a valid file name or see your
system administrator for the correct syntax.
ANS7506W

Invalid label entry

Explanation: An invalid entry is entered on the Label

field.
System action: TSM prompts you to enter a valid
volume label.
User response: Enter a valid volume label or see your
system administrator for correct syntax.
ANS7507W

The node name entry is invalid. Please

try again.

Explanation: An invalid entry is entered on the Node

Name field.

User response: Enter an existing drive and volume to

define the desire rule.
ANS7510E

Explanation: NAS nodes cannot be used for

operations like Access Another Node.
System action: TSM prompts you to enter a valid
node name.
User response: Enter a valid, non-NAS, TSM node
name.
ANS7522E

ANS7508W

Duplicate authorization

Explanation: The authorization rule entered by the

user is already defined. Duplicate rules are not allowed.
System action: TSM allows you to enter a different
rule.
User response: Enter an authorization rule that has
not been defined yet or cancel defining authorization
rules.
ANS7509W

Drive and/or volume label do not exist

Explanation: Either the drive or the volume label or

both do not match the existing ones. Rules must be
defined on existing drives and volumes.
System action: TSM prompts you to reenter drives
and/or volumes or cancel defining authorization rules.

Environment variable name is not set.

Explanation: Required environment variable as

indicated in the message is not set for TSM processes.
System action: Processing stops.
User response: Set the environment variable and
restart TSM processes then retry the operation.
ANS7523E

The hardware type number is not known

to TSM.

Explanation: Due to a configuration or internal error,

underlying snapshot hardware type is not set correctly.
System action: Processing stops.
User response: Check your configuration and error
log file for more information. If unresolved, contact
your TSM administrator for help.
ANS7526E

System action: TSM prompts you to enter a valid

node name.
User response: Enter a valid node name or see your
system administrator for the correct syntax.

A NAS node cannot be used for this

operation.

The SNAPSHOTROOT option is not

valid with either of the following
options: -GROUPNAME and
-VIRTUALFSNAME.

Explanation: The SNAPSHOTROOT option is

incompatible with the -GROUPNAME and
-VIRTUALFSNAME options and cannot be used with
either one of those options.
System action: Processing stops.
User response: For information about backup-archive
client processing options, see IBM Tivoli Storage
Manager Backup-archive Clients Installation and User's
Guide.
ANS7527E

The (-SNAPSHOTROOT) option is not

valid in conjunction with num-specs file
specifications.

Explanation: The (-SNAPSHOTROOT) option must be

used in conjunction with only one file specification. It
cannot be used with zero file specification (e.g., an
INCREMENTAL command with no file specifications)
or with more than one file specification.
System action: Processing stopped.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

199

User response: See the appropriate Using the

Backup-Archive Client book for your operating system
for correct use of the named option.

User response: See the appropriate Using the

Backup-Archive Client book for your operating system
for correct use of the named option.

ANS7528W

ANS7531E

The (-SNAPSHOTROOT) option is not

valid in conjunction with the Logical
Volume Snapshot Agent. Processing will
continue without the use of the Logical
Volume Snapshot Agent.

Explanation: The (-SNAPSHOTROOT) option is

incompatible with the Logical Volume Snapshot Agent.
The Logical Volume Snapshot Agent provides a
comprehensive snapshot solution without having to use
the (-SNAPSHOTROOT) option. It is strongly
recommended that the snapshot capabilities provided
by the Logical Volume Snapshot Agent be used instead
of using the (-SNAPSHOTROOT) option. Processing
continues without the use of the Logical Volume
Snapshot Agent.
System action: Processing continues without the use
of the Logical Volume Snapshot Agent.
User response: See the appropriate Using the
Backup-Archive Client book for your operating system
for correct use of the named option.
ANS7529E

The specified SNAPSHOTROOT

'obj-name' is not valid for the BACKUP
IMAGE command.

Explanation: When you use the (-SNAPSHOTROOT)

option with the BACKUP IMAGE command,
SNAPSHOTROOT must specify the device name of the
logical volume containing the snapshot for the backup.
An example is /dev/fslv01 (on Unix) or
\\?\GLOBALROOT\Device\
HarddiskVolumeShadowCopy1 (on Windows).
With BACKUP IMAGE, SNAPSHOTROOT cannot be
used unless SNAPSHOTPROVIDERIMAGE has one of
the following values in effect:
v VSS
v JFS2
System action: Processing is stopped.
User response: For the correct use of the
(-SNAPSHOTROOT) option, see the appropriate
Backup-Archive Client Installation and User's Guide book
for your operating system.
ANS7530E

The snapshot_volume_name cannot end

with a directory delimiter.

Explanation: The snapshot_volume_name cannot end

with a directory delimiter. This name should specify
the root of a logical volume, e.g., /snapshot, x:,
\\machine\x$, SNAP_VOL:, etc.
System action: Processing stopped.

200

The (-SNAPSHOTROOT) option is

invalid when processing the NetWare
NDS or Server Specific Information.

Explanation: The (-SNAPSHOTROOT) option is only

intended with NetWare file server volumes and is not
compatible with processing the NDS or Server Specific
Information on NetWare.
System action: Processing stopped.
User response: See the appropriate Using the
Backup-Archive Client book for your operating system
for correct use of the named option.
ANS7532E

The logical file system specified with

the (-SNAPSHOTROOT) option cannot
be a remote NetWare file system.

Explanation: The (-SNAPSHOTROOT) option is only

intended with local NetWare file server volumes and is
not compatible with remote NetWare volumes.
System action: Processing stopped.
User response: See the appropriate Using the
Backup-Archive Client book for your operating system
for correct use of the named option.
ANS7533E

The specified file system 'obj-name' does

not exist or is not local.

Explanation: When you use the (-SNAPSHOTROOT)

option, the target and source file systems must be valid,
local file systems. The file systems cannot be non-local,
such as a remote NetWare drive, a remote Windows
drive, or an NFS mount. The (-SNAPSHOTROOT)
option is valid for local operations only.
System action: Processing is stopped.
User response: For the correct use of the
(-SNAPSHOTROOT) option, see the appropriate
Backup-Archive Client Installation and User's Guide book
for your operating system.
ANS7534W

Initialization functions cannot open

/dev/tty special file. errno = errno-value,
error message

Explanation: Special file /dev/tty, required by

command line internal editor could not be opened
during initialization. The system set the error code
errno-value.
System action: Processing continues as if EDITOR
option was set to NO.
User response: Check your terminal settings.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS7535W

Command line internal editor can not

be initialized.

Explanation: EDITOR option is set to YES in the

options file, but command line internal editor can not
be started.
System action: Processing continues as if EDITOR
option was set to NO
User response: Check previous messages to determine
the reason why the internal editor could not be started.
ANS7543E

Error: Scout is not available for object

query. Either scout is not running or the
initial file system scan has not finished.

Explanation: The scout daemon must be running for

the reconcile process to do a query for all migrated
files. If the scout daemon is not running or the initial
file system scan has not finished you cannot run the
reconcile tool in orphan check mode.
System action: Processing stops.
User response: Ensure that the scout daemon is
running. If the scout daemon is not running, restart it
and retry the command. If the scout daemon is
running, wait until it finishes the initial file system
scan. You can check the current status of the scout
daemon by using the dsmscoutd scanplan command.
ANS7544E

ICC routine icc-routine failed with the

following error: "error-string".

operation. If the problem still exists, contact TSM

technical support.
ANS7546E

Unexpected error while decrypting the

data.

Explanation: There was an error while decrypting the

data. See the error log for more information. This can
happen if the encrypted data has been corrupted while
in storage, during the network transfer, or both.
System action: The object is not restored.
User response: Ensure TSM software is installed
correctly. If needed, reinstall the software. Make sure
there are no TSM server or network problems that may
affect the transfer of data. Retry the operation. If the
problem still exists, contact TSM technical support.
ANS7547E

Unexpected error while digesting the

data.

Explanation: There was an error while digesting the

data. See the error log for more information.
System action: The object is not backed up.
User response: Ensure TSM software is installed
correctly. If needed, reinstall the software. Retry the
operation. If the problem still exists, contact TSM
technical support.
ANS7551E

The source path cannot contain a drive

letter

Explanation: There was an error within ICC

cryptography library while processing the data. For
example, this problem can occur when encrypted client
data is corrupted, so the restore operation cannot
correctly decrypt it. This message reports an error code
and problem description which can be used by TSM
technical support personnel to determine the cause of
the failure.

Explanation: The entered path cannot contain a drive

letter.

System action: The processing stops.

ANS7552I

User response: Ensure TSM software is installed

correctly. If needed, reinstall the software. Make sure
you use the correct encryption key password for the
data. Make sure there are no TSM server or network
problems that may affect the transfer of data. If the
problem still exists, contact TSM technical support.
ANS7545E

Unexpected error while encrypting the

data.

Explanation: There was an error while encrypting the

data. See the error log for more information.
System action: The object is not backed up.
User response: Ensure TSM software is installed
correctly. If needed, reinstall the software. Retry the

System action: TSM did not continue with the

requested operation.
User response: Enter the source path in the correct
format.
timestamp ***** Processed count files
*****

Explanation: IBM Tivoli Storage Manager has

processed the specified number of files.
System action: Processing continues.
User response: None.
ANS7553W

Disabled demand migration (ENOSPC)

on file system file-system-name because of
high threshold, low threshold, and
pmpercentage settings.

Explanation: The settings of high threshold = 100, low

threshold = 100, and pmpercentage = 0 are reserved to
disable demand migration and automigration. Used for
GPFS driven migration.
System action: Processing continues.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

201

User response: None.

ANS7555E

The destination path must contain a

drive letter

ANS7641I

The user does not have administrative

credentials to perform a full system
state backup.

Explanation: The entered path must begin with a

drive letter, colon, and root slash.

Explanation: The user account used to perform system

state backup including ASR Writer data must be a
member of the Administrators group.

System action: TSM did not continue with the

requested operation.

System action: System state backup skips ASR Writer

data.

User response: Enter the destination path in the

correct format.

User response: Log on with a user who is a member

of the Administrators group or add this user to the
Administrators group. Then try the system state
backup again.

ANS7556E

An invalid drive letter was entered

Explanation: You entered an invalid drive letter.

System action: TSM prompts you for the correct drive
ID.
User response: Reenter the drive ID in the correct
format.
ANS7560E

Drive drive-name has no volume label.

Backup/Archive not allowed.

Explanation: The specified drive-name selected cannot

be backed up.
System action: TSM rejected the selected drive.
User response: If the drive is a floppy drive, place a
disk with a volume label in it and retry the operation.
If the disk is a hard drive, ensure the drive has a
volume label, and retry the operation.
ANS7561E

Drive drive-name is unavailable

Explanation: In an attempt to process a file, the

specified drive-name was found unavailable.
System action: TSM did not process the file.
User response: Determine why the drive was not
available, make it ready, and retry the operation.
ANS7564E

Backup or archive of drives with

duplicate volume labels is not allowed.

Explanation: You tried to back up or archive a drive

that has a duplicate volume label. Because TSM uses
the volume label to keep track of backup or archive
information, it cannot back up or archive files from a
drive with a duplicate volume label.
System action: TSM cannot select the drive for backup
or archive operations.
User response: If the volume needs to be available to
the system, exit TSM and assign a unique volume label
to the drive. Restart TSM and try the operation again.

202

ANS7642E

An error occurred creating the registry

directory structure.

Explanation: An error occurred while creating the

directory structure to save or replace a registry key.
System action: Registry function fails.
User response: Ensure that the user account that is
running the backup of the registry has the proper
authority. If the user account has the proper authority,
you might need to restart the machine. There might be
operations that are pending which have a file or files in
the registry directory structure locked.
ANS7650E

The user does not have sufficient

privileges to execute IBM Tivoli Storage
Manager.

Explanation: The user account used to execute IBM

Tivoli Storage Manager must have the "Back up files
and directories" and the "Restore files and directories"
security settings assigned.
System action: Processing stops.
User response: Assign the "Back up files and
directories" and the "Restore files and directories"
security settings to the account using the Windows
Local Security Settings tool or use a different user-id to
execute IBM Tivoli Storage Manager.
ANS7660E

An error occurred replacing one or more

registry keys.

Explanation: The registry key or keys being replaced

are exclusively held by another process. The registry
keys were previously restored but the system was not
restarted.
System action: processing stops.
User response: Restart the system and try the restore
operation again.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS7701E

The specified directory cannot be

created.

Explanation: The directory contains invalid characters,

or you are not authorized to create the directory.
System action: The directory selection dialog remains
open so that you can specify another directory name.
User response: Specify another directory name.
Ensure that the directory contains valid characters and
that you have proper authorization to create the
directory.
ANS7709E

Restore operation failed. Not all files

were restored.

ANS7902I

Explanation: The number of entries cached in the

client deduplication cache has exceeded the configured
size for the cache.
System action: The deduplication feature is designed
so that this happens periodically. The cache is reset to
no entries.
User response: You can reconfigure the client
deduplication cache size to a larger value to reduce the
frequency of resets.
ANS7903W

Explanation: Restore operation failed due to an error.

System action: Operation completed.
User response: Check the error log for more details.
ANS7899E

The client referenced a deduplicated

extent that does not exist on the TSM
server

Explanation: The deduplicated extent has been

deleted from the server during the backup or archive
operation. If you are using deduplication cache, it
might be out of synch with the TSM server.
System action: The processing stops.
User response: Retry the operation. If the problem
persists, turn off deduplication and retry the operation.
ANS7900W

Deduplication cache has been reset

because it is not synchronized with the
TSM server

Explanation: The deduplication cache contains

deduplicated extent entries that do not exist on the
TSM server. This occurs when the extents are deleted
from the TSM server after they were recorded in the
deduplication cache.

System action: This process does not use the client

deduplication cache. The server deduplication is not
changed.
User response: You can serialize processes using the
client deduplication cache. Or you can reconfigure the
current process to use a different cache path to avoid
contention.
ANS7904E

Explanation: The following features cannot be used

with deduplication: lan-free, subfile, NAS,
useTsmBuffers.
System action: Client deduplication is disabled.
User response: Review the configuration. Do not
configure deduplication with the lan-free, subfile, NAS,
or useTsmBuffers features.

Client deduplication and lan-free or

subfile backup are mutually exclusive.

Explanation: Client deduplication and lan-free or

subfile are mutually exclusive.
System action: Client deduplication is disabled.
User response: Review the configuration. Do not
configure deduplication with the lan-free or subfile
feature.
ANS7905L

User response: None

Client deduplication and option-name are
mutually exclusive.

Client deduplication cache is locked by

another process.

Explanation: Another process is using the client

deduplication cache. Only one process may use it at a
time.

System action: The deduplication cache is reset, and

all cache entries are removed. The processing continues.

ANS7901W

Client deduplication cache is full. Cache

is reset.

Client deduplication statistics. Total

Objects Deduplicated objectsDeduplicated
Total Bytes Inspected bytesInspected Total
Bytes Processed bytesProcessed
Deduplicated Reduction Ratio
dedupReduction Total Reduction Ratio
totalReduction

Explanation: Deduplication statistcs for diagnostic

purposes.
System action: None.
User response: None.
ANS7906W

Current storage pool ran out of space,

data will be stored into the next pool deduplication is disabled.

Explanation: The current storage pool on the TSM

server is out of space. Data will be stored in the next
Chapter 2. ANS 0001-9999: Client messages, version 6.3

203

storage pool. Deduplication is disabled and the

transaction is being resent.

User response: Check the local client error log for

reason for the failure.

System action: Deduplication is disabled to allow the

backup to complete.

ANS7915E

User response: Contact your system administrator to

add volumes to current storage pool.
ANS7907W

Connection to repository repos-name

failed. Retrying with repos2-name.

Explanation: Unable to connect to the Fastback DR

Hub repository. Retry using Fastback server repository.
System action: Retry operation.
User response: Specify a vaild repository.
ANS7908E

Unable to mount FastBack snapshot

policy 'Policy' client 'Client' volume
'Volume'. Reason: reason

Explanation: The FastBackMount command failed to

mount a FastBack volume.
System action: The archive or backup of the FastBack
volume can not continue. The next Volume in in line
will be processed. The output of the FastBackMount
command will show the reason for the failure.
User response: Check the local client error log for the
reason for the failure. Issue a FastBack command for
the FastBack volume to determine the reason for the
failure. Refer to the documentation for that message for
more information.
ANS7916E

Explanation: TSM Mount failed.

System action: TSM cannot continue processing.
User response:
ANS7912E

FastBackMount or FastBackShell is not

installed.

Explanation: Failure initializing FastBack environment.

FastBackShell or FastBackMount are not installed or are
not located in the FastBack install directory.
System action: The FastBack operation cannot
continue.
User response: Reinstall the software. The
FastBackShell and FastBackMount must be installed on
the dedicated proxy computer.
ANS7913E

The given branch was not found in the

DR Hub repository.

Explanation: The parameter to the required fbbranch

option is incorrect.

Failure mounting FastBack client

'vmname' with FastBack command. RC=rc

Failure initializing FastBack

environment.RC=rc

Explanation: Failure initializing FastBack environment.

Can not find FastBackShell.exe command. The
FastBackShell or FastBackMount is not installed or
FastBackShell.exe command is not located in the
FastBack install directory.
System action: The backup can not continue. The
output of the FastBack command will show the reason
for the failure.
User response: Issue a FastBack command to
determine the reason for the failure. Refer to the
documentation for that message for more information.
The FastBackShell and FastBackMount must be
installed on the backup proxy computer.
ANS7917E

No FastBack snapshots found for input

policy, client and volume combination.

Explanation: Failure processing fbClientName option.

System action: The backup cannot continue.

System action: The operation cannot continue.

User response: Check for errors in the FBClientName

option value. Refer to the documentation for the
FBClientName option for more information.

User response: Correct the parameter given for the

fbbranch option.

ANS7918E

ANS7914E

Incremental backup of FastBack client

'vmname' failed with RC rc

Failure locating mounted volumes for

FastBack client 'vmname' volumes. Failed
with RC=rc

Explanation: The archive or incremental backup of

FastBack client volumes failed.

Explanation: FastBack client volumes can not be

found. Volume mount points are not available on the
backup proxy computer.

System action: The archive or backup of FastBack

client finished with failures. The next FastBack client
will be processed. The reason for the failure is written
to the local client error log.

System action: The backup of the FastBack client can

not continue. The next FastBack client in the list will be
processed. The output of the FastBackMount command
will show the reason for the failure.
User response: Issue a fastbackshell mount add

204

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

command for the FastBack client volume to determine

the reason for the failure. Refer to the documentation
for that message for more information.
ANS7919E

Password for Host host could not be

read from encrypted password file.

Explanation: Use dsmc SET PASSWORD

-type=FastBack 'FastBack hostname' 'userid' 'password'
to save encrypted password

ANS7939E

Invalid FastBack volume specification.

Explanation: You must enter at least one FastBack

client with the "-fbclientname=" option before entering
a FastBack volume name.
User response: When entering a FastBack volume
name, enter at least one FastBack client name using the
"-fbclientname=" option.
System action:

System action: The backup cannot continue.

User response: Use dsmc SET PASSWORD
-type=FastBack 'FastBack hostname' 'userid' 'password'
to save encrypted password
ANS7920E

Invalid objName specification.

Explanation: TSM invalid option value specified.

System action: TSM cannot continue processing.
User response: Enter correct user credentials using the
set password command with option: -type=fastback.
Then try the failed command again.
ANS7936E

objType objName not found in dump.

Explanation: TSM server could not find the object that

is specified in the FastBack Dump command..
System action: TSM skips the current object.
User response: Ensure that there is at least one
snapshot for this FastBack volume, client, and policy.
Ensure that a correct object is specified as input.

ANS7940W

Explanation: When using FastBack, SUBDIR is forced

to YES to ensure that the whole volume is processed.
System action: SUBDIR is forced to YES.
User response: To avoid this message, do not use
SUBDIR NO with the command.
ANS7941E

No objType found in dump for input

objType1 objType2.

Explanation: TSM server found no clients for the

specified policy. TSM server found no volumes for the
specified FastBack client.
System action: TSM skips the current object.
User response: Ensure that there is at least one
snapshot for this FastBack volume, client, and policy.
Ensure that a correct object is specified as input.
ANS7938E

Unable to dismount FastBack volume

'volName'. RC = rc

Explanation: TSM Dismount failed.

System action:

FastBack invalid repository name or

domain not set in password file entry
for hostname.

Explanation: TSM The FastBack repository name is

invalid or the domain has not been set in the password
file when specifying the REP form of the repository.
User response: Issue the command dsmc set password
server userid:domain password -type=fastback.
System action: TSM
ANS7942E

ANS7937E

SUBDIR NO is not valid in this context.

SUBDIR will be forced to YES for
FastBack commands.

Maximum number of FastBack objName

objects exceeded.

Explanation: TSM The maximum number of FastBack

objects shown in the message has been exceeded.
User response: Re-run the command with no more
than the maximum number of objects specified.
System action: TSM
ANS7943E

The combination of objName and

objName is invalid.

Explanation: TSM The combination of options

specified is invalid.
User response: Re-run the command with a
compatible set of options.
System action: TSM

User response:
ANS7944W

The number of FastBack clients

specified client is greater than the
number of FastBack clients found client.

Explanation: TSM One or more of the FastBack clients

Chapter 2. ANS 0001-9999: Client messages, version 6.3

205

specified was not found. Look for message ANS7936E

specifying the client name.
User response: Correct the names of the clients
specified.
System action: TSM
ANS7945W

The number of FastBack policies

specified policy is greater than the
number of FastBack policies found
policy.

Explanation: TSM One or more of the FastBack

policies specified was not found. Look for message
ANS7936E specifying the policy name.
User response: Correct the names of the policies
specified.
System action: TSM

ANS7950E

The FastBack server is not installed on

the target machine.

Explanation: TSM The FastBack server is not installed

on the target machine.
User response: Install the FastBack server on the
target machine or specify a different target machiner.
System action: TSM
ANS7951E

The FastBackShell on the target machine

returned with the message errormsg .

Explanation: TSM An error occurred with the

command issued to the FastBackShell on the target
machine.
User response: Correct the options specified on the
commandr.
System action: TSM

ANS7946E

FastBack shell command timeout.SSH

Keys may not be configured for no
password.

ANS7952E

The package package required for

FastBack support is not installed.

Explanation: TSM The FastBack shell command

timeout. SSH may not be configured properly.

Explanation: TSM The required package is not

installed.

User response: Correct SSH configuration.

User response: Install and configure the required

package.

System action: TSM

System action: TSM

ANS7947E

The root user .ssh directory was not

found. SSH is not configured properly.

Explanation: TSM SSH is not configured properly for

the root user.
User response: Correct SSH configuration.
System action: TSM

ANS7953E

The FastBack shell scripts returned an

unexpected error error.

Explanation: TSM The FastBack shell scripts returned

an unexpected error.
User response: Correct the error.
System action: TSM

ANS7948E

The public key for the FastBack server

was not found. SSH public keys are
configured properly.

Explanation: TSM The SSH public keys are not

configured properly for the root user.
User response: Correct SSH configuration.
System action: TSM

ANS7954E

The SSH connection failed. The SSH

daemon may not be started or
configured on the target machine

Explanation: TSM Ensure that the SSH daemon is

configured correctly.
User response: Correct the error.
System action: TSM

ANS7949E

The connection to FastBack server

failed.

Explanation: TSM The connection to FastBack server

failed.
User response: Insure that the FastBack server on the
target machine is runing properly.
System action: TSM

ANS7955E

The cygdrive-prefix is set incorrectly.

Explanation: TSM Ensure that cygdrive-prefix is set to

/ in the ssh cygwin environment. The command mount
-s --change-cygdrive-prefix / can be use to set the drive
prefix correctly.
User response: Correct the error.
System action: TSM

206

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS7956E

Unable to execute cygwin shell

commands. The cygwin environment
may be incorrectly

Explanation: TSM Use ssh to connect to the cygwin

shell and ensure that the cygwin environment and
cygdrive are configured correctly.
User response: Correct the error.
System action: TSM
ANS7957E

Unable discover the FastBackShell

location in the registry

Explanation: TSM Check that the FastBackShell was

installed on the Windows FastBack server machine.
User response: Correct the error.
System action: TSM

ANS8005E

Java Applet failed to load. Please ensure

that the Java Java version Plugin has been
installed for this browser.

Explanation: Java Plugin is missing from browser.

Since plugin is not present, applet is not able to load.
System action: Applet unable to load and message
displayed.
User response: Install appropriate plugin for browser
in order to use web client.
ANS8008W

Redirection inside macro whose output

is redirected is ignored.

Explanation: An output redirection symbol has been

encountered inside a macro. However, the output of the
macro itself (or a higher level macro) is already being
redirected.
System action: The redirection request is ignored.

ANS8000I

Server command: 'command'

User response: None.

Explanation: The specified command is being sent to

the server. This message is displayed when the
command is generated from a macro or when the client
is running in batch mode.

ANS8009E

System action: The command is sent to the server for

processing.

Explanation: Because of errors in command line or

option file parameters displayed earlier, the
administrative client session is ending.

User response: None.

ANS8001I

Return code return code value.

Explanation: The error code shown has been returned

from the preceding server command. This message is
preceded by a server message explaining the reason for
the error code.

System action: The client exits.

User response: Fix the option file parameter in error
and restart the client, or restart the client with proper
command line parameters.
ANS8010E

System action: None.

User response: None.
ANS8002I

Highest return code was return code

value.

Explanation: At exit from the client, the highest return

code encountered during the session is displayed.
System action: This value is used as the program exit
code.
User response: None.
ANS8003I

Process number process ID started.

Explanation: As a result of the preceding server

command, the process whose ID is shown starts to
execute the command. The process can be monitored
using the QUERY PROCESS command.

Exiting due to command or option

errors.

An attempt to backup or archive a file

has exceed the maximum number of
retries.

Explanation: After five unsuccessful attempts to

backup or archive a file, the client will no longer
attempt to send the file to the server.
System action: File skipped.
User response: Check the console or schedule log for
additional information. Retry the operation at a later
time.
ANS8012E

Option processing storage exhausted.

Explanation: During processing of the client options

file, the client runs out of memory.
System action: The client session is ended.
User response: Make more memory available and
restart the administrative client.

System action: None.

User response: None.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

207

ANS8013I

Invalid encryption key password

Explanation: The key you entered does not match the

key that was used to encrypt the file during backup.
The file can not be restored unless the matching key is
entered.
System action: User is prompted for encryption key
password.

System action: The administrative client session is

ended.
User response: Reissue the command with valid
parameters.
ANS8018E

Administrative command not valid in

Console mode.

User response: Enter the correct encryption key

password.

Explanation: The Console Mode option has been

specified but the client encounters what appears to be a
server command on the command line.

ANS8014E

System action: The administrative client session is

ended.

Insufficient information to connect to

host.

Explanation: The client options file or command line,

or both, do not contain enough communications
information to successfully connect to the server
system. For example, with TCP/IP both the TCPPort
number and TCPServer address are required to make a
connection.
System action: The administrative client session is
ended.
User response: Determine what information is needed
to establish a connection for your communications
method and then specify all that information in your
client options file or on the administrative client
command line.
ANS8015E

File 'file spec', error code error code from

options processing.

Explanation: An unknown error code is returned from

the routine that processes the client options file.

User response: Reissue the command with no server

command.
ANS8019E

Id and password must be supplied in

Batch mode.

Explanation: A server command has been encountered

on the command line, but no administrator ID or
password, or both, are specified.
System action: The administrative client session is
ended.
User response: Reissue the command and include the
-ID and -PASSWORD parameters on the command line.
ANS8020E

Unable to open file 'file spec' for output.

Explanation: The file name specified in the -OUTFILE

option cannot be opened.
System action: The -OUTFILE parameter is ignored.

System action: The administrative client session is

ended.

User response: Allow processing to continue or exit

the session and correct the file name.

User response: Attempt to determine the error and

correct it. If the problem persists, contact your service
representative.

ANS8021E

ANS8016E

Command line parameter parameter

number: 'parameter' is too long.

Explanation: The specified command line parameter

exceeds the maximum length for a command line
parameter.

Exiting Batch mode session due to

output file error.

Explanation: The file specified in the -OUTFILE

parameter cannot be opened for a session running in
Batch mode.
System action: The administrative client session is
ended.

System action: The administrative client session is

ended.

User response: Reissue the command with a valid

output file name or make space available for the output
file.

User response: Reissue the command with a shorter

parameter.

ANS8022E

ANS8017E

Command line parameter parameter

number: 'parameter' is not valid.

Explanation: The command line parameter shown is

not a valid administrative client parameter.

208

Output will be written only to stdout.

Explanation: The file specified in the -OUTFILE

parameter cannot be opened, so output is written only
to the standard output stream.
System action: Output that would have been written
to the output file is written to the standard output
stream.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Allow processing to continue or exit

the session and correct the file name.

ANS8028E

ANS8023E

Explanation: An input command longer than the

maximum command length allowed has been entered.

Unable to establish session with server.

Explanation: The administrative client cannot start a

session with the requested server. This message is
preceded by another message that explains the reason
for the error.
System action: The administrative client session is
ended.
User response: Attempt to correct the error. If the
problem persists, contact your service representative.
ANS8024E

End of macro after continued command

line.

Explanation: A macro containing a continuation line

has been executed, but no more lines are found in the
macro file.
System action: The continued command is ignored,
and an error return code is set for the macro.
User response: Correct the macro in error.
ANS8025E

I/O Error reading command input.

Explanation: The client is unable to read an input

command from the terminal.
System action: The administrative client session is
ended.
User response: Correct the problem on the terminal
and retry the administrative session.

System action: The input command is ignored.

User response: Reissue the command with fewer
characters. This could mean replacing series of
repeating blanks with a single blank.
ANS8029E

Input line longer than maximum of max

length characters. Use continuation.

Macro processing terminated.

Explanation: An error occurs during processing of a

macro because the -ITEMCOMMIT option is not
specified on the command line. Processing of this
macro and any higher level macro is terminated.
System action: All current macro processing ends.
User response: Specify the -ITEMCOMMIT option on
the command line to ensure that the server commits
each command in the macro individually.
ANS8030E

Substituted command longer than

maximum of max length characters.

Explanation: After variable substitution, an input

command is longer than the maximum command
length allowed.
System action: The input command is ignored.
User response: Reissue the command with fewer
characters. This may require replacing a series of
repeating blanks with a single blank.
ANS8031E

ANS8026E

Command longer than maximum of max

length characters.

Missing name of macro to execute.

Explanation: A macro command is encountered that

does not contain a macro name.

Explanation: An input command line is longer than

the maximum input line length allowed.

System action: The command is ignored.

System action: The input command is ignored.

User response: Reissue the macro command with a

macro file name.

User response: Reissue the command with several

lines using continuation characters.
ANS8027E

Unterminated comment in command.

Explanation: An input command contains an opening

comment mark but no closing comment mark.

ANS8032E

Could not allocate storage to process

macro 'file spec'.

Explanation: The client cannot allocate enough

memory to process the macro shown.

System action: The input command is ignored.

System action: The macro is ignored and an error is

returned.

User response: Reissue the command with matching

comment marks.

User response: Make more memory available to the

client and retry the macro command.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

209

ANS8034E

Your administrator ID is not recognized

by this server.

Explanation: The administrator ID entered is not

known to the requested server.
System action: The administrative session terminates.
User response: Ensure that you are using a registered
administrative ID for the server to which you are
connecting.
ANS8035E

Interrupted by user.

Explanation: During an administrative session, a

keyboard interrupt or break sequence is entered.
System action: The administrative session is
terminated.
User response: Restart the administrative client
session.
ANS8036E

Administrative command not valid in

Mount mode.

Explanation: The Mount Mode option has been

specified but the client encounters what appears to be a
server command on the command line.
System action: The administrative client session is
ended.
User response: Reissue the command with no server
command.
ANS8037E

Missing name for redirection file.

Explanation: A command is entered that contains an

output redirection symbol but no output file name.

ANS8041E

Explanation: During an administrative session, the

client discovers that the connection with the server has
been severed; an attempt to reestablish the connection
fails.
System action: The client session is ended.
User response: Determine the cause of the failure;
then try to restart the session at a later time. If the
problem persists, contact your service representative.
ANS8045E

Communications error.

Explanation: An unexpected communications error

occurs during an administrative session.
System action: The client session is ended.
User response: Verify that communications are active
between the client and server machines. Server outages,
processor outages, and communication controller
outages can cause this error.
ANS8046E

The client connection with the server

has ended due to an unexpected error.

Explanation: The TSM error log might contain other

messages related to this error.
System action: The client session ends.
User response: Check the communication link
between the client and server to ensure that it is
operational. Examine the client error log for additional
messages related to this error.
ANS8047E

System action: The command is ignored and an error

is returned.
User response: Reissue the command with an output
file name.

The server connection has been lost and

cannot be re-established.

The client connection with the server

has ended due to a communications
buffer overflow.

Explanation: The TSM error log might contain other

messages related to this error.
System action: The client session ends.

ANS8038E

Unable to open file 'file spec' for

redirection.

Explanation: A command has been entered that

specifies an output redirection file, but the file cannot
be opened.
System action: The command is ignored and an error
is returned.
User response: Reissue the command with a valid
output file name or make space available for the output
file.

User response: Try the operation again. Check the

communication link between the client and server to
ensure that it is operational. Examine the client error
log for additional messages related to this error.
ANS8049E

A connection with the server cannot be

established due to a communications
time-out.

Explanation: The TSM error log might contain other

messages related to this error.
System action: The client session ends.
User response: Check the communication link
between the client and server to ensure that it is
operational. Examine the client error log for additional

210

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

messages related to this error.

problem persists, contact your service representative.

ANS8050E

ANS8055E

The TSM server is not accepting

administrative sessions on the client
port. You must use the port number
designated for administrative sessions.

Explanation: The TSM server is configured to not

allow administrative sessions on the client TCP/IP
port. A different port number has been designated for
use by administrative sessions.
System action: The administrative session is not
established.
User response: Use the TCPADMINPORT client
option to specify the TCP/IP port number that the TSM
server uses for administrative sessions. See your TSM
server administrator if you do not know the correct
port number.
ANS8051E

User is not authorized to get prompted

for encryption key

Explanation: The current passwordaccess option

setting and user authority do not allow encryption.

The server has insufficient resources to

perform the operation.

Explanation: The server ran out of resources. A lack of

storage or other problem condition does not allow any
new activity. The server activity log might contain
additional information about this problem.
System action: The client session ends.
User response: The TSM administrator should
examine the TSM server activity log to determine the
source of the resource constraints. Try the operation
again when the server is under less load.
ANS8056E

Your administrator ID is locked.

Explanation: The administrative ID entered has been

locked by a system administrator and cannot be used.
System action: The client session is ended.
User response: Contact your system administrator to
unlock your ID.

System action: You are not prompted to set the

encryption key password.

ANS8057E

User response: Request the TSM authorized user to

set passwordaccess=GENERATE in dsm.sys and set the
encryption key password. (The encryption key
password is set the first time that the TSM authorized
user backs up a file).

Explanation: The NLS repository for the language

specified is not available.

ANS8052E

Unable to decrypt file 'filespace

namepath-namefile-name' ....Please try to
restore this file individually

Explanation: File could not be decrypted and restored.

System action: File is not restored.
User response: Restore the file separately.
ANS8053E

The network cannot be accessed.

Explanation: The TSM error log might contain other

messages related to this error.
System action: The client session ends.

The requested language files are not

available.

System action: The client session is ended.

User response: Use a different language or obtain a
copy of the NLS repository for the language desired.
ANS8059E

The TCP/IP functions have not been

linked into this module.

Explanation: The ADSM TSO administrative client

cannot find the TCP/IP functions required to support
TCP/IP communications.
System action: The connection to the server fails.
User response: The TCP/IP functions must be
included in the DSMADMC/ANSADM module. Refer
to the Program Directory for this product for
instructions on how to include the TCP/IP functions in
the DSMADMC/ANSADM module.

User response: Check the communication link

between the client and server to ensure it is
operational. Examine the client error log for additional
messages related to this error. Try the operation again.
ANS8054E

No memory available to service request.

Explanation: Sufficient server memory is not available.

System action: The client session is ended.
User response: Retry the administrative session. If the
Chapter 2. ANS 0001-9999: Client messages, version 6.3

211

ANS8060W

A previously established incremental

flashcopy relationship for local backup
version with backup date 'datetime' for
database configuration 'dbconfig' has
been withdrawn for this backup
operation. The reason for this is that the
local backup policy defined for this
database specifies a single backup
version. This backup operation is
requesting a copytype of NOINCR
forcing the reuse of the single set of
target volumes.

Explanation: The local backup policy defined for this

database specifies a single backup version. The target
volume set defined for this backup version is currently
engaged in an incremental flashcopy relationship. This
backup operation is requesting a copytype of NOINCR
forcing the withdraw of the incremental flashcopy
relationship. Refer to TSM documentation for
additional information on local backup policy.
System action: None.
User response: None.
ANS8061E

Session Rejected: The server does not

allow a signon as a Unicode enabled
administrative client

Explanation: The administrative client is unable to

establish a connection to the server because of a
unicode enabling mismatch between server and client.
System action: The client session is ended.

TSM password for the Client Acceptor or verify that

the current password is still valid before retrying the
operation.
ANS8064E

Explanation: The connection to the server is ended

because of a communication timeout from the server.
System action: The server does not process the
command.
User response: Reissue the command. If necessary,
increase the values of IDLETIMEOUT and
COMMTIMEOUT options in the server options file.
ANS8104W

Client-to-Client communication is not

allowed to take place when TSM Server
authentication is turned off.

Explanation: Client-to-Client communication requires

TSM Authentication to be enabled.

Cannot determine EFS status of the file

system 'file-system name', errno='errnor
number', processing data normally.

Explanation: IBM Tivoli Storage Manager cannot

determine EFS status on the specified filesystem. No
EFS specific processing will take place for files on this
filesystem. If EFS is indeed enabled on the filesystem,
all accessaible files will be backedup in cleartext.
System action: The filesystem will be processed as a
regular filesystem.
User response: Contact your system administrator to
determine the cause of the error reported in the
message.
ANS8106E

User response: Register a new administrator from a

different administrative client or the server console, and
signon with the new administrator ID.
ANS8062E

Communication timeout. Reissue the

command.

Support for multiple IBM Tivoli Storage

Manager servers is enabled on this
node. The server name must be
specified for this command.

Explanation: When a node is enabled to support

multiple IBM Tivoli Storage Manager servers, the
command must specify a valid IBM Tivoli Storage
Manager server name.
System action: Processing stopped.

System action: Processing stops.

User response: Specify a valid server name for this

command.

User response: Turn TSM Server authentication on

using the Set AUthentication ON command.

ANS8500I

ANS8063E

The remote TSM Client Acceptor

associated with Node 'name' could not
authenticate with the TSM Server.

Explanation: Some TSM Client operations require the

Backup/Archive Client to contact Clients on remote
machines. The remote machine in question cannot
authenticate with the TSM Server.

User action cannot be completed due to

the following error:

Explanation: An error has occurred while processing

your requested action, user action. The message
displaying with this message identifies the error.
System action: The system does not process your
requested action.
User response: See Explanation for the message
displaying with ANS8000I.

System action: Processing stops.

User response: On the remote machine, create a new

212

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS8501E

Internal error in this graphical user

interface. Try one of the following in
the order listed: 1) close this window
and reopen it 2) close this object and
reopen it 3) shut down this graphical
user interface and restart it 4) save
dsmerror.log residing in the directory
specified by DSMG_LOG and contact
your service representative for
assistance.|Graphical User Interface Internal error

ANS8503I

No matching option found for pattern:

'pattern'.

Explanation: You specified a pattern which does not

match the name of any supported option.
System action: This message is the only response to
your query.
User response: Specify a different pattern or omit the
pattern to display all options.

Explanation: An internal processing error has

occurred in the TSM Administrators graphical user
interface while processing your requested action.
Message ANS8000I, which displays with this message,
identifies your requested action.

ANS8504E

System action: The system does not process your

requested action.

Explanation: An internal processing error has

occurred in the TSM Administrators graphical user
interface while attempting to display an informational,
warning, or error message related to the current
window or your requested action.

User response:
v Close the window in which your failed request was
made and reopen it.
v If this problem persists, close all windows associated
with the object toward which your failed request was
directed and reopen them.
v If this problem persists, shut down the TSM
Administrators graphical user interface and restart
it.

A message related to this window or

your requested action cannot be
displayed due to an internal error in
this graphical user interface. Refresh
this window or request the action again.

System action: The system may or may not process

your requested action.
User response: View the Activity Log window in the
Server object to find out if your requested action has
completed. If it has completed successfully, refresh the
current window to show its results. If it has not
completed successfully, make your request again.

v If this problem persists, save the dsmerror.log file

residing in the directory specified by the
environment variable DSMG_LOG or in the current
directory if DSMG_LOG is not specified, and contact
your service representative for assistance.

ANS8505I

ANS8502S

Explanation: The remote node is running and has

failover enabled. The node is now marked as offline
until it has successfully joined the Service.

Due to this error, processing cannot

continue. This graphical user interface
will shut down.

Explanation: A severe error has occurred. The

message displaying with this message identifies the
actual error.
System action: The TSM Administrators graphical
user interface closes.
User response:
v Restart the TSM Administrators graphical user
interface.
v If this problem persists, save the dsmerror.log file
residing in the directory specified by the
environment variable DSMG_LOG or in the current
directory if DSMG_LOG is not specified, and contact
your service representative for assistance.

program: node hostname with id node-id

was added to the Responsiveness
Service.

System action: The watch daemon will now check the

node.
User response: None.
ANS8506I

program: node hostname with id node-id

was removed from the Responsiveness
Service.

Explanation: The remote node has shut down and

was removed from the Responsiveness Service after
some time.
System action: The watch daemon will not look for
this node until it is up again.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

213

ANS8507I

program: node hostname with id node-id is

now online.

Explanation: The remote node has successfully joined

our Responsiveness Service and it's availability is now
checked.
System action: The watch daemon will now check the
availability of the node.
User response: None.
ANS8508I

program: node hostname with id node-id is

now offline.

Explanation: The node has successfully left the

Responsiveness Service because it was shut down
normally.
System action: The watch daemon will not check the
node again.
User response: None.

ANS8512W

program: signal signal received, HSM

activities stopped on this node.

Explanation: The node is failing voluntarily because of

a local problem.
System action: Other nodes are informed to take over
the filesystems of the failing node.
User response: Examine the log files for possible
reasons and do a file system rollback after the
computer is back online.
ANS8513I

program: this node is leaving the

Responsiveness Service voluntarily.

Explanation: The node is shut down regularly and

will leave the Responsiveness Service without initiating
a failure notice to other nodes.
System action: The watch daemon will not check for
the node.
User response: None.

ANS8509I

program: node hostname with id node-id is

now recovered.

ANS8514E

Explanation: The node has recovered from a previous

failure situation and a rollback can now be initiated.
System action: The watch daemon will now check the
node for availability.
User response: None.
ANS8510W

program: node hostname with id node-id

has failed, checking if failover is
required.

Explanation: The node is not responding to the

Responsiveness Service anymore, a failover will be
initiated if the remote and current node have failover
enabled and if the remote watch daemon's filesystem
timestamp is too old.
System action: The watch daemon will check if a
failover for any of the node's filesystems is required.
User response: None.
ANS8511W

program: failover for node hostname with

id node-id aborted, failover thread could
not be started.

Explanation: The internal service thread to perform

the failover operation could not be started.
System action: The failover on this machine is
aborted. Another machine with failover enabled will
perform the failover.
User response: Please check if the machine has too
much load to start new threads.

program: the Responsiveness Service on

this node could not be initialized.
Failover will not be possible.

Explanation: It was not possible to initialize and start

the internal thread for the Responsiveness Service.
System action: The watch daemon is exiting and will
be restarted to retry the operation.
User response: Verify that virtual memory (swap
space) has sufficient space. Verify that the system
process thread limit is reasonable and has not been met
or exceeded. If the thread limit is reasonable, but has
been exceeded, or the problem otherwise persists,
reboot the GPFS cluster
ANS8515E

program: it was not possible to join the

Responsiveness Service. Failover will
not work for this node.

Explanation: The watch daemon could not join the

Responsiveness Service and will not be able to do
failover.
System action: The watch daemon is exiting and will
be restarted to retry the operation.
User response: None.
ANS8516E

The values entered for the New

Password and Reenter New Password
fields do not match. Type the same
value into both fields.

Explanation: You have entered different values into

the New Password and Reenter New Password fields.
System action: The system does not process your
requested action.

214

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Enter the same value into the New

Password and Reenter New Password fields.
ANS8517W

program: not trying to take over

filesystems for node hostname with id
node-id since it has failover disabled.

User response: Verify that the correct java executable

is on your PATH or install the required version of Java
runtime environment and start the program again.
ANS8777E

Explanation: The node was detected as failing but no

failover will be initialized since the node is not
configured for failover.
System action: No filesystem of the failing node will
be taken over.
User response: Manually take over the filesystem if
required.
ANS8518W

program: Could not resolve cluster node

id by hostname hostname.

Explanation: The hostname provided by the

Responsiveness Service could not be resolved to a
cluster node id.

Explanation: IBM Tivoli Enterprise Space Management

Console cannot be started because the library that
defines the Tivoli look and feel cannot be found.
System action: The IBM Tivoli Enterprise Space
Management Console shuts down.
User response: Verify that the product is correctly
installed. If IBM Tivoli Enterprise Space Management
Console still cannot be started, contact your system
administrator for further assistance.
ANS8778E

System action: The current operation aborts.

User response: Make sure the cluster is functional and
the machine hostnames are propperly set and
resolvable.
ANS8566E

You have not entered or selected a value

for this required field. Enter or select a
value for this field.

Explanation: You have not entered or selected a value

for a required field.
System action: The system does not process your
requested action.
User response: Enter or select a valid value for this
required field.
ANS8776E

The IBM Tivoli Enterprise Space

Management Console cannot be started.
Java Runtime Environment version
version by company has been detected on
machine. A Java Runtime Environment
version or higher is required to run this
program. If you have already installed
Java version on this machine, please
ensure that the correct Java executable is
on your PATH, otherwise you can
download it from 'webAddress' and start
the program again.

Explanation: IBM Tivoli Enterprise Space Management

Console cannot be started because the Java runtime
environment does not meet the requirements.
System action: A confirmation dialog is displayed for
you to close the application, or to open a browser with
a link to the Web site where you can download the
correct version of Java.

The IBM Tivoli Enterprise Space

Management Console cannot be started.
An error occurred trying to load Tivoli
look and feel. Verify that the product is
correctly installed.

A browser program cannot be found or

cannot be started. An error occurred
executing the command.command Verify
that a browser is installed and works
correctly on your local machine.

Explanation: A browser program cannot be found, so

it is not possible to access the IBM Tivoli Web site and
online documentation.
System action: TSM continues to process user
requests.
User response: For the Windows platform, the default
system browser is used. Verify that a browser is
installed on your machine.
ANS8779E

A browser program cannot be found or

cannot be started. One of the following
browsers is required: browser-list Verify
that one of these browsers is installed
and works correctly on your local
machine.

Explanation: A browser program cannot be found, so

it is not possible to access the IBM Tivoli Web site and
online documentation.
System action: TSM continues to process user
requests.
User response: For UNIX platforms, a list of
supported browsers is provided in the README.
Install the required browser to access the IBM Tivoli
Web sites and online documentation.
ANS8780E

A browser program cannot be found or

cannot be started. Check the 'file-name'
file on your local machine for more
information.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

215

Explanation: A browser program cannot be found, so

it is not possible to access the Web site or online
documentation.

ANS8783E

System action: TSM continues to process user

requests.
User response: Install a browser to access the Web site
or online documentation.
ANS8781E

The system could not log on to TSM

client node node-name on machine-name.
Make sure your data and password are
correct and that caps lock key is not on.
The Space Management Agent must be
running at the specified port on the
machine to which you are attempting to
log on to.

Explanation: The system was not able to connect to

the specified client node.
System action: TSM continues to process user
requests.
User response: Verify that:
v the information provided to connect is correct
v the machine is reachable in the network
v HSM is installed on the specified machine and a
Space Management Agent is running at the specified
port.
ANS8782E

An error occurred while loading file

system information on 'fs-name'. Verify
that the Space Management agent is
running on the client node machine.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred while loading file

system information on the selected client node
System action: Disconnects the client node.
User response: Verify that the Space Management
agent is running on the client node machine. Check
also the dsmsm.log file in the installation directory of
your local machine and the $DSM_DIR/dsmerror.log
file on the client node machine if present. If this does
not identify the cause of the problem, contact your
system administrator and/or TSM technical support for
further assistance.

216

An error occurred loading file system

properties of fsName required to show
space usage graphical information.
Verify that the Space Management agent
is running on the client node machine.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred while loading file

system properties on the selected client node.
System action: Continue to process other file system
properties.
User response: Verify that the Space Management
agent is running on the client node machine. Check
also the dsmsm.log file in the installation directory of
your local machine and the $DSM_DIR/dsmerror.log
file on the client node machine. If this does not identify
the cause of the problem, then see your system
administrator for further assistance.
ANS8784E

An error occurred initializing the client

nodes table. Your local configuration file
'config-file' might be corrupted. Remove
it from your installation directory and
start the program again. Check also the
log-file file on your local machine for
more information.

Explanation: The client nodes table cannot be

initialized.
System action: The IBM Tivoli Enterprise Space
Management Console shuts down.
User response: It is possible that your local settings
file 'dsmsm.cfg' is corrupted. Try to remove it from
your installation directory and start the program again.
Check the dsmsm.log file in the installation directory of
your local machine and the $DSM_DIR/dsmerror.log
file on the client node machine if present. If this does
not identify the cause of the problem, contact your
system administrator and/or TSM technical support for
further assistance.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS8785E

An error occurred disconnecting the

system from the client node 'node-name'.
The Client node is being disconnected
without deleting internal HsmSystem
objects. Verify that the Space
Management agent is running on the
client node machine. Check also the
local-log-file file in the installation
directory of your local machine and the
$DSM_DIR/error-file file on machine if
present. If this does not identify the
cause of the problem, contact your
system administrator and/or TSM
technical support for further assistance.

Explanation: An error occurred disconnecting the

system from the client node. It was not possible to
delete internal HsmSystem objects.
System action: The client node disconnected without
deleting HsmSystem objects.
User response: Verify that the Space Management
agent is running on the client node machine. Check the
dsmsm.log file in the installation directory of your local
machine and the $DSM_DIR/dsmerror.log file on the
client node machine if present. If this does not identify
the cause of the problem, contact your system
administrator and/or TSM technical support for further
assistance.
ANS8786E

An error occurred loading file system

information from the selected client
node. Verify that the Space Management
agent is running on the client node
machine. Check also the local-log-file file
in the installation directory of your local
machine and the $DSM_DIR/error-file
file in the client node machine if
present. If this does not identify the
cause of the problem, contact your
system administrator and/or TSM
technical support for further assistance.

Explanation: An error occurred loading file system

information from the selected client node.
System action: File System information is not loaded
User response: Verify that the Space Management
agent is running on the client node machine. Check the
dsmsm.log file in the installation directory of your local
machine and the $DSM_DIR/dsmerror.log file on the
client node machine if present. If this does not identify
the cause of the problem, contact your system
administrator and/or TSM technical support for further
assistance.

ANS8787E

An error occurred loading file system

information from nodename client node.
The client node is being disconnected.
Verify that the Space Management agent
is running on the client node machine.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred loading file system

information from the selected client node.
System action: The client node is disconnected
User response: Verify that the Space Management
agent is running on the client node machine. Check the
dsmsm.log file in the installation directory of your local
machine and the $DSM_DIR/dsmerror.log file on the
client node machine if present. If this does not identify
the cause of the problem, contact your system
administrator and/or TSM technical support for further
assistance.
ANS8788E

An error occurred starting manually

threshold migration on file-system. Verify
that the Space Management agent is
running on the client node machine.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred starting the manually

threshold migration on the selected client node.
System action: Threshold migration is not started
manually.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

217

ANS8789E

An error occurred trying to deactivate all

managed file systems of client-node.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

System action: Space management is not added to the

selected file system.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8792E

Explanation: An error occurred trying to deactivate all

managed file systems of the selected client node.
System action: File systems are not deactivated.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8790E

An error occurred trying to reactivate all

managed file systems of client-node.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred trying to reactivate all

managed file systems of the selected client node.
System action: File systems are not reactivated.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8791E

An error occurred trying to add space

management to fs-name file system.
Verify that the Space Management agent
is running on the client node machine.
Check also the local-log-file file in the
installation directory of your local
machine and the $DSM_DIR/error-file
file on machine if present. If this does
not identify the cause of the problem,
contact your system administrator
and/or TSM technical support for
further assistance.

Explanation: An error occurred trying to add space

management to the selected file system.

218

An error occurred trying to remove

space management from file-system file
system. Verify that the Space
Management agent is running on the
client node machine. Check also the
local-log-file file in the installation
directory of your local machine and the
$DSM_DIR/error-file file on machine if
present. If this does not identify the
cause of the problem, contact your
system administrator and/or TSM
technical support for further assistance.

Explanation: An error occurred trying to remove

space management from the selected file system.
System action: Space management is not removed
from the selected file system.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8793E

An error occurred trying to deactivate

file-system file system. Verify that the
Space Management agent is running on
the client node machine. Check also the
local-log-file file in the installation
directory of your local machine and the
$DSM_DIR/error-file file on machine if
present. If this does not identify the
cause of the problem, contact your
system administrator and/or TSM
technical support for further assistance.

Explanation: An error occurred trying to deactivate

the selected file system.
System action: The selected file system is not
deactivated.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS8794E

An error occurred trying to reactivate

file-system file system. Verify that the
Space Management agent is running on
the client node machine. Check also the
local-log-file file in the installation
directory of your local machine and the
$DSM_DIR/error-file file on machine if
present. If this does not identify the
cause of the problem, contact your
system administrator and/or TSM
technical support for further assistance.

ANS8810E

The LD_LIBRARY_PATH is either not

set or is set incorrectly. Ensure that the
LD_LIBRARY_PATH environment
variable contains the installation
directory.

Explanation: The LD_LIBRARY_PATH must be set

and it must contain the installation directory path.
System action: The VMware backup or restore
operation fails.

Explanation: An error occurred trying to reactivate the

selected file system.

User response: Set the LD_LIBRARY_PATH and

ensure that it contains the Backup/Archive client
installation directory.

System action: The selected file system is not

reactivated.

ANS8811E

User response: Check the dsmsm.log file in the

installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8795E

An error occurred trying to save your

settings to config-file configuration file
on your local machine. Check the log-file
file in the installation directory of your
local machine for more information.

VMware operations can not be run

when the hardware plugin product
TIVsm-BAhdw is installed and loaded.
Please either uninstall the hardware
product TIVsm-BAhdw, or set the
option DONTLOAD PIHDW in the
options file to prevent the hardware
plugin from being loaded.

Explanation: VMware operations are incompatible

with the hardware plugin product libraries.
System action: The VMware backup or restore
operation fails.

Explanation: An error occurred trying to save your

settings to dsmsm.cfg configuration file on your local
machine.

User response: Uninstall the hardware product

product TIVsm-BAhdw, or set the option DONTLOAD
PIHDW to prevent the hardware plugin from being
loaded.

System action: Customized GUI settings are not saved

to the local machine

ANS8818E

User response: Check the dsmsm.log file in the

installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS8809E

The LD_LIBRARY_PATH is either not

set or is set incorrectly. Ensure that the
LD_LIBRARY_PATH environment
variable contains the installation
directory path name.

An error occurred trying to apply your

changes. Your changes have not been
applied to the system. Contact your
system administrator.

Explanation: An error occurred trying to apply your

changes.
System action: User changes are not applied.
User response: Contact your system administrator.
ANS8819E

The following trace flag(s) are not valid:

trace-flag-list. Correct them before
continuing.

Explanation: The LD_LIBRARY_PATH must be set

and it must contain the installation directory path.

Explanation: One or more of the trace flags are not

valid.

System action: The VMware backup or restore

operation fails.

System action: Prompts the user to correct the trace

flags.

User response: Set the LD_LIBRARY_PATH and

ensure that it contains the Backup/Archive client
installation directory.

User response: Correct the wrong trace flags.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

219

ANS8820E

The HSM System Object was not found

on the Space Management agent. The
error occurred when calling function:
function-name. The last operation was not
processed correctly.

Explanation: The Space Management agent was

unable to process a HSM System function, because the
HSM System object was not found.
System action: The last operation is skipped.
User response: Reconnect to the Space Management
agent. If this does not solve the problem restart the
Space Management agent.
ANS8821E

Unable to create requested HSM object

on Space Management agent. The last
operation was not processed correctly.
The problem is caused from a memory
problem. Try to free memory on the
system where the Space Management
agent is running. Or restart the Space
Management agent.

Explanation: Space Management agent was not able to

create a requested HSM object because not enough free
space was found on the system.
System action: Last operation is skipped.
User response: Try to free more memory on the
system where the Space Management agent is running,
or restart the Space Management agent.
ANS8822E

HSM File System Object was not found

on Space Management agent. The error
occurred when calling function:
function-name The last operation was not
processed correctly.

Explanation: Space Management agent was not able to

process a HSM File System function, because no HSM
File System object was found.
System action: Last operation is skipped.
User response: Reconnect to the Space Management
agent. If this does not solve the problem restart the
Space Management agent.
ANS8823E

A Protocol error occurred in

communication with the Space
Management agent This error occurs
when a session with the Space
Management agent was lost, or network
error caused synchronization problem
between the Space Management console
and the agent.

Explanation: Space Management console and Space

Management agent has different session and
transaction key in the communication header.

220

System action: Last operation is skipped.

User response: Restart Space Management console
and Space Management agent.
ANS8824E

A internal error occurred in the Space

Management agent. The error occurred
in function : function-name

Explanation: Not defined exception caused a internal

error in the Space Management agent.
System action: Last operation is skipped.
User response: Restart Space Management agent. If
this does not solve the problem contact TSM technical
support.
ANS8825E

The Space Management API was unable

to locate option object The error
occurred in function : function-name

Explanation: Not defined exception caused this

internal error in the Space Management API.
System action: Last operation is skipped.
User response: Contact TSM technical support.
ANS8826E

The Space Management API was unable

to query a HSM device. This error
occurs because the HSM kernel
extension was not loaded correctly

Explanation: Because of a wrong configuration HSM

was not able the load the kernel extension. This causes
to fail the query for global activation of the HSM
system.
System action: Query for global HSM activation is
skipped.
User response: Check the configuration of the HSM
system. If you can not find any problem in the
configuration contact TSM technical support.
ANS8827E

The Space Management API was unable

to locate global control block. The error
occurred in function : function-name

Explanation: Not defined exception caused this

internal error in the Space Management API.
System action: Load connection settings function is
skipped.
User response: Contact TSM technical support.
ANS8828E

The Space Management API lost the

session with the server. This problem is
caused by a connection failure with the
server. Check to see if your Space
Management Client machine has a
network connection to the TSM server.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Explanation: This error occurs when the Space

Management API has connection problems with the
TSM server.

Management Console. A reason could be that the file

system was unmounted and is not longer existing on
the system.

System action: Session with server gets lost and

server operation is skipped.

System action: Getting file system information for the

specified file system name is skipped.

User response: Check the network connection with

TSM server machine. See the error log file for
additional information why the session gets lost.
Restart the Space Management Agent if the connection
re-established automatically.

User response: Update the file system list in the Space

Management Console by pressing F5 on your keyboard
or selecting 'Refresh' in the View menu.

ANS8829E

The Space Management API was unable

to initialize the HSM system. The error
is caused from a problem to initialize a
DMAPI session.

Explanation: This error is caused from a problem to

initialize a DMAPI session.
System action: The HSM system cannot be initialized
and the Space Management Console is ended.
User response: Try to restart Space Management
Agent. If this does not solve the problem, see the error
log for additional information and contact TSM
technical support.
ANS8830W

Different server name stanzas

(HSM-stanza and BA-stanza) for
file-system-name file system for space
management and backup-archive.

Explanation: The server name stanzas you specified

for the space management (HSM) client and the
backup-archive (BA) client are different. The inline
backup and stub restore features will be unavailable for
the file system.

ANS8832E

The Space Management API could not

retrieve TSM policy settings from the
server.

Explanation: The Space Management API tried to get

TSM policy settings from the server and failed for a
unknown reason.
System action: Getting TSM policy settings fails and
policy information fields are not filled up in the Space
Management Console.
User response: See the error log file for additional
information.
ANS8833E

The Space Management API could not

retrieve TSM policy settings from the
already loaded list.

Explanation: The Space Management API tried to get

TSM policy settings from the management list and
failed for a unknown reason.
System action: Getting TSM policy settings fails and
policy information fields are not filled up in the Space
Management Console.
User response: See the error log file for additional
information.

System action: Processing continues.

User response: If you want to allow inline backup and
stub restore for the file system, the MIGRATESERVER
and DEFAULTSERVER options must specify the same
SERVERNAME stanza in dsm.sys. You may also choose
to supply a server stanza name using the
SERVERNAME option in dsm.opt or on the command
line. In either case the stanza name must match the
stanza specified in the MIGRATESERVER option.
ANS8831E

The Space Management API could not

find file system : function-name An
incorrect file system name was passed to
the Space Management API. Ensure that
the file system that was selected in the
file system list is still valid. Refresh the
file system view in the Space
Management Console by pressing F5 on
your keyboard or select 'Refresh` under
the View menu.

Explanation: The Space Management API could not

find the file system that was specified in the Space

ANS8834E

The Space Management API was unable

to get file system information for file
system : filesystem-name.

Explanation: The Space Management API could not

retrieve the file system information for a selected file
system.
System action: Getting file system information fails
and information are not displayed in the Space
Management Console.
User response: See the error log file for additional
information.
ANS8835E

The Space Management API was unable

to get file system status for file system :
filesystem-name. System call to get file
system status returned with error.

Explanation: The Space Management API could not

retrieve the file system status for a selected file system.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

221

The error is caused from a failed system call on the file

system.
System action: Getting file system status fails and
information are not displayed in the Space
Management Console.
User response: See the error log file for additional
information.
ANS8836E

An object creation error occurred in the

Space Management API The error
occurred in function : function-name. The
problem is caused from a memory
problem. Try to free memory on the
system where the Space Management
agent is running. Or restart the Space
Management agent.

Explanation: Caused from a out of memory problem

the Space Management API could not create a
requested object.
System action: The requested function fails and
cannot retrieve information to the Space Management
Console.

the file system list in the Space Management console is

not longer HSM managed and no configuration can bet
set for it. A reason could be that the file system was
unmanaged from a other user.
System action: Setting HSM managed file system
configuration fails.
User response: Update the file system list in the Space
Management Console by pressing F5 on your keyboard
or selecting 'Refresh' in the View menu.
ANS8839E

A wrong stub file size was passed to the

Space Management API for file system :
filesystem-name. The stub file size that
was entered in the file system properties
dialog is not supported by this file
system. Correct the stub file size value
in the file system properties dialog of
the Space Management Console.

Explanation: The Stub file size that you has specified

is not supported by this file system.
System action: Wrong stub file size is not applied to
the file system.

User response: Free more memory on the system

where the Space Management agent is running, or
restart the Space Management agent.

User response: Correct the stub file size in the file

system properties dialog of the Space Management
Console.

ANS8837E

ANS8840E

The Space Management API was unable

to get configuration data from managed
file system : filesystem-name. The
problem is caused from a error when
reading dsmmigfs table entry.

Explanation: The Space Management API reads

information from dsmmigfs table to get HSM managed
files system configuration. This error occurs when the
API is unable to read an entry from this table.
System action: Getting HSM managed file system
configuration fails and information is not displayed in
the Space Management Console.
User response: See the error log for additional
information on errors occurring when reading entries
from the dsmmigfs table.
ANS8838E

The Space Management API can not set

HSM managed file system configuration
for file system : filesystem-name. The
configuration cannot be set because this
file system is NOT HSM managed.
Check to see if the managed file system
that was selected in the file system list
is still HSM managed. Refresh the file
system view in the Space Management
Console by pressing F5 on your
keyboard or select 'Refresh` under the
View menu.

Explanation: The file system that you selected from

222

The maximum number of candidates

that was specified for file system :
filesystem-name is out of range. The
maximum number of candidates value
that was entered in the file system
properties dialog is out of range. Correct
the maximum number of candidates
value in the file system properties
dialog of the Space Management
Console.

Explanation: The maximum number of candidates

value that was specified is out of range for this file
system.
System action: Wrong maximum number of
candidates value is not applied to the file system.
User response: Correct the maximum number of
candidates value in the file system properties dialog of
the Space Management Console.
ANS8841E

The server name that was specified for

the file system : optfile-name is not valid.
Correct the server name value in the
client node properties dialog of the
Space Management Console.

Explanation: The server name that was specified is

not valid.
System action: Wrong server name value is not
applied to the system options file.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Correct the server name value in the

client node properties dialog of the Space Management
Console.
ANS8842E

The Space Management API was not

able to modify system options file :
optfile-name because of insufficient
privilege. Use root user to change HSM
managed file system configuration.

ANS8846E

The Space Management API was not

able to update the HSM managed file
system : filesystem-name.

Explanation: The Space Management API could not

apply configuration changes to the HSM managed file
system.
System action: Changes are not applied to HSM
managed file system.

Explanation: User has no rights to modify system

options file.

User response: See error log file for additional

information why the update of the file system fails.

System action: Changes are not applied to the system

options file.

ANS8847E

User response: Run as root user to change HSM

managed file system configuration.
ANS8843E

No correct include/exclude settings are

found in system options file :
optfile-name. Correct the include/exclude
list in the system options file.

Explanation: The include/exclude settings in the

system options file are not correct.
System action: Changes are not applied to the system
options file.

Explanation: The Space Management API could not

lock the SDR file for the file system.
System action: Changes are not applied to HSM
managed file system.
User response: See the error log file for additional
information on why the lock on the SDR file fails.
ANS8848E

User response: Correct the include/exclude list in the

system options file.
ANS8844E

A incorrect preferred node or server

name was specified in the HSM
configuration for filesystem-name. Correct
the preferred node and server name
value in the HSM configuration.

Explanation: The Space Management API could not

change preferred node settings because a wrong value
was specified
System action: Changes are not applied to the system
options file.

The Space Management API was not

able to obtain a lock on SDR file for file
system : filesystem-name.

The Space Management API could not

open file system status file to retrieve
managed file system statistics for :
filesystem-name. Reason could be
insufficient permissions or that the file
does not exist. The managed file system
statistics are not retrieved from the
HSM system.

Explanation: The Space Management API could not

retrieve managed file system information from file
system status file. The error occurred when the API
tries to open the file for reading.
System action: Managed file system statistics are not
retrieved and information is not displayed in the Space
Management Console.

User response: Correct the preferred node and server

settings in Space Management Configuration.

User response: See the error log file for additional

information on why opening the file system status file
fails.

ANS8845E

ANS8849E

A incorrect owner node or server name

was specified in the HSM configuration
for filesystem-name. Correct the owner
node and server name value in the HSM
configuration.

Explanation: The Space Management API could not

change owner node settings because a wrong value was
specified
System action: Changes are not applied to the system
options file.
User response: Correct the owner node and server
settings in Space Management Configuration.

The Space Management API was not

able to load HSM managed file system
statistics for : filesystem-name. Check to
see if the managed file system that was
selected in the file system list is still
HSM managed. Refresh the file system
view in the Space Management Console
by pressing F5 on your keyboard or
select 'Refresh` under the View menu.

Explanation: The Space Management API could not

load managed file system statistics from selected file
system. The reason could be that the file system is not
longer HSM managed.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

223

System action: Managed file system statistics are not

retrieved and information is not displayed in the Space
Management Console.

does not solve the problem, see the error log file for
additional information and contact TSM technical
support.

User response: Update the file system list in the Space

Management Console by pressing F5 on your keyboard
or selecting 'Refresh' in the View menu.

ANS8854E

ANS8850E

The Space Management API was not

able to add HSM to file system :
filesystem-name. This error occurs because
selected file system is not mounted. You
must mount the file system before you
can add HSM.

Explanation: The Space Management API could not

add HSM to a file system, because it is not mounted.
System action: The add HSM operation fails and HSM
is not added to the selected file system.
User response: Mount the selected file system before
adding HSM.

Explanation: The Space Management API attempt to

unmanage (remove) file system and fails for a
unknown reason.
System action: The remove HSM operation fails and
HSM is not removed from the selected file system.
User response: Try the remove HSM operation again.
If this does not solve the problem, see the error log file
for additional information and contact TSM technical
support.
ANS8855E

ANS8851E

The Space Management API was not

able to add HSM to file system :
filesystem-name. This error occurs because
selected file system is not supported to
add HSM.

The Space Management API was not

able to remove HSM from file system :
filesystem-name. The error occurs when
the Space Management API tries to lock
the SDR file and fails.

The Space Management API was not

able to start automatic migration on the
file system : filesystem-name.

Explanation: The Space Management API tries to start

automatic migration on a file system and fails for a
unknown reason.

Explanation: The Space Management API could not

add HSM to a unsupported file system.

System action: The automatic migration is not started

for the file system.

System action: The add HSM operation fails and HSM

is not added to the selected file system.

User response: See the error log file for additional

information and contact TSM technical support.

User response: Select a supported file system to add

HSM.

ANS8856E

ANS8852E

The Space Management API was not

able to add HSM to file system :
filesystem-name. This error occurs because
selected file system is already HSM
managed.

Explanation: The Space Management API attempt to

manage a already HSM managed file system.
System action: The add HSM operation fails and the
selected file system stays HSM managed.

The Space Management API was not

able to start reconciliation process on
the file system : filesystem-name.

Explanation: The Space Management API tries to start

reconciliation process on a file system and fails for a
unknown reason.
System action: The reconciliation process is not
started for the file system.
User response: See the error log file for additional
information, and contact TSM technical support.

User response: Select a not managed file system to

add HSM.

ANS8857E

ANS8853E

Explanation: The Space Management API tries to start

scout process on a file system and fails for a unknown
reason.

The Space Management API was not

able to add HSM to file system :
filesystem-name.

The Space Management API was not

able to start scout process on the file
system : filesystem-name.

Explanation: The Space Management API attempt to

manage file system and fails for a unknown reason.

System action: The scout process is not started for the

file system.

System action: The add HSM operation fails and HSM

is not added to the selected file system.

User response: See the error log file for additional

information, and contact TSM technical support.

User response: Retry the add HSM operation. If this

224

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS8858E

The Space Management API was not

able to migrate the file : file-name. The
error occurred in function :
function-name.

Explanation: The Space Management API tries to

migrate a file and fails in the displayed API function.
System action: The selected file is not migrated to the
server.
User response: See the error log file for additional
information.
ANS8859E

The Space Management API was not

able to recall the file : file-name. The
error occurred in function :
function-name.

ANS9005W

Explanation: The program found an invalid parameter

in the space management configuration of a filesystem.
System action: The paramter value was rejected.
User response: In case you tried to set the specified
value manually, choose a value from the specified
range instead. If the value is read from a file system's
space management configuration file (located at
[fs]/.SpaceMan/hsmfsconfig.xml), edit the file
accordingly. The name of the filesystem can be
determined from a subsequent error message.
ANS9007W

Explanation: The Space Management API tries to

recall a file and fails in the displayed API function.
System action: The selected file is not recalled from
the server.
User response: See the error log file for additional
information.
ANS8939E

An unexpected error occurred trying to

filter the directory tree. rc=return-code

Explanation: The filter was not applied to the

directory tree.

program name: invalid 'parameter name'

value: value (must be in [minimum
value..maximum value]).

program name: invalid 'parameter name'

value: value (must be in [minimum
value..maximum value]).

Explanation: The program found an invalid parameter

in the space management configuration of a filesystem.
System action: The paramter value was rejected.
User response: In case you tried to set the specified
value manually, choose a value from the specified
range instead. If the value is read from a file system's
space management configuration file (located at
[fs]/.SpaceMan/hsmfsconfig.xml), edit the file
accordingly. The name of the filesystem can be
determined from a subsequent error message.

System action: The directory tree is not filtered.

User response: Contact your system administrator for
further assistance.
ANS8945E

An unexpected error occurred analyzing

the directory tree. The list of files
matching your search criteria is not
completed. rc=return-code

Explanation: It was not possible to search all items

matching the search criteria on the directory tree due to
an unexpected error.
System action: The search results table shows only the
items found until the error is occurred.
User response: Contact your system administrator for
further assistance.
ANS8946E

RPC call failed.

Explanation: Unable to connect receiver recall

daemon.
System action: Processing stopped.

ANS9009E

program name: found invalid space

management configuration for
'filesystem'.

Explanation: The program found an invalid space

management configuration for the given filesystem.
System action: The space management configuration
was rejected for the given filesystem . When updating
an existing configuration, invalid configurations to set
are ignored. When a persistent configuration file is
invalid, the filesystem will appear to not have space
management enabled.
User response: In case you tried to update space
management for this filesystem manually, enter a valid
configuration instead. In case the persistent
configuration file is invalid, edit the file accordingly;
alternatively, you can add space management explicitly
(which will remove / overwrite the existing
configuration). The reason for the configuration can be
determined from a preceding error message. The
filesystem's space management configuration file is
located at 'filesystem'/.SpaceMan/hsmfsconfig.xml.

User response: System is not operating correctly or

recall daemons are not started.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

225

ANS9010E

program name: could not parse space

management configuration file
'configuration file' for filesystem.

ANS9017W

Explanation: The space management configuration file

for the given filesystem is present but its content
appears to have invalid format.
System action: The configuration was rejected. The
filesystem will appear to not have space management
enabled.
User response: Check the given space management
configuration file; it is supposed to contain a
well-formed XML document with a root element
named 'HsmFsConfig'. To create a new configuration
file, you can simply add space management to this
filesystem.
ANS9011E

program name: could not write space

management configuration file
'configuration file' for filesystem.

Explanation: IBM Tivoli Storage Manager could not

write and save the space management configuration file
for the given filesystem.
System action: IBM Tivoli Storage Manager did not
save the space management configuration information.
If you tried to add space management for this
filesystem, it was not added. If you tried to update the
space managment configuration, it was probably not
updated. If an existing configuration file in old format
was read successfully, but could not be converted to
XML format, space management will be active for this
filesystem with the configuration from the old file.
User response: Determine if there is any reason why
the given file cannot be written.
ANS9012E

error-program: Command must be run by

root user.

error-program: Minimum number of

recall daemons min-dsmrecalld cannot be
greater than maximum number of recall
daemons max-dsmrecalld; defaulting to
minimum min-dsmrecalld and maximum
max-dsmrecalld.

Explanation: A minimum number of recall daemons

has been entered that is greater than the maximum
number of recall daemons.
System action: TSM uses defaults instead of the
values specified in the client system options file
(dsm.sys).
User response: Correct the MINRECALLDAEMONS
and MAXRECALLDAEMONS options in the client
system options file and retry the operation.
ANS9018W

program-name: option option value value

invalid, range min-value to max-value.

Explanation: An invalid value has been entered. Value

should be in the range specified by the message.
System action: TSM uses defaults instead of the value
specified by the user.
User response: Correct the invalid input value.
ANS9019W

program-name: unable to parse option

value 'argument'

Explanation: Input is incorrect or is not in correct

format.
System action: TSM continues.
User response: Retry operation with correct usage
syntax.
ANS9020E

Could not establish a session with a

TSM server or client agent. The TSM
return code is tsm-error;.

Explanation: TSM requires that a root user perform

this operation.

Explanation: None.

System action: TSM terminates the operation.

System action: Processing stops.

User response: Change to root user, and then retry the

operation.

User response: Check the TSM error log for

communications failures such as TCP/IP, shared
memory, or named pipe errors.

ANS9016E

Cannot get space management migration

status for path.

Explanation: An error occurred while trying to get the

space management migration status. Either the
permissions for the status file are not set correctly, or
the status file is damaged.
System action: TSM terminates the operation.
User response: The root user should check the
permissions of the status file, or contact the service
representative.

226

ANS9021E

error-program Unknown recall daemon

(pid process-ID) terminated abnormally,
status: status.

Explanation: A recall daemon stops abnormally.

System action: TSM terminates the operation.
User response: Try the operation again. If the problem
persists, send the core file to IBM technical support for
analysis.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9022E

error-program Recall daemon (pid

process-ID) ended abnormally, status:
status.

the process holding the lock.

ANS9029E

Explanation: A recall daemon stopped abnormally.

System action: The operation does not complete.
User response: Try the operation again. If the problem
persists, send the core file to IBM technical support for
analysis.

The WebSphere server is running, but

the server must be shut down for a
restore operation. Shut down the
WebSphere server and try the restore
operation again.

Explanation: The WebSphere server must be brought

down to perform a restore.
System action: The restore operation fails.

ANS9023I

error-program: Subsidiary recall daemon

process exiting.

Explanation: The process is interrupted and exiting.

The user has terminated the process.
System action: TSM detected an interrupt. The recall
daemon is terminated and exiting.

User response: Shut down the WebSphere server and

try the restore operation again.
ANS9030W

Cannot set conflicting attributes to file

file-name.

User response: None.

Explanation: TSM cannot set the file attributes

because the requested attributes are in conflict with one
another.

ANS9024E

System action: TSM does not set the file attributes.

Starting with this release all candidate

processing is done internally by the
TSM monitor daemon. Thus -c is no
longer a valid option for dsmreconcile.

Explanation: The command line options -c and

-Candidates are no longer valid for dsmreconcile as all
candidates processing is now performed by
dsmmonitord.
System action: TSM detected an invalid option.
dsmreconcile is exiting.
User response: Don't use options -c and -Candidates
with dsmreconcile anymore.

User response: Retry this operation with attributes

that do not conflict with each other.
ANS9031W

Explanation: TSM can only set file attributes to a

migrated file. This file has not been migrated.
System action: TSM does not set the file attributes.
User response: Migrate this file, and then retry the
operation.
ANS9032W

ANS9025E

The Data Protection for WebSphere

plug-in version and the backup-archive
client version do not match. Please
upgrade your Data Protection for
WebSphere plug-in.

Explanation: The release and version of the Data

Protection for WebSphere plug-in is downlevel from the
release and version of the Backup-Archive Client.

File file-name is not a migrated file.

File file-name is not in an HSM managed

file system.

Explanation: TSM detects that the file is not in an

HSM managed file system, and therefore, it cannot
perform the operation requested.
System action: TSM does not set the file attributes.
User response: Add space management to the file
system, migrate the file, and then retry the operation.

System action: None

User response: Upgrade Data Protection for
WebSphere to the proper release and version.
ANS9028E

program name: could not acquire lock for

filesystem.

Explanation: Prior to modifying a space management

configuration file, it is required to lock the file in order
to avoid concurrent access. If acquiring the lock fails,
there was a concurrent access.
System action: The action was cancelled.

ANS9034E

The restore operation did not complete,

due to a change in the original
WebSphere environment.

Explanation: The data must be restored to the same

environment that it was backed up from. This includes
items such as cell name, node name, and the location
where WebSphere is installed.
System action: The restore operation does not
complete.
User response: Perform the restore procedure in the
DP for WebSphere book.

User response: Retry the same request or determine

Chapter 2. ANS 0001-9999: Client messages, version 6.3

227

ANS9036W

program-name: migrated file(s) are

missing on server for number stub file(s).
Look in 'file-spec' for file names.

Explanation: TSM cannot find the migrated file(s) on

the server.
System action: TSM continues.
User response: Look in the path mentioned in the
message for the file name. Also ensure that you are
working with the correct server for this file.
ANS9054E

error-program: cannot get and increase

limit of open files.

Explanation: TSM either cannot get the limit of the

number of open files, or cannot increase the limit of the
number of open files.
System action: TSM cannot increase the number of
open files, and was not able to complete the operation.
User response: Free some file space by ending some
processes or removing some files, and retry the
operation.

The plug-in was not found.

Explanation: None.
System action: None
User response: Run "dsmc show plugins" at the
command prompt to see the available plug-ins on the
system.
ANS9057W

ANS9060W

error-program: cannot get space

information for file-system: error.

Explanation: TSM cannot get the space information

for the file system.

ANS9062E

File 'filename' has changed during the

backup.

Explanation: A file changed during the backup. Check

the dsmerror.log file for a list of files that have
changed.
System action: The backup fails.
User response: Try the backup again.
ANS9063E

error-program: file system file-system is out

of inodes.

System action: TSM continues.

Explanation: TSM cannot get space for the file system

because the file system is out of inodes.

User response: Verify that space management has

been added to the file system.

System action: TSM cannot get space via migration.

ANS9058E

error-program: cannot close file-spec: error.

Explanation: TSM cannot close the file. This problem

occurs while the dsmmonitor daemon examines
available space on the file system.
System action: TSM terminates the current operation.
User response: Confirm that file system is still
mounted and managed by HSM. If the problem
persists, reboot the system. If that does not resolve the
problem, contact IBM technical support for further
assistance. Provide the operating system error code and
the output of the df, dsmdf, and mount Unix shell
commands.
ANS9059E

error-program: process cannot detach to

become a daemon.

Explanation: TSM process cannot detach itself to

become a daemon.

User response: Remove some files to make more

inodes available and retry.
ANS9064E

error-program: Cannot fork a new

process: error.

Explanation: TSM cannot fork a new process that is

needed. If the operating system errno is EAGAIN, then
the limit on the total number of processes running on
the system or by a single user has been exceeded, or
the system does not have the resources necessary to
create another process. If the errno is ENOMEM, then
there is not enough memory to create the process.
System action: TSM cannot complete the requested
operation.
User response: Depending on the error code (errno),
either allocate additional virtual memory (swap space)
or increase the operating system process limit. Then
restart the HSM daemons or reboot the system.

System action: TSM cannot start the daemon as

requested. TSM stops.

ANS9065E

File 'filename' or file 'filename2' has been

added or removed during the backup.

User response: Retry the operation.

Explanation: A file was added or removed during the

backup.
System action: The backup fails.
User response: Try the backup again.

228

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9067W

error-program: error updating

dsmmigfstab file for file-system.

Explanation: TSM found an error in updating the

dsmmigfstab file for this file system.
System action: TSM does not update the dsmmigfstab
file.
User response: See the preceding error message and
correct the error if possible. Then, retry the operation. If
problem persists, contact your system administrator.
ANS9068I

program-name: dsmmigfstab file updated

for file system file-system.

installed correctly and retry the operation.

ANS9073W

Explanation: TSM found an error in trying to

deactivate the file system.
System action: TSM does not deactivate space
management for the file system.
User response: Make sure space management is
installed correctly and retry the operation.
ANS9074I

Explanation: TSM successfully updated the

dsmmigfstab file for the file system.
System action: TSM continues.
User response: Continue with normal operation.

program-name: error deactivating space

management for file system file-system.

program-name: space management

functions have been locally deactivated
for file system file-system.

Explanation: TSM has locally deactivated space

management functions like migration, recall and
reconciliation for the file system.
System action: TSM continues.

ANS9069I

program-name: all file systems are

reactivated to previous states.

Explanation: TSM has reactivated all file systems

managed by HSM to their previous states before the
global deactivation.
System action: TSM continues.
User response: Continue with normal operation.
ANS9070I

program-name: space management is now

deactivated for all HSM file systems.

Explanation: TSM has deactivated space management

for all file systems listed in the dsmmigfstab file.
System action: TSM continues.

User response: Continue with normal operation.

ANS9075W

program-name: error reactivating space

management for file system file-system.

Explanation: TSM found an error in trying to

reactivate space management for the file system.
System action: TSM does not reactivate space
management for the file system.
User response: Verify that the specified file system is
mounted and that HSM is enabled for this file system.
Then try the operation again. If the problem persists,
contact IBM technical support for additional assistance.
Provide the /etc/filesystems (or equivalent file) and the
output from the mount and dsmdf commands.

User response: Continue with normal operation.

ANS9076I
ANS9071W

program-name: error reactivating space

management for all HSM file systems.

Explanation: TSM found an error in trying to

reactivate space management.
System action: TSM does not reactivate space
management for HSM file systems.
User response: Make sure space management is
installed correctly and retry the operation.

program-name: space management

functions have been locally reactivated
for file system file-system.

Explanation: TSM has locally reactivated space

management functions like migration, recall and
reconciliation for the file system. Please, note however
that the space management might still be globally
deactivated.
System action: TSM continues.
User response: Continue with normal operation.

ANS9072W

error-program: error deactivating space

management for all FSM file systems.

Explanation: TSM found an error in trying to

deactivate space management.
System action: TSM does not deactivate space
management for FSM file systems.
User response: Make sure space management is

ANS9077I

program-name: removed space

management from file system file-system.

Explanation: TSM removed space management. The

file system is now a native file system.
System action: TSM continues.
User response: Continue with normal operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

229

ANS9078W

Space management is not removed from

file system file-system.

Explanation: TSM was not able to remove space

management from this file system. Possible causes:
Kernel extension is downlevel.
Program is downlevel.
Insufficient disk space.
System action: TSM is unable to complete the
requested operation.
User response: Refer to the immediately preceding
error message and retry the operation.
ANS9079W

program-name: no migrated files

matching search criteria found.

Explanation: TSM did not find any migrated files

matching the search criteria.
System action: TSM cannot complete the requested
operation.
User response: Retry the operation with a different
search criteria.
ANS9080E

program-name: not enough space in file

system or storage pool to recall all
migrated files.

Explanation: TSM detects there is not enough space in

the file system to hold all the migrated files if all are
recalled. If you are using GPFS storage pools, each pool
needs to have enough space to recall it's files.
System action: TSM does not attempt to recall all the
migrated files.
User response: Make room in the file system by
increasing the file system size or removing some files.
Retry the operation.
ANS9081W

program-name: orphaned stub file(s)

detected in file system file-system.

Explanation: TSM detected one or more orphaned

stub files. Either the migration server was changed in
the client system options file after the file was
migrated, or the migration server database is damaged.
System action: TSM does not attempt to remove space
management from the file system.
User response: Determine the cause of orphaned stub
files. Switch to the correct migration server and recall
the migrated files. Retry the operation.
ANS9082W

program-name: error encountered while

reconciling file system file-system.

Explanation: TSM encountered an error performing

reconciliation on the file system.
System action: TSM continues.

230

User response: Refer to other messages displayed or

messages in the log to correct the problem. Then retry
the operation.
ANS9083W

program-name: cannot deactivate space

management on file system file-system.

Explanation: TSM cannot deactivate space

management on the file system.
System action: TSM continues.
User response: Correct the error if possible and retry
the operation.
ANS9084E

program-name: file-system is not managed

or not locally managed by space
management.

Explanation: There is no entry for the file system in

the dsmmigfstab file or the file system is managed by
another node.
System action: TSM will not perform space
management functions on this file system.
User response: Add space management to the file
system, if appropriate, and then retry the operation. If
the file system is not locally managed, retry the
operation on the node managing the file system.
ANS9085E

program-name: file system file-system is

not managed by space management.

Explanation: There is no entry for the file system in

the dsmmigfstab file.
System action: TSM will not perform space
management functions on this file system.
User response: Add space management to the file
system, if appropriate, and then retry the operation.
ANS9086E

program-name: A DMAPI error occured

adding space management to file system
file-system, It is possible DMAPI is
disabled on this file system. The system
set the error code: errno = errno-value

Explanation: TSM encountered an error and cannot

add space management to the file system.
System action: TSM Space management cannot be
added to file system.
User response: Verify that DMAPI is enabled for this
file system and retry the operation.
ANS9087I

Space management is successfully

added to file system file-system.

Explanation: TSM has added space management to

the file system, and will now monitor its space usage.
You can also perform other space management

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

operations on this file system.

ANS9092W

System action: TSM continues.

User response: Continue with normal operation.
ANS9088W

program-name: space management is

already active for file system filesystem.

Explanation: This message is issued when trying to

add space management to a filesystem with space
management already activated. It is not possible to add
space management for a filesystem that already has
space management activated.

Explanation: AES 128-bit encryption is not being used.

DES 56-bit encryption is being used instead.
System action: DES 56-bit Encryption is used instead
of AES 128-bit encryption.
User response: If the user wants to use AES
encryption, then the user must install the IBM JRE in
order to enable AES encryption for the web client.
ANS9093W

System action: The action was cancelled.

User response: In case you wanted to update the
filesystem's space management configuration instead,
use the appropriate update command.

AES 128-bit Encryption is not being

used.

program-name: cannot update migration

candidates list file-name.

Explanation: TSM cannot update the migration

candidates list because not enough memory is available
to create a temporary file.
System action: Processing stops.

ANS9089E

The group backup validation failed.

One or more files were added, removed,
or changed during the backup.

User response: Make some memory available by

ending some processes, and then retry the operation.

Explanation: One or more files have been added,

removed, or changed from the time WebSphere was
queried to the time that all the data was sent to the
TSM server. Check the dsmerror.log file for a list of
files that were added, removed, or changed.

Explanation: TSM found no files eligible for migration

in the file system after running dsmreconcile.

System action: The backup fails.

System action: TSM continues.

User response: Try the backup again.

User response: Continue with normal operation.

ANS9090E

program-name: file-system is not a valid

file system name.

ANS9094W

ANS9096E

program-name: no candidates found in

file system file-system.

User is not the owner of file

filesystem-namedirectory-namefile-name so
file is skipped.

Explanation: TSM received an invalid file system

name. The file system is not mounted, or is not
mounted correctly.

Explanation: The user does not own this file and

cannot perform this operation.

System action: TSM continues.

System action: TSM skips the file.

User response: Correct the file system name, and retry

the operation.

User response: None, or if you have root-user

authority, switch to root user and retry the operation.

ANS9091E

ANS9098E

The WebSphere backup validation

failed. One or more files were added,
removed, or changed during the backup.

Explanation: One or more files have been added,

removed, or changed from the time WebSphere was
queried to the time that all the data was sent to the
TSM server. Check the dsmerror.log file for a list of
files that were added, removed, or changed.
System action: The backup fails.

program-name: space management does

not support file system file-system.

Explanation: TSM space management does not

support this type of file system. Space management
supports only true local file systems (e.g. JFS on AIX).
Space management does not support other types of file
systems (AFS, NFS, etc).
System action: Processing of the file system stopped.
User response: None.

User response: Try the backup again. Do not install

new WebSphere applications or change the WebSphere
configuration while in the backup window.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

231

ANS9099E

program-name: space management is not

active for file system file-system.

Explanation: TSM found the file system did not have

space management activated.
System action: Processing of that file system stopped.
User response: Reactivate space management for the
file system.
ANS9100E

Unable to open file 'filename' for output.

technical support for assistance.

ANS9128I

Explanation: A Domino inactivate log operation was

completed.
System action: TSM inactivated the log.
User response: Continue with normal operations.
ANS9130W

Explanation: The file name specified cannot be

opened.
System action: Make sure that user has access to write
to specified file, or use different file name.
User response: Output will not be saved. Please
specify different file or check permissions on chose file.
ANS9101I

No migrated files matching 'file-name'

were found.

Explanation: You entered a search pattern or file name

that cannot be found in the server database as a
migrated file.
System action: Processing stopped.
User response: Ensure that your search pattern is
correct, or specify a new search string.
ANS9121I

Activate completed.

Explanation: A Domino activate databases operation

was completed.
System action: TSM activated the databases.
User response: Continue with normal operations.

Inactivate logs completed.

program name: could not convert the

space management configuration for
filesystem from file old configuration file to
XML configuration file.

Explanation: Starting from TSM version 6.1, space

management configuration is stored in XML format. In
case the systems finds a configuration file in former,
proprietary format only, it is read and converted to
XML format. This message indicates that the old format
file was read successfully but could not be written to
an XML configuration file.
System action: Space management configuration is
taken from the old format file.
User response: Determine the reason why the XML
file could not be written.
ANS9131E

program name: old space management

configuration file does not match
filesystem: file content.

Explanation: Starting from TSM version 6.1, space

management configuration is stored in XML format. In
case the systems finds a configuration file in former,
proprietary format only, this file is processed. The
content of the file starts with the filesystem; this
message is issued when the filesystem name does not
match.

program-name: cannot determine whether

space management is active or inactive
for file-system due to error: error.

System action: Space management configuration was

rejected. The filesystem is considered to not have space
management activated.

Explanation: The program 'program-name' indicated

in the message text was unable to obtain statistics for
file system 'file-system'. Therefore the program cannot
determine whether space management is activated,
deactivated, or globally deactivated on that file system.
The message text includes a description of the Unix
errno error that occurred while trying to get the state of
space management.

User response: Check the old configuration file and

correct the filename manually in case the rest of the file
content is valid. Alternatively, you can explicitely add
space management for the filesystem to create a new
space management configuration file.

ANS9126E

System action: TSM stops the operation.

User response: Verify that the file system is mounted
and accessible. Using the appropriate tools for that file
system, check whether there are any I/O or other
integrity errors on that file system. Then try the
operation again. If the operation fails, then a system
reboot might clear the error condition. If, after taking
these actions the problem persists, contact IBM

232

ANS9132E

program name: old space management

configuration file is corrupted for
filesystem: file content.

Explanation: Starting from TSM version 6.1, space

management configuration is stored in XML format. In
case the systems finds a configuration file in former,
proprietary format only, this file is processed. This
message is issued when parsing its content failed.
System action: Space management configuration was

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

rejected. The filesystem is considered to not have space

management activated.

could not be removed and retry.

User response: Check the old configuration file and

consider correct its content manually. Alternatively, you
can explicitely add space management for the
filesystem to create a new space management
configuration file.

ANS9147E

ANS9133E

program name: space management already

active for filesystem.

Explanation: This message is issued when trying to

add space management to a filesystem with space
management already activated.
System action: The action was cancelled.
User response: Check the filesystem's space
management configuration and consider updating it in
case it does not match your needs. It is not possible to
add space management for a filesystem that already
has space management activated.
ANS9134E

program name: space management not

active for filesystem.

Explanation: The program requested the space

management configuration for a file system where
space management is not active.
System action: The action was cancelled.
User response: In case you entered the filesystem
specification, check for correct spelling. It is not
possible to perform space management actions on a
filesystem with space management not activated.

program-name: cannot read file-spec: error.

Explanation: TSM cannot read this file.

System action: TSM cannot fully complete the
requested operation.
User response: An error occurred reading an HSM
managed file system status file. Verify that the file
system is mounted and enabled for HSM and is
actually managed by HSM and then try the operation
again. If the problem persists, contact IBM technical
support for further assistance. Provide the output from
the mount, dsmdf and ls -l [file system name]
commands.
ANS9148E

program-name: cannot find mount point

for file system file-system.

Explanation: TSM cannot find file system mount

point.
System action: TSM cannot complete the requested
operation.
User response: The specified file system is not
currently mounted. Mount the file system and try the
operation again.
ANS9150I

Archive log completed.

Explanation: A Domino archive log operation was

completed.
System action: TSM archived the log.
User response: Continue with normal operations.

ANS9135E

program name: space management for

filesystem not controlled by the local
node.

Explanation: The program requested the space

management configuration for a file system where
space management is active, but not controlled by the
local node. In cluster environments, some space
management actions are allowed from the owner node
only.
System action: The action was cancelled.
User response: Determine the controller node for this
filesystem and retry.
ANS9136E

program name: could not remove

configuration file for filesystem.

Explanation: During removal of space management

for the given filesystem, this configuration file could
not be removed.
System action: Space management could not be
deactivated for this filesystem.
User response: Determine the reason why the file

ANS9151E

An unexpected program error was

encountered . TSM function name :
function-name TSM function :
function-desc TSM return code : TSM-rc
TSM file : file-name (line-number)

Explanation: None.
System action: Processing stops.
User response: Check error log for more information.
Contact the TSM administrator with the information
provided in this message.
ANS9152E

program-name: cannot deactivate space

management for whole system: error.

Explanation: Space management cannot be

deactivated for the whole machine.
System action: TSM cannot deactivate space
management support.
User response: The HSM global status is inaccessible,
possibly due to concurrent access. Try the operation
Chapter 2. ANS 0001-9999: Client messages, version 6.3

233

again. If the problem continues, examine the output of

the shell command ps -aef as well as the contents of
/etc/adsm/SpaceMan/config/dmiFSGlobalState.pid. If
a pid is stored in this file and it does correspond to a
running process, remove the dmiFSGlobalState.pid file
and retry the operation. If the problem persists, reboot
the system and repeat the appropriate analysis for your
file system type.
ANS9153E

program-name: cannot reactivate space

management for whole system: error.

Explanation: Space management cannot be reactivated

for the whole machine.
System action: TSM cannot reactivate space
management support.
User response: The HSM global status is inaccessible,
possibly due to concurrent access. Try the operation
again. If the problem continues, examine the output of
the shell command ps -aef as well as the contents of
/etc/adsm/SpaceMan/config/dmiFSGlobalState.pid. If
a pid is stored in this file and it does correspond to a
running process, remove the dmiFSGlobalState.pid file
and retry the operation. If the problem persists, reboot
the system and repeat the appropriate analysis for your
file system type.
ANS9154E

program-name: cannot deactivate space

management for file system file-system:
error.

ANS9156I

Rollforward completed.

Explanation: A Domino DB2 rollforward operation

was completed.
System action: TSM rollforward the Domino DB2
database log.
User response: Continue with normal operations.
ANS9157W

Please enter a valid filespace location

Explanation: This message will be seen when you run

the Pref editor from MFC GUI. This means that user
has not entered a required field which is filespace
location path.
System action: TSM Enter required field
User response: Operation will not proceed till user
enters required field
ANS9158W

program-name: cannot turn on ENOSPC

checking in kernel: error.

Explanation: TSM cannot turn on ENOSPC checking.

System action: TSM cannot turn on ENOSPC
checking. Processing continues.
User response: Verify that the AIX JFS HSM fsm
kernel extension is loaded, then try the operation again.
If the problem persists, reboot the system and try the
operation again.

Explanation: Space management cannot be

deactivated for the file system.

ANS9159E

System action: TSM unable to deactivate space

management support for the file system.

Explanation: TSM cannot create a temporary file.

User response: The HSM file system status is

inaccessible, possibly due to concurrent access. Try the
operation again. If the problem continues verify that
the file system is mounted and that HSM is enabled on
the file system with the Unix shell commands mount
and dsmdf. If the problem persists, reboot the system
and try the operation again.
ANS9155E

program-name: cannot reactivate space

management for file system file-system:
error.

Explanation: Space management cannot be reactivated

for the file system.
System action: TSM cannot reactivate space
management support to the file system.
User response: The HSM file system status is
inaccessible, possibly due to concurrent access. Try the
operation again. If the problem continues, verify that
the file system is mounted and that HSM is enabled on
the file system with the Unix shell commands mount
and dsmdf. If the problem persists, reboot the system
and try the operation again.

234

program-name: unable to create temporary

file.

System action: TSM cannot complete its operation.

User response: Check with the Unix mount shell
command that /tmp and /etc exist as separate file
systems on your system. Use the df command to check
whether they are full. Create additional space by
deleting files or increasing the file system size.
ANS9160E

program-name: cannot write to temporary

file or status filefile-spec: error.

Explanation: TSM cannot complete writing to the

temporary file.
System action: TSM cannot complete the requested
operation.
User response: The Unix error code may provide
guidance as to why the write failed. Use the Unix
mount and df shell commands to verify that the
associated file system is mounted and has space
available. If this message resulted from a shell
command, mount the file system and create additional
space if necessary, then retry the operation. If the
message did not result from a shell command, restart

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

the daemons. If the problem persists, reboot the system.

ANS9161E

ANS9166I

Invalid backupset file or device name

entered.

Explanation: The backupset file or device name

specified does not contain a valid backupset.
System action: Processing stopped.
User response: Specify a file name or device that
contains a valid backupset and retry the operation.
ANS9163W

program-name: Could not acquire the

recall daemon session id.

Explanation: Could not set up the event disposition

for the file system, because the recall daemon session
could not be acquired. It seems the recall daemon is not
running. Recall requests will not be handled, which
means the TSM client for space management can't react
to recall requests for this file system.
System action: TSM could not set up the recall event
handling. The recall event handling is not enabled for
this filesystem.
User response: Start or restart the recall daemon.
ANS9164W

program-name: Could not acquire the

monitor daemon session id.

Explanation: Could not set up the event disposition

for the file system, because the monitor daemon session
could not be acquired. It seems the monitor daemon is
not running. Thus the thresholds for file system usage
will not be monitored and the NOSPACE event will not
be handled, which means the file system may run out
of space.

A 'backup type' backup version backup

date 'datetime' is not consistent with local
repository and has been deleted from
the server (object name='filespace
namepath-namefile-name', ID =
'object-id:object-id').

Explanation: The specified backup instance of the

named object is not valid with local repository contents.
This could happen if local repository is modified or got
corrupted on the client system. This backup can not be
restored, therefore it will be deleted on the server.
System action: The specified backup object will be
deleted on the server. Processing will continue.
User response: None.
ANS9167W

The client cache for adaptive subfile

backup is corrupt and cannot be used.

Explanation: The adaptive subfile cache has become

corrupt. While the backup client can detect the
corruption, the reason for the corruption cannot be
determined.
System action: The TSM client will proceed with
standard selective or incremental backup. The cache
will be rebuilt so that subsequent backups will use the
adaptive subfile technique.
User response: If the problem persists, contact IBM
technical support for assistance. Be prepared to provide
the client error log, which will contain additional
messages that might be useful for support to help
identify the problem.
ANS9168E

program-name cannot open database

file-spec due to the following error: error.

System action: TSM could not set up the NOSPACE

event handling. The NOSPACE event handling is not
enabled for this filesystem.

Explanation: The database specified in the message

text could not be opened. The reason for the error is
included in the message text.

User response: Start or restart the monitor daemon.

System action: The requested operation does not

complete.

ANS9165E

program-name cannot open directory

directory-spec due to the following error:
error.

Explanation: The directory indicated in the message

text cannot be opened. The message text includes a
description of the error that occurred.
System action: The requested operation is not
completed.
User response: Try to correct the error condition that
is indicated in the message text, then try the operation
again. If the problem persists, contact IBM technical
support for further assistance.

User response: Make sure that the file system has

sufficient available space, then try the operation again.
If the problem persists, contact IBM technical support
for further assistance.
ANS9169E

program-name: cannot create directory

directory-spec, reason.

Explanation: TSM cannot create this directory.

System action: TSM does not create this directory.
User response: Verify that this directory does not
already exist, and that its parent directory has proper
permissions.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

235

ANS9170E

program-name: file-system is not a

mounted local file system.

Explanation: TSM did not find that this file system is

properly mounted.
System action: TSM ignores the file system.
User response: Verify that this file system is local and
mounted and activated properly.
ANS9171E

An error internal to TSM has occurred.

The following string is too long: error.

Explanation: None.
System action: The requested operation does not
complete.
User response: A system reboot might clear up the
problem, after which the operation should be tried
again. If the problem persists, contact IBM technical
support for further assistance.
ANS9172I

Backup system component '' is excluded

from processing.

Explanation: You tried to back up the system

component that was specified to be excluded from
backup.
System action: IBM Tivoli Storage Manager did not
back up the system component.
User response: Verify the input keyword or the writer
name via the command line client and the Exclude lists.
ANS9173I

Backup system component '' doesn't

exist.

Explanation: You tried to back up the system

component that is not installed or is not started.
System action: IBM Tivoli Storage Manager did not
back up the system component.
User response: Verify the input keyword or the writer
name by using the GUI interface to expand the "System
State" or "System Services" node.
ANS9174I

A backup delete completed.

Explanation: A Backup delete was completed.

System action: TSM deleted backup files.
ANS9175E

There is not enough memory for the

backup delete operation

Explanation: TSM cannot allocate memory for the

specified backup delete operation.

try the operation again. Reducing the scope of queries

and the amount of data returned might also help, or
see your system administrator.
ANS9176I

Backup delete is stopped by the user.

Explanation: You requested the backup delete

operation be stopped.
System action: Archive delete stopped.
User response: Continue with normal operations.
ANS9177T

Reconciling local snapshot repository

with TSM server....

Explanation: None.
System action: This message is informational.
User response: None.
ANS9178E

program-name cannot open file file-spec

due to the following error: error.

Explanation: The program indicated in the message

text was unable to open the specified file. The message
text also includes a description of the error that
occurred when it tried to open the file.
System action: The requested operation does not
complete.
User response: Verify that the file system on which
the file resides is mounted, then try the operation
again. A system reboot might clear up the problem. If
the problem persists, contact IBM technical support for
further assistance.
ANS9179W

Database log path is overlapping with

the path for data.value.

Explanation: When log path overlaps database data

path, the logs will be overwritten upon local restore
causing rollforward recovery to fail.
System action: User will be prompted to select "Yes"
to continue the restore operation, or to select "No" to
stop the restore.
User response: User should select "No" to stop the
restore operation and backup the logs to an alternate
location. The restore operation can then be retried. Now
the User can select "Yes" to continue the restore
operation, in which case the logs will be overwritten.
User will have to copy the logs back to the original
location once the restore operation is complete. The
rollforward operation can then be performed
successfully.

System action: TSM cannot continue with the

requested backup delete operation.
User response: Close all unneeded applications and

236

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9180W

An entry in the password file could not

be decrypted.

Explanation: The password failed decryption

validation.
System action: The password in the password file will
be ignored. You will be prompted for the password,
unless the process is running in the background, such
as in scheduling mode.
User response: Enter the password when prompted.
ANS9181I

Current statistics for DB2 restore host

'host': Total number of volumes in
request: volumes Total number of
volumes completed: complet Total
number of volumes in progress: inprogr
Total number of volumes remaining:
remaing Currently processing volumes:
process Total number of bytes in request:
totalda Total number of bytes
transferred: totaltr

Explanation: None.
System action: This message is informational.
User response: None.
ANS9182W

Your customized client nodes list

already contains this node. Would you
like to update it?

Explanation: The list of client nodes contains already

the specified client node. You cannot have two client
nodes with the same client node name in the same
machine.
System action: Updates or does not update the client
node, depending on the user response.

ANS9184E

program-name cannot allocate memory

due to the following error: error.

Explanation: A memory allocation error occurred. The

message text includes a description of the error that
occurred.
System action: The requested operation does not
complete.
User response: Try the operation again. If the problem
occurs in an HSM daemon, restart the daemon, then try
the operation again. If the problem continues to occur,
use your operating system's administrative tools to
check virtual memory (swap space) on your system,
and increase it if necessary. Check whether an
application is consuming available virtual memory. A
system reboot might also clear up the problem. If the
problem persists, contact IBM technical support for
further assistance.
ANS9185W

Master scout daemon is not running!

Explanation: A list of candidates files eligible for

migration cannot be built because the master scout
daemon is not running on the selected client node.
System action: Files are not automatically migrated to
the TSM server.
User response: Restart the master scout daemon
manually using the "dsmscoutd" command from a
command shell on the machine where Space
Management Agent is running.
ANS9186E

program-name: cannot open mounted file

system file-system: error.

Explanation: TSM cannot open mounted file system.

System action: TSM ignores the file system.

User response: Select "yes" to update the client node.

Select "no" to cancel this operation.

User response: Verify that this file system is mounted

and activated properly.

ANS9183W

ANS9187W

Removing Space Management from

'file-system' file system means that all
migrated data will be recalled from
TSM Server 'server-name' Make sure that
enough free space is present on this file
system for the recalled data. Do you
want to remove Space Management
from 'client-node' now?

Explanation: Removing Space Management from the

selected file system means that all migrated data will
be recalled from the server.
System action: Prompts the user to confirm when
removing Space Management from the selected file
system.

Monitor daemon is not running!

Explanation: Files cannot be automatically migrated to

the TSM server or recalled from TSM server because
the monitor daemon is not running on the selected
client node.
System action: Files are not automatically migrated or
recalled from the TSM server.
User response: Restart the monitor daemon manually
using the "dsmmonitord" command from a command
shell on the machine where Space Management Agent
is running.

User response: Make sure that enough free space is

present on this file system for the recalled data.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

237

ANS9188E

Not enough memory for recall operation

ANS9195W

Explanation: TSM cannot allocate storage for the

requested recall operation.
System action: TSM cannot complete the requested
operation.
User response: Retry the recall operation. If the
problem continues, check with your system
administrator.
ANS9189I

Recall stopped by user

Explanation: You initiated a migration operation while

a selective recall is in progress.
System action: TSM ignores the request.
User response: Wait until the selective recall is
complete and retry the migration operation.
ANS9196W

Explanation: You requested that TSM stop the recall

operation.
System action: Recall stopped.
User response: Continue with normal operations.
ANS9191E

Error checking file system state

Explanation: The system cannot open /dev/dsm or

cannot open the file system.

A selective recall is in progress. Wait

until it completes and retry the
migration.

The PASSWORDACCESS option in

your dsm.sys file is not set to
GENERATE. Reset it to GENERATE and
restart the HSM client.

Explanation: The PASSWORDACCESS option in your

dsm.sys file is set to PROMPT. It must be set to
GENERATE in order for automatic space management
services to work.
System action: TSM terminates the client.

System action: Transaction stopped.

User response: The root user must set the

PASSWORDACCESS option to GENERATE in the
dsm.sys file.

User response: Retry the operation. If the problem

continues, check with your system administrator.

ANS9197E

ANS9192I

Cannot disable file-system.

Explanation: TSM cannot disable the file system. This

message is issued only from the Motif HSM GUI,
which is no longer supported.

File: file-name has already been recalled.

Explanation: You tried to recall the a file that has

already been recalled.
System action: TSM does not highlight the file.
User response: None.

System action: TSM ignores the request.

User response: Use the dsm Unix shell commands.

ANS9198E

File: file-name is a resident file.

Explanation: You tried to recall a file that is resident.

ANS9193I

Cannot open file-system.

Explanation: TSM cannot open the file system. This

message is issued only from the Motif HSM GUI,
which is no longer supported.
System action: TSM ignores the request.
User response: Use the dsm Unix shell commands.

System action: TSM will not highlight the file.

User response: None.
ANS9199S

Cannot open /dev/fsm

Explanation: TSM cannot open the space management

device file, /dev/fsm.
System action: TSM cannot complete the operation.

ANS9194W

A selective migration is in progress.

Wait until it completes and retry the
recall.

Explanation: You tried a recall operation while a

selective migration is in progress.
System action: TSM ignores the request.
User response: Wait until the selective migration is
complete and retry the recall operation.

User response: Check to see whether TSM is installed

correctly and that the /dev/fsm file exists. Correct the
problem and retry the operation.
ANS9201W

LAN-free path failed.

Explanation: A LAN-free connection could not be

made.
System action: The system will connect to the server
without using the LAN-free path.
User response: Verify your LAN-free setup.

238

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9203E

ENABLELANFREE can not be used

when HSM is installed.

Explanation: The TSM Client has detected that HSM

is installed on the system. LAN-free is not a valid
option when HSM is installed.
v This error occurs on AIX when this file is found:
/usr/tivoli/tsm/client/hsm/bin/dsmrecalld
v This error occurs on Solaris when this file is found:
/opt/tivoli/tsm/client/hsm/bin/dsmrecalld
System action: An invalid option is detected and
processing stops.
User response: Remove the ENABLELANFREE option
from the system option file. ENABLELANFREE can
only be used when HSM is not installed.
ANS9206W

User quota is reached!

Explanation: The maximum amount of data that can

be migrated and premigrated from this file system to
the TSM Server is reached.
System action: Files cannot be migrated to TSM
server.
User response: Use the File System Properties dialog
to specify a different quota value.
ANS9220W

Communication error detected in the

migration phase of this process!

Explanation: An unexpected error is occurred due to

server communication error in migration phase.
System action: TSM will not migrate files from this
file system.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS9231E

Processing error detected in the

migration phase of this process!

Explanation: An unexpected error is occurred due to

some processing communication error.
System action: TSM will not migrate or premigrate
files from this file system.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.

Recall daemon is not running!

Explanation: Files cannot be recalled from TSM server

because the recall daemon is not running on the
selected client node.
System action: Files are not recalled from the TSM
server.
User response: Restart the recall daemon manually
using the "dsmrecalld" command by a command shell
on the machine where Space Management Agent is
running.
ANS9227E

ANS9230E

Internal error loading the status:

error-message

Explanation: An exception has been detected loading

the status of space management activities.
System action: The status of the related activity is not
loaded. The process continues to load the status at the
next refresh interval.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.

ANS9233E

Processing error detected in the

premigration phase of this process!

Explanation: An unexpected error is occurred due to

some processing communication error in the
premigration phase.
System action: TSM will not premigrate files from this
file system.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
ANS9236E

Error detected performing reconciliation

on this file system!

Explanation: An error is occurred performing

reconciliation on the selected file system.
System action: TSM will not reconcile this file system
with TSM server.
User response: Check the dsmsm.log file in the
installation directory of your local machine and the
$DSM_DIR/dsmerror.log file on the client node
machine if present. If this does not identify the cause of
the problem, contact your system administrator and/or
TSM technical support for further assistance.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

239

ANS9240W

Could not acquire the serial number of

disk 'disk-name' at LUN LUN-id.

Explanation: TSM was not able to determine the serial

number of the specified disk. The disk may not support
SCSI inquiries of the Vital Product Data on page 0x80.
System action: Server-free data movement will not be
possible for data residing on the specified disk.

explicit include/exclude directives to allow for

exclusion of HSM control files and directories. Ensure
that all HSM file systems are mounted.
ANS9256E

File 'file-namefile-namefile-name' is
currently opened by another process.
File skipped.

User response: None.

Explanation: The specified file-name was not migrated

because the file was open by one or more other
processes.

ANS9249E

System action: TSM left the file resident.

File 'file-namefile-namefile-name' accessed

during migration. File skipped.

Explanation: The specified file-name was not migrated

because the file was accessed by another process during
the attempt to migrate it.
System action: TSM left the file resident.
User response: If you want the file migrated, stop the
process which is accessing the file and retry the
migration.
ANS9250I

File system 'file-system' reconciliation

completed.

Explanation: TSM has finished reconciling the file

system.

User response: If you want the file migrated, stop the

processes which currently have the file open and retry
the migration.
ANS9257E

Server 'server-name' does not support

space management.

Explanation: The specified server-name does not

support space management. It is a downlevel server, or
a platform that does not support space management.
System action: TSM failed the operation.
User response: If you want to use the space
management function, make sure you connect to a
server that supports space management.

System action: TSM continues.

User response: Continue with normal operations.
ANS9251E

ProgramName: Cannot parse

command-line options correctly.

Explanation: An internal program error occurred

trying to parse the command-line arguments.
System action: The program is not able to process the
request.
User response: Use the -h or -help option to see what
options are allowed on the command-line, then retry
the request.
ANS9252I

Value of environment variable: envVar.

Explanation: None.
System action: This message is informational.
User response: None.
ANS9254E

An error was encountered while adding

implicit excludes to the include-exclude
list.

Explanation: None.

ANS9263W

You cannot restore both active and

inactive versions of System State.

Explanation: Restoring an active copy and inactive

copy of System State is not allowed.
System action: No processing takes place.
User response: Select either the active copy or the
inactive copy to perform restore operation.
ANS9264E

Incremental backup of Virtual Machine

'vmname' failed with RC rc

Explanation: The incremental backup of virtual

machine volumes failed.
System action: The backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS9265E

Failure mounting Virtual Machine

'vmname' with vcbMounter command.
RC=rc

System action: TSM cannot proceed.

Explanation: The VMware vcbmount command failed

to mount virtual machine disk.

User response: If HSM control file exclusion conflicted

with other include/exclude directives, correct the

System action: The backup of the virtual machine can

not continue. The next virtual machine in the vmlist

240

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

will be processed. The output of the vcbMounter

command will show the reason for the failure.

will be processed. The output of the vcbMounter

command will show the reason for the failure.

User response: Issue a vcbMounter command for the

virtual machine to determine the reason for the failure.
Refer to the documentation for that message for more
information.

User response: Issue a vcbMounter command for the

virtual machine to determine the reason for the failure.
Refer to the documentation for that message for more
information.

ANS9266E

ANS9280E

Failure initializing virtual machine

environment. Can not find
vcbMounter.exe command. RC=rc

Explanation: Failure initializing virtual machine

environment. Can not find vcbMounter.exe command.
The VMware Consolidated Backup Framework not
installed or vcbMounter.exe command is not located in
current PATH environment variable.
System action: The backup can not continue. The
output of the vcbMounter command will show the
reason for the failure.
User response: Issue a vcbMounter command for the
virtual machine to determine the reason for the failure.
Refer to the documentation for that message for more
information. The VMware Consolidated Backup
Framework must be installed on the Backup Proxy
machine. The installed location and the vcbMounter.exe
must be located in the PATH environment variable. The
default location is C:\Program Files\VMware\VMware
Consolidated Backup Framework.
ANS9267E

program-name: File system file-system has

exceeded its quota.

Explanation: TSM detects that the file system has

exceeded its quota. No more data can be migrated out
of this file system.
System action: TSM will not migrate files from this
file system.
User response: Recall some files, or ask the system
administrator to increase the quota for this file system.
ANS9278E

Failure processing vmList option. RC=rc

Explanation: Failure processing vmList option.

System action: The backup can not continue.
User response: Check for errors in the vmList option
value. Refer to the documentation for the vmList option
for more information.
ANS9279E

Failure locating Virtual Machine

'vmname' volumes. Failed with RC=rc

'vmname' option must be set when

running this operation.

Explanation: A required option for the command is

missing.
System action: The operation can not continue.
User response: Set the missing option using the
Preference Editor or the command line.
ANS9283K

Tivoli Space Manager is recalling a

migrated file.

Explanation: The space management kernel extension

is attempting to access a file that is not stored locally. If
the file is migrated, TSM is attempting to access it from
an TSM space management server.
System action: TSM waits for the kernel to access the
file.
User response: None.
ANS9284K

File access waiting for migration to

complete.

Explanation: The file being accessed is currently being

migrated. Access to this file must wait until the
migration process is finished.
System action: TSM waits until the file migration is
completed.
User response: None.
ANS9285K

Cannot complete remote file access.

Explanation: The space management kernel extension

cannot complete the remote file access. The file may be
migrated to an TSM migration server. The file cannot
be recalled to the local machine. The server could be
temporarily disabled.
System action: TSM terminates the current operation.
User response: Check to see whether the server has
been disabled by the system administrator, then retry
the operation.

Explanation: Virtual machine volumes can not found.

Volume mount points are not available on Backup
Proxy machine.

ANS9286K

File migration has been discontinued.

System action: The backup of the virtual machine can

not continue. The next virtual machine in the vmlist

System action: TSM terminates the current operation.

Explanation: Migration stops because the file is being

migrated by another process.

User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

241

ANS9287E

Invalid or unsupported device.

Explanation: The logical volume device is either

invalid or unsupported. Refer to the documentation for
device type support for image backup.
System action: The logical volume operation is not
performed.
User response: For image backup source or image
restore destination, specify a device of one of the
supported types.
ANS9288W

File: file-name of size file-size is too small

to qualify for migration.

Explanation: The file is smaller than the minimum

size required for migration. A file is considered for
migration only if the file is greater than both of the
following: The stub file size specified for the file system
plus 1 byte The block size defined for the file system.
System action: IBM Tivoli Storage Manager does not
migrate this file because migration does not free
additional space.

dsmmigfs remove.
Also, dsmmigfs remove cannot run while a migration
process is running in the file system.
System action: TSM will not run the program at this
time.
User response: Try running the program later.
ANS9292E

Explanation: TSM cannot access a lock file due to an

error. The lock file provides serialization of certain
programs to prevent conflicting processes from running
at the same time.
System action: TSM will not run the program at this
time.
User response: Check the permissions on the
directories leading up to the lock file and also the
permissions on the program executable.
ANS9293E

User response: None.

ANS9289W

Object: 'dir-name' is skipped for

migration: It is a directory.

Explanation: The object is a directory. Space

management does not migrate directories.
System action: IBM Tivoli Storage Manager does not
migrate this object because it is a directory.
User response: None.
ANS9290W

File: file-name is skipped for migration:

The file type is either unknown or
unsupported.

Explanation: The file either cannot be read, is not a

regular file, or its type is unknown to the HSM client.
The HSM client migrates only regular files and does
not migrate directories, symbolic links, and special files.
System action: IBM Tivoli Storage Manager does not
migrate this file.

program-name: Cannot access lock file

lock-file/lock-filelock-file: error

TSM space management cannot access

ERRORPROG error-program:error

Explanation: TSM encountered an error trying to

access the program specified with the ERRORPROG
option in your client system options file (dsm.sys). This
message will appear only the first time this error
occurs.
System action: TSM cannot send a severe error
message to the specified error message program.
User response: Check to make sure the program exists
and that it accepts standard input when run. It is
usually best if ERRORPROG specifies the fully
qualified file name of the program.
ANS9294I

No files matching 'file-name' were found.

Explanation: You entered a search pattern or file name

that cannot be found in the local file system.
System action: Processing stopped.
User response: Ensure that your search pattern is
correct, or specify a new search string.

User response: None.

ANS9296W
ANS9291E

program-name: A conflicting space

management program is already running
in the file-system file system. Re-run this
program later in this file system.

Explanation: TSM detected another program running

in the file system that cannot run at the same time as
the program your tried to initiate. The following
programs cannot run at the same time for a file system:
dsmreconcile
dsmautomig

242

Performing image backup of the entire

volume for volume name. The
IMAGEGAPSIZE option and used block
image backup is not supported for
non-JFS2 file systems on AIX.

Explanation: None.
System action: The entire volume is backed up.
User response: Refer to the client manual for
additional information regarding the IMAGEGAPSIZE
option and used block image backup.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9297W

File file-name is skipped for migration:

No backup copy found.

Explanation: A management class is assigned to the

file with the attribute MIGREQUIRESBKUP set to YES.
This option requires that there exists a current backup
copy of the file before migration. However, there is no
backup copy found on the migration server. This file is
not migrated. Note: IBM Tivoli Storage Manager checks
only the migration server for a backup copy. If the
migration server and backup server are different
servers, IBM Tivoli Storage Manager does not find a
backup copy of the file.
System action: The file is skipped.
User response: Back up this file on the migration
server, or assign a management class to this file that
does not require a current backup copy. Try the
operation again.

System action: TSM remove processing stops.

User response: Check for error messages that occurred
during the recall process, correct any problems, and
retry the remove process.
ANS9301E

Explanation: The Full VM backup of virtual machine

failed.
System action: The full backup of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS9302E

ANS9298W

File file-name is skipped for migration:

Backup copy found is not current.

Explanation: A management class is assigned to the

file with the attribute MIGREQUIRESBKUP set to YES.
This option requires that there exists a current backup
copy of the file before migration. However, the backup
copy found on the migration server is an old version.
This file is not migrated. Note: IBM Tivoli Storage
Manager checks only the migration server for a backup
copy. If the migration server and backup server are
different servers, there must be a valid backup copy of
the file on the migration server.
System action: The file is skipped.
User response: Back up the current file on the
migration server, or assign a management class to this
file that does not require a current backup copy. Retry
the operation.
ANS9299I

Cannot get the number of migrated files

for file system file-system.

Explanation: Failed to get the number of migrated

files on the file system. The number is stored in the
status file for the file system.
System action: If you are removing space
management from the file system, processing stops.
Space management is not removed.
User response: Run reconciliation to reconcile the file
system. Retry operation.
ANS9300I

Migrated files found in file system

file-system. Check for any error
encountered during recall.

Explanation: Remove space management failed

because there are migrated files in the file system. TSM
was unable to recall any files, or some of the migrated
files may have failed during a recall operation.

Full VM backup of Virtual Machine

'vmname' failed with RC rc

The Restore VM command does not

support VMBACKUPTYPE=FILE data.
VM File level restore must be run from
inside the virtual machine or with the
'asnodename' option.

Explanation: The Restore VM function not supported

for file level data.
System action: The system does not process your
requested action.
User response: Virtual machine File level restore must
be run from inside the virtual machine or with the
asnodename option. To process a full virtual machine
restore, issue the command with
VMBACKUPTYPE=FULLVM.
ANS9303E

Full VM restore of Virtual Machine

'vmname' failed with RC rc

Explanation: The Full VM restore of virtual machine

failed.
System action: The full restore of the virtual machine
finished with failures. The next virtual machine in the
vmlist will be processed. The reason for the failure is
written to the local client error log.
User response: Check the local client error log for
reason for the failure.
ANS9304E

VMware Converter tool not installed on

system.

Explanation: VMware Converter tool install could not

be detected on system.
System action: The full virtual machine image files
have been restored successfully at the specified
location.
User response: No further action is necessary. The full
virtual machine images files can be used by various

Chapter 2. ANS 0001-9999: Client messages, version 6.3

243

tools. VMware Converter tool can be installed on

system.

User response: You must successfully backup a

Hyper-V Virtual Machine before using this command.

ANS9305E

ANS9312S

Invalid Hyper-V VM name 'string'

entered

program-name: Cannot change

owner/group on file: file-name: error

Explanation: You entered a Hyper-V VM name string

that contains incorrect characters or contains wildcard
characters.

Explanation: TSM cannot change the ownership or

group, or both for the specified file. This change is
necessary for space management to run properly.

System action: Processing stopped.

System action: TSM cannot continue processing.

User response: Enter a correct Hyper-V VM name.

User response: Ensure that directory permissions

allow the file owner or group to be changed. Reissue
the command.

ANS9306E

Invalid Hyper-V VM list 'string' entered

Explanation: You entered a Hyper-V VM list string

that contains incorrect characters or contains wildcard
characters.
System action: Processing stopped.
User response: Enter a correct Hyper-V VM list.
ANS9307E

No Hyper-V VM name or VMList

entered

Explanation: No Hyper-V VM name or VMList

parameter was specified.

ANS9313E

program-name: The TMP directory is full.

Explanation: The TMP directory from the operating

system is full.
System action: TSM stops.
User response: Delete some files in the TMP directory
and retry the operation.
ANS9316T

File system 'file-system' undelete

completed.

System action: Processing stopped.

Explanation: TSM has finished undeleting the file

system.

User response: Specify a correct Hyper-V VM name or

VMList parameter.

System action: TSM continues.

User response: Continue with normal operations.

ANS9308E

No match found for the Hyper-V VM

name or VMList 'string' entered

Explanation: No match found for the Hyper-V VM

name or VMList parameter entered.
System action: Processing stopped.
User response: Specify a correct Hyper-V VM name or
VMList parameter.
ANS9309E

Pick option specified but also a value

for the Hyper-V VM name or VMList
'string' entered

ANS9318W

program-name: error encountered while

undeleting file system file-system.

Explanation: TSM encountered an error performing

undelete on the file system.
System action: TSM continues.
User response: Continue with normal operation.
ANS9333E

Unable to re-create 'file-name' as a stub

file due to Unix-system-call() failure;
errno: error; reason: 'error-reason'.

Explanation: You cannot specify the -pick option and

also include a Hyper-V VM name or VMList parameter.

Explanation: TSM was unable to re-create the

specified file as a stub due to an error.

System action: Processing stopped.

System action: The processing continues with the next

file.

User response: Specify the -pick option without a

Hyper-V VM name or VMList parameter.
ANS9311E

No Hyper-V VMs exist on the TSM

server

Explanation: No filespaces representing a Hyper-V

Virtual Machine currently exist on the TSM server.

User response: Please, look into the dsmerror.log for

further error details. If the affected file path doesn't
exist, restore it from your backup (if any) or re-create it
manually, then re-try the operation. Make sure that the
specified file system is TSM space managed, writable
and in consistent state.

System action: Processing stopped.

244

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9334E

Wrong alias 'alias-name' received from

the server.

Explanation: TSM could not build a valid pathname

for a migrated file due to the invalid alias received
from the server.
System action: The processing continues with the next
file.
User response: If possible, perform either an orphan
check reconcile or an inline incremental backup of the
initial file, so that the alias is updated on the server.
Then, retry the operation. Otherwise, contact TSM
support for further investigation and problem
resolution.
ANS9349I

Selective Recall completed

System action: Processing stops.

User response: Check the dsmerror log file for
additional information, and contact the IBM Tivoli
Storage Manager administrator with the information
provided in this message.
ANS9357E

Explanation: The dsmscout process is exclusively

started by the dsmmonitord.
System action: TSM aborts the operation.
User response: None.
ANS9359W

Explanation: The selective recall was completed.

System action: TSM recalled the files.
User response: Continue with normal operations.
ANS9353I

Selective Recall stopped by user.

Explanation: You requested to stop the selective recall

operation.

The dsmscout executable cannot be used

on the user level.

program-name: file-system: high threshold

high-threshold exceeds recommended
maximum max-threshold maximum
percentage.

Explanation: System performance can be impacted.

There can be delays from waiting for demand
migration.
System action: Processing continues.
User response: Set the migration high threshold lower
than the file system capacity.

System action: Selective recall stopped.

User response: Continue with normal operations.
ANS9354E

The node or owner name 'node' specified

in the SET ACCESS command exceeds
the maximum allowed length (64).

Explanation: An invalid node or owner name has

been entered in the SET ACCESS command.
System action: Processing stops.
User response: Enter the SET ACCESS command
using the correct node or owner name.

ANS9360W

program-name: file-system: configured

low-threshold low threshold is below the
recommended minimum floor-percent low
threshold.

Explanation: TSM low threshold is not recommended

to be less than teh minimum space required by this file
system and may result in endless attempts to find
migration candidates. Usage of the file system may be
higher than the recommended minimum of low
threshold on GPFS and Veritas because these types of
file system allocate some space for metadata.
System action: Processing continues.

ANS9355E

VMware vStorage VI Web Service API

reported error message: vstor-api-msg

Explanation: The VMware vStorage VI Web Service

API reported an error with the specified message text.
System action: Processing stops.
User response: Check the dsmerror log file for
additional information, and contact the IBM Tivoli
Storage Manager administrator with the information
provided in this message.
ANS9356E

A VMware vStorage API error was

reported.

Explanation: A VMware vStorage API was reported.

See other messages displayed and logged for additional
information about the problem.

User response: Set the migration low threshold higher

than the recommended-minimum size of the file
system.
ANS9361W

program-name: file-system: the configured

pre-mig premigration is greater than the
difference between the configured
low-threshold low threshold and the
recommended-minimum size of the file
system Min_size.

Explanation: TSM premigration percentage below the

low threshold may not leave sufficient space for the file
system, and can result in endless attempts to find
migration candidates. Usage of the file system may be
higher than the recommended minimum of low
threshold on GPFS and Veritas because these types of
file system allocate some space for metadata.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

245

System action: Processing continues.

ANS9368W

User response: Lower the premigration setting.

ANS9362W

program-name: file-system: MAXFILES

max-files is less than used inodes used
inodes in the file system. MAXFILES
will be set to the minimum possible
value.

Explanation: TSM The specified maxfiles value is

below the number of files already existing in the file
system. The value will be ignored, and CFI will default
to the minimum possible size according to the number
of currently used inodes.

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS9369W

System action: Processing continues.

User response: Increase the value of maxfiles.
ANS9363W

program-name: file-system: MAXFILES

max-files is more than files total available
inodes in the file system. MAXFILES
will be set to the maximum possible
value.

Explanation: TSM The specified maxfiles value is

above the number of available inodes in the file system.
The value will be ignored, and CFI will default to the
maximum size that corresponds to the number of
available inodes.
System action: Processing continues.
User response: Decrease the value of maxfiles.
ANS9364E

Failure initializing virtual machine

environment. Refer to dsmerror.log for
detailed error messages.

Explanation: Failure initializing virtual machine

environment. Refer to dsmerror.log for detailed error
messages.
System action: The backup can not continue.
User response: Refer to dsmerror.log for detailed error
message.
ANS9365E

VMware vStorage API error. TSM

function name : function-name TSM file :
file-name (line-number) API return code :
TSM-rc API error message : function-desc

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.

WARNING: VMware Host Userid

<hostuserid> read from pwd file different
than VMCUSER option value
<vmcuserid>. Using VMCUSER option
value.

WARNING: VMware VirtualCenter or

ESX Server User Password for VMC
Host <host> VMC Userid <userid> set in
options file.

Explanation: None.
System action: Processing stops.
User response: Contact the TSM administrator with
the information provided in this message.
ANS9370W

WARNING: Use Preference Editor or

dsmc SET PASSWORD -type=VM
'VirtualCenter hostname' 'userid'
'password' to save encrypted password.

Explanation: None.
System action: Processing stops.
User response: Use Preference Editor or dsmc SET
PASSWORD -type=VM 'VirtualCenter hostname'
'userid' 'password' to save encrypted password.
ANS9371I

program-name: file-system: The specified

MAXFILES value is 0. The CFI size will
be calculated automatically now.

Explanation: TSM The specified maxfiles value is 0,

which means that the CFI size is managed
automatically now.
System action: TSM continues.
User response: none.
ANS9372E

Unable to create the virtual machine to

be restored due to an invalid host name,
datacenter name, or datastore name.

Explanation: IBM Tivoli Storage Manager was unable

to create the virtual machine to be restored because an
invalid host name, datacenter name, or datastore name
was specified. Check the dsmerror log file for
information on the specific reason for the failure.
System action: Processing stops.
User response: Check the dsmerror log file for
additional information, and contact the IBM Tivoli

246

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Storage Manager administrator with the information

provided in this message.
ANS9373E

VMware vStorage API environment

could not be found.Install the VMware
VDDK and copy VMware runtime
libraries from the VDDK bin directory
to TSM baclient directory.

Explanation: Failure initializing virtual machine

environment.

ANS9377E

No virtual machine is specified on the

string command or the virtual machine
domain list could not be processed.

Explanation: No virtual machine found with name or

specified in domain option.
System action: Processing stops.
User response: Specify a correct VM name or domain
option.

System action: The backup can not continue.

ANS9378E

User response: Make sure the VMware VDDK is

installed and copy VMware runtime libraries from
VDDK bin directory to TSM baclient directory.

Explanation: There was an error while fingerprinting

the data. See the error log for more information.

Unexpected error while fingeprinting

the data

System action: The object is not backed up.

ANS9374E

VMware vStorage virtual storage driver

service is not running or could not be
found.Make sure VMware
'vstor2-mntapi10.sys' service is installed
and running. Install the VMware
VDDK.

Explanation: Failure initializing virtual machine

environment.
System action: The backup can not continue.
User response: Make sure the VMware
'vstor2-mntapi10.sys' service is installed and running.
Install the VMware VDDK. VMware.
ANS9375E

VMware vStorage virtual storage driver

service is not running or could not be
found.Make sure VMware
'vstor2-mntapi10.sys' service is installed
and running. Run the TSM install
selecting the vmwaretools feature or
install the VMware VDDK.

Explanation: Failure initializing virtual machine

environment.

User response: Retry the operation. Retry the

operation without client-side deduplication. If the
problem persists, contact TSM technical support.
ANS9379E

Unexpected error while deduplicating

the data

Explanation: There was an error while deduplicating

the data. See the error log for more information.
System action: The object is not backed up.
User response: Retry the operation. Retry the
operation without client-side deduplication. If the
problem persists, contact TSM technical support.
ANS9380E

No virtual machine found processing

string command.

Explanation: No virtual machine found with name or

specified in domain option.
System action: Processing stopped.
User response: Specify a correct VM name or domain
option.

System action: The backup can not continue.

User response: Make sure the VMware
'vstor2-mntapi10.sys' service is installed and running.
Run the TSM install selecting the vmwaretools or
install the VMware VDDK. VMware.
ANS9376W

Warning: VM Backup domain keyword

'domain-keyword' specified which contains
no virtual machines.

Explanation: None.
System action: Processing stops.
User response: Ensure that the correct domain
keyword value was entered.

ANS9381I

The value set for vmlist option will be

migrated to the new domain option.

Explanation: New option has been set.

System action: Processing continues.
User response: None.
ANS9383E

Required files for VMware vStorage

virtual machine backup could not be
found. Run the TSM install selecting
the vmwaretools feature or install the
VMware VDDK.

Explanation: Failure initializing virtual machine

environment.
System action: The backup can not continue.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

247

User response: Run the TSM install selecting the

vmwaretools feature. VMware.
ANS9384W

Unable to get VMware Changed Block

Tracking(CBT) data for virtual machine
'virtual machine name'. Full VM backup
continues, and includes both used and
unused areas of the disk.

Explanation: IBM Tivoli Storage Manager was unable

to obtain Changed Block Tracking(CBT) data for the
specified virtual machine. The backup continues, but
instead of backing up just the used blocks (in the full
VM backup case), or just the changed blocks (in the
incremental VM backup case), the entire virtual
machine is backed up. This backup includes both the
used and unused blocks of the disk.

ANS9387W

Explanation: IBM Tivoli Storage Manager was unable

to perform an incremental backup of the specified
virtual machine. The backup continues, but a full
backup will be performed instead.
System action: The backup continues.
User response: See the error log dsmerror.log for
information about why the changed block data is not
obtained.
ANS9388E

System action: The backup continues.

User response: See the error log dsmerror.log for
information about why the changed block data is not
obtained.

Incremental backup unsuccessful for

virtual machine 'virtual machine name'.
Performing Full backup instead.

The management class 'management class

name' specified for. the 'option name'
option is invalid, or does not have a
backup copy group.

Explanation: The management class name for the

specified option does not exist, or it exists but does not
have a valid backup copy group.
System action: Processing stops.

ANS9385W

Error returned from VMware vStorage

API in vSphere API function
__ns2__QueryChangedDiskAreas.
RC=API return code, Detail message: API
message

Explanation: None.

User response: Verify that the specified management

class name is valid, and that it contains a valid backup
copy group.
ANS9389W

System action: CBT processing stops.

User response: Contact the TSM administrator with
the information provided in this message.
ANS9386W

Changed block tracking is not

supported for virtual machine 'virtual
machine name'. A FULL backup of the
disk will be performed and will include
both used and unused areas of the disk.

Explanation: IBM Tivoli Storage Manager was unable

to obtain Changed Block Tracking(CBT) data for the
specified virtual machine because changed block
tracking is not supported. RDM disks in physical
mode, virtual disks attached to shared virtual SCSI bus,
and VMs with hardware version 6 or earlier are not
supported. The backup continues, but instead of
backing up just the used blocks (in the full VM backup
case), or just the changed blocks (in the incremental
VM backup case), the entire virtual machine is backed
up. This backup includes both the used and unused
blocks of the disk.
System action: The backup continues.
User response: See the error log dsmerror.log for
information about why the changed block data is not
obtained.

The DEDUP backup attempt was

unsuccessful for virtual machine 'virtual
machine name'. Retry #retry attempt number
with DEDUP disabled.

Explanation: The attempt to backup the virtual

machine with DEDUP enabled was unsuccessful.
Instead of failing the backup right away, an attempt is
being made to backup the virtual machine with
DEDUP disabled.
System action: Processing continues with DEDUP
disabled.
User response: Check the log files for messages as to
why DEDUP failed. If future attempts to backup using
DEDUP fail, contact your system administator.
ANS9390W

The DEDUP backup attempt was

unsuccessful for virtual machine 'virtual
machine name'. Retry #retry attempt number
with DEDUP still enabled.

Explanation: The attempt to backup the virtual

machine with DEDUP enabled was unsuccessful.
Instead of failing the backup right away, an attempt is
being made to retry the backup of the virtual machine
with DEDUP still enabled.
System action: Processing continues with DEDUP still
enabled.
User response: Check the log files for messages as to
why DEDUP failed. If future attempts to backup using

248

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

DEDUP fail, contact your system administator.

ANS9391W

Linux guest OS with EFI Boot enabled

is not fully supported by TSM VMware
backup. Manual steps may be required
following restore to enable the virtual
machine to power on correctly.

Explanation: A restored Linux guest OS with EFI boot

enabled may not successfully start. Manual steps are
required to successfully boot the guest OS.
System action: Restore processing continues.
User response: Following guest OS restore: remove
and reattach the guest Linux boot disk, select Guest
Boot Option to enter EFI setup configuration on next
boot, power on the guest, enter EFI Boot Maintenance,
add Boot Device, select unnamed volume, give it a
label, save and commit changes, continue with boot.

whether the target daemon is running. Start or restart

the target daemon as appropriate. If the problem
persists, restart the GPFS cluster.
ANS9403E

Explanation: TSM If the GPFS daemon crashes or the

local HSM daemons cannot perform their function for
whatever reason the dsmwatchd will try to migrate the
functionality to another node.
System action: Migrate HSM functionality to another
node.
User response: Check failure node. It may be
necessary to recover the local GPFS daemon.
ANS9404E

ANS9399W

program-name: lock file access error for

operation value on path value value with
errno text value.

Explanation: A lock file operation has failed.

System action: TSM logs the condition and continues
processing, or exits if directory not found.
User response: Correct the configuration.
ANS9400W

program-name: Recovered program-name.

The daemon was either not started or in
corrupted state.

Explanation: TSM HSM daemon breakdown with

automatic recovery by the dsmwatchd.
System action: Restarting the daemon.
User response: Continue with normal operation.
ANS9401E

program-name: Cannot kill recall daemon.

program-name: The local HSM

functionality cannot be recovered.
Trying to initiate failover to another
node.

Error creating the specified Virtual

Machine. See log files for more
information.

Explanation: An error was encountered creating the

Virtual Machine. Look in the dsmerror.log for
additional information on why the Virtual Machine
could not be created.
System action: Processing stops.
User response: Check the dsmerror.log for more
specific messages on why the virtual machine could not
be created.
ANS9405W

program-name: The takeover of filesystem

file system started.

Explanation: The local activation of the specified file

system started successfully.
System action: TSM on the local node will try to
activate the file system that is space managed on
another node.

Explanation: TSM A request for killing the recall

daemon failed. This may occur during node failover.

User response: None.

System action: none.

ANS9412E

User response: Continue with normal operation unless

further errors occur.
ANS9402E

program-name: Cannot notify process name

to recover HSM operations on a failing
node.

Explanation: In order to assume the functionality of a

failing partner node, the dsmwatchd daemon must
notify the local daemons.
System action: none.
User response: Communication cannot be established
with the HSM daemon specified in this message. Check

program-name: Failover is disabled on the

local machine. Aborting failover ...

Explanation: TSM Failover operations were disabled

either by the system or the user.
System action: None.
User response: Check failover policy if necessary.
ANS9413W

program-name: The remote node was able

to recover from failure situation.
Aborting takeover ...

Explanation: The remote dsmwatchd was able to

recover from the failure situation during the local
takeover operation.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

249

System action: None.

ANS9421W

User response: Check failure node for consistency.

ANS9414E

program-name: Unable to create file-name

in the SDR. Aborting ...

Explanation: An update of an SDR object failed.

program-name: Recovered from Lock on

SDR File file-name

Explanation: This output relates to ANS9418W. A

previously blocked SDR file got unlocked.
System action: TSM continues.
User response: None.

System action: Aborting operation.

User response: Check SDR consistency.
ANS9418W

program-name: Cannot access the GPFS

SDR for writing. It might be locked, or
the var filesystem might be full.

Explanation: The GPFS configuration is stored in the

SDR. This file can be accessed as soon as it is possible
to set a certain SDR lock. If a second process holds this
lock, access to the file is denied until the lock is
released. Use the GPFS command - mmcommon
showLocks - to show which process holds the lock
currently.

ANS9422W

Explanation: The local activation of the specified file

system started successfully.
System action: TSM on the local node will try to
activate the file system that is space managed on
another node.
User response: None.
ANS9423E

System action: None.

User response: Wait. If the situation does not get
resolved within a reasonable amount of time (about 1
min.), examine the var file system. If it is full, free up
some space. Otherwise use the command dsmmigfs
SDRreset. This command resets all activated locks in
the SDR for the local GFPS node set.
ANS9419E

program-name:The filesystem
filesystem-name is either already managed
locally or under the control of a remote
HSM instance.

Explanation: A GPFS filesystem can be managed just

once.
System action: Aborting operation.
User response: Execute dsmmigfs query -detail to
have a look at the current HSM configuration within
the local GFPS node set.
ANS9420E

program-name: An update of the

configuration files in the SDR is not
allowed as long as failover is disabled
on the local machine.

Explanation: You cannot update configuration files in

the SDR when failover is disabled on the local machine.
System action: TSM Aborting operation.
User response: Do nothing, or activate failover by
using dsmmigfs enableFailover before running
dsmmigfs SDRupdate.

250

program-name: The rollback of filesystem

file system started.

program-name: Setting the default

partition name failed! Aborting
operation ...

Explanation: The application needs to have access to

the SP Group Services. In this context it tries to extract
the default partition name for the local system as
provided by spget_syspar. The data extraction failed.
System action: Aborting operation.
User response: Check node consistency.
ANS9424E

program-name: It was not possible to

send a message to the SP Group
Services. This is a severe error.

Explanation: The Failover environment requires

proper access to the SP Group Services. The
distribution of a message failed.
System action: Aborting operation.
User response: If the problem persists, verify SP
Group Service is accessible and is not overwhelmed. If
the problem persists, reboot the GPFS cluster.
ANS9425E

program-name: It was not possible to

notify the dsmwatchd in order to
distribute a message within the failover
group. The data of the current operation
may get lost.

Explanation: Some HSM commands need to inform

the dsmwatchd about the current operation. This
notification failed.
System action: Aborting operation.
User response: Restart the GPFS daemon and check
that the DMApi support is active by executing
/usr/lpp/mmfs/bin/mmlsfs deviceName.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9428E

program-name: The takeover of filesystem

file system failed to start.

Explanation: The local activation of the specified file

system failed to start. Please, note that only file systems
which are space managed on another node within the
same cluster can be taken over. Additionally, the file
system must be mounted locally.

System action: Continuing failover or aborting

operation.
User response: Check HSM and SP Group Services
environments. Execute dsmmigfs enableFailover after
resolving the problem.
ANS9450W

System action: TSM will not take over the file system.
User response: Make sure the file system is mounted
locally and managed with the TSM client for space
management on another node within the same cluster
and retry the operation.
ANS9433E

program-name: dm_send_msg failed with

errno Errno.

program-name: No eligible filesystem for

takeover.

Explanation: None of the locally mounted GPFS

filesystems matches with the remotely managed
filesystems of the failure node.
System action: Aborting takeover operation.
User response: Check that the filesystems of the
remote failure node get managed elsewhere within the
node set.

Explanation: Unable to execute DMApi call.

System action: Aborting operation.
User response: Check consistency of the GPFS
daemon.
ANS9442E

program-name: It appears that another

dsmmigfs add/rem/update command is
in process within the local GPFS
nodeset. Please wait a few moments,
then repeat the operation. If a previous
dsmmigfs command was aborted, there
could be a stale lock in the SDR. If so,
run dsmmigfs SDRreset to fix the
problem.

Explanation: There can only be one instance of

dsmmigfs add/rem/update running within a GPFS
nodeset at the same time.
System action: Aborting operation.
User response: Wait for a bit and try again. If no other
instance of dsmmigfs is running within the local GPFS
nodeset run dsmmigfs SDRreset.
ANS9443E

program-name: The operation cannot be

executed in a deactivated failover
environment.

Explanation: The operation relies on an active failover

environment.
System action: Aborting operation.
User response: Run dsmmigfs enableFailover on the
local node and repeat the operation.
ANS9449W

program-name: Forced deactivation of the

local failover environment!

Explanation: TSM Failover was initiated or a problem

with the group services occurred.

ANS9451E

program-name: GPFS or the SP switch is

down locally. Aborting takeover
activities ...

Explanation: TSM GPFS is not functional locally.

System action: Aborting takeover operation.
User response: Check switch and VSD status. The
local system must be unfenced.
ANS9452E

program-name: The DMApi is not

functional locally. Aborting takeover
activities ...

Explanation: The operation stopped because the

DMApi interface is not accessible.
System action: Aborting takeover operation.
User response: Check GPFS status.
ANS9453E

program-name: Could not determine the

GPFS storage pool id for file 'file-path'.
Reason: reason

Explanation: The processed file does not exist or is

located on a file system without storage pool support.
System action: The requested operation stops.
User response: Please check the input parameters and
if DMAPI is enabled on the file system.
ANS9454W

program-name: Performing
synchronization between the local and
global file event handling.

Explanation: The local node received a request from a

remote node to synchronize with the global file event
handling (DMApi event disposition).
System action: Synchronization proceeds.
User response: None.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

251

ANS9455E

program-name: Unable to join the local

failover group with rc=return-code!

ANS9462E

Failover functionality is not supported

with this HSM release.

Explanation: SP Group services reported a problem

accessing/creating an HSM group.

Explanation: The TSM user ran dsmmigfs with the

failover flag on an unsupported platform.

System action: Aborting operation.

System action: TSM ends the operation.

User response: Check PSSP environment on the local

node.

User response: None.

ANS9469E

ANS9457E

program-name: Could not determine the

storage pools of file system 'file-system'.
Reason: reason

Explanation: The specified file system is not a GPFS

file system or has an old GPFS version.
System action: The requested operation stops.
User response: Please update to a supported version
of GPFS.
ANS9458I

program-name: Responsiveness Service

successfully started.

Warning! Unable to write a complete

migration candidate list due to low
space in the parent filesystem of name.

Explanation: TSM Low space in filesystem which

stores the migration candidates files.
System action: TSM The executable writes a partial
migration candidates list.
User response: Increase the filesystem size or create a
dedicated filesystem with sufficient size under the
given path.
ANS9472I

program-name: Updating failover

information for Node ID: node

Explanation: Starting and joining the Responsiveness

Service to monitor other nodes for failover was
successful. The node will now try to establish a
connection to the service of other nodes.

Explanation: Failover status information for remote

node was updated.

System action: Processing continues.

ANS9474E

User response: None.

program-name: Lost my session with

errno: errno . Trying to recover.

Explanation: The DMAPI session is not valid.

ANS9459E

Using the specified MAXCANDIDATES

parameter would produce an
out-of-space condition in the parent
filesystem of /etc/adsm/SpaceMan/
candidatesPool. Based on the current
free space situation the maximum value
for the MAXCANDIDATES parameter is
value.

Explanation: TSM The automigration candidate pools

for the selected filesystem require MAXCANDIDATES/
10 KB plus a safety buffer of 5 MB of memory under
/etc/adsm/SpaceMan/candidatesPool, which exceeds
the available space.
System action: TSM Abort operation.
User response: Increase the filesystem size or choose a
smaller value for the MAXCANDIDATES parameter.
You may also create a dedicated filesystem with
sufficient space for the migration pools under
/etc/adsm/SpaceMan/candidatesPool. Kill the
dsmscout processes after performing this option.

252

System action: Trying to recover session.

User response: Check the failure node. You might
have to recover the local GPFS daemon.
ANS9476I

program-name: Recovered my DM session

sid.

Explanation: DMAPI session is recovered.

ANS9480E

program-name: The rollback of filesystem

file system failed to start.

Explanation: The local activation of the specified file

system failed to start. Please, note that a rollback can
only be performed after the space management of the
file system was moved from the local node to another
node during failover. Additionally, the file system must
be mounted locally.
System action: TSM will not roll back the file system.
User response: Make sure the file system is mounted
locally and managed with the TSM client for space
management on another node within the same cluster
and retry the operation.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9500W

program-name: cannot disposition the

mount event. Reason: error

ANS9504W

program-name: The file system

filesystem-name is not mounted or is
mounted with wrong options.

Explanation: The system wide mount event could not

be dispositioned. Mount events will not be received by
this daemon.

Explanation: Either the file system is not mounted or

it has been mounted with incorrect options.

System action: TSM continues.

System action: TSM continues.

User response: Try to resolve the problem and restart

the recall daemon. If the problem cannot be resolved
immediately, kill and restart the recall daemon after an
TSM space management supported file system has been
added using dsmmigfs or after a file system has been
mounted using the mount command.

User response: Mount the file system or remount it

with corrected mount options.

ANS9501W

program-name: cannot set event

disposition on session session for file
system mountdir token = token. Reason :
error

Explanation: Events could not be dispositioned on the

file system. No events will be received for this
filesystem. HSM is not enabled for this file system.
System action: TSM continues.
User response: The file system must be one of the
supported native file systems in order for the TSM
space management to support it. Verify that the mount
options the file system are correct. Correct the problem
and remount the file system.
ANS9502W

program-name: cannot remove event

disposition on session session for file
system mountdir token = token. Reason :
error

Explanation: Event dispositions could not be removed

from the file system.
System action: TSM continues.
User response: Verify that the file system is mounted
and that dmapi is enabled on that file system. If the
problem persists, unmount and remount the file
system, then try the operation again. If the problem still
persists, reboot the system.
ANS9503I

program-name: events have been set and

dispositioned on session session for file
system filesystem-name

Explanation: Setting events and dispositioning these

on a DM session enables the file system for TSM space
management support.

ANS9505E

program-name: cannot initialize the

DMAPI interface. Reason: error

Explanation: TSM client failed to perform

implementation-defined initialization of the DMAPI
interface.
System action: The dm_init_service() function failed.
User response: If you are running TSM as a non-root
user and you have TSM space management client
installed, please, make sure that the dsmrootd daemon
is up and running, then retry the operation. If you
don't have TSM space management client installed,
retry the operation under the root user authority.
ANS9506E

program-name: The provided filespace

argument 'argument' has an invalid
format.

Explanation: Occurs if you are on a GPFS file system

and the file system parameter was not in the correct
format.
System action: The requested operation stops.
User response: See the dsmautomig documentation
for the correct syntax.
ANS9507E

program-name: cannot request the right

on session session for file handle
filehandle token = token. Reason : error

Explanation: TSM space management cannot request

the required right on a file.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9508W

program-name: cannot release the right on

session session for file handle = filehandle
token = token. Reason : error

System action: TSM continues.

Explanation: TSM space management cannot release

the right on a file.

User response: Continue with normal operation.

System action: Processing of the file is interrupted.

User response: Continue with normal operation.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

253

ANS9509W

program-name: received an unexpected

event of type event-type on session
session.

Explanation: TSM space management daemon

received an unexpected event. This event has not been
dispositioned.
System action: TSM ignores event and continues.
User response: Continue with normal operation.
ANS9510E

program-name: cannot get event messages

from session session, expected max
message-length = msglen, returned
message-length = return-length. Reason :
error

Explanation: TSM space management encountered an

error while trying to receive a message on a DM
session.
System action: TSM continues.

ANS9514E

Explanation: TSM space management cannot create a

file handle from the given file.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9515E

program-name: cannot read DM attributes

on session session for file: name = name
handle = handle token = token. Reason :
error

Explanation: TSM space management cannot read the

DM attributes of a DM object, usually a file. If the file
name is not available, it will be displayed as an empty
string or as <NA>.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9512E

program-name: cannot set DM attributes

on session session for file handle =
filehandle token = token. Reason : error

Explanation: TSM space management cannot set DM

attributes for a DM object, usually a file.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9513E

program-name: cannot remove DM

attributes on session session for file
handle = filehandle token = token. Reason
: error

Explanation: TSM space management cannot remove

DM attributes for a DM object, usually a file.

program-name: cannot set the migration

information. Reason: error

Explanation: TSM space management cannot set the

migration information of a file, because space
management cannot create a file handle from the file
and/or from the file system.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9516E

User response: Continue with normal operation.

ANS9511E

program-name: cannot create a file handle

from path. Reason: error

program-name: cannot create an user

event message on session session.
Reason: error

Explanation: TSM space management cannot create an

user event message, needed to reference rights on a file
to be processed.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
ANS9517I

program-name: cleared event messages

from session session. Reason: error

Explanation: TSM space management is in the process

of destroying a DM session. There are still unexpected
event messages on this session that were responded to.
System action: TSM DM session is not destroyed.
User response: This message is informational. If the
session could not be destroyed, try the operation again.
If the problem persists, reboot the system.
ANS9518E

program-name: cannot respond to an

event message on session session using
token token Reason : error

Explanation: An event message could not be

responded to (returned to the system).
System action: TSM space management continues.
User response: If a user process is unexpectedly
blocked and cannot be killed, see your system
administrator.

System action: Processing of the file is interrupted.

User response: Continue with normal operation.

254

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9519W

program-name: cannot set eventlist for a

file system on session session token =
token fs-handle = fs-handle. Reason : error

Explanation: An eventlist could not be set on a file

system. None of the events will be generated by the
system on this file system.
System action: TSM space management continues.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, reboot the
system.
ANS9520E

program-name: cannot set a managed

region on session session for file handle
= filehandle token = token. Reason : error

Explanation: A managed region could not be set on a

file. No events will be generated for this file.

Explanation: A correct stub size could not be

determined by the system.
System action: TSM stops migration of the file.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9524W

program-name: adjusted stubsize to an

allowed value on session session file
handle = filehandle token = token old
stubsize = old-size new stubsize =
new-size

Explanation: The predefined stubsize for the file was

not valid. The system corrected the stubsize.
System action: TSM space management continues.
User response: Continue with normal operation.

System action: Processing of the file is interrupted.

User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, reboot the
system.
ANS9521E

program-name: cannot get the file

attributes on session session for file
handle = handle token = token. Reason :
error

ANS9525E

program-name: is unable to create a stub

file on session session for file handle =
handle token = token. Reason : error

Explanation: An error occurred while creating a stub

file.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.
program-name: cannot open the state file
filename for writing. Reason: error

Explanation: TSM space management cannot read the

attributes of a file.

ANS9526E

System action: Processing of the file is interrupted.

Explanation: The global or file system state file could

not be opened.

User response: Try the operation again. If the problem

persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, reboot the
system.
ANS9522E

program-name: can not create a file

system handle from path. Reason: error

Explanation: TSM can not create a file system handle

from the file system name. If Reason is Operation not
permitted, the dmapi functionality may be disabled for
the file system.
System action: Processing of the file system is
interrupted.
User response: If Reason is Operation not permitted,
enable dmapi functionality for the file system and retry.
ANS9523E

System action: TSM stops processing.

User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9527E

program-name: cannot write to the state

file filename. Reason: error

Explanation: TSM space management could not write

to the state file.
System action: TSM stops processing.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.

program-name: is unable to verify the

stub size for the file on session session
file handle = filehandle token = token.
Reason : error

Chapter 2. ANS 0001-9999: Client messages, version 6.3

255

ANS9528W

program-name: cannot read from the state

file filename.. The file is corrupted and
will be recreated.

Explanation: TSM space management could not read

from the state file.
System action: TSM stops processing.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.

ANS9532W

Explanation: TSM space management could not

destroy a DM session.
System action: TSM continues.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9533W

ANS9529W

program-name: cannot obtain the handle

of a file system state file

Explanation: TSM space management could not find

the handle of a file system state file that is stored in the
global state file. This can occur if either space
management is querying a file system that has no HSM
support added, or the file system state file is corrupted,
or the global state file is corrupted.
System action: TSM continues or stops processing,
depending on the situation.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.

program-name: cannot destroy the session

session. Reason: error

program-name: failed getting all sessions.

Reason: error

Explanation: TSM space management could not get all

DM sessions on the system.
System action: TSM stops processing.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9534W

program-name: cannot query a session.

Reason: error

Explanation: TSM space management could not query

a DM session on the system.
System action: TSM continues.

ANS9530W

program-name: cannot remove an entry

for file-system from the global state file.

Explanation: The entry for the file system in the

dmiFSGlobalState file cannot be removed. Possible
reasons:
v There is not enough memory to create temporary file
name for temporary file system table.
v There is not enough free space or inodes to create
temporary file system table
v The real or temporary file system table files cannot
be opened.
System action: TSM does not remove the entry from
the global state file.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9531E

program-name: cannot create a DM

session: old session = oldsession session
info = session-info. Reason : error

Explanation: TSM space management could not create

a DM session.

User response: Continue with normal operation.

ANS9535E

program-name: a file handle could not be

created from the file descriptor
file-descriptor. Reason: error

Explanation: TSM space management could not create

a file handle.
System action: Processing of the file is interrupted.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9536E

program-name: cannot query an event

message on session session. Reason: error

Explanation: TSM space management cannot query an

event message, needed to determine whether nfs call.
System action: Processing of the file is interrupted.
User response: Continue with normal operation.

System action: TSM stops processing.

User response: Try the operation again. If the problem
persists restart the system.

256

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9537E

program-name: Invalid storage pool

'storagepool' for file system 'filesystem'.

Explanation: No storage pool with that name exists on

the specified file system.
System action: The requested operation stops.
User response: Please make sure the storage pool
exists on the specified file system.
ANS9538W

program-name: request request for DM file

attributes not recognized

Explanation: An unknown request type has been

encountered that cannot be handled.
System action: TSM continues.
User response: Continue with normal operation.
ANS9539E

program-name: cannot create a file system

handle from the file handle = filehandle.
Reason : error

Explanation: A file system handle could not be

created from a file handle.
System action: TSM continues.
User response: Continue with normal operation.
ANS9542E

program-name: the file attributes could

not be set on session session for file
handle = filehandle token = token flag =
flag Reason : error

Explanation: TSM space management could not

update file attributes.
System action: Processing of the file is interrupted.
User response: Try the operation again. If the problem
persists, verify that the file system is mounted with
dmapi enabled. If the problem still persists, restart the
system.
ANS9543W

program-name: cannot reserve

(blocks-num1) blocks for nospace
condition on file system filesystem-name,
errno: error-num, reason: error-str.
Currently, (blocks-num2) blocks are
available.

Explanation: Either the TSM client is not able to get

status information for the file system or there is
insufficient space in the file system. The message
reports zero blocks if the file system status information
is not available.
System action: TSM continues.
User response: If there is insufficient space in the file
system, free the required space or increase the file
system capacity. If this is due to an input output error,

perform an appropriate file system check. Then, retry

the operation.
ANS9545E

program-name: cannot get a lock for

lockdirlockfile to continue processing.

Explanation: TSM space management could not obtain

a lock for a file.
System action: processing stops.
User response: Try the operation again. If problem
persists, restart HSM. If problem still persists, restart
the system.
ANS9548W

Cannot complete remote file access.

Explanation: TSM space management cannot complete

the remote file access. The file may be migrated to an
TSM migration server. The file cannot be recalled to the
local machine. The server could be temporarily
disabled.
System action: TSM terminates the current operation.
User response: Check to see whether the server has
been disabled by the system administrator, then retry
the operation.
ANS9550W

File recall has been discontinued.

Explanation: Recall stops because the file being

recalled would cause the file system to run out of
space.
System action: TSM terminates the current operation.
User response: Increase the file system space, or
remove unneeded files, or wait until space
management has migrated files off the file system by
demand or threshold migration, or manually migrate
files. Then retry the operation.
ANS9552E

program-name: cannot add space

management to file-system; path includes
non-local file system.

Explanation: An attempt was made to add space

management to a file system whose path contains
non-local elements.
System action: Processing stopped.
User response: File system must be entirely local.
ANS9553I

Wrote temporary candidates list to

file-name.

Explanation: Due to out of space condition, the

candidates list was written to the named temporary
file.
System action: Temporary file created.
User response: Temporary file can be copied to the
Chapter 2. ANS 0001-9999: Client messages, version 6.3

257

appropriate .SpaceMan directory when space is made

available.
ANS9554E

program-name: command for file system

mountdir Reason : error

Explanation: An attempt to enable or disable xdsm

api functionality on the file system failed. If the attempt
was to enable HSM, then HSM is not enabled for this
file system.

ANS9591E

A SOAP UDP connection error has

happened!

Explanation: The SOAP communication system had

an UDP error. Please see errorlog file for more detailed
information!
System action: TSM aborts the operation.
User response: None.

System action: TSM continues.

ANS9592E

User response: The file system must be of type JFS2 in

order for the TSM Space Management to successfully
set the managed attribute. Verify that the file system is
of the correct type.

Explanation: The SOAP communication system had

an TCP error. Please see errorlog file for more detailed
information!

A SOAP TCP connection error has

happened!

System action: TSM aborts the operation.

ANS9576E

Not enough space in filesystem to create

meta data file!At least space space
required!

Explanation: A disk full error occurred attempting to

create the metadata file. Please migrate some files in
filesystem to free at least space kb.
System action: Processing stops.
User response: None.
ANS9577E

An exception "msg"!Unable to use meta

file!

Explanation: An internal error occurred. The dsmscout

is unable to use the meta data file!
System action: Processing stops.
User response: None.
ANS9578E

An unknown error occurred!

Explanation: An internal error has occurred. The

dsmscout is unable to use the meta data file! The file
has been deleted. A new meta data file will be created.
System action: Processing stops.
User response: None.

User response: None.

ANS9593E

A SOAP HTTP communication error has

happened!

Explanation: The SOAP communication system had

an HTTP error. Please see errorlog file for more
detailed information!
System action: TSM aborts the operation.
User response: None.
ANS9594E

An internal SOAP error has happend!

Explanation: The SOAP communication system had

an internal error. Please see errorlog file for more
detailed information!
System action: TSM aborts the operation.
User response: None.
ANS9595E

The SOAP communication system is out

of memory!

Explanation: The SOAP communication system had

an memory error. Please see errorlog file for more
detailed information!
System action: TSM aborts the operation.

ANS9590E

The SOAP error information: message

failed, reason: message

Explanation: The detailed SOAP error message is

created from gSOAP communication module and does
not exist in the chosen language!
System action: TSM continues.
User response: Verify your system and retry the
operation.

User response: None.

ANS9596E

The SOAP communication ended

unexpected!

Explanation: The SOAP communication system had

an EOF error. Please see errorlog file for more detailed
information!
System action: TSM aborts the operation.
User response: None.

258

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9613E

program-name: Stub size of stubsize bytes

is not supported on filesystem.

Explanation: The given stub size value not a multiple

of the file system block size and cannot be supported.
System action: The program aborts the operation.
User response: Use a correct stub size.
ANS9641S

Invalid option 'option' found in options

file 'file-name' at line number : number
Invalid entry : 'entry'

Explanation: The specified option in the TSM options

file (file-name) is in error.
System action: Processing stopped.
User response: Correct the options file entry.
ANS9669W

program-name: file-system CFI is out of

range.

Explanation: TSM CFI is out of range on the specified

file system. The scout daemon could not insert a new
file entry into the CFI during the file system scan. As a
result, it may not provide enough candidates for the
next automigration.
System action: Processing continues.
User response: Please, reconsider the MAXFILES
option setting for the file system. The CFI size should
likely be increased via 'dsmmigfs update /fs
-MAXFiles=n' command.
ANS9732E

No Backup Copy Group for

Management Class: management-class

Explanation: The management class for this file does

not have a backup copy group specified. This message
is issued only from the Motif HSM GUI, which is no
longer supported.
System action: processing stops.
User response: Use the HSM Unix shell commands
instead.
ANS9733E

File: File-name excluded by the

Include/Exclude list

Explanation: You tried to back up the named file-name

that was specified to be excluded from backup.
System action: TSM did not back up the file.
User response: Specify the file using the Include
option and retry the operation.

ANS9734E

There are number file(s) not selected.

Click on file to find out reason.

Explanation: There are files that cannot be selected.

System action: These files will not be selected for
migrate or recall.
User response: Click on the files to find out the reason
these files are not selected, for example, inclexcl list.
ANS9735E

Error doing realtime initialization

Explanation: TSM ran out of resource (either processes

or shared storage) that prevents it from starting a
migrate or recall operation. Your file selections remain
intact. This message is issued only from the Motif HSM
GUI, which is no longer supported.
System action: TSM cannot start the migrate or recall
operation.
User response: Use the HSM Unix shell commands
instead.
ANS9736E

Not enough memory for authorization

list table

Explanation: TSM cannot allocate enough storage for

the authorization list. This message is issued only from
the Motif HSM GUI, which is no longer supported.
System action: TSM cannot complete the requested
operation.
User response: Use the HSM Unix shell commands
instead.
ANS9737E

Authentication failed -- Exit TSM to

retry

Explanation: You typed an incorrect password four

times in a row. This message is issued only from the
Motif HSM GUI, which is no longer supported.
System action: TSM cannot connect to the server
without a correct password.
User response: Use the HSM Unix shell commands
instead.
ANS9738S

Out of memory

Explanation: TSM found an error allocating storage at

initialization. This message is issued only from the
Motif HSM GUI, which is no longer supported.
System action: TSM cannot continue.
User response: Use the HSM Unix shell commands
instead.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

259

ANS9739E

Cannot get shared memory

ANS9743W

No files selected in directory tree

Explanation: The system ran out of shared storage

resources.

Explanation: You did not select any files to list for

migrate or recall.

System action: TSM cannot continue without a shared

storage segment.

System action: TSM cannot complete the requested

operation.

User response: Check the output of the ipcs

program to see if there are many new shared storage
segments. Use ipcrm to remove them. If this problem
continues, configure UNIX to allow more shared
storage segments.

User response: Select files and retry the operation.

ANS9740S

This program is not installed correctly.

Place the application defaults file
(file-name) into the application default
directory (usually directory-name), or set
the XAPPLRESDIR environment
variable to the directory containing the
file-name defaults file.

Explanation: TSM cannot find its resource file (Sm) in

the default directory (directory-name). A problem may
have occurred during installation. This message is
issued only from the Motif HSM GUI, which is no
longer supported.
System action: TSM cannot start.
User response: Use the HSM Unix shell commands
instead.
ANS9741E

Not enough memory to hold directory

structure

ANS9744W

Size exceeds limit

Explanation: You tried to recall a file that has

exceeded the maximum file size limitation on your
system.
System action: TSM cannot recall the file.
User response: Recall this file on a system that
supports the file size. See your system administrator.
ANS9778E

Error(s) were detected in options file: ''

Do you want TSM to comment out the
line with errors and continue?

Explanation: Invalid options or option values were

encountered while reading the options file.
System action: This message is displayed. Further
action depends on your response.
User response: Click "Yes" to allow TSM to turn the
invalid line into comments. If you click "No", you will
exit immediately.
ANS9779E

Unable to open options file '' for

writing.

Explanation: TSM cannot allocate storage for the

requested directory structure. This error can happen
under migrate or recall operations. This message is
issued only from the Motif HSM GUI, which is no
longer supported.

Explanation: An error occurred while TSM tried to

open options file for writing to update it.

System action: TSM cannot complete the requested

operation.

User response: Check file and directory access

permissions or correct invalid entries in your options
file manually.

User response: Use the HSM Unix shell commands

instead.
ANS9742E

Error reading directory structure

Explanation: TSM cannot load the requested directory

structure. This error is due to a corrupted file system or
a storage shortage. This can happen under selective
migrate or selective recall. This message is issued only
from the Motif HSM GUI, which is no longer
supported.
System action: TSM cannot complete the requested
operation.
User response: Use the HSM Unix shell commands
instead.

260

System action: Program exits.

ANS9780E

Unable to update options file ''.

Explanation: TSM was unable to update your options

file, possibly because of disk full condition.
System action: Program exits.
User response: Check if you have enough disk space
or correct invalid entries in your options file manually.
ANS9781E

After completing repair TSM found an

invalid option, keyword or parameter in
your options file.

Explanation: A final check of your options file found

that an invalid option, keyword, or parameter still
remains. It is possible your options file was modified
by another application.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Program exits.

User response: Make sure no other application
modified your options file and restart TSM. You may
also use a text editor to correct invalid entries in your
options file.
ANS9782S

The selected backupset was generated

by a newer version of the backup server,
and the new backupset version is not
supported by this client; The backupset
data cannot be restored by this version
of the client.

Explanation: The backupset you are attempting to

restore was generated by a newer server that has a
different level of functionality. The client you are using
does not recognize this newer format so it cannot
restore the data from the backupset.
System action: Processing stopped.
User response: Restore the backupset with a client
that is at the same or higher level as the server that
was used to generate the backupset.
ANS9790I

File is skipped for migration: No

backup copy found.

Explanation: A management class is assigned to the

file with the attribute MIGREQUIRESBKUP set to YES.
This requires a current backup copy of the file before
migration. However, there is no backup copy found on
the migration server. This file will not be migrated.
Note: TSM checks only the migration server for a
backup copy. If the migration server and backup server
are different servers, TSM does not find a backup copy
of the file.
System action: TSM does not migrate this file.
User response: Back up this file on the migration
server, or assign a management class to this file that
does not require a current backup copy. Retry the
operation.
ANS9791I

File is skipped for migration: Backup

copy found is not current.

file that does not require a current backup copy. Retry

the operation.
ANS9792W

A tree view of a file system is being

built. Please wait until it completes, and
then retry the operation.

Explanation: You tried to choose Selective Migration

or Selective Recall when a tree view of a file system is
being built.
System action: TSM ignores the request.
User response: Wait until the tree view build
completes, and then retry the operation.
ANS9796E

Cannot access lock file for file-system file

system.

Explanation: TSM cannot access a lock file due to an

error. The lock file provides serialization of certain
programs to prevent conflicting processes from running
at the same time.
System action: TSM will not run the program at this
time.
User response: Check the permissions on the
directories leading up to the lock file and also the
permissions on the program executable.
ANS9797E

A conflicting space management process

is already running in the file-system file
system. Rerun this process at a later
time.

Explanation: TSM detects that another process that

conflicts with the process you are trying to run is
running in the file system. The following processes
cannot be run at the same time for a file system:
dsmreconcile
dsmautomig
dsmmigfs remove.
Also dsmmigfs remove cannot run while a migration
process is running in the file system.
System action: TSM will not run the process at this
time.

Explanation: A management class is assigned to the

file with the attribute MIGREQUIRESBKUP set to YES.
This requires a current backup copy of the file before
migration. However, the backup copy found on the
migration server is an old version. This file will not be
migrated. Note: TSM checks only the migration server
for a backup copy. If the migration server and backup
server are different servers, there must be a valid
backup copy of the file on the migration server.

User response: Try running the process again later.

System action: TSM does not migrate this file.

System action: TSM cannot add space management to

the file system.

User response: Back up the current file on the

migration server, or assign a management class to this

ANS9799W

Cannot open temp file for mount

command.

Explanation: TSM cannot open a temporary file to

process the mount command for this file system. This
message is issued only from the Motif HSM GUI,
which is no longer supported.

User response: Use the HSM Unix shell commands

instead.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

261

ANS9800W

Cannot create temp file for mount

command.

Explanation: TSM cannot create a temporary file to

process the mount command for this file system. This
message is issued only from the Motif HSM GUI,
which is no longer supported.
System action: TSM cannot add space management to
the file system.
User response: Use the HSM Unix shell commands
instead.
ANS9801W

Cannot create transaction file.

Explanation: Cannot create transaction file for this file

system. This message is issued only from the Motif
HSM GUI, which is no longer supported.

ANS9805W

Cannot create .SpaceMan directory.

Explanation: Cannot create .SpaceMan directory for

this file system. This message is issued only from the
Motif HSM GUI, which is no longer supported.
System action: TSM cannot add space management to
the file system.
User response: Use the HSM Unix shell commands
instead.
ANS9806W

The file system type is not supported.

Explanation: The file system is not a type supported

by space management.
System action: TSM cannot add space management to
the file system.

User response: Use the HSM Unix shell commands

instead.

User response: There is a mismatch between the HSM

client and the file system type specified. If the file
system type is consistent with the intent, install an
HSM client that supports it, then try the operation
again. Only one HSM client can be installed at a time.

ANS9802W

ANS9807I

System action: TSM cannot add space management to

the file system.

Cannot create status file.

Explanation: Cannot create status file for this file

system. This message is issued only from the Motif
HSM GUI, which is no longer supported.
System action: TSM cannot add space management to
the file system.
User response: Use the HSM Unix shell commands
instead.
ANS9803W

Cannot create premigration database.

Explanation: Cannot create a premigration database

for this file system. This message is issued only from
the Motif HSM GUI, which is no longer supported.
System action: TSM cannot add space management to
the file system.
User response: Use the HSM Unix shell commands
instead.
ANS9804W

Cannot create migration candidates list.

Explanation: Cannot create a migration candidates list

for this file system. This message is issued only from
the Motif HSM GUI, which is no longer supported.

The specified backupset file does not

contain a backupset of type "file" for the
specified nodename.

Explanation: Local backupset support is limited to

backupsets that contain file data; Image backupsets are
not supported locally. The specified backupset does not
contain a backupset with file data for the node name
specified.
System action: Processing stopped.
User response: Specify a different backupset file to
restore file data from a backupset. To restore an image
from a backupset, access the backupset from a TSM
server.
ANS9808W

Invalid field in the dsmmigfstab file.

Explanation: There is an invalid field in the

dsmmigfstab file entry for the file system. This message
is issued only from the Motif HSM GUI, which is no
longer supported.
System action: TSM cannot add space management to
the file system.
User response: Use the HSM Unix shell commands
instead.

System action: TSM cannot add space management to

the file system.

ANS9809W

User response: Use the HSM Unix shell commands

instead.

Explanation: TSM cannot open the dsmmigfstab file.

This message is issued only from the Motif HSM GUI,
which is no longer supported.

Cannot open the dsmmigfstab file.

System action: TSM cannot add space management to

the file system.

262

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Use the HSM Unix shell commands

instead.
ANS9811W

Server did not respond. Check the

server connection. Select OK to exit.

Explanation: Server did not respond.

System action: TSM stops processing.

ANS9816W

File system has exceeded its quota.

Explanation: TSM detects that the file system has

exceeded its quota. No more files can be migrated to
TSM storage for this file system.
System action: TSM will not migrate files from this
file system.

User response: Exit dsmhsm. Check the server

connection and try again later.

User response: Either recall some files to the local file

system, or ask the system administrator to increase the
quota for this file system.

ANS9812I

ANS9817W

Files not found in current directory.

Refresh file systems.

Explanation: Some files are not found in the local file

system.
System action: The transaction will show incorrect
results.

file-system is globally deactivated. Please

wait until the file system is globally
reactivated.

Explanation: The file system is in a global inactive

state.
System action: TSM cannot continue the process.

User response: Refresh the file systems to reflect local

file systems.

User response: Wait until the system administrator

globally reactivates the file system.

ANS9813W

ANS9818W

Incorrect data shown. Run reconcile.

Explanation: Information in the space management

status file is not synchronized with the file system.
System action: TSM continues processing.
User response: To correct the information, run
reconcile, and then refresh the current window.
ANS9814W

A selective recall is in progress. Stop the

recall, and then close the window.

Explanation: You tried to close the Selective Recall

Status window while a selective recall was in progress.
System action: TSM ignores the request.
User response: Stop the selective recall process, and
then close the window.

Cannot create migration object ID.

Explanation: The file system is full. No more free

space can be allocated for the migration object ID when
a file is being migrated or recalled.

ANS9819W

A selective migration is in progress.

Stop the process, and then close the
window.

System action: TSM terminates the current operation

for this file system.

Explanation: You tried to close the Selective Migration

Status window while a selective migration was in
progress.

User response: Remove some files in the file system,

and then run reconciliation. Retry the operation.

System action: TSM ignores the request.

ANS9815W

Out of free space or inodes in file

system to migrate or recall.

Explanation: The file system is full. No more free

space or free inodes are available to be allocated for the
transaction file that is needed when a file is being
migrated or recalled.
System action: TSM terminates the current operation
for this file system.
User response: Remove some files in the file system,
and then run reconciliation. Retry the operation.

User response: Stop the selective migration process,

and then close the window.
ANS9820W

A selective recall or a selective

migration is in progress. Wait until it
completes, and then retry the operation.

Explanation: You tried to perform one of the

following while a selective recall or selective migration
process was in progress:
Add space management
Deactivate or reactivate space management
Global deactivate or reactivate space management
Display policy information
Change password
System action: TSM ignores the request.
User response: Wait until the selective recall or
Chapter 2. ANS 0001-9999: Client messages, version 6.3

263

selective migration process is complete, and then retry

the operation.

/etc/adsm/SpaceMan/dsmrecalld.pid file.
ANS9828W

ANS9821W

New password is not re-entered.

Explanation: You did not re-enter the new password.

System action: The Change password dialog will
display again.
User response: Re-enter the new password.
ANS9822W

New password is not entered.

Error processing the space monitor

daemon: reason.

Explanation: There is a problem accessing the space

monitor daemon.
System action: TSM cannot perform automatic space
management functions.
User response: Check with the system administrator.
The space monitor daemon is normally installed as
/usr/lpp/adsm/bin/dsmmonitord.

Explanation: You did not enter the new password.

System action: The Change password dialog will
display again.
User response: Enter the new password.
ANS9823W

Current password is not entered.

ANS9829W

Recall daemon is not running.

Explanation: An TSM recall daemon is not running.

System action: TSM recall fails.
User response: Ask the system administrator to start a
recall daemon by issuing the dsmrecalld command.

Explanation: You did not enter the current password.

System action: The Change password dialog will
display again.

ANS9830W

Space monitor daemon is not running.

User response: Enter the current password.

Explanation: The space monitor daemon is not

running.

ANS9824W

System action: TSM is unable to perform space

management functions.

Cannot update space management

settings for file-system

Explanation: You tried to update space management

settings for a file system, and the update failed. This
message is issued only from the Motif HSM GUI,
which is no longer supported.

User response: Ask the system administrator to start

the space monitor daemon by issuing the dsmmonitord
command.
ANS9840I

System action: TSM continues with normal operation.

This command is not currently

supported for local backupsets.

User response: Use the HSM Unix shell commands

instead.

Explanation: Local backupset support is limited to

only a few commands and the command you specified
is not one of the supported commands.

ANS9825W

System action: Processing stopped.

Total migrated space is greater than

quota for file system.

Explanation: TSM total migrated space is greater than

quota.

User response: To perform this command on a

backupset, access the backupset from a TSM server.

System action: TSM continues.

ANS9841E

User response: You can remove this warning message

by increasing the quota for the file system.

Explanation: TSM cannot get the user name for the

user ID. This message is issued only from the Motif
HSM GUI, which is no longer supported.

ANS9827W

System action: TSM terminates the requested process

and returns to normal operation.

Error accessing the Recall daemon lock

file: file name.

Explanation: There is a problem accessing the recall

daemon lock file.

Cannot get user name for the user ID.

User response: Use the HSM Unix shell commands

instead.

System action: TSM cannot determine whether the

recall daemon is running. Because the recall daemon is
needed to perform file recalls, the recall fails.
User response: Check with the system administrator.
The recall process needs read access to the

264

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9842E

The watch daemon is not running

properly.

ANS9848W

Cannot activate file system file system.

Explanation: An TSM watch daemon is either not

running, has no dmapi session, or is not connected to
group services.

Explanation: TSM cannot activate space management

for the specified file system. This message is issued
only from the Motif HSM GUI, which is no longer
supported.

System action: The TSM action fails.

System action: TSM file system state is not changed.

User response: Ask the system administrator to check

GPFS and the group services and to restart a watch
daemon by issuing the dsmwatchd command.

User response: Use the HSM Unix shell commands

instead.
ANS9849I

ANS9843E

Cannot connect to migration server.

Explanation: TSM cannot connect to the migration

server specified in your client system options file. This
message is issued only from the Motif HSM GUI,
which is no longer supported.
System action: TSM terminates the requested process
and returns to normal operation.

Local backupset cannot be expanded;

Only full backupset restore is supported
locally.

Explanation: Local backupsets cannot be expanded to

show volumes, directories, and files. Only full
backupset restore is supported from local backupsets.
System action: Processing stopped.

User response: Use the HSM Unix shell commands

instead.

User response: To restore specific volumes, directories,

and files from a backupset, restore the backupset from
the TSM server.

ANS9844E

ANS9850E

Cannot close the premigrated files

database.

Explanation: TSM cannot close the premigrated files

database for the file system. The premigrated files
database resides in the .SpaceMan subdirectory of the
file systems root directory. This message is issued only
from the Motif HSM GUI, which is no longer
supported.
System action: TSM terminates the requested process,
and returns to normal operation.
User response: Use the HSM Unix shell commands
instead.
ANS9845E

Space management action ends.

Explanation: TSM The requested space management

operation is ended because the watch daemon is not
working properly.
System action: TSM is unable to complete the
operation.
User response: Look for previous messages.
ANS9846W

Cannot add space management to file

system.

Explanation: TSM cannot add space management to

the file system. This message is issued only from the
Motif HSM GUI, which is no longer supported.

Tape read error; Max Blocksize is

blocksize. Attempted to read blocksize
blocksize. Run dsmmaxsg to update scsi
driver max blocksize allowed and retry
operation.

Explanation: An attempt to read from tape at the

specified blocksize failed; Tha maximum blocksize
allowed for the scsi driver is shown.
System action: Processing stopped.
User response: If the maximum blocksize is less than
the blocksize used by the operation, run the dsmmaxsg
utility to update the maximum blocksize allowed for
the scsi driver, and then retry the operation. If the
maximum blocksize is greater than or equal to the
blocksize used, then verify that the tape installed and
operating correctly and retry the operation.
ANS9852E

Cannot query the level of client and

kernel.

Explanation: The space management GUI client fails

to query the level of kernel and client code. This
message is issued only from the Motif HSM GUI,
which is no longer supported.
System action: TSM continues with normal operation.
User response: Use the HSM Unix shell commands
instead.

System action: TSM continues with normal operation.

User response: Use the HSM Unix shell commands
instead.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

265

ANS9853W

The space management client program

is downlevel.

ANS9858E

Bit file for image on push button cannot

be found. Please check to make sure the
pixmap file exists in your TSM installed
directory.

Explanation: The space management client is

downlevel compared to the kernel level. This message
is issued only from the Motif HSM GUI, which is no
longer supported.

Explanation: TSM failed to find the pixmap file

defined for the push button.

System action: TSM continues with normal operation.

System action: TSM continues with normal operation.

User response: Use the HSM Unix shell commands

instead.

User response: Check to see whether the pixmap file

exists in the TSM installation directory.

ANS9854W

ANS9860W

The space management kernel is

downlevel.

Some selected files are hidden. Change

View option to see all.

Explanation: The space management kernel is

downlevel compared to the client level. This message is
issued only from the Motif HSM GUI, which is no
longer supported.

Explanation: You have selected all files in a directory

or in all subdirectories. Due to the current View option,
only certain types of files are shown (either migrated,
resident, or premigrated files).

System action: TSM continues with normal operation.

System action: TSM proceeds normally.

User response: Use the HSM Unix shell commands

instead.

User response: If you want to see all selected files,

change the View option from the View menu bar
option.

ANS9855W

File is accessed during migration. File

skipped.

ANS9862W

Do you want to exit TSM space

management?

Explanation: The specified file-name was not migrated

because the file was accessed by another process during
the attempt to migrate it.

Explanation: You have selected Exit from the File

menu bar option.

System action: TSM left the file resident.

System action: TSM waits for your response.

User response: If you want the file migrated, stop the

process which is accessing the file and retry the
migration operation.

User response: If you want to exit the program, select

OK. Otherwise, select Cancel.
ANS9871W

ANS9856E

File is currently opened by another

process. File skipped. File has already
been migrated or is currently being
migrated by another process.

Explanation: The specified file was not migrated

because the file was opened by one or more other
processes.
System action: TSM left the file resident.
User response: If you want the file migrated, stop the
processes which currently have the file open, and retry
the migration operation.
ANS9857W

The restored HSM for Windows stub

file may be an orphan: stub file name

Explanation: The restored stub file may not be

accessible in the HSM client archive and thus it
possibly cannot be recalled.

Specified column width is smaller than

the largest attribute value. Data will be
truncated.

Explanation: You have entered a column width that is

too small to display all digits of the largest attribute.
System action: TSM accepts your request.
User response: To see all attributes in full length,
increase the column width.
ANS9873W

This function should not be used on

large file systems. Continue anyway ?

Explanation: You have decided to open selective recall

or selective migration window, but these functions may
take too long for large file systems.
System action: TSM waits for your response.
User response: If you want to continue, select OK.
Otherwise, select Cancel.

System action: Stub file is restored.

User response: Check if the stub file can be accessed.

266

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9875W

Refresh time must be numeric value and

within 0 - 14400 minutes or 0 - 240 hours
(10 days).

Explanation: You have entered an invalid value for

Refresh time. It must be a positive number between 0
and 14400.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 14400.
ANS9876W

Refresh time must be a positive number.

Explanation: You have entered an invalid value for

Refresh time. It must be a positive number between 0
and 14400.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 14400.
ANS9877W

Size Factor must be a numeric value

between 0 - 999999999.

Explanation: You have entered an invalid value for

Size Factor. It must be a positive number between 0
and 999999999.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 999999999.
ANS9878W

Size Factor must be a positive number.

Explanation: You have entered an invalid value for

Size Factor. It must be a positive number between 0
and 999999999.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 999999999.
ANS9879W

Age Factor must be a numeric value

between 0 - 999999999.

Explanation: You have entered an invalid value for

Age Factor. It must be a positive number between 0
and 999999999.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 999999999.
ANS9880W

Age Factor must be a positive number.

Explanation: You have entered an invalid value for

Age Factor. It must be a positive number between 0
and 999999999.
System action: TSM continues with normal operation.

User response: Enter a positive number between 0

and 999999999.
ANS9881W

Premigration Percent must be a numeric

value between 0 - 100.

Explanation: You have entered an invalid value for

Premigration Percentage. It must be a positive number
between 0 and 100.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 100.
ANS9882W

Premigration Percent must be a positive

number.

Explanation: You have entered an invalid value for

Premigration Percentage. It must be a positive number
between 0 and 100.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 100.
ANS9883W

Quota must be a numeric value between

0 - 999999999.

Explanation: You have entered an invalid value for

Quota. It must be a positive number between 0 and
999999999.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 999999999.
ANS9884W

Quota must be a positive number.

Explanation: You have entered an invalid value for

Quota. It must be a positive number between 0 and
999999999.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 999999999.
ANS9885I

The premigration percentage will not be

updated until you select the Update
push button on the Update window or
the Add push button on the Add
window.

Explanation: While you have just selected 'OK' in the

Advanced Feature dialog, the premigration percentage
is not activated until you select 'Add' or 'Update' in the
'Add space management', or the 'Update space
management' dialog.
System action: TSM waits until you select 'Add' or
'Update' to apply your premigration percentage to the
system.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

267

User response: When you have changed the space

management attribute, select 'Add' or 'Update', and
then the system will apply your new premigration
percentage.

non-cluster environment perform the operation from a

different host with the expected hostname. Retry the
operation.
ANS9895W

ANS9886W

Enter a positive number for Column

Width.

Explanation: You have entered an invalid value for

Column Width. It must be a positive number between 0
and 18.
System action: TSM continues with normal operation.
User response: Enter a positive number between 0
and 18.
ANS9887W

Enter a positive number for Space

Between Column.

Explanation: You have entered an invalid value for

Space Between Column. It must be a positive number
between 0 and 18.
System action: TSM continues with normal operation.

Space management in file system file

system is not active.

Explanation: You tried to select a file in a file system

for which space management is inactive.
System action: TSM continues with normal operation.
User response: Reactivate space management for the
file system, and then proceed with selecting files.
ANS9901E

Cannot migrate TSM system internal

file.

Explanation: You tried to select files that are used

internally by the HSM client. You cannot migrate TSM
internal files.
System action: TSM ignores your request.
User response: None.

User response: Enter a positive number between 0

and 18.

ANS9903E

ANS9889W

Explanation: You tried to migrate a file in a file

system for which space management is inactive.

Space management has not been added

to file-system file system. Do you want to
build the directory tree anyway?

Explanation: You selected a file system that is not

managed by HSM.
System action: TSM builds the directory tree if you
select the OK button. Otherwise, it will not.
User response: You can add space management to the
file system by selecting the Space Manager push button
in the TSM main window, and then selecting Add
under the Selected menu option.

Space management is deactivated for

this file system.

System action: TSM continues to migrate files only in

active file systems.
User response: Reactivate space management for the
file system, and retry the migration operation.
ANS9904E

Transaction failed, migration aborted.

Explanation: The specified file-name was not migrated

because the file was accessed by another process during
the attempt to migrate it.
System action: TSM migration is aborted.

ANS9891W

Please mark either or both check boxes

before proceeding.

Explanation: You have not marked either of the check

boxes.
System action: TSM does not proceed with reconcile
processing.

User response: If you want the file migrated, stop the

process that is accessing the file, and then retry the
migration.
ANS9908E

System Error.

User response: Mark either or both check boxes.

Explanation: TSM detects an error in reading the state

of the file system. This message is issued only from the
Motif HSM GUI, which is no longer supported.

ANS9892E

System action: TSM proceeds with normal operation.

Unable to find snapshot(s) in the local

repository.

Explanation: The requested volume snapshot(s) were

not found in the local repository.

User response: Use the HSM Unix shell commands

instead.

System action: Processing stops.

User response: Ensure the operation is issued with the
proper nodename and/or server address. In a

268

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9909I

Error in accessing migration candidates

list file.

Explanation: TSM detects an error in reading the

migration candidates list file. This file resides in the
.SpaceMan directory of the file system. This message is
issued only from the Motif HSM GUI, which is no
longer supported.
System action: TSM proceeds with normal operation.
User response: Use the HSM Unix shell commands
instead.
ANS9914I

Space management settings have been

modified successfully on file-system file
system.

Explanation: Space management settings have been

updated successfully.
System action: TSM updated space management
settings for the file system.
User response: Continue with normal operation.
ANS9915I

Space management has been added

successfully to file-system file system.

User response: Select OK to return.

ANS9933I

Migration candidates list only exists in

an 'Active' file system. If you want to
make file-system file system 'Active',
select 'Add Space Management'.

Explanation: You tried to display the migration

candidates list for a Native file system (a file system
to which space management has not been added).
System action: Processing stopped.
User response: Select OK to return. Select Add Space
Management if you want to add space management to
the file system.
ANS9934I

Reconcile only works on an 'Active' file

system. If you want to make file-system
file system 'Active', select 'Add Space
Management'.

Explanation: You tried to start reconciliation on a

Native file system (a file system to which space
management has not been added). You must add space
management to a file system before starting reconcile.
System action: Processing stopped.

Explanation: Space management has been added

successfully.

User response: Select OK to return. Select Add if

you want to add space management to the file system.

System action: TSM added and activated space

management for the file system.

ANS9935I

User response: Continue with normal operation.

ANS9918E

Cannot open migration candidates list

for file-system.

Start Threshold Migration only works

on an 'Active' file system. If you want to
make file-system file system 'Active',
select 'Add Space Management'.

Explanation: TSM cannot access the migration

candidates list for the specified file system.

Explanation: You tried to start Threshold Migration on

a Native file system (a file system to which space
management has not been added). You must add space
management to the file system first.

System action: TSM continues normal operation.

System action: Processing stopped.

User response: Select OK to return.

User response: Select OK to return. Select Add if

you want to add space management to the file system.

ANS9928I

Space management has been deactivated

successfully on file-system file system.

Explanation: Space management is deactivated

successfully.
System action: TSM deactivated space management
for the file system.
User response: Select OK to return.
ANS9929I

Space management has been reactivated

successfully on file-system file system.

Explanation: Space management is reactivated

successfully.

ANS9936I

Start Threshold Migration only works

on an 'Active' file system. If you want to
make file-system file system 'Active',
select 'Reactivate'.

Explanation: You tried to start Threshold Migration on

an Inactive file system (a file system for which space
management has been deactivated). You must reactivate
space management for your file system first.
System action: Processing stopped.
User response: Select OK to return. Select 'Reactivate'
to reactivate space management for the file system.

System action: TSM reactivated space management for

the file system.
Chapter 2. ANS 0001-9999: Client messages, version 6.3

269

ANS9938I

Space management has not been added

to file-system file system. You do not
need to deactivate space management.

Explanation: You tried to deactivate space

management on a file system to which space
management has not been added.

System action: Processing stopped.

User response: Select OK to return. Select
Reactivate, and then select Remove to remove
space management.
ANS9945I

System action: Processing stopped.

User response: Select OK to return.
ANS9941I

Space management has not been added

to file-system. If you want to add space
management, select 'Add space
management' option. The file system
will automatically be activated when
you add space management.

Explanation: You tried to activate space management

on a file system to which space management has not
been added. You must first add space management.
The file system will automatically be activated when
the add process is complete.
System action: Processing stopped.
User response: Select OK to return. Select Add if
you want to add space management to the file system.
ANS9942S

Space management has not been added

to file-system file system. Do you want to
add space management now?

Explanation: You tried to update space management

settings for a file system to which space management
has not been added.
System action: Processing stopped.
User response: Select OK to add space management to
the file system. Select Cancel to return.
ANS9943I

Space management has already been

added to file-system file system.

Explanation: You tried to add space management to a

file system to which space management has already
been added.
System action: Processing stopped.
User response: Select OK to return.
ANS9944I

Space management has been deactivated

on file-system file system. You must
reactivate space management before you
can remove it.

Explanation: You tried to remove space management

from a file system for which space management has
been deactivated. You must reactivate space
management for the file system before you can remove
it.

270

Space management has not been added

to file-system file system. You do not
need to remove space management.

Explanation: You tried to remove space management

from a file system to which space management has not
been added.
System action: Processing stopped.
User response: Select OK to return.
ANS9947E

File: file-spec is in a file system to which

space management has not been added.

Explanation: You tried to migrate a file that resides in

a file system to which space management has not been
added.
System action: TSM will not highlight/process the
file.
User response: Switch over to the Space Manager
window, and add space management to the file system.
ANS9948E

File: file-spec size is less than the

minimum size required for migration.

Explanation: You tried to migrate a file that is smaller

than the minimum size required for migration. To be
eligible for migration, a file must be larger than both
the stub file size specified for the file system plus one
byte and the block size defined for the file system.
System action: TSM will not highlight the file.
User response: None.
ANS9949E

File: file-spec is not a regular file and

therefore not qualified for migration.

Explanation: You tried to migrate a file that is not a

regular file. It might be a FIFO file, a special file, a
directory or a symbolic link.
System action: TSM will not highlight the file.
User response: None.
ANS9951I

File: file-name has already been migrated.

Explanation: You tried to migrate a file that is already

migrated. Note that you may get this message if the file
is hard linked with another, already migrated file.
System action: The file is skipped.
User response: None.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

ANS9953E

The management class assigned to this

file does not allow migration.

Explanation: The management class assigned to this

file does not allow migration.
System action: TSM does not migrate the file.

ANS9962I

Migration stopped by user.

Explanation: You requested that TSM stop the migrate

operation.
System action: Migration stopped.
User response: Continue with normal operations.

User response: None.

ANS9963I
ANS9954E

This file has already been migrated.

Selective Recall completed. Check

failure list for possible errors.

Explanation: The file has been previously migrated.

Explanation: The recall was completed.

System action: File is skipped.

System action: TSM recalled the files.

User response: None.

User response: Continue with normal operations.

ANS9958E

ANS9964I

File 'file-namefile-namefile-name has not yet

reached the age for migration. File
skipped.

Explanation: This file cannot be migrated because it

has not yet reached the age for migration.
System action: TSM will not highlight the file.
User response: None.
ANS9959W

IBM Tivoli Storage Manager acceptor

received a non-critical network error
errno, TSM return code : TSM-rc.

Explanation: The communication problem happened

while listening for inbound connection but the IBM
Tivoli Storage Manager acceptor continues running.
System action: Processing continues.
User response: No further action is required, it can be
safely ignored.

Selective Migration completed. Check

failure list for possible errors.

Explanation: The migration was completed.

System action: TSM migrated the files.
User response: Continue with normal operations.
ANS9965S

Please select a file system first.

Explanation: You did not select any file system for the
Migrate window.
System action: TSM ignores this request and
continues.
User response: Select a file system, a directory, and all
files you want to migrate, and then select the Migrate
button to start the process.
ANS9966S

No file system has been selected.

Explanation: You did not select a file system.

ANS9960W

No files selected for migrate or recall.

Explanation: You requested a migrate or recall

operation without selecting files from the presented
directory tree.
System action: TSM cannot do the migration or recall
without selected files.

System action: TSM ignores the request and

continues.
User response: Select at least one file system and retry
the operation
ANS9984W

PFR plugin library was not found.

User response: Select the files that you want to

migrate or recall, and retry the operation.

Explanation: PFR plugin library should have been

installed when the client was installed, but it cannot be
found.

ANS9961E

System action: The selected operation is not

performed.

Server out of migrate data storage space.

Explanation: The server ran out of space in its migrate

data storage. This message is issued only from the
Motif HSM GUI, which is no longer supported.
System action: TSM cannot complete the migrate
operation. Any files displayed in the Successful list of
the Migrate Status window were successfully migrated.
User response: Use the HSM Unix shell commands
instead.

User response: None.

ANS9987W

Partial recall mode is not set for

full-file-name

Explanation: Partial recall mode is not set for the

specified file.

Chapter 2. ANS 0001-9999: Client messages, version 6.3

271

System action: The recall is not performed for the

specified file. Processing stopped.
User response: Set the partial recall mode on the file
("dsmattr -recallmode=partialrecall" command) and
re-try the operation.
ANS9988S

As part of the remove process, all

migrated files in file-system will be
recalled from TSM server. Do you want
to continue with the remove process
now?

v Define the management class named on the

INCLUDE statement (if it is intended to have a
management class with that name).
v Verify that the node is in the correct policy domain
(perhaps the node was accidentally put in the wrong
policy domain, and the correct domain has the
management class).
v Remove the INCLUDE statement if it is no longer
necessary to bind the files to the management class.
ANS9997W

Explanation: When you remove space management

from a file system, TSM recalls all migrated files.
System action: TSM waits for your response before
proceeding with the remove process.
User response: Select Yes to remove space
management from the selected file system, or select
Cancel to skip the remove.
ANS9989W

Management class mcName specified on

the INCLUDEstatement in file-name at
line line-number does not exist.

Explanation: Management class named on the

INCLUDE statement in the file-name file does not exist
in your assigned policy set on the server.
System action: The object is bound to the default
management class.
User response:
v Update the INCLUDE statement so that it specifies a
valid management class.
v Define the management class named on the
INCLUDE statement (if it is intended to have a
management class with that name).
v Verify that the node is in the correct policy domain
(perhaps the node was accidentally put in the wrong
policy domain, and the correct domain has the
management class).
v Remove the INCLUDE statement if it is no longer
necessary to bind the files to the management class.
ANS9990W

Management class mcName specified on

INCLUDE statementin client option set
does not exist.

Explanation: Management class named on the

INCLUDE statement in client option file does not exist
in your assigned policy set on the server.
System action: The object is bound to the default
management class.
User response:
v Update the INCLUDE statement so that it specifies a
valid management class.

272

The selective migration, selective recall,

or policy information window is
displayed. Stop any operations, close the
window, and then retry the operation.

Explanation: When a node is contacting more than

one server for space management services, the selective
migration, selective recall, and policy information
windows may not be displayed at the same time.
System action: TSM ignores the request.
User response: Close the selective migration, selective
recall, or policy information window, and then retry the
operation.
ANS9998E

The migration server changed after the

selective migration or selective recall
window was displayed. Close the
window, and then retry the operation.

Explanation: A migrate or recall operation will not be

allowed to proceed if the user changed the migration
server after the selective migration or selective recall
window was displayed.
System action: No files will be migrated or recalled.
User response: Close the selective migration or
selective recall window, and then retry the operation.
ANS9999E

():

Explanation: This message carries diagnostic text

relating to a client process or algorithm. This
information is intended for reporting processing
exceptions and other non-standard situations that occur
on the TSM client. The (component), (code), and (text)
will vary depending upon the cause of the message
and the client process or algorithm that issues the
message.
System action: Client processing may or may not
continue depending upon the cause of this message.
User response: Examine error messages that may have
been displayed before and/or after this message and
correct any problems, if possible. If the cause of this
message can not be determined or resolved, contact
your support representative. If you contact your
support representative, the entire text of this message
should be reported.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Chapter 3. API return codes, version 6.3

This section contains the API (Application Programming Interface) return codes for
Tivoli Storage Manager 6.3.
The first subsection explains how to understand API return codes. All version 6.3.0
API return codes are documented in another subsection. Version 6.3.0 API return
codes that are new, changed, or deleted since the previous version are listed in
another subsection.

API return code format

This section explains the API (Application Programming Interface) return code
format. For each return code, the following information is provided:
v The return code number. This number corresponds to the number in the dsmrc.h
header file.
v The severity code. This letter is an indication of the severity that generated the
return code. The possible severity codes and their meanings include:
S
E
W

Severe error
Error
Warning

Information

Processing cannot continue.

Processing cannot continue.
Processing can continue, but problems might develop
later. You should be cautious.
Processing continues. User response is not necessary.

v The symbolic name. This name corresponds to the definition in the header file,
dsmrc.h. Always use the symbolic name for a return code in your application rather
than the return code number.
v The explanation. This field explains the circumstances under which this return
code might be generated.
v The system action. This field describes what action Tivoli Storage Manager is
going to take in response to the return code.
v The user response. This field explains how you should respond to the system
action.
Many of the return codes describe errors that cause processing to stop. You can
send a message to the end user that describes the problem and suggest a course of
action. To identify different messages, use these return code values or develop your
own numbering system.

API return codes: Changes from the previous version

This section lists the version 6.3.0 API return codes that are new or changed since
the previous version. Only the return code, severity, and message ID is listed.
Return
Return
Return
Return
Return
Return
Copyright IBM Corp. 1993, 2011

code:
code:
code:
code:
code:
code:

-051 E Message number: ANS1031E

0068 E Message number: ANS1015E
0079 E Message number: ANS5307E
0102 E Message number: ANS1075E
0119 E Message number: ANS1243E
0184 E Message number: ANS1105E

273

Return
Return
Return
Return

code:
code:
code:
code:

0406 S Message number: ANS1035S

2114 E Message number: ANS1140E
2120 E Message number: ANS4999I
4582 E Message number: ANS1101E

API return codes: Deletions from the previous version

There are no deleted API return codes.

Version 6.3.0 API return codes

This section documents the TSM 6.3.0 API return codes. The return codes are listed
in ascending numeric order. The complete return code is documented.

-452 E
DSM_RC_SHM_NOTAUTH
Insufficient authority to connect to the shared
memory region
Explanation: The user issuing the command does not
have authority to connect to the shared memory
segment. When the shared memory segment is created
by the server, it will be owned by the effective uid of
the server process (dsmserv). Only processes running
under this uid or root will be allowed to connect to the
segment (and thus to the server).
System action: The session is rejected and processing
stops.
User response: Run the command under the uid of
the processing running dsmserv, if possible. Otherwise
contact your system administrator for further help.

-451 E
DSM_RC_SHM_FAILURE
An error occurred using the Shared Memory protocol
Explanation: An error has occurred while reading or
writing data through the Shared Memory
communications protocol.
System action: TSM cannot complete the requested
operation.
User response: Check the trace log for additional
information and retry the operation. If the problem
continues, see your system administrator for further
help.

-450 E
DSM_RC_SHM_TCPIP_FAILURE
Session rejected: TCP/IP connection failure for Shared
Memory

274

Explanation: An attempt to connect to the local server

using the Shared Memory protocol has failed during
initial TCP/IP communications. This error can occur if
the server is not listening on the correct port, or if the
server is down.
System action: Session rejected. Processing stopped.
User response: Retry the operation, or wait until the
server comes back up and retry the operation. If the
problem continues, see your system administrator for
further help.

-190 E
DSM_RC_NP_ERROR
Session rejected: Named Pipes connection failure.
Explanation: An attempt to connect to the server
using Named Pipes communications failed. This might
have occurred if an incorrect NAMEDPIPENAME was
specified in the options files or if your system
administrator canceled a backup operation.
System action: Processing stopped.
User response: Retry the operation, or wait until the
server comes back up and retry the operation. Ensure
that the value specified on the NAMEDPIPENAME
option is the same as the one used by the server. If the
problem continues, contact your system administrator
for further help.

-124 E
DSM_RC_3270COMM_MISSING_DLL
The TSM DLL dsm3270.dll cannot be found in the
user's path.
Explanation: The TSM DLL dsm3270.dll cannot be
found in the user's path.
System action: Communications link is not
established.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Make sure that the TSM DLL

dsm3270.dll is in a directory that is included in the
user's path.

TSM client's TCPSERVERADDRESS setting could not

be found on the network. Common reasons for this
error include:
v The TCPSERVERADDRESS client option specifies the
wrong TCP/IP address for the TSM server".

-057 E
DSM_RC_TCPIP_LOADFAILURE

v The machine that hosts the TSM server is not on the

network.

The TCP/IP load function failed.

v A network problem is preventing the TSM client

from reaching the machine that hosts the TSM server.

Explanation: An error occurred while locating a

function. The TCP/IP load function failed.

System action: processing stops.

System action: Processing stopped.

User response: Verify your TCP/IP installation.

-056 E
DSM_RC_TCPIP_DLL_LOADFAILURE

User response: Verify that the TCPSERVERADDRESS

and TCPPORT settings have the correct values for your
TSM server. Use your operating system's "ping" (or
similar) utility to ensure that your machine can locate
the machine that hosts the TSM server across the
network. Try the operating again. If the problem
persists, ask your TSM administrator for further
assistance.

An error occurred while loading a library.

Explanation: An error occurred while loading a
library. The TCP/IP DLL load failed.
System action: Processing stopped.
User response: Verify your TCP/IP installation.

-055 E
DSM_RC_WINSOCK_MISSING
The TCP/IP WINSOCK.DLL file cannot be found.
Explanation: The TCP/IP WINSOCK.DLL file cannot
be found.
System action: Processing stopped.

-052 E
DSM_RC_CONN_REFUSED
An attempt to establish a TCP/IP connection was
rejected by the host
Explanation: An attempt to establish a TCP/IP
connection was rejected by the server.
System action: Processing stopped.
User response: The server was not fully initialized, is
not currently running, was not enabled for TCP/IP
communications, or an incorrect TCP/IP port number
was specified. If the problem continues, see your
system administrator.

User response: Verify your TCP/IP installation.

-051 E
DSM_RC_CONN_TIMEDOUT
-054 E
DSM_RC_NETWORK_UNREACHABLE
The specified TCP/IP host name is unreachable
Explanation: The TCP/IP host name specified in the
TCPSERVERADDRESS statement cannot be reached.
System action: Processing stopped.
User response: Check your options file for the correct
TCPSERVERADDRESS statement. See your
administrator for the correct name of the server.

The attempt to establish a TCP/IP connection timed

out before the connection was made.
Explanation: The Object of the connection attempt
failed to respond within the the allotted wait time. In
the case of the B/A client, this message is preceded in
dsmerror.log by message ANS5216E that gives details
of the connection that failed. The condition may be
temporary.
System action: processing stops.
User response:
v Restart the TSM client and retry the operation.

-053 E
DSM_RC_BAD_HOST_NAME
An invalid TCP/IP address was specified.

v Check the client options file and verify that

TCPSERVERADDRESS and TCPPORT specify the
correct TCP/IP address and port number for your
TSM server.

Explanation: The TCP/IP address specified by the

Chapter 3. API return codes, version 6.3

275

v Verify that network connectivity exists between the

TSM client machine and the TSM server machine.
v If the problem persists, see your TSM administrator
for further assistance.

System action: Processing stopped.

User response: Ensure the names are properly
entered. If the object is part of a backupset generated
prior to a node name change, ensure that the node
name is the same as the node for which the backup set
was generated.

-050 E
DSM_RC_TCPIP_FAILURE
Session rejected: TCP/IP connection failure
Explanation: An attempt to connect to the server
using TCP/IP communications failed. This can be a
result of incorrect TCP/IP option settings in your client
options file. This error can also occur if the LAN
connection went down or if your system administrator
canceled a backup operation.

0003 E
DSM_RC_ABORT_BY_CLIENT
Client ended transaction
Explanation: The client system ended the operation
with the server and ended the current transaction.
System action: Processing stopped.

System action: Session rejected. Processing stopped.

User response: Restart the session.

User response: Retry the operation, or wait until the

server comes back up and retry the operation. If the
problem continues, see your system administrator for
further help.

0004 W
DSM_RC_ABORT_ACTIVE_NOT_FOUND
An active backup version could not be found.

0000 I
DSM_RC_OK
Successfully done.
Explanation: The operation successfully completed.
System action: None.
User response: None.

0001 E
DSM_RC_ABORT_SYSTEM_ERROR
Server detected system error
Explanation: The server detected a system error and
notified the clients.
System action: Processing stopped.
User response: See your system administrator for
further information on server activity.

0002 E
DSM_RC_ABORT_NO_MATCH
No objects on server match query
Explanation: No objects on the server match the query
operation being performed. If this object is part of a
backupset generated on a node, and the node name is
changed on the server, any backup set objects that were
generated prior to the name change will not match the
new node name.

276

Explanation: An attempt was made to expire an

object, but the TSM server was unable to find an active
backup version of the object. This message is preceded
by message ANS1228E which specifies the object name.
For instance, this message could be issued if two
separate client processes are backing up the same file
system at the same time. If one of the processes expires
a file, then the TSM server will make that file inactive.
If the second process subsequently attempts to expire
that same file, the TSM server will not find an active
version of the file, so the second process will issue this
message for that file.
System action: The object is not expired. Processing
continues with the next object.
User response:
v Review the console output, schedule log, or error log
and locate the ANS1228E message that immediately
precedes this message. ANS1228E will identify the
object that could not be expired.
v Examine the conditions under which the problem
occurred and assess whether those conditions explain
the occurrence of this message. For example, this
message could appear if multiple instances of the
client were attempting to back up the file system
concurrently.
v If the reason this message occurred can not be
determined and the message occurs when the
operation is tried again, then contact IBM support for
further assistance. Also try searching for this message
number on http://www.ibm.com for possible
solutions.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

0005 E
DSM_RC_ABORT_NO_DATA

0009 W
DSM_RC_ABORT_DATA_OFFLINE

The TSM server has no data for the object.

The requested data is offline.

Explanation: TSM tried to do a restore or retrieve on

an object that has no data associated with it. If a
corrective action is possible, it is with the TSM server.

Explanation: For the restore or retrieve operation, one

or more of the requested files must be recalled from
offline storage media (generally tape). The wait time
depends on your sites offline storage management
policies.

System action: TSM ends the current operation.

User response: Ask the TSM administrator to check
the TSM activity log for any messages related to this
error that might help identify the problem.

System action: TSM waits for offline storage media to

become available and then continues.
User response: None.

0006 E
DSM_RC_ABORT_BAD_VERIFIER

0010 E
DSM_RC_ABORT_EXCLUDED_BY_SIZE

You entered an incorrect password.

Explanation: You entered an incorrect current
password or you entered a new password that does not
fulfill the password length requirements set on the
server.

Object too large for server limits

Explanation: The object is too large. The configuration
of the server does not have any data storage space that
accepts the object.

System action: Processing stops.

System action: File skipped.

User response: Retry the session with the correct

password. If this fails or you have forgotten your
password, ask the TSM administrator to assign a new
password.

User response: See your system administrator to

determine the maximum file (object) size for which
your sites server is configured.

0007 E
DSM_RC_ABORT_NODE_IN_USE

0011 E
DSM_RC_ABORT_NO_REPOSIT_SPACE
Server out of data storage space

Node in use
Explanation: The node you are running on is in use
by another operation on the server. This might be from
another client or from some activity on the server.

Explanation: The server does not have any space

available to store the object.
System action: TSM ended the current operation.

System action: Processing stopped.

User response: You can take any of the following

actions:

User response: Retry the operation, or see your

system administrator to see what other operations are
running for your node.

v Request the system administrator to add space to the

storage pool.

0008 E
DSM_RC_ABORT_EXPDATE_TOO_LOW
Expiration date must be greater than today's date
Explanation: Archive expiration date is too low, the
date must be greater than todays date.
System action: TSM canceled the current operation.

v For TSM client, set COMPRESSALWAYS=NO and

COMPRESSIon=YES in the options file (DSM.OPT),
then the file will be resent uncompressed if it grows
during compression.
v For API Applications, consult the application's
documentation for recommendations regarding
compression.
v Turn off disk caching in the disk storage pool, and
issue MOVE DATA commands to each disk pool
volume to clear out the cached bitfiles.

User response: Retry archiving the file with an

expiration date that is higher than todays date.

Chapter 3. API return codes, version 6.3

277

0012 E
DSM_RC_ABORT_MOUNT_NOT_POSSIBLE

0015 E
DSM_RC_ABORT_RETRY

Server media mount not possible

Unexpected retry request. The server found an error

while writing the data.

Explanation: Server media mount not possible. The

server timed out waiting for a mount of an offline
volume.
System action: File skipped.
User response: Retry later when server volumes can
be mounted. Ensure that the MAXNUMMP (maximum
number of mount points) defined on the server for this
node is greater than 0.

0013 E
DSM_RC_ABORT_SIZESTIMATE_EXCEED

Explanation: None.
System action: The client retries the operation.
User response: None.

0016 E
DSM_RC_ABORT_NO_LOG_SPACE
The server does not have enough recovery log space
to continue the current operation
Explanation: The server ran out of recovery log space.

Size estimate exceeded

System action: TSM ended the current operation.

Explanation: The total amount of data for a backup or

archive operation exceeds the estimated size originally
sent to the server for allocating data storage space. This
happens when many files are growing by large
amounts while the backup or archive operation is in
session.

User response: This error is a temporary problem.

Retry later or see your system administrator.

0017 E
DSM_RC_ABORT_NO_DB_SPACE

System action: Processing stopped.

User response: Retry the operation. If the problem
continues, check what other processes are running on
the client machine that are generating large amounts of
data. Disable those operations while the backup or
archive operation is taking place.

The server does not have enough database space to

continue the current operation
Explanation: The server ran out of database space.
System action: TSM ended the current operation.
User response: See your system administrator.

0014 E
DSM_RC_ABORT_DATA_UNAVAILABLE

0018 E
DSM_RC_ABORT_NO_MEMORY

File data currently unavailable on server

Explanation: The file data is currently unavailable on
the server. A retrieve or restore operation was
attempted. Possible causes are:
v Data was corrupted at the server
v Server found a read error
v File is temporarily involved in a reclaim operation at
the server
v Server requested a tape volume that was marked
unavailable.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, see your system administrator to determine
the problem from the server console or the activity log.
Check whether any requests were made for a tape
volume that was unavailable. A tape volume may be
marked unavailable if prior read errors were
encountered or the volume is checked out of the tape
library.

278

The server does not have enough memory to continue

the current operation.
Explanation: The server ran out of memory.
System action: TSM ended the current operation.
User response: This is a temporary problem. Retry
later or see your system administrator.

0020 E
DSM_RC_ABORT_FS_NOT_DEFINED
The specified file space does not exist on the server.
The file space might have been deleted by another
client or an administrator.
Explanation: The specified file space does not exist on
the server. Your system administrator deleted the file

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Check the file space name to see if it is

correct, and retry the operation.

persists, examine the TSM client error log and TSM

server activity log for additional information about this
error. If the problem cannot be resolved, then obtain a
SERVICE trace that captures the problem and contact
IBM technical support for additional assistance. Your
TSM administrator can help you configure the trace.

0021 S
DSM_RC_ABORT_NODE_ALREADY_DEFED

0024 E
DSM_RC_ABORT_NO_INVALID_POL_BIND

Open Registration failed because the specified node

name is defined in the server

An object in the transaction has been bound to an

invalid management class.

Explanation: Open registration failed because a node

is defined in the server with the same name.
System action: TSM canceled the current operation.

Explanation: One of the objects in the transaction is

bound to a management class that is not part of this
node's policy, or the management class type is not
supported for this client level.

User response: Retry with another node name.

System action: The current operation ends.

space or another client using your clients node name

deleted it.
System action: TSM canceled the current operation.

0022 S
DSM_RC_ABORT_NO_DEFAULT_DOMAIN
Open Registration failed because no default domain
exists
Explanation: Open registration failed because a
default policy domain does not exist for you to place
your node.
System action: TSM canceled the current operation.
User response: See your system administrator.

User response: Make sure all objects are bound to a

valid management class, or upgrade the client to the
proper level.

0025 E
DSM_RC_ABORT_DEST_NOT_DEFINED
Server problem: Destination not defined.
Explanation: Server problem: Destination not defined.
System action: Processing stopped.
User response: Have your service representative check
the error log.

0023 S
DSM_RC_ABORT_INVALID_NODENAME
Open Registration failed because an invalid node
name was specified
Explanation: Open registration failed because the
specified node name contains invalid characters.
System action: TSM canceled the current operation.
User response: Retry with another node name that
does not have any invalid characters.

0024 S
DSM_RC_ABORT_INVALID_POL_BIND
A policy management problem has occurred on the
TSM server.

0026 S
DSM_RC_ABORT_WAIT_FOR_SPACE
The TSM server does not currently have space in the
storage pool for this file. This may be a temporary
condition.
Explanation: This message is typically issued when
the storage pool in which the data is being placed does
not have sufficient space to store the data, but the
space will be available soon. For example, a storage
pool migration might free up sufficient space to store
the data.
System action: TSM ends the current operation.
User response: Try the operation at a later time. If this
fails, contact the TSM administrator and request more
storage pool space.

Explanation: The TSM client error log and TSM server

activity log may contain additional information about
this error.
System action: Processing is stops.
User response: Try the operation again. If the problem
Chapter 3. API return codes, version 6.3

279

0027 E
DSM_RC_ABORT_NOT_AUTHORIZED
The file space cannot be deleted because this node
does not have permission to delete archived or
backed up data.
Explanation: You cannot delete the file space data
unless your TSM administrator has authorized your
node to do so. Authorization permits you to delete
backup data, archive data, or both.
System action: Delete processing fails.

System action: The session is rejected or the

transaction is cancelled, ending the current operation.
User response: See your system administrator.

0032 E
DSM_RC_ABORT_DUPLICATE_OBJECT
A duplicate object was found, operation cannot
complete.
Explanation: A duplicate object was found, operation
cannot complete.

User response: Use the DSMC QUERY SESSION

command to verify your authorization. Ask your TSM
administrator to provide the necessary authorization or
to delete the file space for you.

System action: The requested operation failed.

0028 E
DSM_RS_ABORT_RULE_ALREADY_DEFED

0033 E
DSM_RC_ABORT_INVALID_OFFSET

'Access rule' Access Rule already defined for node

'node'. Old rule must be deleted before new one can
be defined.

partialObjOffset value for partial object retrieve is

invalid.

Explanation: You are trying to define authorization for

the specified node, which already has authorization
defined.
System action: TSM did not redefine authorization for
the specified node.
User response: Update the authorization, or delete the
old rule and define a new one, or use the current
authorization.

0029 S
DSM_RC_ABORT_NO_STOR_SPACE_STOP
Server out of data storage space
Explanation: The server does not have space available
to store the object.
System action: TSM ended the current operation.
User response: Report to your system administrator
that a storage pool on the server is full.

0030 E
DSM_RC_ABORT_LICENSE_VIOLATION
The operation is not permitted due to server licenses
values.
Explanation: The node or user is trying to perform an
operation that either exceeds license values, or is not
licensed.

280

User response: Try the operation with a different file

specification.

Explanation: The partialObjOffset value for partial

object retrieve is invalid.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.

0034 E
DSM_RC_ABORT_INVALID_LENGTH
partialObjLength value for partial object retrieve is
invalid.
Explanation: partialObjLength value for partial object
retrieve is invalid.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.

0036 E
DSM_RC_END_NODE_NOT_AUTHORIZED
The node or user does not have proper authority to
perform this operation
Explanation: The node or user does not have proper
authority to perform this operation.
System action: The transaction is ended.
User response: Check the authority for the specified
object.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

0041 E
DSM_RC_ABORT_EXCEED_MAX_MP

0049 E
DSM_RC_ABORT_INVALID_DATA_FORMAT

This node has exceeded its maximum number of

mount points.

A target storage pool does not have the correct data

format for the given node type.

Explanation: Either no tape or sequential disk mount

points are permitted for this operation, or the
maximum number of mount points allowed are already
in use. The operation can not be completed. The TSM
administrator defines the maximum number of mount
points with the MAXNUMMP property of your node
definition.

Explanation: none

System action: The object is skipped

0050 E
DSM_RC_ABORT_DATAMOVER_UNDEFINED

User response: If you are performing any other TSM

operations that might be using mount points, wait until
those operations are complete, then try the failed
operation again. Otherwise contact your TSM
administrator for further assistance

System action: TSM ended the current operation.

User response: Contact your system administrator for
more information.

No associated data mover is defined for the given

node.
Explanation: none
System action: TSM ended the current operation.

0045 E
DSM_RC_ABORT_MERGE_ERROR

User response: Contact your system administrator for

more information.

The specified objects failed the merge test.

Explanation: The specified objects failed the merge
test, operation cannot complete.
System action: The requested operation failed.
User response: See documentation for the merge test
parameters.

0047 E
DSM_RC_ABORT_INVALID_OPERATION
An invalid operation was attempted on a node

0051 E
DSM_RC_REJECT_NO_RESOURCES
Session rejected: All server sessions are currently in
use
Explanation: TSM has all available sessions in use and
cannot accept a new one at this time.
System action: TSM canceled the current operation.
User response: Retry the operation. If the problem
continues, see your system administrator to increase the
number of concurrently active sessions to the server.

Explanation: The operation is not valid.

System action: TSM ended the current operation.
User response: Contact your system administrator for
more information.

0052 E
DSM_RC_REJECT_VERIFIER_EXPIRED
The session is rejected. Your password has expired.
Explanation: Your TSM password has expired.

0048 E
DSM_RC_ABORT_STGPOOL_UNDEFINED
The specified target storage pool is not defined.
Explanation: The storage pool is not defined.
System action: TSM ended the current operation.

System action: TSM canceled the current operation.

You are not allowed to connect to the server until the
password is updated.
User response: Update your password. You may use
the SET PASSWORD command, or have the TSM
administrator update your node.

User response: Contact your system administrator for

more information.

Chapter 3. API return codes, version 6.3

281

0053 E
DSM_RC_REJECT_ID_UNKNOWN
Session rejected: Unknown or incorrect ID entered
Explanation: The node name you entered is not
known by the server, or you are attempting to access a
file migrated to a different node.
System action: TSM canceled the current operation.
You are not allowed to connect to the server until your
node name is registered with the server. If attempting
to access a migrated file, your node name must be the
same node which migrated the file.
User response: Ensure that you entered your TSM
node name correctly. If yes, see your system
administrator. Verify that the server is using closed
registration and that your node name is registered with
the server.

0054 E
DSM_RC_REJECT_DUPLICATE_ID

required by your system administrator. The server is

not configured to allow open registration.
System action: Session not started.
User response: You must obtain a TSM node and
password from your system administrator.

0057 S
DSM_RC_REJECT_CLIENT_DOWNLEVEL
Session rejected: Downlevel client code version
Explanation: The server version and your client
version do not match. The client code is downlevel.
System action: TSM canceled the current operation.
User response: See your system administrator to see
what version of TSM to run for your location.

0058 S
DSM_RC_REJECT_SERVER_DOWNLEVEL
Session rejected: Downlevel server code version

Session rejected: Duplicate ID entered

Explanation: Another process using this node name is
active with the server.
System action: TSM cannot connect to the server. TSM
canceled the current operation.
User response: If you are running a UNIX-based
system, ensure that another process is not active with
TSM under the same name. Also, ensure that your
node name is unique to the server so that it cannot be
used by another person. See your system administrator
to identify the owner of that node name.

0055 E
DSM_RC_REJECT_SERVER_DISABLED
Session rejected: Server disabled
Explanation: The server is in a disabled state and
cannot be accessed for normal activity.
System action: TSM canceled the current operation.
User response: Retry the operation after the server
returns to an enabled state. If the problem continues,
see your system administrator.

0056 E
DSM_RC_REJECT_CLOSED_REGISTER
The server is not configured to allow open
registration
Explanation: No authorization. Registration is

282

Explanation: The server version and your client

version do not match. The server code is downlevel.
System action: TSM canceled the current operation.
User response: See your system administrator to see
what version of TSM to run for your location.

0059 E
DSM_RC_REJECT_ID_IN_USE
Session Rejected: The specified node name is
currently in use
Explanation: The node name you specified is in use
on the server.
System action: Session was not started.
User response: The server is probably performing a
task that prevents your node from establishing a
session. Retry later or check with your system
administrator.

0061 E
DSM_RC_REJECT_ID_LOCKED
Session Rejected: The specified node name is
currently locked
Explanation: The node name you specified is currently
locked on the server.
System action: Session was not started.
User response: Check with your system administrator

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

to find out why your node name is locked.

0066 E
DSM_RC_REJECT_INTERNAL_ERROR
0062 S
DSM_RC_SIGNONREJECT_LICENSE_MAX
SLM LICENSE EXCEEDED: The client licenses for
TSM are exceeded. See your system administrator.
Explanation: Adding a new enrollment will exceed the
product license count for TSM.
System action: Execution of the client enrollment or
connection request ends.

The session is rejected. The TSM server has an

internal error.
Explanation: The client cannot establish a connection
to the TSM server because of an internal server error.
System action: The session was not started.
User response: Notify your TSM administrator of this
error.

User response: See your system administrator.

0067 S
DSM_RC_SIGNONREJECT_INVALID_CLI
0063 E
DSM_RC_REJECT_NO_MEMORY
Session Rejected: The server does not have enough
memory to allow a connection to be established.
Explanation: The server does not have enough
memory to allow your client to establish a connection
with the server.
System action: Session was not started.
User response: Retry later or see your system
administrator.

0064 E
DSM_RC_REJECT_NO_DB_SPACE
Session Rejected: The server does not have enough
database space to allow a connection to be
established.
Explanation: The server ran out of database space.
System action: Session was not started.

Session Rejected: The server is not licensed for this

platform type. See your system administrator.
Explanation: The server is not licensed for the
requesting client type.
System action: Execution of the client enrollment or
connection request ends.
User response: See your system administrator.

0068 E
DSM_RC_SESSION_CANCELED
Session Rejected: The session was canceled by the
server administrator.
Explanation: The server administrator canceled the
current client session.
System action: Execution of the client connection
request ends.
User response: See your system administrator.

User response: See your system administrator.

0068 E
DSM_RC_CLIENT_NOT_ARCHRETPROT
0065 E
DSM_RC_REJECT_NO_LOG_SPACE
Session Rejected: The server does not have enough
recovery log space to allow a connection to be
established.
Explanation: The server ran out of recovery log space.
System action: Session was not started.
User response: This error is a temporary problem.
Retry later or see your system administrator.

The session is rejected. The server does not allow a

signon of a client that is not archive-retention
protection enabled.
Explanation: The client cannot establish a connection
to the server because the server is enabled for
archive-retention protection enabled and the client is
not.
System action: The session is not started.
User response: See your system administrator.

Chapter 3. API return codes, version 6.3

283

space-management retention-protection.
0073 E
DSM_RC_REJECT_INVALID_NODE_TYPE
An inconsistency was detected between the client
node and the node that is registered to the TSM
server.
Explanation: The user has probably coded the node
option incorrectly. For instance, the node that is
registered to the TSM server might be a type of NAS,
but the node is actually a non-NAS client.
System action: The TSM operation ends.

Explanation: The client cannot establish a connection

to the server because the server is enabled for
space-management retention-protection and the client is
not.
System action: The session is not started.
User response: See your system administrator.

0101 W
DSM_RC_USER_ABORT

User response: Ensure that the node name is correct

in the client options file. Make sure to use a node of
type NAS only with the nasnodename option.

The operation was stopped by the user.

0074 E
DSM_RC_REJECT_INVALID_SESSIONINIT

System action: Processing stopped.

Server does not allow client-initiated connections for

this node.
Explanation: The node is not allowed to initiate
connections due to the configuration parameters for
this node on the server. Server is able to initiate
connections to the client scheduler running in
prompted mode.
System action: The IBM Tivoli Storage Manager
operation ends.
User response: Contact your systems administrator to
enable client-initiated sessions for your node or update
the SESSIONINITIATION option and run the client
scheduler.

0075 E
DSM_RC_REJECT_WRONG_PORT
Wrong server port.
Explanation: You were trying to open a
backup/archive client session on the server port set up
for administrative sessions only.
System action: The IBM Tivoli Storage Manager
operation ends.
User response: Contact your systems administrator
and/or use the correct values for TCP port and TCP
Admin Port.

0079 E
DSM_RC_CLIENT_NOT_SPMRETPROT
The session is rejected. The server does not allow a
signon of a client that is not enabled for

284

Explanation: The operation was stopped at the request

of the user. This usually occurs when the 'Q' key is
pressed two times.

User response: None.

0102 E
DSM_RC_NO_MEMORY
file name(line number)The operating system refused a
IBM Tivoli Storage Manager request for memory
allocation.
Explanation: IBM Tivoli Storage Manager requires
access to memory in order to store information as
processing proceeds. In this case, more memory was
requested than the operating system would allocate.
Possible reasons include:
The system is low on memory.
The process in which the program runs has
exceeded the maximum allocated memory.
Some other error condition occurred. No memory is
available.
System action: IBM Tivoli Storage Manager cannot
complete the requested operation.
User response: Close all unneeded applications and
try the operation again. If the operation still fails, try
dividing the task into several smaller units. For
example, if a file specification contains several
high-level directories, run the IBM Tivoli Storage
Manager task serially for each directory. If the IBM
Tivoli Storage Manager task is an incremental backup,
use the option "-memoryefficientbackup=yes".
For UNIX systems that support resource limits, you can
check if the memory resource limit is too low by
entering the following command: ulimit -a
Based on the resulting data, you can ask the UNIX
system root user to increase the resource limit above
the current default limit. The UNIX system root user
has the authority to increase resource limits.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

0104 E
DSM_RC_FILE_NOT_FOUND

0107 E
DSM_RC_NO_HANDLES

File not found during Backup, Archive or Migrate

processing

No file handles available

Explanation: The file being processed for backup,

archive or migrate no longer exists on the client.
Another process deleted the file before it could be
backed up, archived or migrated by TSM.
System action: File skipped.

Explanation: All file handles for your system are

currently in use. No more are available.
System action: Processing stopped.
User response: Either free some file handles by ending
other processes, or modify your system setup to allow
for more files to be open at the same time.

User response: None.

0105 E
DSM_RC_PATH_NOT_FOUND

0108 E
DSM_RC_FILE_EXISTS
The file exists and cannot be overwritten.

The specified directory path could not be found.

Explanation: An invalid or unreachable directory path
was specified.

Explanation: The file being restored or retrieved exists

and cannot be overwritten due to lack of authority or
access permissions.

System action: Processing stopped.

System action: The file is skipped.

User response: Try the operation again using a valid

directory path.

User response: Verify that you have sufficient access

permissions to overwrite the file, then try the operation
again. If the problem persists, contact your system
administrator or TSM administrator for further
assistance.

0106 E
DSM_RC_ACCESS_DENIED
Access to the specified file or directory is denied
Explanation: Access to the specified file or directory is
denied. You tried to read from or write to a file and
you do not have access permission for either the file or
the directory.
System action: Processing stopped.
User response: Ensure that you specified the correct
file or directory name, correct the permissions, or
specify a new location.

0106 E
DSM_RC_ACCESS_DENIED

0109 E
DSM_RC_INVALID_PARM
Invalid parameter was found.
Explanation: The system encountered an internal
program error due to an invalid parameter.
System action: The system returns to the calling
procedure.
User response: Ask your service representative to
check the error log.

0110 E
DSM_RC_INVALID_HANDLE

The specified file is being used by another process

Explanation: The specified file is being used by
another process. You tried to read from or write to a
file that is currently being used by another process.

An invalid file handle was passed; system error.

Explanation: An internal system error occurred: A file
operation failed because of an invalid file handle.

System action: Processing stopped.

System action: processing stops.

User response: Ensure that you specified the correct

file or directory name, correct the permissions, or
specify a new location.

User response: Try the operation again. If the failure

persists, obtain a service trace that captures the
problem and contact IBM technical support for
additional assistance. Your TSM administrator can help
you configure the trace.

Chapter 3. API return codes, version 6.3

285

0111 E
DSM_RC_DISK_FULL
Processing stopped; Disk full condition
Explanation: No more files can be restored or
retrieved because the destination disk is full.
System action: Processing stopped.
User response: Free up disk space, or restore or
retrieve the file to another disk.

persists, contact TSM technical support for further

assistance.

0116 E
DSM_RC_FILE_BEING_EXECUTED
File is in use; Write permission denied.
Explanation: The current file cannot be opened to
write to because it is currently being run by another
operation.
System action: File skipped.

0113 E
DSM_RC_PROTOCOL_VIOLATION

User response: Stop the operation that is running the

file and retry the operation, or restore or retrieve the
file to a different name or directory.

Protocol violation
Explanation: A communications protocol error
occurred. The communication subsystem is not
properly defined or is itself in error.
System action: TSM ended the current operation.
User response: Verify that the communication
processes are operating properly, and then retry the
operation.

0117 E
DSM_RC_DIR_NO_SPACE
No more files can be restored or retrieved since the
destination directory is full.
Explanation: No more files can be restored or
retrieved since the destination directory is full.
System action: Processing stopped.

0114 E
DSM_RC_UNKNOWN_ERROR
An unknown system error has occurred from which
TSM cannot recover.
Explanation: An unknown error occurred. This might
be a low-level system or communication error from
which TSM cannot recover.
System action: Processing stops.
User response: Try the operation again. If the problem
persists, review the TSM error log for any related
messages. Obtain a service trace that captures the
problem and contact IBM technical support for
additional assistance. Your TSM administrator can help
you configure the trace.

0115 E
DSM_RC_UNEXPECTED_ERROR
An unexpected error occurred.
Explanation: This is usually caused by a low-level
system error or communication error from which TSM
cannot recover.
System action: Processing stopped.
User response: Examine the client error log for any
additional messages that might be related to this
problem. Try the operation again. If the problem

286

User response: Free up disk space, or restore or

retrieve the file to another disk.

0118 E
DSM_RC_LOOPED_SYM_LINK
Too many symbolic links were detected while
resolving name
Explanation: While trying to resolve the file name, too
many symbolic links were found.
System action: File skipped.
User response: Ensure that you do not have a looping
symbolic link for the file.

0119 E
DSM_RC_FILE_NAME_TOO_LONG
The file name is too long and can not be processed by
TSM
Explanation: The size limit for file names may vary by
operating system. The most common limit is 256
characters. The file name being processed exceeds the
limit supported by TSM on this system.
System action: The file is skipped.
User response: Enter HELP FILE SPEC or see the
client manual for the operating system on which you

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

are receiving this error. The "File specification syntax"

section of the manual explains file name lengths
supported by TSM.

0124 E
DSM_RC_FILE_SPACE_NOT_FOUND
File space 'filespace-name' does not exist

0120 E
DSM_RC_FILE_SPACE_LOCKED

Explanation: The specified file space (domain) is

incorrect or does not exist on the machine.

File system is locked by system

System action: Processing stopped.

Explanation: File system cannot be accessed because it

is locked by the system.

User response: Retry the operation specifying an

existing domain (drive letter or file system name).

System action: TSM cannot complete the operation.

User response: See your system administrator.

0125 E
DSM_RC_TXN_ABORTED

0121 I
DSM_RC_FINISHED

Transaction aborted

The operation is finished.

Explanation: The operation is finished.
System action: The system returns to the calling
procedure.

Explanation: The current transaction between the

server and the client stopped. A server, client, or
communication failure cannot be recovered.
System action: TSM canceled the current operation.

User response: Proceed with next function call.

User response: Retry the operation. If the problem

continues, see your system administrator to isolate the
problem.

0122 E
DSM_RC_UNKNOWN_FORMAT

0126 E
DSM_RC_SUBDIR_AS_FILE

The file has an unknown format.

TSM cannot build a directory path because a file

exists with the same name as the directory.

Explanation: TSM tried to restore or retrieve a file, but

it had an unknown format.

Explanation: None

System action: The file is skipped.

System action: Processing stopped.

User response: The file was either backed up by

another application, or the data is invalid. If the file
belongs to this system, try the operation again. If the
problem persists, contact IBM technical support for
further assistance.

User response: Remove or rename the file that has the

same name as the directory. Alternatively, you can
restore the directory to a different location.

0127 E
DSM_RC_PROCESS_NO_SPACE
0123 E
DSM_RC_NO_AUTHORIZATION

Disk space limit for this process reached

Not authorized to restore the other node's data.

Explanation: The disk space allocated for the client

owner is full.

Explanation: The client is not authorized to restore the

other node's data.

System action: Processing stopped.

System action: The system returns to the calling

procedure.

User response: Free up disk space and retry the

restore or retrieve operation.

User response: Get authorization from the other node.

0128 E
DSM_RC_PATH_TOO_LONG

Chapter 3. API return codes, version 6.3

287

Destination directory path length exceeds system

maximum
Explanation: The path name specified plus the path
name in the restored file name combine to create a
name whose length exceeds the system maximum.
System action: Processing stopped.
User response: Specify a destination path that, when
combined, is less than the system maximum.

0129 E
DSM_RC_NOT_COMPRESSED

the TSM Server: audit volume <volume_name> fix=no

If there is any problem reported, you could move the
data from that volume to a new one (see command
MOVE DATA) and try again the restore. 2) There are
communications problems between the TSM Server and
the TSM Client and the results is that the file is
corrupted during the transmission. If you use a gigabit
Ethernet adapter on the Server please upgrade the card
driver (AIX platform) or add provided by SUN
suggested changes to some system network options
which have resolved this problem (SUN platform). 3)
Please verify with your network support if during the
restore there are no any problems between the TSM
Client/Server that is originating the file corruption.

File is not compressed; System failure.

Explanation: A file that was flagged as compressed
was not compressed, and the system failed.

0131 S
DSM_RC_SYSTEM_ERROR

System action: Processing stopped.

An internal program error occurred.

User response: See your system administrator to

report this problem. This error is a system failure.

Explanation: TSM encountered an unexpected

condition and can not continue the operation. This
might be a programming error.

0130 E
DSM_RC_TOO_MANY_BITS
File compressed on a different client machine that has
more memory
Explanation: You are trying to restore a file that was
backed up and compressed on another client
workstation that had more memory than your client
workstation. You cannot restore this file. When the file
is restored, it is expanded and your workstation does
not have enough memory.
System action: TSM canceled the operation.
User response: Obtain a machine with more memory
and retry the operation.

0131 E
DSM_RC_COMPRESSED_DATA_CORRUPTED
The compressed file is corrupted and cannot be
expanded correctly.
Explanation: The compressed file cannot be expanded
correctly due to one of the following reasons:
There is a problem on the tape.
There is a communications problem.
The compressed file was corrupted on the TSM
Server.
System action: File skipped.
User response: 1) The compressed file is corrupted
because there is a problem on the tape. To know if this
is the problem, please issue the following command on

288

System action: processing stops.

User response: Try the operation again. If the problem
persists, contact your TSM administrator or IBM
technical support for further assistance.

0132 E
DSM_RC_NO_SERVER_RESOURCES
The TSM server is out of resources.
Explanation: A lack of a storage resource or a
maximum value condition does not allow any new
activity.
System action: TSM canceled the current operation.
User response: Try the operation again at a later time.
If the problem continues, contact your TSM
administrator to isolate what resource is unavailable.
The TSM administrator can check the TSM server
activity log for messages that might explain the
problem.

0133 E
DSM_RC_FS_NOT_KNOWN
The file space for domain 'domain-name' could not be
found on the TSM server.
Explanation: The specified file space was expected to
be found on the server, but it no longer exists. It is
possible that a command was issued to delete the file
space from the server while the current operation was
in progress.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: TSM processing stops.

System action: TSM canceled the current operation.

User response: Try the operation again. If the problem

recurs, check the error log for any other messages that
might indicate a reason for the failure. Try to correct
any indicated problems, then try the operation again. If
the problem persists, contact IBM technical support for
further assistance.

User response: Enter your correct password. If you

cannot remember the correct password, see your
system administrator to have a new one assigned for
your node name.

0138 E
DSM_RC_TA_NOT_VALID
0134 E
DSM_RC_NO_LEADING_DIRSEP
The objName field has no leading directory separator.
Explanation: The objName field does not have a
leading directory separator.
System action: The system returns to the calling
procedure.

The trusted agent execution/owner permissions are

invalid.
Explanation: The trusted agent execution/owner
permissions are invalid.
System action: Processing stopped.

User response: Correct the value for the objName.

User response: Have your system administrator check

the installation instructions for the client to ensure that
the trusted agent permissions are set correctly.

0135 E
DSM_RC_WILDCARD_DIR

0139 S
DSM_RC_KILLED

Wildcards are not allowed in the objName directory

path.

Process killed.

Explanation: Wildcards are not allowed in the

objName directory path.
System action: The system returns to the calling
procedure.

Explanation: Processing stopped. This is a

programming failure and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

User response: Correct the value for the objName.

0136 E
DSM_RC_COMM_PROTOCOL_ERROR

0145 S
DSM_RC_WOULD_BLOCK
Trusted agent would block the operation.

The session is rejected: There was a communications

protocol error.
Explanation: An unexpected network message was
received by the client. This could be caused by network
problems or a programming error.
System action: TSM canceled the current operation.
User response: Verify that your communication path
is functioning properly and try the operation again. If
the problem persists, contact your TSM administrator
for further assistance.

Explanation: The trusted agent blocks the operation.

This is a programming failure and the client program
ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

0146 S
DSM_RC_TOO_SMALL
The area for the include/exclude pattern is too small.

0137 E
DSM_RC_AUTH_FAILURE
Session rejected: Authentication failure
Explanation: Authentication failure. You entered an
incorrect password.

Explanation: The area for the include/exclude pattern

is too small. This is a programming failure and the
client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
Chapter 3. API return codes, version 6.3

289

continues, contact your system administrator.

0151 S
DSM_RC_BUFFER_OVERFLOW
0147 S
DSM_RC_UNCLOSED
There is no closing bracket in the pattern.
Explanation: There is no closing bracket in the
pattern. This is a programming failure and the client
program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

0148 S
DSM_RC_NO_STARTING_DELIMITER

The data buffer overflowed.

Explanation: The data buffer overflowed. This is a
programming failure and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

0154 E
DSM_RC_NO_COMPRESS_MEMORY
Insufficient memory for file compression/expansion

Explanation: The include or exclude pattern must start

with a directory delimiter.

Explanation: Not enough memory is available to do

data compression or expansion. For a restore or
retrieve, the file cannot be recalled from the server until
more storage is made available. For a backup or
archive, try running without compression if storage
cannot be made available.

System action: Processing stopped.

System action: Processing stopped.

User response: Correct the syntax for the pattern.

User response: Free up extra storage for the operation

to continue, or run the backup or archive process
without compression enabled.

Include/Exclude pattern must start with a directory

delimiter

0149 S
DSM_RC_NEEDED_DIR_DELIMITER
A beginning or ending directory delimiter is missing
from the Include/Exclude pattern.
Explanation:

0155 T
DSM_RC_COMPRESS_GREW
Compressed Data Grew

1. The include/exclude pattern has a '...' without a

beginning or ending directory delimiter.

Explanation: The size of the file after compression is

greater than the size of the file before compressed.

2. For Windows, the drive seperator is not

immediately followed by a directory delimiter.

System action: Even though the size of the file

increased, the file is compressed.

System action: Processing stopped.

User response: None.

User response: Correct the syntax for the pattern.

0150 S
DSM_RC_UNKNOWN_FILE_DATA_TYPE
The structured file data type is unknown.
Explanation: An unknown and unexpected error code
occurred within the client program. The structured file
data type is unknown. This is a programming failure
and the client program ends.
System action: Processing stopped.
User response: Retry the operation. If the problem
continues, contact your system administrator.

290

0156 E
DSM_RC_INV_COMM_METHOD
An unsupported communications method was
specified.
Explanation: None.
System action: processing stops.
User response: Specify a communications interface
that is supported by the TSM client on your operating
system. See the TSM client manual for your operating
system for further information on configuring TSM
client communications.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

0157 S
DSM_RC_WILL_ABORT

0161 E
DSM_RC_TA_ACCESS_DENIED

The transaction will be aborted.

Access denied for dsmapitca.

Explanation: The server encountered an error and will

abort the transaction.

Explanation: An attempt to access a system function

has been denied.

System action: The transaction will be aborted. The

reason code is passed on the dsmEndTxn call.

System action: Processing stopped.

User response: Contact your system administrator.

User response: Issue the dsmEndTxn with a vote of

DSM_VOTE_COMMIT and examine the reason code.
0162 E
DSM_RC_FS_NOT_READY
0158 E
DSM_RC_FS_WRITE_LOCKED
Destination file or directory is write locked
Explanation: The file or directory being restored or
retrieved from the server cannot be written to because
the destination is write locked. Another operation
might have the file open and will not allow it to be
updated.

File system/drive not ready

Explanation: The file system/drive was not ready for
access.
System action: Processing stopped.
User response: Ensure that the drive is available to
TSM, and then retry the operation.

System action: File skipped.

User response: Either determine which operation has
the file write locked, or restore the file to another name
or location.

0159 I
DSM_RC_SKIPPED_BY_USER
A file was skipped during a restore operation because
the file is off line and the application has chosen not
to wait for a tape mount.
Explanation: A file was skipped during a restore
operation because the file is off line and the application
has chosen not to wait for a tape mount.

0164 E
DSM_RC_FIO_ERROR
File input/output error
Explanation: An error was found while reading from
or writing to the file.
System action: File or file system is skipped.
User response: Check your system to ensure that it is
operating properly. For OS/2, run CHKDSK /F for the
failing drive which can be found in dsmerror.log.

0165 E
DSM_RC_WRITE_FAILURE

System action: File skipped.

User response: Verify the application sets the
mountWait value correctly on dsmBeginGetData.

0160 E
DSM_RC_TA_NOT_FOUND

File write error

Explanation: An error was found while writing to the
file.
System action: File skipped.
User response: Check your system to ensure that it is
operating properly.

Unable to find Trusted Agent module.

Explanation: TSM was unable to find the TSM Trusted
Agent module in the specified directory. The name of
the TSM Trusted Agent module is dsmtca.

0166 E
DSM_RC_OVER_FILE_SIZE_LIMIT

System action: TSM ends.

File exceeds system/user file limits

User response: Make sure the Trusted Agent module

is in the directory specified by DSMI_DIR.

Explanation: A file being restored or retrieved exceeds

system set limits for this user.

Chapter 3. API return codes, version 6.3

291

System action: File skipped.

System action: processing stops.

User response: Ensure that the system limits are set

properly.

User response: Perform the following actions to

resolve this error:
v Run the product in interactive mode.

0167 E
DSM_RC_CANNOT_MAKE
Cannot make file/directory
Explanation: The directory path for files being
restored or retrieved cannot be created.
System action: File skipped.
User response: Ensure that you have the proper
authorization to create the directory for file being
restored or retrieved. Make sure that you have write
access.

0168 E
DSM_RC_NO_PASS_FILE

v Ensure your password is set correctly.

0174 E
DSM_RC_REJECT_PLATFORM_MISMATCH
Session rejected: Node type mismatch
Explanation: Your node name is associated with a
different type of operating system (such as OS/2 or
AIX) and cannot be used on this system.
System action: TSM canceled the current operation.
User response: If you need a new node name, see
your system administrator to assign a new one to you.
Generally, you have a unique node name for each
machine and operating system pair that requires access
to the server.

Password file is not available.

Explanation: The file containing the stored password
for the specified server-name is unavailable.
System action: TSM ends.
User response: The root user must set and store a new
password.

0175 E
DSM_RC_TL_NOT_FILE_OWNER
Not file owner
Explanation: The file cannot be backed up because the
client is not the file owner.
System action: TSM skips the file.

0169 E
DSM_RC_VERFILE_OLD

User response: None.

PASSWORDACCESS is GENERATE, but password

needed for server 'server-name'. Either the password is
not stored locally, or it was changed at the server.

0177 S
DSM_RC_UNMATCHED_QUOTE

Explanation: Either the password is not stored locally,

or it was changed at the server.
System action: TSM prompts you for the password if
TSM is running in the foreground.
User response: If TSM was running as a background
process, issue any TSM command from the foreground.
Enter the password in answer to the prompt. Then try
your background TSM command again.

0173 E
DSM_RC_INPUT_ERROR
The process is running in a non-interactive mode, but
requires user input.
Explanation: This process requires keyboard input,
but non-interactive processes are unable to read input
from keyboard.

292

Quotes are not matched

Explanation: The quotes specified in the pattern are
not the same and do not make a set.
System action: Processing stopped.
User response: Correct the pattern by using matching
quotes in the syntax.

0184 E
DSM_RC_TL_NOBCG
The management class for this file does not have a
valid backup copy group. This file will not be backed
up.
Explanation: The management class for this file does
not have a backup copy group specified. This file will
not be backed up.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Processing stopped.

User response: Add a valid backup copy group to the
management class, and then retry the operation.

0185 W
DSM_RC_TL_EXCLUDED
File 'file-namefile-namefile-name' excluded by
Include/Exclude list
Explanation: You can not back up, archive, or migrate
files that are excluded.
System action: TSM does not process the file.

with the TSM server, or there is no active policy set for

the node.
System action: Processing stops.
User response: Verify that the node whose data you
are trying to access is registered with the TSM server. If
you have more than one TSM server, make sure you
are connecting to the correct server, then try the
operation again. If the problem persists, contact your
TSM administrator for further assistance.

0189 S
DSM_RC_PS_INVALID_DIRMC

User response: If the file is intentionally excluded,

then this message can be ignored. Otherwise modify
the include/exclude list, restart the client, and try the
operation again. Contact your TSM administrator for
further assistance.

The management class assigned to directories does

not exist.

0186 E
DSM_RC_TL_NOACG

System action: processing stops.

The management class for this file does not have a

valid archive copy group. This file will not be
archived.
Explanation: The management class for this file does
not have an archive copy group specified. This file will
not be archived.

Explanation: The management class named on the

DIRMC option does not exist in your assigned policy
set on the server. The error log contains an entry
showing the invalid management class name.

User response: Remove the current DIRMC option

from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.

System action: Processing stopped.

User response: Add a valid archive copy group to the
management class, and then retry the operation.

0187 E
DSM_RC_PS_INVALID_ARCHMC
Invalid management class entered
Explanation: You entered an invalid management
class.
System action: TSM is unable to do the requested
operation.
User response: Retry the operation using a valid
management class.

0188 S
DSM_RC_NO_PS_DATA

0190 S
DSM_RC_PS_NO_CG_IN_DIR_MC
There is no backup copy group in the management
class used for directories.
Explanation: The DIRMC option names a
management class that contains no backup copy group.
System action: processing stops.
User response: Remove the current DIRMC option
from the client options file, then run DSMC QUERY
MGMTCLASS -DETAIL to view information about
available management classes. Make sure the
management class you select has a backup copy group.
If you have more than one TSM server, make sure you
are connecting to the correct server. If you are unable to
find a suitable management class, contact your TSM
administrator for further assistance.

Either the node does not exist on the server or there is

no active policy set for the node.

0231 E
DSM_RC_ABORT_MOVER_TYPE

Explanation: This error occurs when you try to access

another node's data. Either the node is not registered

Unknown Remote Mover type

Chapter 3. API return codes, version 6.3

293

Explanation: The specified Remote Mover type is

unknown.

User response: Contact your system administrator for

more information.

System action: TSM ended the current operation.

User response: Contact your system administrator for
more information.

0232 E
DSM_RC_ABORT_ITEM_IN_USE
An Operation for the requested node and filespace is
already in progress.
Explanation: A request has been made to use a data
mover to perform an operation for the indicated node
and filespace. Since an operation for this node and
filespace is already in progress, the new operation
cannot be performed.
System action: TSM ended the current operation.

0236E
DSM_RC_ABORT_CRC_FAILED
The CRC received from the Server does not match the
CRC calculated by the client.
Explanation: The server sent a CRC for a buffer. The
client calculated a CRC for the same buffer. These did
not match. The mismatch indicates a communication
failure.
System action: In some cases, the client can indicate
the failure to the server and retry the operation.
User response: Check the trace log for additional
information and retry the operation. If the problem
persists, contact your system administrator.

User response: Retry the operation at a later time.

0237E
DSM_RC_ABORT_INVALID_GROUP_ACTION
0233 E
DSM_RC_ABORT_LOCK_CONFLICT
System resource in use
Explanation: A required resource is in use by another
command or process.
System action: TSM ended the current operation.

An invalid operation was attempted on a group leader

or group member.
Explanation: An invalid operation was attempted on a
logical group.
System action: The current operation stops.
User response: Retry a valid operation.

User response: Retry the operation at a later time.

0234 E
DSM_RC_ABORT_SRV_PLUGIN_COMM_ERROR

0238E
DSM_RC_ABORT_DISK_UNDEFINED
Remote disk not defined.

Server plugin communication error

Explanation: Communication between a server plugin
module and a NAS filer failed.
System action: TSM ended the current operation.

Explanation: An operation was attempted on a remote

disk that is not defined.
System action: The current operation stops.
User response: Define the proper remote disk.

User response: Contact your system administrator for

more information.
0239E
DSM_RC_ABORT_BAD_DESTINATION
0235 E
DSM_RC_ABORT_SRV_PLUGIN_OS_ERROR
Server plugin detected unsupported NAS filer
operating system.
Explanation: A plugin module detected that a NAS
filer is running an unsupported operating system or
operating system level.
System action: TSM ended the current operation.

294

Input destination does not match expected

destination.
Explanation: Input destination does not match
expected destination.
System action: The current operation stops.
User response: Retry operation with proper
destination.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Processing stopped.

0240E
DSM_RC_ABORT_DATAMOVER_NOT_AVAILABLE
Data mover is not available.

User response: Check the client, server, and storage

agent logs to determine why the client was not able to
send data LAN-free. Make sure the client configuration
and server options are compatible.

Explanation: Data mover is not available.

System action: The current operation stops.
User response: Retry operation with a proper Data
mover.

0247 E
DSM_RC_ABORT_INSERT_NOT_ALLOWED
This server does not support backup operations.

0241E
DSM_RC_ABORT_STGPOOL_COPY_CONT_NO
Operation failed because the copy continue option
was set to NO.

Explanation: This server only supports archive

operations, backup is not allowed.
System action: Current operation ends.
User response: Use only archive operations with this
server.

Explanation: Operation failed because the copy

continue option was set to NO.
System action: The current operation stops.
User response: This abort code indicates that a store
operation, like backup or archive failed because the
copy continue option was set to NO. The sysadmin will
need to resolve the problem on the server end.

0242E
DSM_RC_ABORT_RETRY_SINGLE_TXN
Transaction failed because of a problem during a
store operation.
Explanation: Transaction failed because of a problem
during a store operation. This error is typical when the
next storage pool has a different copy storage pool list
and we switch to this pool in the middle of a
transaction.
System action: Transaction is aborted.
User response: Resend objects in separate transactions.

0248 E
DSM_RC_ABORT_DELETE_NOT_ALLOWED
Deleting this object: "fshlll" is not allowed.
Explanation: The object is either under a hold and
cannot be deleted, or it is on a retention-protection
enabled server and has not expired.
System action: The object is skipped and processing
continues.
User response: Check the status of the object through
a query to see if it is held, or when it expires.

0249 E
DSM_RC_ABORT_TXN_LIMIT_EXCEEDED
The number of objects in this transaction exceed
TXNGROUPMAX values.
Explanation: There are too many objects in this
transaction.
System action: Current operation ends.

0245 E
DSM_RC_ABORT_PATH_RESTRICTED
The current client configuration does not comply with
the value of the DATAWRITEPATH or
DATAREADPATH server option for this node.
Explanation: The values of the DATAWRITEPATH
and DATAREADPATH server options specify where the
client is allowed to send data, and where data is read
from. The values for the specified node name should
correspond with the client configuration. For example,
you will get this error message if DATAWRITEPATH
contains a LAN value and the client is configured to
use LAN-free protocol, or vice versa.

User response: Try the operation again with fewer

objects in the transaction, or increase the
TXNGROUPMAX value on the server.

0250 E
DSM_RC_ABORT_OBJECT_ALREADY_HELD
fshlll is already under hold.
Explanation: One of the objects in the transaction The
specified object is already under hold, and it cannot be
placed under a new hold.
System action: Current operation ends. This object is
skipped and processing continues.
Chapter 3. API return codes, version 6.3

295

User response: Issue a query to see the status of the

objects, and try the operation again, without the object
that is already held.

0292 E
DSM_RC_TCA_FORK_FAILED
Error starting the Trusted Communication Agent
process.
Explanation: An error has occurred starting the
Trusted Communication Agent process; specifically, the
fork() function has failed.
System action: TSM ends.
User response: Probable system error. If the problem
persists, restart the workstation.

0295 E
DSM_RC_TCA_INVALID_REQUEST
The TSM Trusted Communication Agent received an
invalid request.
Explanation: The Trusted Communication Agent is
invoked by the TSM client and has received an
unknown request argument in the call.
System action: TSM ends.
User response: It is possible the Trusted
Communication Agent was mistakenly invoked by a
process other than the TSM client. If that is not the
case, then this is an internal error. If the problem
recurs, contact your IBM service representative.

System action: Processing ends.

User response: Ask your system administrator for
assistance, and possibly increase the number of
semaphores in your system.

0298 E
DSM_RC_TCA_SEM_OP_ERROR
Error setting semaphore value or waiting on
semaphore.
Explanation: An error has occurred while attempting
to set or wait on a semaphore.
System action: Processing ends.
User response: Probable system error. If the problem
persists, restart the workstation.

0400 E
DSM_RC_INVALID_OPT
An invalid option was found during option parsing.
Explanation: An invalid option was found.
System action: The system returns to the calling
procedure.
User response: Verify the options in dsm.opt, dsm.sys,
and the options string. Check the error log for more
details about the error. on the AS/400 platform, verify
the options in *LIB/QOPTTSM(APIOPT).

0405 E
DSM_RC_NO_HOST_ADDR
0296 E
DSM_RC_TCA_NOT_ROOT
This action requires TSM administrative authority on
this system.
Explanation: An activity has been attempted that must
be performed by the TSM administrator (for example,
open registration, filespace delete or password update).
System action: TSM ends.
User response: If the activity is required, the
administrator for this system must perform it.

0297 E
DSM_RC_TCA_SEMGET_ERROR
Error allocating semaphores.
Explanation: An error has occurred because the
semaphores you are attempting to allocate have become
insufficient.

296

TCPSERVERADDRESS not defined for this server in

the System Options File
Explanation: The TCPSERVERADDRESS for this
server is not defined in the server name stanza in the
system options file.
System action: TSM initialization fails and the
program ends.
User response: See the TSM administrator for your
system, and make sure that the server to which you are
trying to connect, has a valid TCPSERVERADDRESS
defined in the system options file.

0406 S
DSM_RC_NO_OPT_FILE
Options file 'file-name' could not be found, or it cannot
be read.
Explanation: Common reasons for this error include:

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

v The default options file does not exist.

v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file you provided does not exist.
v The DSM_CONFIG (or DSMI_CONFIG if you are
using the IBM Tivoli Storage Manager API)
environment variable specifies an options file that
does not exist.
v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file that you provided is not in the standard file
encoding of the system. For example, on Windows
the expected file encoding is ANSI.
v You specified the -OPTFILE option when starting the
IBM Tivoli Storage Manager client, but the options
file that you provided does not have appropriate
read permissions for the user that is running the
operation.
System action: IBM Tivoli Storage Manager client
processing stops.
User response: Make sure that the options file you
want to use exists, it has the read rights set for the user
that is running the operation, and it is in the standard
file encoding of the system. For example, on Windows
the expected file encoding is ANSI. Review the
configuration information in the IBM Tivoli Storage
Manager client manual specific to your operating
system. If the problem persists, ask your IBM Tivoli
Storage Manager administrator for further assistance.

0408 E
DSM_RC_MACHINE_SAME
A virtual node name must not equal either a node
name or the system host name.
Explanation: A VIRTUALNODENAME option was
entered with a name the same as either a NODENAME
option or the system host name.
System action: Initialization fails and the program
ends.
User response: If the virtual node name entered was
the same as the host name, remove the virtual node
name option. If it was the same as the node name
option, you can remove either one, depending upon the
intended usage. Node name is used to assign an
alternate name to your system. Virtual node name is
used to access another system's server data.

0409 E
DSM_RC_INVALID_SERVER
Server name not found in System Options File
Explanation: The system options file does not contain
the SERVERNAME option.

System action: TSM initialization fails and the

program ends.
User response: See the TSM administrator for your
system, and make sure that the system options file
contains the server name.

0410 E
DSM_RC_INVALID_KEYWORD
An invalid option keyword was found during option
parsing.
Explanation: An invalid option keyword was found in
the dsmInit configuration file, the option string,
dsm.sys, or dsm.opt.
System action: The system returns to the calling
procedure.
User response: Correct the spelling of the option
keywords. Verify that the dsmInit configuration file
only has a subset of the dsm.sys options. Check the
error log for more details about the error.

0411 S
DSM_RC_PATTERN_TOO_COMPLEX
The include or exclude pattern cannot be parsed.
Explanation: The pattern is formatted incorrectly or is
too complex for TSM to interpret.
System action: Processing stopped.
User response: Verify that the include or exclude
pattern is specified correctly. If the pattern is correct,
then contact IBM technical support for further
assistance.

0412 S
DSM_RC_NO_CLOSING_BRACKET
Include/Exclude pattern is missing a closing bracket
Explanation: The include or exclude pattern is
incorrectly constructed. The closing bracket is missing.
System action: Processing stopped.
User response: Correct the syntax for the pattern.

0426 E
DSM_RC_CANNOT_OPEN_TRACEFILE
Initialization functions cannot open the trace file
specified.
Explanation: The file "tracefile-name could not be
opened during initialization. The specified path may be
Chapter 3. API return codes, version 6.3

297

incorrect. It is also possible that the current user does

not have permission to write to the tracefile in the
directory specified. It is also possible that no space is
available at the given tracefile location.

System action: The requested operation does not run.

User response: Create a volume label on the
removable media, then try the operation again.

System action: Processing terminates.

User response: Make sure the tracefile option points
to a valid path and that the user has proper
permissions to write to the file specified.

0610 E
DSM_RC_NLS_CANT_OPEN_TXT
Unable to open message text file.

0427 E
DSM_RC_CANNOT_OPEN_LOGFILE
Initialization functions cannot open the Error Log file
specified.
Explanation: The Error Log file could not be opened
during initialization. The specified path may be
incorrect. It is also possible that the current user does
not have permission to write to the logfile in the
directory specified. It is also possible that no space is
available at the given logfile location.
System action: Processing terminates.
User response: Make sure the logfile option points to
a valid path and that the user has proper permissions
to write to the file specified.

0600 E
DSM_RC_DUP_LABEL
A duplicate volume label exists. The operation cannot
continue.
Explanation: For removable media, TSM uses the
volume label as the file space name. To prevent data
from different volumes being stored in the same file
space on the TSM server, backup or archive of
removable media volumes having duplicate volume
labels is not allowed.
System action: The requested operation does not run.
User response: Change the volume labels on the
removable media volumes so that there are no
duplicate labels. Then restart TSM and try the
operation again.

Explanation: The system is unable to open the

message txt file (dscenu.txt or dsmclientV3.cat for AIX).
On the AS/400 platform this file is
QANSAPI/QAANSENU(TXT).
System action: The system returns to the calling
procedure.
User response: Verify that the dscenu.txt file is in the
directory pointed to by DSMI_DIR. For AIX, verify that
the dsmclientV3.cat file has a symbolic link to
/usr/lib/nls/msg/<locale>/dsmclientV3.cat .

0611 E
DSM_RC_NLS_CANT_READ_HDR
Unable to use message text file.
Explanation: The system is unable to use the message
text file (dscenu.txt or dsmclientV3.cat for AIX) because
of an invalid header. On the AS/400 platform this file
is QANSAPI/QAANSENU(TXT).
System action: The system returns to the calling
procedure.
User response: Install the message text file again.

0612 E
DSM_RC_NLS_INVALID_CNTL_REC
Unable to use message text file.
Explanation: The system is unable to use the message
txt file (dscenu.txt or dsmclientV3.cat for AIX) because
of an invalid control record. On the AS/400 platform
this file is QANSAPI/QAANSENU(TXT).
System action: The system returns to the calling
procedure.

0601 E
DSM_RC_NO_LABEL
The drive has no label. The operation cannot
continue.
Explanation: Backup or archive of removable media
requires that the media have a volume label. An
attempt was made to back up or archive data on a
removable volume that has no label.

298

User response: Install the message text file again.

0613 E
DSM_RC_NLS_INVALID_DATE_FMT
Invalid value for DATEFORMAT specified.
Explanation: An invalid value is specified for
DATEFORMAT.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: The system returns to the calling

procedure.

value specified for ERRORLOGNAME in the API

options file.

User response: Specify a valid value.

0614 E
DSM_RC_NLS_INVALID_TIME_FMT
Invalid value for TIMEFORMAT specified.
Explanation: An invalid value is specified for
TIMEFORMAT.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.

0615 E
DSM_RC_NLS_INVALID_NUM_FMT
Invalid value for NUMBERFORMAT specified.
Explanation: An invalid value is specified for
NUMBERFORMAT.

0622 E
DSM_RC_LOG_NOT_SPECIFIED
The log file name was not specified.
Explanation: The system is unable to open the error
log file.
System action: The system returns to the calling
procedure.
User response: Verify the DSMI_LOG value and
access permission. On the AS/400 platform, verify the
value specified for ERRORLOGNAME in the API
options file.

0927 E
DSM_RC_NOT_ADSM_AUTHORIZED
Only a TSM authorized user can perform this Action.

System action: The system returns to the calling

procedure.

Explanation: User must be a TSM authorized user to

perform this action. User is not password authorized
and this action requires authorization.

User response: Specify a valid value.

System action: Processing stopped.

0620 E
DSM_RC_LOG_CANT_BE_OPENED
Unable to open error log file.
Explanation: The system is unable to open the error
log file.
System action: The system returns to the calling
procedure.
User response: Verify the DSMI_LOG value and
access permission. On the AS/400 platform, verify the
value specified for ERRORLOGNAME in the API
options file.

User response: User must be root user, or user must

be the owner of the executable and the set effective
user id bit is set to 'on' ('s' bit).

961 E
DSM_RC_DIRECT_STORAGE_AGENT
_UNSUPPORTED
Direct connection to the Storage Agent is not allowed.
Explanation: You cannot connect directly to the
Storage Agent.
System action: Processing stopped.
User response: To perform Lanfree operations using
the Storage Agent, specify the ENABLELANFREE
option in your options file, and restart the process.

0621 E
DSM_RC_LOG_ERROR_WRITING_TO_LOG
The log file cannot be written to.
Explanation: There was an error writing to the log
file.
System action: The system returns to the calling
procedure.
User response: Verify the DSMI_LOG value and
access permission. on the AS/400 platform, verify the

963 E
DSM_RC_FS_NAMESPACE_DOWNLEVEL
The long namespace has been removed from the local
filespace. If you wish to proceed with the
backup/archive operation, rename your filespace on
the server.
Explanation: TSM has detected that the server
namespace is NTW:LONG, but the local volume does
not have long name support. If you would like to back
Chapter 3. API return codes, version 6.3

299

up the volume using the short names, rename the

filespace on the server. If you would like to back up
using long names, add the long namespace support
back to the volume in question.

1376 E
DSM_RC_DIGEST_VALIDATION_ERROR

System action: Processing stopped.

Error processing 'filespace namepath-namefile-name';

end-to-end digest validation failed.

User response: Add the long namespace support to

the volume or rename(remove) the corresponding
server filespace.

0996 E
DSM_RC_SERVER_DOWNLEVEL_FUNC
The TSM server is downlevel and does not support
the requested function. See error log for version
information.
Explanation: The function being used requires a more
current TSM Server.
System action: The operation fails.
User response: Upgrade your TSM Server to a level
that supports this function. See error log for version
information.

0997 E
DSM_RC_STORAGEAGENT_DOWNLEVEL
The TSM Storage Agent is downlevel and does not
support the requested function. See error log for
version information.
Explanation: The function being used requires a more
current TSM Storage Agent.

Explanation: Cryptographic digest of the restored or

retrieved data did not match the digest generated
during the backup or archive operation. Possible causes
are a transmission error, data corruption, or a hash
collision.
System action: Processing stops
User response: Try the restore operation again. If the
problem persists, contact IBM technical support for
additional assistance.

2000 E
DSM_RC_NULL_OBJNAME
The object name pointer is NULL.
Explanation: There is no value provided for the object
name pointer.
System action: The system returns to the calling
procedure.
User response: Provide an address for the
dsmObjName structure.

2001 E
DSM_RC_NULL_DATABLKPTR

System action: The operation fails.

The data block pointer is NULL.

User response: Upgrade your TSM Storage Agent to a

level that supports this function. See error log for
version information.

Explanation: There is no value provided for the data

block pointer.

0998 E
DSM_RC_SERVER_AND_SA_DOWNLEVEL

System action: The system returns to the calling

procedure.
User response: Provide an address for the DataBlk
structure.

The TSM Server and TSM Storage agent are

downlevel and do not support the requested function.
See error log for version information.

2002 E
DSM_RC_NULL_MSG

Explanation: The function being used requires a more

current TSM Server and TSM Storage agent

msg parameter for dsmRCMsg is a NULL pointer.

System action: The operation fails.

Explanation: The message parameter for dsmRCMsg

is a NULL pointer.

User response: Upgrade your TSM Server and TSM

Storage agent to a level that supports this function. See
error log for version information.

System action: The system returns to the calling

procedure.
User response: Allocate enough space for the message
parameter.

300

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

2004 E
DSM_RC_NULL_OBJATTRPTR
The object attribute pointer is NULL.
Explanation: There is no value provided for the object
attribute pointer.

Explanation: There is no value provided for the

dataBlk bufferPtr.
System action: The system returns to the calling
procedure.
User response: Provide an address for the bufferPtr.

System action: The system returns to the calling

procedure.

2010 E
DSM_RC_INVALID_OBJTYPE

User response: Provide an address for the ObjAttr

structure.

The objType is invalid.

Explanation: The value for the objType is invalid.

2006 E
DSM_RC_NO_SESS_BLK
There is no server session information.
Explanation: The server did not respond with the
session information.
System action: The system returns to the calling
procedure.

System action: The system returns to the calling

procedure.
User response: The value for dsmObjName.objType
must be:
DSM_OBJ_FILE or DSM_OBJ_DIRECTORY for
Backup, or
DSM_OBJ_FILE for Archive.

User response: Verify the server status.

2011 E
DSM_RC_INVALID_VOTE

2007 E
DSM_RC_NO_POLICY_BLK

The dsmEndTxn vote is invalid.

There is no server policy information.

System action: The system returns to the calling

procedure.

Explanation: The server did not respond with the

policy information.
System action: The system returns to the calling
procedure.

Explanation: The dsmEndTxn vote is invalid.

User response: The vote must be

DSM_VOTE_COMMIT or DSM_VOTE_ABORT.

User response: Verify the server policy definitions.

2012 E
DSM_RC_INVALID_ACTION

2008 E
DSM_RC_ZERO_BUFLEN

The update action is invalid.

The dataBlk bufferLen value is zero.

Explanation: The value for the dataBlk bufferLen is
zero.
System action: The system returns to the calling
procedure.

Explanation: The dsmUpdateFS or dsmUpdateObj

action is invalid.
System action: The system returns to the calling
procedure.
User response: Correct the action value. Valid values
are defined in dsmapitd.h and documented in our
Using the API book.

User response: Provide a non-zero value for the

bufferLen.
2014 E
DSM_RC_INVALID_DS_HANDLE
2009 E
DSM_RC_NULL_BUFPTR

There was an error in the TSM API internals.

The dataBlk bufferPtr is NULL.

Explanation: The system encountered an error in the

API internals.

Chapter 3. API return codes, version 6.3

301

System action: The system returns to the calling

procedure.

Explanation: The low level qualifier for the object

name is invalid.

User response: Shut down the process and retry the

operation. Verify that any previous dsmInit calls were
cleaned up and terminated by a dsmTerminate call. If
the problem continues, contact your system
administrator or service representative.

System action: The system returns to the calling

procedure.

2015 E
DSM_RC_INVALID_REPOS
The repository type is invalid.
Explanation: The repository type is invalid.
System action: The system returns to the calling
procedure.
User response: For dsmDeleteFS the repository must
be one of the following:
v DSM_ARCHIVE_REP

User response: Start the low level qualifier of the

object name with the directory delimiter.

2019 E
DSM_RC_INVALID_OBJOWNER
The object owner is invalid.
Explanation: The object owner must be either the root
user, or the object owner must be the same as the
session owner.
System action: The system returns to the calling
procedure.
User response: Verify the session owner and object
owner.

v DSM_BACKUP_REP
v DSM_REPOS_ALL.
2020 E
DSM_RC_INVALID_ACTYPE
2016 E
DSM_RC_INVALID_FSNAME
Filespace name should start with the directory
delimiter.
Explanation: The filespace name is invalid.
System action: The system returns to the calling
procedure.
User response: Filespace name should start with the
directory delimiter.

The dsmBindMC sendType is invalid.

Explanation: The dsmBindMC sendType is invalid.
System action: The system returns to the calling
procedure.
User response: The sendType must be one of the
following:
stBackup
stArchive
stBackupMountWait
stArchiveMountWait

2017 E
DSM_RC_INVALID_OBJNAME
The object name is either an empty string or has no
leading delimiter.
Explanation: The object name is invalid because of an
empty string or there is no leading delimiter.
System action: The system returns to the calling
procedure.
User response: Verify the format of the dsmObjName
full path.

2021 E
DSM_RC_INVALID_RETCODE
no text available for this return code.
Explanation: The dsmRC parameter for dsmRCMsg is
an unsupported return code.
System action: The system returns to the calling
procedure.
User response: Specify a valid value.

2018 E
DSM_RC_INVALID_LLNAME

2022 E
DSM_RC_INVALID_SENDTYPE

Low level qualifier of the object name should start

with the directory delimiter.

The dsmSendObj sendType is invalid.

302

Explanation: The dsmSendObj sendType is invalid.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: The system returns to the calling

procedure.

character. This return code is valid on Microsoft

Windows only.

User response: The sendType must be one of the

following:

System action: The system returns to the calling

procedure.

stBackup
stArchive
stBackupMountWait

User response: Verify that the drive designation is an

alphabetic character. The referenced field is
dsmDosFSAttrib.driveLetter.

stArchiveMountWait

2023 E
DSM_RC_INVALID_PARAMETER
The dsmDeleteObj delType is invalid.
Explanation: The dsmDeleteObj delType is invalid.
System action: The system returns to the calling
procedure.
User response: The delType must be dtBackup or
dtArchive.

2024 E
DSM_RC_INVALID_OBJSTATE
The query Backup objState is invalid.
Explanation: The query Backup objState is invalid.
System action: The system returns to the calling
procedure.
User response: The qryBackupData.objState must be
one of the following:
DSM_ACTIVE

2027 E
DSM_RC_NULL_FSNAME
The Register Filespace name is NULL.
Explanation: There is no value provided for the
Register Filespace name.
System action: The system returns to the calling
procedure.
User response: Provide a filespace name on
dsmRegisterFS.

2028 E
DSM_RC_INVALID_HLNAME
High level qualifier of the object name should start
with the directory delimiter.
Explanation: The high level qualifier for the object
name is invalid.
System action: The system returns to the calling
procedure.
User response: High level qualifier of the object name
should start with the directory delimiter.

DSM_INACTIVE
DSM_ANY_MATCH
2029 E
DSM_RC_NUMOBJ_EXCEED
2025 E
DSM_RC_INVALID_MCNAME
The management class name was not found.
Explanation: A query or send operation is unable to
find the management class name.
System action: The system returns to the calling
procedure.
User response: Verify the management class name.

2026 E
DSM_RC_INVALID_DRIVE_CHAR
The drive letter is not an alphabetic character.

The number of objects on dsmBeginGetData exceeds

DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ.
Explanation: The number of objects (numObjId)
specified on the dsmBeginGetData call exceeds
DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ.
System action: The system returns to the calling
procedure.
User response: Check the number of objects before
calling dsmBeginGetData. If it is greater than
DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ, then issue multiple
Get call sequences.

Explanation: The drive letter is not an alphabetic

Chapter 3. API return codes, version 6.3

303

2030 E
DSM_RC_NEWPW_REQD

2033 E
DSM_RC_NO_NODE_REQD

The new password value is NULL or blank.

On dsmInit, the node is not allowed when

PASSWORDACCESS=generate.

Explanation: There is no value provided for new

password.
System action: The system returns to the calling
procedure.
User response: Provide a new password on
dsmChangePW.

2031 E
DSM_RC_OLDPW_REQD
The old password value is NULL or blank.
Explanation: There is no value provided for old
password.
System action: The system returns to the calling
procedure.
User response: Provide an old password on
dsmChangePW.

2032 E
DSM_RC_NO_OWNER_REQD
On dsmInit, the owner is not allowed to establish a
session when PASSWORDACCESS=generate.
Explanation: PASSWORDACCESS=GENERATE
establishes a session with the current login user as the
owner. The application should set clientOwnerNameP
to NULL when PASSWORDACCESS=GENERATE is in
effect.
System action: The system returns to the calling
procedure. Whether the application can continue
processing depends on how the application handles the
error.
User response: This message applies to applications
that utilize the TSM API, and is intended primarily for
the vendor of the application for which the message is
issued. Depending on the application, this could be a
configuration issue.
Consult the documentation for the application and
verify that the application is configured correctly. If the
problem persists, contact the application vendor for
further assistance.

Explanation: PASSWORDACCESS=generate
establishes a session with the current hostname as the
node.
System action: The system returns to the calling
procedure.
User response: When using
PASSWORDACCESS=generate, set clientNodeNameP to
NULL.

2034 E
DSM_RC_KEY_MISSING
The key file is missing.
Explanation: The key file for Tivoli Data Protection
application client for Oracle cannot be found.
System action: The system returns to the calling
procedure.
User response: Ensure that you have ordered the
Tivoli Data Protection application client which contains
TDP for Oracle, and install the key file.

2035 E
DSM_RC_KEY_BAD
The key file content is invalid.
Explanation: The key file content for Tivoli Data
Protection application client for Oracle is invalid.
System action: The system returns to the calling
procedure.
User response: Ensure that you have ordered the
Tivoli Data Protection application client which contains
the TDP for Oracle, and install the key file.

2041 E
DSM_RC_BAD_CALL_SEQUENCE
The sequence of calls is invalid.
Explanation: The sequence of calls is invalid.
System action: The system returns to the calling
procedure.
User response: Verify the transaction call sequence.

304

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

2042 E
DSM_RC_INVALID_TSMBUFFER
The tsmBuffHandle is invalid, or the value of dataPtr
is invalid.
Explanation: An invalid value for a handle or dataPtr
has been passed into the API.
System action: The system returns to the calling
procedure.
User response: There is a problem with the calling
application. Verify the values of the tsmBuffHandle and
dataptr passed to the API.

continues, contact your system administrator or service

representative.

2046 E
DSM_RC_INVALID_DATABLK
When using useTsmBuffers, dataBlk must be NULL
in calls to dsmSendObj and dsmGetObj.
Explanation: The value for dataBlk must be NULL
when using useTsmBuffers.
System action: The system returns to the calling
procedure.
User response: There is a problem with the calling
application. Contact your application provider

2043 E
DSM_RC_TOO_MANY_BYTES
The number of bytes copied into the tsmBuffer is
larger than the allowed value.
Explanation: An invalid number of bytes was copied
to a tsmBuffer.
System action: The system returns to the calling
procedure.
User response: There is a problem with the calling
application. Verify the number of bytes copied into the
tsmBuffer.

2047 E
DSM_RC_ENCR_NOT_ALLOWED
Encryption is not allowed when using useTsmBuffers.
Explanation: useTsmBuffers does not support
encryption.
System action: The system returns to the calling
procedure.
User response: Try the operation again, without using
useTsmBuffers, or disable encryption for this operation.

2044 E
DSM_RC_MUST_RELEASE_BUFFER

2048 E
DSM_RC_OBJ_COMPRESSED

dsmTerminate cannot finish because the application is

holding on to 1 or more tsmBuffers.

This object cannot be restored/retrieved using

useTsmBuffers, because it is compressed.

Explanation: An application is trying to terminate a

session, but is still holding some tsmBuffers.

Explanation: useTsmBuffers does not support

compression.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: The application must return all buffers

for this session by calling tsmReleaseBuffer, and then
issue dsmTerminate.

User response: Try the operation again, without using

useTsmBuffers.

2045 E
DSM_RC_BUFF_ARRAY_ERROR

2049 E
DSM_RC_OBJ_ENCRYPTED

An internal error occurred in the tsmBuffer array.

This object cannot be restored/retrieved using

useTsmBuffers, because it is encrypted.

Explanation: An internal API buffer array error

occurred.

Explanation: useTsmBuffers does not support

encryption.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Try the operation again. If the problem

User response: Try the operation again, without using

useTsmBuffers.
Chapter 3. API return codes, version 6.3

305

2050 E
DSM_RC_WILDCHAR_NOTALLOWED
On dsmSendObj, wildcards are not allowed for the
objName.

System action: The system returns to the calling

procedure.
User response: Either remove the
ENABLEENCRYPTKEY option from the options file, or
set the parameter bEncryptKeyEnabled to bFalse in the
program using the TSM API.

Explanation: On dsmSendObj, wildcards are not

allowed for the objName.
System action: The system returns to the calling
procedure.
User response: Provide a fs, hl, and ll on the
dsmObjName.

2051 E
DSM_RC_POR_NOT_ALLOWED
When using useTsmBuffers, a restore/retrieve with
partial object restore is not allowed.
Explanation: useTsmBuffers does not support partial
object restore.
System action: The system returns to the calling
procedure.
User response: Make sure the calling application is
either using Partial object restore or useTsmBuffers.

2060 E
DSM_RC_FSNAME_NOTFOUND
The filespace to delete/set access cannot be found.
Explanation: The filespace to delete cannot be found.
System action: The system returns to the calling
procedure.
User response: Verify the filespace name.

2061 E
DSM_RC_FS_NOT_REGISTERED
On dsmSendObj, dsmDeleteObj, or dsmUpdateFS the
filespace is not registered.
Explanation: On dsmSendObj, dsmDeleteObj, or
dsmUpdateFS, the filespace is not registered.
System action: The system returns to the calling
procedure.

2052 E
DSM_RC_NO_ENCRYPTION_KEY
No encryption key was found. If you are using
-encryptkey=prompt make sure there is a value in the
encryptionPasswordP field and that
bEncryptKeyEnabled is set to true.

User response: Verify the filespace name.

2062 W
DSM_RC_FS_ALREADY_REGED
On dsmRegisterFS the filespace is already registered.

Explanation: There was no encryption key found in

the password file, or no key was provided by the
application.

Explanation: On dsmRegisterFS the filespace is

already registered.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: If you are using -encryptkey=prompt,

make sure there is a value in encryptionPasswordP and
that bEncryptKeyEnabled is set to true.

User response: Verify the filespace name.

2063 E
DSM_RC_OBJID_NOTFOUND
2053 E
DSM_RC_ENCR_CONFLICT
Conflicting encryption key options have been
specified.
Explanation: When using the ENABLEENCRYPTKEY
option, the parameter bEncryptKeyEnabled for the TSM
API dsmInitExIn_t and tsmInitExIn_t structures cannot
be set to bTrue.

On dsmBeginGetData the objID is NULL.

Explanation: On dsmBeginGetData, the objID is
NULL.
System action: The system returns to the calling
procedure.
User response: Verify the following:
The dsmGetList is not NULL.
Each objID is not NULL.

306

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

The dsmGetList numObjId is not zero.

2064 E
DSM_RC_WRONG_VERSION

Explanation: The backup or archive object is excluded

from processing.
System action: The system returns to the calling
procedure.
User response: Verify the objName and Exclude lists.

On dsmInit the caller's API version is different than

the TSM library version.
Explanation: On dsmInit the caller's API version has a
higher value than the TSM library version.
System action: The system returns to the calling
procedure.
User response: Install the latest TSM API library and
trusted agent module.

2081 E
DSM_RC_OBJ_NOBCG
The backup object does not have a copy group.
Explanation: The backup object does not have a copy
group.
System action: The system returns to the calling
procedure.

2065 E
DSM_RC_WRONG_VERSION_PARM

User response: Verify server policy definitions.

The caller's structure version is different than the

TSM library version.

2082 E
DSM_RC_OBJ_NOACG

Explanation: The caller's structure version is different

than the TSM library version.

The archive object does not have a copy group.

System action: The system returns to the calling

procedure.
User response: Ensure that the stVersion field is set
with the value in the header file. Recompile the
application with the latest header files.

Explanation: The archive object does not have a copy

group.
System action: The system returns to the calling
procedure.
User response: Verify server policy definitions.

2070 E
DSM_RC_NEEDTO_ENDTXN

2090 E
DSM_RC_APISYSTEM_ERROR

Issue dsmEndTxn and then begin a new transaction

session.

Memory used by the TSM API has been corrupted.

Explanation: This transaction must be ended and a

new one must be started due to one of the following
reasons:
The destination changed.
The byte limit is exceeded
The maximum number of objects is exceeded.

Explanation: Memory used by the TSM API has been

corrupted.
System action: The system returns to the calling
procedure.
User response: Retry the operation. If the problem
continues, contact your system administrator or service
representative.

System action: The system returns to the calling

procedure.
User response: Issue dsmEndTxn and start a new
transaction session.

2100 E
DSM_RC_DESC_TOOLONG
The sendObj Archive description is too long.

2080 E
DSM_RC_OBJ_EXCLUDED
The backup or archive object is excluded from
processing.

Explanation: The sendObj Archive description is too

long.
System action: The system returns to the calling
procedure.
User response: The sndArchiveData.descr string must
be less than or equal to DSM_MAX_DESCR_LENGTH.
Chapter 3. API return codes, version 6.3

307

Explanation: The sendObj dsmObjName.ll is too long.

2101 E
DSM_RC_OBJINFO_TOOLONG

System action: The system returns to the calling

procedure.

The sendObj ObjAttr.objInfo is too long.

User response: The ll field must be less than or equal

to DSM_MAX_LL_LENGTH.

Explanation: The sendObj ObjAttr.objInfo is too long.

System action: The system returns to the calling
procedure.
User response: The objInfo field must be less than or
equal to DSM_MAX_OBJINFO_LENGTH.

2106 E
DSM_RC_FSINFO_TOOLONG
On RegisterFS or UpdateFS the fsAttr's fsInfo is too
long.

2102 E
DSM_RC_HL_TOOLONG

Explanation: On RegisterFS or UpdateFS the fsAttr's

fsInfo is too long.

The sendObj dsmObjName.hl is too long.

System action: The system returns to the calling

procedure.

Explanation: The sendObj dsmObjName.hl is too long.

System action: The system returns to the calling
procedure.
User response: The hl field must be less than or equal
to DSM_MAX_HL_LENGTH.

User response: The fsInfo field must be less than or

equal to DSM_MAX_FSINFO_LENGTH.

2107 E
DSM_RC_SENDDATA_WITH_ZERO_SIZE
Cannot Send data with a zero byte sizeEstimate.

2103 E
DSM_RC_PASSWD_TOOLONG

Explanation: You cannot send data for an object with

size estimate = 0.

The password, or encryptionPassword string provided

is too long.

System action: The system returns to the calling

procedure.

Explanation: The value provided for password or

encryptionPassword is too long.

User response: Set size estimate greater than 0 in

dsmSendObj.

System action: The system returns to the calling

procedure.
User response: The password or encrypionPassword
field must be less than
DSM_MAX_VERIFIER_LENGTH.

2110 E
DSM_RC_INVALID_ACCESS_TYPE
The dsmSetAccess access Type is invalid.
Explanation: The dsmSetAccess accessType is invalid.

2104 E
DSM_RC_FILESPACE_TOOLONG

System action: The system returns to the calling

procedure.

The sendObj dsmObjName.fs is too long.

User response: The accessType must be one of the

following:

Explanation: The sendObj dsmObjName.fs is too long.

System action: The system returns to the calling
procedure.
User response: The fs field must be less than or equal
to DSM_MAX_FS_LENGTH.

atBackup
atArchive

2111 E
DSM_RC_QUERY_COMM_FAILURE

2105 E
DSM_RC_LL_TOOLONG

Communications error with server during object

query

The sendObj dsmObjName.ll is too long.

Explanation: An unexpected communications error

occurred during an object query to the server.

308

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

System action: Processing stopped.

User response: Verify that communications are active
between the client and server machines. Server outages,
processor outages, and communication controller
outages can cause this error.

2112 E
DSM_RC_NO_FILES_BACKUP
No files have been previously backed up for this
filename/filespace.
Explanation: You tried to set access to files when no
files for the specified filename, drive or file system
were previously backed up.
System action: Processing stopped.
User response: Ensure that the correct drive or file
system was specified and that files are backed up for
you to set access.

2113 E
DSM_RC_NO_FILES_ARCHIVE

2120 E
DSM_RC_STRING_TOO_LONG
The following message was too long to log to the
server: 'shortened message with message number'
Explanation: The message text and inserts are too
large to send to the server in the available internal
buffer.
System action: The message number message is written
to the local client error log, then shortened and sent to
the server as a part of this message. The message is
reduced in length by substituting '...' in the middle of
the original message.
User response: The message referred to has been
shortened, but describes the error that occurred. See the
documentation for that message for more information.

2200 I
DSM_RC_MORE_DATA
On dsmGetNextQObj or dsmGetData there is more
available data.

No files have been previously archived for this

filename/filespace.

Explanation: On dsmGetNextQObj or dsmGetData

there is more available data.

Explanation: You tried to set access to files when no

files for the specified filename, drive or file system
were previously archived.

System action: The system returns to the calling

procedure.
User response: Call the function again.

System action: Processing stopped.

User response: Ensure that the correct drive or file
system was specified and that files are archived for you
to set access.

2114 E
DSM_RC_INVALID_SETACCESS
Invalid format for Set Access command.
Explanation: The SET ACCESS command must have
at least three operands, the first of which must be
either BACKUP or ARCHIVE. A validly formed file
specification must follow.

2210 E
DSM_RC_BUFF_TOO_SMALL
The dataBlk buffer is too small for the query
response.
Explanation: The dataBlk buffer is too small for the
query response.
System action: The system returns to the calling
procedure.
User response: On dsmGetNextQObj ensure that the
dataBlk buffer is at least as big as the query response
structure.

System action: Processing stopped, the command is

not executed.
User response: Use the HELP SET ACCESS command
for complete details of usage, then enter the SET
ACCESS command using the correct syntax.

2228 E
DSM_RC_NO_API_CONFIGFILE
The configuration file specified on dsmInit cannot be
opened.
Explanation: The configuration file specified on
dsmInit cannot be opened.

Chapter 3. API return codes, version 6.3

309

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Verify the file name.

User response: Run this program as a root user.

2229 E
DSM_RC_NO_INCLEXCL_FILE

2301 E
DSM_RC_NEEDTO_CALL_BINDMC

The Include/Exclude definition file was not found.

You must issue dsmBindMC before dsmSendObj.

Explanation: The Include/Exclude definition file was

not found.

Explanation: You must issue dsmBindMC before

dsmSendObj.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: Verify the file name on the Inclexcl

option.

User response: Modify your program.

2230 E
DSM_RC_NO_SYS_OR_INCLEXCL
Either the dsm.sys file was not found, or the Inclexcl
file specified in dsm.sys was not found.

2302 I
DSM_RC_CHECK_REASON_CODE
The dsmEndTxn vote is ABORT, so check the reason
field.

Explanation: Either the dsm.sys file was not found, or

the Inclexcl file specified in dsm.sys was not found.

Explanation: After a dsmEndTxn call, the transaction

is aborted by either the server or client with a
DSM_VOTE_ABORT and the reason is returned.

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: The dsm.sys file must be in the

directory referenced by the environment variable
DSMI_DIR. Verify the file name on the Inclexcl option
in the dsm.sys file.

User response: Check the reason field for the code

which explains why the transaction has been aborted.

2400 E
DSM_RC_ALMGR_OPEN_FAIL
2231 E
DSM_RC_REJECT_NO_POR_SUPPORT
Partial Object Retrieve is not supported on this
server.
Explanation: The TSM server specified by the user
does not support partial object retrieve.
System action: The system returns to the calling
procedure.

License file could not be opened.

Explanation: The license file was not found, or could
not be opened because of permissions or the file is
corrupted.
System action: The system returns to the calling
procedure.
User response: Check permissions on file. See if the
license file is in the correct place.

User response: Specify a TSM server which supports

the partial object retrieve function.
2401 E
DSM_RC_ALMGR_READ_FAIL
2300 E
DSM_RC_NEED_ROOT
Only a UNIX root user can execute dsmChangePW or
dsmDeleteFS.
Explanation: Only a UNIX root user can execute
dsmChangePW or dsmDeleteFS.

310

Read failure on the license file.

Explanation: The license file was not found, or could
not be opened because of permissions, or the file is
corrupted.
System action: The system returns to the calling
procedure.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Check permissions on file. See if the

license file is in the correct place.

Explanation: Invalid mode passed by Oracle.

System action: The system returns to the calling
procedure.

2402 E
DSM_RC_ALMGR_WRITE_FAIL

User response: Contact your system administrator.

Write failure on the license file.

2411 E
DSM_RC_ORC_NULL_FILENAME

Explanation: The license file was not found, or could

not be opened because of permissions or the file is
corrupted.
System action: The system returns to the calling
procedure.
User response: Check permissions on file. See if
license file is in the correct place.

Oracle passed null file name

Explanation: Null filename passed by Oracle.
System action: The system returns to the calling
procedure.
User response: Contact your system administrator.

2403 E
DSM_RC__ALMGR_DATA_FMT

2412 E
DSM_RC_ORC_WRONG_BLKSIZE

Data in the license file is not in a valid format.

Wrong data block size

Explanation: The license file is not valid.

Explanation: Wrong Block Size

System action: The system returns to the calling

procedure.

System action: The system returns to the calling

procedure.

User response: User needs to obtain a new license.

User response: Contact your system administrator.

2404 E
DSM_RC_ALMGR_CKSUM_BAD

2413 E
DSM_RC_ORC_OBJ_EXISTS

The checksum in the license file does not match the

licenseregistration string.

Object exists

Explanation: The registration string is not valid.

System action: The system returns to the calling
procedure.

Explanation: Backup or Restore Object already exists.

System action: The system returns to the calling
procedure.

User response: User needs to obtain a new license.

User response: If backing up an object, be sure to

generate a unique object name.

2405 E
DSM_RC_ALMGR_TRIAL_EXPRD

2414 E
DSM_RC_ORC_NOTSAME_HANDLE

This is an expired try and buy license.

Not same Oracle handle

Explanation: The registration string is not valid.

Explanation: The handle passed from Oracle is not the

same handle that TSM passed back.

System action: The system returns to the calling

procedure.
User response: User needs to obtain a new license.

System action: The system returns to the calling

procedure.
User response: Contact your system administrator.

2410 E
DSM_RC_ORC_INVALID_MODE
Oracle passed invalid mode
Chapter 3. API return codes, version 6.3

311

User response: Contact your system administrator.

2415 E
DSM_RC_ORC_END_OF_FILE
End of file reached
Explanation: End of file reached.
System action: The system returns to the calling
procedure.
User response: None

2416 E
DSM_RC_ORC_WRONG_RDSTATE
Wrong Read State

4580 E
DSM_RC_ENC_WRONG_KEY
Error processing 'filespace namepath-namefile-name';
invalid encryption key.
Explanation: The key you entered does not match the
key that was used to encrypt the file during backup.
The file can not be restored unless the matching key is
entered.
System action: processing stops.
User response: Try the restore operation again and
provide the correct key.

Explanation: The operation must be in READ state.

System action: The system returns to the calling
procedure.
User response: Contact your service representative.

2417 E
DSM_RC_ORC_LOWER_APIVER
Runtime API version is outdated
Explanation: Runtime API is lower than compile time
API.
System action: The system returns to the calling
procedure.
User response: Use the WHAT command to find out
the compile time API level. Obtain the same or higher
level of API library.

2418 E
DSM_RC_ORC_WRONG_WRTSTATE

4582 E
DSM_RC_ENC_NOT_AUTHORIZED
User is not authorized to encrypt file-space
namedirectory_pathfile_name.
Explanation: The user is not authorized to encrypt the
file. Normally, only a IBM Tivoli Storage Manager
authorized user or a root user can use IBM Tivoli
Storage Manager encryption. However, a certain
combination of PASSWORDACCESS and
ENCRYPTKEY options may allow encryption
operations by a non-authorized user.
System action: The file is not backed up or restored.
User response: Log in as a root or IBM Tivoli Storage
Manager authorized user and try the operation again.
See IBM Tivoli Storage Manager Backup-Archive Client
Installation and User's Guide for the correct usage of
the ENCRYPTKEY option.

4584 E
DSM_RC_ENC_TYPE_UNKOWN

Wrong write state

Explanation: The operation must be in WRITE state.
System action: The system returns to the calling
procedure.
User response: Contact your service representative.

Error processing 'filespace namepath-namefile-name':

unsupported encryption type.
Explanation: The files you are trying to restore or
retrieve have been backed up or archived by a later
version of the TSM client. The file encryption method is
not supported by the current client.
System action: Object skipped.

2419 E
DSM_RC_ORC_INVALID_FLAG

User response: Restore or retrieve the file with the

most recent version of the TSM client.

Invalid flag passed

Explanation: Invalid flag passed from Oracle.
System action: The system returns to the calling
procedure.

312

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

4600 E
DSM_RC_CLUSTER_INFO_LIBRARY
_NOT_LOADED

User response: Ensure that the cluster software is

configured properly. If the cluster is in the process of
initialization, retry the operation at a later time.

CLUSTERNODE is set to YES but the Cluster

Information Daemon is notstarted.

4604 E
DSM_RC_CLUSTER_NOT_ENABLED

Explanation: The HACMP Cluster Information

Daemon must be started in order to specify the
CLUSTERNODE option.

CLUSTERNODE is set to YES but the cluster service

is not enabledon this system.

System action: Processing ends.

Explanation: The cluster service has not been enabled

on this system.

User response: Start the HACMP Cluster Information

Dameon.

System action: Processing ends.

User response: Enable the cluster service on the
system.

4601 E
DSM_RC_CLUSTER_LIBRARY_INVALID
CLUSTERNODE is set to YES but the cluster load
library is not valid.
Explanation: The load library that the operating
system provides to obtain the cluster name is not valid.
A possible cause is an out-of-date load library which
does not contain the proper routines this product
expects.
System action: Processing ends.
User response: Ensure that the latest cluster software
is installed on the system.

4602 E
DSM_RC_CLUSTER_LIBRARY_NOT_LOADED
CLUSTERNODE is set to YES but the cluster software
is not availableon this system.
Explanation: The load library that the operating
systems provides to obtain the cluster name is not
available on this system.
System action: Processing ends.
User response: Ensure that the cluster software is
installed on the system.

4603 E
DSM_RC_CLUSTER_NOT_MEMBER_OF_CLUSTER
CLUSTERNODE is set to YES but this machine is not
a member of acluster.
Explanation: This machine is not a member of a
cluster node. Possible causes are that the cluster service
has not been configured correctly, or that the cluster is
in the process of initialization.
System action: Processing ends.

4605 E
DSM_RC_CLUSTER_NOT_SUPPORTED
The CLUSTERNODE option is not supported on this
system.
Explanation: This option is not supported on this
system.
System action: Processing ends.
User response: Disable the CLUSTERNODE option in
the local options file.

4606 E
DSM_RC_CLUSTER_UNKNOWN_ERROR
An unexpected error (retcode) occurred while the
program was trying to obtain the cluster name from
the system.
Explanation: An unknown error occurred while the
program was trying to obtain the cluster name from the
cluster service. The error code is the reason code
provided directly from the cluster service being used in
this operating system environment.
System action: Processing ends.
User response: Consult the documentation for your
clustering software for an explanation of the reason
code. Insure that your clustering service is operational,
then try the TSM operation again.

5702 E
DSM_RC_PROXY_REJECT_NO_RESOURCES
Proxy Rejected: The TSM server has run out of
memory.
Explanation: There is not enough memory available to
allow this operation to continue.
Chapter 3. API return codes, version 6.3

313

System action: TSM canceled the current operation.

User response: Try the operation again. If the problem
continues, see your system administrator to increase the
amount of memory of the server.

Explanation: The node has not been granted proxy

authority to access the node named by the
ASNODENAME option. The TSM administrator must
first grant proxy authority.
System action: The TSM operation ends.

5705 E
DSM_RC_PROXY_REJECT_DUPLICATE_ID
Proxy Rejected: ASNODENAME and NODENAME
are identical.
Explanation: TSM does not allow the ASNODENAME
and NODENAME option values to be the same.
System action: TSM canceled the current operation.
User response: Use the ASNODENAME option only
to access another node. It is not necessary to set
ASNODENAME option to access your own node.
Remove ASNODENAME from your option file unless
you are actually trying to access a node that you have
been granted authority to access with the
administrative command "Grant Proxynode".

5710 E
DSM_RC_PROXY_REJECT_ID_IN_USE
Proxy Rejected: The node name you specified in the
ASNODENAME option is locked.
Explanation: The TSM administrator has locked the
node you specified as the ASNODENAME option.
System action: The TSM operation ends.
User response: The TSM server administrator must
unlock the node before you can access it. Try the
operation later, or check with your TSM administrator.

User response: The TSM server administrator must

grant proxy authority for this node. See the
administrator command "Grant Proxynode".

5746 E
DSM_RC_PROXY_INVALID_FROMNODE
The ASNODENAME option is not valid with the
FROMNODE option.
Explanation: None.
System action: Processing stops.
User response: Remove the ASNODENAME option
from the options file or do not use the FROMNODE
option.

5748 E
DSM_RC_PROXY_INVALID_FUNCTION
The operation that is being attempted cannot be
invoked using the ASNODENAME option.
Explanation: None.
System action: Processing stops.
User response: Remove the ASNODENAME option
and retry the operation.

5748 E
DSM_RC_PROXY_INVALID_CLUSTER
5717 E
DSM_RC_PROXY_REJECT_INTERNAL_ERROR

The ASNODENAME option cannot be used with the

CLUSTERNODE option.

Proxy Rejected: The server has an internal error.

Explanation: None.

Explanation: The client cannot proxy to the node

named by the ASNODENAME option because of an
internal server error.

System action: Processing stops.

User response: Remove the ASNODENAME option
and retry the operation.

System action: TSM canceled the current operation.

User response: See your system administrator
immediately.

5722 E
DSM_RC_PROXY_REJECT_NOT_AUTHORIZED
Proxy Rejected: Proxy authority has not been granted
to this node.

314

5801 E
DSM_RC_CRYPTO_ICC_ERROR
Unexpected error in cryptography library.
Explanation: There was an unexpected error in the
cryptography library. See the error log for more
information.
System action: processing stops.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

User response: Check the error log for ANS1467E to

determine the cause of failure. Verify you TSM client is
installed properly. If needed, reinstall client and/or
API. If the problem still exists, contact TSM technical
support.

Chapter 3. API return codes, version 6.3

315

316

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Appendix. Accessibility features for the Tivoli Storage

Manager product family
Accessibility features help users who have a disability, such as restricted mobility
or limited vision, to use information technology products successfully.

Accessibility features
The following list includes the major accessibility features in the Tivoli Storage
Manager family of products:
v Keyboard-only operation
v Interfaces that are commonly used by screen readers
v Keys that are discernible by touch but do not activate just by touching them
v Industry-standard devices for ports and connectors
v The attachment of alternative input and output devices
The Tivoli Storage Manager Information Center, and its related publications, are
accessibility-enabled. The accessibility features of the information center are
described at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3/topic/
com.ibm.help.ic.doc/iehs36_accessibility.html.

Keyboard navigation
On Windows, the Tivoli Storage Manager product family follows Microsoft
conventions for all keyboard navigation and access. Drag and Drop support is
managed using the Microsoft Windows Accessibility option known as MouseKeys.
For more information about MouseKeys and other Windows accessibility options,
please refer to the Windows online help (keyword: MouseKeys).
On other operating systems, these products follow the operating-system
conventions for keyboard navigation and access.

Vendor software
The Tivoli Storage Manager product family includes certain vendor software that is
not covered under the IBM license agreement. IBM makes no representation about
the accessibility features of these products. Contact the vendor for the accessibility
information about its products.

IBM and accessibility

See the IBM Human Ability and Accessibility Center for more information about
the commitment that IBM has to accessibility.

Copyright IBM Corp. 1993, 2011

317

318

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property LIcensing
Legal and Intellectual Property Law
IBM Japan Ltd
1623-14 Shimotsuruma, Yamato-shi
Kanagawa 242-8502, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.

Copyright IBM Corp. 1993, 2011

319

IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758
U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurements may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which
illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. The sample

320

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

programs are provided "AS IS", without warranty of any kind. IBM shall not be
liable for any damages arising out of your use of the sample programs.
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows: (your company name) (year). Portions of
this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp.
_enter the year or years_.
If you are viewing this information in softcopy, the photographs and color
illustrations may not appear.

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corporation, registered in many jurisdictions
worldwide. Other product and service names might be trademarks of IBM or other
companies. A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at http://www.ibm.com/legal/copytrade.shtml.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in
the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Oracle and/or its
affiliates.
Linux is a registered trademark of Linus Torvalds in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Other product and service names might be trademarks of IBM or other companies.

Notices

321

322

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

Glossary
This glossary includes terms and definitions for IBM Tivoli Storage Manager and
IBM Tivoli Storage FlashCopy Manager products.
To view glossaries for other IBM products, go to http://www.ibm.com/software/
globalization/terminology/.
The following cross-references are used in this glossary:
v See refers the reader from a term to a preferred synonym, or from an acronym or
abbreviation to the defined full form.
v See also refers the reader to a related or contrasting term.
A
absolute mode
In storage management, a backup copy-group mode that specifies that a
file is considered for incremental backup even if the file has not changed
since the last backup. See also modified mode.
access control list (ACL)
In computer security, a list associated with an object that identifies all the
subjects that can access the object and their access rights. For example, an
access control list is associated with a file that identifies the users who can
access that file and their access rights.
access mode
An attribute of a storage pool or a storage volume that specifies whether
the server can write to or read from the storage pool or storage volume.
The access mode can be read/write, read-only, or unavailable. Volumes in
primary storage pools can also have an access mode of destroyed. Volumes
in copy storage pools can also have an access mode of offsite.
acknowledgment
The transmission of acknowledgment characters as a positive response to a
data transmission.
ACL

See access control list.

activate
To validate the contents of a policy set and then make it the active policy
set.
active-data pool
A named set of storage pool volumes that contain only active versions of
client backup data.
active file system
A file system to which space management has been added. With space
management, tasks for an active file system include automatic migration,
reconciliation, selective migration, and recall. Contrast with inactive file
system.
active policy set
The activated policy set that contains the policy rules in use by all client
nodes that are assigned to the policy domain. See also policy domain and
policy set.
Copyright IBM Corp. 1993, 2011

323

active version
The most recent backup copy of a file stored. The active version of a file
cannot be deleted until a backup process detects that the user has either
replaced the file with a newer version or has deleted the file from the file
server or workstation. Contrast with inactive version.
activity log
A log that records normal activity messages that are generated by the
server. These messages include information about server and client
operations, such as the start time of sessions or device I/O errors.
adaptive subfile backup
A type of backup that sends only changed portions of a file to the server,
instead of sending the entire file. Adaptive subfile backup reduces network
traffic and increases the speed of the backup.
administrative client
A program that runs on a file server, workstation, or mainframe that
administrators use to control and monitor the Tivoli Storage Manager
server. Contrast with backup-archive client.
administrative command schedule
A database record that describes the planned processing of an
administrative command during a specific time period. See also client
schedule.
administrative privilege class
See privilege class.
administrative session
A period of time during which an administrator user ID communicates
with a server to perform administrative tasks. Contrast with client node
session.
administrator
A user who is registered to the server as an administrator, and who is
authorized to perform tasks and issue commands through the assignment
of an administrative privilege class.
Advanced Program-to-Program Communication (APPC)
An implementation of the SNA LU 6.2 protocol that allows interconnected
systems to communicate and share the processing of programs.
agent node
A client node that has been granted proxy authority to perform operations
on behalf of another client node, which is the target node.
aggregate
An object, stored in one or more storage pools, consisting of a group of
logical files that are packaged together. See also logical file and physical file.
aggregate data transfer rate
A performance statistic that indicates the average number of bytes that
were transferred per second while processing a given operation.
APPC See Advanced Program-to-Program Communication.
application client
A program that is installed on a system to protect an application. The
Tivoli Storage Manager server provides backup services to an application
client.

324

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

archive
To copy programs, data, or files to other storage media, usually for
long-term storage or security. Contrast with retrieve.
archive copy
A file or group of files that was archived to server storage.
archive copy group
A policy object containing attributes that control the generation,
destination, and expiration of archived files.
archive-retention grace period
The number of days that the storage manager retains an archived file when
the server is unable to rebind the file to an appropriate management class.
See also bind.
association
(1) The defined relationship between a client node and a client schedule.
An association identifies the name of a schedule, the name of the policy
domain to which the schedule belongs, and the name of a client node that
performs scheduled operations.
(2) On a configuration manager, the defined relationship between a profile
and an object such as a policy domain. Profile associations define the
configuration information that is distributed to a managed server when it
subscribes to the profile.
audit

To check for logical inconsistencies between information that the server has
and the actual condition of the system. The storage manager can audit
information about items such as volumes, libraries, and licenses. For
example, when a storage manager audits a volume, the server checks for
inconsistencies between information about backed-up or archived files that
are stored in the database and the actual data that are associated with each
backup version or archive copy in server storage.

authentication
The process of checking a user's password before permitting user access to
the Tivoli Storage Manager server. Authentication can be turned on or off
by an administrator with system privilege.
authentication rule
A specification that another user can use to either restore or retrieve files
from storage.
authority
The right to access objects, resources, or functions. See also privilege class.
authorization rule
A specification that permits another user to either restore or retrieve a
user's files from storage.
authorized user
A user who has administrative authority for the Tivoli Storage Manager
client on a workstation. This user changes passwords, performs open
registrations, and deletes file spaces.
AutoFS
See automounted file system.
automatic detection
A feature that detects, reports, and updates the serial number of a drive or
library in the database when the path from the local server is defined.
Glossary

325

automatic migration
The process that is used to automatically move files from a local file
system to storage, based on options and settings that are chosen by a root
user on a workstation. See also threshold migration and demand migration.
automatic reconciliation
The process that is used to reconcile file systems at regular intervals. The
intervals are set by a user with root user authority. See also reconciliation.
automounted file system (AutoFS)
A file system that is managed by an automounter daemon. The
automounter daemon monitors a specified directory path, and
automatically mounts the file system to access data.
B
backup-archive client
A program that runs on a workstation or file server and provides a means
for users to back up, archive, restore, and retrieve files. Contrast with
administrative client.
backup copy group
A policy object containing attributes that control the generation,
destination, and expiration of backup versions of files. A backup copy
group belongs to a management class.
backup-retention grace period
The number of days the storage manager retains a backup version after the
server is unable to rebind the file to an appropriate management class.
backup set
A portable, consolidated group of active versions of backup files that are
generated for a backup-archive client.
backup set collection
A group of backup sets that are created at the same time and which have
the same backup set name, volume names, description, and device classes.
The server identifies each backup set in the collection by its node name,
backup set name, and file type.
backup version
A file or directory that a client node backed up to server storage. More
than one backup version can exist in server storage, but only one backup
version is the active version. See also active version and inactive version.
bind

To associate all versions of a file with a management class name. See

rebind.

bindery
A database that consists of three system files for a NetWare server. The
files contain user IDs and user restrictions.
C
cache

To place a duplicate copy of a file on random access media when the

server migrates a file to another storage pool in the hierarchy.

cache file
A snapshot of a logical volume created by Logical Volume Snapshot Agent.
Blocks are saved immediately before they are modified during the image
backup and their logical extents are saved in the cache files.
CAD

326

See client acceptor.

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

central scheduler
A function that permits an administrator to schedule client operations and
administrative commands. The operations can be scheduled to occur
periodically or on a specific date. See client schedule and administrative
command schedule.
client

A software program or computer that requests services from a server.

client acceptor
An HTTP service that serves the applet for the web client to web browsers.
On Windows systems, the client acceptor is installed and run as a service.
On AIX, UNIX, and Linux systems, the client acceptor is run as a daemon,
and is also called the client acceptor daemon (CAD).
client acceptor daemon (CAD)
See client acceptor.
client domain
The set of drives, file systems, or volumes that the user selects to back up
or archive data, using the backup-archive client.
client node
A file server or workstation on which the backup-archive client program
has been installed, and which has been registered to the server.
client node session
A session in which a client node communicates with a server to perform
backup, restore, archive, retrieve, migrate, or recall requests. Contrast with
administrative session.
client options file
An editable file that identifies the server and communication method, and
provides the configuration for backup, archive, hierarchical storage
management, and scheduling.
client option set
A group of options that are defined on the server and used on client nodes
in conjunction with client options files.
client-polling scheduling mode
A method of operation in which the client queries the server for work.
Contrast with server-prompted scheduling mode.
client schedule
A database record that describes the planned processing of a client
operation during a specific time period. The client operation can be a
backup, archive, restore, or retrieve operation, a client operating system
command, or a macro. See also administrative command schedule.
client/server
Pertaining to the model of interaction in distributed data processing in
which a program on one computer sends a request to a program on
another computer and awaits a response. The requesting program is called
a client; the answering program is called a server.
client system-options file
A file, used on AIX, UNIX, or Linux system clients, containing a set of
processing options that identify the servers to be contacted for services.
This file also specifies communication methods and options for backup,
archive, hierarchical storage management, and scheduling. This file is also
called the dsm.sys file. See also client user-options file.

Glossary

327

client user-options file

A file that contains the set of processing options that the clients on the
system use. The set can include options that determine the server that the
client contacts, and options that affect backup operations, archive
operations, hierarchical storage management operations, and scheduled
operations. This file is also called the dsm.opt file. For AIX, UNIX, or
Linux systems, see also client system-options file.
closed registration
A registration process in which only an administrator can register
workstations as client nodes with the server. Contrast with open registration.
collocation
The process of keeping all data belonging to a single-client file space, a
single client node, or a group of client nodes on a minimal number of
sequential-access volumes within a storage pool. Collocation can reduce
the number of volumes that must be accessed when a large amount of data
must be restored.
collocation group
A user-defined group of client nodes whose data is stored on a minimal
number of volumes through the process of collocation.
commit point
A point in time when data is considered consistent.
Common Programming Interface for Communications (CPI-C)
A call-level interface that provides a consistent application programming
interface (API) for applications that use program-to-program
communications. CPI-C uses LU 6.2 architecture to create a set of
interprogram services that can establish and end a conversation, send and
receive data, exchange control information, and notify a partner program
of errors.
communication method
The method by which a client and server exchange information. See also
Transmission Control Protocol/Internet Protocol.
communication protocol
A set of defined interfaces that permit computers to communicate with
each other.
compression
A function that removes repetitive characters, spaces, or strings of
characters from the data being processed and replaces the repetitive
characters with control characters. Compression reduces the amount of
storage space that is required for the data.
configuration manager
A server that distributes configuration information, such as policies and
schedules, to managed servers according to their profiles. Configuration
information can include policy and schedules. See also managed server and
profile.
conversation
A connection between two programs over a session that allows them to
communicate with each other while processing a transaction.

328

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

copy backup
A full backup in which the transaction log files are not deleted so that
backup procedures that use incremental or differential backups are not
disrupted
copy group
A policy object containing attributes that control how backup versions or
archive copies are generated, where backup versions or archive copies are
initially located, and when backup versions or archive copies expire. A
copy group belongs to a management class. See also archive copy group,
backup copy group, backup version, and management class.
copy storage pool
A named set of volumes that contain copies of files that reside in primary
storage pools. Copy storage pools are used only to back up the data that is
stored in primary storage pools. A copy storage pool cannot be a
destination for a backup copy group, an archive copy group, or a
management class (for space-managed files). See also primary storage pool
and destination.
CPI-C See Common Programming Interface for Communications.
D
daemon
A program that runs unattended to perform continuous or periodic
functions, such as network control.
damaged file
A physical file in which Tivoli Storage Manager has detected read errors.
data access control mode
A mode that controls whether a command can access a migrated file, see a
migrated file as zero-length, or receive an input/output error if it attempts
to access a migrated file. See also execution mode.
database backup series
One full backup of the database, plus up to 32 incremental backups made
since that full backup. Each full backup that is run starts a new database
backup series. A number identifies each backup series.
database snapshot
A complete backup of the entire database to media that can be taken
off-site. When a database snapshot is created, the current database backup
series is not interrupted. A database snapshot cannot have incremental
database backups associated with it. See also database backup series. Contrast
with full backup.
data deduplication
A method of reducing storage needs by eliminating redundant data. Only
one instance of the data is retained on storage media. Other instances of
the same data are replaced with a pointer to the retained instance.
data manager server
A server that collects metadata information for client inventory and
manages transactions for the storage agent over the local area network. The
data manager server informs the storage agent with applicable library
attributes and the target volume identifier.
data mover
A device that moves data on behalf of the server. A network-attached
storage (NAS) file server is a data mover.
Glossary

329

data storage-management application-programming interface (DSMAPI)

A set of functions and semantics that can monitor events on files, and
manage and maintain the data in a file. In an HSM environment, a
DSMAPI uses events to notify data management applications about
operations on files, stores arbitrary attribute information with a file,
supports managed regions in a file, and uses DSMAPI access rights to
control access to a file object.
default management class
A management class that is assigned to a policy set. This class is used to
govern backed up or archived files when a file is not explicitly associated
with a specific management class through the include-exclude list.
deduplication
See data deduplication.
demand migration
The process that is used to respond to an out-of-space condition on a file
system for which hierarchical storage management (HSM) is active. Files
are migrated to server storage until space usage drops to the low threshold
that was set for the file system. If the high threshold and low threshold are
the same, one file is migrated.
desktop client
The group of backup-archive clients that includes clients on Microsoft
Windows, Apple, and Novell NetWare operating systems.
destination
A copy group or management class attribute that specifies the primary
storage pool to which a client file will be backed up, archived, or migrated.
device class
A named set of characteristics that are applied to a group of storage
devices. Each device class has a unique name and represents a device type
of disk, file, optical disk, or tape.
device configuration file
(1) For a server, a file that contains information about defined device
classes, and, on some servers, defined libraries and drives. The information
is a copy of the device configuration information in the database.
(2) For a storage agent, a file that contains the name and password of the
storage agent, and information about the server that is managing the
SAN-attached libraries and drives that the storage agent uses.
device driver
A program that provides an interface between a specific device and the
application program that uses the device.
disaster recovery manager (DRM)
A function that assists in preparing and using a disaster recovery plan file
for the server.
disaster recovery plan
A file that is created by the disaster recovery manager (DRM) that contains
information about how to recover computer systems if a disaster occurs
and scripts that can be run to perform some recovery tasks. The file
includes information about the software and hardware that is used by the
server, and the location of recovery media.

330

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

domain
A grouping of client nodes with one or more policy sets, which manage
data or storage resources for the client nodes. See policy domain or client
domain.
DRM

See disaster recovery manager.

DSMAPI
See data storage-management application-programming interface.
dynamic serialization
A type of copy serialization in which a file or folder is backed up or
archived on the first attempt regardless of whether it changes during a
backup or archive.
E
EA

See extended attribute.

EB

See exabyte.

EFS

See Encrypted File System.

Encrypted File System (EFS)

A file system that uses file system-level encryption.
enterprise configuration
A method of setting up servers so that the administrator can distribute the
configuration of one of the servers to the other servers, using
server-to-server communication. See also configuration manager, managed
server, profile, and subscription.
enterprise logging
The process of sending events from a Tivoli Storage Manager server to a
designated event server. The event server routes the events to designated
receivers, such as to a user exit. See also event.
error log
A data set or file that is used to record error information about a product
or system.
estimated capacity
The available space, in megabytes, of a storage pool.
event

(1) An administrative command or a client operation that is scheduled to

be run using Tivoli Storage Manager scheduling.
(2) A message that an Tivoli Storage Manager server or client issues.
Messages can be logged using Tivoli Storage Manager event logging.

event record
A database record that describes actual status and results for events.
event server
A server to which other servers can send events for logging. The event
server routes the events to any receivers that are enabled for the sending
server's events.
exabyte (EB)
For processor storage, real and virtual storage, and channel volume, 1 152
921 504 606 846 976 bytes. For disk storage capacity and communications
volume, 1 000 000 000 000 000 000 bytes.
exclude
The process of identifying files in an include-exclude list. This process
Glossary

331

prevents the files from being backed up or migrated whenever a user or

schedule enters an incremental or selective backup operation. A file can be
excluded from backup and space management, backup only, or space
management only.
exclude-include list
See include-exclude list.
execution mode
A mode that controls the space-management related behavior of commands
that run under the dsmmode command.
expiration
The process by which files, data sets, or objects are identified for deletion
because their expiration date or retention period has passed.
expiring file
A migrated or premigrated file that has been marked for expiration and
removal from storage. If a stub file or an original copy of a premigrated
file is deleted from a local file system, or if the original copy of a
premigrated file is updated, the corresponding migrated or premigrated
file is marked for expiration the next time reconciliation is run.
extend
To increase the portion of available space that can be used to store
database or recovery log information.
extended attribute (EA)
Names or value pairs that are associated with files or directories. There are
three classes of extended attributes: user attributes, system attributes, and
trusted attributes.
extent The part of a file that is created during the data-deduplication process.
Extents are compared with other file extents to identify duplicates.
external library
A type of library that is provided by Tivoli Storage Manager that permits
LAN-free data movement for StorageTek libraries that are managed by
Automated Cartridge System Library Software (ACSLS). To activate this
function, the Tivoli Storage Manager library type must be EXTERNAL.
F
file access time
On AIX, UNIX, or Linux systems, the time when the file was last accessed.
file age
For migration prioritization purposes, the number of days since a file was
last accessed.
file device type
A device type that specifies the use of sequential access files on disk
storage as volumes.
file server
A dedicated computer and its peripheral storage devices that are connected
to a local area network that stores programs and files that are shared by
users on the network.
file space
A logical space in server storage that contains a group of files that have
been backed up or archived by a client node, from a single logical
partition, file system, or virtual mount point. Client nodes can restore,

332

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

retrieve, or delete their file spaces from server storage. In server storage,
files belonging to a single file space are not necessarily stored together.
file space ID (FSID)
A unique numeric identifier that the server assigns to a file space when it
is stored in server storage.
file state
The space management mode of a file that resides in a file system to which
space management has been added. A file can be in one of three states:
resident, premigrated, or migrated. See also resident file, premigrated file, and
migrated file.
file system migrator (FSM)
A kernel extension that intercepts all file system operations and provides
any space management support that is required. If no space management
support is required, the operation is passed to the operating system, which
performs its normal functions. The file system migrator is mounted over a
file system when space management is added to the file system.
file system state
The storage management mode of a file system that resides on a
workstation on which the hierarchical storage management (HSM) client is
installed. A file system can be in one of these states: native, active, inactive,
or global inactive.
frequency
A copy group attribute that specifies the minimum interval, in days,
between incremental backups.
FSID

See file space ID.

FSM

See file system migrator.

full backup
The process of backing up the entire server database. A full backup begins
a new database backup series. See also database backup series and incremental
backup. Contrast with database snapshot.
fuzzy backup
A backup version of a file that might not accurately reflect what is
currently in the file because the file was backed up at the same time as it
was being modified.
fuzzy copy
A backup version or archive copy of a file that might not accurately reflect
the original contents of the file because it was backed up or archived the
file while the file was being modified. See also backup version and archive
copy.
G
General Parallel File System
A high-performance shared-disk file system that can provide data access
from nodes in a cluster environment.
gigabyte (GB)
In decimal notation, 1 073 741 824 when referring to memory capacity; in
all other cases, it is defined as 1 000 000 000.
global inactive state
The state of all file systems to which space management has been added
when space management is globally deactivated for a client node. When
Glossary

333

space management is globally deactivated, hierarchical storage

management (HSM) cannot perform migration, recall, or reconciliation.
However, a root user can update space management settings and add
space management to additional file systems. Users can access resident and
premigrated files.
Globally Unique Identifier (GUID)
An algorithmically determined number that uniquely identifies an entity
within a system.
GPFS See General Parallel File System.
GPFS node set
A mounted, defined group of GPFS file systems.
group backup
The backup of a group containing a list of files from one or more file space
origins.
GUID See Globally Unique Identifier.
H
hierarchical storage management (HSM)
A function that automatically distributes and manages data on disk, tape,
or both by regarding devices of these types and potentially others as levels
in a storage hierarchy that range from fast, expensive devices to slower,
cheaper, and possibly removable devices. The objectives are to minimize
access time to data and maximize available media capacity.
hierarchical storage management (HSM) client
A client program that works with the Tivoli Storage Manager server to
provide hierarchical storage management (HSM) for a system. See also
hierarchical storage management and space manager client.
HSM

See hierarchical storage management.

HSM client
See hierarchical storage management client.
I
ILM

See information lifecycle management.

image A file system or raw logical volume that is backed up as a single object.
image backup
A backup of a full file system or raw logical volume as a single object.
inactive file system
A file system for which space management has been deactivated. Contrast
with active file system.
inactive version
A backup version of a file that is either not the most recent backup version,
or that is a backup version of a file that no longer exists on the client
system. Inactive backup versions are eligible for expiration processing
according to the management class assigned to the file. Contrast with active
version.
include-exclude file
A file containing statements to determine the files to back up and the
associated management classes to use for backup or archive. See also
include-exclude list.

334

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

include-exclude list
A list of options that include or exclude selected files for backup. An
exclude option identifies files that should not be backed up. An include
option identifies files that are exempt from the exclusion rules or assigns a
management class to a file or a group of files for backup or archive
services.
incremental backup
(1) A copy of all database data that has changed since the most recent
successful full backup operation. An incremental backup is also known as
a cumulative backup image because each incremental backup includes the
contents of the previous incremental backup.
(2) The process of backing up information in the database that is new or
changed since the last full backup. Contrast with full backup. See also
database backup series.
(3) For Data Protection for Microsoft Exchange Server, a backup in which
the transaction logs are backed up and then cleared.
individual mailbox restore
See mailbox restore.
information lifecycle management (ILM)
GPFS policy-based file management for storage pools and file sets.
inode The internal structure that describes the individual files on AIX, UNIX, or
Linux systems. An inode contains the node, type, owner, and location of a
file.
inode number
A number specifying a particular inode file in the file system.
IP address
A unique address for a device or logical unit on a network that uses the IP
standard.
J
job file
A generated file that contains configuration information for a migration
job. The file is XML format and can be created and edited in the
hierarchical storage management (HSM) client for Windows client
graphical user interface.
journal-based backup
A method for backing up Windows clients and AIX clients that exploits the
change notification mechanism in a file to improve incremental backup
performance by reducing the need to fully scan the file system.
journal daemon
On AIX, UNIX, or Linux systems, a program that tracks change activity for
files residing in file systems.
journal service
In Microsoft Windows, a program that tracks change activity for files
residing in file systems.
K

Glossary

335

kilobyte (KB)
For processor storage, real and virtual storage, and channel volume, 210 or
1 024 bytes. For disk storage capacity and communications volume, 1 000
bytes.
L
LAN

See local area network.

LAN-free data movement

The movement of client data between a client system and a storage device
on a storage area network (SAN), bypassing the local area network. This
process is also referred to as LAN-free data transfer.
LAN-free data transfer
See LAN-free data movement.
leader data
Bytes of data, from the beginning of a migrated file, that are stored in the
file's corresponding stub file on the local file system. The amount of leader
data that is stored in a stub file depends on the stub size that is specified.
library
(1) A repository for demountable recorded media, such as magnetic disks
and magnetic tapes.
(2) A collection of one or more drives, and possibly robotic devices
(depending on the library type), which can be used to access storage
volumes.
library client
A server that uses server-to-server communication to access a library that
is managed by another storage management server. See also library
manager.
library manager
A server that controls device operations when multiple storage
management servers share a storage device. See also library client.
local

(1) Pertaining to a device, file, or system that is accessed directly from a

user system, without the use of a communication line.
(2) For HSM products, pertaining to the destination of migrated files that
are being moved.

|
|

local area network (LAN)

A network that connects several devices in a limited area (such as a single
building or campus) and that can be connected to a larger network.
local shadow volumes
Data that is stored on shadow volumes localized to a disk storage
subsystem.
LOFS See loopback virtual file system.
logical file
A file that is stored in one or more server storage pools, either by itself or
as part of an aggregate. See also aggregate and physical file.
logical occupancy
The space that is used by logical files in a storage pool. This space does
not include the unused space created when logical files are deleted from
aggregate files, so it might be less than the physical occupancy.

336

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

logical unit (LU)

An access point through which a user or application program accesses the
Systems Network Architecture (SNA) network to communicate with
another user or application program.
logical unit number (LUN)
In the Small Computer System Interface (SCSI) standard, a unique
identifier that is used to differentiate devices, each of which is a logical
unit (LU).
logical volume
A portion of a physical volume that contains a file system.
logical volume backup
A backup of a file system or logical volume as a single object.
Logical Volume Snapshot Agent (LVSA)
Software that can act as the snapshot provider for creating a snapshot of a
logical volume during an online image backup.
loopback virtual file system (LOFS)
A file system that is created by mounting a directory over another local
directory, also known as mount-over-mount. A LOFS can also be generated
using an automounter.
LU

See logical unit.

LUN

See logical unit number.

LVSA See Logical Volume Snapshot Agent.

M
macro file
A file that contains one or more storage manager administrative
commands, which can be run only from an administrative client using the
MACRO command. Contrast with Tivoli Storage Manager command script.
mailbox restore
A function that restores Microsoft Exchange Server data (from IBM Data
Protection for Microsoft Exchange backups) at the mailbox level or
mailbox-item level.
managed object
In Tivoli Storage Manager, a definition in the database of a managed server
that was distributed to the managed server by a configuration manager.
When a managed server subscribes to a profile, all objects that are
associated with that profile become managed objects in the database of the
managed server. In general, a managed object cannot be modified locally
on the managed server. Objects can include policy, schedules, client option
sets, server scripts, administrator registrations, server definitions, and
server group definitions.
managed server
A Tivoli Storage Manager server that receives configuration information
from a configuration manager using a subscription to one or more profiles.
Configuration information can include definitions of objects such as policy
and schedules. See also configuration manager, subscription, and profile.
management class
A policy object that users can bind to each file to specify how the server
manages the file. The management class can contain a backup copy group,

Glossary

337

an archive copy group, and space management attributes. See also copy
group, space manager client, bind, and rebind.
maximum transmission unit
The largest possible unit of data that can be sent on a given physical
medium in a single frame. For example, the maximum transmission unit
for Ethernet is 1500 bytes.
MB

See megabyte.

media server
In a z/OS environment, a program that provides access to z/OS disk and
tape storage for Tivoli Storage Manager servers that run on operating
systems other than z/OS.

|
|
|
|

megabyte (MB)
(1) 1 048 576 bytes (2 to the 20th power) when used in this publication.
(2) For processor storage, real and virtual storage, and channel volume, 2
to the power of 20 or 1 048 576 bits. For disk storage capacity and
communications volume, 1 000 000 bits.
metadata
Data that describes the characteristics of data; descriptive data.
migrate
To move data from one storage location to another. In Tivoli Storage
Manager products, migrating can mean moving data from a client node to
server storage, or moving data from one storage pool to the next storage
pool defined in the server storage hierarchy. In both cases the movement is
controlled by policy, such as thresholds that are set. See also migration
threshold.
migrated file
A file that has been copied from a local file system to Tivoli Storage
Manager storage. For HSM clients on UNIX or Linux systems, the file is
replaced with a stub file on the local file system. On Windows systems,
creation of the stub file is optional. See also stub file and resident file. For
HSM clients on UNIX or Linux systems, contrast with premigrated file.
migrate-on-close recall mode
A mode that causes a migrated file to be recalled back to its originating file
system temporarily. Contrast with normal recall mode and read-without-recall
recall mode.
migration job
A specification of files to migrate, and actions to perform on the original
files after migration. See also job file.
migration threshold
High and low capacities for storage pools or file systems, expressed as
percentages, at which migration is set to start and stop.
mirroring
The process of writing the same data to multiple locations at the same
time. Mirroring data protects against data loss within the recovery log.
mode

A copy group attribute that specifies whether to back up a file that has not
been modified since the last time the file was backed up. See modified mode
and absolute mode.

modified mode
In storage management, a backup copy-group mode that specifies that a

338

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

file is considered for incremental backup only if it has changed since the
last backup. A file is considered a changed file if the date, size, owner, or
permissions of the file have changed. See also absolute mode.
mount limit
The maximum number of volumes that can be simultaneously accessed
from the same device class. The mount limit determines the maximum
number of mount points. See also mount point.
mount point
On the Tivoli Storage Manager server, a logical drive through which
volumes in a sequential access device class are accessed. For
removable-media device types, such as tape, a mount point is a logical
drive that is associated with a physical drive. For the file device type, a
mount point is a logical drive that is associated with an I/O stream. The
number of mount points for a device class is defined by the value of the
mount limit attribute for that device class. See also mount limit.
mount retention period
The maximum number of minutes that the server retains a mounted
sequential-access media volume that is not being used before it dismounts
the sequential-access media volume.
mount wait period
The maximum number of minutes that the server waits for a
sequential-access volume mount request to be satisfied before canceling the
request.
MTU

See maximum transmission unit.

N
Nagle algorithm
An algorithm that reduces congestion of TCP/IP networks by combining
smaller packets and sending them together.
named pipe
A type of interprocess communication that permits message data streams
to pass between peer processes, such as between a client and a server.
NAS

See network-attached storage.

NAS node
A client node that is a network-attached storage (NAS) file server. Data for
the NAS node is transferred by a NAS file server that is controlled by the
network data management protocol (NDMP). A NAS node is also called a
NAS file server node.
native file system
A file system that is locally added to the file server and is not added for
space management. The hierarchical storage manager (HSM) client does
not provide space management services to the file system.
native format
A format of data that is written to a storage pool directly by the Tivoli
Storage Manager server. Contrast with non-native data format.
NDMP
See Network Data Management Protocol.
NetBIOS
See Network Basic Input/Output System.

Glossary

339

network-attached storage (NAS) file server

A dedicated storage device with an operating system that is optimized for
file-serving functions. A NAS file server can have the characteristics of both
a node and a data mover.
Network Basic Input/Output System (NetBIOS)
A standard interface to networks and personal computers that is used on
local area networks to provide message, print-server, and file-server
functions. Application programs that use NetBIOS do not have to handle
the details of LAN data link control (DLC) protocols.
Network Data Management Protocol (NDMP)
A protocol that allows a network storage-management application to
control the backup and recovery of an NDMP-compliant file server,
without installing vendor-acquired software on that file server.
network data-transfer rate
A rate that is calculated by dividing the total number of bytes that are
transferred by the data transfer time. For example, this rate can be the time
that is spent transferring data over a network.
node

A file server or workstation on which the backup-archive client program

has been installed, and which has been registered to the server.

node name
A unique name that is used to identify a workstation, file server, or PC to
the server.
node privilege class
A privilege class that gives an administrator the authority to remotely
access backup-archive clients for a specific client node or for all clients in a
policy domain. See also privilege class.
non-native data format
A format of data that is written to a storage pool that differs from the
format that the server uses for operations.
normal recall mode
A mode that causes a migrated file to be copied back to its originating file
system when it is accessed.
O
offline volume backup
A backup in which the volume is locked so that no other system
applications can access it during the backup operation.
online volume backup
A backup in which the volume is available to other system applications
during the backup operation.
open registration
A registration process in which users can register their workstations as
client nodes with the server. Contrast with closed registration.
operator privilege class
A privilege class that gives an administrator the authority to disable or halt
the server, enable the server, cancel server processes, and manage
removable media. See also privilege class.

340

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

options file
A file that contains processing options. On Windows and NetWare systems,
the file is called dsm.opt. On AIX, UNIX, Linux, and Mac OS X systems,
the file is called dsm.sys.
originating file system
The file system from which a file was migrated. When a file is recalled
using normal or migrate-on-close recall mode, it is always returned to its
originating file system.
orphaned stub file
A file for which no migrated file can be found on the Tivoli Storage
Manager server that the client node is contacting for space management
services. For example, a stub file can be orphaned when the client
system-options file is modified to contact a server that is different than the
one to which the file was migrated.
out-of-space protection mode
A mode that controls whether the program intercepts out-of-space
conditions. See also execution mode.
P
pacing
In SNA, a technique by which the receiving system controls the rate of
transmission of the sending system to prevent overrun.
packet In data communication, a sequence of binary digits, including data and
control signals, that is transmitted and switched as a composite whole.
page

A defined unit of space on a storage medium or within a database volume.

partial-file recall mode

A recall mode that causes the hierarchical storage management (HSM)
function to read just a portion of a migrated file from storage, as requested
by the application accessing the file.
password generation
A process that creates and stores a new password in an encrypted
password file when the old password expires. Automatic generation of a
password prevents password prompting. Password generation can be set in
the options file (passwordaccess option). See also options file.
path

An object that defines a one-to-one relationship between a source and a

destination. Using the path, the source accesses the destination. Data can
flow from the source to the destination, and back. An example of a source
is a data mover (such as a network-attached storage [NAS] file server), and
an example of a destination is a tape drive.

pattern-matching character
See wildcard character.
physical file
A file that is stored in one or more storage pools, consisting of either a
single logical file, or a group of logical files that are packaged together as
an aggregate. See also aggregate and logical file.
physical occupancy
The amount of space that is used by physical files in a storage pool. This
space includes the unused space that is created when logical files are
deleted from aggregates. See also physical file, logical file, and logical
occupancy.
Glossary

341

plug-in
A self-contained software component that modifies (adds, or changes) the
function in a particular system. When a plug-in is added to a system, the
foundation of the original system remains intact.
policy domain
A grouping of policy users with one or more policy sets, which manage
data or storage resources for the users. The users are client nodes that are
associated with the policy domain.
policy privilege class
A privilege class that gives an administrator the authority to manage
policy objects, register client nodes, and schedule client operations for
client nodes. Authority can be restricted to certain policy domains. See also
privilege class.
policy set
A group of rules in a policy domain. The rules specify how data or storage
resources are automatically managed for client nodes in the policy domain.
Rules can be contained in management classes. See also active policy set and
management class.
premigrated file
A file that has been copied to Tivoli Storage Manager storage, but has not
been replaced with a stub file on the local file system. An identical copy of
the file resides both on the local file system and in Tivoli Storage Manager
storage. Premigrated files occur on UNIX and Linux file systems to which
space management has been added. Contrast with migrated file and resident
file.
premigrated files database
A database that contains information about each file that has been
premigrated to Tivoli Storage Manager storage. The database is stored in a
hidden directory named .SpaceMan in each file system to which space
management has been added.
premigration
The process of copying files that are eligible for migration to Tivoli Storage
Manager storage, but leaving the original file intact on the local file system.
premigration percentage
A space management setting that controls whether the next eligible
candidates in a file system are premigrated following threshold or demand
migration.
primary storage pool
A named set of volumes that the server uses to store backup versions of
files, archive copies of files, and files migrated from client nodes. See also
destination and copy storage pool.
privilege class
A level of authority that is granted to an administrator. The privilege class
determines which administrative tasks the administrator can perform. See
also node privilege class, operator privilege class, policy privilege class, storage
privilege class, and system privilege class.
profile
A named group of configuration information that can be distributed from a
configuration manager when a managed server subscribes. Configuration
information can include registered administrator IDs, policies, client
schedules, client option sets, administrative schedules, storage manager

342

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

command scripts, server definitions, and server group definitions. See also
configuration manager and managed server.
Q
quota (1) For HSM on AIX, UNIX, or Linux systems, the limit (in megabytes) on
the amount of data that can be migrated and premigrated from a file
system to server storage.
(2) For HSM on Windows systems, a user-defined limit to the space that is
occupied by recalled files.
R
randomization
The process of distributing schedule start times for different clients within
a specified percentage of the schedule's startup window.
raw logical volume
A portion of a physical volume that is comprised of unallocated blocks and
has no journaled file system (JFS) definition. A logical volume is
read/write accessible only through low-level I/O functions.
read-without-recall recall mode
A mode that causes hierarchical storage management (HSM) to read a
migrated file from storage without storing it back on the local file system.
The last piece of information read from the file is stored in a buffer in
memory on the local file system. Contrast with normal recall mode and
migrate-on-close recall mode.
rebind
To associate all backed-up versions of a file with a new management class
name. For example, a file that has an active backup version is rebound
when a later version of the file is backed up with a different management
class association. See also bind.
recall

In Tivoli Storage Manager, to copy a migrated file from server storage back
to its originating file system using the space management client. See also
transparent recall, selective recall, and recall mode.

recall mode
A mode that is assigned to a migrated file with the dsmattr command that
determines how the file is processed when it is recalled. It determines
whether the file is stored on the local file system, is migrated back to Tivoli
Storage Manager storage when it is closed, or is read from Tivoli Storage
Manager storage without storing it on the local file system.
receiver
A server repository that contains a log of server and client messages as
events. For example, a receiver can be a file exit, a user exit, or the Tivoli
Storage Manager server console and activity log. See also event.
reclamation
The process of consolidating the remaining data from many
sequential-access volumes onto fewer, new sequential-access volumes.
reclamation threshold
The percentage of space that a sequential-access media volume must have
before the server can reclaim the volume. Space becomes reclaimable when
files are expired or are deleted.

Glossary

343

reconciliation
The process of synchronizing a file system with the Tivoli Storage Manager
server, and then removing old and obsolete objects from the Tivoli Storage
Manager server.
recovery log
A log of updates that are about to be written to the database. The log can
be used to recover from system and media failures. The recovery log
consists of the active log (including the log mirror) and archive logs.
register
To define a client node or administrator ID that can access the server.
registry
A repository that contains access and configuration information for users,
systems, and software.
remote

|
|
|

(1) Pertaining to a system, program, or device that is accessed through a

communication line.
(2) For HSM products, pertaining to the origin of migrated files that are
being moved.

|
|

resident file
On a Windows system, a complete file on a local file system that might
also be a migrated file because a migrated copy can exist in Tivoli Storage
Manager storage. On a UNIX or Linux system, a complete file on a local
file system that has not been migrated or premigrated, or that has been
recalled from Tivoli Storage Manager storage and modified. Contrast with
stub file and premigrated file. See migrated file.
restore
To copy information from its backup location to the active storage location
for use. For example, to copy information from server storage to a client
workstation.
retention
The amount of time, in days, that inactive backed-up or archived files are
kept in the storage pool before they are deleted. Copy group attributes and
default retention grace periods for the domain define retention.
retrieve
To copy archived information from the storage pool to the workstation for
use. The retrieve operation does not affect the archive version in the
storage pool.
roll back
To remove changes that were made to database files since the last commit
point.
root user
A system user who operates without restrictions. A root user has the
special rights and privileges needed to perform administrative tasks.
S
SAN

See storage area network.

schedule
A database record that describes client operations or administrative
commands to be processed. See administrative command schedule and client
schedule.

344

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

scheduling mode
The type of scheduling operation for the server and client node that
supports two scheduling modes: client-polling and server-prompted.
scratch volume
A labeled volume that is either blank or contains no valid data, that is not
defined, and that is available for use.
script

A series of commands, combined in a file, that carry out a particular

function when the file is run. Scripts are interpreted as they are run.
Contrast with Tivoli Storage Manager command script.

Secure Sockets Layer (SSL)

A security protocol that provides communication privacy. With SSL,
client/server applications can communicate in a way that is designed to
prevent eavesdropping, tampering, and message forgery.
selective backup
The process of backing up certain files or directories from a client domain.
The files that are backed up are those that are not excluded in the
include-exclude list. The files must meet the requirement for serialization
in the backup copy group of the management class that is assigned to each
file. Contrast with incremental backup.
selective migration
The process of copying user-selected files from a local file system to Tivoli
Storage Manager storage and replacing the files with stub files on the local
file system. Contrast with threshold migration and demand migration.
selective recall
The process of copying user-selected files from Tivoli Storage Manager
storage to a local file system. Contrast with transparent recall.
serialization
The process of handling files that are modified during backup or archive
processing. See dynamic serialization, static serialization, shared static
serialization, and shared dynamic serialization.
server A software program or a computer that provides services to other software
programs or other computers.
server options file
A file that contains settings that control various server operations. These
settings affect such things as communications, devices, and performance.
server-prompted scheduling mode
A client/server communication technique where the server contacts the
client node when tasks must be done. Contrast with client-polling scheduling
mode.
server storage
The primary, copy, and active-data storage pools that are used by the
server to store user files such as backup versions, archive copies, and files
migrated from space manager client nodes (space-managed files). See also
active-data pool, primary storage pool, copy storage pool, storage pool volume, and
volume.
session
A logical or virtual connection between two stations, software programs, or
devices on a network that allows the two elements to communicate and
exchange data.

Glossary

345

session resource usage

The amount of wait time, processor time, and space that is used or
retrieved during a client session.
shared dynamic serialization
A value for serialization that specifies that a file must not be backed up or
archived if it is being modified during the operation. Tivoli Storage
Manager retries the backup or archive operation a number of times; if the
file is being modified during each attempt, Tivoli Storage Manager will
back up or archive the file on its last try. See also serialization. Contrast
with dynamic serialization, shared static serialization, and static serialization.
shared library
A library device that is used by multiple storage manager servers.
shared static serialization
A copy-group serialization value that specifies that a file must not be
modified during a backup or archive operation. Tivoli Storage Manager
attempts to retry the operation a number of times. If the file is in use
during each attempt, the file is not backed up or archived. See also
serialization. Contrast with dynamic serialization, shared dynamic serialization,
and static serialization.
snapshot
An image backup type that consists of a point-in-time view of a volume.
space-managed file
A file that is migrated from a client node by the space manager client. The
space manager client recalls the file to the client node on demand.
space management
The process of keeping sufficient free storage space available on a local file
system for new data by migrating files to server storage. Synonymous with
hierarchical storage management.
space manager client
A program that runs on a UNIX or Linux system to manage free space on
the local file system by migrating files to server storage. The program can
recall the files either automatically or selectively. Also called hierarchical
storage management (HSM) client.
space monitor daemon
A daemon that checks space usage on all file systems for which space
management is active, and automatically starts threshold migration when
space usage on a file system equals or exceeds its high threshold.
sparse file
A file that is created with a length greater than the data it contains, leaving
empty spaces for the future addition of data.
special file
On AIX, UNIX, or Linux systems, a file that defines devices for the system,
or temporary files that are created by processes. There are three basic types
of special files: first-in, first-out (FIFO); block; and character.
SSL

See Secure Sockets Layer.

stabilized file space

A file space that exists on the server but not on the client.
stanza A group of lines in a file that together have a common function or define a
part of the system. Each stanza is identified by a name that occurs in the

346

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

first line of the stanza. Depending on the type of file, a stanza is ended by
the next occurrence of a stanza name in the file, or by an explicit
end-of-stanza marker. A stanza can also be ended by the end of the file.
startup window
A time period during which a schedule must be initiated.
static serialization
A copy-group serialization value that specifies that a file must not be
modified during a backup or archive operation. If the file is in use during
the first attempt, the storage manager cannot back up or archive the file.
See also serialization. Contrast with dynamic serialization, shared dynamic
serialization, and shared static serialization.
storage agent
A program that enables the backup and restoration of client data directly
to and from storage attached to a storage area network (SAN).
storage area network (SAN)
A dedicated storage network that is tailored to a specific environment,
combining servers, systems, storage products, networking products,
software, and services.
storage hierarchy
(1) A logical order of primary storage pools, as defined by an
administrator. The order is typically based on the speed and capacity of the
devices that the storage pools use. The storage hierarchy is defined by
identifying the next storage pool in a storage pool definition. See also
storage pool.
(2) An arrangement of storage devices with different speeds and capacities.
The levels of the storage hierarchy include: main storage, such as memory
and direct-access storage device (DASD) cache; primary storage (DASD
containing user-accessible data); migration level 1 (DASD containing data
in a space-saving format); and migration level 2 (tape cartridges containing
data in a space-saving format).
storage pool
A named set of storage volumes that are the destination that is used to
store client data. A storage pool contains backup versions, archive copies,
and files that are migrated from space manager client nodes. A primary
storage pool is backed up to a copy storage pool. See also primary storage
pool, copy storage pool, and active-data pool.
storage pool volume
A volume that has been assigned to a storage pool. See also volume,
active-data pool, copy storage pool, and primary storage pool.
storage privilege class
A privilege class that gives an administrator the authority to control how
storage resources for the server are allocated and used, such as monitoring
the database, the recovery log, and server storage. See also privilege class.
stub

A shortcut on the Windows file system that is generated by the hierarchical

storage management (HSM) client for a migrated file that allows
transparent user access. A stub is the sparse file representation of a
migrated file, with a reparse point attached.

stub file
A file that replaces the original file on a local file system when the file is
migrated to storage. A stub file contains the information that is necessary
Glossary

347

to recall a migrated file from Tivoli Storage Manager storage. It also

contains additional information that can be used to eliminate the need to
recall a migrated file.
stub file size
The size of a file that replaces the original file on a local file system when
the file is migrated to Tivoli Storage Manager storage. The size that is
specified for stub files determines how much leader data can be stored in
the stub file. The default for stub file size is the block size defined for a file
system minus 1 byte.
subscription
In a Tivoli environment, the process of identifying the subscribers that the
profiles are distributed to. For Tivoli Storage Manager, a subscription is the
process by which a managed server receives configuration information
associated with a particular profile on a configuration manager. See also
managed server, configuration manager, and profile.
system privilege class
A privilege class that gives an administrator the authority to issue all
server commands. See also privilege class.
Systems Network Architecture (SNA)
The description of the logical structure, formats, protocols, and operational
sequences for transmitting information through and controlling the
configuration and operation of networks.
T
tape library
A set of equipment and facilities that support an installation's tape
environment. The tape library can include tape storage racks, mechanisms
for automatic tape mounting, a set of tape drives, and a set of related tape
volumes mounted on those drives.
tape volume prefix
The high-level-qualifier of the file name or the data set name in the
standard tape label.
target node
A client node for which other client nodes (called agent nodes) have been
granted proxy authority. The proxy authority allows the agent nodes to
perform operations such as backup and restore on behalf of the target
node, which owns the data.
TCA

See trusted communications agent.

TCP/IP
See Transmission Control Protocol/Internet Protocol.
threshold migration
The process of moving files from a local file system to Tivoli Storage
Manager storage based on the high and low thresholds that are defined for
the file system. Contrast with demand migration, selective migration, and
migration job.
throughput
In storage management, the total bytes in the workload, excluding
overhead, that are backed up or restored, divided by elapsed time.

348

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

timeout
A time interval that is allotted for an event to occur or complete before
operation is interrupted.
timestamp control mode
A mode that determines whether commands preserve the access time for a
file or set it to the current time.
Tivoli Storage Manager command script
A sequence of Tivoli Storage Manager administrative commands that are
stored in the database of the Tivoli Storage Manager server. The script can
run from any interface to the server. The script can include substitution for
command parameters and conditional logic.
tombstone object
A small subset of attributes of a deleted object. The tombstone object is
retained for a specified period, and at the end of the specified period, the
tombstone object is permanently deleted.
Transmission Control Protocol/Internet Protocol (TCP/IP)
An industry-standard, nonproprietary set of communication protocols that
provides reliable end-to-end connections between applications over
interconnected networks of different types.
transparent recall
The process that is used to automatically recall a file to a workstation or
file server when the file is accessed. See also recall mode. Contrast with
selective recall.
trusted communications agent (TCA)
A program that handles the sign-on password protocol when clients use
password generation.
U
UCS-2 A 2-byte (16-bit) encoding scheme based on ISO/IEC specification 10646-1.
UCS-2 defines three levels of implementation: Level 1-No combining of
encoded elements allowed; Level 2-Combining of encoded elements is
allowed only for Thai, Indic, Hebrew, and Arabic; Level 3-Any combination
of encoded elements are allowed.
UNC

See Universal Naming Convention name.

Unicode
A character encoding standard that supports the interchange, processing,
and display of text that is written in the common languages around the
world, plus some classical and historical texts. The Unicode standard has a
16-bit character set defined by ISO 10646.
Unicode-enabled file space
Unicode file space names provide support for multilingual workstations
without regard for the current locale.
Unicode transformation format 8
Unicode Transformation Format (UTF), 8-bit encoding form, which is
designed for ease of use with existing ASCII-based systems. The CCSID
value for data in UTF-8 format is 1208.
Universal Naming Convention (UNC) name
A name that is used to access a drive or directory containing files shared
across a network. The UNC name includes the system name and a
SharePoint name that represents the shared drive or directory.
Glossary

349

Universally Unique Identifier (UUID)

The 128-bit numeric identifier that is used to ensure that two components
do not have the same identifier.
UTF-8 See Unicode transformation format 8.
UUID See Universally Unique Identifier.
V
validate
To check a policy set for conditions that can cause problems if that policy
set becomes the active policy set. For example, the validation process
checks whether the policy set contains a default management class.
version
A backup copy of a file stored in server storage. The most recent backup
copy of a file is the active version. Earlier copies of the same file are
inactive versions. The number of versions retained by the server is
determined by the copy group attributes in the management class.
virtual file space
A representation of a directory on a network-attached storage (NAS) file
system as a path to that directory.
virtual volume
An archive file on a target server that represents a sequential media
volume to a source server.
volume
A discrete unit of storage on disk, tape or other data recording medium
that supports some form of identifier and parameter list, such as a volume
label or input/output control. See also scratch volume, and storage pool
volume.
volume history file
A file that contains information about volumes that have been used by the
server for database backups and for export of administrator, node, policy,
or server data. The file also has information about sequential-access storage
pool volumes that have been added, reused, or deleted. The information is
a copy of volume information that is recorded in the server database.
Volume Shadow Copy Service
A set of Microsoft application-programming interfaces (APIs) that you can
use to create shadow copy backups of volumes, exact copies of files,
including all open files, and so on.
VSS

See Volume Shadow Copy Service.

VSS Backup
A backup operation that uses Microsoft Volume Shadow Copy Service
(VSS) technology. The backup operation produces an online snapshot
(point-in-time consistent copy) of Microsoft Exchange data. This copy can
be stored on local shadow volumes or on Tivoli Storage Manager server
storage.
VSS Fast Restore
A function that uses a Microsoft Volume Shadow Copy Service (VSS)
software provider to restore VSS Backups (IBM Data Protection for
Microsoft Exchange database files and log files) that reside on local shadow
volumes.

350

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

VSS Instant Restore

A volume-level hardware-assisted Microsoft Volume Shadow Copy Service
(VSS) function where target volumes that contain the snapshot are copied
back to the original source volumes.
VSS offloaded backup
A backup operation that uses a Microsoft Volume Shadow Copy Service
(VSS) hardware provider (installed on an alternate system) to move IBM
Data Protection for Microsoft Exchange data to the Tivoli Storage Manager
server. This type of backup operation shifts the backup load from the
production system to another system.
VSS Restore
A function that uses a Microsoft Volume Shadow Copy Service (VSS)
software provider to restore VSS Backups (IBM Data Protection for
Microsoft Exchange database files and log files) that reside on Tivoli
Storage Manager server storage to their original location.
W
wildcard character
A special character such as an asterisk (*) or a question mark (?) that can
be used to represent one or more characters. Any character or set of
characters can replace the wildcard character.
workstation
A terminal or personal computer at which a user can run applications and
that is usually connected to a mainframe or a network.
worldwide name
A 64-bit, unsigned name identifier that is unique.
workload partition (WPAR)
A partition within a single operating system instance.

Glossary

351

352

IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes




Product Number: 5608-E01

5608-E02
5608-E03
5608-E07
5608-E12

Printed in USA

SC27-2878-01