IBM Spectrum Protect

Version 8.1.9

Client Messages and Application

Programming Interface Return Codes

IBM
 Note:
Before you use this information and the product it supports, read the information in “Notices” on page
507.

This edition applies to version 8, release 1, modification 9 of IBM Spectrum Protect (product numbers 5725-W98, 5725-
W99, 5725-X15, 5725-X18, 5725-X04) and to all subsequent releases and modifications until otherwise indicated in
new editions.
© Copyright International Business Machines Corporation 1993, 2019.
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..........................................................................................................................v
Publications ................................................................................................................................................. v

Chapter 1. Introduction to messages......................................................................1

IBM Spectrum Protect server and client messages format........................................................................1
Interpreting return code messages.............................................................................................................2
Example one for QUERY EVENT command............................................................................................3
Example two for DEFINE VOLUME command....................................................................................... 3

Chapter 2. ANS 0000-9999 messages.................................................................... 5

ANS messages list........................................................................................................................................5

Chapter 3. API return codes............................................................................... 453

API return code format............................................................................................................................453
API return codes......................................................................................................................................453

Appendix A. Accessibility...................................................................................505

Notices..............................................................................................................507
Glossary............................................................................................................ 511

iii
iv
About this publication
IBM Spectrum Protect 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 IBM Spectrum
Protect client components:
• Administrative client
• Backup-archive client
• IBM Spectrum Protect for Space Management (HSM client for IBM® AIX® and Linux systems).
• Application programming interface (API)

Who should read this guide

The target audience for this publication is system administrators who service the IBM Spectrum Protect
components. In this publication, it is assumed that you have a working knowledge of the IBM Spectrum
Protect backup-archive client.

Publications
The IBM Spectrum Protect product family includes IBM Spectrum Protect Plus, IBM Spectrum Protect for
Virtual Environments, IBM Spectrum Protect for Databases, and several other storage management
products from IBM.
To view IBM product documentation, see IBM Knowledge Center.

© Copyright IBM Corp. 1993, 2019 v

vi IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Chapter 1. Introduction to messages

Messages, error codes, and return codes are issued by the IBM Spectrum Protect server and clients.
Messages and codes can appear on the server console, the administrative client, an operator terminal, the
administrative graphical user interface, the backup-archive client, or the hierarchical storage managment
client (HSM client).
IBM Spectrum Protect 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:
• 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
Some messages have no explanations and are not published. 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 published.

IBM Spectrum Protect server and client messages format

IBM Spectrum Protect server and client messages consist of the following elements:
• A three-letter prefix. Messages have different prefixes to help you identify the IBM Spectrum Protect
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, backup-archive clients issue messages with the ANS prefix. Backup-archive client events
that are logged to the server have the ANE prefix. Server common and server platform-specific
messages have the ANR prefix.
• A numeric message identifier.
• A one-letter severity code. The following codes indicate the severity of the action that generated the
message:

Code Severity Meaning

S Severe The product or a product function cannot continue. User response is
required.
E Error An error is encountered during processing. Processing might stop. User
response might be required.
W Warning Processing continues, but problems might occur later as a result of the
warning.
I Information Processing continues. User response is not necessary.
• Message text that is displayed on screen and written to message logs.
• Explanation, System Action, and User Response texts. These texts elaborate on the message text, and
are available in the product messages publications and in the command line help.
The following image presents a typical IBM Spectrum Protect server message.
The callouts identify each element of the message.

© Copyright IBM Corp. 1993, 2019 1

 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.

2 IBM Spectrum Protect: 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 3

4 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Chapter 2. ANS 0000-9999 messages

ANS messages with message numbers in the range 0000-9999 are issued by the following IBM Spectrum
Protect clients:
• Administrative clients
• Application programming interface clients
• Backup–archive clients
• IBM Spectrum Protect for Space Management (HSM) clients
A list of new and changed messages since the previous product modification level is available in the
client_message.chg file in the product installation directory. The lists of new and changed client
messages for V8.1.9 and later are also available in the IBM developerWorks wiki.

ANS messages list

IBM Spectrum Protect V8.1.9 client 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 System action
repository file name. IBM Spectrum Protect continues processing using the
English language message repository.
Explanation
The default English message repository file cannot be User response
opened. Either the file access permissions prevent Make sure the file in your DSM_DIR is set up properly.
reading the file or the file is not present in the If the problem continues, see your system
expected location. administrator for further help.

System action ANS0103E Error trying to read header record

from message repository file
IBM Spectrum Protect is unable to complete the name.
requested operation. Processing is terminated.
Explanation
User response
The message repository file header record cannot be
Make sure the file in your DSM_DIR is set up properly. obtained.
If the problem continues, see your system
administrator for further help.
System action
ANS0102W Unable to open the message IBM Spectrum Protect is unable to complete the
repository file name. The American requested operation.
English repository will be used
instead.
User response
Explanation Make sure the file has not been altered from the
installation. If the problem continues, see your system
The default message repository file for the current administrator for further help.
locale cannot be opened. Either the file access
permissions prevent reading the file, the file is not ANS0104I A message repository is not
present in the expected location, or the language available for your system's
specified in the option file is not supported on this configured language 'language'.
workstation. The US English message
repository is used instead.

© Copyright IBM Corp. 1993, 2019 5

Explanation User response
IBM Spectrum Protect does not have language support Make sure the DSM_DIR is set up properly and it does
for the specified language. Therefore, it uses the US not point to an old copy. If the problem continues, see
English message repository by default. your system administrator for further help.
ANS0107E Error trying to read header for
System action message number from repository
The US English message repository is used. file name.

User response Explanation

No action is necessary if you want to continue to use The message header information cannot be obtained
US English. If you want to use a different language that for the message number in the message file.
is supported by IBM Spectrum Protect, then: *
(Windows) Add the LANGUAGE option to the client System action
option file and specify a supported language. For
IBM Spectrum Protect is unable to complete the
example, to configure the client to use the French
requested operation.
language repository, add the option LANGUAGE FRA to
the client option file. Refer to the reference
information for the LANGUAGE option in the backup- User response
archive client product manual. * (UNIX and Linux) Set Make sure the file has not been altered from the
the LANG environment variable to a supported installation. If the problem continues, see your system
language and region code. For example, to configure administrator for further help.
the client to use the French language repository, set
LANG to fr_FR. Refer to the backup-archive client ANS0108E Error trying to read text for
manual for the supported language codes. message number from repository
file name.
ANS0105E Error trying to read index for
message number from repository
Explanation
file name.
The message text cannot be obtained for the message
Explanation number in the message file.

The message text for the specified message number

System action
cannot be read.
IBM Spectrum Protect is unable to complete the
System action requested operation.

IBM Spectrum Protect is unable to complete the

User response
requested operation.
Make sure the file has not been altered from the
User response installation. If the problem continues, see your system
administrator for further help.
Make sure the file has not been altered from the
installation. If the problem continues, see your system ANS0109E Insufficient memory for allocation
administrator for further help. of message structure.
ANS0106E Message index not found for
Explanation
message number.
There is not enough memory in your system to allocate
Explanation the storage needed for the message text.

The message repository file does not contain the

System action
message text for the message number.
IBM Spectrum Protect is unable to complete the
System action requested operation.

IBM Spectrum Protect is unable to complete the

requested operation.

6 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response make sure the file has not been locked by another
application.
Stop IBM Spectrum Protect and restart IBM Spectrum
Protect. Then retry the operation. If unsuccessful, ANS0119E Error trying to read response
close all unneeded applications and retry the string for message number from
operation. repository file name.
ANS0110E Unable to open error log file file
name for output. Explanation
The response string information for the message
Explanation number cannot be obtained from the message
repository file. It is possible the message repository
The error log cannot be opened for output.
has been corrupted.

System action
System action
IBM Spectrum Protect is unable to complete the
IBM Spectrum Protect is unable to complete the
requested operation. File permissions may be set such
requested operation.
that writing is not allowed.

User response
User response
Make sure the message file was not altered from the
Stop and restart IBM Spectrum Protect. Then retry the
installation. Check DSM_DIR to make sure it is set up
operation. If unsuccessful, make sure the file is not
properly.
being locked by another application and that file
permissions allow write access. ANS0120E Message number number contains
an invalid multibyte sequence for
ANS0113E Message repository file name has
the current locale.
an invalid control record.

Explanation
Explanation
An illegal multibyte sequence for the current locale
The message repository file contains an incorrect
was found in the message. Either the message
control information.
repository has been corrupted or is coded in a
language other than that of the current locale.
System action
IBM Spectrum Protect is unable to complete the System action
requested operation.
IBM Spectrum Protect is unable to complete the
requested operation.
User response
Make sure the message file was not altered from the User response
installation. Check DSM_DIR to make sure it is set up
If the message repository is not corrupted, process the
properly.
operation in the supported locale.
ANS0118E Unable to open schedule log file
ANS0121W Unable to open the iconv converter
'file name' for output.
for the message repository file
name. The American English
Explanation repository will be used instead.
The schedule log file cannot be opened for output.
Explanation
System action The iconv converter for the default message repository
IBM Spectrum Protect is unable to complete the for the current locale cannot be opened. The iconv
requested operation. converter used to convert from UTF-8 to the current
locale is not installed on this work station.
User response
Stop IBM Spectrum Protect and restart IBM Spectrum
Protect. Then retry the operation. If unsuccessful,

Chapter 2. ANS 0000-9999 messages 7

System action User response
IBM Spectrum Protect continues processing using the Get authorization from the other node.
English language message repository.
ANS0203E The objName field has no leading
directory separator.
User response
Make sure the required iconv converter is installed Explanation
properly. If the problem continues, see your system
The objName field does not have a leading directory
administrator for further help.
separator.
ANS0200E The virtual machine 'VM-name'
was backed up with a later version System action
of the backup-archive client.
The system returns to the calling procedure.
Explanation
User response
The virtual machine was backed up with a later version
of the backup-archive client. The objects of the virtual Correct the value for the objName.
machine backup that were retrieved cannnot be ANS0204E Wildcards are not allowed in the
correctly displayed. objName directory path.

System action Explanation

The backup information for the virtual machine will not Wildcards are not allowed in the objName directory
be displayed. path.

User response System action

Query the virtual machine on a later version of the The system returns to the calling procedure.
backup-archive client to view backup details. If a
query of all virtual machines does not display virtual
machines that were backed up at the same client User response
version, issue the Query VM command for individual Correct the value for the objName.
virtual machines.
ANS0205E Unable to open error log file.
ANS0201E Invalid parameter was found.
Explanation
Explanation
The system is unable to open the error log file.
The system encountered an internal program error due
to an invalid parameter. System action
The system returns to the calling procedure.
System action
The system returns to the calling procedure. User response
Verify the DSMI_LOG value and access permission. On
User response
the AS/400 platform, verify the value specified for
Ask your service representative to check the error log. ERRORLOGNAME in the API options file.
ANS0202E Not authorized to restore the other ANS0206E The log file cannot be written to.
node's data.
Explanation
Explanation
There was an error writing to the log file.
The client is not authorized to restore the other node's
data. System action
The system returns to the calling procedure.
System action
The system returns to the calling procedure.

8 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Verify the DSMI_LOG value and access permission. on Processing stopped.
the AS/400 platform, verify the value specified for
ERRORLOGNAME in the API options file. User response
ANS0207E The log file name was not Verify your TCP/IP installation.
specified.
ANS0211E The object name pointer is NULL.
Explanation
Explanation
The system is unable to open the error log file.
There is no value provided for the object name pointer.
System action
System action
The system returns to the calling procedure.
The system returns to the calling procedure.
User response
User response
Verify the DSMI_LOG value and access permission. On
the AS/400 platform, verify the value specified for Provide an address for the dsmObjName structure.
ERRORLOGNAME in the API options file. ANS0212E The data block pointer is NULL.
ANS0208E The TCP/IP WINSOCK.DLL file
cannot be found. Explanation
There is no value provided for the data block pointer.
Explanation
The TCP/IP WINSOCK.DLL file cannot be found. System action
The system returns to the calling procedure.
System action
Processing stopped. User response
Provide an address for the DataBlk structure.
User response
ANS0213E The object attribute pointer is
Verify your TCP/IP installation. NULL.
ANS0209E An error occurred while loading a
library. Explanation
There is no value provided for the object attribute
Explanation pointer.
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
Provide an address for the ObjAttr structure.
User response
ANS0214E There is no server session
Verify your TCP/IP installation. information.
ANS0210E The TCP/IP load function failed.
Explanation
Explanation The server did not respond with the session
An error occurred while locating a function. The information.
TCP/IP load function failed.
System action
The system returns to the calling procedure.

Chapter 2. ANS 0000-9999 messages 9

User response DSM_OBJ_FILE or DSM_OBJ_DIRECTORY for
Backup, or
Verify the server status.
DSM_OBJ_FILE for Archive.
ANS0215E There is no server policy
information. ANS0219E The dsmEndTxn vote is invalid.

Explanation Explanation

The server did not respond with the policy information. The dsmEndTxn vote is invalid.

System action System action

The system returns to the calling procedure. The system returns to the calling procedure.

User response User response

Verify the server policy definitions. The vote must be DSM_VOTE_COMMIT or

DSM_VOTE_ABORT.
ANS0216E The dataBlk bufferLen value is
zero. ANS0220E An invalid option was found during
option parsing.
Explanation
Explanation
The value for the dataBlk bufferLen is zero.
An invalid option was found.
System action
System action
The system returns to the calling procedure.
The system returns to the calling procedure.
User response
User response
Provide a non-zero value for the bufferLen.
Verify the options in dsm.opt, dsm.sys, and the options
ANS0217E The dataBlk bufferPtr is NULL. string. Check the error log for more details about the
error. on the AS/400 platform, verify the options in
Explanation *LIB/QOPTIBM Spectrum Protect(APIOPT).

There is no value provided for the dataBlk bufferPtr. ANS0221E There was an error in the IBM
Spectrum Protect API internals.
System action
Explanation
The system returns to the calling procedure.
The system encountered an error in the API internals.
User response
System action
Provide an address for the bufferPtr.
The system returns to the calling procedure.
ANS0218E The objType is invalid.
User response
Explanation
Shut down the process and retry the operation. Verify
The value for the objType is invalid. that any previous dsmInit calls were cleaned up and
terminated by a dsmTerminate call. If the problem
System action continues, contact your system administrator or
service representative.
The system returns to the calling procedure.
ANS0222E The repository type is invalid.
User response
The value for dsmObjName.objType must be: Explanation
The repository type is invalid.

10 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS0226E The object owner is invalid.
The system returns to the calling procedure.
Explanation
User response The object owner must be either the root user, or the
object owner must be the same as the session owner.
For dsmDeleteFS the repository must be one of the
following:
System action
• DSM_ARCHIVE_REP
The system returns to the calling procedure.
• DSM_BACKUP_REP
• DSM_REPOS_ALL. User response
ANS0223E Filespace name should start with Verify the session owner and object owner.
the directory delimiter.
ANS0227E The dsmBindMC sendType is
Explanation invalid.

The filespace name is invalid. Explanation

System action The dsmBindMC sendType is invalid.

The system returns to the calling procedure. System action

User response The system returns to the calling procedure.

Filespace name should start with the directory User response

delimiter.
The sendType must be one of the following:
ANS0224E The object name is either an
empty string or has no leading stBackup
delimiter. stArchive
stBackupMountWait
Explanation stArchiveMountWait
The object name is invalid because of an empty string ANS0228E The dsmSendObj sendType is
or there is no leading delimiter. invalid.

System action Explanation

The system returns to the calling procedure. The dsmSendObj sendType is invalid.

User response System action

Verify the format of the dsmObjName full path. The system returns to the calling procedure.
ANS0225E Low level qualifier of the object
name should start with the User response
directory delimiter. The sendType must be one of the following:
stBackup
Explanation
stArchive
The low level qualifier for the object name is invalid. stBackupMountWait
stArchiveMountWait
System action
ANS0229E The dsmDeleteObj delType is
The system returns to the calling procedure. invalid.

User response Explanation

Start the low level qualifier of the object name with the The dsmDeleteObj delType is invalid.
directory delimiter.

Chapter 2. ANS 0000-9999 messages 11

System action ANS0233E The Register Filespace name is
NULL.
The system returns to the calling procedure.

Explanation
User response
There is no value provided for the Register Filespace
The delType must be dtBackup or dtArchive.
name.
ANS0230E The query Backup objState is
invalid. System action
The system returns to the calling procedure.
Explanation
The query Backup objState is invalid. User response
Provide a filespace name on dsmRegisterFS.
System action
ANS0234E The new password value is NULL
The system returns to the calling procedure.
or blank.

User response
Explanation
The qryBackupData.objState must be one of the
There is no value provided for new password.
following:
DSM_ACTIVE System action
DSM_INACTIVE
The system returns to the calling procedure.
DSM_ANY_MATCH
ANS0231E The management class name was User response
not found.
Provide a new password on dsmChangePW.
Explanation ANS0235E The old password value is NULL or
A query or send operation is unable to find the blank.
management class name.
Explanation
System action There is no value provided for old password.
The system returns to the calling procedure.
System action
User response The system returns to the calling procedure.
Verify the management class name.
User response
ANS0232E The drive letter is not an
alphabetic character. Provide an old password on dsmChangePW.
ANS0236E On dsmInit, the owner is not
Explanation allowed to establish a session
The drive letter is not an alphabetic character. This when
return code is valid on Microsoft Windows only. PASSWORDACCESS=generate.

Explanation
System action
PASSWORDACCESS=GENERATE establishes a session
The system returns to the calling procedure.
with the current login user as the owner. The
application should set clientOwnerNameP to NULL
User response when PASSWORDACCESS=GENERATE is in effect.
Verify that the drive designation is an alphabetic
character. The referenced field is
dsmDosFSAttrib.driveLetter.

12 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action • Look for clues in the IBM Spectrum Protect server
activity log file, client side dsierror.log log file, and
The system returns to the calling procedure. Whether
log files that are specific to the problem application.
the application can continue processing depends on
how the application handles the error. • Search the IBM support pages for APARs that match
the problem. The support site is at IBM Spectrum
Protect Support Portal (https://www.ibm.com/
User response
mysupport/s/topic/0TO50000000IQWvGAO/
This message applies to applications that utilize the spectrum-protect)
IBM Spectrum Protect API, and is intended primarily • If the API application is developed by a third party
for the vendor of the application for which the (not IBM), search that third party's support pages for
message is issued. Depending on the application, this known issues that match the problem.
could be a configuration issue.
If none of the above actions resolve the problem,
Consult the documentation for the application and report the problem to the vendor of the application
verify that the application is configured correctly. If the that uses the IBM Spectrum Protect API.
problem persists, contact the application vendor for
further assistance. A developer of an application that uses the IBM
Spectrum Protect API must investigate the reason for
ANS0237E On dsmInit, the node is not the problem, including reviewing the IBM Spectrum
allowed when Protect API state diagram. The IBM Spectrum Protect
PASSWORDACCESS=generate. API state diagram is in the product documentation at
IBM Spectrum Protect product documentation
Explanation (https://www.ibm.com/support/knowledgecenter/
SSEQVQ_8.1.9/tsm/welcome.html)
PASSWORDACCESS=generate establishes a session
with the current hostname as the node. ANS0239E On dsmSendObj, wildcards are not
allowed for the objName.
System action
The system returns to the calling procedure. Explanation
On dsmSendObj, wildcards are not allowed for the
User response objName.
When using PASSWORDACCESS=generate, set
clientNodeNameP to NULL. System action
The system returns to the calling procedure.
ANS0238E The sequence of calls is invalid.

User response
Explanation
Provide a fs, hl, and ll on the dsmObjName.
Then API requires function calls to be made in a
specific sequence. The function calls were not made in ANS0240E The filespace to delete/set access
the expected sequence. The error can be triggered by cannot be found.
the following issues:
• An error in the network. Explanation
• A bug in the IBM Spectrum Protect API. The filespace to delete cannot be found.
• A bug in the IBM Spectrum Protect server.
• A bug in the application (IBM or third party) that uses System action
the IBM Spectrum Protect API. The system returns to the calling procedure.

System action User response

The system returns to the calling procedure. Verify the filespace name.
ANS0241E On dsmSendObj, dsmDeleteObj, or
User response
dsmUpdateFS the filespace is not
An end user can respond in the following ways: registered.
• Check the network for errors.

Chapter 2. ANS 0000-9999 messages 13

Explanation User response
On dsmSendObj, dsmDeleteObj, or dsmUpdateFS, the Install the latest IBM Spectrum Protect API library.
filespace is not registered.
ANS0245E The caller's structure version is
different than the IBM Spectrum
System action Protect library version.
The system returns to the calling procedure.
Explanation
User response The caller's structure version is different than the IBM
Verify the filespace name. Spectrum Protect library version.

ANS0242W On dsmRegisterFS the filespace is

System action
already registered.
The system returns to the calling procedure.
Explanation
User response
On dsmRegisterFS the filespace is already registered.
Ensure that the stVersion field is set with the value in
System action the header file. Recompile the application with the
latest header files.
The system returns to the calling procedure.
ANS0246E Issue dsmEndTxn and then begin
User response a new transaction session.

Verify the filespace name. Explanation

ANS0243E On dsmBeginGetData the objID is This transaction must be ended and a new one must
NULL. be started due to one of the following reasons:
The destination changed.
Explanation
The byte limit is exceeded
On dsmBeginGetData, the objID is NULL. The maximum number of objects is exceeded.

System action System action

The system returns to the calling procedure. The system returns to the calling procedure.

User response User response

Verify the following: Issue dsmEndTxn and start a new transaction session.
The dsmGetList is not NULL. ANS0247E The backup or archive object is
Each objID is not NULL. excluded from processing.
The dsmGetList numObjId is not zero.
ANS0244E On dsmInit, the caller API version Explanation
is different than the IBM Spectrum The backup or archive object is excluded from
Protect library version. processing.

Explanation System action

On dsmInit, the caller API version is later than the IBM The system returns to the calling procedure.
Spectrum Protect library version.
User response
System action
Verify the objName and Exclude lists.
The system returns to the calling procedure.
ANS0248E The backup object does not have a
copy group.

14 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS0252E The sendObj ObjAttr.objInfo is too
long.
The backup object does not have a copy group.

Explanation
System action
The sendObj ObjAttr.objInfo is too long.
The system returns to the calling procedure.

System action
User response
The system returns to the calling procedure.
Verify server policy definitions.
ANS0249E The archive object does not have a User response
copy group.
The objInfo field must be less than or equal to
DSM_MAX_OBJINFO_LENGTH.
Explanation
ANS0253E The sendObj dsmObjName.hl is
The archive object does not have a copy group.
too long.

System action
Explanation
The system returns to the calling procedure.
The sendObj dsmObjName.hl is too long.
User response
System action
Verify server policy definitions.
The system returns to the calling procedure.
ANS0250E Memory used by the IBM
Spectrum Protect API has been User response
corrupted.
The hl field must be less than or equal to
DSM_MAX_HL_LENGTH.
Explanation
ANS0254E The password, or
Memory used by the IBM Spectrum Protect API has
been corrupted. encryptionPassword string
provided is too long.
System action
Explanation
The system returns to the calling procedure.
The value provided for password or
encryptionPassword is too long.
User response
Retry the operation. If the problem continues, contact System action
your system administrator or service representative.
The system returns to the calling procedure.
ANS0251E The sendObj Archive description is
too long. User response
The password or encrypionPassword field must be
Explanation
less than DSM_MAX_VERIFIER_LENGTH.
The sendObj Archive description is too long.
ANS0255E The sendObj dsmObjName.fs is
too long.
System action
The system returns to the calling procedure. Explanation
The sendObj dsmObjName.fs is too long.
User response
The sndArchiveData.descr string must be less than or System action
equal to DSM_MAX_DESCR_LENGTH.
The system returns to the calling procedure.

Chapter 2. ANS 0000-9999 messages 15

User response System action
The fs field must be less than or equal to The system returns to the calling procedure.
DSM_MAX_FS_LENGTH.
ANS0256E The sendObj dsmObjName.ll is too User response
long. On dsmGetNextQObj ensure that the dataBlk buffer is
at least as big as the query response structure.
Explanation
ANS0260E An invalid option keyword was
The sendObj dsmObjName.ll is too long. found during option parsing.

System action Explanation

The system returns to the calling procedure. An invalid option keyword was found in the dsmInit
configuration file, the option string, dsm.sys, or
User response dsm.opt.

The ll field must be less than or equal to

System action
DSM_MAX_LL_LENGTH.
The system returns to the calling procedure.
ANS0257E On RegisterFS or UpdateFS the
fsAttr's fsInfo is too long.
User response
Explanation Correct the spelling of the option keywords. Verify that
the dsmInit configuration file only has a subset of the
On RegisterFS or UpdateFS the fsAttr's fsInfo is too dsm.sys options. Check the error log for more details
long. about the error.

System action ANS0261E The configuration file specified on

dsmInit cannot be opened.
The system returns to the calling procedure.
Explanation
User response
The configuration file specified on dsmInit cannot be
The fsInfo field must be less than or equal to opened.
DSM_MAX_FSINFO_LENGTH.
ANS0258I On dsmGetNextQObj or System action
dsmGetData there is more The system returns to the calling procedure.
available data.
User response
Explanation
Verify the file name.
On dsmGetNextQObj or dsmGetData there is more
available data. ANS0262E The Include/Exclude definition file
was not found.
System action
Explanation
The system returns to the calling procedure.
The Include/Exclude definition file was not found.
User response
System action
Call the function again.
The system returns to the calling procedure.
ANS0259E The dataBlk buffer is too small for
the query response.
User response
Explanation Verify the file name on the Inclexcl option.
The dataBlk buffer is too small for the query response.

16 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS0263E Either the dsm.sys file was not System action
found, or the Inclexcl file specified The system returns to the calling procedure.
in dsm.sys was not found.

User response
Explanation
Check the reason field for the code which explains why
Either the dsm.sys file was not found, or the Inclexcl
the transaction has been aborted.
file specified in dsm.sys was not found.
ANS0267E Invalid command line option/
System action value: 'option'

The system returns to the calling procedure.

Explanation

User response The option is not valid on this command line.

The dsm.sys file must be in the directory referenced by

System action
the environment variable DSMI_DIR. Verify the file
name on the Inclexcl option in the dsm.sys file. Processing stops
ANS0264E Only a UNIX root user can execute
dsmChangePW or dsmDeleteFS. User response
Verify that the option and value are not misspelled and
Explanation are valid with the current command.
Only a UNIX root user can execute dsmChangePW or ANS0268E Server problem: Destination not
dsmDeleteFS. defined.

System action Explanation

The system returns to the calling procedure. Server problem: Destination not defined.

User response System action

Run this program as a root user. Processing stopped.
ANS0265E You must issue dsmBindMC before
dsmSendObj. User response
Have your service representative check the error log.
Explanation
ANS0270S The data buffer overflowed.
You must issue dsmBindMC before dsmSendObj.
Explanation
System action
The data buffer overflowed. This is a programming
The system returns to the calling procedure. failure and the client program ends.

User response System action

Modify your program. Processing stopped.
ANS0266I The dsmEndTxn vote is ABORT, so
check the reason field. User response
Retry the operation. If the problem continues, contact
Explanation your system administrator.
After a dsmEndTxn call, the transaction is aborted by ANS0271E No more files can be restored or
either the server or client with a DSM_VOTE_ABORT retrieved since the destination
and the reason is returned. directory is full.

Chapter 2. ANS 0000-9999 messages 17

Explanation ANS0275S The dsmtca would block the
operation.
No more files can be restored or retrieved since the
destination directory is full.
Explanation
System action The dsmtca blocks the operation. This is a
programming failure and the client program ends.
Processing stopped.

System action
User response
Processing stopped.
Free up disk space, or restore or retrieve the file to
another disk.
User response
ANS0272I The operation is finished.
Retry the operation. If the problem continues, contact
your system administrator.
Explanation
ANS0276S The area for the include/exclude
The operation is finished.
pattern is too small.

System action
Explanation
The system returns to the calling procedure.
The area for the include/exclude pattern is too small.
This is a programming failure and the client program
User response ends.
Proceed with next function call.
System action
ANS0273E The dsmtca execution/owner
permissions are invalid. Processing stopped.

Explanation User response

The dsmtca execution/owner permissions are invalid. Retry the operation. If the problem continues, contact
your system administrator.
System action ANS0277S There is no closing bracket in the
Processing stopped. pattern.

User response Explanation

Have your system administrator check the installation There is no closing bracket in the pattern. This is a
instructions for the client to ensure that the dsmtca programming failure and the client program ends.
permissions are set correctly.
System action
ANS0274S Process killed.
Processing stopped.
Explanation
User response
Processing stopped. This is a programming failure and
the client program ends. Retry the operation. If the problem continues, contact
your system administrator.
System action ANS0278S The transaction will be aborted.
Processing stopped.
Explanation
User response The server encountered an error and will abort the
Retry the operation. If the problem continues, contact transaction.
your system administrator.

18 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS0283E High level qualifier of the object
name should start with the
The transaction will be aborted. The reason code is
directory delimiter.
passed on the dsmEndTxn call.

Explanation
User response
The high level qualifier for the object name is invalid.
Issue the dsmEndTxn with a vote of
DSM_VOTE_COMMIT and examine the reason code.
System action
ANS0279I A file was skipped during a restore
operation because the file is off The system returns to the calling procedure.
line and the application has
chosen not to wait for a tape User response
mount.
High level qualifier of the object name should start
with the directory delimiter.
Explanation
ANS0284E The number of objects on
A file was skipped during a restore operation because dsmBeginGetData exceeds
the file is off line and the application has chosen not to DSM_MAX_GET_OBJ |
wait for a tape mount. DSM_MAX_PARTIAL_GET_OBJ.

System action Explanation

File skipped. The number of objects (numObjId) specified on the
dsmBeginGetData call exceeds DSM_MAX_GET_OBJ |
User response DSM_MAX_PARTIAL_GET_OBJ.
Verify the application sets the mountWait value
correctly on dsmBeginGetData. System action

ANS0280E Unable to find the dsmtca module. The system returns to the calling procedure.

Explanation User response

IBM Spectrum Protect was unable to find the dsmtca Check the number of objects before calling
module in the specified directory. dsmBeginGetData. If it is greater than
DSM_MAX_GET_OBJ | DSM_MAX_PARTIAL_GET_OBJ,
then issue multiple Get call sequences.
System action
ANS0285E The update action is invalid.
Processing ends.

Explanation
User response
The dsmUpdateFS or dsmUpdateObj action is invalid.
Make sure the dsmtca module is in the directory
specified by DSMI_DIR.
System action
ANS0282E Password file is not available.
The system returns to the calling procedure.
Explanation
User response
The file containing the stored password for the
specified server-name is unavailable. Correct the action value. Valid values are defined in
dsmapitd.h and documented in our Using the API
book.
System action
ANS0286E The key file is missing.
Processing ends.

Explanation
User response
The key file for Data Protection for Oracle cannot be
The root user must set and store a new password.
found.

Chapter 2. ANS 0000-9999 messages 19

System action System action
The system returns to the calling procedure. Session was not started.

User response User response

Ensure that you have ordered the Data Protection for Check with your system administrator to find out why
Oracle, and install the key file. your user id is locked.
ANS0287E The key file content is invalid. ANS0299E Scheduler cannot be started
manually because the value of
Explanation MANAGEDSERVICES option is
SCHEDULE.
The key file content for Data Protection for Oracle is
invalid.
Explanation

System action if MANAGEDSERVICES SCHEDULE is indicated in the

option file, the IBM Spectrum Protect scheduler
The system returns to the calling procedure. cannot be started in the traditional manner.

User response System action

Ensure that you have ordered the Data Protection for Scheduler stopped.
Oracle, and install the key file.
ANS0296I Encryption key passwords are not User response
the same. If you are not going to use dsmcad to manage the
Please try again... schedule anymore, stop dsmcad and remove
MANAGEDSERVICES option from the option file.
Explanation
ANS0302I Successfully done.
Encryption key passwords do not match.
Explanation
System action
The operation successfully completed.
You are prompted for the encryption key password.
System action
User response
None.
Enter the correct encryption key password.
ANS0297E Error opening specified file. User response
None.
Explanation
ANS0304E The password is too short.
The specified file could not be located or opened.
Explanation
System action
The new password does not have enough characters.
Attempts to open file failed.
System action
User response
The password is not updated on the server.
Make sure the file exists.
ANS0298E Session Rejected: The specified User response
user id is currently locked Choose a different password. Contact your IBM
Spectrum Protect administrator to lean the password
Explanation requirements.
The user id you specified is currently locked on the ANS0305E It is too soon after the previous
server. update to change the password.

20 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
The password cannot be changed since not enough Contact your system administrator for more
time has elapsed since the last password update. information.
ANS0309E Remote operation failed to start on
System action obj-name. Status: status
The password is not updated on the server.
Explanation
User response The request to start a remote operation has failed for
Try to change your password again later. the indicated node and file space. The status of the
failure is shown.
ANS0306E The password was previously
used.
System action

Explanation Current operation has ended.

The new password that you entered was previously

User response
used.
Contact your system administrator for more
System action information.

The password is not updated on the server. ANS0311E The tsmBuffHandle is invalid, or
the value of dataPtr is invalid.
User response
Explanation
Choose a different password.
An invalid value for a handle or dataPtr has been
ANS0307E The password does not meet the passed into the API.
requirements.
System action
Explanation
The system returns to the calling procedure.
The new password that you entered does not meet the
requirements, such as the number of special
User response
characters or digits.
There is a problem with the calling application. Verify
System action the values of the tsmBuffHandle and dataptr passed to
the API.
The password is not updated on the server.
ANS0312E The number of bytes copied into
User response the tsmBuffer is larger than the
allowed value.
Choose a different password. Contact your IBM
Spectrum Protect administrator to learn the password Explanation
requirements.
An invalid number of bytes was copied to a tsmBuffer.
ANS0308E Remote operation failed to start on
obj-name. Status: status reason:
System action
reason
The system returns to the calling procedure.
Explanation
User response
The request to start a remote operation has failed for
the indicated node and file space. The status and the There is a problem with the calling application. Verify
reason for the failure are shown. the number of bytes copied into the tsmBuffer.
ANS0313E dsmTerminate cannot finish
System action because the application is holding
Processing ends. on to 1 or more tsmBuffers.

Chapter 2. ANS 0000-9999 messages 21

Explanation System action
An application is trying to terminate a session, but is The system returns to the calling procedure.
still holding some tsmBuffers.
User response
System action
Install the message text file again.
The system returns to the calling procedure.
ANS0317E Unable to use message text file.

User response
Explanation
The application must return all buffers for this session
The system is unable to use the message txt file
by calling tsmReleaseBuffer, and then issue
(dscenu.txt or dsmclientV3.cat for AIX) because of an
dsmTerminate.
invalid control record. On the AS/400 platform this file
ANS0314E An internal error occurred in the is QANSAPI/QAANSENU(TXT).
tsmBuffer array.
System action
Explanation
The system returns to the calling procedure.
An internal API buffer array error occurred.
User response
System action
Install the message text file again.
The system returns to the calling procedure.
ANS0318E Invalid value for DATEFORMAT
specified.
User response
Try the operation again. If the problem continues, Explanation
contact your system administrator or service
representative. An invalid value is specified for DATEFORMAT.

ANS0315E Unable to open message text file. System action

The system returns to the calling procedure.
Explanation
The system is unable to open the message txt file User response
(dscenu.txt or dsmclientV3.cat for AIX). On the
AS/400 platform this file is QANSAPI/ Specify a valid value.
QAANSENU(TXT). ANS0319E Invalid value for TIMEFORMAT
specified.
System action
The system returns to the calling procedure. Explanation
An invalid value is specified for TIMEFORMAT.
User response
Verify that the dscenu.txt file is in the directory pointed System action
to by DSMI_DIR. For AIX, verify that the The system returns to the calling procedure.
dsmclientV3.cat file has a symbolic link
to /usr/lib/nls/msg/<locale>/dsmclientV3.cat .
User response
ANS0316E Unable to use message text file.
Specify a valid value.

Explanation ANS0320E Invalid value for NUMBERFORMAT

specified.
The system is unable to use the message text file
(dscenu.txt or dsmclientV3.cat for AIX) because of an
Explanation
invalid header. On the AS/400 platform this file is
QANSAPI/QAANSENU(TXT). An invalid value is specified for NUMBERFORMAT.

22 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The system returns to the calling procedure. partialObjLength value for partial object retrieve is
invalid.
User response
System action
Specify a valid value.
The system returns to the calling procedure.
ANS0321E msg parameter for dsmRCMsg is a
NULL pointer.
User response
Explanation Specify a valid value.
The message parameter for dsmRCMsg is a NULL ANS0325E Partial Object Retrieve is not
pointer. supported on this server.

System action Explanation

The system returns to the calling procedure. The IBM Spectrum Protect server specified by the user
does not support partial object retrieve.
User response
System action
Allocate enough space for the message parameter.
The system returns to the calling procedure.
ANS0322E no text available for this return
code.
User response
Explanation Specify a IBM Spectrum Protect server which supports
the partial object retrieve function.
The dsmRC parameter for dsmRCMsg is an
unsupported return code. ANS0326E This node has exceeded its
maximum number of mount
System action points.

The system returns to the calling procedure.

Explanation

User response Either no tape or sequential disk mount points are

permitted for this operation, or the maximum number
Specify a valid value. of mount points allowed are already in use. The
ANS0323E partialObjOffset value for partial operation can not be completed. The IBM Spectrum
object retrieve is invalid. Protect administrator defines the maximum number of
mount points with the MAXNUMMP property of your
node definition.
Explanation
The partialObjOffset value for partial object retrieve is System action
invalid.
The object is skipped
System action
User response
The system returns to the calling procedure.
If you are performing any other operations that might
be using mount points, wait until those operations are
User response complete, then try the failed operation again.
Specify a valid value. Otherwise contact your IBM Spectrum Protect
administrator for further assistance
ANS0324E partialObjLength value for partial
object retrieve is invalid. ANS0327E A duplicate object was found,
operation cannot complete.

Chapter 2. ANS 0000-9999 messages 23

Explanation User response
A duplicate object was found, operation cannot Ensure that the correct drive or file system was
complete. specified and that files are backed up for you to set
access.
System action ANS0332E No files have been previously
The requested operation failed. archived for this filename/
filespace.
User response
Explanation
Try the operation with a different file specification.
You tried to set access to files when no files for the
ANS0328E The specified objects failed the specified filename, drive or file system were previously
merge test. archived.

Explanation System action

The specified objects failed the merge test, operation Processing stopped.
cannot complete.
User response
System action
Ensure that the correct drive or file system was
The requested operation failed. specified and that files are archived for you to set
access.
User response
ANS0333E Unknown Remote Mover type
See documentation for the merge test parameters.
ANS0330E The dsmSetAccess access Type is Explanation
invalid. The specified Remote Mover type is unknown.

Explanation System action

The dsmSetAccess accessType is invalid. Current operation has ended.

System action User response

The system returns to the calling procedure. Contact your system administrator for more
information.
User response
ANS0334E An Operation for the requested
The accessType must be one of the following: node and file space is already in
atBackup progress.
atArchive
Explanation
ANS0331E No files have been previously
backed up for this filename/ A request has been made to use a data mover to
filespace. perform an operation for the indicated node and file
space. Since an operation for this node and file space
is already in progress, the new operation cannot be
Explanation performed.
You tried to set access to files when no files for the
specified filename, drive or file system were previously System action
backed up.
Current operation has ended.
System action
User response
Processing stopped.
Retry the operation at a later time.
ANS0335E System resource in use

24 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
A required resource is in use by another command or Contact your system administrator for more
process. information.
ANS0339E The specified target storage pool
System action is not defined.
Current operation has ended.
Explanation
User response The storage pool is not defined.
Retry the operation at a later time.
System action
ANS0336E Server plugin communication error
Current operation has ended.
Explanation
User response
Communication between a server plugin module and a
NAS filer failed. Contact your system administrator for more
information.
System action ANS0340E A target storage pool does not
Current operation has ended. have the correct data format for
the given node type.
User response
Explanation
Contact your system administrator for more
information. none

ANS0337E Server plugin detected

System action
unsupported NAS filer operating
system. Current operation has ended.

Explanation User response

A plugin module detected that a NAS filer is running an Contact your system administrator for more
unsupported operating system or operating system information.
level.
ANS0341E No associated data mover is
defined for the given node.
System action
Current operation has ended. Explanation
none
User response
Contact your system administrator for more System action
information.
Current operation has ended.
ANS0338E An invalid operation was
attempted on a node User response
Contact your system administrator for more
Explanation
information.
The operation is not valid.
ANS0342E The CRC received from the Server
does not match the CRC calculated
System action by the client.
Current operation has ended.
Explanation
The server sent a CRC for a buffer. The client
calculated a CRC for the same buffer. These did not

Chapter 2. ANS 0000-9999 messages 25

match. The mismatch indicates a communication ANS0346E Input destination does not match
failure. expected destination.

System action Explanation

In some cases, the client can indicate the failure to the Input destination does not match expected
server and retry the operation. destination.

User response System action

Check the trace log for additional information and retry The current operation stops.
the operation. If the problem persists, contact your
system administrator. User response
ANS0343E An invalid operation was Retry operation with proper destination.
attempted on a group leader or
group member. ANS0347E Data mover is not available.

Explanation Explanation

An invalid operation was attempted on a logical group. Data mover is not available.

System action System action

The current operation stops. The current operation stops.

User response User response

Retry a valid operation. Retry operation with a proper Data mover.

ANS0344E Cannot Send data with a zero byte ANS0348E Operation failed because the copy
sizeEstimate. continue option was set to NO.

Explanation Explanation

You cannot send data for an object with size estimate Operation failed because the copy continue option was
= 0. set to NO.

System action System action

The system returns to the calling procedure. The current operation stops.

User response User response

Set size estimate greater than 0 in dsmSendObj. This abort code indicates that a store operation, like
backup or archive failed because the copy continue
ANS0345E Remote disk not defined. option was set to NO. The sysadmin will need to
resolve the problem on the server end.
Explanation
ANS0349E Transaction failed because of a
An operation was attempted on a remote disk that is problem during a store operation.
not defined.
Explanation
System action
Transaction failed because of a problem during a store
The current operation stops. operation. This error is typical when the next storage
pool has a different copy storage pool list and we
User response switch to this pool in the middle of a transaction.

Define the proper remote disk.

26 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
Transaction is aborted. The session is rejected or the transaction is cancelled,
ending the current operation.
User response
User response
Resend objects in separate transactions.
See your system administrator.
ANS0350E The current client configuration
does not comply with the value of ANS0353E When using useTsmBuffers,
the DATAWRITEPATH or dataBlk must be NULL in calls to
DATAREADPATH server option for dsmSendObj and dsmGetObj.
this node.
Explanation
Explanation
The value for dataBlk must be NULL when using
The values of the DATAWRITEPATH and useTsmBuffers.
DATAREADPATH server options specify where the
client is allowed to send data, and where data is read System action
from. The values for the specified node name should
correspond with the client configuration. For example, The system returns to the calling procedure.
you will get this error message if DATAWRITEPATH
contains a LAN value and the client is configured to User response
use LAN-free protocol, or vice versa.
There is a problem with the calling application.
Contact your application provider
System action
ANS0354E Encryption is not allowed when
Processing stopped. using useTsmBuffers.

User response Explanation

Check the client, server, and storage agent logs to useTsmBuffers does not support encryption.
determine why the client was not able to send data
LAN-free. Make sure the client configuration and
server options are compatible. System action
The system returns to the calling procedure.
ANS0351E The node or user does not have
proper authority to perform this
operation User response
Try the operation again, without using useTsmBuffers,
Explanation or disable encryption for this operation.
The node or user does not have proper authority to ANS0355E This object cannot be restored/
perform this operation. retrieved using useTsmBuffers,
because it is compressed.
System action
The transaction is ended. Explanation
useTsmBuffers does not support compression.
User response
Check the authority for the specified object. System action
The system returns to the calling procedure.
ANS0352E The operation is not permitted due
to server licenses values.
User response
Explanation Try the operation again, without using useTsmBuffers.
The node or user is trying to perform an operation that ANS0356E This object cannot be restored/
either exceeds license values, or is not licensed. retrieved using useTsmBuffers,
because it is encrypted.

Chapter 2. ANS 0000-9999 messages 27

Explanation System action
useTsmBuffers does not support encryption. The system returns to the calling procedure.

System action User response

The system returns to the calling procedure. Either remove the ENABLEENCRYPTKEY option from
the options file, or set the parameter
User response bEncryptKeyEnabled to bFalse in the program using
the IBM Spectrum Protect API.
Try the operation again, without using useTsmBuffers.
ANS0360E The client acceptor cannot start
ANS0357E When using useTsmBuffers, a because the value of the
restore/retrieve with partial object MANAGEDSERVICES option is
restore is not allowed. NONE.

Explanation Explanation
useTsmBuffers does not support partial object restore. The client acceptor will not start if
MANAGEDSERVICES NONE is set in the option file. The
System action client acceptor is designed to manage the web client
or IBM Spectrum Protect schedules. By specifying
The system returns to the calling procedure.
NONE, the client acceptor will not manage any
services.
User response
Make sure the calling application is either using Partial System action
object restore or useTsmBuffers.
The client acceptor will stop processing.
ANS0358E No encryption key was found. If
you are using -encryptkey=prompt User response
make sure there is a value in the
encryptionPasswordP field and Specify either WEBCLIENT or SCHEDULER for the
that bEncryptKeyEnabled is set to MANAGEDSERVICES option in the option file then
true. restart the client acceptor.
ANS0361I DIAG:
Explanation
There was no encryption key found in the password Explanation
file, or no key was provided by the application. The message text is provided for diagnostic purposes
and is meant to provide information to IBM support in
System action problem determination.
The system returns to the calling procedure.
System action
User response None.
If you are using -encryptkey=prompt, make sure there
is a value in encryptionPasswordP and that User response
bEncryptKeyEnabled is set to true. None.
ANS0359E Conflicting encryption key options ANS0362E There are insufficient Windows
have been specified. system resources to process this
command.
Explanation
When using the ENABLEENCRYPTKEY option, the Explanation
parameter bEncryptKeyEnabled for the IBM Spectrum This problem can occur during backup of a shared
Protect API dsmInitExIn_t and tsmInitExIn_t directory. The most likely reason is the 'IRPStackSize'
structures cannot be set to bTrue. setting on the computer that hosts the shared
directory is too small.

28 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS0365E The signature check of one or
more files failed. The retrieved
The file is skipped.
files will be removed.

User response
Explanation
Check the Windows event viewer for event ID 2011 on
One or more files were not retrieved correctly. The
the computer that hosts the shared directory. This
files might be changed or damaged.
event indicates that the configuration parameter
IRPStackSize is too small. IRPStackSize is a setting of
type DWORD located in Windows registry key System action
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet Processing stops.
\services\LanmanServer\Parameters. If the
IRPStackSize value is less than 20, or IRPStackSize is
User response
not specified, then set the value to 20, restart the
system, and try the operation again. The default One or more files were changed or damaged. Make
IRPStackSize value is 15. Attention: Consult with your sure that the data in the Operations Center, such as
Windows system administrator before making changes the client package or Update Manager package, is
to the Windows registry or the problem persists after correct or download the correct version in the
changing the IRPStackSize value to 20. Operations Center.
ANS0363E The signature check of the ANS0366W The signature check of one or
content.spsig file failed. The more files failed.
retrieved files will be removed.
Explanation
Explanation
One or more files were not retrieved correctly. The
The IBM Spectrum Protect signature file, files might be changed or damaged.
content.spsig, was not retrieved correctly. The file was
manipulated or damaged. System action
Processing continues.
System action
Processing stops. User response
One or more files were changed or damaged. Ensure
User response
that the files that were retrieved are not corrupted.
The content.spsig file was not found. Make sure that
the data in the Operations Center, such as the client ANS0367E One or more files were not found
package or Update Manager package, is correct or during the signature check. The
download the correct version in the Operations Center. retrieved files will be removed.

ANS0364W The signature check of the Explanation

content.spsig file failed.
One or more files were not retrieved.
Explanation
System action
The IBM Spectrum Protect signature file,
content.spsig, was not retrieved correctly. The file was Processing stops.
changed or damaged.
User response
System action One or more files were not retrieved. Make sure that
Processing continues. the data in the Operations Center, such as the client
package or Update Manager package, is correct or
download the correct version in the Operations Center.
User response
The content.spsig file is damaged or changed. Ensure ANS0368W One or more files were not found
that the data that was retrieved is not corrupted. The during the signature check.
data was probably damaged or changed.

Chapter 2. ANS 0000-9999 messages 29

Explanation User response
One or more files were not retrieved. Important files No user action is required.
might be missing.
ANS0371E The content.spsig file was not
found. A signature check cannot
System action be completed. All retrieved files
Processing continues. will be removed.

User response Explanation

One or more files were damaged or changed. Ensure The IBM Spectrum Protect signature file,
that the files that were retrieved are not corrupted. content.spsig, was not found. A signature check is not
The missing files could be important or not retrieved possible. It is not possible to check whether the files
on purpose. For example, a file might not be retrieved that were retrieved are damaged or changed.
because it was removed on the server.
System action
ANS0369E The content.spsig file is not a IBM
Spectrum Protect signature file. Processing stops.
The retrieved files will be
removed. User response
The content.spsig file was not found. Make sure that
Explanation
the data in the Operations Center, such as the client
A content.spsig file was found, but it is not a IBM package or Update Manager package, is correct or
Spectrum Protect signature file. The content of the download the correct version in the Operations Center.
retrieve could not be verified.
ANS0372E More than one content.spsig file
was found. A signature check
System action cannot be completed. All retrieved
Processing stops. files will be removed.

User response Explanation

If a content.spsig file is found during retrieve, the More than one IBM Spectrum Protect signature file,
client will try to identify this file as a signature file. If content.spsig, was found. A signature check is not
the file is not a IBM Spectrum Protect signature file, possible. It is not possible to check whether the files
the client is not able to verify the files. Make sure that that were retrieved are damaged or changed.
the data in the Operations Center, such as the client
package or Update Manager package, is correct or System action
download the correct version in the Operations Center.
Processing stops.
ANS0370W The content.spsig file is not a IBM
Spectrum Protect signature file. User response
More than one content.spsig file was found. Make sure
Explanation
that the data in the Operations Center, such as the
A content.spsig file was found, but it is not a IBM client package or Update Manager package, is correct
Spectrum Protect signature file. The content of the or download the correct version in the Operations
retrieve could not be verified. If a content.spsig file is Center.
found during retrieve the client will try to identify this
ANS373I The SAN Policy of the system is set
file as signature file. If the file is not a IBM Spectrum
Protect signature file, the client is not able to verify the to 'san_policy_value'.
data.
Explanation
System action The VMware Virtual Disk Development Kit used to
open, close, read, and write VMware VMDKs requires
Processing continues.
the specified Windows SAN Policy setting for the
datamover hardware and transport type in use.

30 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS0377E The value for the path parameter
is incorrect.
The Windows SAN Policy of the system is configured
and the current operation continues.
Explanation
User response The path parameter cannot be longer than 6000
characters.
When a system is set to Offline All, you need to
manually set new disks to Online.
System action
ANS0374E The CAD service is not running on
the local node. The operation cannot continue.

Explanation User response

The CAD service is not running. Make sure that the path parameter is used correctly.
ANS0378E The value for the name parameter
System action is incorrect.
The operation cannot continue without a connection to
the CAD service. Explanation
The name parameter cannot be longer than 512
User response characters and cannot start with the directory
delimiter.
Make sure that the CAD service is running and
configured correctly.
System action
ANS0375E The fileSpace parameter is either
not defined or too long. The operation cannot continue.

Explanation User response

The fileSpace parameter cannot be empty and cannot Make sure that the name parameter is used correctly.
be longer than 1024 characters. ANS0379E The value for the status parameter
is incorrect.
System action
The operation cannot continue. Explanation
The status parameter can only be "ALL", "ACTIVE" or
User response "INACTIVE".
Make sure that the fileSpace parameter is used
correctly. System action

ANS0376E The value for the codePage The operation cannot continue.
parameter is incorrect.
User response
Explanation Make sure that the status parameter is used correctly.
The codePage parameter can only be "MBCS" or ANS0380E The value for the type parameter
"UCS2". is incorrect.

System action Explanation

The operation cannot continue. The type parameter can only be "FILE" or "DIR".

User response System action

Make sure that the codePage parameter is used The operation cannot continue.
correctly.

Chapter 2. ANS 0000-9999 messages 31

User response System action
Make sure that the type parameter is used correctly. The system returns to the calling procedure.
ANS0381E The value for either the
startDateTime or endDateTime User response
parameter is incorrect. Check permissions on file. See if license file is in the
correct place.
Explanation
ANS0403E Data in the license file is not in a
The startDateTime and endDateTime parameters can valid format.
only be a valid JSON date time format.
Explanation
System action
The license file is not valid.
The operation cannot continue.
System action
User response
The system returns to the calling procedure.
Make sure that the startDateTime and endDateTime
parameters are used correctly. User response
ANS0400E License file could not be opened. User needs to obtain a new license.
ANS0404E The checksum in the license file
Explanation
does not match the
The license file was not found, or could not be opened licenseregistration string.
because of permissions or the file is corrupted.
Explanation
System action
The registration string is not valid.
The system returns to the calling procedure.
System action
User response
The system returns to the calling procedure.
Check permissions on file. See if the license file is in
the correct place. User response
ANS0401E Read failure on the license file. User needs to obtain a new license.
ANS0405E This is an expired try and buy
Explanation
license.
The license file was not found, or could not be opened
because of permissions, or the file is corrupted. Explanation
The registration string is not valid.
System action
The system returns to the calling procedure. System action
The system returns to the calling procedure.
User response
Check permissions on file. See if the license file is in User response
the correct place.
User needs to obtain a new license.
ANS0402E Write failure on the license file.
ANS0420W Warning! Restoring inactive
system state objects is not
Explanation
recommended.
The license file was not found, or could not be opened Do you wish to continue?
because of permissions or the file is corrupted.

32 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
Restoring inactive system state objects may cause Processing continues.
system instability. Examples of possible problems
include: User response
• Applications that were installed after the time the Choose a local drive where journal databases will be
system state was backed up cannot function stored.
properly after restoring the inactive system state
ANS0423E Directory 'filespace namepath-
• Critical operating system updates installed after the
namefile-name' cannot be created.
inactive system state backup was made can no
Path does not exist.
longer be available, or may not function correctly.
Restoring inactive system state objects is not Explanation
recommended unless you are certain that this is what
you need to do. The operating system returned a "path not found"
status when IBM Spectrum Protect attempted to
create the directory needed for Automated System
System action
Recovery (ASR). One possible reason is that a multi
If user responds with yes, the client will restore the disk system is restored to a single disk system.
object. If user responds with no, the client will cancel
the operation. System action
Processing stopped.
User response
Reply to the prompt. If you are unsure, reply no, and User response
consult your system administrator or operating system
vendor before proceeding further. Please verify that you are restoring to identical
hardware and try again.
ANS0421W Unable to synchronize the node
password with the user id ANS0649E Disk provider for volume volume-
password provided. name does not support the snap of
a snap feature.
Explanation
Explanation
The node password was not updated due to the reason
described in the error message preceding this one. You can use the snap of a snap feature only on SVC,
XIV and Storwize systems.
System action
System action
The node password is not updated on the server. Next
time you run the client you will be prompted for the Processing ends.
password again.
User response
User response Reset the USESNAPOFASNAPTOMOUNT option to No
See the preceding error message. in the Data Protection configuration file and set
MOUNTRW=Yes to mount the read/write backup.
ANS0422W The selected journal location is a
network drive and might not be ANS0990W Options file 'file-name' could not
accessible from the journal be found. Default option values
service. Select a location on a local will be used.
drive.
Explanation
Explanation Common reasons for this warning include:
It is not recommended to use a network device as the • The default options file does not exist, and
location where journal databases are stored. Placing
• You did not specify the -OPTFILE option when
journal databases on a network device can prevent the
starting the IBM Spectrum Protect client, and
journal service from running.
• the environment variable DSM_CONFIG was not set.

Chapter 2. ANS 0000-9999 messages 33

System action System action
IBM Spectrum Protect client assumes default values Objects which are part of this filespace are not
for all client options and continues processing, using processed.
the default server name and associated options found
in the dsm.sys file. User response
Try the command again, and specify a different
User response
destination for the object that was not processed.
If the default system action is acceptable, you can
ANS0993E The source specification "source"
eliminate this message by creating an empty dsm.opt
has invalid format.
file in the installation directory.
If you have a client user options file (dsm.opt), either Explanation
place it in the installation directory or set the
DSM_CONFIG environment variable to the fully- The file system must be enclosed in curly braces and
qualified path and file name of your options file. wildcards cannot be used except at the lower level.

Review the information on configuring IBM Spectrum

System action
Protect in the IBM Spectrum Protect client manual
specific to your operating system. If the problem The command processing is terminated.
persists, ask your IBM Spectrum Protect administrator
for further assistance. User response
ANS0991I IBM Spectrum Protect scheduler is Correct the specification and try the command again.
listening for server requests on
port port number ANS0994E Invalid string 'string' for virtual file
space name or group name
Explanation specification.

This message indicates the port number on which the Explanation

clients is listens for server requests. If the port
number in the message differs from the default value You entered a virtual file space name or a group name
or what you specified with the TCPCLIENTPORT specification that contains wildcard characters.
option, it is because the port was in use by a different
process. System action
Processing stopped.
System action
Processing continues. User response
Enter a correct virtual file space name and a group
User response name and try again. Use the pick option to display a
Normally no further action is required. If you require list of groups from which you can select one group.
the use a specific port number, you need to configure ANS0995E Volume 'volume-name' could not
your system or applications so the number is avaible.
be locked.
Restart the IBM Spectrum Protect client and confirm it
uses the desired port.
Explanation
ANS0992E The destination filespace or drive
The system call to lock the volume failed.
letter is unavailable. For more
details please see dsmerror.log.
System action
Explanation Processing stopped.
The system is trying to restore or retrieve to a
destination that cannot be reached. The specified User response
filespace name or drive letter is not valid, or does not Please verify that no other application is accessing the
exist, or you are specifying a local share name that volume. During restore of an image IBM Spectrum
cannot be resolved. Protect must have exclusive use of the volume.

34 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1000E An unsupported communications Explanation
method was specified. Node has exceeded max tape mounts allowed. The
operation will be tried again later.
Explanation
None. System action
The operation will be retried.
System action
processing stops. User response
Increase the number of allowed tape mounts for this
User response node on the server to avoid this situation again.
Specify a communications interface that is supported ANS1005I TCP/IP read error on socket =
by the IBM Spectrum Protect client on your operating socket-id, errno = error-code,
system. See the IBM Spectrum Protect client manual reason : 'error-reason'.
for your operating system for further information on
configuring IBM Spectrum Protect client
Explanation
communications.
An attempt to receive data using TCP/IP connection
ANS1001E Volume being backed up was not a failed. If reason : 'Connection reset by peer', it is
system volume. Skipped. possible that the server control connection timed out.
This can occur if the file transfer time is greater than
Explanation the IDLETIMEOUT value set on the server.
User specified to back up system volume only. This
volume was not backed up since this volume is not a System action
system volume. TCP/IP connection to server fails.

System action User response

Volume was not backed up. If the timeout was due to a large file transfer time, you
can ignore this message. The client will reconnect with
User response the server automatically, finish transferring the data,
Use All option or use image backup command to and send statistics. You can also consider increasing
backup this volume. the IDLETIMEOUT value in the server options file.

ANS1002I MOS image is being created. It ANS1006I TCP/IP write error on socket =
may take a while. socket-id, errno = error-code,
reason : error-reason
Explanation
Explanation
Mini Operating System image is being created. It may
take a while to create it. An attempt to send data using TCP/IP connection
failed.
System action
System action
Processing Continues.
Connection to server fails.
User response
User response
None.
Retry the operation. If the problem persists, contact
ANS1004W Node has exceeded max tape your system administrator.
mounts allowed. Operation for
'filespace-name' will be tried again ANS1007E Sending of object 'object-
later. nameobject-nameobject-name'
failed. There is no backup copy
group.

Chapter 2. ANS 0000-9999 messages 35

Explanation • The specified registry key cannot be opened for
reading
The management class for this file (object-name) does
not have a backup copy group. Either the default • The entry under this key has incorrect data
management class does not have a backup copy
group, or an INCLUDE statement is attempting to bind System action
the file to a management class that does not have a
Processing continues without the full list of operating
backup copy group.
system include/exclude statements.

System action
User response
IBM Spectrum Protect did not back up the file.
Ensure that you have access to the specified registry
key and that entries are a MULTISZ values that
User response contain:
Run DSMC QUERY MGMTCLASS -DETAIL to view • Individual files
information about available management classes.
• Directories
• If the file is being bound to the default management
• Wild card entries
class, make sure the management class has a
backup copy group. • Environment variables
• If the file is being bound to a management class • /s switch (the /s switch is used on directory and/or
specified in an INCLUDE statement, make sure that wild card entries and signifies that all subdirectories
the management class has a backup copy group. of this directory should be excluded)
• If you have more than one IBM Spectrum Protect If the cause of this message can not be determined or
server, make sure you are connecting to the correct resolved, contact IBM technical support for further
server. assistance.
• If you are unable to find a suitable management ANS1010E Error processing 'filespace-name':
class, contact your IBM Spectrum Protect Unsupported file system
administrator for further assistance. operation.
ANS1008E Sending of object 'object-
nameobject-nameobject-name' Explanation
failed: No Archive Copy Group The file system does not support an operation required
to process the file or directory.
Explanation
The management class for this file (object-name) did System action
not have an archive copy group specified. The file or directory is skipped. Depending on the
specific error encountered, processing on Solaris
System action clients might stop.
The file could not be backed up.
User response
User response Verify that the file system is supported by the IBM
See your system administrator. Spectrum Protect client. If a restore or retrieve failed,
retry the operation to another location. If the problem
ANS1009W An error occurred processing the persists, look for other indications of system
operating system include/exclude problems. It may be necessary to run the operating
statements. system utility that checks and repairs file system
The error was detected while inconsistencies. If the problem still cannot be
processing: subsystemname. resolved, contact your IBM Spectrum Protect
administrator for further assistance.
Explanation ANS1015E The session is rejected. The server
The client encountered an error while obtaining the does not allow a signon of a client
automatic include/exclude statements from the that is not archive-retention
operating system. Possible reasons for this error protection enabled.
include:

36 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
The client cannot establish a connection to the server The port specified by the TCPCLIENTPORT option is in
because the server is enabled for archive-retention use by a different process.
protection enabled and the client is not.
System action
System action
Processing stopped.
The session is not started.
User response
User response
Contact the server administrator to set up a different
See your system administrator. port for server-initiated connections. Update the
TCPCLIENTPORT with this new port number.
ANS1016I No eligible files matching
'pathname' were found. ANS1019E The volume could not be opened.

Explanation Explanation
The backup or archive operation completed, but no An error occurred when IBM Spectrum Protect tried to
files were processed. Possible reasons for this include: open the volume for a backup or restore operation.
The directory that was backed up or archived
contains no files System action
The files are excluded from backup or archive The requested operation does not run.

System action User response

None Examine the client error log for additional messages
related to this error. Verify that the volume is available,
User response and is not locked by another process. Try the
operation again. If the problem persists, contact IBM
Check the path you entered. technical support for further assistance.
ANS1017E Session rejected: TCP/IP ANS1020E System object backup failed.
connection failure.
Explanation
Explanation
An error occurred while backing up Windows system
An attempt to connect to the server using TCP/IP object files. The backup did not complete.
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 System action
went down or if your system administrator canceled a Processing stopped.
backup operation.
User response
System action
Ask your system administrator to check the error log.
Session rejected. Processing stopped. Restart the Windows service associated with the
system object indicated in the error log, and retry the
User response backup operation
Retry the operation, or wait until the server comes ANS1021E System object restore failed.
back up and retry the operation. If the problem
continues, see your system administrator for further Explanation
help.
An error occurred while restoring Windows system
ANS1018E Port port number is already in use object files. The restore did not complete.

System action
Processing stopped.

Chapter 2. ANS 0000-9999 messages 37

User response User response
Ask your system administrator to check the error log. Check preceding error messages in error log for more
Restart the machine, and then restore the system information. Retry the operation. If problem continues,
object indicated in the error log again. contact your IBM Spectrum Protect administrator.
ANS1022E Cancel failed for node: node-name ANS1025E Session rejected: Authentication
filesystem: fs-name operation: op- failure
type error: error
Explanation
Explanation
Authentication failure. You entered an incorrect user id
The request to cancel a remote operation has failed. or password.
The node, file space, operation and reason for the
failure are shown. System action
Current operation has been cancelled.
System action
Operation not cancelled. User response
Enter your correct user id and password. If you cannot
User response
remember the correct user id or password, see your
Contact your system administrator for more system administrator to have new credentials
information. assigned for your node name.
ANS1023E Session rejected: Node type ANS1026E The session is rejected: There was
mismatch a communications protocol error.

Explanation Explanation
Your node name is associated with a different type of An unexpected network message was received by the
operating system and cannot be used on this system. client. This could be caused by network problems or a
programming error.
System action
System action
Current operation has been cancelled.
The current operation has been cancelled.
User response
User response
If you need a new node name, see your system
administrator to assign a new one to you. Generally, Verify that your communication path is functioning
you have a unique node name for each machine and properly and try the operation again. If the problem
operating system pair that requires access to the persists, contact your IBM Spectrum Protect
server. administrator for further assistance.
ANS1024E Failed to update backup attributes ANS1028S An internal program error
on server for 'backup_type' backup occurred.
for
'file_space_namepath_namefile_na Explanation
me', object id 'object_id:object_id'
return code 'return code'. An unexpected condition was encountered and the
operation can not continue. This might be a
programming error.
Explanation
Failed to update attributes for the named backup System action
object on the server. The server may not reflect correct
state of the backup. processing stops.

System action
Processing continues.

38 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Try the operation again. If the problem persists, Close all unneeded applications and try the operation
contact your IBM Spectrum Protect administrator or again. If the operation still fails, try dividing the task
IBM technical support for further assistance. into several smaller units. For example, if a file
specification contains several high level directories,
ANS1029E Communication with the IBM run the IBM Spectrum Protect task serially for each
Spectrum Protect server is lost. directory. If the IBM Spectrum Protect task is an
incremental backup, use the option "-
Explanation memoryefficientbackup=yes".
This message is issued after the session with the IBM For UNIX systems that support resource limits, check
Spectrum Protect server is unexpectedly lost. The to see b if the memory resource limit is too low by
client error log might contain additional information entering the following command: ulimit -a
regarding this problem.
Based on the resulting data, you can ask the UNIX
system root user to increase resource limits so that it
System action will override the current default. The UNIX system root
processing stops. user has the authority to increase resource limits.
ANS1031E The attempt to establish a TCP/IP
User response connection timed out before the
• Restart the IBM Spectrum Protect client and retry connection was made.
the operation.
• If the problem persists, review the client error log for Explanation
other messages that might be related to this The Object of the connection attempt failed to respond
problem. within the the allotted wait time. In the case of the B/A
• Verify that network connectivity exists between the client, this message is preceded in dsmerror.log by
IBM Spectrum Protect client machine and the IBM message ANS5216E that gives details of the
Spectrum Protect server machine. connection that failed. The condition may be
temporary.
• Contact your IBM Spectrum Protect administrator for
further assistance. The IBM Spectrum Protect
administrator can review the IBM Spectrum Protect System action
server activity log for additional information about processing stops.
the problem.
ANS1030E The operating system refused a User response
request for memory allocation. • Restart the IBM Spectrum Protect client and retry
the operation.
Explanation
• Check the client options file and verify that
Access to memory is required in order to store TCPSERVERADDRESS and TCPPORT specify the
information as processing proceeds. In this case, more correct TCP/IP address and port number for your
memory was requested than the operating system IBM Spectrum Protect server.
would allocate. Possible reasons include: • Verify that network connectivity exists between the
The system is low on memory. IBM Spectrum Protect client machine and the IBM
The process in which the program runs has Spectrum Protect server machine.
exceeded the maximum memory that it is allowed • If the problem persists, see your IBM Spectrum
to allocate. Protect administrator for further assistance.
Some other error condition occurred that caused
ANS1032E An attempt to establish a TCP/IP
the program to think it is out of memory.
connection was rejected by the
host
System action
Requested operation cannot be completed. Explanation
An attempt to establish a TCP/IP connection was
rejected by the server.

Chapter 2. ANS 0000-9999 messages 39

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

The server was not fully initialized, is not currently ANS1035S Options file 'file-name' could not
running, was not enabled for TCP/IP communications, be found, or it cannot be read.
or an incorrect TCP/IP port number was specified. If
the problem continues, see your system administrator. Explanation
ANS1033E An invalid TCP/IP address was Common reasons for this error include:
specified.
• The default options file does not exist.
• You specified the -OPTFILE option when starting the
Explanation
IBM Spectrum Protect client, but the options file you
The TCP/IP address specified by the IBM Spectrum provided does not exist.
Protect client's TCPSERVERADDRESS setting could not • The DSM_CONFIG (or DSMI_CONFIG if you are using
be found on the network. Common reasons for this the IBM Spectrum Protect API) environment variable
error include: specifies an options file that does not exist.
• The TCPSERVERADDRESS client option specifies the • You specified the -OPTFILE option when starting the
wrong TCP/IP address for the IBM Spectrum Protect IBM Spectrum Protect client, but the options file that
server". you provided is not in the standard file encoding of
• The machine that hosts the IBM Spectrum Protect the system. For example, on Windows the expected
server is not on the network. file encoding is ANSI.
• A network problem is preventing the IBM Spectrum • You specified the -OPTFILE option when starting the
Protect client from reaching the machine that hosts IBM Spectrum Protect client, but the options file that
the IBM Spectrum Protect server. you provided does not have appropriate read
permissions for the user that is running the
System action operation.

processing stops. System action

User response IBM Spectrum Protect client processing stops.

Verify that the TCPSERVERADDRESS and TCPPORT User response

settings have the correct values for your IBM
Spectrum Protect server. Use your operating system's Make sure that the options file you want to use exists,
"ping" (or similar) utility to ensure that your machine it has the read rights set for the user that is running the
can locate the machine that hosts the IBM Spectrum operation, and it is in the standard file encoding of the
Protect server across the network. Try the operating system. For example, on Windows the expected file
again. If the problem persists, ask your IBM Spectrum encoding is ANSI. Review the configuration
Protect administrator for further assistance. information in the IBM Spectrum Protect client manual
specific to your operating system. If the problem
ANS1034E The specified TCP/IP host name is persists, ask your IBM Spectrum Protect administrator
unreachable for further assistance.

Explanation ANS1036S The option 'option' or the value

supplied for it is not valid. It was
The TCP/IP host name specified in the found in options file 'file-name'
TCPSERVERADDRESS statement cannot be reached. at line number: number
The complete entry: 'entry'
System action
Processing stopped. Explanation
The specified option or option value is not valid. For
options that include a date or time specification, the
format of the date or time might not match the formats
specified by the DATEFORMAT or TIMEFORMAT options.

40 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stops. Verify that the include or exclude pattern is specified
correctly. If the pattern is correct, then contact IBM
User response technical support for further assistance.

Correct the option name or value. For options that ANS1040S Include/Exclude pattern is
specify dates or times, ensure that the specified date missing a closing bracket
or time matches the DATEFORMAT and TIMEFORMAT
settings. If -DATEFORMAT or -TIMEFORMAT are Explanation
specified on the command line, they must precede the
The include or exclude pattern is incorrectly
option that specifies the date or time. For example,
constructed. The closing bracket is missing.
use -DATEFORMAT=3 -FROMDATE=yyyy-mm-dd,
instead of -FROMDATE=yyyy-mm-dd -
DATEFORMAT=3. System action

ANS1037S Invalid keyword specified Processing stopped.

Explanation User response

An incorrect keyword was found in the options file. Correct the syntax for the pattern.
ANS1041S Include/Exclude pattern must
System action start with a directory delimiter
Processing stopped.
Explanation
User response The include or exclude pattern must start with a
Correct the options file with valid entries. directory delimiter.

ANS1038S Invalid option specified. System action

Processing stopped.
Explanation
An incorrect option was specified to IBM Spectrum User response
Protect.
Correct the syntax for the pattern.
System action ANS1042S A beginning or ending directory
Processing stopped. delimiter is missing from the
Include/Exclude pattern.
User response
Explanation
Correct the options used for running IBM Spectrum
1. The include/exclude pattern has a '...' without a
Protect.
beginning or ending directory delimiter.
ANS1039S The include or exclude pattern 2. For Windows, the drive seperator is not
cannot be parsed. immediately followed by a directory delimiter.

Explanation System action

The pattern is formatted incorrectly or is too complex Processing stopped.
to be interpreted.
User response
System action
Correct the syntax for the pattern.
Processing stopped.
ANS1043S Quotes are not matched

Chapter 2. ANS 0000-9999 messages 41

Explanation Explanation
The quotes specified in the pattern are not the same The selected path is not a local device and therefore is
and do not make a set. not a valid object for image operations.

System action System action

Processing stopped. The requested logical volume operation is not
performed.
User response
User response
Correct the pattern by using matching quotes in the
syntax. Choose another object.
ANS1044W Image backup of disk 'option- ANS1049E 'filename' is not a valid destination
name' with disk sector size 'block- file for image restore
size' is not supported.
Image backup supports only disks Explanation
with 512 bytes sector.
The filename you specified is not a valid name for a file
or it is a directory.
Explanation
The image backup operation supports disks with System action
sector size 512 bytes. Other sector sizes are not
supported. Restore processing stopped.

System action User response

Use image backup only for disks with 512 bytes Specify a correct filename for image restore.
sector. ANS1050E Volume 'volume-name' could not
be locked for the VSS Instant
User response Restore.
None.
Explanation
ANS1047E The destination file system is
unavailable. The following object The volume cannot be locked because another
was skipped: application is accessing the file systems on the
File space:'filespace-name' volume.
Pathname:' path-name'
Filename:'file-name' System action
Processing stops.
Explanation
The client is trying to restore or retrieve the specified User response
object to a destination that is not valid, does not exist,
Stop or suspend the applications that have handles
or cannot be reached.
open on the volume. For a file system restore, close
applications that are accessing the file systems that
System action are used for the VSS Instant Restore.
The object is not restored or retrieved. Processing If you cannot close the applications that are accessing
continues with the next object. the file system, unmount the file system. After the
unmount process is complete, mount the file system
User response and perform the VSS Instant Restore.
Try the command again using a different destination. For more information, see the error log file
DSMERROR.LOG.
ANS1048E Device 'volname' is not local
ANS1051I Invalid user id or password

42 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation If the file space name represents a drive volume label,
it will be renamed to the corresponding UNC name and
You entered an invalid user id or password.
continues to back up the drive to this renamed file
space.
System action
IBM Spectrum Protect cannot connect to the server User response
without the correct credentials.
No further action is necessary. However, if the file
space is for Windows system state, then at some
User response future time when you have determined you no longer
Contact your system administrator for the correct need the older renamed system state file space, you
credentials. can ask your IBM Spectrum Protect administrator to
delete the older file space from IBM Spectrum Protect
ANS1052E Direct connection to the Storage storage.
Agent is not allowed.
ANS1054E Existing filespace filespace-name
cannot be renamed to new
Explanation
filespace filespace-name. IBM
You cannot connect directly to the Storage Agent. Spectrum Protect return code =
retcode.
System action
Explanation
Processing stopped.
The client was unable to migrate a file space name
User response from the volume label naming convention to the UNC
naming convention.
To perform Lanfree operations using the Storage
Agent, specify the ENABLELANFREE option in your
System action
options file, and restart the process.
Processing stopped.
ANS1053I Existing file space
file_space_name has been
renamed to file_space_name User response
Check the client error log and the IBM Spectrum
Explanation Protect server activity log for any other messages that
might help identify the problem. If the problem cannot
If the file space is for Windows system state, this be resolved, contact IBM technical support for
message is issued when the IBM Spectrum Protect additional assistance.
backup-archive client detects multiple system state
file spaces where the names differ only in case. The ANS1055I Trying to rename existing
existence of multiple system state file spaces can filespace filespace-name to new
occur if, at some earlier time, your IBM Spectrum filespace filespace-name,
Protect administrator renamed the system state file but drive letters do not match,
space to the same name but with a different case or old=drive-letter, new=drive-letter.
the computer's name was changed from all upper case Ignore the old filespace and
characters to lower case or mixed case characters. backup to the new filespace.
If the file space name represents a drive volume label,
then this file space was created by an older IBM Explanation
Spectrum Protect backup-archive client.
Trying to rename the existing filespace name using the
volume label to the UNC format naming convention but
System action
the drive letters do not match. Leave the existing
If the file space is for Windows system state, IBM filespace alone and create a new filespace.
Spectrum Protect will back up system state to the file
space containing the most recent backup. The older System action
file space is renamed as specified in this message.
Subsequent system state backups will continue to Processing continues.
back up system state to the same (most recently used)
file space.

Chapter 2. ANS 0000-9999 messages 43

User response User response
None. Try the command again using a different destination.
ANS1056E Share/network path share cannot ANS1059E Two inactive objects with the
be resolved. Path does not exist. same image name were selected.
Process terminates
Explanation
Explanation
For backup: Trying to backup share/network, which
either does not exist or does not have the correct You selected more than one inactive version of the
privilege to access the share. For restore : Trying to same image object (logical volume). The system has
restore to a share/network path that cannot be no way to decide which you want to restore.
resolved. The directory path does not exist.
System action
System action
The requested logical volume restore is not
Processing stopped. performed.

User response User response

Retry the command and specify a destination, or Retry the operation, selecting an active version or only
restore the directory tree first before trying to restore one inactive version of the volume you wish to restore.
the share point.
ANS1060E The specified path is not a
ANS1057I File space file_space_name cannot mounted filesystem
be renamed to new file space
file_space_name, Explanation
because the new file space
already exists. 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
Explanation
simply that the file system is not currently mounted.
The client was unable to migrate a file space name
from the volume label naming convention to the UNC System action
naming convention because the new file space already
exists on the IBM Spectrum Protect server. The requested logical volume operation is not
performed.
System action
User response
The operation proceeds using the new file space. The
old file space is ignored. Retry the operation, using name of a mounted file
system.
User response ANS1061E The specified device corresponds
No action is necessary, but if the data in the old file to a mounted file system; you
space is no longer needed, it can be deleted from the must specify the file system by
IBM Spectrum Protect server. name.

ANS1058E The restore destination cannot be Explanation

reached.
You entered a logical device name that is mapped to a
mounted file system. This volume must only be
Explanation
referenced by its file system name.
Either the destination file system is invalid or it cannot
be reached. System action
The requested logical volume operation is not
System action
performed.
Processing stopped.

44 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response cause of this message can not be determined or
resolved, contact IBM technical support for further
Try the operation again, using the file system name
assistance.
instead of the device name.
ANS1065E Library version of the image utility
ANS1062E Only a single image may be
does not match that of the IBM
selected when a destination is
Spectrum Protect API
entered.

Explanation
Explanation
The current system has a mix of installed components.
You selected more than one image object (logical
volume) to be restored. You also specified a
destination. The system cannot place more than one System action
image into a single destination volume. When more The requested logical volume operation is not
than one object is selected, each must be restored to performed.
its original location.
User response
System action
Re-install all IBM Spectrum Protect components
The requested logical volume restore is not
performed. ANS1066E The restore operation completed
successfully, but the file system
User response could not be remounted.

Retry the operation, selecting one object to be Explanation

restored to the given destination, or retry the
operation without entering the destination. None.

ANS1063E The specified path is not a valid

System action
file system or logical volume
name. The file system is left unmounted.

Explanation User response

None. Use the mount command to mount the file system. On
AIX, run fsck if requested by the operating system.
System action ANS1067E A call to a system function
The logical volume operation is not performed. returned an unexpected error.

User response Explanation

Try the operation again using a valid path. If you are performing a JFS2 snapshot based
operation, it is possible that the snapshot was not
ANS1064E An unexpected error occurred large enough to contain all the changes made to the
while processing the image filesystem after the snapshot was created. This could
operation. cause the snapshot to become invalid thereby
preventing IBM Spectrum Protect client from reading
Explanation the snapshot.
None.
System action
System action The requested operation does not run.
The requested operation does not run.
User response
User response Examine the client error log for additional messages
related to this error. Try the operation again. If the
Examine the client error log for any additional
problem persists, contact IBM technical support for
messages that may have been issued before or after
further assistance.
this message. Correct any problems, if possible. If the

Chapter 2. ANS 0000-9999 messages 45

If you are performing a JFS2 snapshot based User response
operation, please use the default snapshotcachesize
Re-try the operation, check error log for more
of 100% and ensure that the volume group has
information.
sufficient disk space to allocate snapshots at least as
large as the file system and retry the operation. ANS1071E Invalid domain name entered:
'domain-name'
ANS1068E The device is not local.

Explanation
Explanation
You entered an invalid domain name. Verify whether
The selected path is not a valid object for image
the domain name is a file system and the file system is
operations. The selected path is either a remote
mounted. A directory cannot be specified in the
device or a partition that resides on a multipath device.
domain option, unless it is a virtual mount point.

System action
System action
The requested logical volume operation is not
Processing continues if there are other file systems in
performed.
the domain option to back up.

User response
User response
Choose another object.
Enter a valid drive or file system name (domain).
ANS1069E An error occurred while reading
ANS1072E Unable to continue operation;
data from the device
Drive 'drive-name' has no volume
label.
Explanation
An error occurred while reading data from the device. Explanation
Windows Only: This could be due to bad sectors on the
The specified drive-name in the domain list does not
drive.
have a volume label.

System action
System action
The requested logical volume operation is not
Processing stopped.
performed.

User response
User response
Use the system format utility to place a unique volume
Retry the operation, then check the error log for more
label on all drives on which you intend to run IBM
information. Windows Only: Please run chkdsk /r and
Spectrum Protect.
retry the operation. If the problem persists, a possible
workaround is to back up the entire drive using a ANS1073E The file space for domain 'domain-
regular (non-image) backup. Please ensure that all name' could not be found on the
your data is backed up. Then format the drive using a IBM Spectrum Protect server.
full format (without the /q quick format option). Then
restore the data and retry the image backup operation. Explanation
ANS1070E Write error The specified file space was expected to be found on
the server, but it no longer exists. It is possible that a
Explanation command was issued to delete the file space from the
server while the current operation was in progress.
An error occurred while writing data to the device.

System action
System action
IBM Spectrum Protect processing stops.
The requested logical volume operation is not
performed.
User response
Try the operation again. If the problem recurs, check
the error log for any other messages that might

46 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
indicate a reason for the failure. Try to correct any Based on the resulting data, you can ask the UNIX
indicated problems, then try the operation again. If the system root user to increase the resource limit above
problem persists, contact IBM technical support for the current default limit. The UNIX system root user
further assistance. has the authority to increase resource limits.
ANS1074W The operation was stopped by the ANS1076E The specified directory path
user. 'pathname' could not be found.

Explanation Explanation
The operation was stopped at the request of the user. An invalid or unreachable directory path was specified.
This usually occurs when the 'Q' key is pressed two
times. System action
Processing stopped.
System action
Processing stopped. User response
Try the operation again using a valid directory path.
User response
ANS1078S Unknown system error error-code
None.
occurred.
ANS1075E file name(line number)The
operating system refused a IBM Explanation
Spectrum Protect request for
memory allocation. An unknown error error-code occurred within the client
program.
Explanation
System action
IBM Spectrum Protect requires access to memory in
order to store information as processing proceeds. In The client stops.
this case, more memory was requested than the
operating system would allocate. Possible reasons User response
include:
Check the error log for any other messages that might
The system is low on memory. indicate a reason for the failure. Try to correct any
The process in which the program runs has indicated problems, then try the operation again. If the
exceeded the maximum allocated memory. problem persists, contact IBM technical support for
Some other error condition occurred. No memory is further assistance.
available. ANS1079E No file specification entered

System action Explanation

IBM Spectrum Protect cannot complete the requested You did not enter a file specification as prompted.
operation.
System action
User response
The process did not continue with the requested
Close all unneeded applications and try the operation operation.
again. If the operation still fails, try dividing the task
into several smaller units. For example, if a file
User response
specification contains several high-level directories,
run the IBM Spectrum Protect task serially for each Enter a file specification to continue.
directory. If the IBM Spectrum Protect task is an
incremental backup, use the option "- ANS1081E Invalid search file specification
memoryefficientbackup=yes". 'string' entered.

For UNIX systems that support resource limits, you

Explanation
can check if the memory resource limit is too low by
entering the following command: ulimit -a You entered a file specification or search string that
contains incorrect characters or contains wildcard

Chapter 2. ANS 0000-9999 messages 47

characters in the drive specification or file system System action
name.
Processing stops.

System action
User response
Processing stopped.
Specify a valid drive or file space. Verify that backup
copies exist.
User response
ANS1085E The VMware vStorage API
Enter a correct file specification as described in the reported an invalid snapshot
appropriate Using the Backup-Archive Client book for configuration.
the particular operating system.
ANS1082E Invalid destination file Explanation
specification 'file-name' entered
A VMware vStorage API error occurred due to an
invalid snapshot configuration.
Explanation
You entered a destination file-name specification that System action
contains incorrect characters or has wildcard
A VMware vStorage API error occurred, and the virtual
characters in the specification.
machine backup failed.

System action
User response
Processing stopped.
Check the VMware logs for possible causes of the
error, and retry the operation.
User response
ANS1086E File not found during Backup,
Enter a correct file specification as described in the Archive or Migrate processing
appropriate Using the Backup-Archive Client book for
the particular operating system.
Explanation
ANS1083E No files have previously been
The file being processed for backup, archive or migrate
archived for 'filespace-name'
no longer exists on the client. Another process deleted
the file before it could be backed up, archived or
Explanation migrated by IBM Spectrum Protect.
You tried to retrieve files when no files for the
specified drive or file system (filespace-name) were System action
previously archived.
File skipped.

System action
User response
Processing stopped.
None.

User response ANS1087E Access to the specified file or

directory is denied
Ensure that the correct drive or file system was
specified and that files are archived for you to retrieve.
Explanation
ANS1084E No files have previously been
Access to the specified file or directory is denied. You
backed up for ' filespace-name' or
tried to read from or write to a file and you do not have
the specified file space is invalid
access permission for either the file or the directory.
for the current operating system.

System action
Explanation
Processing stopped.
You cannot restore files. Either the file space or drive
is invalid, or no backup copies exist.

48 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response LVM2. LVM2 is supported by this client for logical
volume operations.
Ensure that you specified the correct file or directory
name, correct the permissions, or specify a new ANS1091E Communications error with server
location. during object query
ANS1088E File space 'filespace-name' does
not exist Explanation
An unexpected communications error occurred during
Explanation an object query to the server.
The specified file space (domain) is incorrect or does
not exist on the machine. System action
Processing stopped.
System action
Processing stopped. User response
Verify that communications are active between the
User response client and server machines. Server outages, processor
outages, and communication controller outages can
Retry the operation specifying an existing domain
cause this error.
(drive letter or file system name).
ANS1092W No files matching search criteria
ANS1089E Destination directory path length
were found
exceeds system maximum

Explanation
Explanation
You entered a search pattern or file name that cannot
The path name specified plus the path name in the
be found in the server database.
restored file name combine to create a name whose
length exceeds the system maximum.
System action
System action Processing stopped.
Processing stopped.
User response
User response Ensure that your search pattern is correct, or specify a
new search string.
Specify a destination path that, when combined, is less
than the system maximum. ANS1093E Your IBM Spectrum Protect server
does not support point-in-time
ANS1090E The LVM1 device is no longer
processing.
supported by this client.

Explanation
Explanation
The client has requested a point-in-time query or
The selected path refers to a volume device managed
restore operation, but the IBM Spectrum Protect
by LVM version 1. LVM 1 is no longer supported by this
server to which the client is connected does not
version of client and therefore is not a valid object for
support point-in-time operations.
image operations.

System action
System action
Processing stopped.
The requested logical volume operation is not
performed.
User response
User response Make sure that you are connected to the correct IBM
Spectrum Protect server. If you are connected to the
Use earlier versions of the client that support LVM1 to
correct server, then try the command again without
perform the logical volume operation. Alternatively,
specifying any point-in-time options.
you can upgrade to LVM2 and migrate the volume to

Chapter 2. ANS 0000-9999 messages 49

ANS1094E An error occured trying to connect System action
to the restore location on the Processing stopped.
virtual machine. Verify that the
restore location exists on the
virtual machine and that your User response
account has access to it. If the DSM_DIR environment variable is set, verify that
it points to the directory containing the current level of
Explanation IBM Spectrum Protect program files, then try the
operation again. If the problem recurs, re-install the
During restore processing, the system creates a share client software. If the problem persists, IBM technical
to access the restore location on the virtual support for further assistance.
machine. In this situation, the system was unable to
create a share. This error typically occurs if the restore ANS1098E Process terminated; Program
location does not exist or the user account does not memory exhausted.
have access to the location.
Explanation
System action
The program used all available storage.
The system was unable to create a share.
System action
User response
Processing stopped.
Verify that the restore location exists on the virtual
machine and that your account has access to it. User response
ANS1096S Either the node does not exist on Free any unnecessary programs (TSRs) that are
the server or there is no active running, and retry the operation. Reducing the scope
policy set for the node. of queries and the amount of data returned can also
solve the problem.
Explanation
ANS1099E File 'filename' not previously
This error occurs when you try to access another archived
node's data. Either the node is not registered with the
IBM Spectrum Protect server, or there is no active Explanation
policy set for the node.
You tried to give access to a file, which is not stored on
the server.
System action
Processing stops. System action
Processing stopped.
User response
Verify that the node whose data you are trying to User response
access is registered with the IBM Spectrum Protect
server. If you have more than one IBM Spectrum Ensure that the correct filename is specified.
Protect server, make sure you are connecting to the ANS1100E File 'filename' not previously
correct server, then try the operation again. If the backed up
problem persists, contact your IBM Spectrum Protect
administrator for further assistance.
Explanation
ANS1097E The client help text cannot be read
You tried to give access to a file, which is not stored on
from the help file.
the server.

Explanation
System action
The help file was opened successfully and its table of
Processing stopped.
contents are available, but there is a problem reading
the text from the help file.
User response
Ensure that the correct filename is specified.

50 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1101E User is not authorized to encrypt ANS1103E Invalid management class entered
file-space
namedirectory_pathfile_name. Explanation
You entered an invalid management class.
Explanation
The user is not authorized to encrypt the file. System action
Normally, only a IBM Spectrum Protect authorized
user or a root user can use IBM Spectrum Protect Requested operation is not possible.
encryption. However, a certain combination of
PASSWORDACCESS and ENCRYPTKEY options may User response
allow encryption operations by a non-authorized user.
Retry the operation using a valid management class.

System action ANS1104E The management class for this file

does not have a valid archive copy
The file is not backed up or restored. group.
This file will not be archived.
User response
Log in as a root or IBM Spectrum Protect authorized Explanation
user and try the operation again. See IBM Spectrum The management class for this file does not have an
Protect Backup-Archive Client Installation and User's archive copy group specified. This file will not be
Guide for the correct usage of the ENCRYPTKEY archived.
option.
ANS1102E An excessive number of command System action
line arguments are passed to the
Processing stopped.
program.

User response
Explanation
Add a valid archive copy group to the management
This command processing routine received more
class, and then retry the operation.
operands than it can use. The rules are:
ANS1105E The management class for this file
• Query can contain only one file specification.
does not have a valid backup copy
• Restore and Retrieve can contain two file group.
specifications. This file will not be backed up.
• Archive, Incremental, and Selective can contain a
maximum of 20 file specifications. To bypass the 20- Explanation
operand limit, use the -REMOVEOPERANDLIMIT
option on the failing archive, incremental, or The management class for this file does not have a
selective command. backup copy group specified. This file will not be
backed up.
Note: The Client operates much more efficiently if it
expands wild cards internally, rather than accepting System action
the expanded list from the shell.
Processing stopped.
System action
User response
Processing stopped.
Add a valid backup copy group to the management
User response class, and then retry the operation.

Reduce the number of arguments and retry the ANS1106E ENCRYPTKEY SAVE not configured
operation. For UNIX-based systems, ensure that you correctly. Encryption not used.
have surrounded the specification containing pattern
matching characters with quotes. As an alternative, Explanation
use the -REMOVEOPERANDLIMIT option on the failing
This message is issued for IBM Spectrum Protect
archive, incremental, or selective command.
Authorized Users and root users when ENCRYPTKEY

Chapter 2. ANS 0000-9999 messages 51

SAVE and PASSWORDACCESS PROMPT options are Explanation
set. Please note that these are the default values.
This usually occurs when the help file file-name cannot
These values do not allow encryption.
be found.

System action
System action
The file is not encrypted.
Processing stopped.

User response
User response
To save encryption keys, you must change
If the DSM_DIR environment variable is set, verify that
configuration values. Add PASSWORDACCESS
it points to the directory containing the current level of
GENERATE to your system option file.
IBM Spectrum Protect program files, then try the
ANS1107E Invalid option/value: 'option' operation again. If the problem recurs, re-install the
client software. If the problem persists, IBM technical
Explanation support for further assistance.

You specified an incorrect IBM Spectrum Protect ANS1111E The requested operation is not
option or option value. possible using the management
class that was entered.
System action
Explanation
For the command line client: Processing stops.
The management class is not valid because the Data
For the native GUI client: There is a small set of Version Exists value is greater than 30. For local
options critical to the initialization of the client. If an backups on a VVOL datastore, this value must be 1 -
error is found in one of these, this message is 30.
presented and the client terminates without further
processing.
System action

User response Processing stopped.

Specify a correct IBM Spectrum Protect option as

User response
defined in the appropriate Using the Backup-Archive
Client book for the particular operating system. Retry the operation using a valid management class.
ANS1108E Invalid option (option) for the ANS1113E The snapshot cache location is not
function command. valid.

Explanation Explanation
There are two possible reasons for this message: The snapshot cache location must point to a local
volume that is formatted with NTFS. The default cache
• The option option was specified for a command or
location is on the same volume where the snapshot is
subcommand (function) that cannot make use of that
being performed. The operation will continue without
option.
snapshot support.
• The option appears on the initial command line and
is not valid there. System action

System action The client does not execute the snapshot backup
operation.
Processing stopped.
User response
User response
Specify a different snapshot cache location using the
See the Backup-Archive Client Installation and User's SNAPSHOTCACHELOCATION option.
Guide for correct use of the named option.
ANS1114I Waiting for mount of offline media.
ANS1110E The client help file file-name could
not be opened.

52 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The server is waiting for the requested media to Processing stopped.
become available before the operation can continue.
User response
System action
Try again using either the PICK or the LATEST option.
Waiting for requested data.
ANS1118I Invalid file space number entered.
Try again.
User response
None. Explanation
ANS1115W File 'file-namefile-namefile-name' The number that represents a file space was incorrect
excluded by Include/Exclude list while you were using the PICK option.

Explanation System action

You can not back up, archive, or migrate files that are The process waits for your specification.
excluded.
User response
System action
Enter a correct file space number.
The file can not be processed.
ANS1119I Initiating the removal of 'filespace-
name' file space.
User response
If the file is intentionally excluded, then this message Explanation
can be ignored. Otherwise modify the include/exclude
list, restart the client, and try the operation again. Indicates that file space deletion has started on the
Contact your IBM Spectrum Protect administrator for specified filespace-name.
further assistance.
System action
ANS1116E The process is running in a non-
interactive mode, but requires None.
user input.
User response
Explanation None.
This process requires keyboard input, but non- ANS1120E Removal of file space 'filespace-
interactive processes are unable to read input from name' failed
keyboard.
Explanation
System action
An attempt was made to delete a filespace (either NAS
processing stops. or normal) and it was unsuccessful.
• Your client registration may not be authorized to
User response
delete filspaces on the server. Look for message
Perform the following actions to resolve this error: ANS1126E.
• Run the product in interactive mode. • The named filespace does not exist on the server.
Look for message ANS1122W.
• Ensure your password is set correctly.
• Other causes which will be made known in messages
ANS1117E The PICK and LATEST options are following this one
not valid together
System action
Explanation
processing stops.
During a restore, PICK and LATEST options cannot be
used together.

Chapter 2. ANS 0000-9999 messages 53

User response Explanation
Take action as recommended by other messages that Execution of the HELP command requires space for
accompanies this one. If so indicated, try to remove both the user prompts and at least one line of the
the file space again. If the problem continues, your HELP directory.
IBM Spectrum Protect administrator has the authority
to delete the file space for you. System action
ANS1121I A request for removal of file space The help directory is not displayed, and the help
'filespace-name' has been command cannot complete.
successfully sent to the server.
User response
Explanation
Increase the size of your display window to allow more
IBM Spectrum Protect has requested deletion of the rows of text to be displayed.
specified filespace-name. The deletion process may
not have actually been completed when this message ANS1125E Unmatched Quotes: 'string'
is displayed. To verify successful deletion, consult the
server logs. Explanation
It is possible for errors to occur on the server during The quotes specified in the pattern are not the same
the deletion process, or the file space might contain and do not make a set.
archive objects in deletion-hold status. In either case,
the file space will not be deleted. System action
Processing stopped.
System action
None. User response
Correct the pattern using matching quotes in the
User response
syntax.
None.
ANS1126E The file space cannot be deleted
ANS1122W File space 'filespace-name' does because this node does not have
not exist on the server. The file permission to delete archived or
space might backed up data.
have been deleted by another
client using your client's node Explanation
name or
an administrator. You cannot delete the file space data unless your IBM
Spectrum Protect administrator has authorized your
node to do so. Authorization permits you to delete
Explanation
backup data, archive data, or both.
The specified filespace-name does not exist on the
server. Your system administrator deleted the file System action
space or another client using your client's node name
might have deleted it. Delete processing fails.

System action User response

None. Use the DSMC QUERY SESSION command to verify

your authorization. Ask your IBM Spectrum Protect
administrator to provide the necessary authorization
User response
or to delete the file space for you.
None.
ANS1127E Your node does not have
ANS1123E The vertical screen dimension is permission to delete archived
too small to display the files.
Help directory. Increase your
window height.

54 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation DETAIL to view information about available
management classes. Make sure the management
You cannot delete archived files unless your IBM
class you select has a backup copy group. If you have
Spectrum Protect administrator has authorized your
more than one IBM Spectrum Protect server, make
node to do so.
sure you are connecting to the correct server. If you
are unable to find a suitable management class,
System action contact your IBM Spectrum Protect administrator for
IBM Spectrum Protect does not delete the archived further assistance.
files. ANS1130E The drive has no label. The
operation cannot continue.
User response
Use the DSMC QUERY SESSION command to verify Explanation
your authorization. Ask your IBM Spectrum Protect Backup or archive of removable media requires that
administrator to provide the necessary authorization. the media have a volume label. An attempt was made
ANS1128S The management class assigned to to back up or archive data on a removable volume that
directories does not exist. has no label.

Explanation System action

The management class named on the DIRMC option The requested operation does not run.
does not exist in your assigned policy set on the
server. The error log contains an entry showing the User response
invalid management class name.
Create a volume label on the removable media, then
try the operation again.
System action
ANS1131E A duplicate volume label exists.
processing stops. The operation cannot continue.

User response Explanation

Remove the current DIRMC option from the client For removable media, IBM Spectrum Protect uses the
options file, then run DSMC QUERY MGMTCLASS - volume label as the file space name. To prevent data
DETAIL to view information about available from different volumes being stored in the same file
management classes. Make sure the management space on the IBM Spectrum Protect server, backup or
class you select has a backup copy group. If you have archive of removable media volumes having duplicate
more than one IBM Spectrum Protect server, make volume labels is not allowed.
sure you are connecting to the correct server. If you
are unable to find a suitable management class,
contact your IBM Spectrum Protect administrator for System action
further assistance. The requested operation does not run.
ANS1129S There is no backup copy group in
the management class used for User response
directories. Change the volume labels on the removable media
volumes so that there are no duplicate labels. Then
Explanation restart IBM Spectrum Protect and try the operation
again.
The DIRMC option names a management class that
contains no backup copy group. ANS1132E 'Access rule' Access Rule already
defined for node 'node'.
System action Old rule must be deleted before
new one can be defined.
processing stops.
Explanation
User response
You are trying to define authorization for the specified
Remove the current DIRMC option from the client node, which already has authorization defined.
options file, then run DSMC QUERY MGMTCLASS -

Chapter 2. ANS 0000-9999 messages 55

System action System action
IBM Spectrum Protect did not redefine authorization The SUBST drive is skipped. Processing continues with
for the specified node. the next drive.

User response User response

Update the authorization, or delete the old rule and Do not specify any file specifications for a drive that is
define a new one, or use the current authorization. a substitute of another drive. Remove any explicit
substitute drives from the DOMAIN statement or use
ANS1133W An expression might contain a the -<drive:> notation to remove a substitute drive if
wildcard not enclosed in quotes. ALL-LOCAL is specified.

Explanation ANS1136E Not file owner

The command cannot be processed because a UNIX

Explanation
shell expands a wildcard expression, such as an
asterisk (*) or a question mark (?), that has no quotes. The file cannot be backed up because the client is not
the file owner.
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 System action
command, add the -REMOVEOPERANDLIMIT option to The file is skipped.
the command, and try it again.
User response
System action
None.
Command dependent.
ANS1137W Invalid Index 'number' skipped.
User response
Explanation
Enclose the wildcard expression in quotes, or add the -
REMOVEOPERANDLIMIT option and enter the An incorrect number was entered for the Index.
command again.
System action
ANS1134E Drive drive-name is an invalid
drive specification Processing stopped.

Explanation User response

The specified drive name is not valid; the drive Correct the Index entry and retry the operation.
probably has not been defined.
ANS1138E The 'command-name' command
must be followed by a
System action subcommand
Process skips the invalid drive and continues to the
next drive. Explanation
You entered an incomplete command-name.
User response
Check the invalid drive. System action
ANS1135E Drive drive-name1 is a virtual drive Processing stopped.
of drive-name2. It cannot be
backed up or archived. User response
Enter the correct syntax of the command and
Explanation
continue.
One drive is a substitute (SUBST) of the other drive.
ANS1139W 'object-nameobject-nameobject-
The SUBST drive cannot be backed up or archived.
name' was restored as 'temp-

56 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 name'. A reboot is required to ANS1143E The DIRSONLY and FILESONLY
complete the restore. options are not valid together

Explanation Explanation
The file being restored was in use by another The DIRSONLY and FILESONLY options cannot be
application, so it could not be immediately replaced. used together.
The file will be replaced during the next reboot of the
operating system. It is important to note that until the System action
reboot occurs, the system or its applications might be
unstable. The degree of instability depends on the Processing stopped.
criticality of the file to the operating system or
applications. User response
Try again using either the DIRSONLY or the
System action FILESONLY option.
The file was restored with a temporary name, and ANS1144W Password authentication not
instructed the operating system to replace the original active on server
file with the restored file during the next boot of the
operating system.
Explanation
User response None.
Reboot the machine as soon as possible after the
restore operation ends. System action
Processing stopped.
ANS1140E Invalid format for Set Access
command.
User response
Explanation Because password authentication is turned off on the
server, you do not need to update the password.
The SET ACCESS command must have at least three
operands, the first of which must be either BACKUP or ANS1145E The maximum macro nesting level
ARCHIVE. A validly formed file specification must has been exceeded. Macros may
follow. be nested up to 10 levels.

System action Explanation

Processing stopped, the command is not executed. IBM Spectrum Protect allows macros to invoke other
macros, for example, macro 'A' invokes macro 'B'
User response which, in turn, invokes macro 'C'. This is nesting to 3
levels. The limit is 10 levels (the inital macro plus nine
Use the HELP SET ACCESS command for complete levels of calls within macros currently executng).
details of usage, then enter the SET ACCESS command There is no limit to the number of different macro calls
using the correct syntax. that may be made within a macro as long as the calls
ANS1141W Unknown command - command- are not nested.
name
System action
Explanation The macro is ignored and an error is returned.
You entered an incorrect command-name.
User response
System action Reduce the level of macro nesting.
None. ANS1146E Macro file 'file spec' cannot be
opened.
User response
Enter the correct command.

Chapter 2. ANS 0000-9999 messages 57

Explanation • DOMAIN ALL-LOCAL is in effect but the system has
no local file systems.
A macro command has been entered that specifies the
macro file name shown. However, that file cannot be
opened for reading. System action
processing stops.
System action
The macro is ignored and an error is returned. User response
Verify that the DOMAIN statements are properly
User response configured and try the backup again. DOMAIN
statements can be in client option files (dsm.opt,
Enter the command with the proper macro name.
dsm.sys), client option sets, schedule definitions, and
ANS1147E File is temporarily unavailable. scripted IBM Spectrum Protect commands. Corrective
actions include:
Explanation • Make sure the DOMAIN option settings specify the
File is temporarily unavailable. file systems you want to back up.
• If a file system that should be backed up is excluded
System action by an EXCLUDE.FS statement, remove the
EXCLUDE.FS statement.
File skipped.
• If a file system that should not be backed up is listed
in a DOMAIN statement, remove the file system from
User response the DOMAIN statement.
Check and see if file is locked by other process. If not, • Make sure the DOMAIN is not empty. That is, if any
retry the command. DOMAIN statements exclude file systems from
backup, make sure the DOMAIN statements include
ANS1148I 'Command-name' command
the file systems that should be backed up.
successfully completed
ANS1150E Unable to restore current user
Explanation profile because you are running as
a local system account.
The specified command-name was successfully
completed.
Explanation
System action The local system account does not have a profile.
Therefore you cannot restore its profile.
Command completed.

System action
User response
Processing stops.
Continue with normal operations.
ANS1149E No domain is available for User response
incremental backup. The domain
Log on to the user whose profile you want to restore.
may be empty or all file systems in
the domain are excluded. ANS1151E 'drive-name1' is not a cluster disk.

Explanation Explanation
An incremental backup was started, but no domain The indicated file system is not a cluster disk. Because
was selected. Possible reasons for this message the CLUSTERNODE option is set to YES, the file system
include: cannot be backed up or archived.
• An attempt was made to back up a file system that is
excluded with the EXCLUDE.FS option. System action
• The DOMAIN is empty. That is, a DOMAIN statement Processing stops.
excludes one or more file systems, but no DOMAIN
statements include any file systems.

58 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response name has been corrupted or is coded in a language
other than that of the current locale.
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 System action
information about configuring the client to run in a Object skipped.
cluster environment.
ANS1152E The VMware vStorage API User response
reported a failure to quiesce the If the file name and path are not corrupted, process
virtual machine. the file in the locale for which it is valid.

Explanation ANS1155E No domain is available for image

backup.
A VDDK error occurred while quiescing the virtual
machine.
Explanation

System action An image backup was started, but no domain was

specified.
A VMware vStorage API error occurred, and the virtual
machine backup failed.
System action

User response Processing stopped.

This error can occur if there is a lot of activity on the

User response
virtual machine at the time the snapshot is occurring.
Try setting the INCLUDE.VMSNAPSHOTATTEMPTS Choose a domain and restart the image backup. Set
option to resolve this issue. Also, check the VMware the image domain using the domain.image option in
logs for possible causes of the error, and try the your dsm.opt file, either manually, or by using the GUI
operation again. preferences editor.
ANS1153E 'drive-name1' is a cluster disk. ANS1156E NODENAME cannot be the local
machine name when
Explanation CLUSTERNODE is set to YES

The indicated file system is a cluster disk. Because the

Explanation
CLUSTERNODE option is set to NO, the file system
cannot be backed up or archived. When IBM Spectrum Protect is running as a cluster
node, the node name cannot be the local machine
System action name.

Processing stops.
System action

User response Processing stops.

If the CLUSTERNODE option is incorrectly set to NO,

User response
then change the option to YES and try the operation
again. Otherwise see the client manual for further Change the node name either to the cluster name or to
information about configuring the client to run in a any other name, and restart IBM Spectrum Protect.
cluster environment.
ANS1157E The registry cannot be backed up
ANS1154E Object name 'filespace namepath- or restored when the client is
namefile-name' contains an invalid running as a cluster node.
multibyte sequence for the current
locale. Explanation
When the CLUSTERNODE option is set to YES, the
Explanation
registry cannot be backed up or restored.
An illegal multibyte sequence for the current locale
was found in the object name. Either the path or file

Chapter 2. ANS 0000-9999 messages 59

System action User response
The registry is not backed up or restored. Use the mount command to mount the file system. On
AIX, run fsck if requested by the operating system.
User response ANS1163E Filesystem could not be
If the CLUSTERNODE option is incorrectly set to YES, unmounted.
then change the option to NO and try the operation
again. Otherwise see the client manual for further Explanation
information about configuring the client to run in a
The system call to unmount the file system failed.
cluster environment.
ANS1158E The event logs cannot be backed System action
up or restored when the client is
running as a cluster node. The logical volume operation is not performed.

Explanation User response

When the CLUSTERNODE option is set to YES, the Make sure the device or file system is not being
event logs cannot be backed up or restored. accessed, then retry the operation.
ANS1164E Filesystem is not mounted
System action
The event logs are not backed up or restored. Explanation
The named file system is not currently mounted. It
User response must be mounted for IBM Spectrum Protect to
If the CLUSTERNODE option is incorrectly set to YES, perform an image backup.
then change the option to NO and try the operation
again. Otherwise see the client manual for further System action
information about configuring the client to run in a The logical volume operation is not performed.
cluster environment.
ANS1159E The specified file is being used by User response
another process
Mount the file system.

Explanation ANS1165E Destination is smaller than source

The specified file is being used by another process.
Explanation
You tried to read from or write to a file that is currently
being used by another process. The space allocation for the selected destination is
smaller than the source.
System action
System action
Processing stopped.
The restore operation is not performed.
User response
User response
Ensure that you specified the correct file or directory
name, correct the permissions, or specify a new Choose a different, bigger destination or increase the
location. size of the destination file space.
ANS1162E Filesystem could not be mounted ANS1166E Source and destination are not the
same file system type.
Explanation
Explanation
The system call to mount the file system failed.
The source and destination file system types do not
System action match.

The file system remains unmounted.

60 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The requested logical volume operation is not Enter a number from the list or 'Q' to quit.
performed.
ANS1177E Must specify a path for this
operation.
User response
Choose a destination that has the same file system Explanation
type as the source.
A path must be specified for this operation to execute
ANS1168E ERROR: could not create image successfully.
object.
System action
Explanation
Processing stops.
Creation of the image object failed for one of the
following reasons: User response
• The image command was executed by a non-root Specify a valid path and execute the command again.
user
ANS1181E There was a communication
• The image plugin library was not found.
failure with the journal service.

System action
Explanation
The requested logical volume function is not
An error occurred using named pipe communication
performed.
with the journal service.

User response
System action
Retry the operation after correcting the cause for
Processing stops.
failure.
ANS1169W There is no table of contents for User response
image-name.
Restart the journal service, then try the operation
again. If the problem persists, contact IBM technical
Explanation support for further assistance.
The image item for which a table of contents was
ANS1183E An unknown error occurred while
requested is either a RAW logical volume or it was
processing system object 'sys-obj-
backed up without the -TOC option.
name':
MS API function 'func-name' failed
System action with error error (error)
No table of contents is displayed.
Explanation
User response An unknown error occurred while processing a system
Select another image object for TOC display. object. The error information captured indicates the
reason for the failure. This information can be used to
ANS1170I Invalid selection number entered. diagnose the problem.
Try again.
System action
Explanation
IBM Spectrum Protect ended the current operation.
A number not shown in the list of images was selected.
It is either less than one or greater than the highest User response
item number displayed.
Contact your system administrator for more
System action information.

Client prompts for you to enter a valid selection.

Chapter 2. ANS 0000-9999 messages 61

ANS1184W The command subcommand User response
command is not supported on this During installation a proper help file was created. Your
client. system administrator can assist you with retrieving the
original help file to replace the named invalid file.
Explanation
ANS1187E The named helpfile "filename" has
The command subcommand command is not invalid content.
supported for the client running on this operating
system on this computer.
Explanation

System action Reinstall the product to correct the help file.

The command is not processed.

System action

User response The help command is terminated.

None.
User response
ANS1185E The help search argument you During installation a proper help file was created. Your
supplied "string" is either too long system administrator can assist you with retrieving the
or contains unmatched quotes. original help file to replace the named invalid file.

Explanation ANS1188E The selected filesystem is

managed by HSM, and therefore is
Valid arguments are the names of things like section not a valid object for image
numbers, command names, option names and operations
message numbers. All of these search arguments are
short and none requires quoting.
Explanation

System action Due to the nature of HSM, image backup is not allowed
on managed filesystems.
The help request is not executed and you are given
another chance to enter a valid argument, display the
System action
table of contents, or exit help.
The requested logical volume operation is not
User response performed.

Respond to the subsequent prompt as directed.

User response
ANS1186I The named file does not have the None.
content to support the help
section. Requests for message ANS1189E The DIRSONLY and V2ARCHIVE
help will all result in topic not options are not valid together
found.
Enter a section number, option Explanation
name, command name,
or a command and subcommand. The DIRSONLY and V2ARCHIVE options cannot be
Otherwise press enter or 't' to used together.
display
the table of contents or 'q' to exit System action
help:
Processing stopped.

Explanation
User response
Reinstall the product to correct the help file.
Try again using either the DIRSONLY or the
V2ARCHIVE option.
System action
ANS1190E Symbolic link 'linkname' to 'target'
The help command pauses and allows you to make was successfully deleted.
another selection.

62 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
Log 'linkname' cannot be a symbolic link. Use the TRACEFILE option to specify the actual trace
file location without the use of symbolic links.
System action ANS1194E The VMware vStorage API
The symbolic link 'linkname' is deleted, the log is reported another task was in
recreated, and processing stops. progress for the virtual machine.

User response Explanation

Check the location of the new file. To specify the A VMware vStorage API error occurred due to another
location of log files, refer to the user's manual for the task in progress for the virtual machine.
'errorlogname' option, the 'schedlogname' option, and
the 'DSM_LOG' environmental variable. System action
ANS1191E Unable to delete symbolic link A VMware vStorage API error occurred, and the virtual
'link'. machine backup failed.

Explanation User response

Log 'linkname' cannot be a symbolic link. Wait for the other task to complete and try the
operation again.
System action ANS1197E A VMware Virtual Disk Kit (VDDK)
Processing stops. API read failure occurred while
reading data for backup.
User response
Explanation
Delete the symbolic link 'linkname'.
There was a VMware Virtual Disk Kit (VDDK) API read
ANS1192E Specifying the error log 'link' as a error while reading data to backup.
symbolic link is not allowed.
System action
Explanation
A VMware Virtual Disk Kit (VDDK) API read error
Error log 'linkname' cannot be a symbolic link. occurred, and the virtual machine backup failed.

System action User response

The symbolic link 'linkname' is deleted, the error log is Check the VMware logs for possible causes of the read
recreated, and processing stops. error, and try the operation again.
ANS1198E The VMware Virtual Disk Kit
User response
(VDDK) API reported an out-of-
Check the location of the new error log. To specify the memory condition while reading
location of the error logs, refer to the user's manual for data for backup.
the 'errorlogname' option and 'DSM_LOG'
environmental variable. Explanation
ANS1193E Specifying the trace file 'link' as a A VMware Virtual Disk Kit (VDDK) API read error
symbolic link is not allowed. occurred due to out-of-memory condition while
reading data to backup.
Explanation
For reasons of security and system integrity, the trace System action
file 'linkname' cannot be a symbolic link. A VMware Virtual Disk Kit (VDDK) API read error
occurred. The virtual machine backup failed.
System action
The symbolic link 'linkname' is deleted, the trace file is
recreated, and processing stops.

Chapter 2. ANS 0000-9999 messages 63

User response for this command, then consider wrapping the
command in a script that always exits with a return
Check the VMware logs for possible causes of the read
code of zero.
error, and try the operation again.
ANS1201E IBM Spectrum Protect cannot
ANS1199E The PRESNAPSHOTCMD command
build a directory path because a
failed. The image snapshot backup
file exists with the same name as
will not be executed.
the directory.

Explanation
Explanation
The command specified by the PRESNAPSHOTCMD
None
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 System action
considered to have completed successfully. If the Processing stopped.
command completed with any other return code, it is
considered to have failed. If the command failed then
User response
the image snapshot backup is not executed.
Remove or rename the file that has the same name as
System action the directory. Alternatively, you can restore the
directory to a different location.
The client does not execute the image snapshot
backup operation. ANS1202E TOC backup for the image failed.
Check log files.
User response
Explanation
Identify and repair the problem that caused the
command to fail. If a non-zero return code is normal An error occurred during backup of the table of
for this command, then consider wrapping the contents. Check the error log for more information.
command in a script that always exits with a return
code of zero. System action
ANS1200W The POSTSNAPSHOTCMD The requested logical volume operation is not
command completed with a non- performed.
zero return code.
User response
Explanation
Check error log.
If the command specified by the POSTSNAPSHOTCMD
ANS1203E Table of Contents not available for
option completed with a non-zero return code, then
the image snapshot backup operation will continue, selected backup set. Please
but with a warning-level result. Note that the result of contact server administrator.
the POSTSNAPSHOTCMD command will not supercede
a higher result from the image snapshot backup Explanation
command. For example, if the image snapshot backup There is no TOC for selected backup set
command completed with a return code of 12, the
image snapshot backup will be considered to have
System action
completed with a return code of 12, regardless of the
outcome of the POSTSNAPSHOTCMD command. Expansion of selected backup set will not be possible.
Will only be able to restore the whole backup set.
System action
User response
The image snapshot backup continues, but with a
warning return code of at least 8. Please contact server administrator to regenerate TOC
for backup set before backup set can be expanded.
User response ANS1204E This client is not supported by the
Identify and repair the problem that caused the IBM Spectrum Protect express
command to fail. If a non-zero return code is normal server

64 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
This client is not supported by the IBM Spectrum Query stopped.
Protect express server. This can occur if:
1. the client is configured as an IBM Spectrum Protect User response
express client using the CLIENTVIEW option Backup the file system again with -TOC option.
2. the client is trying to connect to an IBM Spectrum
ANS1209E The option_name option is not
Protect express server.
supported with the
command_name command using
System action the -FILELIST option.
Processing stops.
Explanation
User response The specified option is not supported with the
Log in using a supported IBM Spectrum Protect specified command when the -FILELIST option is also
express client. specified.

ANS1205E This is not a supported IBM System action

Spectrum Protect express
platform The command is not processed.

Explanation User response

This is not a supported IBM Spectrum Protect express >Do not specify the offending option when the -
platform. FILELIST option is specified with this command.
ANS1212I Invalid Process number entered.
System action Try again.
Processing stops.
Explanation
User response A number not shown in the list of processes was
Log in using a supported IBM Spectrum Protect selected. It is either less than one or greater than the
express client. highest item number displayed.

ANS1206E TOC backup of a raw device is not System action

supported. But the raw device is
backed up. Client prompts for a valid selection.

Explanation User response

TOC backup of a raw device is not supported. But the Enter a number from the list or 'Q' to quit.
raw device is backed up.
ANS1213W Snapshot image backup is not
possible for device device-name.
System action starting static image backup.
Raw device is backed up with no TOC object.
Explanation
User response On Linux platforms, snapshot image backup is only
NONE. possible for logical volumes created by the Linux
logical volume manager (LVM). Since the default image
ANS1207E No TOC has been previously backup type is snapshot, backing up a partition which
backed up for this file system. is not created using LVM automatically leads to a static
image backup.
Explanation
The user is trying to query the TOC of a file system. System action
TOC backup for that file system has not been Snapshot image backup will failover to static image
previously done. backup

Chapter 2. ANS 0000-9999 messages 65

User response currently not authorized to run IBM Spectrum Protect
to this server.
To avoid this message, use the imagetype option to
specify static or dynamic image backup.
System action
ANS1214E The logical volume group does not
have enough free space to contain IBM Spectrum Protect initialization fails and the
the volume snapshot. program ends.

Explanation User response

The snapshot is created in the volume group that See the IBM Spectrum Protect administrator for your
contains the logical volume being backed up. There is system, and ask to be added to the user or group list
insufficient free space in the volume group to contain for this server.
the snapshot. ANS1217E Server name not found in System
Options File
System action
The operation ends. Explanation
The system options file does not contain the
User response SERVERNAME option.
Decrease the SNAPSHOTCACHESIZE value or make
additional space available in the logical volume group. System action
Then try the operation again. IBM Spectrum Protect initialization fails and the
ANS1215E On volumes that are RAW or program ends.
formatted FAT32 the snapshot
cache location cannot be located User response
on the same volume that is being See the IBM Spectrum Protect administrator for your
backed up. system, and make sure that the system options file
contains the server name.
Explanation
ANS1218E TCPSERVERADDRESS not defined
When the snapshot cache location is located on the for this server in the System
same volume that is being backed up the volume must Options File
be formatted with NTFS. The default cache location is
on the same volume where the snapshot is being
Explanation
performed.
The TCPSERVERADDRESS for this server is not defined
System action in the server name stanza in the system options file.

The client does not execute the image snapshot

System action
backup operation.
IBM Spectrum Protect initialization fails and the
User response program ends.

Specify a different snapshot cache location using the

User response
SNAPSHOTCACHELOCATION option.
See the IBM Spectrum Protect administrator for your
ANS1216E Not authorized to run IBM system, and make sure that the server to which you
Spectrum Protect. See the are trying to connect, has a valid TCPSERVERADDRESS
administrator for your system. defined in the system options file.

Explanation ANS1219E A virtual node name must not

equal either a node name or the
The system options file for the server that you are system host name.
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

66 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
A VIRTUALNODENAME option was entered with a The disk space allocated for the client owner is full.
name the same as either a NODENAME option or the
system host name. System action
Processing stopped.
System action
Initialization fails and the program ends. User response
Free up disk space and retry the restore or retrieve
User response
operation.
If the virtual node name entered was the same as the
ANS1223E File is not compressed; System
host name, remove the virtual node name option. If it
failure.
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 Explanation
to your system. Virtual node name is used to access A file that was flagged as compressed was not
another system's server data. compressed, and the system failed.
ANS1220E The IBM Spectrum Protect server
is out of resources. System action
Processing stopped.
Explanation
A lack of a storage resource or a maximum value User response
condition does not allow any new activity.
See your system administrator to report this problem.
This error is a system failure.
System action
ANS1224E File compressed on a different
Current operation has been cancelled. client machine that has more
memory
User response
Try the operation again at a later time. If the problem Explanation
continues, contact your IBM Spectrum Protect You are trying to restore a file that was backed up and
administrator to isolate what resource is unavailable. compressed on another client workstation that had
The IBM Spectrum Protect administrator can check more memory than your client workstation. You
the IBM Spectrum Protect server activity log for cannot restore this file. When the file is restored, it is
messages that might explain the problem. expanded and your workstation does not have enough
ANS1221E Transaction aborted memory.

Explanation System action

The current transaction between the server and the Current operation has been cancelled.
client stopped. A server, client, or communication
failure cannot be recovered. User response
Obtain a machine with more memory and retry the
System action operation.
Current operation has been cancelled. ANS1225E Insufficient memory for file
compression/expansion
User response
Retry the operation. If the problem continues, see your Explanation
system administrator to isolate the problem. Not enough memory is available to do data
ANS1222E Disk space limit for this process compression or expansion. For a restore or retrieve,
reached the file cannot be recalled from the server until more
storage is made available. For a backup or archive, try

Chapter 2. ANS 0000-9999 messages 67

running without compression if storage cannot be System action
made available.
File skipped.

System action
User response
Processing stopped.
Check previous messages pertaining to this file that
indicate the reason for the failure. Where applicable,
User response correct the conditions that prevented the file from
Free up extra storage for the operation to continue, or being sent to the server. The specific corrective
run the backup or archive process without actions will depend on the reason for the failure.
compression enabled. ANS1229E MODE=INCREMENTAL is not valid
ANS1226E Destination file or directory is on file-space. Image backup not
write locked processed.

Explanation Explanation

The file or directory being restored or retrieved from Because the file space has been the subject of at least
the server cannot be written to because the one progressive incremental backup, the
destination is write locked. Another operation might MODE=INCREMENTAL option (incremental by image
have the file open and will not allow it to be updated. date) cannot be used with the backup image
command.
System action
System action
File skipped.
File system skipped.
User response
User response
Either determine which operation has the file write
locked, or restore the file to another name or location. If an image backup of the named file space is desired,
retry the command without the MODE=INCREMENTAL
ANS1227E Processing stopped; Disk full option. To prevent this behavior in the future, delete
condition the file space from the server and do only BACKUP
IMAGE -mode=selective and BACKUP IMAGE -
Explanation mode=incremental from that point on.
No more files can be restored or retrieved because the ANS1230E Stale NFS File Handle
destination disk is full.
Explanation
System action
An NFS file system becomes stale.
Processing stopped.
System action
User response
File system skipped.
Free up disk space, or restore or retrieve the file to
another disk. User response
ANS1228E Sending of object 'object- Check the NFS mounted filesystem.
nameobject-nameobject-name'
failed. ANS1231E No file handles available

Explanation Explanation

The specified file (object-name) cannot be sent to the All file handles for your system are currently in use. No
server. This message is accompanied by at least one more are available.
other message that has more specific information
about why the file could not be processed. System action
Processing stopped.

68 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Either free some file handles by ending other Verify that the communication processes are operating
processes, or modify your system setup to allow for properly, and then retry the operation.
more files to be open at the same time.
ANS1235E An unknown system error has
ANS1232E The file exists and cannot be occurred from which IBM
overwritten. Spectrum Protect cannot recover.

Explanation Explanation
The file being restored or retrieved exists and cannot An unknown error occurred. This might be a low-level
be overwritten due to lack of authority or access system or communication error from which IBM
permissions. Spectrum Protect cannot recover.

System action System action

The file is skipped. Processing stops.

User response User response

Verify that you have sufficient access permissions to Try the operation again. If the problem persists, review
overwrite the file, then try the operation again. If the the IBM Spectrum Protect error log for any related
problem persists, contact your system administrator messages. Obtain a service trace that captures the
or IBM Spectrum Protect administrator for further problem and contact IBM technical support for
assistance. additional assistance. Your IBM Spectrum Protect
administrator can help you configure the trace.
ANS1233E An invalid file handle was passed;
system error. ANS1236E An unexpected error occurred.

Explanation Explanation
An internal system error occurred: A file operation This is usually caused by a low-level system error or
failed because of an invalid file handle. communication error from which IBM Spectrum
Protect cannot recover.
System action
System action
processing stops.
Processing stopped.
User response
User response
Try the operation again. If the failure persists, obtain a
service trace that captures the problem and contact Examine the client error log for any additional
IBM technical support for additional assistance. Your messages that might be related to this problem. Try
IBM Spectrum Protect administrator can help you the operation again. If the problem persists, contact
configure the trace. IBM Spectrum Protect technical support for further
assistance.
ANS1234E Protocol violation
ANS1237E A problem has occurred on the
Explanation IBM Spectrum Protect server.

A communications protocol error occurred. The

Explanation
communication subsystem is not properly defined or is
itself in error. The client error log and the IBM Spectrum Protect
server activity log might contain additional information
System action about this error.

Processing Ends.
System action
Processing stops.

Chapter 2. ANS 0000-9999 messages 69

User response System action
Try the operation again. If the problem persists, File skipped.
examine the client error log and IBM Spectrum Protect
server activity log for additional information about this User response
error. If the problem cannot be resolved, then obtain a
SERVICE trace that captures the problem and contact Ensure that you do not have a looping symbolic link for
IBM technical support for additional assistance. Your the file.
IBM Spectrum Protect administrator can help you ANS1243E The file name is too long and can
configure the trace. not be processed by IBM Spectrum
ANS1238S A policy management problem has Protect
occurred on the IBM Spectrum
Protect server. Explanation
The size limit for file names may vary by operating
Explanation system. The most common limit is 256 characters. The
The client error log and IBM Spectrum Protect server file name being processed exceeds the limit supported
activity log may contain additional information about by IBM Spectrum Protect on this system.
this error.
System action
System action The file is skipped.
Processing is stops.
User response
User response Enter HELP FILE SPEC or see the client manual for the
Try the operation again. If the problem persists, operating system on which you are receiving this error.
examine the client error log and IBM Spectrum Protect The "File specification syntax" section of the manual
server activity log for additional information about this explains file name lengths supported by IBM Spectrum
error. If the problem cannot be resolved, then obtain a Protect.
SERVICE trace that captures the problem and contact ANS1244E File system is locked by system
IBM technical support for additional assistance. Your
IBM Spectrum Protect administrator can help you
configure the trace. Explanation
File system cannot be accessed because it is locked by
ANS1241E File is in use; Write permission
the system.
denied.

System action
Explanation
The operation cannot be completed.
The current file cannot be opened to write to because
it is currently being run by another operation.
User response
System action See your system administrator.
File skipped. ANS1245E The file has an unknown format.

User response Explanation

Stop the operation that is running the file and retry the The process tried to restore or retrieve a file, but it had
operation, or restore or retrieve the file to a different an unknown format.
name or directory.
ANS1242E Too many symbolic links were System action
detected while resolving name The file is skipped.

Explanation User response

While trying to resolve the file name, too many The file was either backed up by another application,
symbolic links were found. or the data is invalid. If the file belongs to this system,

70 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
try the operation again. If the problem persists, Explanation
contact IBM technical support for further assistance.
The restart restore token has expired. The server
ANS1246E A command-line argument cannot restart the restore from where it last ended.
exceeded the maximum length
(maximum length) for a single System action
token.
Processing stopped; waiting for user intervention.
Explanation
User response
Command-line arguments may not exceed maximum
length characters. Retry the request without restart or abort the request.
ANS1251E File system/drive not ready
System action
The command is not processed. Explanation
The file system/drive was not ready for access.
User response
Correct the command and retry the operation. System action

ANS1247I Waiting for files from the server... Processing stopped.

Explanation User response

Restore request has been sent to the server. The wait Ensure that the drive is available , and then retry the
time depends on how many files you are restoring. operation.
ANS1252W The server that you are connected
System action to does not support this function.
IBM Spectrum Protect waits for files to restore from
the server. Explanation
You attempted to run a backup-archive client
User response operation when connected to the virtual server.
Backup-archive client operations are not supported
None.
when connected to the virtual server.
ANS1248E An active restore for the same
source file specification exists. System action
Unable to continue with this
request. The operation fails.

Explanation User response

Currently, there is an active restore for the same Connect to a valid server before attempting this
source file specification. Another restore of the same function.
source file specification cannot be started. ANS1253E File input/output error

System action Explanation

The requested restore fails. An error was found while reading from or writing to the
file.
User response
Start another restore with a different source file System action
specification. File or file system is skipped.
ANS1249W Server cannot restart the last
restore request.
Do you want to restore without
restart or abort the request?

Chapter 2. ANS 0000-9999 messages 71

User response System action
Check your system to ensure that it is operating The system object is not restored.
properly. For OS/2, run CHKDSK /F for the failing drive
which can be found in dsmerror.log. User response
ANS1254E File write error Check the error log for any other messages that might
indicate a reason for the failure, correct any indicated
Explanation problems, then try the operation again. If the problem
occurs again, manually delete the ADSM.SYS directory,
An error was found while writing to the file. then try the operation again. If the problem cannot be
resolved, contact IBM technical support for further
System action assistance.
File skipped. ANS1258E The image snapshot operation
failed.
User response
Check your system to ensure that it is operating Explanation
properly. The process was not able to take a snapshot of the
ANS1255E File exceeds system/user file specified volume.
limits
System action
Explanation Processing stopped.
A file being restored or retrieved exceeds system set
limits for this user. User response
Check the error log for any other messages that might
System action indicate a reason for the failure. Try to correct any
File skipped. indicated problems, then try the operation again. If the
problem persists, contact IBM technical support for
further assistance.
User response
ANS1259E The image snapshot operation
Ensure that the system limits are set properly.
failed. Diagnostic text: diag_text.
ANS1256E Cannot make file/directory
Explanation
Explanation An error was encountered during image backup
The directory path for files being restored or retrieved snapshot processing. The diagnostic text can vary,
cannot be created. depending on the error.

System action System action

File skipped. The operation ends.

User response User response

Ensure that you have the proper authorization to Examine the client error log for additional messages
create the directory for file being restored or retrieved. that might indicate the reason for the problem. Take
Make sure that you have write access. any corrective action suggested by the messages, then
try the operation again. If the problem persists,
ANS1257E An error occurred while preparing contact IBM technical support for further assistance.
the system object for restore.
ANS1260E File is being recalled or has been
Explanation recalled.

This message is typically issued when the client is

unable to delete the ADSM.SYS staging directory in
preparation for restoring the system object.

72 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
The file is being recalled by another process or has In order to back up files, the policy set must contain at
been recalled. last one backup copy group.

System action System action

File skipped. IBM Spectrum Protect did not backup the file.

User response User response

None The IBM Spectrum Protect administrator needs to
update or define at least one management class in
ANS1261W The archive description you your policy set that contains a backup copy group, or
specified is the empty string. else assign you to a different policy domain that
The process will use the default contains at least one backup copy group. Contact your
description (Archive Date: current IBM Spectrum Protect administrator for further
date). assistance.

Explanation ANS1264E The active policy set does not

contain any archive copy group.
The description option on the archive command may The archive operation cannot
not specify a null string. continue.

System action Explanation

Processing continues, and the description option is In order to archive files, the policy set must contain at
ignored. least one archive copy group.

User response System action

None. Specify at least one character in the description IBM Spectrum Protect did not archive the file.
ANS1262E The password is not updated.
Either an invalid current password User response
was supplied or the new password The IBM Spectrum Protect administrator needs to
does not fulfill the server update or define at least one management class in
password requirements. your policy set that contains an archive copy group, or
else assign you to a different policy domain that
Explanation contains at least one archive copy group. Contact your
The password is not updated because of one of the IBM Spectrum Protect administrator for further
following reasons: assistance.

• You entered an incorrect current password or ANS1265E Encountered bad mount or

filesystem, processing stopped.
• You entered a new password that does not fulfill the
password length requirements. The length
requirements are set on the server. Explanation
The getmnt system call returned an error indication.
System action Error was encountered trying to determine what the
mounted file systems are.
The password is not updated on the server.

System action
User response
Processing stopped. Cannot recover.
Enter another password.
ANS1263E The active policy set does not User response
contain any backup copy groups.
There is a bad file system or mount point on your
The backup operation can not
system. Look at file systems and mounts, and correct
continue.

Chapter 2. ANS 0000-9999 messages 73

any errors. If unsuccessful, see your system restart the dsmrecalld daemon and try the operation
administrator for more information. again.
ANS1266E Encountered bad mount or ANS1269I File is implicitly excluded.
filesystem, processing stopped.
Explanation
Explanation
You tried to back up or migrate a file that is implicitly
An error was encountered trying to determine what excluded.
the mounted file systems are.
System action
System action
IBM Spectrum Protect will not back up or migrate an
Processing stopped. Cannot recover. implicitly excluded file.

User response User response

Please, see your system administrator for more None.
information.
ANS1270E Running this command requires a
ANS1267E The management class for file file- valid NetApp Snapshot Differential
name c-mode license file.
does not allow migration. This file
will not be migrated. Explanation
A NetApp Snapshot Differential c-mode license file
Explanation
either does not exist or is not valid.
The management class for this file does not allow
migration System action
Processing stops.
System action
File is skipped. User response
Contact IBM support.
User response
ANS1271E The compressed file is corrupted
Either have the IBM Spectrum Protect administrator
change the Space Management Technique within the and cannot be expanded correctly.
management class to a value other than NONE or
change the include/exclude list to specify a Explanation
management class with the appropriate Space The compressed file cannot be expanded correctly due
Management Technique value. to one of the following reasons:
ANS1268E This file has been migrated. There is a problem on the tape.
There is a communications problem.
Explanation The compressed file was corrupted on the IBM
The error can result from migrating a file with hard Spectrum Protect Server.
links. After a file with hard links is migrated, attempts
to migrate the alias files yield an error. System action
File skipped.
System action
The file is skipped. User response
1) The compressed file is corrupted because there is a
User response problem on the tape. To know if this is the problem,
If this error is not a result of a hard linked file please issue the following command on the IBM
migration, then this error might be due to the previous Spectrum Protect Server: audit volume
cancelled migration or recall operation. In this case, <volume_name> fix=no If there is any problem
reported, you could move the data from that volume to

74 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
a new one (see command MOVE DATA) and try again ANS1274E Error Loading WINSOCK.DLL
the restore. 2) There are communications problems
between the IBM Spectrum Protect Server and the Explanation
IBM Spectrum Protect Client and the results is that the
file is corrupted during the transmission. If you use a Error loading the Windows socket support file into
gigabit Ethernet adapter on the Server please upgrade memory. This error only applies when using TCP/IP
the card driver (AIX platform) or add provided by SUN communications.
suggested changes to some system network options
which have resolved this problem (SUN platform). 3) System action
Please verify with your network support if during the
Connection to server fails.
restore there are no any problems between the IBM
Spectrum Protect Client/Server that is originating the
file corruption. User response

ANS1272W Adaptive subfile backup has been Because this error is caused by insufficient memory,
configured on the client but the shut down running applications and retry. If the
server doesn't allow this type of problem persists, see your system administrator.
backup. ANS1275E Error Loading Function(s) from
Adaptive subfile backup will not WINSOCK.DLL
be used for this operation.
Explanation
Explanation
Error loading one or more functions from the Windows
Adaptive subfile backup forced off by the server. socket support file.

System action System action

Processing continues. Connection to server fails.

User response User response

Set up the server to allow clients to back up subfiles. Since this might possibly be caused by insufficient
ANS1273I Microsoft Windows hotfix 'hotfix- memory, shut down running applications and retry. If
number' is not installed. the problem persists, see your system administrator.
ANS1276E Virtual Machine backup corruption
Explanation detected. The filespace on the IBM
This message is issued On Windows 7, Windows Spectrum Protect server must be
Server 2008 R2, Windows Vista, and Windows Server deleted.
2008. This hotfix is known to release new API
enhancements for Windows to help correctly and Explanation
securely load external libraries. Visit the Microsoft Due to APAR IT22660, the backup on the IBM
support page http://support.microsoft.com for more Spectrum Protect server is corrupt.
information about the hotfix.
System action
System action
The backup of the virtual machine is skipped.
Processing continues.
User response
User response
Request the IBM Spectrum Protect administrator
On Windows 7, Windows Server 2008 R2, Windows delete or rename the virtual machine on the IBM
Vista, and Windows Server 2008 you must apply the Spectrum Protect server.
package KB2533623 prior to performing the Snapshot
dirrerential backup. If backup-archive client ANS1277E The VMware vStorage API
operations that use OpenSSL do not complete reported that a file was not found
successfully due to OpenSSL related errors, install the for the virtual machine.
hotfix, then try the operation again.

Chapter 2. ANS 0000-9999 messages 75

Explanation System action
A VMware vStorage API error occurred due to a file not Operation aborted.
found on the virtual machine.
User response
System action
Use -nasnodename option with the command or place
A VMware vStorage API error occurred, and the virtual nasnodename option in the option file.
machine backup failed.
ANS1287E Volume could not be locked.

User response
Explanation
Check the VMware logs for possible causes of the
The system call to lock the volume failed.
error, and try the operation again.
ANS1278W Virtual mount point 'filespace- System action
name' is a file system. It will be
backed up as a file system. Processing stopped.

Explanation User response

A virtual mount point that is a file system is invalid and Please verify that no other application is accessing the
should be deleted. volume. If this volume is being accessed by
applications that can not be shutdown during backup
then perform an online image backup (snapshot)
System action
instead. During restore of an image IBM Spectrum
The virtual mount point is ignored. Protect must have exclusive use of the volume.
ANS1288E The (-TYPE) option is required
User response with the SET EVENT command.
Delete the virtual mount point.
Explanation
ANS1279W Virtual mount point 'filespace-
name' cannot be used in a file There is no default value for the -TYPE option. It must
system handled by automounter be explicitly entered with the command.
and is ignored.
System action
Explanation
The current command ends.
Virtual mount points cannot be used in a file system
handled by automounter. If virtual mount points reside User response
in a file system that is processed from an
automounter, the backed up files underneath the Enter the SET EVENT command again with the TYPE
virtual mount points will be expired when the file option and a value of HOLD, RELEASE, or
system is unmounted. ACTIVATERETENTION.
ANS1289W Bad areas on 'volume' between
System action sectors hi:lo and hi:lo
The virtual mount point is ignored.
Explanation
User response Some bad sectors within the specified range were
Delete the virtual mount point. detected on the volume during image operation.

ANS1286E -nasnodename option required for System action

this operation.
Processing continues.
Explanation
User response
User issued a NAS related command and
NASNodename option is missing. Make sure the volume data is not corrupt by using
system tools like chkdsk (Windows) or fsck (UNIX).

76 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1299E Unable to generate an encryption Protect client operation from continuing. Your IBM
key for storing password Spectrum Protect server administrator can review the
IBM Spectrum Protect server activity log for more
Explanation details about the error.

You tried to start an operation that led to storing System action

password on the IBM Spectrum Protect client side but
the client was unable to generate an encryption key Processing stopped.
very likely due to a configured FIPS-enabled operating
system environment. User response
Contact your IBM Spectrum Protect server
System action administrator for assistance. The administrator can
Processing stops. review the IBM Spectrum Protect server activity log for
further information about the conditions that lead to
User response this error.

The IBM Spectrum Protect client doesn't support the ANS1302E No objects on server match query
Federal Information Processing Standard (FIPS)
enabled operating system environmnet for locally Explanation
stored passwords. See your system administrator for
No objects on the server match the query operation
assistance in reconfiguring the FIPS-enabled
being performed. If this object is part of a backupset
operating system environment. For more details on
generated on a node, and the node name is changed
FIPS support, see the following techdoc: http://
on the server, any backup set objects that were
www-01.ibm.com/support/docview.wss?
generated prior to the name change will not match the
uid=swg22007756
new node name.
ANS1300E File 'file_name' cannot be
reconstructed because a System action
necessary component was not
restored. Processing stopped.

Explanation User response

The subfile backup technique was used to back up this Ensure the names are properly entered. If the object is
file. During the restore, a portion of the file was not be part of a backupset generated prior to a node name
obtained from the server. change, ensure that the node name is the same as the
node for which the backup set was generated.
System action ANS1303E Client ended transaction
The file indicated in the message is not restored.
Restore for all other files continues. Explanation
The client system ended the operation with the server
User response and ended the current transaction.
Try to restore the file again by selecting the file for
restore from the user interface. You can also check the System action
client error log and the server activity log for any Processing stopped.
messages related to the file indicated in the message.
ANS1301E This operation cannot continue User response
due to an error on the IBM Restart the session.
Spectrum Protect server. See your
IBM Spectrum Protect server ANS1304W An active backup version could not
administrator for assistance. be found.

Explanation Explanation
The IBM Spectrum Protect server encountered an An attempt was made to expire an object, but the IBM
error condition that prevents the IBM Spectrum Spectrum Protect server was unable to find an active

Chapter 2. ANS 0000-9999 messages 77

backup version of the object. This message is ANS1306E You entered an incorrect
preceded by message ANS1228E which specifies the password.
object name.
For instance, this message could be issued if two Explanation
separate client processes are backing up the same file
system at the same time. If one of the processes You entered an incorrect current password or you
expires a file, then the IBM Spectrum Protect server entered a new password that does not fulfill the
will make that file inactive. If the second process password length requirements set on the server.
subsequently attempts to expire that same file, the
IBM Spectrum Protect server will not find an active System action
version of the file, so the second process will issue this
Processing stops.
message for that file.

User response
System action
Retry the session with the correct password. If this
The object is not expired. Processing continues with
fails or you have forgotten your password, ask the IBM
the next object.
Spectrum Protect administrator to assign a new
password.
User response
ANS1307E Node in use
• Review the console output, schedule log, or error log
and locate the ANS1228E message that immediately
precedes this message. ANS1228E will identify the Explanation
object that could not be expired. The node you are running on is in use by another
• Examine the conditions under which the problem operation on the server. This might be from another
occurred and assess whether those conditions client or from some activity on the server.
explain the occurrence of this message. For
example, this message could appear if multiple System action
instances of the client were attempting to back up
the file system concurrently. Processing stopped.

• If the reason this message occurred can not be

User response
determined and the message occurs when the
operation is tried again, then contact IBM support for Retry the operation, or see your system administrator
further assistance. Also try searching for this to see what other operations are running for your
message number on http://www.ibm.com for node.
possible solutions.
ANS1308E Expiration date must be greater
ANS1305E The IBM Spectrum Protect server than today's date
has no data for the object.
Explanation
Explanation
Archive expiration date is too low, the date must be
IBM Spectrum Protect tried to do a restore or retrieve greater than today's date.
on an object that has no data associated with it. If a
corrective action is possible, it is with the IBM System action
Spectrum Protect server.
IBM Spectrum Protect canceled the current operation.
System action
User response
IBM Spectrum Protect ends the current operation.
Retry archiving the file with an expiration date that is
higher than today's date.
User response
ANS1309I The requested data is offline.
Ask the IBM Spectrum Protect administrator to check
the IBM Spectrum Protect activity log for any
messages related to this error that might help identify Explanation
the problem. For the restore or retrieve operation, one or more of
the requested files must be recalled from offline

78 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
storage media (generally tape). The wait time depends Explanation
on your site's offline storage management policies.
Server media mount not possible. The server timed out
waiting for a mount of an offline volume.
System action
IBM Spectrum Protect waits for offline storage media System action
to become available and then continues.
File skipped.

User response
User response
None.
Retry later when server volumes can be mounted.
ANS1310E Object too large for server limits Ensure that the MAXNUMMP (maximum number of
mount points) defined on the server for this node is
Explanation greater than 0.

The object is too large. The configuration of the server ANS1313E Size estimate exceeded
does not have any data storage space that accepts the
object. Explanation
The total amount of data for a backup or archive
System action operation exceeds the estimated size originally sent to
File skipped. 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
User response
session.
See your system administrator to determine the
maximum file (object) size for which your site's server System action
is configured.
Processing stopped.
ANS1311E Server out of data storage space
User response
Explanation
Retry the operation. If the problem continues, check
The server does not have any space available to store what other processes are running on the client
the object. machine that are generating large amounts of data.
Disable those operations while the backup or archive
System action operation is taking place.
Processing Ends. ANS1314E File data currently unavailable on
server
User response
Explanation
You can take any of the following actions:
The file data is currently unavailable on the server. A
• Request the system administrator to add space to
retrieve or restore operation was attempted. Possible
the storage pool.
causes are:
• For IBM Spectrum Protect client, set
COMPRESSALWAYS=NO and COMPRESSIon=YES in • Data was corrupted at the server
the options file (DSM.OPT), then the file will be • Server found a read error
resent uncompressed if it grows during • File is temporarily involved in a reclaim operation at
compression. the server
• For API Applications, consult the application's • Server requested a tape volume that was marked
documentation for recommendations regarding unavailable.
compression.
• Turn off disk caching in the disk storage pool, and System action
issue MOVE DATA commands to each disk pool
volume to clear out the cached bitfiles. Processing stopped.

ANS1312E Server media mount not possible

Chapter 2. ANS 0000-9999 messages 79

User response ANS1318E The server does not have enough
memory to continue the current
Retry the operation. If the problem continues, see your
operation.
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 Explanation
unavailable. A tape volume may be marked The server ran out of memory.
unavailable if prior read errors were encountered or
the volume is checked out of the tape library.
System action
ANS1315W Unexpected retry request. The
Processing ends.
IBM Spectrum Protect server
found an error while writing the
data. User response
This is a temporary problem. Retry later or see your
Explanation system administrator.
None. ANS1319E An error occurred on the IBM
Spectrum Protect server while
System action trying to rename file space
file_space_name
If the current operation supports another attempt, the
client tries the operation again. Otherwise, processing
stops. Explanation
None.
User response
None. System action
Because the file space cannot be renamed, the
ANS1316E The server does not have enough
operation stops.
recovery log space to
continue the current operation
User response
Explanation Check the client error log and the IBM Spectrum
Protect server activity log for any other messages that
The server ran out of recovery log space.
might help identify the problem. If the problem cannot
be resolved, contact IBM technical support for
System action additional assistance.
Processing ends. ANS1320E The specified file space does not
exist on the server. The
User response file space might have been deleted
This error is a temporary problem. Retry later or see by another client or an
your system administrator. administrator.

ANS1317E The server does not have enough Explanation

database space to continue
the current operation The specified file space does not exist on the server.
Your system administrator deleted the file space or
another client using your client's node name deleted it.
Explanation
The server ran out of database space. System action
Current operation has been cancelled.
System action
Processing ends. User response
Check the file space name to see if it is correct, and
User response
retry the operation.
See your system administrator.

80 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1321S Open Registration failed because available soon. For example, a storage pool migration
the specified node name is defined might free up sufficient space to store the data.
in the server
System action
Explanation Current operation has been cancelled.
Open registration failed because a node is defined in
the server with the same name. User response
Try the operation at a later time. If this fails, contact
System action the IBM Spectrum Protect administrator and request
Current operation has been cancelled. more storage pool space.
ANS1327W The snapshot operation for
User response 'volname' failed with error code:
Retry with another node name. retcode.

ANS1322S Open Registration failed because Explanation

no default domain exists
A snapshot could not be taken of the specified volume.
Explanation
System action
Open registration failed because a default policy
domain does not exist for you to place your node. Snapshot processing stopped.

System action User response

Current operation has been cancelled. Check the client error log for any other messages that
might help identify the problem. If the problem cannot
User response be resolved, contact IBM technical support for
additional assistance.
See your system administrator.
ANS1328W An error occurred generating delta
ANS1323S Open Registration failed because file for 'file-name'. The return code
an invalid node name was is retcode.
specified
Explanation
Explanation
An error occurred that prevented the creation of the
Open registration failed because the specified node delta file. Possible reasons for this error include:
name contains invalid characters.
• The base file cannot be opened for reading
System action • The file being backed up cannot be opened for
reading
Current operation has been cancelled.
• The delta file cannot be opened for writing

User response • The file being backed up has grown to a size larger
than 2 GB
Retry with another node name that does not have any
• A memory file mapping of the file cannot be created
invalid characters.
ANS1326S The IBM Spectrum Protect server System action
does not currently have space in
the storage pool for this file. This A full backup of the file is made, and a new version of
may be a temporary condition. the reference file is stored in the subfile cache.

Explanation User response

This message is typically issued when the storage pool If the message indicates return code 4504, check the
in which the data is being placed does not have delta subfile cache directory for any residual delta
sufficient space to store the data, but the space will be files. The delta subfile cache directory is specified by
the client option SUBFILECACHEPATH. Search the

Chapter 2. ANS 0000-9999 messages 81

directory for files named \".dXXXXXXXX\" where System action
\"XXXXXXXX"\ is an eight-digit number. If there are no
Processing stopped.
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 User response
files exist, they can safely be removed. User must be root user, or user must be the owner of
If you continue to receive this message but there are the executable and the set effective user id bit is set to
no residual delta files in the subfile cache directory 'on' ('s' bit).
and the file has not grown to a size larger than 2 GB,
then contact IBM technical support for further ANS1332E Run the '... for Administrators'
assistance. version of the application.

ANS1329S Server out of data storage space

Explanation

Explanation The user must be root or a system administrator and

use the provided authorization tools to start IBM
The server does not have space available to store the Spectrum Protect
object.
System action
System action
IBM Spectrum Protect terminates.
Processing Ends.
User response
User response
The user must login as the root user or be a system
Report to your system administrator that a storage administrator and use one of the following
pool on the server is full. authorization tools to start IBM Spectrum Protect:
ANS1330S This node currently has a pending • "IBM Spectrum Protect Backup for Administrators"
restartable restore session.
• "IBM Spectrum Protect Scheduler for
The requested operation cannot
Administrators"
complete until this session either
completes or is canceled. • "IBM Spectrum Protect Scheduler Daemon for
Administrators"
Explanation ANS1333E The remote node is not properly
This operation can not be completed because a configured on the IBM Spectrum
restartable restore session is pending. The operation is Protect server.
not allowed because the restartable session and the
current operation affect the same file space. Explanation
The remote node is not properly configured on the IBM
System action Spectrum Protect server.
Processing Ends.
System action
User response Processing stopped.
Issue a query restore to see the conflict. Issue the
cancel restore command to delete any unneeded User response
restartable restore sessions. Ensure that the remote node is properly configured
ANS1331E Only a IBM Spectrum Protect and connected to the IBM Spectrum Protect server by
authorized user can perform this using TLS. This validates the remote node
Action. configuration and ensures that the information that is
related to the remote node is sent to the server.
Explanation ANS1334W Volume mount point 'filespace
User must be a IBM Spectrum Protect authorized user namepath-namedir-name' was not
to perform this action. User is not password authorized restored because the target
and this action requires authorization. directory is not empty.

82 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
Volume mount points can only be restored if the target None.
directory does not already exist, or if the target
ANS1337I Restarting the RSM service...
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 Explanation
Windows Vista, it is normal to see these warnings RSM database files have been restored from the server
during system drive restore as there are many junction and imported. The process is about to stop then
points that point to the '%systemroot%\Users' folder. restart the RSM service.

System action System action

The volume mount point is not restored. Processing Processing continues.
continues with the next object.
User response
User response
None.
Correct the conflict with the non-empty directory, then
try the operation again. This is especially important ANS1338I Restart of the RSM service is
when this message is issued for a volume mount point completed.
that resides in the SYSVOL, since an incomplete
SYSVOL restore can result in system stability Explanation
problems. See the reference information for the
RESTORE command in the client manual for additional RSM database files have been restored from the server
information about restoring volume mount points. and imported. The process has restarted the RSM
service on the user's behalf.
ANS1335E The RSM database files could not
be restored. System action
Processing continues.
Explanation
None. User response
None.
System action
The RSM database is not restored. Otherwise, ANS1339E Restart of the RSM service failed.
processing continues. Restart the RSM service manually.

User response Explanation

Check the client error log for any other messages that RSM database files have been restored from the IBM
might help identify the problem. Reboot the system, Spectrum Protect server and imported. The process
then try the RSM restore operation again. If the has tried to restart the RSM service on the user's
problem cannot be resolved, contact IBM technical behalf but has run into a problem.
support for further assistance.
System action
ANS1336I RSM service must be restarted for
changes to become effective. Processing stopped.

Explanation User response

RSM database files have been restored from the server Restart the RSM service manually.
and imported. The RSM service must be restarted for ANS1340E An error occurred while backing
the updates to become effective.
up the RSM database.

System action Explanation

Processing continues. An error occurred while backing up the RSM database
files. The database will not be backed up.

Chapter 2. ANS 0000-9999 messages 83

System action User response
Processing stopped. Run the command without the specified option.
Alternatively, run the command with the other option
User response added.

Check the client error log for any other messages that ANS1344E Job is running in the background.
might help identify the problem. Try the operation Cannot prompt for the Key.
again. If the problem persists, contact IBM technical
support for further assistance. Explanation
ANS1341E An invalid character appears in When jobs are run in the background, the client cannot
the operand: operand. prompt for the key.

Explanation System action

The operand contains a character that is not valid in Processing stopped.
the current locale and code page. It cannot be
translated to its internal wide-character format. User response
Run the Job in the foreground.
System action
ANS1345E No objects on the server match
Processing stops.
'object-nameobject-nameobject-
name'
User response
Change the locale of the workstation to match the Explanation
language in which the operand is recorded, and try the
command again. The specified file does not have a match on the server.

ANS1342E Client cache is locked; unable to System action

continue with operation.
The file is skipped.
Explanation
User response
The client cache is currently locked by another
process. Back up the file and try the operation again. If the
problem continues, see your system administrator to
isolate the problem through use of the server console.
System action
ANS1346E The image snapshot operation
Processing stopped.
failed. The
SNAPSHOTCACHELocation does
User response not contain enough space for this
Report the program error to your service snapshot image backup.
representative.
Explanation
ANS1343E The option 'specified-option' can
only be entered when 'other- IBM Spectrum Protect was not able to take a snapshot
option' has been entered. of the specified volume. The
SNAPSHOTCACHELocation points to a location which
Explanation does not contain the space necessary to manage the
snapshot. This could be due to an unexpected amount
The command failed because the specified option of disk activity which is generating more changes than
(specified-option) option was entered, but the other can be contained in the available space at this
option (other-option) was not. particular point in time, or the
SNAPSHOTCACHELocation needs to be changed
System action because the specified location is not large enough to
handle the usual amount of changes to the volume.
The command is terminated.
Another reason for this failure can be that the
specified SNAPSHOTCACHESize is not set to a large

84 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
enough value to handle the usual amount of changes User response
to the volume during snapshot image backup.
If the problem persists please modify the
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
System action options to better fit the normal disk write activity of
Processing stopped. the volume being backed up.
ANS1349E An error occurred during Logical
User response Volume Snapshot Agent snapshot
processing.
If the problem persists please increase the
SNAPSHOTCACHESize and/or change the value of the
SNAPSHOTCACHELocation. Explanation

ANS1347E The image snapshot operation An unrecoverable error occurred during snapshot
failed. The percent of space to use, processing. This can be caused by a variety of errors,
specified via the so the error and system event logs should be checked
SNAPSHOTCACHESize, has been for additional messages.
exceeded.
System action
Explanation Processing stopped.
IBM Spectrum Protect was not able to take a snapshot
of the specified volume. The percent of space allotted User response
via the SNAPSHOTCACHESize option was not enough
Check the client error log and the system event log for
to perform this snapshot image backup. This could be
any other messages that might help identify the
due to an unexpected amount of disk activity which is
problem. Try the operation again. If the problem
generating more changes than can be contained in the
persists, contact IBM technical support for further
allotted space at this particular point in time. Another
assistance.
reason for this failure can be that the specified
SNAPSHOTCACHESize is not set to a large enough ANS1350E The logical volume snapshot agent
value to handle the usual amount of changes to the (LVSA) is currently busy
volume during snapshot image backup. performing a snapshot on this
same volume.
System action
Processing stopped. Explanation
Another IBM Spectrum Protect process is already
User response performing a snapshot of this volume.
If the problem persists please increase the
SNAPSHOTCACHESize or, for Windows, change the System action
value of the SNAPSHOTCACHELocation. The operation is stopped.
ANS1348E Unable to satisfy the
SNAPSHOTFSIDLEWait and User response
SNAPSHOTFSIDLERetries options Please wait until the other IBM Spectrum Protect
due to volume write activity. process finishes with the volume and then retry the
operation.
Explanation
ANS1351E Session rejected: All server
IBM Spectrum Protect was not able to take a snapshot sessions are currently in use
of the specified volume. The Logical Volume Snapshot
Agent was not able to satisfy the Explanation
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
options before starting the snapshot of the specified IBM Spectrum Protect has all available sessions in use
volume. and cannot accept a new one at this time.

System action System action

Processing stopped. Current operation has been cancelled.

Chapter 2. ANS 0000-9999 messages 85

User response Check the administrative ID associated with your
IBM Spectrum Protect node and verify that the IBM
Retry the operation. If the problem continues, see your
Spectrum Protect node name has a matching
system administrator to increase the number of
administrative ID with client owner authority for the
concurrently active sessions to the server.
node. If it does not, your IBM Spectrum Protect
ANS1352E The session is rejected. Your administrator needs to create it.
password has expired. Check that the server is using closed registration
and that your node name is registered with the
Explanation server.
If attempting to access a migrated file, your node
The password for IBM Spectrum Protect user ID has name must be the same node that migrated the
expired. It can be either IBM Spectrum Protect node file.
name password or administrative user ID password or
both. ANS1354E Session rejected: Duplicate ID
entered
System action
Explanation
Current operation has been cancelled. You are not
allowed to connect to the server until the password is Another process using this node name is active with
updated. the server.

User response System action

Update your password. It may require updating the IBM Spectrum Protect cannot connect to the server.
node name password or the corespondent Current operation has been cancelled.
administrative ID password or both. You may use the
SET PASSWORD command, or have the IBM Spectrum User response
Protect administrator update your node or your
administrative ID. If you are running a UNIX-based system, ensure that
another process is not active with IBM Spectrum
ANS1353E Session rejected: User ID is Protect under the same name. Also, ensure that your
incorrect, does not have admin node name is unique to the server so that it cannot be
authority, or is not known by the used by another person. See your system
server administrator to identify the owner of that node name.
ANS1355E Session rejected: Server disabled.
Explanation
The user ID, which is either IBM Spectrum Protect Explanation
node name or administrative user ID, is not known by
the server. Possible reasons for this include: The server is in a disabled state and cannot be
accessed for normal activity.
Your node name is not registered with the IBM
Spectrum Protect server
System action
The node name is correct but does not have a
corresponding administrative ID with the same Current operation has been cancelled.
name and client owner authority
you are attempting to access a file that was User response
migrated to a different node.
On the IBM Spectrum Protect server, run the ENABLE
SESSIONS administrative command. Try the operation
System action again after the server returns to an enabled state. If
Current operation has been cancelled. the problem continues, see your system administrator.
ANS1356E The server is not configured to
User response allow open registration
Do the following checks:
Check that your IBM Spectrum Protect user ID is
entered correctly.

86 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
No authorization. Registration is required by your The server is probably performing a task that prevents
system administrator. The server is not configured to your node from establishing a session. Retry later or
allow open registration. check with your system administrator.
ANS1360I Compressed Data Grew
System action
Session not started. Explanation
The size of the file after compression is greater than
User response the size of the file before compressed.
You must obtain a IBM Spectrum Protect node and
password from your system administrator. System action
ANS1357S Session rejected: Downlevel client Even though the size of the file increased, the file is
code version compressed.

Explanation User response

The server version and your client version do not None.
match. The client code is downlevel.
ANS1361E Session Rejected: The specified
node name is currently locked.
System action
Current operation has been cancelled. Explanation
The node name you specified is currently locked on
User response the server.
See your system administrator to see what version of
IBM Spectrum Protect to run for your location. System action
ANS1358S Session rejected: Downlevel Session was not started.
server code version
User response
Explanation
Check with your system administrator to find out why
The server version and your client version do not your node name is locked.
match. The server code is downlevel.
ANS1362S SLM LICENSE EXCEEDED: The
client licenses for IBM Spectrum
System action Protect are exceeded.
Current operation has been cancelled. See your system administrator.

User response Explanation

See your system administrator to see what version of Adding a new enrollment will exceed the product
IBM Spectrum Protect to run for your location. license count for IBM Spectrum Protect.

ANS1359E Session Rejected: The specified

System action
node name is currently in use
Execution of the client enrollment or connection
Explanation request ends.

The node name you specified is in use on the server.

User response

System action See your system administrator.

Session was not started. ANS1363E Session Rejected: The server does
not have enough memory to
allow a connection to be
established.

Chapter 2. ANS 0000-9999 messages 87

Explanation User response
The server does not have enough memory to allow Notify your IBM Spectrum Protect administrator of this
your client to establish a connection with the server. error.
ANS1367E The client is unable to sign on to
System action the IBM Spectrum Protect server
Session was not started. because the server does not allow
sign-on of Unicode clients.
User response
Explanation
Retry later or see your system administrator.
The client is not allowed to connect to the IBM
ANS1364E Session Rejected: The server does Spectrum Protect server.
not have enough recovery log
space to allow a connection to be
System action
established.
The session does not start.
Explanation
User response
The server ran out of recovery log space.
Contact your IBM Spectrum Protect administrator for
System action assistance in configuring a working IBM Spectrum
Protect client for your environment.
Session was not started.
ANS1368S Session Rejected: The server is not
User response licensed for this platform type.
See your system administrator.
This error is a temporary problem. Retry later or see
your system administrator. Explanation
ANS1365E Session Rejected: The server does The server is not licensed for the requesting client
not have enough database type.
space to allow a connection to be
established.
System action

Explanation Execution of the client enrollment or connection

request ends.
The server ran out of database space.
User response
System action
See your system administrator.
Session was not started.
ANS1369E Session Rejected: The session was
User response canceled by the server
administrator.
See your system administrator.
ANS1366E The session is rejected. The IBM Explanation
Spectrum Protect server has an The server administrator canceled the current client
internal error. session.

Explanation System action

The client cannot establish a connection to the IBM Execution of the client connection request ends.
Spectrum Protect server because of an internal server
error.
User response

System action See your system administrator.

The session was not started.

88 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1370E The user ID entered does not have ANS1373W The PRESNAPSHOTCMD command
the correct level of authority to for volume filespace completed
access the client machine. with a non-zero return code.

Explanation Explanation
The user ID entered cannot access this IBM Spectrum The command specified by the PRESNAPSHOTCMD
Protect client. option must complete successfully in order to perform
the snapshot backup/archive operation. If the
System action command completed with a return code of 0 (zero), it
has completed successfully. If the command
Operation ends. completed with any other return code, it has failed. If
the command failed, then the backup is still
User response performed, but without the benefit of the snapshot
technology.
Grant authority to this user ID on the IBM Spectrum
Protect server so that it can access this IBM Spectrum
Protect client. System action

ANS1371E File '' cannot be reconstructed The client executes the backup/archive operation, but
from subfile components. without using a snapshot.

Explanation User response

An error occurred while reconstructing this file from its Identify and fix the problem that caused the command
subfile components. 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.
System action
ANS1374W The POSTSNAPSHOTCMD
The file indicated in the message is not restored.
command for volume filespace
Restore for all other files continues.
completed with a non-zero return
code.
User response
Try to restore the file again by selecting the file for Explanation
restore from the user interface. You can also check the
The command specified by the POSTSNAPSHOTCMD
client error log and the server activity log for any
option completed with a non-zero return code. The
messages related to the file indicated in the message.
snapshot-based backup operation yields a return code
ANS1372E An inconsistency was detected of at least 8.
between the client node and
the node that is registered to the System action
IBM Spectrum Protect server.
The snapshot-based backup operation continues.
Explanation
User response
The user has probably coded the node option
incorrectly. For instance, the node that is registered to Identify and resolve the problem that caused the post-
the IBM Spectrum Protect server might be a type of snapshot command to fail. If a non-zero return code is
NAS, but the node is actually a non-NAS client. normal for this command, then consider wrapping the
post-snapshot command in a script that always exits
with a return code of zero.
System action
ANS1375W File FilesystemPathFileName
Operation ends.
skipped by user

User response
Explanation
Ensure that the node name is correct in the client
You requested that this file be skipped during the
options file. Make sure to use a node of type NAS only
current operation.
with the nasnodename option.

Chapter 2. ANS 0000-9999 messages 89

System action SNAPSHOTCACHELocation points to a location which
does not contain the space necessary to manage the
The file is skipped during the current operation
snapshot. Reasons for failure include:

User response • An unexpected amount of disk activity which is

generating more changes than can be contained in
None. the available space at this particular point in time.
ANS1376E Error processing 'filespace name • The SNAPSHOTCACHELocation is not large enough
path-namefile-name'; end-to-end to handle the usual amount of changes to the
digest validation failed. volume.
• The specified SNAPSHOTCACHESize is not set to a
Explanation large enough value to handle the usual amount of
changes to the volume during snapshot backup or
Cryptographic digest of the restored or retrieved data
archive operation.
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 stopped.
System action
Processing stops User response
If the problem persists, increase the
User response SNAPSHOTCACHESize or change the value of the
SNAPSHOTCACHELocation.
Try the restore operation again. If the problem
persists, contact IBM technical support for additional ANS1379E The snapshot operation failed. The
assistance. percent of space to use for the
ANS1377W SNAPSHOTCACHELocation,
The client was unable to obtain a
specified via the
snapshot of 'volname'. The
SNAPSHOTCACHESize, has been
operation will continue without
exceeded.
snapshot support.

Explanation
Explanation
IBM Spectrum Protect was not able to take a snapshot
IBM Spectrum Protect client was unable to create a
of the specified volume. The percent of space allotted
snapshot of the volume due to some reason. Instead
via the SNAPSHOTCACHESize option was not enough
of failing the operation, IBM Spectrum Protect client
to perform this snapshot backup/archive operation.
will perform a non-snapshot based backup.
Reasons for failure include:

System action • The SNAPSHOTCACHELocation is not large enough

to handle the usual amount of changes to the
Snapshot processing stops. volume.
• The specified SNAPSHOTCACHESize is not set to a
User response large enough value to handle the usual amount of
Check the client error log for any other messages that changes to the volume during snapshot backup or
might help identify the problem. Try the operation archive operation.
again. If the problem persists, contact IBM technical
support for further assistance. System action
ANS1378E The snapshot operation failed. The Processing stopped.
SNAPSHOTCACHELocation does
not contain enough space for this User response
snapshot operation.
If the problem persists, increase the
SNAPSHOTCACHESize or change the value of the
Explanation
SNAPSHOTCACHELocation.
IBM Spectrum Protect was not able to take a snapshot
of the specified volume. The ANS1380W The snapshot operation failed. The
filesystem write activity prevented

90 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 the Logical Volume Snapshot System action
Agent from satisfying the
The IBM Spectrum Protect operation ends.
SNAPSHOTFSIDLEWait and
SNAPSHOTFSIDLERetries options.
User response
Explanation Contact your systems administrator to enable client-
initiated sessions for your node or update the
IBM Spectrum Protect was not able to take a snapshot
SESSIONINITIATION option and run the client
of the specified volume. The Logical Volume Snapshot
scheduler.
Agent was not able to satisfy the
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries ANS1383E Wrong server port.
options before starting the snapshot of the specified
volume. Explanation
You were trying to open a backup/archive client
System action
session on the server port set up for administrative
Snapshot processing stops. sessions only.

User response System action

If the problem persists, modify the The IBM Spectrum Protect operation ends.
SNAPSHOTFSIDLEWait and SNAPSHOTFSIDLERetries
options to better fit the normal disk write activity of User response
the volume being backed up.
Contact your systems administrator and/or use the
ANS1381W On volumes that are RAW or correct values for TCP port and TCP Admin Port.
formatted FAT32 the snapshot
cache location cannot be located ANS1384E An object in the transaction has
on the same volume that is being been bound to an invalid
backed up. management class.

Explanation Explanation

When the snapshot cache location is located on the One of the objects in the transaction is bound to a
same volume that is being backed up the volume must management class that is not part of this node's
be formatted with NTFS. The default cache location is policy, or the management class type is not supported
on the same volume where the snapshot is being for this client level.
performed. The operation will continue without
snapshot support. System action
The current operation ends.
System action
The client does not execute the snapshot operation. User response
Make sure all objects are bound to a valid
User response management class, or upgrade the client to the proper
Specify a different snapshot cache location, using the level.
SNAPSHOTCACHELOCATION option. ANS1385E This server does not support
ANS1382E Server does not allow client- backup operations.
initiated connections for this node.
Explanation
Explanation This server only supports archive operations, backup is
The node is not allowed to initiate connections due to not allowed.
the configuration parameters for this node on the
server. Server is able to initiate connections to the System action
client scheduler running in prompted mode.
The current operation ends.

Chapter 2. ANS 0000-9999 messages 91

User response Explanation
Use only archive operations with this server. There are two possible reasons for this message:
ANS1386E Deleting this object: "fshlll" is not • The option option was specified for a scheduled
allowed. command or subcommand (function) that cannot
make use of that option.
Explanation • The option appears on a scheduled command but is
valid only on the client scheduler initial command
The object is either under a hold and cannot be
line, not on commands in a schedule from the server.
deleted, or it is on a retention-protection enabled
server and has not expired.
System action
System action The option is ignored.
The object is skipped and processing continues.
User response
User response See the Backup-Archive Client Installation and User's
Guide for correct use of the named option. The system
Check the status of the object through a query to see if
administrator should remove the invalid option from
it is held, or when it expires.
the schedule definition on the server.
ANS1387E The number of objects in this
ANS1395E The destination filespace or drive
transaction exceed
letter is unavailable. The following
TXNGROUPMAX values.
object was not processed:
Filespace:'filespace-name'
Explanation
There are too many objects in this transaction. Explanation
The system is trying to restore or retrieve to a
System action destination that cannot be reached. The specified
The current operation ends. filespace name or drive letter is not valid, or does not
exist, or you are specifying a local share name that
cannot be resolved.
User response
Try the operation again with fewer objects in the System action
transaction, or increase the TXNGROUPMAX value on
the server. Objects which are part of this filespace are not
processed.
ANS1388E fshlll is already under hold.
User response
Explanation
Try the command again, and specify a different
The specified object is already under hold, and it destination for the object that was not processed.
cannot be placed under a new hold.
ANS1396E Access to the specified log or trace
file (filename) is denied.
System action
This object is skipped and processing continues. Explanation
Access to the specified file is denied. You specified a
User response
log or trace file name that cannot be written by the
Issue a query to see the status of the objects, and try current user.
the operation again, without the object that is already
held. System action
ANS1389W Invalid option (option) for the Processing stops.
scheduled function command

92 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response ANS1399W The logical volume snapshot agent
(LVSA) is currently busy
Ensure that you specified the correct file or directory
performing a snapshot on this
name, correct the permissions, or specify a new
same volume.
location.
ANS1397W The snapshot cannot be taken Explanation
because the
SNAPSHOTCACHELocation does IBM Spectrum Protect was not able to take a snapshot
not have enough space for this of the specified volume because another process is
snapshot operation. already performing a snapshot of this volume. The
operation continues without snapshot support.
Explanation
System action
IBM Spectrum Protect was not able to take a snapshot
of the specified volume. The Snapshot processing stops.
SNAPSHOTCACHELocation points to a location which
does not contain the space necessary to create the User response
snapshot; the disk is probably full. The operation
Wait until the other IBM Spectrum Protect process
continues without snapshot support.
finishes with the volume and then try the operation
again.
System action
ANS1400W The snapshot cache location is not
The client does not execute the snapshot operation. valid.

User response Explanation

Change the value of the SNAPSHOTCACHELocation, or The snapshot cache location must point to a local
clean the disk to which the SNAPSHOTCACHELocation volume that is formatted with NTFS. The default cache
points. location is on the same volume where the snapshot is
ANS1398E Initialization functions cannot being performed. The operation will continue without
open one of the IBM Spectrum snapshot support.
Protect logs or a related file: log-
name. errno = errno-value, reason System action
Snapshot processing stops.
Explanation
The file "log-name" could not be opened during User response
initialization. The system set the error code errno-
Specify a different snapshot cache location using the
value. If the reason given is "access denied," the
SNAPSHOTCACHELOCATION option.
current user does not have permission to write to the
log in the directory specified. It is also possible that no ANS1401W The snapshot virtual volume is not
space is available at the given log location. accessible.
On Unix systems, the log must not be in the root
directory. Attempts to do so will result in an "access Explanation
denied" error. The logical volume snapshot agent (LVSA) cannot
access the virtual volume during OFS-enabled backup/
System action archive operation because IBM Spectrum Protect was
Processing terminates. probably started via terminal services. The operation
continues without snapshot support.
User response
System action
Set the DSM_LOG (or DSMI_LOG) environment
variable to a directory into which the current user can Snapshot processing stops.
write. You may also use the ERRORLOGNAME option
to specify a file to which the current user has write User response
permission. Do not use terminal services for the snapshot. Try the
operation again on the local machine.

Chapter 2. ANS 0000-9999 messages 93

ANS1402W The snapshot is not supported on a Explanation
remote, removable, or SAN drive. The service must be restarted for the restored changes
to take effect.
Explanation
IBM Spectrum Protect was not able to take a snapshot System action
of the specified volume because open file support is
Changes are not effected.
only supported on local fixed volumes, including
volume mountpoints. The operation continues without
snapshot support. User response
Restart the service.
System action
ANS1408W Previous changes have not been
The client does not execute the snapshot operation. commited.
The machine must be restarted
User response before the snapshot can be taken

To take advantage of the open file support, you may

Explanation
try the operation again on the local machine.
IBM Spectrum Protect was not able to take a snapshot
ANS1403E Error loading a required filename of the specified volume because a previous operation
DLL required the machine to be restarted for the changes
to take effect, but the machine has not been restarted.
Explanation The operation will continue without snapshot support.
An error occurred while loading a dynamic link library.
The DLL load failed. System action
The client does not execute the snapshot operation.
System action
Processing stopped. User response
Restart the machine and then try the operation again.
User response
ANS1409I A full backup for the vm name
Verify that your system software is up to date and that virtual machine will be performed
all DLLs required by the IBM Spectrum Protect client because an include.resetcbt
are present. option was specified for the virtual
ANS1404E Error loading one or more machine.
functions from a required filename
DLL Explanation
The VM was specified in an include.resetcbt
Explanation statement. A full backup and a Changed Block
An error occurred while loading a function from a Tracking (CBT) reset will be performed.
dynamic link library. The DLL load failed.
System action
System action Changed Block Tracking (CBT) will be reset and the a
Processing stopped. full backup operation will be performed for this virtual
machine.
User response
User response
Verify that your system software is up to date.
No action is required.
ANS1405I 'service-name' service needs to be
restarted. ANS1410E Unable to access the network
path.

94 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The network path cannot be accessed due to a The file is skipped.
possible network problem.
User response
System action
Either delete the file if you do not need it, or else use
The client terminates. an EXCLUDE statement in the client options to prevent
the client from trying to process the file. In the
User response Windows environment, normal delete commands will
most likely not work. You will need to prefix the file
Ensure that the network is up and the path can be name with the characters '\\.\'. For example, "del
accessed using a system command, and retry the c:\mydir\lpt4" will not work, but "del \\.\c:\mydir\lpt4"
operation. will work.
ANS1411E A communication session was ANS1414W Don't have sufficient authority to
dropped. delete open group on server.

Explanation Explanation
A communication session was dropped due to a An open image group exists on the IBM Spectrum
possible network problem. Protect server and cannot be deleted due to missing
backup delete rights for this node.
System action
The client terminates. System action
Processing continues.
User response
Ensure that the network is up and retry the operation. User response

ANS1412E Directory or file has bad EA data or Ask your IBM Spectrum Protect administrator to grant
inconsistent data. backup delete rights for your node.
ANS1417W Protected system state file
Explanation 'filename' is backed up
to the drive file space, not system
Directory or file has bad EA data or inconsistent data.
state file space.

System action
Explanation
The client terminates.
Files protected by Microsoft Windows File Protection
(WFP) or Microsoft Windows Resource Protection
User response (WRP) are part of the Microsoft Volume ShadowCopy
Check failing directory or file for bad EA data. Copy the Services (VSS) System Writer which is part of the
directory to a new location and retry the operation. system state. These files are normally backed up as
part of the system state, not the file system on which
ANS1413W File 'filespace namepath-namefile- the files reside.
name' is not recognized by the A problem in the operating system environment
system as a disk file and cannot be prevented the protected file named in the message
processed. The file is skipped. text from being enumerated as a system state file and
thus backed up as part of the system state.
Explanation The conditions that lead to this message are not
normal. In order to ensure that the file is protected, it
The client is unable to process file types that are not is backed up as part of the file system on which it
'disk', such as 'character' and 'pipe'. This message is resides.
typically, but not always, issued for file names that are
normally reserved for the operating system. In the
Windows environment, reserved names include AUX, System action
CON, NUL, PRN, COMx or LPTx, where 'x' is any digit The file is backed up as part of the file system on
from 1 to 9 (for example, COM1, LPT3, etc.). which it resides.

Chapter 2. ANS 0000-9999 messages 95

User response Explanation
It is possible to restore the system using the file The specified image object of type object-type could
system and system state backups. However the not be located on the server. The operation cannot
conditions that prevent the system state files from complete without this object.
being correctly enumerated should be addressed.
On Microsoft Windows 2008 and Microsoft Windows System action
2008 R2 you can use the DiskShadow utility sub-
command LIST WRITERS DETAILED to enumerate the The operation ends.
system state files. On other versions of Microsoft
Windows you can use the vshadow utility with the - User response
wm2 option to enumerate the system state files. Verify
Examine the client error log for additional messages
that the file indicated in this message is not listed.
that might indicate the reason for the problem. Take
Note: vshadow is a utility that you can obtain from
any corrective action suggested by the messages, then
Microsoft.
try the operation again. If the problem persists,
After confirming that the files are not enumerated,
contact IBM technical support for further assistance.
contact your operating system technical support for
help to diagnose and resolve the issue that prevents ANS1423W 'filesystem' is a virtual mount
the file from being correctly enumerated as part of the point. Migration is not supported
system state. on virtual mount points.
ANS1418E Authentication error. The Admin
and/or Node password for Explanation
nodename has expired. IBM Spectrum Protect HSM does not support virtual
mount points within managed file systems. Files in the
Explanation virtual mount point folder can not be migrated.
Session authentication failed with the server because
either the admin or node password for the node has System action
expired. IBM Spectrum Protect attempts to continue the
current operation.
System action
Processing of the current operation is stopped. User response
Do not use virtual mount points within file systems
User response that are managed by HSM. Use include/exclude rules
instead.
Update your admin and/or node password for the node
identified. ANS1424W Retrying failed image operation for
volume filespace-name.
ANS1420E Volume map document
(tsmvolmap.txt) not found.
Explanation
Explanation The transaction for image operation for volume
filespace-name failed due to reason described by
An error occurred while performing VSS Automated
earlier message(s).
System Recovery (ASR). Check dsmerror.log for more
information.
System action
System action The requested image operation will be retried again.
Processing stops.
User response
User response None.
Ask your system administrator to check the error log. ANS1425E The image operation for volume
filespace-name cannot be retried
ANS1421E The image object 'object-type' was
because of a severe error.
not found on server.

96 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
None. Continue with normal operations.
ANS1428E Backup of the registry failed.
System action
The image operation fails for the indicated volume. Explanation
None.
User response
Check the client error log for any other messages that System action
might help identify the problem. Try the operation
The registry is not backed up.
again. If the problem persists, contact IBM technical
support for further assistance.
User response
ANS1426E An error occurred creating the
Registry backup directory Check the client error log for any other messages that
structure might help identify the problem. Try the operation
again. If the problem persists, contact IBM technical
support for further assistance.
Explanation
ANS1429I Registry Restore function
The IBM Spectrum Protect client uses an intermediate
completed successfully.
directory structure on the client machine as part of the
Windows Registry backup process. The client was
unable to create this intermediate directory structure, Explanation
so the Windows Registry could not be backed up. Registry Restore was successful.
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 action
system, or if a component within the directory None.
structure already exists as a file.
User response
System action
Continue with normal operations.
The Windows Registry is not backed up.
ANS1430W The machine must be rebooted for
the changes to take effect.
User response
Check the client error log for any other messages that Explanation
might have been logged when this message was
written, and take the corrective action (if any) The restore operation made changes that will not be in
suggested by those messages. Make sure that account effect until the machine is rebooted. It is important to
under which the operation runs has sufficient note that until the reboot occurs, the system or its
privileges. Ensure that the system has sufficient applications might be unstable.
memory to run the process. Remove the ADSM.SYS
directory from the root of your system drive, then try System action
the operation again. If the problem persists, contact
None
IBM support for further assistance.
ANS1427I Registry Backup function User response
completed successfully.
Reboot the machine as soon as possible after the
restore operation ends.
Explanation
ANS1431E Restore of the registry failed.
Registry backup was successful.

Explanation
System action
None.
None.

Chapter 2. ANS 0000-9999 messages 97

System action System action
The registry is not restored. The registry is not backed up.

User response User response

Check the client error log for any other messages that Check the client error log for any other messages that
might help identify the problem. Try the operation might help identify the problem. Try the operation
again. If the problem persists, contact IBM technical again. If the problem persists, contact IBM technical
support for further assistance. support for further assistance.
ANS1432E Keyword Expected after keyword ANS1436E An error occurred replacing a
'keyword'. registry key.

Explanation Explanation
A registry command was incorrectly entered. None.

System action System action

Registry function is not invoked. The registry key is restored from the server, but cannot
be activated in the registry. The current registry key
User response remains active.

Refer to the command reference for this command.

User response
ANS1433E Extraneous argument 'input' after Check the client error log for any other messages that
keyword 'keyword' might help identify the problem. Try the operation
again. If the problem persists, contact IBM technical
Explanation support for further assistance.
A registry command was incorrectly entered. ANS1437I Event Log Backup function
completed successfully.
System action
Registry function not invoked. Explanation
Event Log backup was successful.
User response
Refer to the command reference for this command. System action

ANS1434E Invalid argument 'input' after None.

keyword 'keyword'
User response
Explanation Continue with normal operations.
A registry command was incorrectly entered. ANS1438E Backup of the event logs failed.

System action Explanation

Registry function not invoked. None.

User response System action

Refer to the command reference for this command. The event logs are not backed up.
ANS1435E An error occurred saving a registry
key. User response
Check the client error log for any other messages that
Explanation might help identify the problem. Try the operation
None. again. If the problem persists, contact IBM technical
support for further assistance.

98 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1439I Event Log Restore function ANS1443E Invalid argument 'input' after
completed successfully. keyword 'keyword'

Explanation Explanation
Event Log Restore was successful. A event log command was incorrectly entered.

System action System action

None. Event Log function not invoked.

User response User response

Continue with normal operations. Refer to the command reference for this command.
ANS1440E Restore of the event logs failed. ANS1444E An error occurred creating the
Event Log backup directory
Explanation structure

None.
Explanation

System action The IBM Spectrum Protect client uses an intermediate

directory structure on the client machine as part of the
The event logs are not restored. Windows Event Log backup process. The client was
unable to create this intermediate directory structure,
User response so the Windows Event Logs could not be backed up.
This problem can occur if you do not have sufficient
Check the client error log for any other messages that
privileges to perform the backup operations, if the
might help identify the problem. Try the operation
client is unable to allocate more memory from the
again. If the problem persists, contact IBM technical
system, or if a component within the directory
support for further assistance.
structure already exists as a file.
ANS1441E Keyword Expected after keyword
'keyword'. System action
The Windows Event Logs are not backed up.
Explanation
A event log command was incorrectly entered. User response
Check the client error log for any other messages that
System action might have been logged when this message was
Event Log function is not invoked. written, and take the corrective action (if any)
suggested by those messages. Make sure that account
User response under which the operation runs has sufficient
privileges. Ensure that the system has sufficient
Refer to the command reference for this command. memory to run IBM Spectrum Protect. Remove the
ADSM.SYS directory from the root of your system
ANS1442E Extraneous argument 'input' after
drive, then try the operation again. If the problem
keyword 'keyword'
persists, contact IBM support for further assistance.

Explanation ANS1445E ERROR: could not create NAS

image object.
A event log command was incorrectly entered.

Explanation
System action
Creation of the NAS image object failed for one of
Event Log function not invoked. following reasons:

User response • An unauthorized user invoked the NAS command

• NAS operations are not supported on the current
Refer to the command reference for this command.
platform

Chapter 2. ANS 0000-9999 messages 99

• Cannot find the NAS plugin library. User response
Log in to an appropriate server and run the command
System action again.
The requested NAS operation is not performed. ANS1449W A non-critical, unexpected error
was encountered.
User response Deletion of a snapshot(Set/
Volume) failed. Probable cause,
Retry the operation after correcting the cause for
snapshot does not exists anymore.
failure.
Continuing Process...
ANS1446E VSS ASR backup document IBM Spectrum Protect snapShot
(ASRBackupDoc.xml) not found. ID : snapshot-id
IBM Spectrum Protect function
Explanation name : function-name
IBM Spectrum Protect function :
An error occurred while performing VSS Automated function-desc
System Recovery (ASR). Check dsmerror.log for more IBM Spectrum Protect return
information. Possible causes for the error are the code : TSM-rc
following: IBM Spectrum Protect file : file-
• You are trying to recover a machine running a legacy name (line-number)
operating system such as windows XP or windows
2003. VSS ASR Restore is not supported for legacy Explanation
operating systems.
None.
• You are trying to run ASR recovery from a backup
created by a client earlier than version 6.2.2. Such
System action
backups do not have ASRBackupDoc.xml file.
Processing continues.
System action
User response
Processing stops.
Contact the IBM Spectrum Protect administrator with
User response the information provided in this message.

Ask your system administrator to check the error log. ANS1450W The -FILENAME option was
specified without a file name.
ANS1448E The command command is not Output will be written to filename.
supported by the current server.
Explanation
Explanation
The -FILENAME option was specified, but the file
The server to which the client is connected does not name was omitted.
support the command.
1. If the command is "set event," the server does not System action
support event-based policy. This command The output is written to the default file.
requires that the server supports event-based
policy. That support is available only at IBM
Spectrum Protect Server levels 5.2.2 and above. User response

2. If the message displays any other command, the Reissue the command and specify a valid file name, or
server is configured to support archive retention use the information that was written to the default file.
protection and cannot process operations that are ANS1453W The IMAGEGAPSIZE option is not
not associated with that facility.
supported for non-NTFS file
systems. The entire volume will be
System action backed up.
The command is skipped and other processing
continues. Explanation
None.

100 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The entire volume is backed up. The OBF file for volume is very small to initiate a
server-free data transfer. Hence this file will not be
User response transferred via a server-free data path.

Refer to the client manual for additional information

System action
regarding the IMAGEGAPSIZE option.
Processing continues.
ANS1454W Used blocks information could not
be obtained for name. The entire
volume will be backed up. User response
None.
Explanation
ANS1459E VSS Automated System Recovery
None. (ASR) failed.

System action Explanation

The entire volume is backed up. An error occurred while performing VSS Automated
System Recovery (ASR). Check dsmerror.log for more
User response information.

Check the client error log for any other messages that
System action
might help identify the problem. Try the operation
again. If the problem persists, contact IBM technical Processing stops.
support for further assistance.
ANS1455E The value of the -vmname option User response
'vmname-option-value' would Ask your system administrator to check the error log.
result in the restoration of
multiple virtual machines with the ANS1461E Error processing 'filespace
same name. Use the keywords '*', namepath-namefile-name':
<time>, or <timestamp> to unsupported encryption type.
differentiate the restored virtual
machine names. Explanation
The files you are trying to restore or retrieve have been
Explanation backed up or archived by a later version of the IBM
The virtual machine restore command specified two or Spectrum Protect client. The file encryption method is
more virtual machines. The value of the -vmname not supported by the current client.
option would result in the restored virtual machines
having the same name. System action
Object skipped.
System action
The restore was stopped. User response
Restore or retrieve the file with the most recent
User response version of the IBM Spectrum Protect client.
Use the keywords '*', '<time>', or '<timestamp>' in the ANS1463E Unexpected error in cryptography
-vmname option so that each virtual machine is library.
restored with a different name. If the -vmname option
is not specified, each virtual machine is restored with
the original name. Explanation
There was an unexpected error in the cryptography
ANS1458I OBF file for volume name is too
library. See the error log for more information.
small for server-free data transfer.

System action
processing stops.

Chapter 2. ANS 0000-9999 messages 101

User response Explanation
Check the error log for ANS1467E to determine the Values were specified for both the SCHEDLOGMAX and
cause of failure. Verify you IBM Spectrum Protect the SCHEDLOGRETENTION options. These options are
client is installed properly. If needed, reinstall client mutually exclusive.
and/or API. If the problem still exists, contact IBM
Spectrum Protect technical support. System action
ANS1464S Cannot load ICC encryption Processing stops.
library.
User response
Explanation
Specify a nonzero value for SCHEDLOGMAX if you wish
The process is using a cryptography library which is to have the IBM Spectrum Protect scheduler log wrap
installed automatically with the client and is being when it reaches the specified maximum value. Use
loaded at runtime. The client cannot proceed if the SCHEDLOGRETENTION if you wish you have the
library is not loaded. scheduler log limited in size on a time-based schedule.
ANS1467E ICC routine icc-routine returned:
System action
majRC = majRC, minRC = minRC,
Client exits. desc = 'desc'.

User response Explanation

Check the error log for ANS1467E to determine the There was an error within an ICC cryptography library.
cause of failure. Verify your IBM Spectrum Protect This message reports return codes and problem
client is installed properly. If needed, reinstall the description which can be used by IBM Spectrum
client and/or API. If the problem still exists, contact Protect technical support personnel to determine the
IBM Spectrum Protect technical support. cause of the error.
ANS1465E Conflicting options ERRORLOGMAX
and ERRORLOGRETENTION were System action
specified. Client exits.

Explanation User response

Values were specified for both the ERRORLOGMAX and Verify you IBM Spectrum Protect client is installed
the ERRORLOGRETENTION options. These options are properly. If needed, reinstall client and/or API. If the
mutually exclusive. problem still exists, contact IBM Spectrum Protect
technical support.
System action
ANS1468E Backing up Automated System
Processing stops. Recovery (ASR) files failed. No
files will be backed up.
User response
Explanation
Specify a nonzero value for the ERRORLOGMAX option if
you want the error log to wrap when it reaches the An error occurred while backing up the files needed for
specified maximum value. Use the Automated System Recovery (ASR). No files were
ERRORLOGRETENTION option if you want the error log backed up.
limited in size on a time-based schedule.
ANS1466E Conflicting options System action
SCHEDLOGMAX and Processing stops.
SCHEDLOGRETENTION were
specified. 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.

102 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1469E Error processing 'filespace that you have access to the system object staging
namepath-namefile-name'; invalid directory <system drive> :\adsm.sys. Try the
encryption key. command again.
ANS1472E Could not add entry to the ASR
Explanation system information file. ASR
The key you entered does not match the key that was backup is unsuccessful.
used to encrypt the file during backup. The file can not
be restored unless the matching key is entered. Explanation
An error occurred while adding an entry to the system
System action information file (asr.sif) needed for Automated System
processing stops. Recovery (ASR). The ASR backup is unsuccessful.

User response System action

Try the restore operation again and provide the correct Processing stops.
key.
User response
ANS1470E Unable to load GPFS functions
needed for ACL and extended Ask your system administrator to check the error log.
attributes support: skip Verify that the Windows account from which you are
path_name running this command has administrator authority and
try the command again.
Explanation ANS1473E Session rejected: TCP/IP
The GPFS functions that handle the GPFS ACL and connection failure for Shared
extended attributes were not loaded. Memory

System action Explanation

The object is skipped. Processing continues with the An attempt to connect to the local server using the
next object. 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
User response
server is down.
Ensure that the GPFS software is installed on the
system and try the operation again. On Linux, iensure System action
that there has been an appropriate symbolic link
created in /usr/lib/ directory for the GPFS libgpfs.so Session rejected. Processing stopped.
shared library.
User response
ANS1471E ASR system information file
creation failed. ASR backup is Retry the operation, or wait until the server comes
unsuccessful. back up and retry the operation. If the problem
continues, see your system administrator for further
Explanation help.

An error occurred while creating the system ANS1474E An error occurred using the
information file (asr.sif) needed for Automated System Shared Memory protocol
Recovery (ASR). The ASR backup is unsuccessful.
Explanation
System action An error has occurred while reading or writing data
Processing stops. through the Shared Memory communications protocol.

User response System action

Ask your system administrator to check the error log. IBM Spectrum Protect cannot complete the requested
Verify that the Windows account from which you are operation.
running this command has administrator authority and

Chapter 2. ANS 0000-9999 messages 103

User response User response
Check the trace log for additional information and retry Ensure that the latest cluster software is installed on
the operation. If the problem continues, see your the system.
system administrator for further help.
ANS1478E CLUSTERNODE is set to YES but
ANS1475E Insufficient authority to connect to the cluster software is not
the shared memory region available
on this system.
Explanation
Explanation
The user issuing the command does not have authority
to connect to the shared memory segment. When the The load library that the operating systems provides to
shared memory segment is created by the server, it obtain the cluster name is not available on this system.
will be owned by the effective uid of the server process
(dsmserv). Only processes running under this uid or System action
root will be allowed to connect to the segment (and
thus to the server). Processing ends.

System action User response

The session is rejected and processing stops. Ensure that the cluster software is installed on the
system.
User response ANS1479E CLUSTERNODE is set to YES but
Run the command under the uid of the processing this machine is not a member of a
running dsmserv, if possible. Otherwise contact your cluster.
system administrator for further help.
Explanation
ANS1476E CLUSTERNODE is set to YES but
the Cluster Information Daemon is This machine is not a member of a cluster node.
not Possible causes are that the cluster service has not
started. been configured correctly, or that the cluster is in the
process of initialization.
Explanation
System action
The HACMP Cluster Information Daemon must be
started in order to specify the CLUSTERNODE option. Processing ends.

System action User response

Processing ends. Ensure that the cluster software is configured

properly. If the cluster is in the process of
initialization, retry the operation at a later time.
User response
ANS1480E CLUSTERNODE is set to YES but
Start the HACMP Cluster Information Dameon.
the cluster service is not enabled
ANS1477E CLUSTERNODE is set to YES but on this system.
the cluster load library is not valid.
Explanation
Explanation
The cluster service has not been enabled on this
The load library that the operating system provides to system.
obtain the cluster name is not valid. A possible cause
is an out-of-date load library which does not contain System action
the proper routines this product expects.
Processing ends.
System action
User response
Processing ends.
Enable the cluster service on the system.

104 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1481E The CLUSTERNODE option is not System action
supported on this system. None.

Explanation
User response
This option is not supported on this system. None.

System action ANS1487E An error occurred while backing

up the WMI repository. The
Processing ends. database will not be backed up.

User response Explanation

Disable the CLUSTERNODE option in the local options The Windows event log and error log might contain
file. additional information related to this error.
ANS1482E An unexpected error (retcode)
occurred while the program was System action
trying to obtain the cluster name processing stops.
from the system.

User response
Explanation
Examine the Windows event log and error log for
An unknown error occurred while the program was messages related to WMI. Ensure that the Windows
trying to obtain the cluster name from the cluster Management Instrumentation service is started.
service. The error code is the reason code provided
directly from the cluster service being used in this ANS1489E The WMI service failed to stop. No
operating system environment. files will be restored.

System action Explanation

Processing ends. An error occurred while stopping the Windows
Management Instrumentation (WMI) service. The
User response database will not be restored.

Consult the documentation for your clustering

System action
software for an explanation of the reason code. Insure
that your clustering service is operational, then try the processing stops.
IBM Spectrum Protect operation again.
ANS1483I Schedule log pruning started. User response
Examine the Windows event log and client error log for
Explanation messages related to Windows Management
Instrumentation (WMI). You might need to quiesce
The schedule log pruning function has begun. WMI activity or reboot the machine in order to free
resources which are preventing the WMI service from
System action stopping.
The schedule log is pruned. ANS1490W File specification 'file-spec'
ignored. A file list has already
User response been specified.
None.
Explanation
ANS1484I Schedule log pruning finished
successfully. A non-option argument (file specification) was
encountered after the -FILELIST has been processed.
Explanation
System action
The schedule log pruning function completed with no
errors. The argument is ignored.

Chapter 2. ANS 0000-9999 messages 105

User response User response
You may have either a -FILELIST or explicit file Set the option FOLLOWSYMBOLIC to YES in the user
specifications on this command, but not both. options file. Retry the operation.
ANS1492S Invalid virtual mountpoint ANS1495S Invalid virtual mountpoint
file_space_name: File not found. file_space_name: Other error, rc =
return_code.
Explanation
Explanation
The specified VIRTUALMOUNTPOINT option in the
system options file is invalid because it could not be The specified VIRTUALMOUNTPOINT option in the
found in the file system. system options file is invalid.

System action System action

The process attempts to continue the current The process attempts to continue the current
operation. operation.

User response User response

Check the virtual mountpoint in the system options file Make sure the virtual mountpoint is a directory and
and make sure it exists in the file system. Retry the accessible from the shell, and retry the operation.
operation.
ANS1496W Duplicate include/exclude option
ANS1493S Invalid virtual mountpoint 'option file-name' found while
file_space_name: Access denied. processing the client options file.
This might produce unexpected
Explanation results.

The specified VIRTUALMOUNTPOINT option in the

Explanation
system options file is invalid because access to it is
denied. IBM Spectrum Protect found a duplicate statement
while processing the client options file, which might
System action produce unexpected results.

The process attempts to continue the current

System action
operation.
Processing continues.
User response
User response
Check the valule of the VIRTUALMOUNTPOINT option
in the system options file and make sure that the Verify if you obtained the desired results. If not, you
virtual mount point is accessible. Retry the operation. need to correct the client options file by removing the
duplicate option statement.
ANS1494S Invalid virtual mountpoint
file_space_name: Symbolic link. ANS1497W Duplicate include/exclude option
'option file-name' found while
Explanation processing the client options
passed by the server.
The specified VIRTUALMOUNTPOINT option in the This might produce unexpected
system options file is invalid because it is a symbolic results.
link and the FOLLOWSYMBOLIC option is not set.
Explanation
System action
IBM Spectrum Protect found a duplicate statement
The process attempts to continue the current while processing the client options by the server,
operation. which might produce unexpected results.

106 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing continues. Reinstall the product.
ANS1501E The dsmtca execution/owner
User response permissions are invalid
Verify if you obtained the desired results. If not, you
need to correct either the client options file or the Explanation
client options passed by the server.
The dsmtca execution/owner permissions are invalid.
ANS1498E The IIS services failed to stop. No
files will be restored. System action
IBM Spectrum Protect ends.
Explanation
An error occurred while stopping the Internet User response
Information Services (IIS) services. The metabase will
not be restored. Have your system administrator check the installation
instructions for the client to ensure that the dsmtca
permissions are set correctly.
System action
ANS1502E Access to run the the dsmtca or
processing stops.
dsmenc module is denied.
User response
Explanation
Examine the Windows event log and client error log for
messages related to Internet Information Services The user of the backup-archive client does not have
(IIS). You might need to quiesce IIS activity or reboot permission to run the dsmtca or dsmenc module.
the machine in order to free resources which are
preventing the IIS service from stopping. System action

ANS1499E Creation of table of contents Processing ends.

failed.
User response
Explanation See your system administrator.
A failure occurred on the server during creation of the ANS1503E Valid password not available for
table of contents. server 'server-name'.
The administrator for your system
System action must run the backup-archive
The table of contents was not created. client and enter the password to
store it locally.
User response
Explanation
This abort code indicates there was a problem creating
The file containing the stored password for the
a table of contents on the server. The sysadmin will
specified server server-name is unavailable.
need to consult the activity log on the server to
determine the cause.
System action
ANS1500E The dsmtca module is not found in
the installation directory. Processing ends.

Explanation User response

IBM Spectrum Protect cannot find the dsmtca module The administrator for your system must set and store a
in the appropriate directory. new password.
ANS1504E Error starting the dsmtca or
System action dsmenc process.
Processing ends.

Chapter 2. ANS 0000-9999 messages 107

Explanation ANS1507E This action requires IBM Spectrum
Protect administrative authority
An error has occurred starting the dsmtca or dsmenc
on this system.
process; specifically, the fork() function has failed.

Explanation
System action
An activity has been attempted that must be
Processing ends.
performed by the IBM Spectrum Protect administrator
(for example, open registration, file space delete or
User response password update).
Probable system error. If the problem persists, restart
the workstation. System action
ANS1505W Performing image backup of the Processing ends.
entire volume for volume name.
The IMAGEGAPSIZE option value User response
of image gap size is being ignored
as this level of the operating If the activity is required, the administrator for this
system does not support used system must perform it.
block image backup. Please ANS1508E Error allocating semaphores.
upgrade to AIX 5.3 Maintenance
Level 7 or later in order to perform
Explanation
used block image backup.
An error has occurred because the semaphores you
Explanation are attempting to allocate have become insufficient.

AIX 5.3 Maintenance Level 7 or later has some

System action
necessary fixes that are required to support used
block image backup. Processing ends.

System action User response

The entire volume is backed up. Ask your system administrator for assistance, and
possibly increase the number of semaphores in your
User response system.

Please upgrade to AIX 5.3 Maintenance Level 7 or ANS1509E Error setting semaphore value or
later in order to perform used block image backup. waiting on semaphore.
ANS1506E The IBM Spectrum Protect dsmtca
Explanation
received an invalid request.
An error has occurred while attempting to set or wait
Explanation on a semaphore.

The dsmtca or dsmenc process was invoked by the

System action
backup-archive client and received an unknown
request argument in the call. Processing ends.

System action User response

Processing ends. Probable system error. If the problem persists, restart
the workstation.
User response ANS1510W The specified backupset either
It is possible that the dsmtca or dsmenc process was does not exist, or does not contain
mistakenly invoked by a process other than the file data.
backup-archive client. If that is not the case, then this
is an internal error. If the problem recurs, contact your
IBM service representative.

108 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation The specific corrective actions will depend on the
specific errors encountered.
The specified backupset either does not exist, or does
not contain file data for the node name specified. The For more information about return codes, search for
restore backupset command is limited to backupsets "client return codes" in the product information
that contain file data. To restore an image backup from (www.ibm.com/support/knowledgecenter/SSGSG7/).
a backupset, use the restore image command.
ANS1513E The object 'object_name' is
skipped from rename.
System action Error_condition.
Processing stopped.
Explanation
User response IBM Spectrum Protect skips the specified object from
If an incorrect backupset name was specified, try the renaming because the object with the same long name
command again with the correct backupset name. If but with different attributes exists on the server.
you are trying to restore an image from a backupset,
refer to the restore image command for the correct System action
syntax.
The backup operation continues. The specified object
ANS1511I Invalid Restore session number will expire during the next incremental backup.
entered.
Try again. User response
The object is skipped if one of the following condition
Explanation
occurs:
You entered a number not shown in the list of
The long name object(LN) has a more recent insert
restartable restores. The number you entered is either
date than the short name object(SN).
less than one or greater than the highest item number
displayed. The management classes for LN and SN do not
match.
The copy groups for LN and SN do not match.
System action
LN and SN have different owners.
Client prompts for a valid selection. The creation date for LN and SN do not match.
The short name attribute for LN does not match SN.
User response
If you are unable to determine what is wrong, report
Enter a number from the list or 'Q' to quit. the problem to your service representative.
ANS1512E Scheduled event 'event' failed. ANS1514W Encryption key passwords are not
Return code = value. the same.

Explanation Explanation
One or more error conditions were encountered that The key passwords are different.
prevented the schedule from completing successfully.
This message is preceded by other messages that System action
indicate the specific problems encountered during the
operation. The process allows you to try again.

System action User response

Scheduled event failed. Enter the correct password.
ANS1515E Loading a table of contents failed.
User response
Check the schedule and error log files for the Explanation
messages that specify what problems were
A failure occurred on the server during loading of the
encountered during the operation. Correct the
table of contents.
conditions that caused those messages to be issued.

Chapter 2. ANS 0000-9999 messages 109

System action System action
The table of contents was not loaded. Processing terminates.

User response User response

This abort code indicates there was a problem loading Set the DSM_LOG (or DSMI_LOG) environment
a table of contents on the server. The sysadmin will variable to a directory with adequate space to write
need to consult the activity log on the server to the log data.
determine the cause.
ANS1523E An error occurred while
ANS1519E Your node does not have connecting to TSA/SMDR service.
permission to delete backup files
Explanation
Explanation
An error was encountered during a call to the TSA/
The server does not allow your node to delete backup SMDR service. This message usually follows previous
files. messages that contain more specific information
about the problem.
System action
System action
The process did not delete the backup files.
Processing stopped.
User response
User response
See your system administrator.
Refer to previous messages in dsmerror.log for further
ANS1520E Failure writing to the IBM information. If those messages are not helpful in
Spectrum Protect error log: errno identifying the cause of the problem, see your system
= errno-value, administrator for further assistance.

Explanation ANS1528I The process is converting the log-

file from continuous (pruning)
A failure was encountered when writing to the mode to wrapping mode. This
dsmerror log or dsierror log. The system set the error process may take several minutes.
code errno-value. It is possible that no space is
available at the given log location.
Explanation

System action The log-file was previously in continuous mode where

the only size control was through the use of the
Processing terminates. ERRORLOGRETENTION or SCHEDLOGRETENTION
option. This is the first occasion where the
User response ERRORLOGMAX or SCHEDLOGMAX option is specified for
this log, so its format must be changed and old data
Set the DSM_LOG (or DSMI_LOG) environment
saved.
variable to a directory with adequate space to write
the log data.
System action
ANS1521E Failure writing to a IBM Spectrum
Protect log or log-related file: file- Transition processing continues.
name, errno = errno-value, reason
User response
Explanation None.
A failure was encountered when writing to one of the ANS1529I The process is converting the log-
log files or a related file named file-name. The system file from wrapping mode to
set the error code errno-value. reason is the system continuous (pruning) mode. This
explanation of that error code. Among other things, it process may take several minutes.
is possible that no space is available at the given log
location.

110 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The log-file was previously in wrapping mode where The IBM Spectrum Protect operation ends.
the size control was through the use of the
ERRORLOGMAX or SCHEDLOGMAX option. This is the User response
first occasion where the ERRORLOGMAX or
SCHEDLOGMAX option is not specified for this log, so its The IBM Spectrum Protect server administrator must
format must be changed and old data saved. unlock the node before you can access it. Try the
operation later, or check with your IBM Spectrum
Protect administrator.
System action
ANS1534E Proxy Rejected: The IBM Spectrum
Transition processing continues.
Protect server has run out of
memory.
User response
None. Explanation
ANS1530I count log records processed. There is not enough memory available to allow this
operation to continue.
Explanation
System action
This is just a progress report to let you know the
process is still ongoing. Current operation has been cancelled.

System action User response

Transition processing continues. Try the operation again. If the problem continues, see
your system administrator to increase the amount of
User response memory of the server.

None. ANS1535E Proxy Rejected: The ASNODENAME

and NODENAME options have the
ANS1532E Proxy Rejected: Proxy authority same value.
has not been granted to this node.
Explanation
Explanation
The ASNODENAME and NODENAME options cannot have
The node has not been granted proxy authority to the same value.
access the node named by the ASNODENAME option.
The IBM Spectrum Protect administrator must first
System action
grant proxy authority.
The current operation is cancelled.
System action
User response
The IBM Spectrum Protect operation ends.
Use the ASNODENAME option only to access another
User response node. It is not necessary to set the ASNODENAME
option to access your own node. Remove the
The IBM Spectrum Protect server administrator must ASNODENAME option from your option file unless you
grant proxy authority for this node. See the are actually trying to access a node that you have been
administrator command "Grant Proxynode". granted authority to access with the administrative
ANS1533E Proxy Rejected: The node name command "Grant Proxynode".
you specified in the ASNODENAME ANS1536E Proxy Rejected: The server has an
option is locked. internal error.

Explanation Explanation
The IBM Spectrum Protect administrator has locked The client cannot proxy to the node named by the
the node you specified as the ASNODENAME option. ASNODENAME option because of an internal server
error.

Chapter 2. ANS 0000-9999 messages 111

System action Explanation
Current operation has been cancelled. The client option 'VMTAGDATAMOVER' must be set to
YES so that IBM categories and tags can be applied to
User response virtual machines. The active data mover is not a tag
enabled data mover.
See your system administrator immediately.
ANS1537E The ASNODENAME option is not System action
valid with the FROMNODE option. The data mover operation stops.

Explanation User response

None. Enable tag support on this data mover by setting the
'VMTAGDATAMOVER' option to 'YES' then retry the
System action operation.
Processing stops. ANS1541E The operation requires a tag
enabled data mover.
User response
Remove the ASNODENAME option from the options Explanation
file or do not use the FROMNODE option. The client option 'VMTAGDATAMOVER' must be set to
ANS1538E The operation that is being YES so that IBM categories and tags can be applied to
attempted cannot be invoked virtual machines. The active data mover is not a tag
using the ASNODENAME option. enabled data mover.

Explanation System action

None. The data mover operation stops.

System action User response

Processing stops. Enable tag support on this data mover by setting the
'VMTAGDATAMOVER' option to 'YES' then retry the
operation.
User response
ANS1544E An error in WAS processing has
Remove the ASNODENAME option and retry the
occurred.
operation.
ANS1539E The ASNODENAME option cannot Explanation
be used with the CLUSTERNODE
option. None.

Explanation System action

None. None

System action User response

Processing stops. Run the following command to see the nodes that can
be backed up:
dsmc query was -wastype=local
User response Make sure the results are correct for your
Remove the ASNODENAME option and retry the environment, then try the operation again. If the
operation. problem persists, contact IBM Spectrum Protect
technical support for further assistance.
ANS1540E The option 'option-name' requires
a tag enabled data mover. ANS1545W IT22692: logical file sizes don't
match: (migrated)

112 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 migrated_file_size != (local) Explanation
local_file_size for (file_path)
None.

Explanation
System action
The dsmreconcile command is run in APAR IT22692
The unlock of the WebSphere Configuration Repository
issue detection mode ('testflag
fails.
HSM_IT22692_DETECTION' specified in the dsm.opt).
In this mode, this warning message is reported for
each file that was potentially affected by APAR User response
IT22692 issue. Make sure that the WebSphere server is running. If the
repository is locked, then unlock it and try the
System action operation again. Ensure that the correct node is being
backed up. To see a list of available nodes that can be
The reconciliation processing proceeds with next
backed up, run: 'dsmc q was -wastype=local'.
object.
ANS1548E A supported version of WebSphere
User response is not installed on this machine.

Wait till the reconciliation processing completes, then

Explanation
run the following corrective actions for each file
identified by this warning: - if there is backup copy, A supported version of WebSphere is not installed on
restore the backup copy overwriting the affected file: this machine. The only version of WebSphere that is
root> dsmc restore /affected_file -repl=yes - if there is supported is 5.0.x.
no backup copy, unlink the affected file(s) and restore
appropriate stub(s) using the dsmmigundelete System action
command: root> rm /affected_file1 /affected_file2 /
affected_file_n root> dsmmigundelete /HSM_fs - to None
make sure the rest of the premigrated files won't
eventually contain file data corrupted by IT22692, re- User response
stub all existing premigrated files: root> dsmmigrate -
Install WebSphere 5.0 on the machine.
stubpremigrated -R /HSM_fs
ANS1549E No application server instances
ANS1546W IBM Spectrum Protect failed to
were found. Unable to perform
lock the WebSphere configuration
backup.
repository.

Explanation
Explanation
The application server is not installed on this machine.
None.

System action
System action
Backup is not performed.
The lock of the WebSphere configuration repository
fails.
User response
User response Install the application server.
Ensure that the WebSphere server is running. If the ANS1550E No network deployment manager
server is already running, ensure that the repository is instances were found to back up.
unlocked. Ensure that you are backing up the correct
node. To see a list of available nodes that can be
Explanation
backed up, enter: 'dsmc q was -wastype=local'.
Deployment manager is not installed on this machine.
ANS1547W IBM Spectrum Protect failed to
unlock the WebSphere
System action
Configuration Repository.
Back up is not performed.

Chapter 2. ANS 0000-9999 messages 113

User response • Try a backup. If the backup performs a failover, and
there is a incorrect password message in the error
Install the network deployment manager.
log, then the password that was entered is incorrect.
ANS1553W The user name and password that • Start the WAS server and rerun the set password
have been provided to Data command. Since the server is now up, validation will
Protection for WebSphere are be performed as normal and the user notified if a
invalid. good/bad password was entered.
ANS1560W The WebSphere server is not
Explanation
running.
None.
Explanation
System action
The WebSphere server is not running. The WAS server
Data Protection for WebSphere cannot run. is running for backup operations.

User response System action

Run the dsmc set WASPassword command to set the The WebSphere server is not running.
WebSphere security user name and password.
ANS1556E Setting the WAS user and User response
password failed. Start the WAS server and run the backup again.

Explanation ANS1562E WAS Restore failed during EAR

Expansion.
Password validation for the WAS user and password
failed. Explanation
EAR Expansion is performed for a WebSphere
System action
Application server after the files have been restored.
WAS password validation fails.
System action
User response
WAS restore fails.
Rerun the set WASPassword command with the
correct values for user and password. User response
ANS1557W The WAS Server was not running, Run the restore again.
and the password file was saved
without validation. ANS1565E No WebSphere EARExpander was
found. Copy the EARExpander tool
Explanation from the base WebSphere bin
directory to the instance bin
If the WAS server is down, then it is not possible to directory, then run the restore
connect to the server and validate the user-entered operation again.
password. The password has still been saved, but no
validation has been performed. Explanation

System action The EAR files are expanded for an instance of an

Application server and the EARExpander tool does not
The set WAS password command did not validate the exist in the instance bin directory.
password. The password has still been saved, but no
validation has been performed. The password may be System action
incorrect.
No WebSphere EARExpander found.
User response
User response
There are two options:
Copy the WAS EARExpander tool from the base
install's bin directory to the bin directory of the

114 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
instance. Then run the WAS restore operation again, Explanation
after the EARExpander tool has been copied.
The client acceptor sent the port and address
ANS1566E The version of WebSphere on the information to the server, however, there was a
machine does not match the problem registering the information with the server.
version of WebSphere that was The problem occurred because the server detected
backed up. These versions must that the address provided resolved to the loopback
match for a WAS restore address.
operation.
System action
Explanation The server did not register the information for the
The version of WebSphere on the machine does not client acceptor. client acceptor processing will
match the version of WebSphere that was backed up. continue, but some functions of the client acceptor
These versions must match for a WAS restore may not be working properly.
operation.
User response
System action Use TCPCADADDRESS in the client option file to
The WAS restore operation fails. indicate the proper TCP/IP address for this client
acceptor. Loopback address is not valid.
User response ANS1570E Registering this instance of the
Install the correct version of WebSphere on the client acceptor with the server
machine before performing the restore operation. failed. The client acceptor process
continues.
ANS1568E The client acceptor attempted to
register it's tcpport and tcpip Explanation
address without using the
TCPCADADDRESS option. The client acceptor failed to register address
information to the server due to an error.The message
Explanation immediately preceding this message should indicate
the problem more precisely.
The client acceptor sent the port and address
information to the server, however, there was a System action
problem registering the information with the server.
The problem occurred because no default value for the The server did not register the information for the
tcpip address was provided. The server was unable to client acceptor. client acceptor processing continues,
determine a default value for the tcpip address but some functions of the client acceptor might not
because the communication method was not tcpip. work properly.

System action User response

The server cannot register the information for the Review the messages immediately preceding this
client acceptor. client acceptor processing will message to help determine what error occurred.
continue, but some functions of the client acceptor
ANS1571E The time-option option cannot be
may not be working properly.
used without specifying the date-
option option
User response
Use TCPCADADDRESS in the client option file to Explanation
indicate the proper TCP/IP address for this client
If the to/from/pit time options is specified then the
acceptor.
corresponding to/from/pit date MUST also be
ANS1569E The client acceptor attempted to specified.
register it's tcpport and tcpip
address but the TCP/IP address System action
resolved to the loopback address
and was rejected by the server. Processing stopped.

Chapter 2. ANS 0000-9999 messages 115

User response System action
Either remove the to/from/pit time option or add the Journal backup processing is interrupted.
corresponding to/from/pit date option.
ANS1572E An unexpected error was received User response
from the server query, RC=re Retry the backup, check the journal daemon errorlog
tcode. for the cause of the failure. Backup of other file
systems in the domain will continue.
Explanation
ANS1575E Journal Daemon Communications
An unexpected error was received by the client. This Error.
could be caused by network problems or a
programming error. Explanation
An error occurred communicating with the journal
System action
daemon.
Current operation has been cancelled.
System action
User response
Journal backup processing is interrupted.
Verify that your communication path is functioning
properly and try the operation again. If the problem User response
persists, contact your IBM Spectrum Protect
administrator for further assistance. Retry the backup, check the journal daemon and client
errorlogs for the cause of the failure.
ANS1573E FROMDATE and TODATE cannot be
used with PITDATE. ANS1577I The Windows console event
handler received a 'event' console
event.
Explanation
The PITDATE option specifies different and conflicting Explanation
date selection criteria from the FROMDATE and
TODATE options. Therefore these options cannot be A console event was received by one of the IBM
combined. Spectrum Protect processes or programs. The
following events can be received:
System action • Ctrl-C - This indicates either the user entered the
ctrl-c sequence or that one of the Windows services
The restore operation is not performed.
was stopped.

User response
System action
Determine whether you require the functionality of
None.
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 User response
you want to restore files from a given range of dates, None.
use FROMDATE, TODATE, FROMTIME, and TOTIME.
Refer to the IBM Spectrum Protect client manual for ANS1578E The specified path 'path' is not
your operating system for additional information about valid for backup or archive.
these options.
Explanation
ANS1574E Journal Query Failed.
The specified path is a special file system or part of a
Explanation special file system. Special file systems contain
dynamic information generated by the operating
The journal daemon was unable to process the system and should not be backed up or archived. Refer
requested journal query. to the IBM Spectrum Protect client manual for a
complete list of special file systems for your operating
system.

116 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Processing continues if there are other file systems to This is a system file restored and could not be
back up. immediately replaced. The file will be replaced during
the next reboot of the operating system. It is
User response important to note that until the reboot occurs, the
changes will not be in effect.
Do not specify special file systems for backup or
archive.
System action
ANS1579E GSKit function func-name failed The client restored the file with a temporary name,
with error-code: session and instructed the operating system to replace the
original file with the restored file during the next boot
Explanation of the operating system.
A GSKit function has failed with the specified error
code. User response
Reboot the machine as soon as possible after the
System action restore operation ends.
Processing stopped ANS1582E The web client is no longer
supported when connecting to
User response IBM Spectrum Protect V7.1.8 or
V8.1.2 and later servers.
Make sure you have configured the key database for
SSL communication as described in the
documentation. Possible issues could be failure in TLS Explanation
handshake due to client and server not agreeing on a The web client functionality is no longer supported and
protocol. If the problem persists, contact IBM is unavailable for connecting to IBM Spectrum Protect
Spectrum Protect customer support. V7.1.8 or V8.1.2 and later servers.
ANS1580W An Include.Fs statement with
performance algorithm set already System action
exists for the drive specified. Do Processing stopped
you want to replace the
statement?
User response
Explanation Use one of the other supported client interfaces to
perform your IBM Spectrum Protect operations. Refer
The user tried to create a duplicate Include.Fs entry on to IBM Spectrum Protect documentation for
a drive that already has a performance algorithm information on the supported client interfaces.
associated with it. This is applicable to the Preference
Editor on the MFC GUI ANS1583E The Hardware Utility plug-in
module was not found or could not
System action be loaded.

The user can replace the statement with the new one
Explanation
or they can cancel out of this operation
Processing stops.
User response
System action
The user is prompted to replace the statement with
the new one or they can say No to cancel out of this None.
operation.
ANS1581W 'object-name' was restored as User response
'temp-name'. A reboot is required Run the "dsmc show plugins" command at the
to complete the restore. 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 plug-in path is
available and the Hardware Utility plug-in,

Chapter 2. ANS 0000-9999 messages 117

libPiHDW.a, is present, ensure that the LIBPATH again. If the problem persists, contact IBM technical
variable is set to the Hardware product's library path. support for further assistance.
For example, LIBPTH=/usr/opt/db2_08_01/lib.
ANS1588W I/O error reading file attribute:
ANS1584E Error loading system library attr-name for: file-name. errno =
'libdevmapper.so' required for errno-value,
image operations for LVM2
volumes. Explanation
The attribute attr-name of the file file-name could not
Explanation
be retrieved. The system set the error code errno-
The system library libdevmapper.so required for LVM2 value. If the reason given is "access denied," the
image operations could not be loaded. This error can current user does not have permission to read the file
occur when the library does not exist on the system, or attributes.
the library is an earlier level than is required. This error
also occurs when the library can not be opened by the System action
IBM Spectrum Protect clienti process.
Processing continues without backing up the specified
file attribute.
System action
The image operations for LVM2 volumes are not User response
available.
Correct the condition causing the physical error.
User response ANS1589W Unable to write extended
Check the installed packages and the library versions attributes for object-full-name due
on the system. If correct versions are installed, check to errno: errno-value, reason:
for access related issues. If the system does not have errno-explanation
these libraries installed, contact your Linux OS
distributer. Also, refer to Technote 1452629: https:// Explanation
www.ibm.com/support/docview.wss? The extended attributes of the object could not be
uid=swg21452629 written. The system set the error code errno-value and
ANS1587W Unable to read extended the reason errno-explanation. If the reason is either
attributes for object object-full- "access denied" or "permission denied", the current
name due to errno: errno-value, user does not have permission to write the extended
reason: errno-explanation attributes of the object.

Explanation System action

The extended attributes of the object could not be Processing continues without restoring the extended
read. The system set the error code errno-value and attributes.
the reason errno-explanation. If the reason errno-
explanation is either "access denied" or "permission User response
denied", the current user does not have permission to
The error is expected if the operation tries to write
read the extended attributes of the object.
extended attributes to an object that you do not own
or do not have access to. If the reason indicates an
System action input/output error, perform the file system
The object is skipped. Processing continues with the consistency check procedure and retry the operation.
next object. If the problem persists, contact IBM technical support
for further assistance.
User response ANS1590W I/O error writing file attribute:
The error is expected if the operation tries to read attr-name for: file-name. errno =
extended attributes of an object that you do not own errno-value,
or do not have access to. If the reason indicates an
input/output error, perform the file system Explanation
consistency check procedure and try the operation The attribute attr-name of the file file-name could not
be set. The system set the error code errno-value. If

118 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
the reason given is "access denied," the current user Explanation
does not have permission to set the file attributes.
The client was unable to open the certificate key
database using the stored password, or the stored
System action password could not be read.
Processing continues without restoring the specified
file attribute. System action
Processing stops.
User response
Correct the condition causing the physical error. User response
ANS1592E Failed to initialize SSL protocol. Make sure that you configure the key database for SSL
communication as described in the Client Installation
Explanation and User's Guide. Also make sure that the stash file,
dsmcert.sth, is readable by the current user.
The process was unable to initialize the SSL protocol.
This could be because the node is in a strict ANS1595E Bad server certificate.
'sessionsecurity' state and the client certificate key
database could not be found. Explanation
The process was unable to open SSL connection to
System action server because of a bad certificate. This error usually
Processing stopped occurs when the server certificate cannot be verified
by the client.
User response
System action
Check for GSKit related messages in the error log.
Make sure you have configured the key database for Processing stopped
SSL communication as described in the
documentation. You must manually import the client User response
certificate by using the dsmcert utility. If the problem
Make sure you have configured the key database for
persists, contact IBM Spectrum Protect customer
SSL communication as described in the
support.
documentation. Make sure to import the correct
ANS1593E Cannot open the key database. certificate from the IBM Spectrum Protect server you
are trying to connect to.
Explanation ANS1596E SSL protocol is not supported.
The process was unable to open the keyfile that is
expected to contain the server certificate for SSL Explanation
communications.
SSL protocol is not supported on this platform.

System action
System action
Processing stopped
Processing stopped

User response
User response
Make sure you have configured the key database for
Refer to IBM Spectrum Protect documentation for the
SSL communication as described in the
list of supported platforms.
documentation. If the problem persists, contact IBM
Spectrum Protect customer support. ANS1597E The -pick and -deltype=all options
are not valid together.
ANS1594E The key database password is
incorrect or unavailable.
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.

Chapter 2. ANS 0000-9999 messages 119

System action problem persists, contact IBM Spectrum Protect
customer support.
Processing stopped.
ANS1600E Unable to load the Data Protection
User response for Lotus Domino library.

Try the operation again with a valid combination of

Explanation
options.
If you want to delete an entire tree, use -deltype=all, The Datt Protection for Lotus Domino library could not
but do not use -pick. be loaded.
If you want to select which backup versions to delete,
specify -deltype=active or -deltype=inactive, and use System action
the -pick option. Also use -subdir=yes if you want the
file selection to include files in subdirectories of the Processing ends.
file specification.
See the client manual or command line help for User response
additional information.
Ensure that Domino plugin is properly configured and
ANS1598E -deltype=all is not valid for this file check the error log on the client machine for more
specification. information.
ANS1601E The Domino plugin operation
Explanation failed because of an internal error.
-deltype=all is used to delete an entire directory tree.
You must specify a fully wildcard directory when using Explanation
-deltype=all.
A Domino plugin internal error has occurred.
System action
System action
Processing stopped.
Processing ends.
User response
User response
Try the operation again with a valid combination of
options. Check the error log on the client machine for more
If you want to delete all backup versions of an entire information.
directory tree, use -deltype=all and a fully wildcarded ANS1602E The Domino plugin operation
file specification. failed because the preferences file
If you want to delete backup versions of partially was not found.
qualified file names, use -deltype=inactive or -
deltype=active. Also use -subdir=yes if you want to
Explanation
delete backup versions in subdirectories of the file
specification. The Data Protection for Lotus Domino preference file
See the client manual or command line help for could not be found.
additional information.
System action
ANS1599E Cannot load SSL runtime library.
Processing ends.
Explanation
User response
IBM Spectrum Protect failed to dynamically load SSL
runtime library necessary for SSL protocol The Data Protection for Lotus for Domino configuration
file (default name domdsm.cfg) could not be found.
System action Check the error log on the client machine for more
information.
Processing stopped
ANS1603E The Domino plugin operation
User response failed because of an internal
TCP/IP error.
Make sure IBM Spectrum Protect client is properly
installed. Try to reinstall the client software. If the

120 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
A TCP/IP error has occurred. The dsmdomp address space could not be started.

System action System action

Processing ends. Data Protection for Domino processing stops.

User response User response

Check the error log on the client machine for more The dsmdomp address space failed during its
information. initialization. This is likely to be an installation error.
Ensure that the lotus/bin directory has a symbolic link
ANS1604E The Domino plugin operation to the tools directory for dsmdomp and the lotus/notes
failed trying to start the dsmdomp directory has a symbolic link to the dsmdomp
address space. executable. Examine the file /tmp/dsmdomp* for more
information. If the problem persists, contact your
Explanation System Administrator for further assistance.
The dsmdomp address space could not be started. ANS1607E A plugin found in the plugins
This is probably an installation error. library is not supported by the
current level of the IBM Spectrum
System action Protect client.
Processing ends.
Explanation
User response The plugin is not loaded, and processing continues.
Ensure that the lotus/bin directory has a symbolic link
to the tools directory for dsmdomp and the lotus/notes System action
directory has a symbolic link to the dsmdomp The plugin is not loaded, and processing continues.
executable. If the problem persists, contact your
System Administrator for further assistance.
User response
ANS1605E The Domino plugin operation This probably is an installation error. Ensure that the
failed while initializing plugins directory contains valid plugin libraries, and
communications with the that the correct level of the IBM Spectrum Protect
dsmdomp address space. client has been installed. If the problem persists,
contact your System Administrator for further
Explanation assistance.
The Domino plugin communication initialization failed. ANS1608E Domino plugin operation failed
with the following message:
System action messsage
Processing ends.
Explanation
User response A Domino plugin operation error occurred.
The dsmdomp address space failed during its
initialization. This is likely to be an installation error. System action
Ensure that the lotus/bin directory has a symbolic link Processing ends.
to the tools directory for dsmdomp and the lotus/notes
directory has a symbolic link to the dsmdomp
User response
executable. If the problem persists, contact your
System Administrator for further assistance. Correct the error that caused the operation to fail.
ANS1606E The Domino plugin operation ANS1609E Domino plugin process failed. The
failed while starting up the following messages are associated
dsmdomp address space. with the error.
messsage.

Chapter 2. ANS 0000-9999 messages 121

Explanation ANS1614E The Domino plugin 'Try and Buy'
license has expired.
A Domino plugin operation error occurred.

Explanation
System action
The 'Try and Buy' license that was detected has
Processing ends.
expired.

User response
System action
Correct the error that caused the operation to fail.
Processing ends.
ANS1611E A plugin operation failed because
of an internal error. User response
This product is no longer valid for use. A valid license
Explanation
must be obtained before running the product.
A plugin internal error has occurred.
ANS1615E The Domino plugin operation
failed due to a license error.
System action
The plugin operation stops. Explanation
Domino plugin license verification failed.
User response
If the error persists, run with tracing enabled and System action
contact your System Administrator and IBM for further
Processing ends.
assistance.
ANS1612E The Domino plugin operation User response
failed because of a IBM Spectrum
Protect API error. Check the error log for further information.
ANS1616E The Domino plugin operation
Explanation failed because the Lotus Domino
An IBM Spectrum Protect API error occurred . API could not be loaded.

Explanation
System action
The Lotus Domino API could not be loaded.
Processing ends.

System action
User response
Processing ends.
Check error log on the client machine for more
information.
User response
ANS1613E >Could not load the IBM Spectrum
Protect API. Ensure the Lotus Domino Server is installed correctly.
ANS1617E The Domino plugin operation
Explanation failed because of a Data
The IBM Spectrum Protect API could not be loaded. Protection for Domino API error.

Explanation
System action
A Data Protection for Domino API error occurred
Processing ends.
during a Domino plugin operation.

User response
System action
Check error log on the client machine for more
Processing ends.
information.

122 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
For more details, view the following IBM Spectrum The process failed to update attributes for the named
Protect error logs. backup object on the server. The server may not
reflect correct state of the backup.
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 System action
Domino installation directory. Processing continues.
The backup-archive client error log (dsmerror.log), the
web client error log (dsmwebcl.log), and the log of User response
scheduler activite (dsmsched.log). The default location
Check preceding error messages in error log for more
of these logs is the backup-archive installation
information. Retry the operation. If problem continues,
directory.
contact your IBM Spectrum Protect administrator.
ANS1618E A Domino plugin operation is
ANS1622I Number of backup objects cleaned
already in progress. Please wait
up on server: 'number' number of
for operation to complete.
local snapshot resources made
available :'number'.
Explanation
A Domino plugin operation is in progress. Explanation
While performing consistency check for server's
System action database and the local repository maintained on the
The Domino plugin operation stops. client system, reported inconsistencies were found.
Inconsistent backups cannot be restored, therefore
IBM Spectrum Protect deletes all inconsistent backup
User response
objects and frees the space occupied in the local
Please wait for the Domino plugin operation to repository.
complete before starting a new Domino plugin
operation. System action
ANS1619E The IBM Spectrum Protect Processing continues.
application client cannot work
with the version of the Domino User response
plugin you have installed.
Check error log for further details on which objects on
Explanation server were deleted. If numbers look unusually high
check your configuration and if it continues, contact
The version of the Domino plugin currently installed on your IBM Spectrum Protect administrator.
the system is older than the version used to build the
IBM Spectrum Protect application client. ANS1623W Backup of NSF Db2 database was
skipped. NSF Db2 databases not
supported.
System action
Processing ends. Explanation
This version of DP for Domino plugin does not support
User response
NSF Db2 databases.
Install a version of the Domino plugin at or later than
the level of the IBM Spectrum Protect application System action
client.
Backup of NSF Db2 databases is skipped.
ANS1621E Failed to update backup attributes
on server for local backup for User response
'file_space_namepath_namefile_na
me', object id - Exclude NSF Db2 databases from backup.
'object_id':'object_id' return code
'return_code'.

Chapter 2. ANS 0000-9999 messages 123

ANS1624E 'value' is an invalid value for ANS1647E 'input spec': Invalid input
option 'option' for 'command' specification format.
command
Explanation
Explanation
The specified input for this commmand is invalid.
The specified option value is not valid in this context.
System action
System action
The operation stops.
The operation was stopped
User response
User response
Verify that the syntax specified with the parameter is
Specify a valid value for the option. Consult correct.
documentation for valid values.
ANS1648W PREViewsize option value is
ANS1626E An unexpected error was greater than the specified stub
encountered when processing a size.
IBM Spectrum Protect operation
using a hardware or snapshot Explanation
function.
IBM Spectrum Protect function The PREViewsize CLI option value specified must not
name : function-name be greater than the stub size for the file.
IBM Spectrum Protect function :
function-desc System action
IBM Spectrum Protect return
Operation stopped. File skipped.
code : TSM-rc
IBM Spectrum Protect file : file-
name (line-number) User response
Change the value of the PREViewsize accordingly.
Explanation
ANS1649E The option 'specified-option' is
None. inconsistent with the option
'other-option'.
System action
Explanation
Processing stops.
The command failed because the the two options
User response cannot be used at the same time.

Contact the IBM Spectrum Protect administrator with

System action
the information provided in this message.
The command is stopped.
ANS1632I 'option name' not specified,
defaults to 'deafult value'
User response
Explanation Run the command and do not specify both options.
A value for the option is not spedified, default value wil ANS1650I Command: command-string
be used.
Explanation
System action
The command string listed in the message was issued
The operation continues using default value for the by the backup-archive client.
option
System action
User response
This message is for auditing purposes only.
To override the default, specify a valid value for the
option. Consult documentation for valid values.

124 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response ANS1655I Restored: fshlll
This message is for auditing purposes only.
Explanation
ANS1651I Backed Up: fshlll
The restore operation for the object was successful.
Explanation
System action
The backup operation for the object was successful.
This message is for auditing purposes only.
System action
User response
This message is for auditing purposes only.
This message is for auditing purposes only.
User response ANS1656I Retrieved: fshlll
This message is for auditing purposes only.
Explanation
ANS1652I Archived: fshlll
The retrieve operation for the object was successful.
Explanation
System action
The archive operation for the object was successful.
This message is for auditing purposes only.
System action
User response
This message is for auditing purposes only.
This message is for auditing purposes only.
User response ANS1657I Expired: fshlll
This message is for auditing purposes only.
Explanation
ANS1653I Updated: fshlll
The active version of the object was expired in the IBM
Spectrum Protect database.
Explanation
The update operation for the object was successful. System action
This message is for auditing purposes only.
System action
This message is for auditing purposes only. User response
This message is for auditing purposes only.
User response
ANS1658I Deleted: fshlll
This message is for auditing purposes only.
ANS1654E Failed: fshlll Explanation
The object was deleted from the IBM Spectrum
Explanation
Protect database.
The backup, archive, restore or retrieve
operation for the object failed. System action
This message is for auditing purposes only.
System action
This message is for auditing purposes only. User response
This message is for auditing purposes only.
User response
ANS1659I Skipped: fshlll
This message is for auditing purposes only. For
information about the failure refer to the backup-
archive Client error log.

Chapter 2. ANS 0000-9999 messages 125

Explanation Explanation
The object was skipped by the user during backup or Network Appliance strongly recommends that when
archive processing. the fractional reserve is set to less than 100 percent
you actively monitor space consumption and the rate
System action of change of data in the volume to ensure you do not
run out of space reserved for overwrites. In that case,
This message is for auditing purposes only. if you run out of overwrite reserve space, writes to the
active file system fail and the host application or
User response operating system might crash.
This message is for auditing purposes only.
System action
ANS1660I Excluded: fshlll
Process continues.
Explanation
User response
The object was excluded from backup or archive
processing. Ensure that you monitor the space consumption.
Consult Network Appliance for tools to monitor
available space in your volumes.
System action
ANS1664E The snap restore for volume
This message is for auditing purposes only.
volname with snapshot name
snapname would destroy later
User response snapshots that are required for
This message is for auditing purposes only. other applications or for volume
clones.
ANS1661I Unchanged: fshlll
Explanation
Explanation
ONTAP will delete newer snapshots of a volume when
The object has not changed since the last incremental a specific snapshot is used for snap restore.
backup was performed and does not need to be
resent. System action

System action Process stops.

This message is for auditing purposes only. User response

User response Prior to a snap restore, ensure that newer snapshots

are not used in other applications or in volume clones.
This message is for auditing purposes only.
ANS1665W IBM Spectrum Protect for ACS did
ANS1662I Agent Node: 'agent_node' Target not find any snapshots for volume
Node: 'target_node' volname on the N series filer.

Explanation Explanation
Proxy nodes information. No snapshots were found for this volume on the N
series filer.
System action
None System action
Process continues.
User response
None User response

ANS1663W None.
The option fractional reserve on
volume vol_name was reduced to
less than 100 percent.

126 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1666W IBM Spectrum Protect for ACS did Explanation
not find any information about the The command subcommand command is not
N series volume volname. supported on a currently running operating system.
You must reboot to Windows WinPE mode to run this
Explanation command.
The query for information about this volume did not
return any data. System action
The command is not processed.
System action
Process continues. User response
None.
User response
ANS1670E The file specification is not valid.
None. Specify a valid Network Appliance
ANS1667E The snapshot name snapname for or N-Series NFS (AIX, Linux) or
volume volname was not found in CIFS (Windows) volume.
the snapshot list on the N series
filer. Explanation
The file specification is not valid. Incremental backup
Explanation using snapshot difference using the -SNAPDIFF option
Snapshot identified by this name does not exist. 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
System action Appliance or N-Series Qtrees or a path within the
Process stops. Network Appliance or N-Series volume. Only full
volumes are supported.
User response
System action
None.
Processing stops.
ANS1668E The 'drive-name1' is not a local
disk.
User response

Explanation Retry the incremental backup operation using the -

SNAPDIFF option. Specify a valid Network Appliance
The specified file system is network disk or network or N-Series NFS volume on AIX or Linux, or a CIFS
share. Because the CLUSTERNODE option is set to volume on Windows.
YES, the file system cannot be backed up or archived.
ANS1672I Could not take the cluster
System action resource resource name offline. MS
rc retcode. Error is ignored.
Processing stops.
Explanation
User response
Microsoft recommends taking the cluster resources
If the CLUSTERNODE option is incorrectly set to YES, offline during an authoritative cluster database
then change the option to NO and try the operation restore. However, the restore can still be done if the
again. Otherwise see the client manual for further resources cannot be taken offline. The error is ignored.
information about configuring the IBM Spectrum
Protect client to run in a cluster environment.
System action
ANS1669W The command subcommand Processing continues.
command can only be run in
Windows WinPE mode.
User response
No action.

Chapter 2. ANS 0000-9999 messages 127

ANS1673W Cluster service on node node name System action
could not be started. You must Processing continues.
manually start the service.

User response
Explanation
Manually start the cluster services on all nodes.
The cluster database has been restored. During the
restore, the cluster service was taken offline. IBM ANS1676W You are doing an authoritative
Spectrum Protect failed to restart the cluster service. cluster database restore. The
process may seem to be hang
System action before and after the file is
restored. This is because it may
Processing continues. need to start the cluster service if
it is not up and take all the
User response resources offline. After the cluster
database is restored, the cluster
You can manually start the service for this node.
service will be restarted for
ANS1674I The cluster database has been changes to be in effect. The cluster
restored but the cluster service on service on all other nodes also
some nodes could not be started. have been shutdown. They will be
Use the Failover Cluster restarted. This may take a few
Management tool to manually minutes.
start the nodes.
Explanation
Explanation The restore will seem to be paused at time because
The cluster database has been restored. During the before the restore, IBM Spectrum Protect ensures the
restore, the cluster services were taken offline except cluster service is up on the restoring node and all the
for the node being restored. IBM Spectrum Protect resources are taken offline. After the cluster database
failed to automatically start these cluster services. You is restored, the cluster service on the restoring node is
need to start them manually. The nodes whose in a paused state. The cluster service on other nodes
services failed to start are logged in the client error were shutdown. All services need to be retarted. If
log. some of the services cannot be started automatically,
you can try to restart them.
System action
System action
Processing continues.
Processing continues.
User response
User response
You can manually start the cluster services.
No action.
ANS1675W Unable to obtain a list of cluster
nodes to restart after the cluster ANS1677W IBM Spectrum Protect failed to set
database is restored. The call the disks for quick formatting
'cmd' returned with MS rc retcode. because of an error. See the error
You must restart the cluster log for more details. The disks will
service on all the nodes after the be slow formatted which will
restore is finished. cause a slower restore process.

Explanation Explanation
Due to an error, IBM Spectrum Protect could not By default, IBM Spectrum Protect tries to set the
retrieve a list of nodes in the cluster to restart. The QuickFormat value of the HKEY_LOCAL_MACHINE
cluster services on these nodes need to be started \SOFTWARE\Microsoft\Windows NT\CurrentVersion
manually. The client error log might contain additional \ASR\RestoreSession key to perform quick formatted
information depending on where the failure occured. 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.

128 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
None The NetApp License only allows using snapshot
differencing for data protection (SnapVault or
User response SnapMirror) volumes.

None
System action
ANS1678E ASR path 'path': not found. The command is not processed.

Explanation User response

You have specified a directory that does not exist. None.

System action ANS1681E DSM_DIR was not set and the

ASRFILESPATH option was not
Processing stops. specified.

User response Explanation

Recheck all spelling and punctuation, particularly the The ASR files can be in put in the DSM_DIR path by
placement of directory delimiters (for example, "\"). default or overriden with the ASRFILESPATH option.
Correct the syntax if it is incorrect, then retry the Either one is being set.
operation.
ANS1679W Updating the registry to identify System action
which volumes have been restored Processing stops.
has failed. This does not affect the
volumes that have already been
restored. See the error log for User response
more details. The error is being Set the DSM_DIR environment variable or specify the
ignored and processing continues. ASRFILESPATH option on the "RESTORE
MACHINEASR" command.
Explanation
ANS1682E Volume 'NetApp-Volume' is a read
After restoring the critical volumes, IBM Spectrum only data protection (SnapMirror
Protect tries to update the RestoredVolumes value of or SnapVault) volume.
the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft Snapshot Differential Backup
\Windows NT\CurrentVersion\ASR\RestoreSession key snapshots cannot be created on a
to indicate which volumes have been restored. Due to read only volume, the
an error accessing the registry, the error is logged but USEEXISTINGBASE and
processing continues. DIFFSNAPSHOT=latest
options must be specified to select
System action existing snapshots for use by the
backup.
Processing continues.
Explanation
User response
The specified NetApp volume is read only which
None prohibits snapshots used by Snapshot Differential
ANS1680E Snapshot Differential Backup is Backup from being created. The USEEXISTINGBASE
only available for data protection and DIFFSNAPSHOT=latest options specify using
(SnapVault or SnapMirror) existing snapshots and may be used in conjunction
volumes. with the BASESNAPSHOTNAME and
Volume 'NetApp-Volume' is not a DIFFSNAPSHOTNAME options.
SnapVault or SnapMirror volume.
System action
The command is not processed.

Chapter 2. ANS 0000-9999 messages 129

User response User response
Use appropriate options for specifying existing None
snapshots.
ANS1687E VSS Instant Restore operation
ANS1684W Disk Full Error Accessing Subfile failed. Please examine the IBM
Cache: exception-name Spectrum Protect client error log
file (DSMERROR.LOG), the Windows
Explanation Application Event Log, the
Windows System Event Log, and
A disk full error occurred attempting to access or write the VSS provider log file (if
to the specified subfile cache file during a subfile applicable) for more details.
incremental backup. See the client error log for more Consult the VSS provider
detailed information. documentation for the meaning of
the error return code.
System action
Processing continues without subfile. Explanation
VSS hardware provider failed while performing
User response volume-level copy restore operation.
None.
System action
ANS1685E Incremental backup operation
using snapshot difference is only Processing stopped.
available for N series/NetApp filer
volumes, is not a NetApp volume. User response
Attempt to determine the source of the error by
Explanation examining the Application Client log file, the client
Cannot perform NAS NFS/CIFS incremental backup error log file (DSMERROR.LOG), the Windows
operation using snapshot difference on the mounted Application Event Log, the Windows System Event Log,
or mapped volume because the volume is not a N and the VSS provider log file, if applicable. Additional
series/NetApp filer volume. instructions for Windows VSS operations are located in
the IBM Spectrum Protect Problem Determination
Guide. Correct the problem and retry the operation. If
System action this error persists, contact your service representative.
Processing stops.
ANS1688I Sparse attributes for 'file-name'
cannot be backed up correctly
User response because the volume from which
Retry the incremental backup operation by specifying the file is backed up does not
an entire NAS NFS or CIFS volume. support sparse files.

ANS1686I Single Instance Store link 'file- Explanation

name' will be restored or retrieved
as a normal file. If the volume from which a file is backed up does not
support sparse files, then the allocated ranges for the
Explanation sparse file cannot be backed up. This is true even if a
file has its sparse attribute set. One example where
IBM Spectrum Protect restores Single Instance Store this can occur is if a sparse file is created on a NAS
(SIS) links as normal files. If the restored version is a volume, but the volume is backed up over CIFS, where
duplicate of of the copy in the SIS Common Store, then CIFS does not support sparse files.
the SIS Groveler will eventually recreate the SIS link.
System action
System action
The sparse attribute and allocated ranges for the file
The process creates normal files instead of the are not backed up. If the file is restored, the restored
reparse point. file will not be sparse.

130 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
No action is required if you do not need the sparse You can ignore the message or remove the option from
attribute and allocated ranges backed up. the option file.
If you require backup of the file's sparse attribute and
ANS1692E The certificate is not trusted.
allocated ranges, then the volume from which IBM
Spectrum Protect backs up the file must support
sparse files. Explanation

ANS1689E The registry was not updated after The client was unable to open SSL connection to the
VSS ASR restore. server because the server certificate was not trusted.

Explanation System action

An error occurred while updating the registry after VSS Processing stopped
Automated System Recovery (ASR). Check
dsmerror.log for more information. User response
Make sure that you have configured the key database
System action for SSL communication as described in the
Processing stops. documentation. If the IBM Spectrum Protect server is
using a self-signed certificate, make sure that you
import the correct certificate from the server you are
User response
trying to connect to. When the server is using a
Ask your system administrator to check the error log. certificate signed by an authority, make sure that the
root certificate of the authority is imported into the
ANS1690E Snapshot Differential Backup is client key database.
only available for data protection
(SnapVault or SnapMirror) ANS1693E The certificate validity period is
volumes. Volume 'NetApp-Volume' incorrect.
is not a SnapVault or SnapMirror
volume. Explanation
The client was unable to open an SSL connection to
Explanation
the server because the certificate validity period is
The NetApp licensing agreement for using snapshot incorrect.
differencing only allows backing up data protection
(SnapVault or SnapMirror) volumes. System action
Processing stopped
System action
Processing stopped. User response
Report this to the IBM Spectrum Protect server
User response
administrator. The server must have the correct
none certificate installed.
ANS1691I The option 'option' that was found ANS1694E The certificate identity could not
in the options file 'file-name' at the be verified.
line number: number is not
supported and will be ignored by Explanation
the client.
The process was unable to open an SSL connection to
the server because the certificate identity could not be
Explanation
verified. This happens when the certificate ownership
The specified option is valid but not supported on the information does not match the IBM Spectrum Protect
current platform and will be ignored by the client. domain name or IP address.

System action System action

Processing continues. Processing stopped

Chapter 2. ANS 0000-9999 messages 131

User response Explanation
Make sure that the server domain name or the IP The specified database (which was saved on the
address (the value of the TCPSERVERADDRESS option) specified date) was successfuly recovered.
is correct. If the problem persists, report it to your IBM
Spectrum Protect server administrator. System action
ANS1695E The certificate is not valid. The specified database was recovered with the last
saved version.
Explanation
The process was unable to open an SSL connection to User response
the server because of an invalid certificate. The client none.
was unable to determine the exact cause of the failure.
ANS1704W Option 'option-name' can not be
supplied by application and is
System action
ignored.
Processing stopped
Explanation
User response
An API application supplied option. The option cannot
Further analysis of the server certificate, the client key be specified by an application. The option can be
database, or both, is needed. Refer to IBM Spectrum specified only in the dsm.sys options file.
Protect documentation for more information.
ANS1696E Only root can perform this action. System action
The supplied option is ignored. Processing continues.
Explanation
User must be root to perform this action. User response
Correct the application configuration.
System action
ANS1705E System Writers writersname do
Processing stopped. not exist.

User response Explanation

Log in as root and try the operation again. These writers are an essential part of the operating
system. When they are not available the backup will
ANS1698I The option 'option_name' that was complete successfully but the data for those writers
found in the command is not will not get backed up to the IBM Spectrum Protect
supported and will be ignored by server. This can result in the computer not booting
the client. after a restore of the system state.

Explanation System action

The specified option is valid but not supported on the System state backup stopped.
current platform and will be ignored by the client.

User response
System action
Verify that these writers exist using 'vssadmin list
Processing continues. writers' command. Try the operation again. If the
problem persists, contact your system administrator
User response or IBM Spectrum Protect administrator for further
Remove the specified option from the command line, help.
and try again. ANS1706E Error creating directory ' directory'.
ANS1700W Database 'database' (save
date=date) was successfully Explanation
recovered. The system was unable to create the specified
directory.

132 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS1708E Backup operation failed. Only a
root user can do this operation.
Processing terminates.

Explanation
User response
Backups initiated by non-root users are disabled by
Verify that the system has the appropriate permissions
IBM Spectrum Protect administrator.
to create this directory, and then restart the operation.
ANS1707E Hard link 'new-file-name' could not System action
be created for existing file 'exist-
file-name'. Microsoft Windows The operation stops.
return code: 'windows-return-code'
'windows-error-text' User response
Request the IBM Spectrum Protect administrator to
Explanation enable non-root backups.
Some system state files are hard links that point to ANS1710I Rebound: fshlll
another file. During system state restore, IBM
Spectrum Protect recreates the hard links for restored
Explanation
system state files. If a file with the same name as the
hard link already exists at the time of the restore, IBM The active version of the object was rebound to a MC
Spectrum Protect attempts to replace the file with the in the IBM Spectrum Protect database.
hard link.
This message is issued when IBM Spectrum Protect is System action
unable to replace an existing file with a hard link. The
message includes the hard link name, the system state This message is for auditing purposes only.
file name to which the hard link points and the
Microsoft Windows return code information. The User response
return code information indicates why the file could
This message is for auditing purposes only.
not be replaced.
It is possible for the operating system or applications ANS1711E Unable to access disk 'disk name'
to behave erratically if the hard link cannot be of VM 'vmname' during backup.
recreated.
Explanation
System action
The client is unable to access the VM disk. In case of
The hard link is skipped, system state restore an offload backup, this might happen if an RDM disk
continues. exists in the VM and is not accessible on the auxilary
ESX host.
User response
Use the Microsoft Windows return code information System action
provided in the message to determine the underlying The virtual machine is not backed up.
cause of the error. Based on the underlying cause of
the error and the reason you are restoring the system
User response
state, you can choose to either correct the underlying
cause and perform the restore again, or you can Ensure that the VM disk is accessible on the ESX.
attempt to manually create the hard link. Because this
ANS1712W Operation on snapshot of a
error message represents an unusual and unexpected
snapshot volume 'uncVolumePath'
condition, you should give careful consideration to the
is not supported for the disk
potential consequences of either choice.
provider type 'LUN-provider-name'
The hard link can be created manually as follows:
(LUN-provider-type).
Rename the file that has the same name as the hard
link. Then use the Microsoft Windows utility fsutil.exe
as follows: Explanation
FSUTIL HARDLINK CREATE hardlinkname Functionality is not available on this type of LUN.
originalfilename

Chapter 2. ANS 0000-9999 messages 133

System action Explanation
Operation continues. The IBM Spectrum Protect client timed-out waiting for
VMware vCenter or ESX host to complete a requested
User response web service task. Resources could be low or the
system could be busy.
Delete manually the LUN on the storage device or
subsystem.
System action
ANS1715E A file space already exists for Processing stopped
virtual machine (VM_name), but
with a different virtual machine
UUID (VM_UUID) than the current User response
virtual machine UUID (VM_UUID). Please check the VMware vCenter or ESX host for
errors.
Explanation
ANS1717E A VMware vStorage web service
A virtual machine with this name was backed up, and it task failed.
has a different virtual machine UUID than the virtual
machine that is backed up now. This can occur if there Explanation
are two virtual machines with the same name that are
backed up to the same data center node name. In this A VMware vCenter or ESX host web service task failed.
case, the backup can not continue because the
backup-archive client uses the virtual machine name System action
to uniquely reference the virtual machine on the IBM
Processing stopped
Spectrum Protect server.
This can also occur if the virtual machine UUID User response
changed after a previous backup operation. This is the
case after the following events: Please check the VMware vCenter or ESX host for
errors.
1. Virtual machine VM_1 backed up.
ANS1729E The passed file list 'file-list' is not
2. Virtual machine VM_1 is restored with a new name:
a valid input file list.
VM_2. A new UUID is assigned to VM_2.
Pass standard file list or collection
3. Virtual machine VM_1 is deleted. file list to the dsmrecall command.
4. Virtual machine VM_2 is renamed to VM_1.
Explanation
System action User has passed a invalid file list type to the dsmrecall
The backup of this virtual machine fails. The backup command
process can continue with other virtual machines.
System action
User response Processing stopped
If there are two or more virtual machines with the
same name in the data center inventory, you can User response
complete either of the following actions:
pass standard file list or collection file list to dsmrecall
• Rename the virtual machines so that all names in the command.
data center inventory are unique.
ANS1730E The IBM Spectrum Protect server
• Backup up virtual machines with the same name to query for ordering information
different IBM Spectrum Protect servers. failed.
If the VM's UUID changed, run a BACKUP VM
command with VMBACKUPUPDATEGUID option. The Explanation
VMBACKUPUPDATEGUID option updates the UUID on
the IBM Spectrum Protect server. Tape optimized recall was not able to retrieve ordering
information from the IBM Spectrum Protect server.
ANS1716E A VMware vStorage web service
task timed-out.

134 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stopped No further action needed.
ANS1734W The virtual machine 'VM-name'
User response contains one or more independent
Check the connection to the IBM Spectrum Protect disks. Backups are not supported
server to see if the IBM Spectrum Protect server is in this configuration. Specify the '-
available and you have the correct access rights vmprocessvmwithindependent=ye
configured. s' option to exclude these disks
from the backup.
ANS1731E Tape optimized recall for file list
'file-list' failed with rc = code.
Explanation

Explanation Independent disks are not affected by snapshots so

the IBM Spectrum Protect client does not support
Tape optimized recall was not able to retrieve ordering backing them up.
information from the IBM Spectrum Protect server.
System action
System action
The virtual machine is not backed up.
Processing stops.
User response
User response
Turn off the virtual machine and change the disk
Check all error messages above this message to get independent mode or remove them from the virtual
details about the problem. machine. Or specify the '-
ANS1732W File 'file' is from a different file vmprocessvmwithindependent=yes' option to exclude
system. writing file to list of these disks from the backup.
unprocessed files: 'file-list'. ANS1735W The virtual machine 'VM-name'
contains one or more physical Raw
Explanation Device Mappings (RDMs). Backups
are not supported in this
The dsmrecall command specifies a file system to
configuration. Specify the '-
process. Files from other file systems are skipped and
vmprocessvmwithprdm=yes'
written into a unprocessed list.
option to exclude these disks from
the backup.
System action
File is skipped and information is written to a list of Explanation
unprocessed files
Physical RDMs are not included in snapshots so the
IBM Spectrum Protect client does not support backing
User response them up.
Check that all files in the input file list are from the
correct file system. System action
ANS1733I A collection file was specified 'file- The virtual machine is not backed up.
list' The ordering process is
skipped. User response
Turn off the virtual machine and change the RDMs to
Explanation virtual mode or remove them from the virtual machine.
A collection file was passed as the input file list. Or specify the '-vmprocessvmwithprdm=yes' option to
Ordering is not necessary since it the file is already exclude these disks from the backup.
ordered. Only the recall is started.
ANS1736W The virtual machine 'VM-name'
cannot be backed up because it
System action contains one or more disks of an
The ordering processed is not started, only recall unsupported type.
started.

Chapter 2. ANS 0000-9999 messages 135

Explanation User response
IBM Spectrum Protect does not support virtual Identify and repair the problem that caused the
machines with unsupported disk types. command to fail. Consider wrapping the command in a
script that always exits with a return code of zero.
System action ANS1739E Restore of a system drive is not
The virtual machine is not backed up. permitted.

User response Explanation

Convert unsupported disks to a supported type, or The drive to which you are restoring contains the
remove the unsupported disks from the virtual operating system.
machine, or exclude the virtual machine from backup.
System action
ANS1737E The PRESNAPSHOTCMD command
failed. Processing stops.

Explanation User response

The command specified by the PRESNAPSHOTCMD Try the operation again without specifying a system
option must complete successfully in order to perform drive.
the VSS snapshot backup. If the command completed
with a return code of 0 (zero), it is considered to have ANS1740W Unable to read ACLs for object:
completed successfully. If the command completed file_system path name. Check
with any other return code, it is considered to have dsmerror.log for more information.
failed. If the command failed then the VSS snapshot
backup is not performed. Explanation
The ACLs of the object are not read.
System action
The client does not perform the VSS snapshot backup System action
operation. The object is skipped. Processing continues with the
next object.
User response
Identify and repair the problem that caused the User response
command to fail. If a non-zero return code is normal Examine the client error log for additional messages
for this command, consider wrapping the command in that might indicate the reason for the problem. Try to
a script that always exits with a return code of zero. follow the suggested corrective actions (if any) and try
ANS1738W The POSTSNAPSHOTCMD the operation again.
command failed. ANS1741W Unable to read extended
attributes for file_system path
Explanation name. Check dsmerror.log for
If the command specified by the POSTSNAPSHOTCMD more information.
option completed with a non-zero return code, the VSS
snapshot backup operation continues. The operation Explanation
continues with a warning-level result. The result of the The extended attributes of the object are not read.
POSTSNAPSHOTCMD command does not supersede a
higher result from the VSS snapshot backup
command. For example, if the VSS snapshot backup System action
command completed with code 12, a lower return The object is skipped. Processing continues with the
code from the POSTSNAPSHOTCMD command does next object.
not alter the return code.
User response
System action
Examine the client error log for additional messages
The VSS snapshot backup continues, but with a that might indicate the reason for the problem. Follow
warning return code of at least 8.

136 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
the suggested corrective actions (if any) and try the Explanation
operation again.
The virtual machine was saved with one or more NIC
ANS1742E Expose Snapshot failed for backup cards backed by distributed port groups. Due to
'backup-name'. conflicts on restore the port number(s) were not
saved.
Explanation
System action
Expose snapshot failed.
The restore continues.
System action
User response
Processing stops
Edit the virtual machine settings and select a port if
User response needed.

See the dsmerror.log file for further details. ANS1746E No available LUNs were found.
Confirm that the storage adapters
ANS1743E Unexpose snapshot failed for are configured correctly on the
backup 'backup-name'. host and that the LUNs are not
mapped to another virtual
Explanation machine.
Unexpose snapshot failed.
Explanation
System action The virtual machine was stored with a Raw Device
Mappings disk backed by a LUN. The required LUN is
Processing stops
missing or still mapped to another virtual machine.

User response
System action
See the dsmerror.log file for further details.
The virtual machine cannot be restored.
ANS1744E One or more of the
snapshots(volumes) needed for User response
the restore operation were not
Confirm that the Storage Adapters are configured
found. See dsmerror.log for
correctly on the host and that the LUNs are not
further details.
mapped to another virtual machine.

Explanation ANS1747E Encryption key password is not

available.
One or more of the snapshots needed for restore were
not found on the system.
Explanation
System action The client is not enabled for encrypted backup/restore
operations by non-authorized users or the encryption
Processing stops key password is not stored by the administrator.

User response System action

See the dsmerror.log file for further details. Objects that cannot be encrypted or decrypted are
ANS1745I The virtual machine to restore has skipped.
one or more distributed port
groups. Further configuration User response
might be necessary to select a port
Contact the administrator for your system to configure
number after the restore is
encrypted operations for non-authorized users.
complete.
ANS1748E The virtual machine was stored
with a Raw Device Mappings disk
backed by a LUN. The required

Chapter 2. ANS 0000-9999 messages 137

 LUN is missing or still mapped to ANS1751E Error processing 'filespace name':
another virtual machine: LUN The file system can not be
UUID lun. accessed.

Explanation Explanation
The virtual machine was stored with a Raw Device The client is unable to access the file system. Two
Mappings disk backed by a LUN. The required LUN is common reasons for this are the account under which
missing or still mapped to another virtual machine. the client is running does not have access to the root
of the file system, or the file system does not exist.
System action
System action
The virtual machine cannot be restored.
The inaccessible file system is skipped. Processing
User response continues with the next file system.

Find the required LUN and make it available to the

User response
virtual machine.
Check the error log for additional messages that might
ANS1749W Object 'filespace-namehl-namell-
yield additional information about the problem that
name' was backed up with invalid
prevents access to the file system. Correct the
file system type attribute.
problem, then retry the operation. If the account does
not have access to the file system, then either the
Explanation system administrator needs to grant access, or an
File system type is used by the client to determine if account that has access to the file system must be
an object name is case sensitive or not. Wrong file used. If the file system does not exist, then remove or
system type may result in incorrect sort order of the correct the file system specification.
server tree for case sensitive file systems. Finally ANS1752E The file system can not be
some unchanged files may expire and then re-backed accessed.
up during full incremental backup.
Explanation
System action
The client is unable to access the file system. Two
Processing continues. common reasons for this are the account under which
the client is running does not have access to the root
User response of the file system, or the file system does not exist.
It is recommended to rename the correspondent
filespace on IBM Spectrum Protect server and do the System action
full incremental backup again. The inaccessible file system is ignored.
ANS1750I Volume mount point
'volumemountpoint' is mounted to User response
volume 'volume'. Using snapshot
Check the error log for additional messages that might
volume for 'volume' to backup.
yield additional information about the problem that
prevents access to the file system. Correct the
Explanation problem, then retry the operation. If the account does
The volume mount point resolved to a volume that has not have access to the file system, then either the
been snapped. The same snapshot volume will be system administrator needs to grant access, or an
used. 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.
System action
ANS1753E File space 'filespace name' was
Processing continues.
backed up by an older client
version, and cannot be restored
User response with this client version. The file
None. space will be skipped.

138 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The backup set format in earlier client versions for IBM Spectrum Protect will ignore the USEDIRECTORY
SYSTEM STATE and SYSTEM SERVICES is option and continue with client processing.
incompatible with the current client version. Those file
spaces will be skipped. The restore might appear to User response
pause while the client skips past the objects in those
file spaces. Other remaining file space data will be Make sure your computer is properly set up to the
restored. domain with Active Directory. Also, make sure your
IBM Spectrum Protect Administrator has properly
configured the IBM Spectrum Protect server for your
System action
node.
Objects in this file space are skipped. Other remaining
ANS1756W The Journal for 'backup-
file space data will be restored.
specification' has been reset: The
server filespace was deleted since
User response the last backup completed.
Restore this specific file space in the backupset with a
prior level client. Explanation
ANS1754E File space 'filespace name' cannot The client has reset the journal because the
be restored when ASNODENAME corresponding server filespace was deleted since the
option is in affect. The file space last backup completed.
will be skipped.
System action
Explanation
The journal is reset, the current backup won't use the
System state data of another node should not be journal, and the journal won't be available for backup
restored to a different node. Those file spaces will be until a full incremental backup successfully completes.
skipped. The restore might appear to pause while the
client skips past the objects in those file spaces. Other User response
remaining file space data will be restored.
None.
System action ANS1757W The Journal for 'backup-
Objects in this file space are skipped. Other remaining specification' has been reset: The
file space data will be restored. server filespace was deleted since
the last backup completed.
User response
Explanation
Remove ASNODENAME option before restoring this
The client has reset the journal because the
specific file space in the backupset or use the node
corresponding server filespace was deleted since the
name that was used to backup system state data to
last backup completed.
restore.
ANS1755W An error communicating with System action
Active Directory has occurred. The
USEDIRECTORY option will be The journal is reset, the current backup won't use the
ignored and processing will journal, and the journal won't be available for backup
continue. until a full incremental backup successfully completes.

Explanation User response

The process attempted to query Active Directory for None.

IBM Spectrum Protect server parameters but an error ANS1758W The Journal for 'backup-
has occurred. This could be caused by Active Directory specification' has been reset: The
or the IBM Spectrum Protect server configuration. server filespace was deleted since
the last backup completed.

Chapter 2. ANS 0000-9999 messages 139

Explanation Explanation
The client has reset the journal because the An active but invalid journal is present for the file
corresponding server filespace was deleted since the system being backed up. Once the backup
last backup completed. successfully completes the journal will available for
use by the next full incremental backup of the file
System action system with the same IBM Spectrum Protect node and
server.
The journal is reset, the current backup won't use the
journal, and the journal won't be available for backup
System action
until a full incremental backup successfully completes.
None.
User response
User response
None.
None.
ANS1759W The Journal for 'backup-
specification' has been reset: The ANS1763W Unable to unmount snapshot
policy set was updated since the mount point snapshot mountpoint
last backup completed. during cleanup of snapshot
'snapshot' of volume 'volume'.
Explanation Error is 'error'.
Operation will continue. Please
The client has reset the journal for the specified file manually unmount, remove the
system because the node policy set was updated since snapshot mount point directory
the last backup completed. and delete the snapshot after
backup is completed.
System action
The journal is reset, the current backup won't use the Explanation
journal, and the journal won't be available for backup During the termination phase of IBM Spectrum Protect
until a full incremental backup successfully completes. client operation, it was not possible to unmount the
snapshot for some reason. However, IBM Spectrum
User response Protect operation was completed successfully.
None.
System action
ANS1760I Journal for 'backup-specification'
enabled for node 'nodename' and Processing continues, and the unmount error is
server 'servername' ignored.

Explanation User response

The journal for the specified file system is now valid Please manually cleanup the snapshots as follows:
and will be used by the next full incremental backup Query the snapshot: snapshot -q -c: <source FS>.
by the specified IBM Spectrum Protect node and Snapshot name will be of the format: tsmxxxxxxxxxx.
server. Check if it is mounted: df -k | grep tsmxxxxxxxxxx.
Unmount the snapshot: umount -f tsmxxxxxxxxxx.
Remove snapshot mount point: rmdir tsmxxxxxxxxxx.
System action Delete the snapshot: snapshot -d /dev/tsmxxxxxxxxxx.
The next full incremental backup of the file system will If snapshot delete fails with "Device Busy" or some
use the journal. other error, unmount the snapshot source filesystem:
umount -f <source FS>.
User response Retry snapshot delete: snapshot -d /dev/
tsmxxxxxxxxxx.
None. Check if any logical volumes are remaining: ls -l /dev/
tsm*.
ANS1761I Journal for 'backup-specification'
Remove any remaining logical volumes: rmlv -f
will be enabled upon successful
tsmxxxxxxxxxx.
completion of the backup.
Remount source file system, if previously unmounted:
mount <source FS>.

140 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS1764W Unable to remove the snapshot snapshot commands. AIX JFS2 expects the snapshot
mount point directory snapshot delete requests for a given filesystem to be issued in
mountpoint during cleanup of the order of oldest snapshot first, next oldest snapshot
snapshot 'snapshot' of volume second, and so on. If there are other processes using
'volume'. older snapshots for the same filesystem, it fails the
Error is 'error'. delete request. Also, the backup-archive client only
Operation will continue. Please deletes snapshots that were created by one of its
manually remove the snapshot processes. It will not delete older snapshots created
mount directory and delete the by other applications or users. In this case, the user
snapshot after backup is will have to manually delete all the older snapshots so
completed. that the next backup-archive command can complete
successfully.
Explanation
System action
During the termination phase of IBM Spectrum Protect
client operation, it was not possible to remove the Processing continues, and the snapshot delete error is
mount point directory for the snapshot for some ignored.
reason. However, IBM Spectrum Protect operation
was completed successfully. User response
Manually clean up the snapshots as follows:
System action Query the snapshot: snapshot -q -c:
Processing continues, and the rmdir error is ignored. <source_FS>
The snapshot name will be of the format:
User response tsmxxxxxxxxxx.
Check if the snapshot is mounted: df -k | grep
Please manually cleanup the snapshots as follows: tsmxxxxxxxxxx
Query the snapshot: snapshot -q -c: <source FS>. Unmount the snapshot: umount -f tsmxxxxxxxxxx
Snapshot name will be of the format: tsmxxxxxxxxxx. Remove the snapshot mount point: rmdir
Check if it is mounted: df -k | grep tsmxxxxxxxxxx. tsmxxxxxxxxxx
Unmount the snapshot: umount -f tsmxxxxxxxxxx. Delete the snapshot: snapshot -d /dev/
Remove snapshot mount point: rmdir tsmxxxxxxxxxx. tsmxxxxxxxxxx
Delete the snapshot: snapshot -d /dev/tsmxxxxxxxxxx. If the snapshot delete operation fails with "Device
If snapshot delete fails with "Device Busy" or some Busy" or some other error, unmount the snapshot
other error, unmount the snapshot source filesystem: source filesystem: umount -f <source_FS>
umount -f <source FS>. Retry snapshot delete: snapshot -d /dev/
Retry snapshot delete: snapshot -d /dev/ tsmxxxxxxxxxx
tsmxxxxxxxxxx. Check if any logical volumes are remaining: ls -
Check if any logical volumes are remaining: ls -l /dev/ l /dev/tsm*
tsm*. Remove any remaining logical volumes: rmlv -f
Remove any remaining logical volumes: rmlv -f tsmxxxxxxxxxx
tsmxxxxxxxxxx. Remount source file system, if previously unmounted:
Remount source file system, if previously unmounted: mount <source_FS>
mount <source FS>.
ANS1766E Failed to initialize SSH2: rc=error-
ANS1765W Unable to delete the snapshot code.
during cleanup of snapshot
'snapshot' of volume 'volume'. Explanation
Error is 'error'.
Operation will continue. Manually Problem occurred during SSH2 initialization.
delete the snapshot after backup
is completed. System action
The operation stops.
Explanation
During a backup-archive client operation, it was not User response
possible to delete the snapshot for some reason.
However, the operation was completed successfully. Check network, DNS and connection settings to the
The error could be caused by an unexpected order of target host or if SSH is working properly.

Chapter 2. ANS 0000-9999 messages 141

ANS1767E Unable to create a snapshot Explanation
logical volume using command: Incremental backup using Snapshot difference
'cmd'. requires Data ONTAP V7.3 or later. However, if you are
Error is 'error'. upgrading from Data ONTAP V7.3.3 or later to V8.0,
Please ensure that the volume you will lose snapshot difference support for unicode
group has sufficient free partitions file names. Upgrade to Data ONTAP V8.1 or later.
to fulfill the allocation request.

System action
Explanation
Processing stops.
During the initialization phase of IBM Spectrum
Protect client operation, it was not possible to create a
logical volume for the snapshot. User response
Upgrade the file server to a supported level of Data
System action ONTAP, then retry the operation.
Processing continues, and the create snapshot logical ANS1770E Unable to resolve address 'tcpip
volume error is ignored. IBM Spectrum Protect address'. Error = error code, 'error
operation will be performed without the snapshot. message'

User response Explanation

Please ensure that the volume group has sufficient The system was not able to get the TCP/IP v6 address.
free partitions to fulfill the mklv allocation reuest and
retry the operation. System action
ANS1768E IBM Spectrum Protect was unable Processing stopped
to find space for a new snapshot.
IBM Spectrum Protect function User response
name : function-name
IBM Spectrum Protect function : Verify the address shown is a TCP/IP v6 address and
function-desc can be resolved with ping or ping6.
IBM Spectrum Protect return
ANS1771W The system state filespace
code : TSM-rc
'filespace name' cannot be
IBM Spectrum Protect file : file-
restored to a different location.
name (line-number)

Explanation
Explanation
The system state file space cannot be restored to a
None.
different location. This file space is skipped.

System action
System action
Processing stops.
Objects in the system state file space are skipped.
Other remaining file spaces are restored. The restore
User response might appear to pause while the client skips past the
Previous backups may still be pending. If problem objects in this file space.
persists contact the IBM Spectrum Protect
administrator with the information provided in this User response
message.
Restore system state to its original location.
ANS1769E NetApp file server 'server-name' at
ANS1772E Error loading the snapshot plugin.
Data ONTAP version
The plugin might not be installed.
'version.modification.submodificati
on' is not supported for performing
incremental backups using Explanation
snapshot difference. The snapshot plugin could not be loaded, possibly
because the plugin is not installed.

142 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Volume Shadow Copy Service (VSS). Examine the IBM
Spectrum Protect error log and Applications Event Log
The snapshot backup is stopped.
for additional information about this error.

User response
System action
On Linux 86/86_64 platform, install the TIVsm-BAhdw
Processing ends.
package if it is not already installed. Try the operation
again. On AIX platform, install the hdw and snphdw
filesets if they are not already installed. Try the User response
operation again. Try the operation again. If the error persists, examine
ANS1773I The virtual machine 'VM-name' the IBM Spectrum Protect error log and Windows
contains one or more independent event log for information related to this error.
disks and these disks are excluded Restart the Windows Volume Shadow Copy Service
from the VM backup. (VSS), and try the operation again.
In some cases, it is necessary to restart the machine
Explanation to clear the VSS error state.
You cannot perform a shapshot of independent disks.
ANS1782E writer-name failed to be stopped.
Specify the option '-
vmprocessvmwithindependent=yes' to skip these
disks. Explanation
IBM Spectrum Protect encountered an error while
System action stopping writer-name. Examine the IBM Spectrum
Protect error log and Applications Event Log for
The virtual machine independent disks will not be
additional information about this error.
backed up.

System action
User response
Processing ends.
None.
ANS1774I The virtual machine 'VM-name' User response
contains one or more physical Raw
Device Mappings (RDM) disks and Try the operation again. If the error persists, examine
these disks are excluded from the the IBM Spectrum Protect error log and Windows
VM backup. event log for information related to this error.
Restart the Windows Volume Shadow Copy Service
Explanation (VSS), then try the operation again.
You cannot perform a shapshot of physical RDM disks. In some cases, it is necessary to retart the machine to
Specify the option '-vmprocessvmwithprdm=yes' to clear the VSS error state.
skip these disks.
ANS1784E Incremental by snapshot
difference cannot be performed on
System action 'volume-name' as it is a vFiler
The virtual machine physical RDM disks are not volume.
backed up.
Explanation
User response Snapshot difference incremental backup is not
None. supported on vFiler volumes.

ANS1780E writer-name failed to initialize and System action

subscribe to VSS.
Processing stops.
Explanation
IBM Spectrum Protect encountered an error while
creating writer-name under control of the Windows

Chapter 2. ANS 0000-9999 messages 143

User response Explanation
Perform snapshot difference incremental backup on The virtual machine NIC was backed by a distributed
normal NetApp/N-Series volumes only. virtual port group but the target ESX host has no port
group available.
ANS1787I The virtual machine NIC is backed
by a distributed virtual port group
but it is missing the portgroupKey System action
attribute, The NIC cannot be The virtual machine can be restored but the NIC
restored. cannot be restored.

Explanation User response

The virtual machine NIC is missing the required After the virtual machine has been restored a new NIC
portgroupKey attribute. card can be added.
ANS1790E Volume 'volname' cannot be
System action
backed up because 'nosnapdir=on'
The virtual machine can be restored but the NIC is set on the filer.
cannot be restored.
Explanation
User response
This message is issued when option 'nosnapdir=on' is
After the virtual machine has been restored a new NIC in set for the volume indicated in the message. When
card can be added. this option is set, the volume snapshots are hidden
and thus cannot be backed up.
ANS1788I The target ESX host is missing the
required distributed virtual port
group, the virtual machine NIC System action
cannot be restored. Use The volume indicated in the message is not backed up.
VMDEFAULTDVPORTGROUP Processing continues with the next volume.
option to set to specify new port
group. If target ESXi server does User response
not have any port groups, use
VMDEFAULTNETWORK option. To back up the volume, change the volume on the filer:
Set option 'nosnapdir=off'. Then try the backup
Explanation operation for this volume again.
If the volume is not backed up, remove it from the
The virtual machine NIC was backed by a distributed backup-archive client DOMAIN setting.
virtual port group but the target ESX host is missing
this port group. ANS1794I The option
'cifs.enable_share_browsing = off'
is set on the filer 'filerName'.
System action
The virtual machine can be restored but the NIC Explanation
cannot be restored.
This message is issued when the option
'cifs.enable_share_browsing = off' is set on the NAS
User response
filer indicated in the message.
After the virtual machine has been restored a new NIC
card can be added. System action
ANS1789I No Ddistributed virtual port group Processing continues.
were found on the target ESX host.
The virtual machine NIC cannot be User response
restored.
Set option 'cifs.enable_share_browsing = on'. Then try
the snapshot difference backup operation again.
ANS1795I Operation will continue without
using snapshot provider, because

144 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 file system 'volname' does not access the object 'object-name'.
have write permissions. Error occurred in file file-name
(line-number).
Explanation
Explanation
The source file system for a snapshot should be read-
write as by definition a snapshot is a point-in-time An error occurred while processing the object. The
snapshot of changing file system. Snapshot creation error code indicates the reason for the failure. This
updates the file system superblock which requires the information can be used to diagnose the problem.
file system to be read-write
System action
System action
The IBM Spectrum Protect client may or may not fail
Processing continues without using snapshot provider. the operation, depending on the code.

User response User response

If the volume needs to be backed up via snapshot Contact your system administrator for more
provider, change its permissions to read-write. information.
ANS1796I The short name for 'fullpath-name' ANS1798W An error occurred while accessing
could not be set to original short encrypted data of the object
name 'file-name': Windows 'object-name', skipping object.
function 'func-name' failed with Windows system error code error,
return code return-code, reason: reason 'error-reason'
'error text'
Explanation
Explanation
An error occurred while processing encrypted data of
The client cannot set the short name for the specified the object. The error information captured indicates
object. This is usually because the short name is the reason for the failure. This information can be used
already in use by another object located in the same to diagnose the problem.
directory. Another possible reason is that the account
under which the client is running does not have the System action
SE_RESTORE_NAME privilege.
Object skipped.
System action
User response
The short name for the specified object is not set. The
object will retain the default short name. Otherwise Contact your system administrator for more
processing continues. information.
ANS1799I The last access date for 'fullpath-
User response name' could not be reset because
This message is informational and can be safely the file is read-only.
ignored. If you require that the object be restored with
its original short name, you will need to move or delete Explanation
the conflicting object. From an operating system Option PRESERVELASTACCESSDATE YES is in effect,
command prompt, change to the directory that but the IBM Spectrum Protect client was unable to
contains the object you want to restore. Then use the reset the last access date for the specified file because
\"dir /x\" command to identify the conflicting object. the file's "read only" attribute is enabled. The client
Also make sure that you have the SE_RESTORE_NAME cannot reset the last access date for "read only" files.
privilege. If you need assistance, see your system
administrator. After the conflict has been resolved, try
to restore the file again. System action
The last access date for the specified file is not reset.
ANS1797E Function function-name received
Otherwise processing continues.
an unexpected error from the
Microsoft API MS-function-name:
rc=error while attempting to

Chapter 2. ANS 0000-9999 messages 145

User response ANS1802E Incremental backup of 'file-name'
finished with failCount failure(s)
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 Explanation
reset the last access date. Before turning off the This message is issued after completion of an
attribute, you should verify that doing so will not incremental backup operation for the named file
impact the integrity of the file or the applications that specification when one or more objects in that file
use the file. You should also make sure that turning off specification could not be backed up.
the attribute will not conflict with the file management
policies of your organization.
System action
ANS1800W The last access date for 'fullpath-
Processing continues.
name' could not be reset: function
'func-name' failed with return
code return-code User response
Examine the client error log for additional messages
Explanation that indicate the reasons that each failed object could
not be backed up. Take any corrective action as
Option PRESERVELASTACCESSDATE YES is in effect,
suggested by the messages.
but the IBM Spectrum Protect client was unable to
reset the last access date for the specified file. The ANS1803E Archive processing of 'file-space
message includes the name of the function that failed name' finished with failures.
and the return code from that function.
Explanation
System action
This message is issued after completion of an archive
The last access date for the specified file is not reset. operation for the named file specification when one or
Otherwise processing continues. more objects in that file specification could not be
archived.
User response
If the problem is reproducible, obtain a SERVICE trace System action
that captures an instance of this problem. Run the Processing continues.
QUERY SYSTEMINFO command and collect the
dsminfo.txt file. Contact IBM support and report the User response
exact text of this error message. Be sure to provide
support with the dsminfo.txt and dsmerror.log files Examine the client error log for additional messages
and (if available) the SERVICE trace. that indicate the reasons that each failed object could
not be archived. Take corrective action as suggested
ANS1801E Unable to register the new ID with by the messages.
server.
ANS1804E Selective Backup processing of
Explanation 'file-space name' finished with
failures.
The reasons of this problem can be lack of client
system memory or server protocol error. The IBM Explanation
Spectrum Protect activity log might contain a
corresponding error message with further information This message is issued after completion of a selective
about the cause. backup operation for the named file specification
when one or more objects in that file specification
System action could not be backed up.

The new ID is not registered with the server. System action

User response Processing continues.

Please check your network connection and try again User response
after time. If the error appears again, please contact
your client machine administrator. Examine the client error log for additional messages
that indicate the reasons that each failed object could

146 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
not be backed up. Take any corrective action User response
suggested by those messages.
See if the server is up, and retry. If the problem still
ANS1805E Unable to restore symbolic link exists, look in the error log. Also have the workstation
'file-name'. administrator run dsmreconcile against the file system
and see if the file shows up in the .SpaceMan/
Explanation orphan.stubs file. If system option file has been
changed, stop all recall daemons and restart the
The client operating system is not able to create a master recall daemon to pick up the changes.
symbolic link because the link points to a filename that
is not given. ANS1808E The Logical Volume Snapshot
Agent is not at the correct level. It
is possible that the Client was
System action
upgraded to a newer level but the
Processing continues. LVSA driver was not updated at
the same time. Use the Setup
User response Wizard to configure either Online
Image or Open File support and
Try the restore on a different operating system. choose Update the Logical Volume
ANS1806W Size exceeded the maximum file Snapshot Agent.
size limit on your system
for Explanation
'file_space_namepath_namefile_na The selected operation requires the current level of
me' of 'file_size'. the Logical Volume Snapshot Agent. Use the Setup
Wizard to update the LVSA.
Explanation
You tried to restore or retrieve a file that has exceeded System action
the maximum file size limitation on your system. The selected operation is not performed.

System action User response

The process cannot restore or retrieve the file. Retry the operation after updating the Logical Volume
Snapshot Agent.
User response
ANS1809W A session with the IBM Spectrum
Restore or retrieve this file on a system that supports Protect server has been
the file size. See your system administrator. disconnected. An attempt will be
ANS1807E Unable to recall file from server made to reestablish the
due to error from recall daemon. connection.

Explanation Explanation

Unable to recall file. The recall daemon reported an This message is issued after the session with the IBM
error while trying to recall a file. Look in the recall Spectrum Protect server is unexpectedly lost. Some
daemon's error log for more information. This can possible reasons that this message might be issued:
happen if the server is down, the connection is broken, - There is a problem with the network.
or the file is missing on the server. It is also possible - The IBM Spectrum Protect server was shut down.
that the migration server in the system option file has - The IBM Spectrum Protect server administrator
been changed to a different server. The recall daemon cancelled the client session.
does not check the system option file for changes once
it has started. System action
The client will try to reestablish a connection with the
System action server. If the IBM Spectrum Protect server
File skipped. 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

Chapter 2. ANS 0000-9999 messages 147

continue. If the attempt to reestablish the connection System action
fails, then the client will continue to try to reestablish a
Processing is stopped.
connection according to the
COMMRESTARTDURATION and
COMMRESTARTINTERVAL client option settings. User response
Check network connection to the server. Insure that
User response the IBM Spectrum Protect server is running. Insure
that the communication program underlying IBM
If the session was cancelled by the IBM Spectrum
Spectrum Protect is working properly.
Protect server administrator and you do not know why,
or if the client is unable to reestablish a session with ANS1813E Image Backup processing of
the IBM Spectrum Protect server, then contact your 'filespace-name' finished with
IBM Spectrum Protect server administrator for further failures.
information. Frequent occurrences of the ANS1809W
message can indicate a problem with the network. If Explanation
this message is repeatedly found in the dsmerror.log,
investigate possible networking trouble, such as a The image backup operation failed. This message is
failing network interface card or router problem. One usually preceded by other messages indicating the
common problem is the media speed of the network nature of the failure.
adaptors: If the network adaptors are set to "auto-
negotiate", try changing them to "100%% full duplex". System action
If the problem persists, then as a temporary measure
The failing file space is skipped and processing
ask your IBM Spectrum Protect server administrator
continues.
increase the COMMTIMEOUT and IDLETIMEOUT
option settings on the IBM Spectrum Protect server.
This might reduce the frequency of this message. User response

ANS1810I A session with the IBM Spectrum Examine the messages preceding this message and
Protect server has been the IBM Spectrum Protect Client error log for more
reestablished. specific indications about the problem. A common
cause is that a tape could not be mounted on the IBM
Spectrum Protect server, perhaps due to an
Explanation
insufficient number of mount points. If there is a
The session with the server has been reestablished problem with the server, contact your System
after a connection failure. This message is usually Administrator for further assistance.
preceded by message ANS1809W.
ANS1814E Unable to start the scheduled
event 'event-name'
System action
Processing will continue. Explanation
The scheduled event is no longer valid on the server.
User response Either the window has elapsed or the schedule has
None. This message is informational only. been deleted.

ANS1811S IBM Spectrum Protect session

System action
could not be reestablished.
The client scheduler queries the server to obtain the
Explanation next scheduled event.

The session with the server has been lost. Attempts to

User response
reestablish the session were unsuccessful. Possible
causes include, but are not limited to the following: If the problem continues, contact your system
administrator to correct the problem on the server.
• The server has been halted.
• The network connection to the server is down. ANS1815E Either the window has elapsed or
the schedule has been deleted
• The communication program that IBM Spectrum
Protect is interacting with has encountered some
problem.

148 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
Scheduled event was no longer valid on the server. Start the scheduler from the OS prompt. For example:
dsmc schedule
System action Windows clients can also use the client scheduler
service. Read the client manual for information on how
The client scheduler queries the server to obtain the to use the SCHEDULE command and how to use the
next scheduled event. IBM Spectrum Protect client scheduler features.
ANS1819E The IBM Spectrum Protect server
User response
was unable to register the address
If the problem continues, see your system for this node.
administrator to correct the problem on the server.
ANS1816E Invalid scheduling mode Explanation
This is a rare situation, and is usually an indication of a
Explanation problem with the IBM Spectrum Protect server.
The mode entered for the scheduled event was not
correct. System action
Processing stopped.
System action
Event does not occur. User response
Check the error log for any other messages that might
User response indicate a reason for the failure. Ask your IBM
Spectrum Protect server administrator to check the
Enter the correct scheduling mode and retry the
IBM Spectrum Protect server activity log for any
operation.
messages that might indicate a problem on the server.
ANS1817E Schedule function can only be run Try to correct any indicated problems, then try the
by a IBM Spectrum Protect operation again. If the problem persists, contact IBM
authorized user. technical support for further assistance.
ANS1820E Command line options must be
Explanation preceded by a '-'
An attempt to use the schedule function failed
because of improper authority. Explanation
An option was specified without a '-' delimiter.
System action
Processing stopped. System action
Processing stopped.
User response
See the IBM Spectrum Protect authorized user for User response
schedule function information.
Enter the command again with a dash preceding each
ANS1818E The SCHEDULE command is not option.
allowed in LOOP (interactive)
ANS1821E Unable to start
mode.
POSTSCHEDULECMD/
PRESCHEDULECMD 'command'
Explanation
The SCHEDULE command may only be given on the Explanation
inital command line. Enter the HELP SCHED command
The requested action required a new process to be
for a complete description of the SCHEDULE
created. Either an option or a schedule "action" that
command.
requested an operating system command to be
executed was entered.
System action
The client does not execute any scheduled events.

Chapter 2. ANS 0000-9999 messages 149

System action ANS1824E Invalid trace file name (name too
long).
Request is ignored.

Explanation
User response
A TRACEFILE option in the preferences files used a file
Remove the request from the options file or the
name that is too long.
schedule defined on the server.
ANS1822E Too many objects were selected System action
for restore. Please select less than
max_objects objects Client program did not initialize.

Explanation User response

The restore cannot be performed, because too many Change the file name used as the TRACEFILE so that it
objects were selected. is equal to or less than 255 characters in length.
ANS1827W Directories cannot be selected
System action with the table of contents
currently loaded on the server.
The restore is not performed.

Explanation
User response
The table of contents that is currently loaded on the
Retry the operation after reducing the number of
server for this volume does not contain objects
objects selected.
corresponding to the one and only point-in-time
ANS1823E The TESTFLAGS or TRACEFLAGS backup. It contains an incomplete point in time or
option specifies unknown flag multiple points in time.
name 'keyword' or the value
supplied is invalid for the named System action
keyword.
The directory is not selected for restore.
Explanation
User response
Either the testflag or traceflag name is incorrectly
spelled, or the value supplied for that flag is not valid. To be able to select an entire directory for restore,
select "Use Latest" or "Use Point in Time" from the
Point in Time dialog.
System action
ANS1828E Screen size is too small for using
If the TESTFLAGS or TRACEFLAGS option was
specified in the client options file or on the command the PICK option.
line during client initialization, the the client program
does not start. If the option was specified from the Explanation
command line client while running in LOOP You cannot use the PICK option on a workstation that
(interactive) mode, then the operation does not run. has a screen smaller than 20 characters across and 10
lines down.
User response
Correct the TESTFLAGS or TRACEFLAGS flag name or System action
correct the value specified for the TESTFLAG keyword IBM Spectrum Protect did not complete the operation.
shown in the message. These options are typically
used at the direction of IBM technical support or as
User response
specified in the IBM Spectrum Protect Problem
Determination Guide. If you are not sure which flag Retry the operation using a workstation that has a
names to use, review the IBM Spectrum Protect screen with the minimum size, or do not use the PICK
Problem Determination Guide for additional option.
information or contact IBM technical support for
further assistance. ANS1831E Password expired. The
administrator for this system must

150 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 run IBM Spectrum Protect to Explanation
update the password.
Either the password is not stored locally, or it was
changed at the server.
Explanation
The password expired. System action
IBM Spectrum Protect prompts you for the password if
System action IBM Spectrum Protect is running in the foreground.
IBM Spectrum Protect ends.
User response
User response If IBM Spectrum Protect was running as a background
The administrator for this system must update the process, issue any IBM Spectrum Protect command
password. from the foreground. Enter the password in answer to
the prompt. Then try your background IBM Spectrum
ANS1832W The option 'option' is no longer Protect command again.
supported and will be ignored by
IBM Spectrum Protect client in ANS1836I Unable to process Processor Value
this release. Unit hardware scan info file 'file
name', errno, cause.
Explanation
Explanation
The specified option is in the process of being made
obsolete and will be ignored by the client in this The internal-use data file was not readable.
release. This option will be removed in the next
release and will no longer be valid. System action
Processor Value Unit information is not sent to the IBM
System action Spectrum Protect server. Processing continues.
Processing continues.
User response
User response No response is necessary. This does not affect regular
Remove the option from the option file. Also check the processing. Correct any file access permission issues
documentation to see if this option has been replaced and try the command again. If the file exists, delete
by a newer option. the file and try the command again.

ANS1834S Unable to write to 'file-name' for ANS1837S File space file_space_name is

storing password ignored. Processing continues.

Explanation Explanation

IBM Spectrum Protect cannot write to the specified The specified file space in the system options file is
file-name. invalid.

System action System action

Processing continues. The process attempts to continue the current

operation.
User response
User response
Check access permissions and disk space. If
unsuccessful, see your system administrator. Check the file space in the system options file and use
a valid file space. Retry the operation.
ANS1835E PASSWORDACCESS is GENERATE,
but password needed for server ANS1838E An error occurred while opening
'server-name'. user-specified options file
Either the password is not stored 'file_space_name'.
locally, or it was changed at the
server.

Chapter 2. ANS 0000-9999 messages 151

Explanation User response
The specified options file could not be located or Check the server Activity Log to determine the cause
opened. of failure. Retry the operation after correcting the
problem.
System action ANS1862W No table of contents information is
The process attempts to open the default options file. available on the server for this
volume.
User response
Explanation
Ensure that the specified options file exists and is
valid. No objects for the selected volume exist on the server
that were backed up with table of contents
ANS1839E Cannot read password. information. Consequently no file-level queries can be
performed against the volume.
Explanation
An error occurred in setting up the input file (for System action
example, the terminal) to be read. none

System action User response

Processing stopped. If file-level information is desired, use TOC option
during backup.
User response
ANS1865E Session rejected: Named Pipes
Check the attributes of the terminal. connection failure.
ANS1852E Recall failed: offset 'offset' and
read size 'size' are beyond the file Explanation
size of 'filesize'. An attempt to connect to the server using Named
Pipes communications failed. This might have
Explanation occurred if an incorrect NAMEDPIPENAME was
specified in the options files or if your system
An attempt was made to read beyond the end of the
administrator canceled a backup operation.
file.

System action
System action
Processing stopped.
Processing stopped.

User response
User response
Retry the operation, or wait until the server comes
You must read within the file size. When determining
back up and retry the operation. Ensure that the value
offset and read size values, all values are processed as
specified on the NAMEDPIPENAME option is the same
bytes.
as the one used by the server. If the problem
ANS1853E Server could not load the Table of continues, contact your system administrator for
Contents. Status: status further help.
ANS1867E The server generated a CRC for
Explanation verb type CRC verb which does not
A failure occurred when the server attempted to load a match the received verb verb
file-level Table of contents for an NDMP volume. No received.
file-level queries can be performed against the volume
until the problem is solved. Explanation
A cyclic redundancy check (CRC) failed between IBM
System action Spectrum Protect client and server communication.
The table of contents is not loaded.

152 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The current object is skipped. Processing continues Contact your system administrator for more
with the next object. information.
ANS1877E The parsed string is too long for
User response IBM Spectrum Protect to process
This is an unusual condition, and could indicate a and has been truncated to prevent
communications problem between the IBM Spectrum a buffer overflow.
Protect client and server. Try the operation again. If
the problem persists, contact IBM for further Explanation
assistance.
This is a rare condition. A very long string would have
ANS1871W The server CRC version is server to be entered by the user in a command line, dsm.opt
CRC version which does not match file, or filelist. This string exceeds the maximum input
the client version client CRC string size of 1024 bytes.
version.
System action
Explanation
IBM Spectrum Protect truncated the string to the
This is a rare situation. The server and client are using maximum possible length of 1024, then continued
different versions of cyclic redundancy check (CRC) with the operation. The operation may fail later due to
algorithms. this truncation.

System action User response

Processing continues without CRC checking. Check the client error log for other messages that
might have been logged after this message was
User response written, and take any corrective action suggested by
those messages. If the problem persists, contact IBM
Clients can be no more than one version downlevel support for further assistance.
from the IBM Spectrum Protect server. Make sure the
client and server are at compatible levels. The ANS1878E An unknown error occurred while
command line client displays both client and server processing system object 'sys-obj-
versions when the client starts and connects to the name':
server. The QUERY SESSION command will also Service 'service-name' and its
display the server version. From the GUI, use the dependent services could not be
\"Help/About\" menu item to identify the client stopped.
version, and the \"File/Connection Information\" menu
item to identify the server version. If the client and Explanation
server versions are incompatible, then the IBM
Spectrum Protect server administrator can turn off An unknown error occurred while processing a system
CRC checking for your node. object. The service listed in the message and all of its
dependent services could not be stopped. Processing
ANS1873E An unknown error occurred while cannot complete until the service is stopped.
processing system object 'sys-obj-
name': System action
utility function 'func-name' failed
with error error IBM Spectrum Protect ended the current operation.

Explanation User response

An unknown error occurred while processing a system Manually stop the service and retry the operation.
object. The error information captured indicates the ANS1882E Unable to stop service 'service-
reason for the failure. This information can be used to name'; error error
diagnose the problem.
Explanation
System action
The service could not be stopped by the program.
IBM Spectrum Protect ended the current operation.

Chapter 2. ANS 0000-9999 messages 153

System action System action
IBM Spectrum Protect ended the current operation. None.

User response User response

Manually stop the service and retry the operation. For return codes other than 0, the user may wish to
verify the results of the client operation(s) and take
ANS1891W SUBDIR is not a valid option when diagnostic and repair actions, as necessary.
using FILELIST, SUBDIR will be
ignored. ANS1898I ***** Processed count files
*****
Explanation
Explanation
When Specifying FILELIST each entry is a single object
and so SUBDIR will not apply. IBM Spectrum Protect has processed the specified
number of files.
System action
System action
The option SUBDIR is ignored.
Processing continues.
User response
User response
You may have either a -FILELIST or SUBDIR on this
command, but not both. None.
ANS1892W Expire command is not allowed on ANS1899I ***** Examined count files *****
the IBM Spectrum Protect
journaled filespace 'filespace'. Explanation
IBM Spectrum Protect has examined the specified
Explanation
number of files.
You cannot expire files from the server on a IBM
Spectrum Protect journaled filespace. System action
Processing continues.
System action
The expire command will not work on this filespec User response
None.
User response
ANS1900I Return code is return code value.
If you want to expire this filepec remove it from the
local filesystem.
Explanation
ANS1895I Highest macro return code was
return code value. The return code has been issued for the preceding
client command. In order of increasing severity, the
return code meanings are:
Explanation
0 - The command completed successfully
This message is issued after all commands in a client
macro have completed. The return code represents 4 - One or more files were skipped
the highest return code that was issued during 8 - One or more warning messages were issued
processing of the macro. In order of increasing 12 - One or more error messages (except for
severity, the return code meanings are: skipped files) were issued
0 - The command completed successfully The return code indicates the highest severity
4 - One or more files were skipped message that was issued during execution of the client
8 - One or more warning messages were issued command.
For a scheduled event, the event will be considered
12 - One or more error messages (except for
successful if the return code is 0, 4, or 8. The event
skipped files) were issued
will be considered to have failed if the return code is
12.

154 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action option, which does not require that the command
complete successfully. If a non-zero return code is
None.
normal for this command, then consider wrapping the
command in a script that always exits with a return
User response code of zero.
For return codes other than 0, the user may wish to ANS1903W The POSTSCHEDULECMD
verify the results of the client operation and take command failed.
diagnostic and repair actions, as necessary.
ANS1901I Highest return code was return Explanation
code value.
If the command specified by the POSTSCHEDULECMD
option completed with a non-zero return code, then
Explanation the scheduled event is considered to have completed
This message indicates the highest return code of all successfully, but with a warning-level result. Note that
the client commands that were executed. In order of the result of the POSTSCHEDULECMD command will
increasing severity, the return code meanings are: not supercede a higher result from the scheduled
client command. For example, if the scheduled client
0 - The command completed successfully command completed with a return code of 12, the
4 - One or more files were skipped scheduled event will be considered to have completed
8 - One or more warning messages were issued with a return code of 12, regardless of the outcome of
12 - One or more error messages (except for the POSTSCHEDULECMD command.
skipped files) were issued
System action
System action At a minimum, the result code of the scheduled event
None. is 8.

User response User response

For return codes other than 0, the user may wish to Identify and repair the problem that caused the
verify the results of the client operation(s) and take command to fail. If it is not necessary for the
diagnostic and repair actions, as necessary. command to complete before posting the result of the
scheduled event, then consider using the
ANS1902E The PRESCHEDULECMD command POSTNSCHEDULECMD option. If a non-zero return
failed. The scheduled event will code is normal for this command, then consider
not be executed. wrapping the command in a script that always exits
with a return code of zero.
Explanation
ANS1904E The archive description may not
The command specified by the PRESCHEDULECMD contain any wildcard characters
option must complete successfully in order to execute like '?' or '*'.
the scheduled event. If the command completed with
a return code of 0 (zero), it is considered to have Explanation
completed successfully. If the command completed
with any other return code, it is considered to have Descriptions for archive files must not contain
failed. If the command failed then the scheduled event wildcard characters.
is not executed.
System action
System action Processing stopped.
The client does not execute the scheduled event, and
the result code of the scheduled event will be 12. User response
Enter an archive description that does not contain
User response wildcard characters.
Identify and repair the problem that caused the
ANS1906I Destination must be specified for
command to fail. If it is not necessary for the
this operation when using
command to complete before starting the scheduled
FROMNODE.
event, then consider using the PRENSCHEDULECMD

Chapter 2. ANS 0000-9999 messages 155

Explanation System action
You must specify a destination with a Restore/Retrieve The scheduled event is successful. The result code for
command when using FROMNODE processing. the event is 0.

System action User response

Processing stops. None.
ANS1909E The scheduled command failed.
User response
Retry the Restore/Retrieve command with a Explanation
destination specified.
The scheduled command completed with a non-zero
For example, with the Windows backup-archive client: return code, which is interpreted as failure.
restore -fromnode=cougar \\cougar\d$\projx\*
d:\projx\ System action

Or, with the UNIX and Linux backup-archive clients: The scheduled event is failed. The result code for the
event is 12.
restore -fromn=node1 -fromo=ann "/home/proj/*" /
home/gillis/
User response
ANS1907E An error occurred while trying to
Identify and repair the problem that caused the
perform an object merge operation
command to fail. If a non-zero return code is normal
on the server.
for this command, then consider wrapping the
command in a script that always exits with a return
Explanation code of zero.
For NetWare clients: The IBM Spectrum Protect server ANS1912E An invalid registry hive was
is unable to perform a NetWare long name conversion. specified.
For Unix or Windows image backup: The group used to
store associated image components could not be
Explanation
closed.
The specified registry hive is invalid.
System action
System action
The operation ends.
Processing stopped.
User response
User response
For NetWare: It is possible that a more current level of
the IBM Spectrum Protect server can perform the Correct the command and retry the operation.
conversion. Contact your IBM Spectrum Protect server
administrator for assistance. ANS1913E An invalid registry subkey was
For Unix or Windows: This error indicates an specified.
authorization problem. Contact your IBM Spectrum
Protect server administrator for assistance. Explanation
If the problem still cannot be resolved, contact IBM
The specified registry subkey is invalid.
technical support for further assistance.
ANS1908I The scheduled command System action
completed successfully.
Processing stopped.

Explanation
User response
The scheduled command completed with return code
Correct the command and retry the operation.
of zero, which is interpreted as success.
ANS1914E The specified subkey isn't valid for
the specified hive.

156 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS1918E Too few arguments specified for
the RESTORE REGISTRY
The specified registry subkey is invalid for the
command.
specified registry hive.

Explanation
System action
Too few arguments were specified for the RESTORE
Processing stopped.
REGISTRY command.

User response
System action
Correct the command and retry the operation.
Processing stopped.
ANS1915E Too many arguments specified for
the BACKUP REGISTRY command. User response
Correct the command and retry the operation.
Explanation
ANS1919E The specified eventlog is not valid.
Too many arguments were specified for the BACKUP
REGISTRY command.
Explanation
System action The specified eventlog is not valid.
Processing stopped.
System action
User response Processing stopped.
Correct the command and retry the operation.
User response
ANS1916E Too many arguments specified for
the RESTORE REGISTRY Correct the command and retry the operation.
command. ANS1920E Too many arguments specified for
the BACKUP EVENTLOG command.
Explanation
Too many arguments were specified for the RESTORE Explanation
REGISTRY command. Too many arguments were specified for the BACKUP
EVENTLOG command.
System action
Processing stopped. System action
Processing stopped.
User response
Correct the command and retry the operation. User response

ANS1917E Too few arguments specified for Correct the command and retry the operation.
the BACKUP REGISTRY command. ANS1921E Too many arguments specified for
the RESTORE EVENTLOG
Explanation command.
Too few arguments were specified for the BACKUP
REGISTRY command. Explanation
Too many arguments were specified for the RESTORE
System action EVENTLOG command.
Processing stopped.
System action
User response Processing stopped.
Correct the command and retry the operation.

Chapter 2. ANS 0000-9999 messages 157

User response User response
Correct the command and retry the operation. Correct the command and retry the operation.
ANS1922E Too few arguments specified for ANS1926E The specified system object type is
the BACKUP EVENTLOG command. only valid on Windows NT.

Explanation Explanation
Too few arguments were specified for the BACKUP The specified system object type is only valid on
EVENTLOG command. Windows NT.

System action System action

Processing stopped. Processing stopped.

User response User response

Correct the command and retry the operation. Correct the command and retry the operation.
ANS1923E Too few arguments specified for ANS1928E Server-initiated sessions are not
the RESTORE EVENTLOG available in the LAN-free mode.
command.
Explanation
Explanation
Conflicting options SESSIONINIT=serveronly and
Too few arguments were specified for the RESTORE ENABLELANFREE=yes were specified. This
EVENTLOG command. combination is not allowed.

System action System action

Processing stopped. Processing stops.

User response User response

Correct the command and retry the operation. Use client-initiated sessions or disable LAN-free.
ANS1924E The specified system object is not ANS1929E An error occurred saving the
valid. registry key.

Explanation Explanation
The specified system object is not valid. The active registry key cannot be copied to the
ADSM.SYS staging directory.
System action
System action
Processing stopped.
The registry backup operation stops.
User response
User response
Correct the command and retry the operation.
Check the space available on the Windows boot
ANS1925E The specified system object type is partition to ensure there is room to contain a copy of
not valid. the Windows registry. This might require several
megabytes of free space. Also check the Windows
Explanation permissions on the ADSM.SYS staging directory and
The specified system object type is not valid. ensure that the Windows user which you are using to
run IBM Spectrum Protect has full access to that
directory and its contents.
System action
ANS1930W IBM Spectrum Protect Express
Processing stopped.
client view not supported with a

158 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 IBM Spectrum Protect Enterprise Reboot the system and attempt the restore operation
server. CLIENTVIEW option again.
ignored.
ANS1933E Error accessing file or device
'name'.
Explanation
The IBM Spectrum Protect Express client view is only Explanation
supported when going to a IBM Spectrum Protect
An error has occurred while accessing the file or
Express server. When a IBM Spectrum Protect Express
device.
client connects to a IBM Spectrum Protect Enterprise
server, the CLIENTVIEW option is ignored, and the IBM
Spectrum Protect Standard client view is displayed System action
instead. Backup set operation is not completed.

System action User response

The CLIENTVIEW option is ignored and the IBM Verify that the file or device exists and is accessible.
Spectrum Protect Enterprise client view is displayed.
ANS1934E Backup set 'name' not found.
User response
Explanation
If you intend to use the IBM Spectrum Protect
Enterprise server, then update your CLIENTVIEW The backup set name was not found on the server.
option to a value of STANDARD. Otherwise, update
your TCPSERVERADDRESS option to point to your IBM System action
Spectrum Protect Express server.
The backup set operation is not processed.
ANS1931E An error saving one or more
eventlogs. User response
Verify that the backup set name is correct.
Explanation
An error occurred saving one or more eventlogs. ANS1935E Too many arguments specified for
the BACKUP NTDS command.
System action
Explanation
Processing stopped.
Too many arguments were specified for the BACKUP
NTDS command.
User response
Correct the command and retry the operation. System action
ANS1932E An error occurred replacing one or Processing stopped.
more registry keys.
User response
Explanation
Correct the command and retry the operation.
The registry key or keys being replaced are exclusively
held by another process. The registry keys were ANS1936E Not enough arguments specified
previously restored but the system was not restarted. for the BACKUP NTDS command.

System action Explanation

processing stops. Not enough arguments were specified for the BACKUP
NTDS command.
User response
System action
This error occurs because the registry key or keys
being replaced are exclusively held by another Processing stopped.
process. This can happen if the registry keys were
previously restored but the system was not rebooted.

Chapter 2. ANS 0000-9999 messages 159

User response Explanation
Correct the command and retry the operation. IBM Spectrum Protect encountered an error while
restoring files under control of the Windows 2000 File
ANS1937E No NTDS server name specified for Replication Service
the BACKUP NTDS command.

System action
Explanation
Processing stopped.
No NTDS server name was specified for the BACKUP
NTDS command.
User response
System action Examine the Windows 2000 File Replication Service
Event log to insure the File Replication Service is
Processing stopped. operating properly. Restart the service and retry the
restore operation.
User response
ANS1941E System Volume backup failed.
Specify NTDS server name at the command and retry
the operation.
Explanation
ANS1938E NT Active Directory is not IBM Spectrum Protect encountered an error while
supported in this OS level. backing up files of the Windows 2000 System Volume

Explanation System action

NT Active Directory is not supported in this OS level. Processing stopped.

System action User response

Processing stopped. Examine the Windows 2000 File Replication Service
Event log to insure the system volume was
User response successfully initialized. Restart the service and retry
Install Active Directory before performing backup the backup operation
operation. ANS1942E System Volume restore failed.
ANS1939E File Replication Service backup
failed. Explanation
IBM Spectrum Protect encountered an error while
Explanation restoring files under control of the Windows 2000 File
IBM Spectrum Protect encountered an error while Replication Service
backing up files under control of the Windows 2000
File Replication Service System action
Processing stopped.
System action
Processing stopped. User response
Examine the Windows 2000 File Replication Service
User response Event log to insure the system volume was
Examine the Windows 2000 File Replication Service successfully initialized. Restart the service and retry
Event log to insure the File Replication Service is the restore operation.
operating properly. Restart the service and retry the ANS1943E The operation is not supported:
backup operation. Downlevel server version.
ANS1940E File Replication Service restore
failed. Explanation
The operation cannot be performed because server
version is downlevel.

160 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stopped. The file was skipped because either REPLACE NO was
in effect, causing all existing files and directories to be
User response skipped, or REPLACE PROMPT was in effect, and when
prompted, the user chose to skip this file or all existing
Use correct server version. directories and files. No additional action is necessary
ANS1944E Error accessing file or device. if the decision to skip the file was deliberate.
Otherwise the operation can be retried using either
REPLACE ALL (automatically replace existing
Explanation directories and files) or REPLACE PROMPT (prompt the
An error has occurred while accessing the file or user whether to replace the file).
device.
ANS1947W The following directory exists and
is skipped: file-space_name
System action directory_path directory_name
Backup set operation is not completed.
Explanation
User response The client tried to restore or retrieve the specified
Verify that the file or device exists and is accessible. directory. The directory exists in the target restore
location and the user chose not to replace the existing
ANS1945E The long namespace has been directory.
removed from the local file space.
If you wish to proceed with the The directory can be skipped because the option
backup/archive operation, rename REPLACE=NO is set, which causes all existing files and
your file space on the server. 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.
Explanation
The process has detected that the server namespace System action
is NTW:LONG, but the local volume does not have long
name support. If you would like to back up the volume The directory is skipped, a message is logged in the
using the short names, rename the file space on the dsmerror.log log file, and restore or retrieve
server. If you would like to back up using long names, processing continues with the next object.
add the long namespace support back to the volume in
question. User response
No additional action is necessary.
System action
To replace the files, try the operation again and set
Processing stopped. option REPLACE=ALL. You can set REPLACE=PROMPT
and when prompted, choose to replace the directory.
User response
ANS1948E The Microsoft volume shadow
Add the long namespace support to the volume or copy system components could
rename(remove) the corresponding server file space. not be queried.
ANS1946W File exists, skipping
Explanation
Explanation IBM Spectrum Protect encountered an error while
querying the system writers under control of the
The client tried to restore or retrieve the specified file, Windows volume shadow copy service. The error log
but the file already existed in the target restore and Windows event log might contain additional
location and the user chose not to replace the existing information about this error.
file.

System action
System action
Processing stops.
The file is skipped, a message is logged in
dsmerror.log, and restore or retrieve processing
continues with the next object.

Chapter 2. ANS 0000-9999 messages 161

User response service. It might be necessary to reboot the machine
to clear the Volume Shadow Copy error state.
Try the operation again. If the error persists, review
the error log and Windows event log for information ANS1951E Restore using Microsoft volume
related to this error. You might need to restart the shadow copy failed.
volume shadow copy service, then try the operation
again. It might be necessary to reboot the machine to Explanation
clear the volume shadow copy error state.
IBM Spectrum Protect encountered an error while
ANS1949E Microsoft volume shadow copy restoring with the Microsoft Volume Shadow Copy
snapshot initialization failed. Service.

Explanation System action

IBM Spectrum Protect encountered an error while processing stops.
initializing the Microsoft Volume Shadow Copy Service
for backup or restore. The error log and Windows
User response
event log can contain additional information about this
error. Review the error log and Windows event log for
information related to this error. Restart any failing
System action system service indicated in the Windows event log.
Restart the volume shadow copy Service. You can use
processing stops. the Windows command 'vssadmin list writers'
to determine the status of the volume shadow copy
User response service. It might be necessary to reboot the machine
to clear the Volume Shadow Copy error state.
Try the operation again. If the error persists, review
the error log and Windows event log for information ANS1952E Invalid symbolic link destination
related to this error. Use the Windows command 'file-name' entered
'vssadmin list writers' to determine the status
of the Volume Shadow Copy service. You can reboot Explanation
the machine to clear the volume shadow copy error
state. If the system is a Domain Controller and the You entered a restore/retrieve destination file-name
Active Directory service is stopped, restarting the specification that is a symbolic link. To restore to
Active Directory service will resolve the issue. symbolic link, make sure you set the followsymbolic
option to yes. Also, check where this symbolic link
ANS1950E Backup using Microsoft volume points. You can restore/retrieve to a symbolic link that
shadow copy failed. points to an existing object.

Explanation System action

IBM Spectrum Protect encountered an error while Processing stopped.
performing a backup operation using the Microsoft
volume shadow copy service. The error log and
User response
Windows event log might contain additional
information about this error. Enter a correct file specification.
ANS1954E Backup processing of 'file-space
System action name' finished with failures.
processing stops.
Explanation
User response This message indicates that the file system backup
Review the error log and Windows event log for has completed, but encountered errors during backup
information related to this error. Restart any failing processing.
system service indicated in the Windows event log.
Restart the volume shadow copy Service. You can use System action
the Windows command 'vssadmin list writers'
to determine the status of the volume shadow copy Processing continues.

162 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Examine the client error log for additional messages A previous group backup failed without cleaning up the
related to errors in backing up the file system. Take temporary groups correctly.
any corrective action as suggested by the messages.
ANS1956E Too few arguments specified for System action
the BACKUP GROUP command. The previous incomplete groups are removed and
processing continues.
Explanation
Too few arguments were specified for the BACKUP User response
GROUP command. None.
ANS1971E The remote client agent
System action
(dsmagent) could not be started.
Processing stopped.
Explanation
User response
The remote client agent cannot be started. This error
Correct the command and retry the operation. message is usually preceded or followed by other
messages.
ANS1957E Showmembers and inactive are
mutually exclusive parameters on
a query. System action
Processing is stopped.
Explanation
Showmembers and inactive are mutually exclusive User response
parameters on a query. Check the error log for any other messages that might
indicate a reason for the failure. Verify that the web
System action client is installed correctly. Try to correct any indicated
problems, then try the operation again. If the problem
Processing terminates. persists, contact IBM technical support for further
assistance.
User response
ANS1972E The connection to the remote
Specify one of the mutually exclusive parameters on client agent (dsmagent) failed.
the query Either the port number could not
ANS1958W No base group found, attempting a be read, or the port number is
full backup. invalid.

Explanation Explanation

A differential backup requires a previous full backup to An error occurred when trying to read the port number.
have been performed. A connection to the remote client agent cannot be
made.
System action
System action
Processing continues, and a full backup is attempted.
Processing stopped.
User response
User response
None. Perform a full backup before attempting a
differential backup Check the error log for any other messages that might
indicate a reason for the failure. Verify that the web
ANS1959I Removing previous incomplete client is installed correctly. Try to correct any indicated
group 'name' Id:hi-lo problems, then try the operation again. If the problem
persists, contact IBM technical support for further
assistance.

Chapter 2. ANS 0000-9999 messages 163

ANS1973I VSS writer for system object System action
'name' does not exist. Restore Processing stopped.
skipped.

User response
Explanation
Correct the command and retry the operation.
Microsoft Volume Shadow Copy Service does not
detect a writer for this system component. Either the ANS1977E Dsmcad schedule invocation was
component is not installed or is not running.. unsuccessful. This command will
be tried again in 10 minutes.
System action
Explanation
Object skipped.
Dsmcad was unable to get the valid scheduler
User response information from the dsmc schedule process. This
could be due to some problems during the scheduler
Install or enable the affected system service and retry initialization, such as incorrect option usage.
the operation.
ANS1974W Error removing previous System action
incomplete group Id:hi-lo Dsmcad will try to invoke the scheduler again in 10
minutes in order to get the valid information.
Explanation
A previous group backup failed without cleaning up the User response
temporary groups correctly, and the error still can not Check the console and error logs to determine what
be cleaned up. kind of error occurred during the dsmc process and
correct the problem.
System action
ANS1978E The IBM Spectrum Protect server
The previous incomplete groups remain and is downlevel and does not support
processing continues. the requested function. See error
log for version information.
User response
None. Explanation

ANS1975W IBM Spectrum Protect server error The function being used requires a more current IBM
reason occurred closing and Spectrum Protect Server.
renaming the group
System action
Explanation The operation fails.
An error was encountered closing and renaming the
temporary group. User response
Upgrade your IBM Spectrum Protect Server to a level
System action that supports this function. See error log for version
The backup is unsuccessful. information.
ANS1979E The IBM Spectrum Protect Storage
User response Agent is downlevel and does not
support the requested function.
Ensure that the user has the proper authority to
See error log for version
update the group and try the operation again.
information.
ANS1976E The specified system service is not
valid. Explanation
The function being used requires a more current IBM
Explanation Spectrum Protect Storage Agent.
The specified system service is not valid.

164 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action to the tracefile in the directory specified. It is also
possible that no space is available at the tracefile
The operation fails.
location.

User response
System action
Upgrade your IBM Spectrum Protect Storage Agent to
Processing stops.
a level that supports this function. See error log for
version information.
User response
ANS1980E The IBM Spectrum Protect Server
and IBM Spectrum Protect Storage Make sure the tracefile option points to a valid path
agent are downlevel and do not and that the user has proper permissions to write to
support the requested function. the specified file.
See error log for version ANS1987E A destination file specification is
information. not allowed with this command.

Explanation Explanation
The function being used requires a more current IBM Of all the system object restore commands only
Spectrum Protect Server and IBM Spectrum Protect RESTORE ASR allows the entry of a destination file
Storage agent specification.

System action System action

The operation fails. Processing stopped.

User response User response

Upgrade your IBM Spectrum Protect Server and IBM Re-issue the command without a destination file
Spectrum Protect Storage agent to a level that specification.
supports this function. See error log for version
information. ANS1989E Initialization functions cannot
open the error log file specified.
ANS1981E Server :Version ver, Release rel,
Level lev.subl
Explanation
Storage Agent:Version SAver,
Release SArel, Level SAlev.SAsubl The error log file could not be opened during
initialization. The specified path may be incorrect. It is
Explanation also possible that the current user does not have
permission to write to the logfile in the directory
This message supplies extra detail to downlevel specified. It is also possible that no space is available
messages. at the given logfile location.

System action System action

The operation fails. Processing terminates.

User response User response

This message supplies extra detail to downlevel Make sure the logfile option points to a valid path and
messages. that the user has proper permissions to write to the
ANS1986E Initialization functions cannot file specified.
open the trace file specified. ANS1990W The 'filesystem name' volume
mount point can not be accessed.
Explanation The IBM Spectrum Protect return
code is 'rc'.
The file could not be opened during initialization. The
specified path might be incorrect. It is also possible
that the current user does not have permission to write

Chapter 2. ANS 0000-9999 messages 165

Explanation System action
The client is unable to access volume mount point. The No processing takes place.
common reasons for this are that the account under
which the client is running does not have access to the User response
volume mount point, or the volume is mounted onto a
cluster volume which is currently not available. Select objects of the same type to perform delete
operation.
System action ANS1996W The volume mount points
enumeration on 'filesystem name'
The inaccessible mount point is skipped and
volume failed. Windows system
processing continues. with the next mount point or
error code: error; reason: 'error-
volume.
reason'.

User response
Explanation
Check the error log for additional messages that might
The client was unable to scan the specified volume for
yield additional information about the problem that
volume mount points. The error information captured
prevents access to the volume mount point. Ensure
indicates the reason for the failure. A common reason
that the IBM Spectrum Protect client is running under
is that the account under which the client is running
an account which as access to the volume mount
does not have access to the volume.
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 System action
volume mount points on a clustered server. The processing continues with the next volume.
ANS1991E An error occurred processing
registry key 'key-name', data value User response
'value-name'. See the client error
Ensure that the client is running under an account
log for additional information
which has access to the volume and volume mount
about this error.
points. Correct the condition causing the error and try
the operation again. If the problem persists, contact
Explanation your system administrator or IBM Spectrum Protect
An unexpected error occurred when the client tried to administrator for further help.
read or update the Windows registry. Additional ANS1997W No files have been previously
information regarding the error is usually placed in the backed up for the VSS component
error log. 'component-name'.

System action Explanation

The operation might not execute correctly, depending You tried to restore the Microsoft Volume Shadow
on the error. Copy (VSS) System State component which does not
contain file data. This is not necessarily a problem.
User response
Check the client error log for any other messages that System action
might have been logged when this message was Processing continues.
written, and take any corrective action suggested by
those messages. If the problem persists, contact IBM
User response
support for further assistance.
Check the error log for any other messages that
ANS1995W Objects of different types cannot
occurred during backup. The logs can indicate a
be deleted at the same time.
reason for the failure.

Explanation ANS1998W Transaction byte limit 'name' is

not supported by the server. Value
Deleting objects of different types is not allowed. For reset to limit
example, deleting Backup Sets and regular file objects
at the same time is not possible.

166 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The TXNBYTELIMIT is larger than the server supports. Processing continues.
The value will be reset to a supported limit.
User response
System action
Make sure the volume data is not corrupt by using
TXNBYTELIMIT is reset, and processing continues. system tools like chkdsk (Windows) or fsck (Unix).
ANS2027E GSKit function func-name failed
User response with error-code: During the
Set the option to a value supported by the server. SSL/TLS handshake, the client
could not agree on a supported
ANS1999E type of the operation processing of SSL/TLS protocol version to use
'filespace-name' stopped. with server. session

Explanation Explanation
The client has encountered a condition where it can A GSKit function has failed with the
not continue processing the specified file space. The GSK_ERROR_BAD_MESSAGE.
IBM Spectrum Protect client error log or schedule log
should contain additional messages related to this
System action
error.
Processing stopped
System action
User response
Processing stops.
Make sure you have configured the key database for
User response SSL communication as described in the
documentation. Possible issues could be during the
Check the IBM Spectrum Protect client error log and SSL/TLS handshake, the client could not agree on a
schedule log for any additional messages related to supported SSL/TLS protocol version to use with server
this error. Take any corrective action that might be If the problem persists, contact IBM Spectrum Protect
suggested by the related messages, then try the customer support.
operation again. If the problem persists, contact your
IBM Spectrum Protect administrator for further ANS2032I The client VM restore is skipping
assistance. the unsupported Independent
disk : vmdk
ANS2025W Object 'object-name' has been
removed from DB (Fix IT19964).
Explanation

Explanation The VMware vStorage APIs do not support

snapshoting Independent disks, no backups were
Fix of the APAR IT19964 created.

System action System action

None Processing continues.

User response User response

Nothing None.
ANS2026W Bad sectors were detected on the ANS2033W 'symboliclink name': is a symbolic
volume 'volname'. link to a file or directory in a
different file system.
Explanation
Bad sectors are skipped during image backup/restore Explanation
operations. The dsmls file specs operand or the used file list
contains a symbolic link to a file or directory in another

Chapter 2. ANS 0000-9999 messages 167

file system. Processing may lead to incorrect status of most syntax checking for client option set options is
the object the symbolic link refers to. done by the server, there are still errors that can only
be detected by the client. These errors include:
System action • Option value is not correct.
Status of objects are displayed. • Options that have been retired by newer versions of
the IBM Spectrum Protect client.
User response • Missing brackets or directory delimiters.
To display the correct status of objects use dsmls with • Include and exclude patterns that are too complex.
the full qualifying path to the objects.
ANS2036W Pruning functions cannot open one System action
of the IBM Spectrum Protect prune The option is ignored by the IBM Spectrum Protect
files: log-name. errno = errno- client.
value,
User response
Explanation
Contact the IBM Spectrum Protect server
The file "log-name could not be opened during administrator to determine if the option can be
pruning. The system set the error code errno-value. If removed from the client option set.
the reason given is "access denied," the current user
does not have permission to write to the file in the ANS2039E Invalid destination file
directory specified. It is also possible that no space is specification 'file-name' entered
available at the given file location or another IBM
Spectrum Protect process started by different user id Explanation
is performing pruning at the same time.
The destination file specification must end with
directory delimiter when performing a file list restore,
System action or when the restore specification is for more than one
Pruning stops, processing continues. file, or when the option SUBDIR YES is in effect.

User response System action

Set the DSM_LOG (or DSMI_LOG) environment Processing stopped.

variable to a directory into which the current user can
write. User response
ANS2037W Schedule log pruning failed. Specify a destination that ends with directory
delimiter.
Explanation ANS2040E While attempting to communicate
The schedule log pruning function completed with with the remote client, a version
errors. check reveals that the versions do
not match. The version is
remoteversion but the expected
System action
version is localversion.
Processing continues.
Explanation
User response
During initialization between the local client and the
Check error log for possible reasons of failure. remote client, version checking reveals that the
versions do not match. This is usually the result of an
ANS2038W Invalid option 'option-name' upgrade of one client module without upgrading other
received from the IBM Spectrum client modules that are part of product solution.
Protect server client options set.
System action
Explanation
The calling procedure returns and control is passed
The client received an invalid option from the IBM back the user.
Spectrum Protect server's client option set. Although

168 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Check the versions of all IBM Spectrum Protect Client Processing skips this virtual machine template.
products that communicate with each other and
ensure that they are all at the same version, release, User response
and level.
To back up this virtual machine template, run an
ANS2041E Snapshot Differencing support is incremental forever full backup operation.
not available on the specified
NetApp filer. ANS2044E The template virtual machine
'name' cannot be restored when
the IBM Spectrum Protect data
Explanation
mover node on the vStorage
Incremental by snapshot difference backup cannot be Backup Server is connected
performed because required support on the specified directly to an ESX/ESXi host.
NetApp filer is not availble. .
Explanation
System action
The VMware vStorage API do not support template
Processing terminates. virtaul machine operations when connected directly to
an ESX/ESXi host.
User response
System action
None.
Processing stops for this template virtual machine
ANS2042W 'symboliclink':is a symbolic link to
a file or directory in another
filesytem. ACLs or extended User response
attributes might not be backed up. Virtual machine template operations are supported
when the IBM Spectrum Protect data mover node
Explanation connects directly to a ESX/ESXi host. Modify the
VMCHOST to connect the IBM Spectrum Protect data
The backup or archive operand contains a symbolic mover to a vCenter Server.
link to a file or directory in another file system.
Processing may lead to loss of ACLs or other extended ANS2045E The
attributes because they might not be processed. VMENABLETEMPLATEBACKUPS
option is not specified. The virtual
System action machine template 'name' can not
be backed up.
The file data is backed up. Processing continues with
the next object.
Explanation

User response The VMENABLETEMPLATEBACKUPS template option

must specify YES in order for a virtual machine
If you need to ensure that ACLs and other extended template to be included in a backup operation. The
attributes are backed up successfully, do not use default value is NO.
symbolic links to back up files on other file systems of
different file system types. Instead use IBM Spectrum
System action
Protect to process the other file system directly.
Processing stops for this template virtual machine
ANS2043I The virtual machine template
'name' has already been backed
up. User response
Use the option -vmenabletemplatebackups=yes and
Explanation run the operation again.
Virtual machine templates are skipped if no change ANS2046S Error 'errtxt' (errno=errno)
has occurred since the last backup. occurred trying to write to audit
log 'file-name'. The audit log
function is disabled.

Chapter 2. ANS 0000-9999 messages 169

Explanation User response
There was an error encountered writing to the audit The backup copy of the named stream is damaged.
log (for example, there is not enough space on the The file is restored to as great an extent as possible,
disk). but the file should be examined to verify that it is
usable.
System action ANS2049W Named stream of object 'object-
Audit logging is disabled for the rest of the operation. name' may be corrupt.
The return code for the operation is set to 12 to
indicate that the contents of the audit log are Explanation
incomplete.
One or more of the file's named streams may be
corrupt.
User response
If this is an out of space condition either free up space System action
on the volume or try to write the audit log to a volume
The named stream is restored/retrieved to as great an
with more space.
extent as possible.
ANS2047E An unexpected error was
encountered processing a system User response
state/services request.
IBM Spectrum Protect function The backup copy of the named stream may be
name : function-name damaged. The file is restored to as great an extent as
IBM Spectrum Protect function : possible, but the file should be examined to verify that
function-desc it is usable.
IBM Spectrum Protect return ANS2050E IBM Spectrum Protect needs to
code : TSM-rc prompt for the password but
IBM Spectrum Protect cannot prompt because the
explanation : TSM-msg process is running in the
IBM Spectrum Protect file : file- background.
name (line-number)
Explanation
Explanation
If PASSWORDACCESS=PROMPT or if the password that
None. is stored locally is incorrect, IBM Spectrum Protect
attempts to prompt the user for the password. The
System action attempt to prompt the user fails because the process
is running in the background. When a process is
Processing the system state stops.
running in the background, prompting is not allowed.

User response
System action
Contact the IBM Spectrum Protect administrator with
Processing stopped.
the information provided in this message.
ANS2048W Named stream of object 'object- User response
name path-name file-name' is
corrupt. If RUNASSERVICE=YES, do not set
PASSWORDACCESS=PROMPT. Use
PASSWORDACCESS=GENERATE.
Explanation
ANS2051W The local snapshot repository was
One or more of the file's named streams are corrupt.
not found on location.
System action
Explanation
The named stream is not restored/retrieved.
The specified directory for the local snapshot location
does not exist.

170 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS2055I The local snapshot manager could
not be locked.
Processing continues.

Explanation
User response
The local repository is locked by another application.
A new local snapshot repository will be build in the
This process will proceed when the other application
specified directory.
unlock the local repository.
ANS2052E Information about the disk
subsystem is missing. System action
Processing continues.
Explanation
The local snapshot repository could not be initialized User response
due to missing information about the disk subsystem.
None.
System action ANS2056I Waiting maximal timeout seconds
until the lock is released by the
Processing stops.
other application.

User response
Explanation
The application ensures that the disk subsystem is
While the local repository is locked by another
initialized properly. Check for preceding error
application, the program will wait a specific period of
messages.
time to proceed. For example, in the mySAP
ANS2053E A memory allocation error has environment, the wait period is 1 hour.
occurred in file filename, line
number linenumber. System action
Processing continues.
Explanation
Enough memory was not available to continue User response
processing.
None.
System action ANS2057E Local snapshot manager not
Processing ends. initialized.

Explanation
User response
The local snapshot repository was used without
Ensure that your system has sufficient real and virtual
previous initialization.
memory. Close unnecessary applications.
ANS2054E Operating system error errno: System action
messagetext.
Processing ends.
Explanation
User response
The application encountered an unexpected message
error during the execution of a system function. The The system normally ensures that the local repository
respective operating system error and message text is initialized. Check for preceding error messages.
will be displayed. ANS2058E The data container with ID dcID
could not be updated in the local
System action repository.
Processing stops.

User response
Check the specific error message.

Chapter 2. ANS 0000-9999 messages 171

Explanation System action
During a FlashCopy backup the target set record in the Processing continues.
local repository is updated with the correspondent
properties. A failure occurred during that process. User response
None.
System action
ANS2061W The target data container with ID
Processing ends.
dcid was not found in the local
repository.
User response
Check for preceding error messages like memory Explanation
allocation error or other system error.
An inquire of the data container with the specified ID
ANS2059E Cannot find a target data could not be satisfied because that target set does not
container that match with the exists in the local repository.
source data container.
System action
Explanation
Processing may continue.
During a snapshot type backup or hardware function,
the process tries to find a target data container that User response
match to the source data container to satisfy the
operation. A matching target data container could not The application that is requesting the inquire will
be found. decide whether or not the error should end the
program. Check for following messages.
System action ANS2062W Could not find a target data
Processing ends. container in the state state to
fulfill the requested criteria.
User response
Explanation
See the rules for select one of multiple target data
containers. For example, this message will be A data container in the specified state was not found in
displayed if the user is trying to start a FlashCopy the local repository to satisfy specific criteria
backup of type 'INCR' and all the target sets are being requested by the application.
used for the FlashCopy type 'COPY'. Make sure also
that the target volumes are available to the backup System action
system and the syntax is correct for the following Processing may continue.
setup file parameters: 1. shark_target_volume 2.
shark_copy_service_code 3.
java_home_directory 4. User response
primary_copyservices_servername 5. Which criteria have been passed is application
shark_username 6. shark_password specific. Check for following messages. The
application will decide whether or not that warning
ANS2060W Cannot find a volume in the target
should end the program.
data container dcID to match with
the source srcvol. ANS2063W The local snapshot repository
already exists on the directory
Explanation location.
This warning message indicates that for the specific
Explanation
source not any target volume could be found in this
target data container that matches for a FlashCopy An application tried to create the local repository in a
operation. If multiple target data containers are being directory that already exists.
used, the processing will continue checking the
volumes of the next target data container. System action
Processing may continue.

172 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
The application will decide whether or not that Processing ends.
warning should end the program. Check for following
messages. User response
ANS2064I The local snapshot repository will Check the specific reason.
be created on the directory
location. ANS2068E No target LUNs were found for the
data container dcID in the .fct file
filename.
Explanation
The local snapshot repository containing information Explanation
about the state of the data containers is being created.
The program will search in the .fct file for each specific
data container a list of entries with the label
System action
<PREFIX>TARGET_VOLUME where the prefix depends
Processing continues. on the hardware type. Either you have a wrong label
for the target volumes of the specified data container
User response or this data container in the .fct file does not have any
target LUNs.
None.
ANS2065I The local snapshot repository System action
could not be created on the Processing ends.
directory location.
User response
Explanation
This error can only occurred if the application does not
A failure occurred creating the local snapshot have a GUI where the user provides the input of the
repository. target data containers and the format will
automatically be checked. If so, please check the
System action format of the .fct file.
Processing ends. ANS2069E Cannot read the file filename of
the local snapshot repository.
User response
Look for a operating system error message. Explanation

ANS2066E Cannot read the .fct file filename. 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.
Explanation
The .fct file containing the target data containers was System action
not found or is not accessible.
Processing ends.
System action
User response
Processing ends.
Check the name, the path and the right of the file.
User response ANS2070E The repository state file filename
is empty or has a wrong format.
Check the name, the path and the right of the file.
ANS2067E The exception CLsmException was Explanation
thrown. Reason: txt.
The system keeps some information about the state of
the data containers locally in a file. This file was found
Explanation but the expected format of the data in not correct.
An unexpected error occurred processing a function of
the local snapshot repository.

Chapter 2. ANS 0000-9999 messages 173

System action Explanation
Processing ends. The system keeps some information about the state of
the data containers in the local snapshot repository.
User response Opening a file of this repository occurred an error.

Normally the system ensures that the format of this

System action
file is correct. Check for preceding error.
Processing ends.
ANS2071E The data container dcID could not
be inserted in the local snapshot
repository. User response
Check the rights permission of that file.
Explanation
ANS2074E Cannot open user input FlashCopy
The system keeps some information about the state of target file 'fct_file'.
the data containers locally in a file. Inserting an entry
for a new data container occurred an error. Explanation
The FlashCopy target file that the user provided
System action
cannot be read.
Processing ends.
System action
User response
The operation fails.
This is an unexpected error. Check for preceding error.
If not any other error can be seen, collect the logs and User response
traces and contact the support.
Run the client configuration utility and provide a valid
ANS2072E An unexpected error was FlashCopy target user input file.
encountered processing a IBM
Spectrum Protect operation using ANS2075E There is no VTOC data available
a hardware or snapshot function. for the volume. The volume cannot
IBM Spectrum Protect function be backed up.
name : function-name
IBM Spectrum Protect function : Explanation
function-desc
The volume disk label type is not VTOC. It is possible
IBM Spectrum Protect return
that your disk is formatted with an EFI label. The IBM
code : TSM-rc
Spectrum Protect client on Solaris currently supports
IBM Spectrum Protect file : file-
only VTOC disk labels.
name (line-number)

System action
Explanation
The volume is not backed up.
None.

User response
System action
Do not attempt to backup volumes formatted with a
Processing stops.
non-VTOC disk label.

User response ANS2076E program-name: Space Managment

can not be added for file system
Contact the IBM Spectrum Protect administrator with 'filesystem' The length of the file
the information provided in this message. system name exceeds the
ANS2073E The file filename of the local maximum length of 'maxlength'
snapshot repository could not be which can be stored in a DMAPI
opened for writing. attribute.

174 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS2079E Error processing 'filespace
namepath-namefile-name': error
The DMAPI has a limitation in the size of data that can
scanning snapshot
be stored in a DMAPI attribute. If the lenght of the file
system name exceeds this limit the IBM Spectrum
Protect client can not add space management to the Explanation
file system. This message is issued when the IBM Spectrum
Protect client is unable to read data from a snapshot
System action used for the backup. If you are performing the
Microsoft Volume Shadowcopy Service (VSS) snapshot
Space management cannot be added to file system.
backup one possible cause is that the operating
system deleted a VSS snapshot because the shadow
User response copy storage could not grow. If you are performing the
Please make sure that the length of the file system snapshot difference incremental backup on normal
name does not exceed the DMAPI limit. NetApp/N-Series volumes one possible cause is that
the base snapshot was accidentally removed from the
ANS2077E program-name: Reconcile for file NetApp file server.
system 'filesystem'
can not be started for the selected
System action
mode in a non-scout environment.
Please use Two Way Orphan Backup processing for the file system stops.
Check Reconcile instead.
User response
Explanation
If you were performing VSS snapshot-based backup,
The IBM Spectrum Protect client reconciliation examine the client error log and the Microsoft
program can not be started in orphan check or stub Windows system event log for any other messages
restore mode when the HSM system is configured to that might help identify the problem. If there are no
run without the scout daemon. obvious reasons for the failure, try the operation
again,the problem might be caused by temporary I/O
System action conflicts between VSS and other system disk I/O
activities. If you were performing snapshot difference
Reconcile can not run in a non scout environment. incremental backup, contact your IBM Spectrum
Protect administrator to verify that base snapshot was
User response not accidentally deleted.
If you have configured a non scout environment you ANS2080W The value 'option' for the option
need to use the Two Way Orphan Check Reconcile. 'option' is no longer supported and
will be ignored by IBM Spectrum
ANS2078E System state backup is not
Protect client in this release.
allowed CLUSTERNODE is set to
YES.
Explanation
Explanation The specified option value is in the process of being
made obsolete and will be ignored by the client in this
When the CLUSTERNODE option is set to YES, the
release. This option value will be removed in the next
backup systemstate command is not valid.
release and will no longer be valid.

System action
System action
System state backup is stopped.
Processing continues.

User response
User response
If the CLUSTERNODE option is incorrectly set to YES,
Update the option value or remove the option from the
then change the option to NO and try the operation
option file. Also check the documentation to see if this
again. Otherwise see the backup-archive client manual
option has been replaced by a newer option.
for further information about configuring the client to
run in a cluster environment. ANS2083W No vApps that match the input
specification were found.

Chapter 2. ANS 0000-9999 messages 175

Explanation System action
A vApp that matches the specified input or the VAPP Processing stops.
value in the DOMAIN.VCD option was not found.
User response
System action
Logon to the server from a client with a platform that
The operation is stopped uses unicode data. For example, the original platform
that was used to create the existing filespaces for this
User response node. Alternatively, if the client node needs to change
to the platform that is currently being attempted,
Make sure the the VAPP value in the DOMAIN.VCD contact the server administrator to remove the
option is correct. existing filespaces that contain unicode data and try
ANS2084I Creating a new vApp the node connection again.
ANS2089E The string string_text can not be
Explanation converted to Unicode.
The estore is attempting to create the destination
vApp. Explanation
An object contains a multibyte sequence that is invalid
System action for the current locale.
This message is for informational purposes only.
System action
User response The operation stops.
No action is required.
User response
ANS2085E The virtual machine is configured
as a fault tolerant virtual machine. Verify that the locale is appropriate for the objects that
As a result, it cannot be backed are processed.
up. ANS2090I The virtual machine folder could
not be found in this path: 'name'.
Explanation
vSphere does not allow for the snapshot or backup of Explanation
fault tolerant virtual machines with vStorage API for The destination target does not have the original
Data Protection. inventory path that was saved with the virtual
machine. As a result, the virtual machine is restored to
System action the top level of the ESX/ESXi inventory.
The virtual machine is not backed up.
System action
User response Processing continues
To back up a fault tolerant virtual machine with
vStorage API for Data Protection, first disable fault User response
tolerant. Then, after the backup completes, enable None
fault tolerant.
ANS2091I The virtual machine resource
ANS2088E Session rejected: The client does could not be found in this path:
not use unicode. 'name'.

Explanation Explanation
The server cannot accept the client session because The destination target does not have the original
the client does not use unicode and the node already resource path that was saved with the virtual machine.
contains a unicode filespace. The server records As a result, the virtual machine is restored to the top
whether or not the client's data is unicode, and does level of the ESX/ESXi inventory.
not let the node change this attribute.

176 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing continues Ensure that the multi-node name exists on the server
and that the agent node has the proper authority to
User response target node listed.

None ANS2100E Backup of virtual machine 'virtual-

machine-name' cannot continue
ANS2092I The restore process will override because an invalid disk area was
the original inventory path that encountered during backup.
was saved with this virtual
machine.
Explanation

Explanation During a backup of the virtual machine, one or more

virtual hard disks indicated an invalid disk area for
Specifying the -datacenter or -host option will override backup such as a length of zero, a length greater than
the original inventory path that was saved with the the size of the disk, invalid starting position, or
virtual machine. As a result, the virtual machine is negative values.
restored to the top level of the ESX/ESXi inventory.
System action
System action
The backup was stopped.
Processing continues
User response
User response
Check that the virtual machine's storage is configured
None properly, working correctly, and all storage hardware
ANS2093E The remote file system agent is is properly connected to the virtual machine. Try the
downlevel and does not support command again. If the problem persists contact IBM
this operation. Spectrum Protect customer support.
NODENAME : node ANS2101E Compressed data grew.
MULTI-NODE NAME : multi-node
hostname : host
Explanation
TCP/IP address : tcpaddr:tcpport
version : version.release.level..mod The size of data is growing after compression

Explanation System action

None. Processing continues.

System action User response

The operation fails. The application must abort the transaction.
Please turn off compression and try to resend the
User response object.
Upgrade the remote file system agent to a supported ANS2102E File list processing not started
level.
ANS2097E Unable to establish a session with Explanation
the IBM Spectrum Protect server
An error occured before the file list processing was
as target node 'target' using agent
started.
node 'agent'.

System action
Explanation
Processing stops.
None.

System action
Processing ends.

Chapter 2. ANS 0000-9999 messages 177

User response error log for communications failures and correct any
configuration issues. If the IBM Spectrum Protect
Examine the client error log for additional messages
server is not available, allow the node to fail over to
that might indicate the reason for the problem. Try to
the secondary server as configured by the primary IBM
follow the suggested corrective actions (if any) and try
Spectrum Protect server administrator.
the operation again.
ANS2107I Attempting to connect to
ANS2104E An error occured after processing
secondary server secondary server;
the file list.
at secondary server; : TCP/IP Port;

Explanation
Explanation
An error occured after the file list processing
The node is configured for replication and will attempt
completed.
to connect to the secondary server. The secondary
server address and port are configured by the primary
System action IBM Spectrum Protect server administrator and are
Processing stops. saved in the options file.

User response System action

Examine the client error log for additional messages Processing continues.
that might indicate the reason for the problem. Try to
follow the suggested corrective actions (if any) and try User response
the operation again.
Contact the IBM Spectrum Protect server
ANS2105I File list entry not Processed: File administrator to verify if the primary server is
List Entry available. If the primary server is available, check the
IBM Spectrum Protect error log for communications
Explanation failures and correct any configuration issues. If the
IBM Spectrum Protect server is not available, allow the
A file list operation encounted an error. This entry from node to fail over to the secondary server as configured
the file list was not processed. by the primary IBM Spectrum Protect server
administrator.
System action
ANS2108I Connected to secondary server
This message is for auditing purposes only. secondary server;.

User response Explanation

This message is for auditing purposes only. The node is configured for replication and has
successfully connected to the secondary server.
ANS2106I Connection to primary IBM
Spectrum Protect server primary
server; failed System action
Processing continues.
Explanation
A communication error occured while attempting to User response
connect to the primary server. The node is configured None.
for replication and will attempt to connect to the
secondary server. ANS2110I Connection to secondary server
IBM Spectrum Protect secondary
server; failed
System action
Processing continues. Explanation
A communications error occured while attempting to
User response
connect to the secondary server. The node is
Contact the IBM Spectrum Protect server configured for replication and an attempt to connect to
administrator to verify if the primary server is the secondary server was made but failed.
available. If the primary server is available, check the

178 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action operations for the node with the 'Update Node'
command.
Processing continues.
ANS2113E The command is not enabled when
User response connected to the secondary server
in failover mode.
Contact the IBM Spectrum Protect server
administrator to verify if the secondary server is
Explanation
available. If the secondary server is available, check
the error log for communications failures and correct The IBM Spectrum Protect client has failed over and
any configuration issues. established a session with a secondary server. The
IBM Spectrum Protect server is configured as a
ANS2111E The REPLSERVERNAME entry for
replication server and will not accept data from this
the specified
node. Commands that store data on the server are
MYREPLICATIONSERVER option
disabled.
was not found.

System action
Explanation
Processing continues.
The MYREPLICATIONSERVER option must have a
matching REPLSERVERNAME entry in the options file.
The REPLSERVERGUID, REPLTCPPORT, and User response
REPLTCPSERVERADDRESS must also be specified. You can use the IBM Spectrum Protect client for
These options are normally set by the IBM Spectrum Restore, Retrieve, and Query operations. Backup and
Protect server administrator and saved to the options Archive operations will fail.
file during logon to the primary server.
ANS2114W IBM Spectrum Protect application
System action protection did not copy the VSS
Manifest files from VM 'VM'.
Processing stops.
Explanation
User response
The VSS Manifest files are not found on the guest
Manually edit the options file to either correct or machine.
remove the options.
ANS2112I Secondary server is configured as System action
'read-only'. Backup and Archive The VSS Manifest files cannot be copied. Verify that
operations are not supported the VSS and SQL Writer services are running on the
when the secondary server is in guest VM
'read-only' mode
User response
Explanation
None
The IBM Spectrum Protect client has established a
session with a server that is configured as 'read-only'. ANS2115I Replication server connection
The IBM Spectrum Protect server is configured as a information saved:
replication server and will not accept data from this connection information;
node.
Explanation
System action This node is configured for replication. The replication
Processing continues. server connection information has been saved to the
options file. The replication server options are set by
User response the IBM Spectrum Protect Administator, sent to the
client during logon, and are saved to the options file.
The IBM Spectrum Protect may be used for Restore,
Retrieve and Query operations. Backup and Archive System action
commands will fail. The IBM Spectrum Protect server
administrator can enable Backup and Archive Processing continues.

Chapter 2. ANS 0000-9999 messages 179

User response ANS2118I A write failure occurred while
attempting to save node
None.
replication failover values to the
ANS2116W IBM Spectrum Protect application options file.
protection did not back up the VSS
Manifest files from VM 'VM'. Explanation
A write failure is often a result of insufficient access
Explanation
permissions to the options file, but could also be
A failure occurred while backing up the files that are caused by the lack of available disk space. The
necessary for application protection. replication server connection information can not be
saved and failover will not be possible.
System action
System action
The back up of this VM failed.
The operation failed.
User response
User response
Check the dsmerror.log for additional information.
Then try the operation again. Check the local disk for possible causes of the write
error, and check to see that sufficient access to the
ANS2117E Source volume is of subtype dev- options file is configured.
type and destination is of subtype
dev-type. Destination must be ANS2119I An invalid replication server
larger than source. address return code rc value = rc-
value was received from the
Explanation server.

Logical volumes from scalable volume groups (subtype

Explanation
DS_LVZ) do not contain an LVCB. That is, the very first
block contains user data. An invalid replication server address return code
AIX LVM volumes from original volume groups indicates that the server was not able to aquire
(subtype LVM) contain a Logical Volume Control Block connection information.
(LVCB) on the first block (512 bytes) of the volume.
When restoring to a volume of subtype LVM, the first System action
block must be skipped in order to preserve the existing
LVCB of the destination volume. That is, the restore Possible server problem.
operation begins writing at the second block of the
volume. User response
This means that given two volumes of identical size,
Check the server log for more information.
one of subtype DS_LVZ and the other is of subtype
LVM, the latter has one less 512-byte block in which to ANS2120W The last store operation date
store user data. Thus when you restore a volume of reported by the server replication
subtype DS_LVZ to a volume of subtype LVM, it is not server; of server commit date; UTC
sufficient for the destination volume to be the same does not match the last store
size as the source volume. Instead, the destination operation date of client commit
volume must be at least one 512-block larger than the date; UTC stored by the client for
source volume. the filespace filespace;.

System action Explanation

The restore operation is not performed. The last store operation date reported on the server
does not match the date stored locally on the client. If
User response connected to the replication server it is likely that the
replication was done before the last store operation
Make sure that both source and destination logical from the client to the primary server. Hence, the
volumes are of the same type, or choose a larger replication is out of date. If connected to the primary
destination volume, or increase the size of the server it is likely that the previous backup was done
destination volume. from another machine.

180 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Processing continues. Another process is using the client node replication
table.
User response Only one process may use it at a time.

Contact the IBM Spectrum Protect server

System action
administrator. Restoring from an out of date replica
may lead to loss of data. If the primary server cannot This process does not use the client node replication
be recovered, a full backup to the replica may be table.
appropriate. If connected to the primary server, the
message can be ignored. User response
ANS2122E The name of virtual machine 'VM- You can serialize processes using the client node
name' ends with a period. The replication table. Or you can reconfigure the current
backup/restore of such machines process to use a different table path to avoid
is not supported. contention.
ANS2126E The Organization VDC node that
Explanation
contains snapshots of
The specified virtual machine ends with a period Organization VDC 'org vdc name' of
character that are not supported for virtual machine organization 'org name' was not
backup and restore operations. found.

System action Explanation

The backup for the specified virtual machine fails. The Organization VDC node contains the backup data
to be restored. The specified organization and
User response organization VDC are not mapped to this Organization
VDC node. As a result, the restore operation cannot
Rename the virtual machine so that it does not ends proceed.
with period.
ANS2123W Issue the dsmc SET PASSWORD - System action
type=VCD 'vCloud Director The operation stops.
hostname' 'userid' 'password'
command to save an encrypted
password. User response
Verify that the specified organization, organization
Explanation VDC, and vApp are correct.
The VCDPW option was found either in an options file ANS2127E The snapshot data that is required
or as a command- line entry. Although both methods to restore 'vapp name' cannot be
of entry are allowed, they present a security risk retrieved from the IBM Spectrum
because the password is in plain text and is not Protect Server.
encrypted.
Explanation
System action
The required snapshot data was unable to be retrieved
The option is accepted and the VCD password is used from the IBM Spectrum Protect Server.
in the current session.
System action
User response
The operation stopped.
To save an encrypted password, issue the following
command: User response
dsmc SET PASSWORD -type=VCD 'VirtualCenter
hostname' 'userid' 'password' Check the dsmerror.log file for information about why
the data was not retrieved. Then, try the operation
ANS2124W Client node replication table is again. If the problem persists, visit the IBM Support
locked by another process.

Chapter 2. ANS 0000-9999 messages 181

Portal for additional information at http:// User response
www.ibm.com/support/entry/portal/.
Contact the IBM Spectrum Protect server
ANS2128E Failed in creating a restored administrator to verify if the primary server is
version of vApp 'vapp name'. available. If the primary server is available, check the
error log for communications failures and correct any
Explanation configuration issues.

The operation to create a restored vApp on the vCloud ANS2136E Operation not permitted. The
failed. The data associated with the vApp snapshot secondary server reports the
might not be complete. primary server is available. Quit
and restart the IBM Spectrum
Protect client and retry the
System action
command.
The operation stops.
Explanation
User response
The server has prevented a store operation on the
Check the dsmerror.log file for information about why secondary IBM Spectrum Protect server. The
the operation failed. Then, try the operation again. If secondary server reports that the primary server is
the problem persists, visit the IBM Support Portal for available. However, the IBM Spectrum Protect client
additional information at http://www.ibm.com/ failed over to the secondary server.
support/entry/portal/.
ANS2129E A VM you tried to rename 'rename' System action
did not appear in the list of VMs to Processing stops.
restore 'list'.
User response
Explanation
Restart the IBM Spectrum Protect client and verify the
The VMNAME option for parallel restores requires primary server connection is made. If the IBM
pairing the name and rename fields together. You Spectrum Protect client is unable to connect to the
cannot rename a VM which you are not attempting to primary server, contact the IBM Spectrum Protect
restore. server administrator to verify if the primary server is
available. If the primary server is available, check the
System action error log for communications failures and correct any
configuration issues.
The operation will not begin.
ANS2138E Failed in restoring the vApp
User response properties to vApp: 'vapp name'.

Verify the syntax of the command and spelling of the

Explanation
VMs you are trying to restore.
The vApp properties were not restored to the created
ANS2135E The node on the IBM Spectrum vApp. This failure might be caused by a problem in the
Protect server is in read only backed up vApp or in its metadata.
mode.
System action
Explanation
The operation completes. However, it is possible that
The server has prevented a store operation on the IBM the restored object does not contain all of the
Spectrum Protect server. The most likely explaination expected content.
for this is the node has failed over to the secondary
server.
User response
System action Check the backed up vApps on the vCloud. In addition,
check the dsmerror.log file for any additional
Processing stops. messages that might be related to this problem. Try
the operation again. If the problem persists, visit the

182 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
IBM Support Portal for additional information at http:// ANS2147E The virtual machine named 'name'
www.ibm.com/support/entry/portal/. already exists on the target
system.
ANS2143E vApp verification failed. Data
inconsistency was found.
Explanation
Explanation The virtual machine cannot be restored because the
name already exists on the target system.
During the verification of a vApp, an inconsistency was
found in the backup data.
System action
System action Processing stops for this virtual machine
The restore operation was stopped.
User response
User response Use the -vmname option to rename the virtual
machine.
Examine the client error log for any additional
messages that might be related to this problem and ANS2148I Virtual machine templates cannot
contact IBM Spectrum Protect technical support for be backed up in incremental
further assistance. mode, switching to full mode.
ANS2145W Warning - updating an existing
virtual machine named 'name'. Explanation
The restore operation continues. The backup of virtual machine templates are only
supported as full backups.
Explanation
The virtual machine exists and will be updated with System action
the disks specified. Processing continues in full mode for this template
virtual machine.
System action
The virtual machine will be updated by the restore User response
operation. To back up this virtual machine template use full
mode.
User response
ANS2149E The restore operation for this
No user action is necessary. virtual machine to the target ESX/
ESXi host is not supported
ANS2146E The target vCenter or ESX/ESXi
because virtual machine hardware
host is no longer supported, for
version is incompatible.
virtual machine backups, by this
version of IBM Spectrum Protect.
Explanation
Explanation The target ESX/ESXi host does not support the virtual
hardware version of the virtual machine. As a result, a
The target vCenter or ESX/ESXi host is no longer
restore of the specified virtual machine to this host is
supported, for virtual machine backups, by this version
not supported.
of IBM Spectrum Protect.

System action
System action
Processing stops for this virtual machine.
Processing stops for this virtual machine.

User response
User response
Specify another virtual machine to restore or specify
Specify another target vCenter or ESX/ESXi host that is
another target ESX/ESXi host that supports virtual
supported by this version of IBM Spectrum Protect.
hardware version of the virtual machine.

Chapter 2. ANS 0000-9999 messages 183

ANS2150E Set ANS2157E The server 'server-name' was not
HSMDISABLEAUTOMIGDAEMONS removed from the environment.
YES in the dsm.opt file to use HSM
multi-server functionality. Explanation
The requested IBM Spectrum Protect server was not
Explanation
added to the multi-server environment.
Set HSMDISABLEAUTOMIGDAEMONS YES in the There are several causes for this error:
dsm.opt file to use HSM multi-server functionality.
• The file system is not managed by HSM.
• The HSM management is not active for the file
System action
system.
HSM multi-server processing stops. • The IBM Spectrum Protect server is the default
server for the file system and must be removed last.
User response
• The IBM Spectrum Protect server name is not valid.
Set HSMDISABLEAUTOMIGDAEMONS YES in dsm.opt.
ANS2155W Skipping file 'file-name'. File System action
related to 'server-name'. HSM multi-server processing stops.

Explanation User response

File is already coupled to another server. Eliminate the possible causes for this issue and retry.
ANS2158E The server 'server-name' was not
System action
added to the environment.
HSM continues with normal operation. You must first add the default IBM
Spectrum Protect server ('default-
User response server-name') for this file system.

Use the correct server to process the file.

Explanation
ANS2156E The server 'server-name' was not The requested IBM Spectrum Protect server was not
added to the environment. added to the multi-server environment.
The requested IBM Spectrum Protect server is not the
Explanation default server for the file system.
The requested IBM Spectrum Protect server was not
added to the multi-server environment. System action
There are several causes for this error: HSM multi-server processing stops.
• The file system is not managed by HSM.
• The HSM management is not active for the file User response
system. Add the default IBM Spectrum Protect server first.
• The file system is out of space.
ANS2159I The server 'server-name' was
• The default IBM Spectrum Protect server for the file added to the environment.
system was not yet added to the multi-server
environment.
Explanation
• The IBM Spectrum Protect server name is not valid.
The requested IBM Spectrum Protect server was
added to the multi-server environment.
System action
HSM multi-server processing stops. System action
HSM multi-server processing continues.
User response
Eliminate the possible causes for this issue and retry. User response
None.

184 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2160I The server 'server-name' was The IBM Spectrum Protect server list for multi-server
removed from the environment. will be empty after this step.

Explanation System action

The requested IBM Spectrum Protect server was HSM processing continues without multi-server
removed from the multi-server environment. support.

System action User response

HSM multi-server processing continues. nothing.
ANS2165I The server 'server-name' is the
User response default server and has been
None. removed last.

ANS2161E The server 'server-name' is not a Explanation

valid IBM Spectrum Protect server
for this environment. The requested IBM Spectrum Protect server was
removed from the multi-server environment.
Explanation
System action
The requested IBM Spectrum Protect server was not
added to the multi-server environment. HSM multi-server processing continues.

System action User response

HSM multi-server processing stops. None
ANS2166I The IBM Spectrum Protect server
User response 'server-name' is not included in the
Check the dsm.sys file for the correct IBM Spectrum multi-server environment.
Protect server name.
Explanation
ANS2162E HSM cannot be removed from the
file system. The IBM Spectrum The requested IBM Spectrum Protect server is not part
Protect multi-server list is not of the multi-server environment.
empty.
System action
Explanation HSM multi-server processing continues.
HSM management was not removed from the file
system. User response
None.
System action
ANS2167W Can not read SERVERNAME
HSM processing continues.
attribute.

User response
Explanation
Remove all IBM Spectrum Protect servers from the
IBM Spectrum Protect cannot read the SERVERNAME
multi-server list before removing HSM.
attribute from file.
ANS2163E The default IBM Spectrum Protect
server ('server-name') for the file System action
system will be removed.
HSM multi-server processing continues.
Explanation
User response
The default IBM Spectrum Protect server will be
removed. None.

Chapter 2. ANS 0000-9999 messages 185

ANS2168W Can not write SERVERNAME User response
attribute. Use the documentation to identify the supported
DMAPI versions. Install a supported DMAPI and retry
Explanation the HSM command or process.
IBM Spectrum Protect cannot write SERVERNAME ANS2172E Command not supported in
attribute to file. HSMBACKENDMODE TSMFREE.

System action Explanation

HSM multi-server processing continues. That command is not supported using an external HSM
backend.
User response
None. System action

ANS2169E Skipping - Requested server is not Exit programm

included in multi-server
environment for filesystem 'file- User response
system'. Do not use the command

Explanation ANS2173E Volume 'volume name' from vFiler

'vFiler name' is mounted using AIX
The requested IBM Spectrum Protect server is not part NFS version 4. This configuration
of the multi-server environment. is not supported for snapshot
difference incremental backups.
System action
HSM multi-server processing continues. Explanation
Snapshot difference incremental backups are not
User response supported for vFiler volumes mounted using AIX NFS
version 4.
None.
ANS2170W Skipping - file linked to another System action
server.
Snapshot difference incremental backup fails.
Explanation
User response
The file is already coupled to another IBM Spectrum
Protect server. This problem is documented by NetApp BURT
630200. Apply the fix for this once it is available from
NetApp. Specify "testflag snapdiffenablevfilernfs4" in
System action dsm.opt file and retry the snapshot difference
HSM continues with normal operation. incremental backup.
ANS2174E Conflicting options HSMLOGMAX
User response and HSMLOGRETENTION were
Use the correct server to process the file. specified.

ANS2171E The DMAPI version 'dmapi-version' Explanation

is not supported.
Values were specified for both the HSMLOGMAX and
Explanation the HSMLOGRETENTION options. These options are
mutually exclusive.
The DMAPI version installed on this node is not
supported from the given IBM Spectrum Protect client. System action

System action Processing stops.

Due to this issue the affected HSM process ends.

186 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Specify a nonzero value for HSMLOGMAX if you wish to The restore was not performed.
have the IBM Spectrum Protect hsm log wrap when it
reaches the specified maximum value. Use User response
HSMLOGRETENTION if you wish you have the hsm log
limited in size on a time-based schedule. Execute the required restore command again,
considering that the given name for the restored vApp
ANS2175I Data from server 'server-name' is not used.
should be recalled using the script
'dsmMultiServerRemove.pl'. ANS2181I Option primary server; saved.

Explanation Explanation

Migrated files must be recalled before a server can be This node is configured for replication. The primary
removed from the multiserver configuration. server name option is now saved to the options file.
The replication server options are set by the IBM
Spectrum Protect Administator, sent to the client
System action
during logon, and are saved to the options file.
The server will not be removed.
System action
User response
Processing continues.
Check the documentation for detailed information
about the 'dsmMultiServerRemove.pl' script. User response
ANS2176E The sample journal configuration None.
file '' could not be copied to ''.
ANS2182I Option secondary server; saved.
Explanation
Explanation
The IBM Spectrum Protect Journal Engine setup
wizard tried to create a new journal configuration file This node is configured for replication. The replication
by copying the sample configuration file. However the server option is now saved to the options file. The
sample configuration file could not be successfully replication server options are set by the IBM Spectrum
copied. Protect Administator, sent to the client during logon,
and are saved to the options file.
System action
System action
The IBM Spectrum Protect Journal Engine setup
wizard stops. Processing continues.

User response User response

Manually copy the sample journal configuration file None.

"config\tsmjbbd.ini.smp" to "baclient\tsmjbbd.ini", ANS2183E Organization 'Org name' not found
then try the IBM Spectrum Protect Journal Engine in the vCloud Director.
setup wizard. The "baclient" and "config" directories
can be found in the directory where you installed the
IBM Spectrum Protect Backup-Archive Client. For Explanation
example, "C:\Program Files\Tivoli\TSM\baclient" and The specified Organization is not recognized by the
"C:\Program Files\Tivoli\TSM\config" vCloud Director.
ANS2177E The vCloud vApp named 'vapp
name' already exists on the target System action
system. The action requested for the organization is canceled.

Explanation
The restore vApp command does not support restoring
a vApp with an existing name.

Chapter 2. ANS 0000-9999 messages 187

User response User response
Verify that an organization by the specified name Verify that the values of the VCDHOst and VCDPort
exists in the vCloud. Organization names are case- options are valid, network connectivity to the host
sensitive. exists, and that the vCloud Director service is running.
ANS2184E Organization VDC 'Org vDC name' ANS2188E The vCloud protection runtime
not found in organization 'Org library is not installed or failed to
name'. load.

Explanation Explanation
The specified organization VDC is not part of the The vCloud runtime library is not installed or cannot be
specified organization. loaded.

System action System action

The action requested for the organization VDC is vCloud operations cannot be performed.
canceled.
User response
User response
Verify that the IBM Spectrum Protect for Virtual
Verify that an organization VDC by the specified name Environments vCloud runtime library is installed. If
exists in the specified organization. Organization and neccessary, reinstall IBM Spectrum Protect for Virtual
organization VDC names are case-sensitive. Environments.
ANS2185E Failed to log on to the vCloud ANS2189E The vCloud protection runtime
Director on 'vCD host name' with library cannot be initialized.
user name 'vCD user name':
Authentication failed. Explanation
The vCloud protection runtime library failed to
Explanation
initialize. This issue might be caused by the Java
The vCloud credentials specified in the VCDUser and runtime not being installed.
VCDPass options were rejected by the vCloud director.
System action
System action
vCloud operations cannot be performed.
vCloud operations cannot be performed.
User response
User response
Verify that Java is installed.
Update the VCDUser and VCDPass options with valid
ANS2190E The vCloud protection runtime
credentials for the vCloud Director.
library encountered an internal
ANS2187E Failed to establish connection to error.
the vCloud Director on 'vCD host
name'. Explanation
An internal error had occured in the vCloud runtime
Explanation
library.
A connection cannot be established to the vCloud
Director on the host that is specified by the VCDHost System action
and VCDPort options.
vCloud operations cannot be performed.
System action
User response
vCloud operations cannot be performed.
Check the dsmerror.log file for any additional
messages that might be related to this problem. Try
the operation again. If the problem persists, visit the

188 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
IBM Support Portal for additional information at http:// User response
www.ibm.com/support/entry/portal/.
Make sure that the specified vApp is correct. Then, try
ANS2191E An error occurred creating the the restore operation again.
default VSS staging directory
ANS2194E The snapshot data is incomplete
'path'.
for vApp 'vapp name'.

Explanation
Explanation
The IBM Spectrum Protect client uses an VSS staging
Inconsistent data was found in the backed up vApp. It
directory to store files related to to VSS snapshot
is not possible to restore the specified vApp.
operations. The IBM Spectrum Protect client was
unable to create this directory structure.
System action
System action The restore was not performed.
The IBM Spectrum Protect client stopped.
User response
User response Check the dsmerror.log file for any additional
messages that might be related to this problem. If the
If the problem persists, contact IBM technicalsupport
problem persists, visit the IBM Support Portal for
for further assistance.
additional information at http://www.ibm.com/
ANS2192E Failed to read the node support/entry/portal/.
configuration information from
ANS2195E The number of VMs that are
node 'node name'.
available for restore is different
from expected according to the
Explanation vApp 'vapp name' metadata.
Node mapping information is required for this vCloud
operation. However, the mapping information either Explanation
does not exist or cannot be read from the specified
Inconsistent data was found in the vApp metadata. It
node.
is not possible to restore the specified vApp. More VMs
have been backed up than are now available for
System action restore. This may happen due to incomplete node
The operation is canceled. replication or if a file space was deleted.

User response System action

Make sure that you are accessing the correct node. The restore was not performed.
The node mapping information is stored in the
Provider VDC node. If necessary, go to the User response
Configuration page and click 'Run the Configuration
Check the dsmerror.log file for any messages that may
Wizard' to make corrections to the node mapping.
indicate the problem. Run a detailed query for this
ANS2193E The required filespace for the vApp to verify that all VMs backups exist. If node
vApp 'vapp name' backup does not replication is used, ensure it is working correctly. If the
exist. problem persists, visit the IBM Support Portal for
additional information at http://www.ibm.com/
Explanation support/entry/portal/. Contact IBM Spectrum Protect
administrator for more information.
No filespace exists for the specified vApp backup.
ANS2196W An incompatible disk
configuration is detected for the
System action
following disk: 'disk name'. The
The restore was not performed. individual database restore for the
following database is not
supported:'database name'.

Chapter 2. ANS 0000-9999 messages 189

Explanation User response
One or more database files in this operation are If the number of VMs backed up is less than the total
located on the dynamic or GUID Partition Table (GPT) in the vApp please check the error logs for more
disks. In this configuration, individual database restore information.
is not supported.
ANS2200I ***** Filling Cache count files
*****
System action
Backup of the full VM continues. Explanation
IBM Spectrum Protect the specified number of files
User response have been added to the disk cache.
To restore the environment to the previous statue,
issue a full VM restore. System action
ANS2197E The verification test of vApp 'vapp Processing continues.
name' indicates that VM data is
incomplete in the vApp. The vApp User response
cannot be restored.
None.
Explanation ANS2201I ***** Inspecting Cache count
Inconsistent data was found in the VM for the files *****
specified vApp. It is not possible to restore the
specified vApp. This may happen due to incomplete Explanation
node replication or if a file space was deleted. IBM Spectrum Protect the specified number of files
have been examined in the disk cache.
System action
Operation continues. System action
Processing continues.
User response
Check the dsmerror.log file for any additional User response
messages that might be related to this problem. Run a None.
detailed query for this vApp to verify that all VMs
backups exist. If node replication is used, ensure it is ANS2202E Disk Full Error Accessing Disk
working correctly. If the problem persists, perform a Cache.
FULL new backup of the vApp and visit the IBM
Support Portal for additional information at http:// Explanation
www.ibm.com/support/entry/portal/. Contact IBM
Spectrum Protect administrator for more information. A disk full error occurred attempting to access or write
to the specified disk cache file during a disk cache
ANS2198I Backup of VMware vCloud Director incremental backup. See the client error log for more
vApp 'vApp name' in Organization detailed information.
VDC 'Org VDC name' of
organization 'Org name' completed System action
successfully. VMs: number of VM
backed up out of number of VMs in Processing stops.
vApp VMs backed up successfully.
User response
Explanation This error can be resolved by freeing up space in the
The backup operation completed. The number of VMs file system containing the cache file, or specifying a
backed up and the total number of VMs in the vApp are different location for the cache file. Use the
displayed. diskcachelocation option to specify the location of the
cache file.
System action ANS2203E Error Accessing Disk Cache.
This message is for informational purposes only.

190 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation the tag value. The maximum value that you can specify
is 10 for either type of snapshot attempts. The
An error occurred attempting to access the specified
minimum value that you can specify is 0, but both
disk cache file during a disk cache incremental
numbers cannot be 0.
backup. See the client error log for more detailed
information. IBM Spectrum Protect.
System action
System action The operation continues with the default number of
quiescing and nonquiescing attempts (2,0).
Processing stops.

User response
User response
Change the pair of numbers in the tag so that the
None.
number of quiescing and nonquiescing attempts is
ANS2204E Disk cache restarted. between 0-10, and that both numbers cannot be 0.
ANS2218I The encryption key password for
Explanation node node name and server server
The length of an object name exceeded the configured name has been migrated.
disk cache key length during a disk cache incremental
backup. The backup must be restarted.. IBM Spectrum Explanation
Protect.
The format of the IBM Spectrum Protect password file
has recently changed. The option
System action MIGRATEENCRYPTKEY is set and the stored
Backup is restarted with a larger key length to encryption key password was automatically migrated
accommodate the object name. to the new format. This message confirms that the
migration was successful.
User response
System action
None required. The name of the object that caused the
failure can be found in the dsmerror.log file. The encryption key password has been migrated.

ANS2206W The user must have root authority User response

to use the memory efficient
backup disk cache method. The No response.
operation will continue using
ANS2219E Cannot backup or archive files into
memory efficient backup method
filespace because it is owned by a
without disk caching.
IBM Spectrum Protect API
application.
Explanation
None. Explanation
IBM Spectrum Protect Client cannot archive or backup
System action files into a file space that is used a IBM Spectrum
The operation continues without using disk caching. Protect API application.

User response System action

None. Processing stops.

ANS2213W The virtual machine 'vm-name' is User response

configured with an invalid number
of snapshot attempts specified by Use separate node names for IBM Spectrum Protect
the tag 'tag' for category 'cat'. Client and IBM Spectrum Protect API application(s).
ANS2220E The cluster disk could not be put
Explanation in maintenance mode.
An invalid number of snapshot attempts is specified
for the quiescing or nonquiescing snapshot attempts in

Chapter 2. ANS 0000-9999 messages 191

Explanation Explanation
The system call to put the cluster disk in maintenance For security, the client will not accept server-initiated
mode failed. sessions from servers that have authentication turned
off.
System action
System action
Processing stopped.
The client-server session is not opened, and the
User response schedule is not executed. The scheduler continues to
wait for contact by a server that has authentication
Try the operation again. If the problem continues, turned on.
check the client error log for any other messages that
might have been logged when this message was
User response
written, and take the corrective action (if any)
suggested by those messages. Examine the Windows If the client system is supposed to accept scheduled
event log which may contain additional information. events from the prompting IBM Spectrum Protect
See your system administrator or IBM Spectrum server, either ask the IBM Spectrum Protect server
Protect administrator for further help. administrator to turn authentication on, or do not use
server-initiated sessions.
ANS2221W Java was not able to resolve the IP If the client system is not supposed to accept
address of your local machine scheduled events from the prompting server, ask the
due to network misconfiguration IBM Spectrum Protect server administrator to remove
problems! the client node name from the schedule on the
Please verify your network and prompting server.
DNS configuration are setup
correctly. ANS2225W User has specified
Note that on UNIX machines the 'SNAPSHOTROOT' option.
hostname must be reported snapshot provider snapshot
correctly (the same) backup is not valid in conjunction
for IPv4 and IPv6 communication with this option.
methods in the /etc/hosts "SNAPSHOTROOT option will take
configuration file. precedence and processing will
IBM Spectrum Protect processing continue without the use of a
continues. snapshot taken internally by IBM
Spectrum Protect.
Explanation
Explanation
Java was not able to get the local host address due to
network misconfiguration problems. The (-SNAPSHOTROOT) option is incompatible with
IBM Spectrum Protect snapshot providers such as
System action Logical Volume Snapshot Agent, VSS snapshot
provider, JFS2 snapshot provider etc. which provide a
Processing continues. comprehensive snapshot solution withot having to use
the (-SNAPSHOTROOT) option. It is strongly
User response recommended that the snapshot capabilities provided
by the IBM Spectrum Protect snapshot providers be
Please verify your network and DNS configuration are
used instead of using the (-SNAPSHOTROOT) option.
setup correctly. Note that on UNIX machines the
Processing will continue without the use of the IBM
hostname must be reported correctly (the same) for
Spectrum Protect snapshot providers.
IPv4 and IPv6 communication methods in the /etc/
hosts configuration file. See your system administrator
or IBM Spectrum Protect administrator for further System action
help. Processing continues without the use of the IBM
ANS2223W Rejected unauthenticated server- Spectrum Protect snapshot providers.
initiated session from peer name.

192 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response completed. Some VMs were not
backed up. VMs: number of VM
See the appropriate Using the Backup-Archive Client
backed up out of number of VMs in
book for your operating system for correct use of the
vApp VMs backed up successfully.
named option.
ANS2226W The virtual machine 'vm-name' is Explanation
configured with an invalid hard
disk list, specified by the tag 'tag' The vApp backup operation completed successfully.
for category 'cat'. However, one or more VMs for the specified vApp were
not backed up. These VMs will not be created during
the restore operation.
Explanation
An invalid hard disk number is specified in the disk System action
backup list tag value. The minimum hard disk number
that you can specify is 1 and the maximum hard disk Processing continues to the next vApp.
number that you can specify is 999. Also, the hard disk
numbers must be comma separated positive integer User response
values. Check the log file for this vApp for more information
about this message. Resolve the problem, then try the
System action operation again.
Processing stopped. ANS2229E Failed to initialize the vCloud
protection environment. See the
User response local client error log for detailed
error message information.
Change the hard disk list tag so that the hard disk
numbers are between 1-999, and are listed as comma
separated values. Explanation

ANS2227W Server option 'option-name' The vCloud protection package could not be initialized.
'option-value' has not been applied
on the client due to the client System action
option The operation is stopped
SRVOPTSETENCRYPTIONDISABLE
D.
User response
Explanation Make sure all options that are related to the vCloud
environment are specified correctly. Check the
When the client option dsmerror.log file for detailed information.
SRVOPTSETENCRYPTIONDISABLED is set to YES on
the client it prevents the IBM Spectrum Protect ANS2230E Failed to create vApp list
administrator from setting one of the following client according to spec 'vApp
options ENCRYPTIONTYPE, EXCLUDE.ENCRYPT, specification'
INCLUDE.ENCRYPT. The client option setting
ENCRYPTKEY GENERATE is also prevented, but the Explanation
client option settings ENCRYPTKEY PROMPT and
ENCRYPTKEY SAVE are not prevented. The vApp list was unable to be retrieved from the
vCloud Director.
System action
System action
The option is ignored.
The operation is stopped
User response
User response
None.
Make sure the values specified in the VCDHost,
ANS2228W Backup of VMware vCloud Director VCDUser, VCDPW, and DOMAIN.VCD options are
vApp 'vApp name' in Organization correct. Make sure the vCloud Director is alive.
VDC 'Org VDC name' of
organization 'Org name'

Chapter 2. ANS 0000-9999 messages 193

ANS2231I The IBM category 'cat' was not User response
found. Create the required IBM tags in the VMware vSphere
web client or disable the data mover option
Explanation 'VMTAGDATAMOVER' in the client options file.
The IBM Spectrum Protect option ANS2234W Restore from virtual machine
'VMTAGDATAMOVER' is enabled so that IBM backup 'vm-name' is not available
categories and tags can be applied to virtual machines, for database 'db-name'. reason
but the IBM category was not found.
Explanation
System action
Restore from virtual machine backup is not supported
The backup operation continues without tagging for in-guest application databases for one of the
support. following reasons:
• Database files are located on the dynamic disks,
User response
GUID Partition Table (GPT) disks, iSCSI disks or
Create the required IBM categories in the VMware other Network Attached Storage devices.
vSphere web client or disable the data mover option • Microsoft Exchange Server databases are in the
'VMTAGDATAMOVER' in the client options file. dismounted state during virtual machine backup.
ANS2232E Failed to retrieve the list of VMs • Microsoft Exchange Server databases are in the
for vApp 'vApp name' from the unhealthy state or with unhealthy database copies.
vCloud Director. • Microsoft Exchange Server databases are being
backed up by a different server at the same time.
Explanation
• When vmPreferDagPassive option is set to YES,
The VM information for the specified vApp was not Microsoft Exchange Server databases are active
retrieved from the vCloud Director. This failure might copies on the current server and have a healthy
be caused by the vCloud Director not being alive or passive copy on another server.
accessible. • Microsoft Exchange Server Exchange databases are
in the unknown state because IBM Spectrum Protect
System action is not able to determine the database health status
during virtual machine backup.
The VMs that compose the specified vApp are not
backed up. Processing continues to the next vApp.
System action
User response The backup operation of the full virtual machine
continues.
Make sure that the vCloud Director is alive and
accessible. Check the dsmerror.log file for specific
errors that are related to this issue. User response

ANS2233I The IBM tag 'tag' for category 'cat' Take one or more of the following actions to resolve
was not found. the issue:
• Move the database files to disks that are supported
Explanation by in-guest application protection.
The IBM Spectrum Protect option • Mount the dismounted Microsoft Exchange Server
'VMTAGDATAMOVER' is enabled so that IBM databases before the virtual machine backup.
categories and tags can be applied to virtual machines, • Repair the Microsoft Exchange Server databases in
but the IBM tag was not found. the unhealthy states.
• Use the VMTSMVSS trace flag on the data mover to
System action trace database health status processing during
The operation continues without tagging support. virtual machine backup operations.
ANS2236I The virtual machine 'VM-name'
contains one or more disks that
exceed the maximum size set by
the VMMAXVIRTUALDISKS option.

194 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 These disks will be excluded from Explanation
the backup.
The IBM Spectrum Protect client does not back up
VMDKs or VHDXs that are larger than the maximum
Explanation size.
The IBM Spectrum Protect client does not back up
VMDKs that are larger than the maximum size. System action
The virtual machine is not backed up.
System action
The virtual machine is backed up; however, the disks User response
that exceed the limit are excluded from the backup.
Use the VMMAXVIRTUALDISKS option to change the
ANS2238E VCDHOST option must be set maximum size or specify the '-
before running this operation. VMSKIPMAXVIRTUALDISKS=yes' option to exclude
these disks from the backup.
Explanation ANS2245E Virtual machine backups and
VCDHOST option is missing. restores are not supported on 32
bit data movers.
System action
Explanation
Operation cannot continue without this option being
set. Virtual machine operations such as backups and
restores are not supported on 32 bit Data Movers.
User response
System action
Add the option to the client options file, either via the
preferences editor or by manually editing the file, or The operation is not performed.
specify the option on the command line.
User response
ANS2242E No nodes were found that
matched the input specification: Update to a 64 bit Data Mover and retry the operation.
node specification
ANS2246W Failed to disable maintenance
mode for vApp vApp name.
Explanation
An invalid node specification was entered. Explanation
The client has tried to disable the maintenance mode
System action of this vApp. This operation failed.
The operation was stopped.
System action
User response Operation continues.
Check documentation how to specify nodes.
User response
ANS2244W The virtual machine contains one
or more disks that exceed the Check whether the vApp is still in maintenance mode.
maximum size set by the If yes, disable it manually.
VMMAXVIRTUALDISKS option.
ANS2247E ASNODENAME option must be
You can use the
specified when running this
VMMAXVIRTUALDISKS option to
command.
change the maximum size or
specify the '-
VMSKIPMAXVIRTUALDISKS=yes' Explanation
option to exclude these disks from When running vCloud-related commands,
the backup. ASNODENAME option must specify the Provider vDC
node.

Chapter 2. ANS 0000-9999 messages 195

System action ANS2250W A IBM Spectrum Protect core file
or crash report was found:
Operation cannot continue.
filename

User response
Explanation
Specify the Provider vDC node as ASNODENAME to the
The presence of a core dump or crash report indicates
command.
a process has abnormally terminated.
ANS2248E Failed to load or initialize the Java
runtime library. System action
The core file or crash report name is reported in the
Explanation
message. Processing continues.
The Java runtime library (libjvm), required by the
vCloud Protection environment, cannot be loaded, or User response
initialization of Java runtime environment failed
Review the error log for any other error messages that
may help diagnose the cause of the core dump. If
System action
possible, correct any issues found. As a core dump is
Operation is stopped generally caused by a programming error, save the file
noted in this message and contact IBM technical
User response support.

For Linux operating system, verify that a link named ANS2253W The version of the message
'jre', referencing the 'jre' directory under your Java catalog, catalogversion, in use by
installation path, exists in the backup-archive client IBM Spectrum Protect does not
installation directory. If a link does not exist, create match the version of IBM
the link (e.g. ln -s /opt/ibm/java-x86_64-70/jre /opt/ Spectrum Protect, clientversion
tivoli/tsm/client/ba/bin/jre). Alternatively, modify
LD_LIBRARY_PATH to include the path to libjvm.so Explanation
(e.g. export LD_LIBRARY_PATH=
$LD_LIBRARY_PATH:/opt/tivoli/tsm/client/ba/ A check of the catalog version indicates the catalog
bin:/opt/ibm/java-x86_64-70/jre/bin/classic). For and IBM Spectrum Protect are not the same version.
Windows operating system, verify that the JRE This may lead to missing or incorrect messages being
directory exists under the client installation directory. used.
Reinstall the backup-archive client if necessary.
System action
ANS2249W A virtual machine named
'vmname' exists on this system. Processing continues.
Do you want to replace the
existing virtual machine? User response
Review the installation of IBM Spectrum Protect, verify
Explanation the message catalog files match the installed version
Restoring this virtual machine will stop and delete the of IBM Spectrum Protect. Re-installation of IBM
existing virtual machine and all of its files. To protect Spectrum Protect may be required, or a system reboot
application data, stop any applications that are may be required to complete the installtion.
running, and then shut down the virtual machine ANS2254E program-name with session id
before you restore it. sessid aborted recall for token
token. ERRNO errno : errno-text
System action was set. See message
If the user chooses to continue, the system will stop explanation.
and delete the existing virtual machine and all of its
files. Explanation
A recall was aborted from HSM. The ERRNO set from
User response HSM explains why the recall was aborted.
Choose whether to replace the existing virtual Transient errors (The operation must be retried after
machine. the associated problem was solved):

196 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ENOSPC : No space left on device. HSM couldn't free System action
space for the recall.
processing stops
ENOMEM : Not enough memory available to acquire
the required resocurces for the recall.
ESRCH : The internal communication between master User response
and distributor failed. Try to use MAXRETRIESLOCK test flag to increase
EACCES : Most common errno. One of the failures number of attempts to lock the file. The default value
below: is 1500.
- The recall daemon are exiting. System cleanup
ongoing. ANS2261E IBM Spectrum Protect client failed
- Recovery of previously failed nodes is ongoing. to lock options file.
- File is immutable and can't be opened for write /
truncate. Explanation
- The HSM internal processing failed due to issues with
In multi-process environment IBM Spectrum Protect
the DMAPI.
client locks the options file during initialization to avoid
EBUSY : HSM can't acquire exclusive rights on the file.
conflicts on reading or adding an option.
EFAULT : The system detected an invalid address in
attempting to use an argument.
EINTR : The DMAPI implementation allows System action
interruption and the process was interrupted. processing continue
EINVAL : The requested right is not valid or the session
or token is not valid or token was DM_NO_TOKEN.
User response
Static errors (The operation can't be fullfilled. Recall
not possible): Try to decrease a number of IBM Spectrum Protect
EIO : The stub file is orphan. client processes
ENOENT : The file doesn't exist in the file system.
EBADF : The file handle does not refer to an existing or ANS2262I The service is starting.
accessible object.
Explanation
System action The file restore service is starting.
The recall request was aborted from the HSM service.
System action
User response Processing continues.
Transient errors:
Solve problem indicated from the errno. On GPFS User response
platforms: Use command dsmmigfs q -d -n=all to
No action is required.
verify HSM and GPFS are running properly.
Retry the recall operation if failed file can be identified. ANS2263I The service started.
Enable HSM Logging if failed failed file cannot be
identified and wait for new occurrence. Explanation
(HSM Logging allows you to map between the token
displayed from the ANS message and the recalled file) The file restore service started.
Static errors:
Restore the file from backup. System action
ANS2260E Failed to lock IBM Spectrum Processing continues.
Protect password file.
User response
Explanation No action is required.
In multi-process environment IBM Spectrum Protect
ANS2264I The shutdown is in progress.
client locks the password file during authentication to
avoid conflicts on updating password in case the
currect password is expired. Explanation
The shutdown is in progress.

Chapter 2. ANS 0000-9999 messages 197

System action Explanation
Processing continues. The mount proxy node requires a TCP/IP port address.
This address is used for communication by the client
User response acceptor on the mount proxy node.

No action is required. • If a local mount proxy node is used, the TCP/IP port
address that was specified with the configuration
ANS2265I The service is shutting down. wizard or notebook is invalid.
• If a remote mount proxy node is used, the
Explanation default_mp_httpport option in the frConfig.props file
The file restore service is shutting down. is either not specified or is invalid.
Communication with the client acceptor cannot start.
System action
Processing continues. System action
Processing stops.
User response
No action is required. User response

ANS2266I The option 'option-name' is set to If a local mount proxy node is used, use the Mount
the default value of 'default-value'. Proxy Node Pairs page in the configuration wizard or
notebook to remove the mount proxy node. Then, add
the mount proxy node again to resolve this issue.
Explanation
If a remote mount proxy node is used, ensure that the
An error was detected with the option value. default_mp_httpport option is specified in the
frConfig.props file with a valid TCP/IP port address.
System action
ANS2269E The maximum number of backups
The default setting is used. were loaded. If a restore is
running, wait for it to complete
User response and load the backup again. If the
backup is loaded in another
To use a non-default value, correct the option value in
browser window, close that
the frConfig.props file.
browser.
ANS2267W The 'option-name' option value
'invalid-value' is invalid. Explanation
To mount another backup, one of the mounted
Explanation backups must be dismounted.
An error was detected with the option value.
System action
System action Processing stops.
The default setting is used.
User response
User response Dismount one of the mounted backups and try the
To use a non-default value, correct the option value in operation again.
the frConfig.props file. Then, restart the web server
ANS2271W Unsuccessful deletion of archived
that is hosting the file restore interface.
file fshlll
ANS2268W The TCP/IP port address on the
mount proxy node cannot be Explanation
located or is invalid.
An attempt to delete the archived file was
unsuccessful.

198 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Processing continues. Each operation type recognizes a different set of
column names in a Comma Separated Values (CSV)
User response file. The specified column is not used by the current
operation.
Check the console or schedule log for additional
information. Retry the operation at a later time.
System action
ANS2272E The Comma Separated Values The column that the operation could not recognize is
(CSV) file specified 'CSV_file' could ignored. The operation continues.
not be found or opened.

User response
Explanation
Change the name if it the column is misspelled.
The CSV option uses a Comma Separated Values (CSV) Otherwise, no action is needed. You can also simply
file as input for this operation. The specified CSV file remove the column.
could not be found or opened.
ANS2275W The element 'element_name' in the
System action column labeled 'column_title' in
the Comma Separated Values
The operation has stopped. (CSV) file can not be used in this
operation. Row elements must be
User response unique for each column.
Check that the file path is correct and that the file
permissions allow read access. Try the operation Explanation
again. The operation requires that each element in the
ANS2273E The Comma Separated Values Comma Separated Values (CSV) file is unique for that
(CSV) file has two or more columns column. For example, if two rows contained the same
'column_title' with the same title. value for "Virtual Machine Name", inconsistent
Duplicate column names are not instructions could be applied to that VM.
allowed.
System action
Explanation The operation has stopped.
The specified operation, started from a Comma
Separated Values (CSV) file, requires unique columns. User response
For example, if you specify the column "New Host" Remove the row that contains the duplicate element.
twice, the operation cannot determine which value to Try the operation again.
use.
ANS2276E The Comma Separated Values
System action (CSV) file 'file_name' has a row
count of row_count. The current
The operation has stopped. operation requires a minimum of
required_row_count to execute.
User response
Remove any duplicat ecolumns. Try the operation Explanation
again. The current operation requires a certain number of
ANS2274I The column 'column_title' in the rows in the Comma Seperated Values (CSV) file in
Comma Separated Values (CSV) order to execute. The row count in the CSV file is
file is not recognized for the below this value.
current operation and will be
ignored. System action
The operation has been stopped.

Chapter 2. ANS 0000-9999 messages 199

User response User response
Add the input rows required for this operation to the Add the required column and the required elements
CSV file. Try the operation again. for that column to the CSV file.
ANS2277E The element in the Comma ANS2280E The Comma Separated Values
Separated Values (CSV) file on row (CSV) file 'csv_file' is invalid. The
row under column 'column_name' CSV file must have the same
with the value of 'element_value' is number of columns per row. The
invalid or missing. first row of the CSV file contains
first_row_column_count columns.
Explanation
Explanation
The current operation encountered an invalid or
missing value in the Comma Separated Values (CSV) The CSV file submitted is invalid because the number
file. of columns on each row is not identical.

System action System action

The operation has been stopped. Processing has stopped.

User response User response

Correct the identified element. Try the operation again. Edit the CSV file so that the number of columns per
row is identical. Try the command again.
ANS2278E The time_option option cannot be
used without specifying the ANS2281E The current operation encountered
date_option option on row row of a blank element in the Comma
the Comma Separated Values Separated Values (CSV) file
(CSV) file. 'csv_file' on row row_number,
column column_number.
Explanation
Explanation
If the PITTIME option cell exists thens the
corresponding PITDATE cell must exist. The current operation found a blank element in the
CSV file where a value is required for the operation to
System action continue. CSV files used for this operation must
contain values in all fields. All required columns must
Processing has stopped. be present.

User response System action

Either remove the PITTIME option cell or add the Processing has stopped.
corresponding PITDATE option cell.
ANS2279E The Comma Separated Values User response
(CSV) file is missing the required Edit the CSV file and provide data where a cell is blank
column 'column_name' for the or an entire column is missing. Try the operation again.
current operation.
ANS2282E An element in the Comma
Explanation Separated Values (CSV) file
csv_file is not a valid element:
To perform the task, the current operation requires a 'string_value'
specific column in the CSV file. This column is missing
from the CSV file.
Explanation

System action The current operation encountered a invalid or missing

value that is required for the operation in the Comma
Processing has stopped. Separated Values (CSV) file.

200 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The operation is stopped. Check the vcsplugin.log file for additional information
and contact the IBM Spectrum Protect administrator if
User response you require further assistance.

Correct the identified element. ANS2309I Single Sign On login to the vSphere
Server failed in function function.
ANS2284E The Microsoft Hyper-V backup API message A credential login is
cannot be deleted. now attempted.

Explanation Explanation
Deleting the Hyper-V backup will cause data integrity The Single Sign On (SSO) login to the vSphere Server
issues because the next incremental backup operation failed. Possible reasons for this failure include the
will not back up all required data. For this reason, do following situations:
not delete Hyper-V backups.
• A time difference exists between the vSphere Server
clock and the client clock that exceeds 10 minutes.
System action
• The SSO server accesses a non-default port. This
The backup is not deleted, but system operation issue can occur when the SSO server is installed on
continues. the same system as the VMware vCenter.

User response System action

No action is required. The system attempts a credential login as a result of
ANS2307I IBM Spectrum Protect category or the SSO login failure.
tag can not be found on vCeter.
Category: category-name, tags: User response
tag-names
Check the dsmerror.log file for details about why the
SSO login attempt failed. Then, take any corrective
Explanation action, if needed.
Spectrum Protect category are not present on the ANS2310E The create snapshot task is
vCenter. Setup might be incomplete. Please run 'dsmc disabled on the virtual machine
set vmtags' to add the necessary tags. This message 'VM-name'. As a result, the virtual
can safely be ignored if the tag-based schedule is not machine cannot be backed up.
being used.
Explanation
System action
Virtual machines that are managed or replicated by
Processing continues. another application disable the create snapshot task.
The vSphere client or another application disabled the
User response create snapshot task on this virtual machine. As a
result, this virtual machine cannot be backed up.
Check the vcsplugin.log file for additional information
and contact the IBM Spectrum Protect administrator if
you require further assistance. System action

ANS2308E The VMware vCloud Suite API The backup operation skips the virtual machine with
reported the following error the disabled create snapshot task and continues
message: 'api-message'. processing the remaining virtual machines.

Explanation User response

The VMware vCloud Suite API reported an error with None.

the specified message. ANS2311E The create snapshot task is
disabled on the virtual machine.
System action As a result, the virtual machine
Processing stops. cannot be backed up.

Chapter 2. ANS 0000-9999 messages 201

Explanation System action
Virtual machines that are managed or replicated by The command is not executed.
another application disable the create snapshot task.
The vSphere client or another application disabled the User response
create snapshot task on this virtual machine. As a
result, this virtual machine cannot be backed up. If spelling is the problem, correct it and resubmit the
command.
System action ANS2315E -PICK is not allowed for EXPIRE
when -OBJTYPE=VM.
The backup operation skips the virtual machine with
the disabled create snapshot task and continues
processing the remaining virtual machines. Explanation
-pick is not a valid option value when expiring VM
User response backup objects.
None.
System action
ANS2312E -DELTYPE=ALL is not allowed for
DELETE BACKUP -OBJTYPE=VM. The command is not executed.

Explanation User response

DELTYPE=ALL is not a valid option value when deleting If you wish to expire all VM nodes, use the DELETE
VM backup objects. FILESPACE command.
ANS2316E Wildcards are not allowed in the
System action VM name argument.
The command is not executed.
Explanation
User response When expiring or deleting a VM backup, the VM name
If you wish to delete all backups for a VM node, use must be specified exactly. The EXPIRE -OBJTYPE=VM
the DELETE FILESPACE command. command processes only one backup on each
invocation. When -INACTIVE is present the DELETE
ANS2313E -FILELIST is not allowed for BACKUP -OBJTYPE=VM command displays all
DELETE BACKUP or EXPIRE when versions of a single VM backup in a list from which to
-OBJTYPE=VM. choose. If -INACTIVE is not present, this command
expires the current active VM backup.
Explanation
System action
-filelist is not a valid option value when deleting or
expiring VM backup objects. The command is not executed.

System action User response

The command is not executed. Specify only one VM name without wild cards. It may
be in upper or lower case.
User response ANS2317E Deletion of VM object VMname
If you wish to delete or expire all backups for a VM failed. Reason:
node, use the DELETE FILESPACE command.
Explanation
ANS2314E No VM backup exists for VM-Name.
The transaction which deletes the named VM object
Explanation failed at the server. The reason code ....?????

The IBM Spectrum Protect server has no record of a

System action
VM backup for the VM name provided. The backup
might have been deleted, or the VM name spelled The deletion is skipped and processing continues with
incorrectly. the next selection, if any.

202 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Consult the error log for specific reasons for this The command did not complete, no objects were
failure. expired.
ANS2318E Command with -OBJTYPE=VM
requires exactly one non-option System action
argument The VM expire which failed has been reported in
previous messages.
Explanation
This command accepts only a single VM name as an User response
argument. Either no arguments were entered or more Consult the previous error messages for the cause of
than one appeared on the command line. the failure.
ANS2322I EXPIRE with -OBJTYPE=VM
System action
finished without failures.
The command is not executed.
Explanation
User response
The EXPIRE command executed successfully.
Specify only one VM name without wild cards. It may
be in upper or lower case. System action
ANS2319W DELETE BACKUP -OBJTYPE=VM Control returns to the command line.
finished with failures.
User response
Explanation
No action is required, this message is informational.
One or more deletions failed.
ANS2323E The user ID and password for
VMware vCloud Director 'vCD host
System action
name' are not set.
The VM backups which failed have been reported in
previous messages. Processing continues with the Explanation
next selection, if any.
The user ID and password for VMware vCloud Director
could not be read from encrypted password file.
User response
Consult the previous error messages for the cause of System action
each failure.
Processing stops.
ANS2320I DELETE BACKUP -OBJTYPE=VM
finished without failures. User response

Explanation Issue the dsmc SET PASSWORD -type=VCD 'vCloud

Director hostname' 'userid' 'password' command to
All VM backups selected for deletion were deleted. save an encrypted password.
ANS2324W WARNING: The VMware vCloud
System action
Director user ID <hostuserid> read
Control returns to the command line. from the password file is different
from the VCDUser option value
User response <vmcuserid>. Using stored value.

No action is required, this message is informational.

Explanation
ANS2321W EXPIRE with -OBJTYPE=VM All user IDs that are specified in the TSM.PWD file and
finished with failures. in the VCDUSER option must be the same.

Chapter 2. ANS 0000-9999 messages 203

System action User response
Processing stops. No action is required.
ANS2328I Using Snapshot Differential
User response Change Log.
Contact the IBM Spectrum Protect administrator with
the information that is provided in this message. Explanation
ANS2325E Error Accessing Snapshot A snapshot differential change log is being used for the
Differential Change Log for filer '' backup.
volume '', see client error log for
more information. System action
This message is for informational purposes only.
Explanation
The Snapshot Differential Change Log needed needed User response
to backup the specified filer volume could not be
accessed No action is required.
ANS2329W Down level Snapshot Differential
System action Change Log detected, Change Log
will be reset and a full progressive
The backup of the specified volume fails.
incremental will be performed.
User response
Explanation
Ensure that the client staging directory where change
logs are located is accessible. none.

ANS2326W Corrupt Snapshot Differential System action

Change Log detected, change log
will be reset and a full progressive none.
incremental will be performed.
User response
Explanation none.
A corrupt snapshot differential change log for the filer ANS2330E Failed to unfreeze the VSS writers
volume being backed up was detected. because the snapshot time
exceeded the 10 second timeout
System action limitation.
The change log will be reset and a full progressive
incremental with a new base snapshot will be Explanation
performed. Microsoft VSS has a 10 second timeout limitation
between freeze and thaw events for VSS writers on a
User response VM. When the snapshot time exceeds the 10 second
timeout limit, the VSS writers return to a 'failed' state.
none.
This failed state occurs because the VSS provider did
ANS2327I Creating Snapshot Differential not thaw the VSS writers within the allowed time.
Change Log.
System action
Explanation
Processing stops.
A new snapshot differential change log was created.
User response
System action
Check the event log. Ensure that the writers on the
This message is for informational purposes only. guest VM are in 'stable' state before trying an
application protection VM backup operation again. A
snapshot operation must be completed within 10
seconds.

204 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2331W No match found on the server for that Hyper-V is installed on the
the Hyper-V VM name or VMList backup node.
'string' entered
Explanation
Explanation The Windows Management Instrumentation (WMI)
No match found on the server for the Hyper-V VM namespace "root\virtualization\v2" for Hyper-V could
name or VMList parameter entered. not be found. This namespace is installed with Hyper-
V. If Hyper-V is installed, Hyper-V is not in a good
System action state.

None. System action

User response Creating a connection to the Hyper-V WMI provider.

Specify another Hyper-V VM name or VMList User response

parameter that exists on the server.
Check that Hyper-V is installed. If Hyper-V is not
ANS2332E Failed to log on to the vCloud installed, install Hyper-V before attempting this
Director. Authentication failed. operation again.

Explanation ANS2335E An operation requiring the

Windows Management
The vCloud credentials were rejected by the vCloud Instrumentation (WMI) service
Director. has failed with the error
'errorstring'. The WMI service is in
System action the shutting down or shutdown
state. Restart the service and try
The operation is stopped
again.

User response
Explanation
Update username and password for the vCloud
The Windows Management Instrumentation (WMI)
Director.
service has received a request to shutdown or has
ANS2333E Failed to establish connection to been shutdown due to an external error. An internal
the vCloud Director. operation which requires WMI has been attempted
and failed. The requested operation is unavailable
while WMI is shutdown.
Explanation
All Hyper-V operations require the Windows
A connection cannot be established to the vCloud
Management Instrumentation service.
Director on the host that is specified by the VCDHost
and VCDPort options.
System action
System action An internal IBM Spectrum Protect operation involving
Windows Management Instrumentation has occurred.
The operation is stopped

User response
User response
Restart the Windows Management Instrumentation
Verify that the values of the VCDHOst and VCDPort
service.
options are valid, network connectivity to the host
exists, and that the vCloud Director service is running. ANS2336W IBM Spectrum Protect has
ANS2334E detected that the following Hyper-
An operation requiring the
V virtual machine
Windows Management
"virtual_machines" has an
Instrumentation (WMI) service
interrupted incremental backup
has failed with the error
chain. Performing a full backup on
'errorstring'. Unable to connect to
the specified Hyper-V virtual
the Hyper-V namespace. Confirm
machine.

Chapter 2. ANS 0000-9999 messages 205

Explanation original and the replica may differ. In some occasions
the difference may cause data corruption if a backup
The last operation of the virtual machine was a
of the original is followed by a backup of the replica.
restore; or an unknown party has performed
incremental backup operations on the listed virtual
machine. To prevent backup corruption a full backup System action
will be performed instead. A backup request of a virtual machine replica is being
processed.
System action
IBM Spectrum Protect has detected that a virtual User response
machine has an interrupted incremental backup Configure IBM Spectrum Protect to back up only the
chains. original virtual machine or the replica. Alternatively,
one can change the name of the replica compared to
User response the original virtual machine; and the replica will back
up to a separate file space.
A full backup is performed instead of an incremental.
ANS2339W The Hyper-V VM 'vmname' is in a
ANS2337E The process was unable to take
"branch" state compared to the
cluster resource 'resourcename'
last backup. Incremental Forever -
offline. The current operation
Incremental backup cannot be
requires the resource to be offline.
performed. An Incremental
Turning the cluster resource off
Forever - Full backup will be
failed with rc=rc.
performed instead.

Explanation
Explanation
The cluster resource was not taken offline within the
The VM state is in a "branch" compared to the last
time limit or an attempt was made to take offline a
backup. This causes a fallback to Incremental Forever
failed cluster resource.
- Full as backup consistency in this state is not
guaranteed.
System action
The current operation stops. System action
An Incremental Forever - Full backup will be
User response performed.
Check that the cluster resource is not in a failed state.
Verify that the cluster resource can be taken offline. User response
ANS2338W The process has detected a None.
request to backup a virtual
ANS2340W The target virtual machine 'VM-
machine replica. The state of the
name' exists, use the REPLACE
replica 'vmreplicaname', ID='vmid'
option to overwrite.
may differ from the original virtual
machine. If the names of the
original virtual machine and the Explanation
replica are identical the same file The specified target VM exists and the user specified
space will be used. The data may not to allow restore to replace existing machines.
become unrecoverable because
the state of the original virtual
System action
machine and the replica may
differ. The virtual machine is not restored.

Explanation User response

Backups of an original virtual machine and their replica Specify a different virtual machine as a restore target
overwrite each other as their name and ID are usually or specify that existing virtual machines can be
identical. Virtual machine replicas are taken in definite replaced.
time intervals. Between these intervals the data on the

206 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2341E The target virtual machine 'VM- Explanation
name' cannot be restored: The The indicated volume is a disk witness. Because the
guid differs from the backup copy. CLUSTERNODE option is set to YES, the volume cannot
be backed up or archived.
Explanation
The specified target VM exists and has a different guid System action
than the virtual machine was backed up with.. Processing stops.

System action User response

The virtual machine is not restored. If the CLUSTERNODE option is incorrectly set to YES,
then change the option to NO and try the operation
User response again. Otherwise see the client manual for further
Specify a different virtual machine as a restore target information about configuring the IBM Spectrum
or delete the specified target virtual machine. Protect client to run in a cluster environment.

ANS2342E The specified restore target 'VM- ANS2345W The virtual machine named '' was
name' is ambiguous: Multiple found to have an old snapshot ''. A
virtual machines with the same command was sent to the vCenter
name exist. to remove it.

Explanation Explanation

The specifed restore target is ambiguous, multiple During the snapshot clean-up process the backup-
virtual machine with the same name exist. archive client found old snapshots on the virtual
machine. A remove snapshot command was sent to
the VMware vCenter to remove the old snapshots.
System action
The virtual machine is not restored. System action
Processing continues
User response
Specify a different virtual machine as a restore target. User response
ANS2343E A snapshot of Virtual machine Confirm that the the virtual machine is free of all
'vmname' cannot be taken snapshots before the next scheduled backup.
because a physical disk attached.
ANS2346E Expiration of VM object VMname
failed. Reason:
Explanation
The Volume Snapshot Service (VSS) is unable to Explanation
snapshot a virtual machine with a physical disk.
The transaction which expires the named VM object
failed at the server. The reason code ....?????
System action
The full backup of the the virtual machine finished with System action
failures. The next virtual machine in the backup will be
processed. The expiration is not completed.

User response User response

Do not include this virtual machine in domain.vmfull Consult the error log for specific reasons for this
for backup. A snapshot of this virtual machine cannot failure.
be taken. ANS2347E IBM Spectrum Protect application
ANS2344E 'drive-name1' is a disk witness. protection cannot be used. The
correct Java Runtime Environment
version has not been detected on
machine. A Java Runtime

Chapter 2. ANS 0000-9999 messages 207

 Environment version or higher is User response
required to run this program. If
Confirm that the virtual machine is clean of all
you have already installed this
snapshots and snapshot delta files before the next
level of Java version on this
scheduled backup.
machine, please ensure that the
correct Java executable is on your ANS2350E Virtual machine 'VM name' will not
PATH and start the program again. be backed up because it contains
at least one of the following
Explanation unsupported special characters
\/:;,*?"'<>|
IBM Spectrum Protect application protection vm
backup cannot be started because the Java runtime
Explanation
environment does not meet the requirements.
The specified virtual machine contains characters that
System action are not supported for virtual machine backup and
restore operations.
Processing stops.
System action
User response
The backup for the specified virtual machine fails.
Verify that the correct java executable is on your PATH
or install the required version of Java runtime
User response
environment and run the backup again.
Rename the virtual machine so that it does not contain
ANS2348E Mount proxy host 'remoteversion'
any of the specified special characters.
does not have a supported
operating system. ANS2351E Duplicate virtual machine name
'vmname' was detected in the
Explanation same backup operation. Backups
of a virtual machine can not
The mount proxy node needs to be configured on a continue without a unique object
supported operating system. name.

System action Explanation

The calling procedure returns and control is passed The backup of the virtual machine failed because no
back the user. unique object name is available.

User response System action

Check the documentation for a list of supported The backup for the specified virtual machine fails. The
operating systems. Configure the mount proxy node on next virtual machine to back up will be processed.
a supported operating system.
ANS2349W The virtual machine named '' was User response
found to need snapshot
Rename the virtual machine so that it is unique among
consolidation. A command was
virtual machines for the node.
sent to the VMware vCenter to
perform consolidation. ANS2352E Validation of virtual machine
'vmname' configuration returned
Explanation the following message from
Hyper-V:
During the virtual machine backup process the hypervmessage
backup-archive client found the virtual machine This message indicated that the
needed snapshot consolidation. A command was sent virtual machine could not be
to the VMware vCenter to perform consolidation. restored until the message from
Hyper-V is addressed.
System action
Processing continues

208 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation the Platform Services Controller is running either
embedded or external.To receive any additional
When validating the virtual machine with Hyper-V a
messages that might be related to this problem,
message was returned that prevents the virtual
enable TRACEFLAGS VCLOUD tracing in the client
machine restore from continuing.
options file. To determine which Platform Services
Controller the vCenter Server is referencing, examine
System action the vCenter Server's Advanced Settings key
Cannot continue with restore until the issue is 'config.vpxd.sso.sts.uri'. Confirm the system time
resolved. between the PSC, vCenter and the client on the data
mover node are in sync. Also, check the vCloud Suite
plug-in error file vcsplugin.log.
User response
ANS2374E The VMware vCloud Suite plug-in
Resolve the issue outlined by the message.
library failed to connect to the
ANS2353W The virtual machine to be restored vCenter Management Server.
'vm-name' exceeds the amount of
vCPUs, virtual memory, or both, Explanation
that are allowed by the host. The
virtual machine was reset to the A connection cannot be established with the vCenter
minimum amount that is allowed Management Server.
by the host so that the restore
operation can continue. System action
vCloud Suite API operations cannot be performed.
Explanation
The virtual machine to be restored is configured for User response
more vCPUs, virtual memory, or both, than are allowed
Verify that the value of the VMCHOST option is correct,
by the host. The amount of vCPUs and virtual memory
and that network connectivity to the host exists. To
can be adjusted after the restore operation completes.
receive any additional messages that might be related
to this problem, enable TRACEFLAGS VCLOUD tracing
System action in the client options file. Also, check the vCloud Suite
The vCPUs, virtual memory, or both, are reset to the plug-in log file vcsplugin.log.
minimum amount that are allowed by the host. The ANS2375E The VMware vCloud Suite plug-in
restore operation continues. library failed to connect to the
vCenter Management Server
User response because the instance name could
Adjust the amount of vCPUs, virtual memory, or both, not be found.
after the restore operation completes.
Explanation
ANS2373E The VMware vCloud Suite plug-in
library failed to connect to the A connection cannot be established with the vCenter
Platform Services Controller (PSC) Management Server because the instance name could
and perform a single sign-on not be found. This could be a spelling error in the host
session. name or the Domain Name System (DNS) is not
functioning.
Explanation
System action
A connection cannot be established with the Platform
Services Controller. vCloud Suite API operations cannot be performed.

System action User response

vCloud Suite API operations cannot be performed. Verify that the value of the VMCHOST option is correct
and matches the name used to register the vCenter
with the Platform Services Controller often this is the
User response
fully qualified domain name (FQDN). To receive any
Verify that the value of the VMCHOST option is correct, additional messages that might be related to this
that network connectivity to the host exists, and that

Chapter 2. ANS 0000-9999 messages 209

problem, enable TRACEFLAGS VCLOUD tracing in the • The PSC single sign-on server accesses a non-
client options file. default port. This issue might occur when the single
sign-on server is installed on the same system as the
ANS2376I The target vCenter version does
VMware vCenter.
not support VMware's vCloud
Suite SDK so tagging operations
cannot be performed by the client System action
on the data mover node. The client on the data mover node will attempt a
credential login as a result of the single sign-on login
Explanation failure.
The client option 'VMTAGDATAMOVER' is enabled so
that IBM Spectrum Protect categories and tags can be User response
applied to virtual machines, but the vCenter version is Check the dsmerror.log file for details about why the
below version 6.0. single sign-on login attempt failed. Then, take any
corrective action, if needed.
System action
ANS2380E Connection to the Windows
The operation continues without the vCloud Suite Management Instrumentation
plug-in library and vSphere tagging support. (WMI) default namespace failed
with the error 'error'.
User response
Explanation
Use a vCenter that is at or above version 6.0 or disable
the 'VMTAGDATAMOVER' option in the client options The Windows Management Instrumentation (WMI)
file. default namespace "root\cimv2" could not be found.
Possibly because the WMI repository is corrupted.
ANS2377I The IBM category data has been
created, or already existed, on the
VMware Platform Services System action
Controller. Processing stops.

Explanation User response

The categories used for tagging support in the backup- Please verify that the WMI repository is consistent
archive client are available for use on the VMware using the command 'winmgmt /verifyrepository'.
Platform Services Controller.
ANS2398I The virtual machine 'VM-name' is
configured as a VMware Site
System action
Recovery Manager placeholder
The operation has completed. virtual machine on the recovery
site. As a result, the virtual
User response machine will be skipped.

None.
Explanation
ANS2378W The single sign-on session to the VMware Site Recovery Manager creates placeholder
Platform Services Controller (PSC) virtual machines that have no virtual disk data. As a
failed with the following message: result, these virtual machines cannot be backed up.
apimessage
System action
Explanation
The backup operation skips the placeholder virtual
The single sign-on session to the Platform Services machine and continues processing the remaining
Controller (PSC) failed. The possible reasons for this virtual machines.
failure include the following situations:
• This issue might occur when the system clock on the User response
on PSC host, vCenter Server host, and client host are
out of sync, or the time zones settings are incorrect. None

210 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2399I The virtual machine is configured ANS2410E Instant Restore information for
as a VMware Site Recovery the specified virtual machines was
Manager placeholder virtual not found.
machine on the recovery site. As a
result, the virtual machine will be Explanation
skipped.
The IBM Spectrum Protect server does not contain
Instant Restore information for the specified virtual
Explanation
machines. Or, the virtual machines were specified
VMware Site Recovery Manager creates placeholder incorrectly.
virtual machines that have no virtual disk data. As a
result, these virtual machines cannot be backed up. System action
Processing stops.
System action
The backup operation skips the placeholder virtual User response
machine and continues processing the remaining
virtual machines. Issue the QUERY VM * -VMRESTORETYPE=ALLTYPE
command. This command queries all active Instant
Access, Restore, and Disk sessions available on the
User response
IBM Spectrum Protect server.
None
ANS2411E Instant Restore/Access of virtual
ANS2408I The virtual machine named machine 'vmname' failed with rc =
'VMNAME' is ready for Instant return-code
Access
Explanation
Explanation
An error happened during processing of an Instant
The Instant Access operation for the specified virtual Restore or Access. See previous output what happens
machine successfully completed. exactly.

System action System action

None. Processing stops.

User response User response

None Check the error log for information about how to
resolve this error.
ANS2409E The Instant Restore type was not
identified. ANS2412E IBM Spectrum Protect Recovery
Agent is not installed.
Explanation
Explanation
The client encountered a connection error when
querying the IBM Spectrum Protect server for Instant IBM Spectrum Protect Recovery Agent is not installed.
Restore and Access information.
System action
System action
Processing stops.
Processing stops.
User response
User response
Ensure that IBM Spectrum Protect Recovery Agent is
Verify that the client is connected to the server. Then correctly installed and configured.
run the operation again. Check with the command
ANS2413E Cannot find the Recovery Agent
QUERY SESSION what is the cause for the connection
issue. Also check the dsmerror.log for additional shell command in the expected
information installation path.

Chapter 2. ANS 0000-9999 messages 211

 Ensure that IBM Spectrum Protect System action
for VE is correctly installed and
Processing stops.
configured.

User response
Explanation
Verify that the configuration of the network interface is
The Recovery Agent shell command was not found in
correct.
the expected installation path.
ANS2417E Unexpected communication
System action method. Only TCP and TCPv6 are
accepted.
Processing stops.
Explanation
User response
An unexpected communication method was detected.
Ensure that IBM Spectrum Protect for VE is correctly
installed and configured.
System action
ANS2414E An error occurred when the
Processing stops.
hostname for the local machine
was called.
User response
Explanation Verify that the communication method for IBM
Spectrum Protect is correct. Use either TCP or TCPv6.
The system call gethostname failed.
ANS2418E Unable to read or write to the local
System action instant restore data.
filename
Processing stops. File cannot be accessed or is
damaged.
User response
Verify that the configuration of the network interface is Explanation
correct. Instant access and instant restore operations require
ANS2415E An error occurred when the read/write access on the local data mover to store
machine address information was data.
called.
System action
Explanation Processing stops.
The system call getaddrinfo failed.
User response
System action To store the instant restore restore data, the data
Processing stops. mover application requires read and write access to
the C:\Documents and Settings\AllUsers\Application
Data\Tivoli\TSM\ or C:\ProgramData\Tivoli\TSM folder.
User response
Set the access rights to this directory so that your user
Verify that the configuration of the network interface is has the correct rights.
correct. If the file was damaged it can be helpfull to replace
the current version with the .bak file.
ANS2416E An error occurred when the
machine name information was ANS2419E The datastore does not have
called. enough free space for the instant
restore operation.
Explanation
Explanation
The system call getnameinfo failed.
The space on the selected datastore is not sufficient
for the instant restore operation.

212 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS2424E Cannot find the ESX host
'ESXHOST' in the vCenter.
Processing stops.

Explanation
User response
The specified ESX host cannot be found in the vCenter.
Increase the datastore space or choose a different
datastore.
System action
ANS2420E Cannot detect storage device
information. Processing stops.

Explanation User response

Storage device information cannot be retrieved. Ensure that the specified ESX host is in the vCenter.
Ensure that the name of the ESX host is correct.
Alternatively, specify another ESX host.
System action
ANS2425E Cannot connect to the ESX host
Processing stops.
'ESXHOST'

User response
Explanation
Ensure that the communication with the ESX host is
A connection to the specified ESX host cannot be
working. Also, review the log messages on the ESX
made
host.
ANS2421E The iSCSI initiator cannot be System action
detected on the hypervisor host.
Processing stops.
Explanation
User response
The iSCSI initiator name of the hypervisor host cannot
be detected. Ensure that the specified ESX host is connected to the
vCenter and the network. Alternatively, specify
another ESX host.
System action
ANS2426E The ESX host 'ESXHOST' is not
Processing stops.
powered on.
User response
Explanation
VMware: Review the log file on the ESX host to ensure
The specified ESX host is not powered on.
that the communication with it is working.
Hyper-V: Ensure that the iSCSI initiator service is
running and working properly. System action

ANS2422E Cannot detect the iSCSI Host Bus Processing stops.

Adapter.
User response
Explanation Turn on the power to the ESX host. Alternatively,
The iSCSI adapter was not detected. specify another ESX host.
ANS2427E The ESX host 'ESXHOST' is in
System action maintenance mode.
Processing stops.
Explanation
User response The specified ESX host is in maintenance mode. A
connection cannot be made to this host.
Ensure that the communication with the ESX host is
working. Also, review the log messages on the ESX
host.

Chapter 2. ANS 0000-9999 messages 213

System action ANS2432E The temporary datastore
'TEMPDATASTORE' is the same as
Processing stops.
the target datastore 'DATASTORE'.

User response
Explanation
Change the ESX host back to normal mode and try
The specified temporary datastore must be a different
again. Alternatively, specify another ESX host.
datastore than the one where the machine is restored
ANS2428E The ESX host 'ESXHOST' is not to. You must specify two different datastores for
connected. Storage vMotion to work.

Explanation System action

The specified ESX host is not connected in the Processing stops.
vCenter.
User response
System action
Specify another datastore as a temporary datastore.
Processing stops.
ANS2433E The '-vmtempdatastore' option
must be specified for an instant
User response restore operation.
Connect the ESX host in the vCenter and try again.
Alternatively, specify another ESX host. Explanation
ANS2430E Cannot find the datacenter You must specify two different datastores for Storage
'DATACENTER'. vMotion to work. Use the '-vmtempdatastore' option to
specify a temporary datastore.
Explanation
System action
The specified Datacenter cannot be found in the
vCenter. Processing stops.

System action User response

Processing stops. Specify a temporary datastore.
ANS2434E The datastore 'DATASTORE' was
User response not found on the host 'ESXHOST'.
Ensure that the specified datacenter is in the vCenter.
Alternatively, specify another datacenter. Explanation
ANS2431E Cannot find the temporary The specified datastore cannot be found on the ESX
datastore 'TEMPDATASTORE' on host.
the ESX host 'ESXHOST'.
System action
Explanation
Processing stops.
The specified temporary datastore cannot be found on
the specified ESX host. User response
Ensure that the specified datastore is on the ESX host.
System action
Alternatively, specify another datastore.
Processing stops.
ANS2435E IBM Spectrum Protect Recovery
Agent detected the following
User response failure while
Ensure that the specified datastore is on the ESX host. attempting to mount a snapshot of
Alternatively, specify another datastore. VM 'VM' from disc='disk-label':
FBCxxxxE-error-message

214 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
The attempt to mount a VM disk as an iSCSI device Unable to determine the datacenter where the ESX
failed. host is located.

System action System action

The operation stops. The operation was stopped.

User response User response

Check the Recovery Agent logs and the FBCxxxxE error Check that the vCenter of the ESX host is in a
message, resolve the problem, and try the operation datacenter and that the user has the proper authority
again. to access this information.
ANS2436E IBM Spectrum Protect Recovery ANS2445E Virtual machine 'VM' is running.
Agent detected the following You cannot delete this VM.
failure while
trying to dismount a snapshot of Explanation
VM 'VM' from target 'target':
FBCxxxxE-error-message You cannot delete a virtual machine that is running.

Explanation System action

The snapshot for the specified VM could not be The operation was stopped.
dismounted from the iSCSI target.
User response
System action Ensure that you have the proper authority to power off
The operation stops. virtual machines, then power off and delete the VM.
ANS2447E Failed to delete VM 'VM' from the
User response ESX host.
Check the Recovery Agent logs and the FBCxxxxE error
message, resolve the problem, and try the operation Explanation
again. You cannot delete the virtual machine form the ESX
ANS2442W The Linux mount proxy node host.
information is not available.
System action
Explanation The operation was stopped.
The Windows mount proxy was unable to retrieve its
partner Linux mount proxy node information. User response
Ensure that you have the proper authority to delete
System action virtual machines, then delete the VM.
A connection to the Linux mount proxy is not ANS2448E Mount command failed.
established. Command was
COMMAND
User response Shell command returned:
Ensure that the Linux mount proxy node is set up and RESULT
the DSMCAD service is running on the Linux mount
proxy node. Then, try this operation again. Explanation

ANS2444E Cannot find the datacenter for The mount command was not successful.
host 'ESXHOST'.
System action
The operation was stopped.

Chapter 2. ANS 0000-9999 messages 215

User response User response
Determine the problem from the error details returned Run the cleanup process after you fix any problems
for the mount command. Resolve the problem, then with the ESX host bus adapter.
run the command again.
ANS2455I The virtual machine has been
ANS2452E num_discovered iSCSI devices started. You can use the machine
were discovered on the ESX host, after it has booted, or you can
while num_mounted were connect to it and manage its
expected. settings through the vCenter
console.
Explanation
Explanation
After the ESX host bus adapter was scanned, the
number of devices that were discovered is different The virtual machine is being started.
from the number of mounted devices.
System action
System action
Processing continues.
The Instant Restore or Instant Access process is
stopped. User response
While the boot is in progress, you can connect to the
User response
virtual machine and view or manage BIOS settings,
Verify that the IBM Spectrum Protect mount is manage the bootloader options, or perform other
configured to use the correct ESX host IP. To clean the tasks. After the boot process completes, you can use
environment, you must run the cleanup process. the virtual machine and its applications and resources.
ANS2453E An error occurred when the host ANS2462E Unable to start the vMotion task
bus adapter was scanned. for virtual machine 'vm_name'.

Explanation Explanation
An error occurred when the ESX host bus adapter was An instant restore of the specified virtual machine was
scanned. attempted but failed. The client could not start a
vMotion task to migrate the virtual machine.
System action
System action
The Instant Restore, Instant Access, or cleanup
process is stopped. The Instant Restore operation stops.

User response User response

Run the cleanup process after you fix any problems Examine the client dsmerror.log file to see if a log
with the ESX host bus adapter. entry indicates why the vMotion task failed. Additional
information about the failure might also be available in
ANS2454E An error occurred when the iSCSI the vCenter server, on the Task and Events tab for the
target target_name was ESXi host that you were migrating the VM from. If
disconnected from the ESX host possible, use the log and event records to determine
bus adapter. what caused the vMotion task to fail and fix it. Then,
clean up the virtual machine (use the Restore VM
Explanation command with the -VMRESToretype=VMCLeanup
An error occurred when a specific iSCSI target was option) and restart the vMotion task. If you cannot
disconnected from the ESX host bus adapter. restart the task, suspend the virtual machine and use
the vSphere web client to start the virtual machine
migration from one host to another.
System action
ANS2463W Instant Restore information
The cleanup operation is stopped.
cannot be saved on the server.

216 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ESXi host that you were migrating the VM from. If
possible, use the log and event records to determine
An error occurred when Instant Restore information
what caused the vMotion task to fail and fix it. Then
was being saved on the server. The Instant Restore
clean up the virtual machine (use the Restore VM
process is still running.
command with the -VMRESToretype=VMCLeanup
option) and restart the vMotion task. If you cannot
System action restart the task, suspend the virtual machine and use
The operation continues. the vSphere web client to start the VM migration from
one host to another.
User response ANS2466W If you continue you will lose all
data created on this virtual
The client dsmerror.log file might contain information
machine.
to help troubleshoot the reason for this error. Let the
The virtual machine will also be
Instant Restore process complete on its own. You
removed from the ESXi host.
might need to run a clean up operation on the virtual
Are you sure that you want to do
machine. Use the Restore VM command, and specify
this? Press Y the virtual machine
the -VMRESToretype=VMCLeanup option.
data and remove it from the ESXi
ANS2464E Unable to delete Instant Restore host.
information from the server. Press any other key to continue
without deleting data or the VM.
Explanation
Explanation
An error occurred while attempting to delete Instant
Restore information from the server. You are performing an operation that, if allowed to
continue, will delete all data that was created after
System action this virtual machine was created.

The Instant Restore operation continues.

System action

User response If Y is pressed, the Instant Restore operation is

stopped, and a cleanup operation is performed
The most likely reason for this error is that an
ANS2463W warning previously occurred, and there is
User response
no data to delete. If you have not previously seen an
ANS2463W message, the client dsmerror.log file Respond to the prompt. Press Y to destroy all data and
might contain information to help you troubleshoot delete the virtual machine from the server. Press any
this error. Clean up the virtual machine to remove old other key to continue without deleting.
information from the server. Use the Restore VM
ANS2467W Unable to delete the snapshot that
command, and specify the -
VMRESToretype=VMCLeanup option. was created for the virtual
machine named 'vm_name'
ANS2465E An error occurred during a storage
vMotion operation. Explanation
When a virtual machine is restored by an instant
Explanation
restore operation, a snapshot is created to store all
A storage vMotion task failed while trying to migrate a data that were written to the virtual machine disks.
running virtual machine. When the restore is completed, the ESXi host deletes
the snapshot. The snapshot for the specified virtual
System action machine could not be deleted.

The Instant Restore operation stops.

System action

User response Operation continues.

Examine the client dsmerror.log file to see if a log

User response
entry indicates why the vMotion task failed. Additional
information about the failure might also be available in Examine the vSphere log to determine why is it not
the vCenter server, on the Task and Events tab for the possible to delete the snapshot and resolve the

Chapter 2. ANS 0000-9999 messages 217

problems that prevent the deletion. Then, delete the resources that were created by the instant restore
snapshot by using the snapshot manager. operation.
ANS2468E The necessary iSCSI targets could ANS2472E Cannot detect the LUN for the
not be found on the ESX host. attached RDM devices for virtual
machine named vmname'.
Explanation The restore operation for this
virtual machine cannot be
An instant restore operation was initiated and one or completed.
more of the required iSCSI targets could not be found
on the ESXi host.
Explanation

System action The LUNs for the RDM devices use by the specified
virtual machine are either missing, are mapped to an
Processing stops. other machine, or the device name and the LUN do not
match.
User response
Verify that the IP address that was specified with the - System action
VMISCSISERVERADDRESS parameter is correct. The restore operation is stopped.
ANS2469E Unable to remove the iSCSI target.
User response
Explanation For restore operations where
An error occurred while trying to remove an iSCSI vmrestoretype=instantrestore or
target. vmrestoretype=instantaccess, verify that the iSCSI
server address and the VMkernel port binding match.
Verify this information by checking the following
System action things: 1. Check the Data Protection for VMware
Processing stops. configuration file RecoveryAgent.conf and verify that
the iSCSI server address is bound to the correct
User response network card and segment. 2. Use the vSphere client
to connect to your ESXi host. In vSphere, select
Check vSphere client log file for the reason this Configuration->Storage Adapters to display a list of
operation failed and remove the iSCSI target. To the iSCSI adapters. Right click the adapter that you are
remove the failed iSCSI static targets go to your ESXi verifying. Then, select Properties ->Network
host Configuration -> Storage Adapters -> Select the Configuration. In the VMkernel Port Bindings Details
iSCSI Adapter -> right click on it -> Click Properties -> output, verify that the VMkernel Adapter is on the
Static Discovery and select the failed iSCSI targets and same subnet that the datamover node is on.
remove them.
ANS2473E Unable to create a Snapshot of the
ANS2471E Unable to stop the vMotion Task virtual machine named 'vm_name'.
'task'.
Explanation
Explanation
An instant restore operation was attempted for the
The specified vMotion task could not be stopped. specified virtual machine. The snapshot that is used to
restore the virtual machine could not be created.
System action
The instant restore operation is stopped. System action
The instant restore operation stops.
User response
Examine the vSphere log to determine why the User response
migration cannot be stopped. Resolve the problem and Examine the vCenter logs to determine why the
cancel the vMotion task. Then, use the - snapshot could not be created and try the instant
VMRESToretype=VMFULLCleanup option on the restore operation again.
Restore VM command to remove any files or other

218 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2474E Unable to cleanup after an instant ANS2485E Cannot query the IBM Spectrum
restore operation for the virtual Protect server to get instant
machine named 'vm_name', access information
because vMotion task is still
running. Explanation
The server did not respond to the query for instant
Explanation
access information.
An instant restore operation is still running for the
specified virtual machine. System action
The virtual machine cleanup operation is halted.
System action
The cleanuop operation stops. User response
Examine the dsmerror.log file and the IBM Spectrum
User response
Protect server activity logs to determine the cause of
Use the query command to check on the status of the this error.
instant restore operation. Examine the vCenter to
ANS2488E Error mounting the iSCSI device.
determine the status of the vMotion task. If you want
to stop the instant restore, cancel the operation in the
DP VMware GUI or stop the vMotion task from the Explanation
vCenter interface. Then, start the cleanup operation An error occurred while trying to mount the iSCSI
again. device. Check the dsmerror.log file to determine the
ANS2476E A restore location must be cause of this error.
specified via the TARGETPATH
option when restoring to a System action
different virtual machine name.
The operation was stopped.

Explanation
User response
A restore location must be specifed via the
No action is required.
TARGETPATH option when restoring to a different
virtual machine name specified by the VMNAME ANS2490E The VM 'VM' cannot be powered
option. off.

System action Explanation

The virtual machine is not restored. The specified virtual machine cannot be powered off.
Attempts to clean up the resources that were created
User response to restore the virtual machine cannot be completed.

Specify a restore location with the TARGETPATH

System action
option.
The restore operation was stopped.
ANS2484I Virtual Machine 'vm_name' was
successfully restored
User response
Explanation Turn off the virtual machine by using your hypervisor
management client.
The Virtual Machine was successfully restored.
ANS2513I The virtual machine has no disks
System action attached
None.
Explanation

User response The virtual machine exists, but it does not have any
disks attached. The machine can be cleaned up.
None

Chapter 2. ANS 0000-9999 messages 219

System action Explanation
None. IBM Spectrum Protect Changes to the restored VM
might not be permanently saved.
User response
System action
None
IBM Spectrum Protect Automatic cleanup cannot be
ANS2514I Disk status cannot be determined performed for the failed vMotion operation.

Explanation User response

It is not possible to determine the status of this disk. Examine the event logs to determine the cause for the
failure. Fix any problems and restart the storage
System action vMotion operation manually, by using the vSphere web
None. clien, to finish the restore operation. Refer to the
vMotion documentation to get details about the
manual recovery process.
User response
ANS2517E Cannot query the IBM Spectrum
Examine the vSphere Client log to determine what is
Protect server to get instant
wrong with the machine. If the log entries do not
restore information
reveal problems with this virtual machine, inspect the
virtual machine in the vSphere Client to determine why
the disk status cannot be determined. See the vSphere Explanation
documentation for additional guidance, if necessary. The server did not respond to the query for instant
ANS2515I No additional information is restore information.
available for this virtual machine.
The virtual machine was deleted System action
or it has been renamed The virtual machine clean up operation stops.

Explanation User response

Information about the virtual machine cannot be found Examine the dsmerror.log file and the IBM Spectrum
on the ESXi host. The virtual machine might have been Protect server activity logs to determine the cause of
previously deleted or renamed. this error.

System action ANS2519E The disk \"diskname\" is an iSCSI

device with an inactive path.
None. Powering off the virtual machine
will cause the ESXi server to hang.
User response The clean up operation has been
stopped to prevent this.
Use the vSphere Client to determine what happened to
Use the Query VM command with
this virtual machine. If the virtual machine was
the -detail option to obtain
renamed, make sure that it is running without errors
detailed status information about
before you clean up the temporary resources, by using
the virtual machine.
the Restore VM command with the -
Correct the path so that the iSCSI
VMRESToretype=VMCLEANUP option.
state is active and then try running
ANS2516E VMware storage vMotion operation the VMFULLCleanup operation
failed. again.
Restart the storage vMotion
operation manually, by using the Explanation
vSphere web client, to finish the
restore operation. A running virtual machine that has an inactive iSCSI
Refer to the documentation to get device cannot be cleaned up.
details about the manual recovery
process.

220 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
The virtual machine full clean up The instant restore operation is stopped.
(VMRESTORType=VMFULLCLeanup) operation stops.
User response
User response
Obtain the necessary license from VMware and assign
For information about troubleshooting inactive iSCSI the license to the ESXi host.
resources, search the VMware support pages by using
ANS2522W A user canceled the
a search string like "troubleshooting iSCSI" or "inactive
'operationType' operation .
iSCSI".
ANS2520E The disk \"diskname\" is not a Explanation
physical device.
An instant restore clean up was A user canceled the restore/backup operation .
stopped because vMotion could
not restore all virtual machine System action
data..
The operation is stopped
Use the Query VM command with
the -detail option to obtain
information about state of the User response
specified disk. No response is required.
Use vMotion to manually migrate
the virtual machine devices and ANS2523E The virtual machine named vm
then try the clean up operation cannot not be restored to the same
again. configuration it had when it was
backed up. IBM Spectrum Protect
Explanation will reconfigure the virtual
machine to include only the most
An instant restore clean up operation (- essential configuration
VMRESToretype=VMCLeanup) cannot complete information and retry the restore
because vMotion could not restore all of the virtual operation.
machine resources.
Explanation
System action
The restore operation failed to restore the virtual
The virtual machine clean up operation stops. machine to its original configuration. This error can
occur if there is incompatibility between the hardware
User response that the virtual machine was on when it was backed
up, and the hardware on the physical host where it
Use the VMware documentation to determine how to was restored. IBM Spectrum Protect will reconfigure
use vMotion to migrate the virtual machine. Then, try the virtual machine to eliminate all but most necessary
the clean up operation again by using the Restore VM configuration information (video and virtual disks) and
command with the -VMRESToretype=VMCLeanup retry the restore operation.
option. If you do not want to restore this virtual
machine, use the Restore VM command with the -
System action
VMRESTORType=VMFULLCLeanup option to remove
the virtual machine and all of its resources. The restore operation continues, using the
reconfigured virtual machine information.
ANS2521E Instant restore operations require
valid licenses for both vMotion and
storage vMothion. User response
When the restore completes, reconfigure the restored
Explanation virtual machine to your requirements.
Instant restore works only when the ESXi host has a ANS2524E An attempt to mount a snapshot of
valid license for both vMotion and storage vMotion VM 'disk' from disk 'vm' failed.
The volume might be mounted
from another operation and cannot
be remounted.

Chapter 2. ANS 0000-9999 messages 221

Explanation User response
An attempt to mount a snapshot of VM 'disk' from disk See the INCLUDE.VMSNAPSHOTATTEMPTS
'vm' failed. documentation for information about how to set this
The volume might be mounted from another operation option.
and cannot be remounted.
ANS2527I The login request started.
.

Explanation
System action
The user submitted a request to log in to the file
The mount operation stops.
restore interface.

User response
System action
Dismount the volume by running a mount cleanup
Processing continues.
operation, then run the mount operation again.
ANS2525E The created virtual machine User response
cannot be powered on.
No action is required.
Explanation ANS2528I The login request was completed
successfully.
The hypervisor is unable to power on the created
virtual machine. VM-OS=os Data-
Center=datacenter
System action
Explanation
The operation will be rolled back and stopped.
The user successfully logged into the file restore
interface.
User response
Check the dsmerror.log file for more information. System action
Check the hypervisor log to determine what error
occurred during the power-on process of the virtual None.
machine.
User response
ANS2526W The
VM_DONT_QUIESCE_ON_SNAPSH No action is required.
OT testflag is deprecated for full ANS2529I The login request failed.
VM backups.
Use the
Explanation
INCLUDE.VMSNAPSHOTATTEMPT
S option to attempt snapshots An error occurred while logging into the file restore
with "VMware Tools file system interface.
quiescing and application (VSS)
quiescing disabled". System action
None.
Explanation
The VM_DONT_QUIESCE_ON_SNAPSHOT testflag User response
overrides the INCLUDE.VMSNAPSHOTATTEMPTS
option. As a result, all snapshot attempts are with Review the log for related login and authentication
VMware Tools file system quiescing and application errors.
(VSS) quiescing disabled. ANS2530I The log out request started.

System action Explanation

Use the INCLUDE.VMSNAPSHOTATTEMPTS option to The user either logged out of the file restore interface
specify snapshot attempts with VMware Tools file or the file restore interface timed out due to inactivity.
system quiescing and application (VSS) quiescing
disabled.

222 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
Processing continues. None.

User response User response

No action is required. No action is required.
ANS2531I The log out request was ANS2535I The mount request failed.
completed successfully. Backup-Date=backupDate Mount-
ID=mountId
Explanation
Explanation
The user was successfully logged out of the file restore
interface. An error occurred while mounting the backup.

System action System action

None. Mount processing stops.

User response User response

No action is required. Review the log for related mount errors.
ANS2532I The log out request failed. ANS2536I The dismount request started.
Backup-ID=backupId Backup-
Explanation Date=backupDate Mount-
ID=mountId
An error occurred while logging out of the file restore
interface.
Explanation

System action The user either selected another backup to load or

logged out of the file restore interface.
Log out processing was completed with errors.
System action
User response
Processing continues.
Review the log for related log out errors.
ANS2533I The mount request started. User response
Backup-ID=backupId No action is required.

Explanation ANS2537I The dismount request was

completed successfully.
The user selected a backup to load. Backup-ID=backupId Backup-
Date=backupDate Mount-
System action ID=mountId
Processing continues.
Explanation
User response The backup was successfully dismounted.
No action is required.
System action
ANS2534I The mount request was completed
successfully. None.
Backup-Date=backupDate Mount-
ID=mountId User response
No action is required.
Explanation
ANS2538I The dismount request failed.
The backup was successfully mounted.

Chapter 2. ANS 0000-9999 messages 223

 Backup-ID=backupId Backup- ANS2542I The final restore processing
Date=backupDate Mount- statistics are available.
ID=mountId Total Objects=totalObjects Total
Restored=totalRestored Total
Explanation Failed=totalFailed Total
Bytes=totalBytes Completion
An error occurred while dismounting the backup. Code=completionCode

System action Explanation

Dismount processing stops. The restore processing statistics contain completion
codes that indicate the state of the restore operation.
User response
• A completion code of 0 indicates that all items were
Review the log for related dismount errors. successfully restored.
ANS2539I The restore request started. • A completion code of 8 indicates that the restore
Selection-Size=selectionSize Alt- operation was completed but some items were not
Destination=altDestination restored.
• A completion code of 12 indicates that the restore
Explanation operation was unsuccessful.
The user submitted a request to restore files,
directories, or both from a backup. System action
None.
System action
Processing continues. User response
If the completion code is not 0, review the logs for
User response related restore errors.
No action is required. ANS2543E A status of 'state' is returned
because the Microsoft iSCSI
ANS2540I The restore request was Initiator Service is not running.
completed successfully.
Explanation
Explanation
The Microsoft iSCSI Initiator Service is not running.
The restore request was successfully submitted.

System action
System action
Operation cannot continue.
None.

User response
User response
Start the Microsoft iSCSI Initiator Service.
No action is required.
ANS2544E A status of 'state' is returned
ANS2541I The restore request failed. because the Microsoft iSCSI
Initiator Service is not installed.
Explanation
An error occurred during the restore request. Explanation
The Microsoft iSCSI Initiator Service is not installed.
System action
Restore processing stops. System action
Operation cannot continue.
User response
Review the log for related restore errors.

224 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Install the Server Role 'File and iSCSI Services' Install the Hyper-V role on the Windows server host.
Alternatively, specify another Hyper-V host.
ANS2545I A crash consistent snapshot is
created for the backup of virtual ANS2548E The status query for Hyper-V on
machine 'VM name'. the host 'host' failed due to lack of
privileges.
Explanation
Explanation
A crash consistent snapshot is created for the backup
of the virtual machine. The User ID running this command does not have the
necessary privileges to access Hyper-V information on
System action the host.

The virtual machine backup continues.

System action

User response Processing stops.

If an application consistent backup was requested but

User response
failed, check the dsmerror.log file and the Hyper-V
event logs for the reason for the failure. Ensure that the current User ID is granted the
necessary privileges. Alternatively, try another user or
ANS2546W An incorrect disk location label specify another host.
'location label' is specified with
option 'option name' ANS2549E The connection to Hyper-V on host
'host' failed with rc= rc.
Explanation
Explanation
The disk location label must begin with 'SCSI' or 'IDE'
followed by the controller number and device location The connection to the Hyper-V host failed with a
number. system specific error.

System action System action

The specified disk location label is ignored. Processing stops.

User response User response

Verify that the disk location label is correctly specified. Ensure that the network is configured correctly.
Check the disk location label format. Ensure that the Ensure that the Hyper-V host is connected to the
label begins with 'SCSI' or 'IDE', and is followed by the network, is configured correctly, and is powered on.
controller number and device location number, which
ANS2550W The virtual machine backup
are expressed as digital numbers. For example, 'SCSI
0 0' or 'IDE 0 1'. operation will skip physical (pass-
through) disk 'drive name' on drive
ANS2547E The Hyper-V role is not installed number 'drive number'
on the specified Windows server
host 'host'. Explanation
Physical disks cannot be backed up during virtual
Explanation
machine backup operations using Resilient Change
Hyper-V is a feature of the Windows server that needs Tracking (RCT).
to be explicitly enabled by installing the Hyper-V role.
System action
System action
The virtual machine backup operation continues
Processing stops. without backing up the physical disks.

Chapter 2. ANS 0000-9999 messages 225

User response User response
Identify the physical disks and back them up by using No action is required.
another method.
ANS2554W No previous backups are found for
ANS2551W Cannot remove recovery disk 'drive name'. Instead of an
checkpoint for virtual machine incremental backup, a full backup
'VM-name'. is run for this disk.

Explanation Explanation
IBM Spectrum Protect cannot remove the recovery No backups are found for the disk on the IBM
checkpoint that was created during backup. Spectrum Protect server. Therefore, an incremental
backup cannot run.
System action
System action
The virtual machine backup continues.
Instead of an incremental backup, a full backup will
User response run for this disk.

Remove the recovery checkpoint manually after

User response
backup.
No action is required.
ANS2552E Backup of a virtual machine that
has a shared virtual hard disk is ANS2555W The incremental backup operation
not supported. was changed to a full backup for
virtual machine 'vmname' because
Explanation no previous backups are found on
the IBM Spectrum Protect server.
IBM Spectrum Protect does not support backup of a
virtual machine that has a shared virtual hard disk.
Explanation

System action No backups are found for the VM on the IBM Spectrum
Protect server, so an incremental backup cannot be
The backup will not occur. run. A full backup will be run instead.

User response System action

Use alternative backup method, such as in-guest A full backup operation will proceed for the VM.
backup.
ANS2553W Resilient Change Tracking (RCT) User response
has been turned off for disk 'drive No user action is required.
name'. Instead of an incremental
backup, a full backup is run on this ANS2556E The cluster operating system is in
disk. the process of a rolling upgrade
and working in mixed-OS mode.
Explanation Virtual machine 'vm_name' cannot
be backed up until the upgrade
RCT has been turned off for the disk. If disk RCT is completes.
disabled, no changes will be tracked after it is
disabled, and existing change tracking data will be
Explanation
lost. Therefore, an incremental backup cannot run.
The cluster operation system is using rolling upgrade,
System action including working in mixed-OS mode. The backup
cannot run during this upgrade operation.
Instead of an incremental backup, a full backup will
run for this disk. RCT will be turned on automatically
System action
for this disk during the backup.
The rolling upgrade continues, but the virtual machine
is not backed up.

226 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Wait for the rolling upgrade to complete, then start the An error occurred while trying to attach the IBM
virtual machine backup again. Spectrum Protect virtual volume snapshot to the
mount proxy. The restore operation cannot continue.
ANS2557E The virtual machine 'VM-name'
contains one or more physical
(pass-through) disks. Backups are System action
not supported in this Processing stops.
configuration. Specify the
'vmprocessvmwithphysdisks=yes' User response
option to exclude these disks from
the backup. Check the mount proxy dsmerror.log file for
information about how to resolve this issue.
Explanation ANS2560W The remote detach operation
Physical disks are not included in Resilient Change failed.
Tracking (RCT) backup operations so they cannot be
backed up by the IBM Spectrum Protect client. Explanation
An error occurred while trying to detach the IBM
System action Spectrum Protect virtual volume snapshot from the
The virtual machine is not backed up. mount proxy virtual machine. The restore operation
will continue.
User response
System action
Turn off the virtual machine and change the physical
disks to virtual mode or remove them from the virtual Processing continues.
machine. Alternatively, specify the
'vmprocessvmwithphysdisks=yes' option to exclude User response
these disks from backup operations.
Check the mount proxy dsmerror.log file for
ANS2558E The virtual machine 'VM-name' information about how to resolve this issue and
contains one or more physical manually remove resources that remain after the
(pass-through) disks. However, failed detach operation.
these physical disks are not all
ANS2561I The snapshot for virtual machine
available during the restore
'vmname' failed due to a
operation and the restore failed.
temporary condition. The
Specify the 'vmskipphysdisks=yes'
snapshot will be retried.
option to exclude these disks from
the restore.
Explanation
Explanation The snapshot for the virtual machine failed due to a
temporary condition. The snapshot will automatically
Physical disks are not all available during restore
be retried.
operations so the IBM Spectrum Protect client does
not restore the virtual machine successfully.
System action
System action Processing continues to the next virtual machine.
The restore operation failed.
User response
User response No action is required.
Check the physical disks and make sure that they are ANS2563I Starting retry snapshot number
available. Alternatively, specify the retryCount for virtual machine
'vmskipphysdisks=yes' option to exclude these disks 'vmname'.
from restore operations.
ANS2559E The remote attach operation
failed.

Chapter 2. ANS 0000-9999 messages 227

Explanation System action
The previous snapshot of the virtual machine finished The snapshot of the virtual machine finished with an
with an error. Another snapshot for of the virtual error. Processing continues to the next virtual
machine will be attempted. machine..

System action User response

Another snapshot attempt of the virtual machine is Check the Windows event log for the reason for the
started. failure. Resolve the problem, and run the backup
operation again.
User response ANS2567E The backup of vm-name failed
No action is required. because another backup is
currently in progress on the Hyper-
ANS2564I Gathering virtual machine V manager host machine.
information...
Explanation
Explanation
There is a concurrent backup going on the Hyper-V
The client is beginning the process of gathering manager host machine.
information about the virtual machines to be
processed. This length of time needed depends upon
System action
the number of virtual machines in the backup.
The backup operation stops.
System action
User response
Processing continues.
Try the backup operation again after the current
User response backup ends. Alternatively, if no other backups are in
progress, there might be a recovery checkpoint
No action is required. created by a previous failed backup. In that case,
ANS2565I Creating virtual machine remove the checkpoint with the Remove-
snapshot... VMCheckPoint cmdlet, and try the backup operation
again.
Explanation ANS2568I The backup request for VM
'vmName' started.
The client is beginning the process of creating a
snapshot for the virtual machines in the backup. This
length of time needed depends upon the number of Explanation
virtual machines in the backup. The user submitted a request to back up a VM.

System action System action

Processing continues. Processing continues.

User response User response

No action required. No action is required.
ANS2566E The snapshot of virtual machine ANS2569I The backup request was
'vmname' failed after the completed successfully.
maximum number of retries
(retryCount) was reached.
Explanation

Explanation The backup request was successfully submitted.

Several attempts to take a snapshot failed. Because

System action
the maximum number of retries was reached, the
operation will not be retried. None.

228 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response ANS2574I The maximum number of sessions
available to the restore operation
No action is required.
has been adjusted to
ANS2570I The backup request failed. adjusted_value. At least one
session must be allocated for each
Explanation disk being restored.

An error occurred during the backup request.

Explanation

System action The value of the VMMAXRESTORESESSIONS option is

less than value of the VMMAXRESTOREPARALLELVMS
Backup processing stops. option multiplied by the value of the
VMMAXRESTOREPARALLELDISKS option. This may not
User response be sufficient for the restore operation.
Review the log for related backup errors. The value of VMMAXRESTORESESSIONS is adjusted so
that each virtual machine restored in parallel has at
ANS2572I The restore request started for vm least one available session per disk restored in
'VmName'. parallel.

Explanation System action

The user submitted a request to restore vm. Maximum session value has been adjusted.

System action User response

Processing continues. None.

User response ANS2575I The process to collect the system

logs is started in background.
No action is required. Depending on the size of the log
ANS2573I The maximum number of restore files, this might take some time to
sessions specified by the complete. As soon as this process
VMMAXRESTORESESSIONS option is complete, you will be prompted
may not be sufficient for the by your browser to download the
restore operation. Each virtual following file:
machine restored in parallel must file name
be allocated at least one session
per disk restored in parallel. Explanation
The user requested system log files for problem
Explanation determination. The logs will be collected and provided
The value of the VMMAXRESTORESESSIONS option for download.
must be at least the value of the
VMRESTOREMAXPARALLELVMS option multiplied by System action
the value of the VMMAXRESTOREPARALLELDISKS The logs are collected and the download will start
option. This ensures that at least one session may be soon.
allocated for each disk being restored.

User response
System action
Wait for the download to complete. Locate the file
The maximum number of sessions available to the where the browser stores downloaded files.
restore operations is set to the value of the
VMMAXRESTOREPARALLELDISKS option multiploed ANS2576I The process to collect the system
by the VMMAXRESTOREPARALLELVMS option. logs is still running in background.
Orocessing continues. Depending on the size of the log
files, this might take some time to
User response complete. As soon as this process
is complete, you will be prompted
None.

Chapter 2. ANS 0000-9999 messages 229

 by your browser to download the User response
following file:
Verify the health and configuration of the specified
file name
host.

Explanation ANS2581E The Hyper-V host is reporting

issues that prevent it from
The user has already requested system log files for proceeding with the operation.
problem determination, but the process to collect the
system logs is still running. The logs will be provided
Explanation
for download once ready.
Issues have been detected on the specified Hyper-V
System action host. The system cannot support the intended
operation.
The download of system logs will start soon.
System action
User response
Processing stops.
Wait for the download to complete. Locate the file
where the browser stores downloaded files.
User response
ANS2577I The download of system logs is
Verify that the installation and configuration of the
currently disabled.
Hyper-V host system is correct. Check the
You can ask the system
dsmerror.log file for additional information, and
administrator to enable it by
contact the IBM Spectrum Protect administrator with
setting the option 'option name
the information in the messages that have been sent.
and value' in the 'configuration file
name' configuration file. ANS2582E The Hyper-V host 'host' is faulty:
Please note that you have to sign EnabledState = EnabledState
in again for the option to take (expected: 2), HealthState =
effect. HealthState (expected: 5),
OperationalStatus =
Explanation OperationalStatus (expected: 2).
The download of system logs is disabled.
Explanation

System action A faulty state has been detected for the specified
Hyper-V host.
The request has been canceled.
System action
User response
Processing stops.
In order to download the logs files the system
administrator needs to enable the option by editing
User response
the FR API configuration file specified in the message
text. User need to sign out and sign in again for the Verify the health and configuration of the specified
option to take effect. A restart of the Liberty server is host.
not required.
ANS2583E The restore target path 'state' does
ANS2580E The query for Hyper-V information not have enough free space for the
on host 'host' failed with rc= rc. restore operation.

Explanation Explanation
The query for Hyper-V status information failed with a The space on the selected restore target path is not
system specific error. sufficient for the restore operation.

System action System action

Processing stops. Processing stops.

230 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Increase the free space to at least 50 MB in the The snapshot of the virtual machine finished with an
restore target path, or choose a different path. error. Processing continues to the next virtual
machine.
ANS2584E The restore target path 'state'
could not be found, or the path has
not been created. User response
Contact the Hyper-V administrator to turn on the
Explanation volume shadow copy requestor integration service of
the Hyper-V virtual machine. When the service is
The selected restore target path could not be found, or enabled, run the VM backup operation again.
the path could not be created.
ANS2587E The application consistent
System action snapshot of virtual machine
'vmname' failed, possibly because
Processing stops. the volume shadow copy
requestor integration service is
User response not installed or is not running on
the guest virtual machine.
Create the restore target path manually or choose a
different path.
Explanation
ANS2585E num_discovered iSCSI devices
were discovered on the Hyper-V The volume shadow copy requestor integration service
host Microsoft iSCSI Initiator, must be installed and enabled on the guest virtual
while num_mounted were machine in order to take an application consistent
expected. snapshot.

Explanation System action

The logged in iSCSI targets in the Microsoft iSCSI The snapshot of the virtual machine finished with an
Initiator do not match the amount of expected logged error. Processing continues to the next virtual
in iSCSI targets. machine.

System action User response

Operation cannot continue. Contact the Hyper-V administrator to install and

configure the volume shadow copy requestor
integration service on the Hyper-V virtual machine.
User response When the service is installed and enabled, run the VM
Verify that the IBM Spectrum Protect mount is backup operation again. Alternatively, perform a crash
configured to use the correct Hyper-V host IP. To clean consistent snapshot of the virtual machine.
the environment, you must run the cleanup process.
ANS2600S Browser trying to establish
ANS2586E The application consistent connection to client; received
snapshot of virtual machine socket exception: exception-name
'vmname' failed because the
volume shadow copy requestor Explanation
integration service is not enabled
on the guest virtual machine. The browser received the exception when trying to
connect to the IBM Spectrum Protect client computer.
Explanation
System action
The volume shadow copy requestor integration service
must be enabled on the guest virtual machine in order The operation ends.
to take application consistent snapshots.
User response
Validate that the LAN is up and that you are trying to
connect to the correct port number.

Chapter 2. ANS 0000-9999 messages 231

Check the error logs for any additional information: User response
dsmerror.log, dsmwebcl.log, or dsmj.log. The
Determine what might be causing this kind of an
default location of these logs is the installation
exception. Determine if the LAN is down, or if the IBM
directory of the backup-archive client.
Spectrum Protect client acceptor on the IBM Spectrum
Ensure that the command line client runs without Protect machine is up and running.
problems. Test the command line client with a
ANS2604S The Web client agent was unable
command like "dsmc q sess".
to authenticate with the server.
ANS2601S The browser tried to connect to
the client and received unknown Explanation
host exception: exception-name
The Web client agent was unable to authenticate with
the IBM Spectrum Protect server.
Explanation
The browser received the exception when trying to System action
connect to the IBM Spectrum Protect client machine.
The operation ends.
System action
User response
The operation ends.
One possible solution is to run the command line client
so that the client password can be re-entered. Another
User response
approach is to check the error log on the IBM
Try the operation again. If it persists, determine what Spectrum Protect Web client agent system for any
might be causing this kind of problem. For example, relevant messages.
determine if your LAN went down, or verify if you are
trying to connect to the correct IBM Spectrum Protect ANS2605S Browser could not re-establish
client machine. connection to client; received
protocol error.
ANS2602S The browser tried to connect to
the client and received I/O Explanation
exception: exception-name
The browser received a protocol error trying to re-
connect to the client machine.
Explanation
The browser received the exception when trying to System action
connect to the IBM Spectrum Protect client machine.
The operation ends.
System action
User response
The IBM Spectrum Protect operation ends.
Determine what might be causing this kind of an error.
Determine if the browser and the IBM Spectrum
User response
Protect client code might be out of sync.
Determine what might be causing this kind of
ANS2606S An invalid password was sent to
exception. Try the operation again, and check if the
LAN is down. the server.

ANS2603S The browser tried to connect to Explanation

the client and received exception:
exception-name The password that was sent to the IBM Spectrum
Protect server was invalid.
Explanation
System action
The browser received the exception when trying to
connect to the IBM Spectrum Protect client machine. The operation ends.

System action
The IBM Spectrum Protect operation ends.

232 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response incorrect TCP/IP option settings in your client options
file. This error can also occur if the LAN connection
Make sure that you have the correct password. Also
went down or if your system administrator canceled a
make sure that it is valid, for example it is not too
backup operation.
short.
ANS2607S Browser could not establish System action
connection to client.
The IBM Spectrum Protect client ends.
Explanation
User response
The browser could not connect to the IBM Spectrum
Protect client machine. Retry the operation and make sure the LAN is up. Make
sure that both the IBM Spectrum Protect server and
the IBM Spectrum Protect client are up and running.
System action
ANS2611S An unknown error occurred in the
The operation ends.
browser.

User response
Explanation
Determine what might be causing this kind of a
An unknown error occurred in the applet running in the
problem. Determine if the LAN is down, or if the IBM
browser.
Spectrum Protect client acceptor on the IBM Spectrum
Protect machine is up and running.
System action
ANS2609S TCP/IP communications failure
between the browser and the The IBM Spectrum Protect operation ends.
client machine.
User response
Explanation Retry the operation. If the problem persists, turn on
This error can occur due to any of the following: tracing and see if the trace to the browser console
gives the reason for the error.
• The LAN connection to the IBM Spectrum Protect
client machine went down. ANS2612S An unknown error occurred in the
client
• You are trying to connect to the IBM Spectrum
Please check the IBM Spectrum
Protect client machine using the wrong port number.
Protect error eog for any
• The client acceptor on the IBM Spectrum Protect additional information
client machine is not up and running and accepting
connections. Explanation
An unknown error occurred in the IBM Spectrum
System action
Protect client.
The IBM Spectrum Protect operation ends.
System action
User response
The IBM Spectrum Protect client ends.
Retry the operation and make sure the LAN is up. Also
check that the port number is correct, and that the User response
client acceptor is started and running on the IBM
Spectrum Protect client machine, and that it is Retry the operation. If the problem persists, check the
listening on the correct port number. IBM Spectrum Protect error log for any additional
information.
ANS2610S TCP/IP communications failure
between the client and the server ANS2613S A communications protocol error
machine. occurred between the web
browser and the client.
Explanation
Explanation
An attempt to connect to the server using TCP/IP
communications failed. This can be a result of None.

Chapter 2. ANS 0000-9999 messages 233

System action System action
The operation ends. None

User response User response

Try the operation again. If the problem occurs again, Reboot the machine
verify that the IBM Spectrum Protect web client is
ANS2617S The destination directory specified
installed and configured correctly, and make sure you
is invalid.
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 Explanation
the target machine and the IBM Spectrum Protect The user specified a destination target directory for
Java applet, then reproduce the problem. Collect the restore or retrieve which is invalid.
traces and contact IBM for further assistance.
ANS2614S A protocol error occurred in System action
communications between the
The IBM Spectrum Protect operation ends.
client and the server.

User response
Explanation
Retry the operation specifying a valid directory name.
A protocol error happened between the IBM Spectrum
Protect client and the IBM Spectrum Protect server. ANS2619S The client acceptor was unable to
start the Remote Client Agent.
System action
The IBM Spectrum Protect client ends. Explanation
The IBM Spectrum Protect client acceptor could not
User response start the IBM Spectrum Protect Remote Client Agent.
Retry the operation. If the problem persists, check the
IBM Spectrum Protect error log for any additional System action
information. Verify that you are running the correct The IBM Spectrum Protect operation ends.
applet with the appropriate level of the client.
ANS2615S The user ID entered does not User response
match the node name configured Check the error log on the IBM Spectrum Protect Web
on the client machine. client agent for any relevant messages. Then correct
the problem and retry.
Explanation
ANS2620W The expand entire branch
The user ID that was entered is not the same as the operation may take a long time,
node name on this IBM Spectrum Protect client. and cannot be canceled once it has
started.
System action Are you willing to wait for the
operation to complete?
The IBM Spectrum Protect operation ends.
Explanation
User response
The expand entire branch operation could take a long
Verify that the node name entered is configured time and cannot be canceled once it is started.
correctly on the IBM Spectrum Protect client.
ANS2616I The machine must be rebooted for System action
the changes to take effect
Processing stopped; waiting for user intervention.

Explanation
The machine must be started for the restored registry
changes to take effect.

234 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Answer 'Yes' to start the expand entire branch Processing continues, but the user is not allowed to do
operation. If you answer 'No', the current operation this operation.
will be canceled.
ANS2622S An invalid ID or password User response
submitted. Do not perform this operation, or get a higher authority
level for your user ID in order to perform this
Explanation operation.
Either the ID is not registered on the IBM Spectrum ANS2625E Node does not support this image
Protect server, or the password for the ID is incorrect. operation.

System action Explanation

The operation ends. Node does not support or is not configured to perform
this image operation.
User response
System action
Verify that the ID you are using exists on the IBM
Spectrum Protect server to which the remote client Processing continues, but the user is not allowed to do
node connects. The ID must have sufficient privileges this operation.
to access the remote client node's data. Also make
sure that you have the correct password for the ID. If User response
the ID does not exist or if the password is unknown,
contact your IBM Spectrum Protect administrator. If Verify whether this image related operation is
the ID does not exist, then the IBM Spectrum Protect supported or configured on the target platform.
administrator can use the REGISTER ADMIN and ANS2626E The Include-Exclude statement:
GRANT AUTHORITY commands to register an ID that ieStatement
can access the remote client node's data. If the contains invalid characters.
password is unknown, the IBM Spectrum Protect
administrator can use the UPDATE ADMIN command
to reset the password. Explanation
The specified Include-Exclude statement has invalid
ANS2623S Web Client applet level is out of
characters.
sync with Web Client agent.

System action
Explanation
IBM Spectrum Protect will not add the specified
The Web Client applet and Web Client agents are at
Include-Exclude statement to the list.
incompatible levels.

User response
System action
Retry the operation with another statement that has
The operation ends.
valid characters.

User response ANS2627W The NTFS security attributes for

object 'full-name' could not be set.
Verify that you have the correct level of the applet Windows system error code: error;
installed with the client, and that an incorrect level of reason: 'error-reason'. Default
the applet was not placed in the install directory. NTFS security attributes have
ANS2624E This operation requires client been set.
owner authority.
Explanation
Explanation IBM Spectrum Protect was unable to set the NTFS
Your user ID has insufficient authority to perform this security attributes of the file. The error information
operation. captured indicates the reason for the failure. Default
NTFS security attributes have been set.

Chapter 2. ANS 0000-9999 messages 235

System action Explanation
Processing continues. The Java runtime library (libjvm), required by the
vCloud Suite plug-in library, cannot be loaded, or the
User response initialization of Java runtime environment failed.

Check the reason field for the code which explains why
System action
the NTFS security attributes have not been set. Correct
the condition causing the error and try the operation Operation is stopped
again. If the problem persists, contact your system
administrator or IBM Spectrum Protect administrator User response
for further help.
For Linux operating system, verify that a link named
ANS2628W Failed to create named stream of 'jre', referencing the 'jre' directory under your Java
object installation path, exists in the backup-archive client
'file_space_namepath_namefile_na installation directory. If a link does not exist, create
me'. the link (e.g. ln -s /opt/ibm/java-x86_64-70/jre /opt/
tivoli/tsm/client/ba/bin/jre). Alternatively, modify
Explanation LD_LIBRARY_PATH to include the path to libjvm.so
(e.g. export LD_LIBRARY_PATH=
The process was unable to create named stream. $LD_LIBRARY_PATH:/opt/tivoli/tsm/client/ba/
bin:/opt/ibm/java-x86_64-70/jre/bin/classic). For
System action Windows operating system, verify that the JRE
The named stream is not restored/retrieved. directory exists under the client installation directory.
Reinstall the backup-archive client if necessary.
User response ANS2631E The vCloud Suite plug-in library
cannot be initialized.
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 Explanation
that should have been logged when this message was The vCloud Suite plug-in library failed to initialize. This
written, take the corrective action and try the issue might be caused by the Java runtime not being
operation again. If the problem persists, contact your installed.
system administrator or IBM Spectrum Protect
administrator for further help.
System action
ANS2629I Migration: The filespace will be vCloud Suite operations cannot be performed.
migrated to the Incremental
Forever model.
User response
Explanation Verify that Java is installed.
The first time an Incremental Forever Incremental ANS2632E The vCloud Suite plug-in library
(IFIncr) backup is performed against a virtual machine cannot attach to the Java runtime.
that was previously backed up using the Periodic Full
model, and the latest backup is an incremental Explanation
backup, then backup chain will be migrated to the
Incremental Forever model. The vCloud Suite plug-in library failed attach to the
JVM runtime. This issue might be caused by the Java
runtime being corrupted or an incomplete installation.
System action
This message is for informational purposes only. System action
vCloud Suite operations cannot be performed.
User response
No action is required. User response
ANS2630E The Java runtime library for the Verify that Java is installed and functioning properly.
vCloud Suite plug-in library failed
to load or initialize.

236 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2633E The vCloud Suite plug-in runtime User response
library failed to log into the Check the dsmerror.log file for any additional
Platform Services Controller on messages that might be related to this problem,
'psc-host' with user name 'user-
enable VCLOUD tracing in the option file.
name': authentication failed.
ANS2636E The vCloud Suite plug-in library is
Explanation uninitialized.

The vCloud Suite single sign-on credentials specified

Explanation
in the VMCUSER and VMCPW options were rejected by
the Platform Services Controller. The vCloud Suite plug-in library is uninitialized. This
issue might be caused by an error loading or initializing
System action the plug-in library.

vCloud Suite operations cannot be performed.

System action

User response vCloud Suite operations cannot be performed.

Update the VMCUSER and VMCPW options with valid

User response
credentials for the targeted Platform Services
Controller. Check the dsmerror.log file for any additional
messages that might be related to this problem,
ANS2634E The vCloud Suite plug-in runtime enable VCLOUD tracing in the option file.
library failed to log into the
Platform Services Controller on ANS2640I The virtual machine 'VM-name' is
'psc-host'. configured with the 'exclude-
category' category and the
Explanation 'exclude-tag' tag, which excludes
the virtual machine from the
A connection cannot be established to the Platform backup operation.
Services Controller using the VMCHOST option.
Explanation
System action
The client option 'VMTAGDATAMOVER' is enabled so
vCloud Suite operations cannot be performed. that IBM categories and tags can be applied to virtual
machines.
User response
Verify that the value of the VMCHOST option is correct, System action
network connectivity to the host exists, and that the The virtual machine is excluded from the scheduled
Platform Services Controller service is running. Enable backup operation.
VCLOUD tracing in the option file for any additional
messages that might be related to this problem.
User response
ANS2635E The vCloud Suite plug-in runtime Remove the tag if the virtual machine should be
library encountered an internal included in scheduled backups, run an on-demand
error. backup of the virtual machine, or set the
'VMTAGDATAMOVER' option to 'No' in the client
Explanation options file.
The vCloud Suite plug-in library encountered an ANS2641E The client failed to load the
unexpected internal error that was not caught. VMware vCloud Suite plug-in
library 'piVcloudSuiteJNI'.
System action
vCloud Suite operations cannot be performed. Explanation
The VMware vCloud Suite plug-in library
'piVcloudSuiteJNI' could not be found or could not
be loaded. This issue might be caused by the library
being corrupted or an incomplete installation.

Chapter 2. ANS 0000-9999 messages 237

System action category' tag and can only be
backed up by a default data
The operation cannot be completed without the
mover. The virtual machine will be
VMware vCloud Suite plug-in library.
excluded from the scheduled
backup operation.
User response
Verify that the VMware vCloud Suite plug-in library Explanation
'piVcloudSuiteJNI' is in the 'plugins' folder in the
The client option 'VMTAGDATAMOVER' is enabled so
client installation folder or disable the clinet option
that IBM categories and tags can be applied to virtual
'VMTAGDATAMOVER'.
machines. The active data mover is not the default
ANS2642E The VMware vCloud Suite plug-in data mover so its unable to perform the backup
library could not find a required operation.
Java class or method.
System action
Explanation The virtual machine is excluded from the scheduled
The VMware vCloud Suite plug-in library failed to find a backup operation.
required Java class or method. This issue might be
caused by an incomplete installation, missing VMware User response
vCloud Suite plug-in JAR 'piVcloudSuiteJwrapper.jar'
file or the JAR files are not in the Java classpath. If you want to include the virtual machine in schedule
backups, assign a data mover tag to the virtual
machine or make sure a data mover is set up as a
System action default data mover by using the
The operation cannot be completed without the VMTAGDEFAULTDATAMOVER option.
VMware vCloud Suite plug-in library.
ANS2649E A Schedule name was not
provided.
User response
Verify that the VMware vCloud Suite plug-in library JAR Explanation
'piVcloudSuiteJwrapper.jar' is in the 'plugins' and the
An error occurred while processing. Either the option
other JAR files are in 'plugins/sdk' in the client
TAGSCHEDULE was missing or the value of the
installation folder or disable the clinet option
parameter was incorrect.
'VMTAGDATAMOVER'.
ANS2643I An on-demand backup of the System action
virtual machine 'VM-name' is
running. The virtual machine is The rebalance processing ended.
configured with the 'exclude-
category' category and the User response
'exclude-tag' tag. Provide a valid schedule with the TAGSCHEDULE
option and try the operation again.
Explanation
ANS2650E The process does not have the
The client option 'VMTAGDATAMOVER' is enabled so VMTAGDATAMOVER option
that IBM categories and tags can be applied to virtual specified.
machines, but the on-demand backup overrides the
tag setting for exclusion.
Explanation

System action An error occurred while processing. The option

VMTAGDATAMOVER must be present in the option file.
The backup operation continues.
System action
User response
The rebalance processing ended.
No action is required.
ANS2644I The virtual machine 'VM-name' is
not configured with a 'exclude-

238 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
To use this feature, employ a datamover configured as Delete the last snapshots created as they are not
a tagged datamover. managed by IBM Spectrum Protect. Unmount the
duplicate volume path in order to have a single mount
ANS2651E The ASNODENAME option must be
point to the same source volume. Restart IBM
provided to rebalance a VMware Spectrum Protect and retry the operation.
schedule.
ANS2667I Scan operation was successful.
Explanation
Explanation
An error occurred while processing. There was a
problem processing the ASNODENAME option or it was The virtual machine was scanned successfully.
not provided to the command.
System action
System action
The scan process stops for the virtual machine. The
The rebalance processing ended. next virtual machine in the data center will be
processed.
User response
User response
To use this feature, employ a datamover configured as
a proxy agent for a datacenter. None
ANS2659I datamover_count data movers are ANS2668E Scan operation failed with an
assigned to schedule sched-name. unexpected error.

Explanation Explanation
Since less than two data movers are assigned to this An unexpected error occurred during guest scan
schedule, assignment of datamover tags was not operations.
possible.
System action
System action
The scan process stops for the virtual machine. The
None. next virtual machine in the data center will be
processed.
User response
User response
Use the vCenter GUI to manually assign a data mover
to this schedule. Check the client error log for additional information.
ANS2666S Either the ource or target volumes ANS2669I Guest operating system platform
are duplicated. The same volume is not supported.
is mounted on more volume paths.
Explanation
Explanation
The operating system of the virtual machine was not
This error can occur when a source volume is mapped supported by the scan operation.
on more volume paths, for example, a drive letter and
one or more mount point directories. Because IBM System action
Spectrum Protect uses the volume path to keep track
of backup information in its internal backups database, The scan process stops for the virtual machine. The
it cannot back up the same volume with a duplicate next virtual machine in the data center will be
volume path. See addition information in the error log. processed.

System action User response

IBM Spectrum Protect cannot select the volume. None

ANS2670I Remote directory in guest is being
used by another application.

Chapter 2. ANS 0000-9999 messages 239

Explanation System action
The scan operation was unable to copy files to the The scan process stops for the virtual machine. The
remote directory because the directory is in use by next virtual machine in the data center will be
another application. processed.

System action User response

The scan process stops for the virtual machine. The None
next virtual machine in the data center will be
ANS2674I The virtual machine is not
processed.
connected to ESX server.

User response
Explanation
Ensure that the remote directory is unlocked. Then,
None
reschedule the scan operation.
ANS2671I Virtual machine name was not System action
found on the VMware server.
The scan process stops for the virtual machine. The
next virtual machine in the data center will be
Explanation
processed.
None
User response
System action
None
The scan process stops for the virtual machine. The
next virtual machine in the data center will be ANS2675E Proxy Rejected: Proxy authority
processed. has not been granted to the
specified data mover node.
User response
Explanation
None
The scan of the virtual machine failed.
ANS2672W Hostname could not be found for
the specified virtual machine System action
name.
The scan process stops for the virtual machine. The
next virtual machine in the data center will be
Explanation
processed.
This issue might be caused by the virtual machine not
running and not having a static IP address. User response
The IBM Spectrum Protect server administrator must
System action
grant proxy authority for this node. See the
The scan process stops for the virtual machine. The administrator command "Grant Proxynode".
next virtual machine in the data center will be
ANS2676W The guest operating system
processed.
credential was not found.
User response
Explanation
Make sure the guest is properly configured. Then,
reschedule the scan operation. The guest scan operation requires a valid operating
system credential.
ANS2673I Duplicate virtual machine name
was detected. System action
The scan process stops for the virtual machine. The
Explanation
next virtual machine in the data center will be
None processed.

240 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Ensure the guest operating system credential is set. None
Then, reschedule the scan operation.
ANS2677W The guest operating system System action
credential is invalid. The scan process stops for the virtual machine. The
next virtual machine in the data center will be
Explanation processed.
The guest scan operation requires a valid operating
system credential. User response
None
System action
ANS2681W ESX host or vCenter version is not
The scan process stops for the virtual machine. The supported.
next virtual machine in the data center will be
processed. Explanation
The ESX host or vCenter is a down level version.
User response
Ensure a valid guest operating system credential is set. System action
Then, reschedule the scan operation.
The scan process stops for the virtual machine. The
ANS2678I Guest machine is powered off. next virtual machine in the data center will be
processed.
Explanation
None User response
Refer to the product documentation for supported ESX
System action and vCenter versions.
The scan process stops for the virtual machine. The ANS2682I The guest credential has
next virtual machine in the data center will be insufficient permissions.
processed.
Explanation
User response
None
None
ANS2679I VMware Tools on the guest System action
machine is not running. The scan process stops for the virtual machine. The
next virtual machine in the data center will be
Explanation processed.
None
User response
System action None
The scan process stops for the virtual machine. The ANS2683W Cannot communicate with the
next virtual machine in the data center will be remote host.
processed.
Explanation
User response
This communication issue is caused by network errors
None or by the host not responding.
ANS2680I VMware Tools version on the guest
machine is not current. System action
The scan process stops for the virtual machine. The
next virtual machine in the data center will be
processed.

Chapter 2. ANS 0000-9999 messages 241

User response You can use the
VMMAXVIRTUALDISKS option to
Ensure that the network and host connection are
change the maximum size or
configured correctly. Then, reschedule the scan
specify the '-
operation.
VMSKIPMAXVIRTUALDISKS=yes'
ANS2684I The guest operation agent could option to exclude these disks from
not be contacted. the backup.

Explanation Explanation
None The IBM Spectrum Protect client does not back up
VMDKs that are larger than the maximum size.
System action
System action
The scan process stops for the virtual machine. The
next virtual machine in the data center will be The virtual machine is not backed up.
processed.
User response
User response Use the VMMAXVIRTUALDISKS option to change the
None maximum size or specify the '-
VMSKIPMAXVIRTUALDISKS=yes' option to exclude
ANS2685I The VM is a template. these disks from the backup.

Explanation ANS2688E The restore of a Hyper-V virtual

machine that was backed up using
VM templates are not supported by the scan incremental forever backup is not
operation. allowed on a Windows 2008 or
Windows 2008 R2 host. The
System action restore operation must be
completed on a Windows 2012 or
The scan process stops for the virtual machine. The
later Hyper-V host
next virtual machine in the data center will be
processed.
Explanation
User response A Hyper-V virtual machine that was backed up with the
incremental forever backup type can only be restored
None on a Windows 2012 or later Hyper-V host.
ANS2686E VM scan initialization error.
System action
Explanation The restore operation does not start.
The vm scan operation encountered an error during
initialization. User response
Try the operation again with a Windows 2012 or later
System action Hyper-V host.
The scan process stops for the virtual machine. The ANS2689E A Hyper-V command subcommand
next virtual machine in the data center will be
command was specified, but the
processed.
Hyper-V role is not enabled on the
host system
User response
Check the client error log and trace for additional Explanation
information.
The Hyper-V role must be enabled on the host system
ANS2687W The virtual machine 'VM-name' where the Hyper-V operation occurs. The current
contains one or more disks that system does not have the Hyper-V role enabled.
exceed the maximum size set by
the VMMAXVIRTUALDISKS option.

242 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The operation does not start. Try the operation again and specify mode IFFULL or
IFINCR.
User response ANS2692E An error occurred while
Try the operation again from a host that has the Hyper- registering the filespace for virtual
V role enabled. machine (VM_name).

ANS2690E A Hyper-V BACKUP VM command

Explanation
with mode IFFULL or IFINCR was
specified but the Data Protection An error occurred while registering the filespace for
for Microsoft Hyper-V license file the specified virtual machine.
does not exist or is not valid
System action
Explanation
The backup of this virtual machine fails. The backup
The Data Protection for Microsoft Hyper-V license file process can continue with other virtual machines.
is required to issue Hyper-V BACKUP VM commands
with mode IFFULL or IFINCR. Make sure the Data User response
Protection for Microsoft Hyper-V file is installed.
Check the error log for information about how to
resolve this issue.
System action
The backup does not start. ANS2693E An error occurred while
registering the filespace for virtual
machine (VM_name). There is a
User response filespace with the same name that
Try the operation again from a host that has the Data is currently being deleted.
Protection for Microsoft Hyper-V license file installed.
Or, issue the BACKUP VM command and specify mode Explanation
FULL.
An error occurred while registering the filespace for
ANS2691E A Hyper-V BACKUP VM command the specified virtual machine. A filespace with the
with mode FULL was specified but same name is currently being deleted on the IBM
the Data Protection for Microsoft Spectrum Protect server
Hyper-V license file exists. Mode
IFFULL or IFINCR must be System action
specified
The backup of this virtual machine fails. The backup
process can continue with other virtual machines.
Explanation
Hyper-V BACKUP VM commands with mode FULL are User response
not allowed on hosts where the Data Protection for
Microsoft Hyper-V license file is installed. Instead, Wait for the delete filespace to finish and run the
issue the BACKUP VM command using mode IFFULL or backup command again.
IFINCR. ANS2694W Application protection is enabled
If you must issue the BACKUP VM command with for virtual machine 'VM-name';
mode FULL, you must uninstall the Data Protection for however, this virtual machine
Microsoft Hyper-V license file. However, uninstalling contains one or more disks that
the license file invalidates the IFINCR backup chain. exceed the maximum size of 2 TB
As a result, an IFFULL is performed if the Data allowed for application protection
Protection for Microsoft Hyper-V license file is operations. Application protection
reinstalled. needs to be disabled in order to
backup this virtual machine.
System action
The backup does not start.

Chapter 2. ANS 0000-9999 messages 243

Explanation User response
The IBM Spectrum Protect client does not back up Perform a full VM backup for this virtual machine or
VMDKs that are larger than 2 TB when application specify the VMVERIFYAction option to force a full VM
protection is being used. backup.
ANS2697E The virtual machine cannot be
System action restored because the datastore
The virtual machine is not backed up. named 'datastore' does not exist
or is inactive.
User response
Explanation
Application protection must be disabled in order to
backup the specified virtual machine. The datastore referenced by virtual machine when it
was backed up does not exist or is inactive on the ESX/
ANS2695W The periodic full backup mode is ESXi that you are restoring the virtual machine to.
being used; however, the virtual
machine 'VM-name' contains one
System action
or more disks that exceed the
maximum size of 2 TB allowed for The virtual machine cannot be restored.
the periodic full backup mode. You
can use the '- User response
VMSKIPMAXVIRTUALDISKS=yes'
option to exclude these disks from Find the missing datastore or specify the -datastore
the backup, or change to the option on the Restore VM command to specify an
incremental forever backup mode. existing datastore to restore the virtual machine files
to.
Explanation ANS2698E Snapshot operation failed.
The IBM Spectrum Protect client does not back up
VMDKs that are larger than 2 TB when the periodic full Explanation
backup mode is being used. If you are performing a VSS or LVSA snapshot based
operation, it is possible that the snapshot was not
System action large enough to contain all the changes made to the
file system after the snapshot was created. This could
The virtual machine is not backed up.
cause the snapshot to become invalid thereby
preventing the IBM Spectrum Protect client from
User response reading the snapshot.
Use the '-VMSKIPMAXVIRTUALDISKS=yes' option to
exclude these disks from the backup, or change to the System action
incremental forever backup mode.
The requested operation stopped.
ANS2696E Control or data files were found to
be compressed but not User response
deduplicated for vm vm name.
Examine the client error log for additional messages
related to this error. Perform corrective actions
Explanation
indicated by the messages, then try the operation
During a verify operation, the data mover detected that again.
one or more control or data files on the server are
ANS2699W Importing VM 'vm name' failed for
compressed, but not deduplicated. This is an invalid
state because data that is compressed, but not vApp 'vapp name'.
deduplicated, cannot be recovered. An incremental
forever full backup of the VM is needed before Explanation
incremental forever incremental backups can resume. The import VM from vSphere to a vCloud vApp
operation failed.
System action
The backup operation for this VM continues based on
the VMVERIFYIFAction option.

244 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Restore processing for the vApp continues. The vCenter returned an error indicating there is a
problem with the license. This error can occur when
User response the vCenter server version is at a lower level than the
ESX host version. The vCenter server version must be
Check the dsmerror.log file for information about why at the same (or later) level as the ESX host version.
the VM was not imported. Then, try the operation This error can also occur when the user ID specified by
again. If the problem persists, visit the IBM Support the VMCUser option does not have sufficient
Portal for additional information at http:// permission to perform the operation or the
www.ibm.com/support/entry/portal/. permissions are not applied at the vCenter server
ANS2700E Restoring VM 'vm name' of vApp level.
'vapp name' is not possible. There
is no VM backup data. System action
Processing stops.
Explanation
During the vApp restore, a VM that exists in the User response
restored vApp version could not be restored, because Verify the vCenter server is at the correct level, and
it was not successfully backed up. verify that the user ID specified by the VMCUser option
has sufficient permission to perform the operation.
System action
ANS2705S No Db2 UDB partitions are
The restore operation will proceed, attempting to available for restore.
restore any available vApp backup data.
Explanation
User response
No Db2 UDB partitions are available on the IBM
Examine the client error log for any messages that Spectrum Protect server for restore. This is most likely
might be indicate on the reason for the specified VM's due to a previous backup that was aborted before the
backup failure. Contact IBM Spectrum Protect backup completed. The Db2 UDB database and
technical support if further assistance is required. selected partitions cannot be restored.
ANS2701E The attempted database operation
was unsuccessful, check the error System action
log for any additional information. Processing stops.

Explanation User response

Processing stops. Issue the IBM Spectrum Protect client command
QUERY DB2UDB command with the -DETAIL
System action parameter using the same database, file, and date
Reserved. criteria to see if any database partitions are available
for restore. Alternatively restore the Db2 UDB
database from a different backup.
User response
ANS2706E The option
Check the error log for information regarding failure
VMBACKUPLOCATION=value is
and take further action.
not allowed with restore type
ANS2704E Error: The vCenter server version operation 'type'.
is at a lower level than the ESX
host version, or the user ID Explanation
specified by the VMCUser option
does not have sufficient Operation failed.
permission to perform the
operation. System action
Processing stopped.

Chapter 2. ANS 0000-9999 messages 245

User response System action
Remove option VMBACKUPLOCATION from the Processing stopped.
command line and try again.
ANS2707W The VMBACKUPLOCATION option User response
value BOTH was specified. The Delete the local backup from the IBM Spectrum
local backup for virtual machine Protect server for this virtual machine.
'VM-name' failed, but the backup
to the server completed. ANS2710E The virtual machine 'VM-name'
was removed from the inventory.
Explanation
Explanation
The local backup failed. Only the server backup was
successful. The virtual machine was removed from the inventory.
This removal invalidates all local backups.
System action
System action
Processing completed.
Processing stopped.
User response
User response
Contact your system administrator to resolve issues
that cause the local backup to fail. Delete all the local backups from the IBM Spectrum
Protect server for this virtual machine.
ANS2708E One or more disks of the virtual
machine 'VM-name' are not in a ANS2711E The snapshot of virtual machine
virtual volumes datastore. Local 'VM-name' was removed during
backup is not allowed. If the the backup.
VMBACKUPLOCATION option
value BOTH was specified, the Explanation
backup to the server will continue.
The virtual machine snapshot was removed by another
application or process during the backup. This removal
Explanation corrupts the backup and it becomes unusable.
Local backup is only supported for virtual machines
that are in a virtual volumes datastore. System action
The virtual machine is not backed up.
System action
Processing continues if VMBACKUPLOCATION=BOTH User response
was specified.
Ensure that another application or process does not
remove or modify the virtual machine during the
User response backup.
If you want local backup, contact your system ANS2712W The virtual machine 'name' has a
administrator to reconfigure the virtual machine and VMware Tools running, but
then try the backup again. VMware Tools is out of date.
ANS2709E The snapshot of virtual machine
'VM-name' was removed after the Explanation
backup.
A supported version of VMware Tools must be
installed, running and current to complete a virtual
Explanation machine backup.
The virtual machine snapshot was removed by another
application or process after the backup. This removal System action
corrupted the backup and it cannot be restored or
The backup operation fails.
mounted.

246 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Verify that a supported version of VMware Tools is To back up a fault tolerant virtual machine with
installed, current and running. Then, try the backup vStorage API for Data Protection, first disable fault
operation again. tolerant. Then, after the backup completes, enable
fault tolerant.
ANS2713E The virtual machine 'VM-name' is
in an invalid connection state ANS2716E A background copy process is still
'state'. As a result, it cannot be pending on local hardware. A
backed up. restore operation cannot be
initiated until the background
Explanation copy process is completed.

To back up a virtual machine it must be in the

Explanation
'connected' state to be accessed.
None.
System action
System action
The virtual machine is not backed up.
Processing stops.
User response
User response
Return the virtual machine to the 'connected' state
and try the backup again. Wait until the background copy process completes and
retry the restore operation.
ANS2714W The management class 'mc'
specified for the 'dest' backup ANS2717E The multi-node definition does not
destination is invalid. The default have permission to delete its own
management class will be used. backup files from the server.

Explanation Explanation
None. All DB2 UDB commands require that the multi-node
definition has permission to delete its own backup
System action files from the server in order to properly reconcile the
local backup repository with the server backup
Processing continues. repository.

User response System action

Contact the IBM Spectrum Protect administrator to Processing stops.
run the configuration utility for DB2 UDB and specify a
valid management class.
User response
ANS2715E The virtual machine 'VM-name' is Have the IBM Spectrum Protect administrator update
configured as a fault tolerant the multi-node definition so that it has permission to
virtual machine. As a result, it delete its own backup files from the server. For
cannot be backed up. example, on the IBM Spectrum Protect administrative
command-line client:
Explanation . dsmadmc update node <multi-node name>
vSphere does not allow for the snapshot or backup of backdelete=yes
fault tolerant virtual machines with vStorage API for ANS2718W The virtual machine 'VM-name'
Data Protection. requires snapshot consolidation.

System action Explanation

The virtual machine is not backed up. Snapshot consolidation is required when a snapshot is
deleted but its associated disk is not committed back
to the base disk. If consolidation is not completed,

Chapter 2. ANS 0000-9999 messages 247

snapshot disks might grow and eventually fill the data system administrator if you are not sure how to make
store. this correction.
ANS2721E The virtual machine is in an invalid
System action connection state. As a result, it
The virtual machine backup continues. cannot be backed up.

User response Explanation

Consolidate the virtual machine snapshots according One or more virtual machine backups failed because
to instructions provided in the appropriate VMware of an invalid connection state. A virtual machine must
vSphere documentation. be in the 'connected' state to be accessed for backup.

ANS2719E A previous backup started on

System action
'datetime', is using the resources
needed for new backup is still Processing stops for this virtual machine
pending.
User response
Explanation
Check the console output and error logs for
A new backup can not be done until previous backup information about why the connection state was
completes. invalid. Correct any issues and try backing up the failed
virtual machines.
System action ANS2722E There is not enough space in the
Processing stops. local repository to complete this
backup.
User response
Explanation
Wait until previous backup completes before starting
another local backup. Alternatively, use different This space available in the local repository is not
copyType value to perform a local backup. IBM enough to perform snapshot for this backup operation.
Spectrum Protect local backup policy only allows one It could happen if there is more number of local
incremental and one full background copy to be versions kept by the management class than there is
pending at any time, before local backup resources are space allocated in the local repository at configuration
reused for a new backup version. A new local backup time or application configuration has changed such
would result in a backup with background copy in that previously allocated space is not enough.
pending state.
System action
ANS2720W Failed to execute the command
'command'. None.

Explanation User response

IBM Spectrum Protect Failed to execute a command. Please validate IBM Spectrum Protect configuration by
The possible reason - the command interpreter cannot running the configuration wizard.
be found. Verify the ComSpec and PATH environment
ANS2723E A value of UNDEF for the
variables that locate the command interpreter. Either
ComSpec or PATH is not defined, or it is not correctly REAdstartsrecall option is not
defined. valid when the
HSMBACKENDMODE option is set
to IBM Spectrum Protect.
System action
The command does not run. Otherwise processing will Explanation
attempt to continue.
A value of UNDEF for the REAdstartsrecall option is
valid only when the HSMBACKENDMODE option is set
User response to TSMFREE.
Correct the ComSpec and PATH environment variable
that locate the command interpreter. Contact your

248 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
The operation stops. The file is skipped. The command is not processed.

User response User response

If the HSMBACKENDMODE option is set to IBM Install Data Protection for VMware or the license file
Spectrum Protect, set the REAdstartsrecall option to for Data Protection for VMware, and retry the
YES or NO. command. Or retry the operation from a host that has
the Data Protection for VMware license file installed.
ANS2725E IBM Spectrum Protect application
protection could not register the ANS2732E The BACKUP VM command failed
IBM Spectrum Protect VSS because the Data Protection for
provider on the guest VM 'VM'. Microsoft Hyper-V license file does
not exist or is not valid.
Explanation
Explanation
The guest vm credentials speficied on the datamover
do not have the correct required Windows permissions The Data Protection for Microsoft Hyper-V license file
for application protection. is required for the BACKUP VM command.

System action System action

The application protection vm backup processing The command is not processed.
stops.
User response
User response
Install Data Protection for Microsoft Hyper-V or the
Make sure that the credentials specified for the guest license file for Data Protection for Microsoft Hyper-V,
VM have the correct required Windows permissions for and retry the command. Or retry the operation from a
application protection type vm backups. The user host that has the Data Protection for Microsoft Hyper-
guide outlines the correct permissions that are V license file installed.
required for backuping and restoring application data
for Microsoft Exchange and Microsoft SQL Servers. ANS2733E An operation requiring the
Windows Management
ANS2729E Operating system command Instrumentation (WMI) service
'command' failed; rc=rc. has failed with the error
'errorstring'. IBM Spectrum
Explanation Protect has been denied access to
a WMI system due to insufficient
None. privileges.

System action Explanation

Process stops. Windows denied access to a Windows Management
Instrumentation (WMI) resource, object, or operation.
User response This program has insufficient permissions to perform
the requested operation.
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. System action

ANS2731E The BACKUP VM command failed Performing an operation requiring the Windows
because the Data Protection for Management Instrumentation service.
VMware license file does not exist
or is not valid. User response
Raise the permissions assigned to IBM Spectrum
Explanation Protect and retry the operation.
The Data Protection for VMware license file is required ANS2734E An operation requiring the
for the BACKUP VM command. Windows Management

Chapter 2. ANS 0000-9999 messages 249

 Instrumentation (WMI) service User response
has failed with the error
If files from the affected file systems or volumes must
'errorstring'. The application
be recovered, ensure that at least one disk is included
interface does not exist.
in the backup.

Explanation ANS2740E The vApp restore operation failed.

This error occurred because Windows Management

Explanation
Instrumentation (WMI) classes were not registered or
have become unregistered. WMI classes are registered The vApp restore operation failed. Check the error log
with Windows features. for details on why the operation failed.

System action System action

Initialization of a Windows Management Processing stops
Instrumentation object failed.
User response
User response
Review the console output and error logs for the
Register the Windows Management Instrumentation details on the problem. Fix any issues and restart the
classes of the appropriate Windows feature. operation.
ANS2736E An unexpected response was ANS2744I TESTFLAG Db2 enabled with the
received from a remote IBM value of 'value'.
Spectrum Protect file system
agent. Explanation
verb : verb
remote host : host None.
return code : rc
reason code : rs System action
msg. string : msg-string
This message is informational.

Explanation
User response
None.
None.

System action ANS2745E An assigned virtual disk to Hyper-

V Virtual Machine
Processing stops.
'virtualmachinename' cannot be
found.
User response
Contact the IBM Spectrum Protect administrator with Explanation
the information provided in this message. The IBM Spectrum Protect client detected that a
ANS2737W No disks from VM are mounted Virtual Machine has assigned a disk that is
because all disks were excluded unreachable. The disk may have been moved or
during the backup. deleted. A snapshot cannot be taken while the disk
cannot be found.
Explanation
System action
No disks from VM can be mounted because all disks
were excluded during backup or the VM did not The IBM Spectrum Protect could not find a virtual disk
contain any disks. at the assigned path.

System action User response

The operation stops. Check that the virtual disk has not been moved or
deleted and update the virtual machine configuration
to match any changes to the file system.

250 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2746E An assigned virtual disk to Hyper- backup virtual machines with
V virtual machine disks that exceed the limit of two
'virtualmachinename' is a VHD or terabytes.
invalid format. Only virtual disks
in VHDX format can be backed up. Explanation
The IBM Spectrum Protect client detected that a
Explanation Virtual Machine has assigned a disk whose capacity
The IBM Spectrum Protect client detected that a exceeds two terabytes. Virtual disks that exceed 2
virtual machine has assigned a disk that is in the VHD terabytes are currently not supported by incremental
format or is in an unrecognisable or unsupported forever backups.
format. If the disk is in VHDX format it may be
corrupted. System action
The IBM Spectrum Protect found a virtual disk whose
System action capacity exceeds two terabytes on a virtual machine
The IBM Spectrum Protect found a virtual disk in VHD scheduled for back up.
or unrecognisable format while preparing for a backup
of a virtual machine. User response
There are several options available: Remove the disk
User response from the virtual machine, shrink the disk to under two
If the virtual disk is in VHD format there are several terabytes, copy the data to virtual disk with a capacity
options: Remove the VHD from the virtual machine, under two terabytes. Even though incremental backup
convert the virtual disk from VHD format to VHDX is not available, the always full backup type is
format, or adjust DOMAIN.VMFULL to skip the virtual compatible with disks over two terabytes.
machine from backup. If the disk is in VHDX format,
ANS2749E See Microsoft Technote
check that the disk has not been corrupted.
KB2771882. An assigned virtual
ANS2747E An assigned AVHDX virtual disk to disk to Hyper-V Virtual Machine
Hyper-V virtual machine 'virtualmachinename' contains
'virtualmachinename' cannot find files that are on a Cluster Shared
the parent disk. Snapshots can be Volume and local volumes. A
taken only if the parent can be snapshot of a Virtual Machine in
found. this configuration cannot be taken.

Explanation Explanation
The AVHDX format specifies an internal field that The IBM Spectrum Protect client detected that a
points to a parent AVHDX or VHDX file. If the parent Virtual Machine has files involved in the snapshot on
cannot be found the disk is invalid and a snapshot will both local volumes and Cluster Shared Volumes.
fail. Attempting to snapshot a virtual machine in this
configuration always results in failure. This error is
System action documented in Microsoft Technote KB2771882.

The process discovered an AVHDX attached to a System action

virtual machine and attempted to find the parent
AVHDX or VHDX file. The IBM Spectrum Protect client discovered the virtual
machine has files on local volumes and cluster shared
User response volumes prior to taking a snapshot.

Check that the parent AVHDX or VHDX file still exists User response
and has not been moved or deleted. Return the parent
AVHDX and/or VHDX file. Check that all of the disks and the configuration files
are all on local volumes or cluster shared volumes. If
ANS2748E An assigned virtual disk to Hyper- necessary, perform a storage migration to move the
V virtual machine disks and/or configuration files.
'virtualmachinename' exceeds the
maximum capacity limit. The IBM ANS2750E The Hyper-V Virtual Machine
Spectrum Protect client cannot 'virtualmachinename' is currently

Chapter 2. ANS 0000-9999 messages 251

 undergoing one of the following Explanation
operations:
The Data Protection for Microsoft Hyper-V license file
* Creating Local Snapshot
is required for the BACKUP VM command.
* Applying Local Snapshot
* Deleting Local Snapshot
* Exporting Virtual Machine System action
* Migrating Virtual Machine The command is not processed.
* Volume Snapshot Service (VSS)
Snapshot
User response
* Restore
* Merging Differencing Disks Install Data Protection for Microsoft Hyper-V or the
The above operations prevent a license file for Data Protection for Microsoft Hyper-V,
Hyper-V VSS snapshot from taking and retry the command. Or retry the operation from a
place. Wait for the operation to host that has the Data Protection for Microsoft Hyper-
finish or cancel to perform a V license file installed.
backup.
ANS2753I Establishing inter-client
communication with node node(s).
Explanation
Some virtual machine management tasks interfere Explanation
with a virtual machine VSS snapshot. One of these
operations was detected during a back up request. None.

System action
System action
This message is informational.
The IBM Spectrum Protect client discovered the virtual
machine is currently undergoing an operation that will
prevent a Volume Snapshot Service snapshot from User response
occuring. None.

User response ANS2785I Gathering current Db2

configuration for 'type' restore.
Cancel or wait for the current virtual machine
management task to finish and then retry the back up.
Explanation
ANS2751E The RESTORE VM command failed None.
because the Data Protection for
VMware license file does not exist
System action
or is not valid.
This message is informational.
Explanation
User response
The Data Protection for VMware license file is required
for the RESTORE VM command. None.
ANS2790E Error Accessing Storage Virtual
System action
Machine 'svm_name' on NetApp
The command is not processed. Filer 'filer_name'.

User response Explanation

Install Data Protection for VMware or the license file The specified Storage Virtual Machine could not be
for Data Protection for VMware, and retry the accessed on the specified filer. Make sure that the
command. Or retry the operation from a host that has storage virtual machine exists and is running on the
the Data Protection for VMware license file installed. specified filer and that the storage virtual machine has
been correctly associated with the filer with the SET
ANS2752E The RESTORE VM command failed NETAPPSVM command.
because the Data Protection for
Microsoft Hyper-V license file does
not exist or is not valid.

252 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stops. If you need to use dsmtrace to enable or disable
tracing for a running client process, make sure that the
User response client is already running. If you used the -FILTER
option, try the command again with a different filter
Make sure that the storage virtual machine is running specification. You can use -FILTER=* to display all
on the specified filer and that the association between processes running on the system.
the filer and the storage virtual machine has been
defined correctly with the dsmc set netappsvm ANS2801E The dsmtrace utility was unable to
command. connect to the specified process.

ANS2798E Unable to start a session from

Explanation
client node 'nodename' multi-node
'multi-node' to client at address This message typically occurs when the specified
'ip-address:ip-port'. The return process ID is not active.
code is rc.
System action
Explanation
None.
None.
User response
System action
If you need to use dsmtrace to enable or disable
This message is informational. tracing for a running client process, make sure that the
client is already running. Use the dsmtrace QUERY
User response PIDS command to identify running client processes,
then try the command again.
None.
ANS2802I Tracing has been disabled.
ANS2799E An error was encountered during a
session with another client.
Explanation
Check the error log for any
additional information None.

Explanation System action

This message is reserved for DB2 UDB. None.

System action User response

Reserved. None.
ANS2803E Tracing could not be disabled.
User response
This message is reserved for DB2 UDB. Explanation
ANS2800W No IBM Spectrum Protect A problem occurred while trying to disable tracing for
processes were found. the specified process. This message is usually
accompanied by other, more specific messages
Explanation immediately preceding or following this message.

The QUERY PIDS command was unable to identify any

System action
known IBM Spectrum Protect processes running on
the system. If the -FILTER option was used, no No changes are made to the trace status of the
processes matching the filter specification were found. specified process.

System action User response

None. Review the messages that immediately precede or
follow this message for further information about this
error.

Chapter 2. ANS 0000-9999 messages 253

ANS2804W Tracing is already enabled. - ANS2807E An incorrect number of
TRACEFILE, -TRACEMAX, and - parameters was specified for the
TRACESEGSIZE are ignored. command-name command.

Explanation Explanation
When tracing is already enabled for a client process, The specified command was invoked with too few or
only the -TRACEFLAGS option has any effect. too many parameters.

System action System action

The -TRACEFLAGS options are set on the client The command is not processed.
process. -TRACEFILE, -TRACEMAX, and -
TRACESEGSIZE are ignored. User response
Try the command again with the correct number of
User response
parameters. Run \"dsmtrace help\" for additional
If you need to modify the -TRACEFILE, -TRACEMAX, or information on dsmtrace command syntax.
-TRACESEGSIZE settings, you must first use the
ANS2808W Incremental by snapshot
dsmtrace DISABLE command to disable tracing for the
difference backup did not locate
client process. Then run the dsmtrace ENABLE
the registered base snapshot
command to configure the desired trace settings. If it
is not necessary to modify these settings, then this 'regbase-name' on NetApp/N-
message may be ignored. Series filer volume 'volume-name'.
Snapshot 'olderbase-name' is used
ANS2805I Tracing has been enabled. as the base snapshot.

Explanation Explanation
None. Incremental by snapshot difference backup did not
locate the specified registered base snapshot on the
System action specified NetApp/N-Series filer volume. The most
recent existing snapshot which is older than the
None. registered base snapshot is used as the current base
snapshot.
User response
None. System action

ANS2806E Tracing could not be enabled. Processing continues.

Explanation User response

A problem occurred while trying to enable tracing for None.

the specified process. This message is usually ANS2809E The backupid 'backupid:' in the
accompanied by other, more specific messages input file does not match the
immediately preceding or following this message. vmname 'vmname:' being
restored.
System action
No changes are made to the trace status of the Explanation
specified process. There is a discrepency between the backupid and
vmname specified in the input file
User response
Review the messages that immediately precede or System action
follow this message for further information about this The virtual machine cannot be restored.
error.

254 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Confirm that the backupid specified matches the While processing Proxy relationships with the
vmname you are attempting to restore by re-running DataCenter node and DataMover node specified, no
the inquire_detail command and make any necessary appropriate Datamover node name matches detected.
corrections before attempting the restore again.
ANS2810E The IBM Spectrum Protect for System action
Virtual Environments Input File The operation cannot continue without a valid
'input file:' appears to be empty. Datamover Node name.

Explanation User response

While processing the Input File no items were found to Make sure the Datamover node name specified is a
operate on. valid IBM Spectrum Protect node name and that the
node has the proper proxy relationships established.
System action
ANS2813E The IBM Spectrum Protect Server
The operation cannot continue with an empty list. returned an empty network
address or port number for
User response 'datamover nodename'.

Confirm that the input file is not empty and has valid
Explanation
input. If the file is not empty it may be that an error
occurred while reading the file, please check the error While querying the IBM Spectrum Protect Server for
log for any errors found during the reading of the file. If the Datamover network address and port number, the
errors are found make the necessary corrections Server returned zero for one of the values.
before attempting the operation again.
ANS2811E The IBM Spectrum Protect for System action
Virtual Environments could not The operation cannot continue without a valid
find a suitable datamover agent Datamover network address and port number.
for the DataCenter Node
'datacenter nodename'. User response

Explanation This is usually the result of a Datamover Node not

being started. Log on to the Datamover host and start
While processing Proxy relationships with the or restart the DSMCAD service and retry the IBM
DataCenter Node specified, no appropriate datamover Spectrum Protect for Virtual Environments command
matches detected again. If the problem persists, work with your IBM
Spectrum Protect Server Administrator to inspect the
System action IBM Spectrum Protect Server activity log to identify
the issue.
The operation cannot continue without a valid
datamover. ANS2814E IBM Spectrum Protect for Virtual
Environments detected an error
User response while parsing the Input File 'input
file'. The 'specifier' appears to be
Work with your IBM Spectrum Protect Administrator to empty or invalid.
ensure that your DataCenter Nodes have granted
proxy authority to your DataMover Nodes.
Explanation
ANS2812E The IBM Spectrum Protect for While parsing the Input File an error occurred.
Virtual Environments could not
find Datamover node named
'datamover nodename' on the IBM System action
Spectrum Protect Server. The operation cannot continue without valid virtual
machine specifications.

Chapter 2. ANS 0000-9999 messages 255

User response Explanation
This is usually the result of an empty virtual machine While parsing the command line options, an empty
name or other identifier. Please check that the syntax vCenter Command-Line interface node name was
of the Input File is correct for all entries and that detected.
virtual machine names are not empty and retry the
operation. System action
ANS2815E IBM Spectrum Protect for Virtual The operation cannot continue without a valid vCenter
Environments detected an error Command-Line interface node name.
while parsing 'read in line' from
the Input File 'input file'. User response

Explanation This may be a result of the VMCLI profile having an

empty VE__TSMCLI_NODE_NAME entry. Please check
While parsing the Input File an error occurred. that the VMCLI profile is configured correctly
specifying the vCenter Command-line interface node
System action name.
The operation cannot continue without valid ANS2818E IBM Spectrum Protect for Virtual
specifications in the Input File. Environments detected that the
IBM Spectrum Protect Server port
User response was not specified.

This may be the result of an empty virtual machine

Explanation
name or other identifier. Please check that the syntax
of the Input File is correct for all entries and that While parsing the command line options, an empty
virtual machine names are not empty and retry the IBM Spectrum Protect Server port was detected.
operation.
ANS2816E IBM Spectrum Protect for Virtual System action
Environments detected that the The operation cannot continue without a valid IBM
IBM Spectrum Protect Server IP Spectrum Protect Server port.
address was not specified.
User response
Explanation
This may be a result of the VMCLI profile having an
While parsing the command line options, an empty empty VE_TSM_SERVER_PORT entry. Please check
Server address was detected. that the VMCLI profile is configured correctly
specifying the IBM Spectrum Protect Server port.
System action
ANS2820E An interrupt has occurred. The
The operation cannot continue without a valid network current operation will end and the
address for the IBM Spectrum Protect Server. client will shut down.

User response Explanation

This may be a result of the VMCLI profile having an This message is issued when the process is
empty VE_TSM_SERVER_NAME entry. Please check interrupted by a break signal such as CTRL-BREAK or
that the VMCLI profile is configured correctly CTRL-C.
specifying the IBM Spectrum Protect Server address.
ANS2817E IBM Spectrum Protect for Virtual System action
Environments detected that the The operation and process are ended immediately.
vCenter Command-Line interface
node name was not specified. User response
Restart the operation if desired.

256 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2821E The CAD service is not running for that the VMCLI profile is configured correctly
data mover node named specifying the vCenter node name.
'datamover nodename'.
ANS2825E IBM Spectrum Protect for Virtual
Environments detected that the
Explanation node name representing the
The CAD service is not running for the data mover. Datacenter is not specified.

System action Explanation

The operation cannot continue without a connection to While parsing the command line options, an empty
the data mover CAD service. datacenter node name was detected.

User response System action

Make sure the data mover CAD service is running and The operation cannot continue without a valid
that the node has the proper proxy relationships datacenter node name.
established.
User response
ANS2822E The data mover is unable to
connect to the IBM Spectrum This is a result of the -d DataCenter Node Name not
Protect server. being passed in to the Command-line. Re-try the
operation making sure to pass the -d Datacenter Node
Explanation Name to the command-line call.

There is no connection the specified IBM Spectrum ANS2826E IBM Spectrum Protect for Virtual
Protect server. Environments detected that the
node name representing the
vCenter Datamover is not
System action
specified.
The operation cannot continue without a connection to
the server. Explanation
While parsing the command line options, an empty
User response
Datamover node name was detected.
Possible causes are that the server name is spelled
incorrectly in the dsm.opt or dsm.sys file; an incorrect System action
server is being used; a communications failure or
firewall issue occurred; or the network cable is The operation cannot continue without a valid
unplugged. Datamover node name.

ANS2824E IBM Spectrum Protect for Virtual User response

Environments detected that the
node name representing the This is a result of the -o Datamover Node Name not
vCenter is not specified. being passed in to the Command-line. Re-try the
operation making sure to pass the -o Datamover Node
Explanation Name to the command-line call.

While parsing the command line options, an empty ANS2827E IBM Spectrum Protect for Virtual
vCenter node name was detected. Environments detected that the
input file is not specified.
System action
Explanation
The operation cannot continue without a valid vCenter
node name. While parsing the command line options, an empty or
non-existing input file name was detected.
User response
System action
This may be a result of the VMCLI profile having an
empty VE_VCENTER_NODE_NAME entry. Please check The operation cannot continue without a valid input
file name.

Chapter 2. ANS 0000-9999 messages 257

User response Explanation
This is a result of the -I Inputfile name not being The volume specified cannot be used for performing
passed in to the Command-line. Re-try the operation NetApp/N-Series snapshot difference incremental
making sure to pass the -I input file name to the operation. The volume does not correspond to the NFS
command-line call. mount point or the CIFS shared drive for a Network
Appliance or N-Series NAS volume. One possible
ANS2828E Image operations are not reason for this failure is that snapshot difference
supported for the specified file incremental backups can only be performed against
system. NetApp/N-Series NFS volumes on AIX/Linux
platforms, or CIFS volumes on Windows platforms.
Explanation
Another possible reason for this failure is that the
Image backup and restore are not supported for the qtree security style for the volume was incorrectly
specified file system. selected. If the CIFS volume is mapped on Windows,
ensure that the security style is set to NTFS. If the
System action volume is mounted as NFS, ensure that the security
style is set to UNIX.
The requested image operation is not performed.

System action
User response
Processing stops.
Choose another object.
ANS2829E Image operations are not User response
supported for GPFS.
Try the command again with a NetApp/N-Series NFS
or CIFS volume with the correct security style.
Explanation
ANS2832E Incremental by snapshot
Image backup and restore are not supported for GPFS
difference failed for filespace
volumes.
name. See the error log for details.

System action Explanation

The requested image operation is not performed. Failed to perform NAS NFS/CIFS Incremental by
snapshot difference operation.
User response
Choose another object. System action

ANS2830E An incorrect number of Processing stops.

parameters was specified.
User response
Explanation Take appropriate action based on the information in
The specified command was invoked with too few or the error log. If the problem persists please contact
too many parameters. your IBM Spectrum Protect administrator.
ANS2834E You have to be a root user in order
System action to perform incremental backup
Processing stops. using snapshot difference.

User response Explanation

Try the command again with the correct number of Failed to perform NAS NFS/CIFS incremental backup
parameters. operation using snapshot difference as the user was
non root.
ANS2831E Incremental by snapshot
difference cannot be performed on System action
'volume-name' as it is of type 'type'
and is not a NetApp/N-Series Processing stops.
'fsType' volume.

258 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Please retry the operation as root user. Processing stops.
ANS2835E Incremental backup using
snapshot difference is not User response
supported on this platform. Use the 'set password -type=filer' command to define
the user id and password for the specified NetApp
Explanation Filer and retry the snapshot differential backup
operation.
NetApp NFS/CIFS incremental backup operation using
snapshot difference is only supported on AIX, Linux ANS2838W The file path 'filename' exceeds
and Windows platforms. HSM maximaum path length.

System action Explanation

Processing stops. A file that you tried to migrate has a path name that is
too long.
User response
System action
Retry the incremental operation without the snapdiff
option. File skipped from migration.
ANS2836E Incremental backup operation
using snapshot difference is only User response
available for full volumes. Place files into a shorter path to make them available
is a partial volume or qtree. for migration.
ANS2839E Failed with ONTAPI error
Explanation
'error_code' while connecting to
Cannot perform NAS NFS/CIFS incremental backup NetApp Filer 'filer_name' using
operation using snapshot difference on the mounted user id 'id_name'. You might have
or mapped volume due to one of the following provided credentials incorrectly
reasons: 1) The volume is actually a qtree. 2) The for this Filer.
volume is not a full volume, it is not mounted or
mapped to the root of the volume. Explanation
The user ID and password have been configured
System action
incorrectly for the specified Filer.
Processing stops.
If you are using the snapdiffhttps option, ensure that
you are not specifying vFiler volumes as vFiler does
User response not support the HTTPS transport type.
Retry the incremental backup operation by specifying
an entire NAS NFS or CIFS volume. System action
ANS2837E Unable to access the required Processing stops.
stored NetApp filer credentials
(user id and password) for filer ''. User response
Make sure the SET PASSWORD -
TYPE=FILER command was Make sure that the credentials you have specified for
specified correctly to store the the Filer are the correct ones. Use the dsmc set
credentials. password command to specify the correct credentials
for your Filer and try the command again.
Explanation ANS2840E Incremental backup using
snapshot difference is not
The user id and password for the specified NetApp
supported for Data ONTAP file
Filer have been either not configured or have been
server version
specified incorrectly.
'version.modification.submodificati
on'. Upgrade the file server 'file-
server-name' to Data ONTAP

Chapter 2. ANS 0000-9999 messages 259

 version '7.3' or later in order to User response
perform incremental backup
This is a result of the -I Inputfile containing conflicting
operations using snapshot
input for createsnap: and vmsnapname: keywords. If
difference.
you intend to have IBM Spectrum Protect for Virtual
Environments use a VMWare Snapshot created by
Explanation FlashCopy Manager then specify createsnap:no with a
The file server specified is not at the Data ONTAP valid VMWare Snapshot for the vmsnapname:
version that supports snapshot difference API. keyword.
ANS2850E Error Creating Snapshot: Volume
System action NAS volume is a snapmirror
destination volume.
Processing stops.

Explanation
User response
An attempt was made to create a snapshot on a read
Upgrade the file server to Data ONTAP version 7.3 or
only snapmirror destination volume.
later and retry the operation.
ANS2841E Incremental by snapshot System action
difference is only supported on
AIX 64 bit and Linux 86 bit clients. Processing stops.

Explanation User response

Incremental backup using snapshot difference feature Rety the operation using the USEEXISTINGBASE and
is only available on IBM Spectrum Protect AIX 64 bit DIFFSNAPSHOT=latest options.
and Linux 86 clients. ANS2851E Snapshot Processing Error: .

System action Explanation

Processing stops. An error occurred due to the reason specified in the
message
User response
Try the command again with an IBM Spectrum Protect System action
AIX 64 bit or Linux 86 client. Processing stops.
ANS2842E IBM Spectrum Protect for Virtual
Environments detected an error User response
with the createsnap: keyword.
Ensure that the specified volume is online and allows
createsnap:yes is specified while
write access.
also specifying
vmsnapname:VMWare Snapshot ANS2855W IBM Spectrum Protect for Virtual
Name. Environments detected an error
while parsing the Input File 'input
Explanation file'. The 'specifier' should not be
specified when using 'specifier'.
While parsing the Input File for FlashCopy Manager for Option will be ignored.
VMWare offload backup, an error condition was
detected with VM Ware snapshot handling. Specifying
Explanation
a VMWare Snapshot name while specifying
createsnap:yes is not allowed. While parsing the Input File an error occurred.

System action System action

The operation cannot continue without specifying the The operation will continue ignoring this parameter.
correct createsnap: and vmsnapname: combination.

260 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
This is usually the result of an identifier used with the The operation was stopped
wrong option. Please check that the options in the
Input File matches the requested operation and retry User response
the operation.
Verify that configuration parameters for connection to
ANS2856E IBM Spectrum Protect for Virtual vCenter.
Environments detected that the
node name representing the ANS2859E Failed to locate the Organization
vCloud is not specified. VDC node that is used to store the
backed up data.
Explanation
Explanation
A node name that represents the vCloud is not
specified in the VMCLI profile. The Organization VDC node that stores the backed up
vApp data was not located. This node must be mapped
to the Provider VDC node. This issue might be caused
System action
by invalid mapping between the Provider VDC node
The operation cannot continue without a valid vCloud and the Organization VDC node.
node name.
System action
User response
The operation was stopped
Specify the vCloud node name in the
VE_VCENTER_NODE_NAME parameter in the VMCLI User response
profile. Then, try the operation again.
Go to the Configuration page and click 'Run the
ANS2857E IBM Spectrum Protect for Virtual Configuration Wizard' to verify that mapping
Environments detected while information for the Provider VDC node is valid.
parsing 'read in line' from the input
file 'input file' that option ANS2860E The PRESNAPSHOTCMD command
'specifier' is required for failed. The snapshot differential
'operation' operation. backup will not be executed.

Explanation Explanation

A required option or identifier is missing from the input The command specified by the PRESNAPSHOTCMD
file. option must complete successfully in order to execute
the snapshot differential backup. If the command
completed with a return code of 0 (zero), it is
System action
considered to have completed successfully. If the
The operation stops. command completed with any other return code, it is
considered to have failed. If the command failed then
User response the snapshot differential backup is not executed.

This may be the result of a missing option or identifier.

System action
Verify that the syntax of the command and the syntax
of the values in the input file are correct. Then, try the The client does not execute the snapshot differential
operation again. backup operation.
ANS2858E Failed to get the list of available
VMs for backup User response
Identify and repair the problem that caused the
Explanation command to fail. If a non-zero return code is normal
for this command, then consider wrapping the
Failed to get the entire list of VMs in order to choose command in a script that always exits with a return
ones that needed to be backed up. code of zero.
ANS2861W The POSTSNAPSHOTCMD
command failed.

Chapter 2. ANS 0000-9999 messages 261

Explanation was not detected on the host
system.
If the command specified by the POSTSNAPSHOTCMD
option completed with a non-zero return code, the
snapshot differential backup operation continues. The Explanation
operation continues with a warning-level result. The The Hyper-V role must be enabled on the host system
result of the POSTSNAPSHOTCMD command does not where the Hyper-V operation occurs. The current host
supersede a higher result from the snapshot system either does not have the Hyper-V role enabled
differential backup command. For example, if the or does not support Hyper-V.
snapshot differential backup command completed
with code 12, a lower return code from the
System action
POSTSNAPSHOTCMD command does not alter the
return code. The operation does not start.

System action User response

The snapshot differential backup continues, but with a If the host system supports Hyper-V then enable the
warning return code of at least 8. Hyper-V role. Otherwise, try the operation again from a
host system that supports Hyper-V and has the Hyper-
User response V role enabled.

Identify and repair the problem that caused the If you want to process VMware virtual machines, go to
command to fail. Consider wrapping the command in a the IBM Spectrum Protect window, and click Edit >
script that always exits with a return code of zero. Client Preferences > VM Backup. Click VMWare Full VM
or VMWare File Level. Then, click OK.
ANS2862E No entry found for the specified
Storage Virtual Machine. ANS2865E An error occurred creating or
accessing a virtual disk for virtual
machine 'VM-name'.
Explanation
The SVM does not exist in the registry or password file. Explanation
An error occurred creating or accessing a virtual disk
System action
while restoring a virtual machine.
No operation is performed.
System action
User response
The virtual machine is not restored.
The user should register the SVM using the Set
NetAppSVM command. User response
ANS2863E The backup-archive client failed to See the client error log for more detailed information
load the vCloud protection runtime about the error.
library.
ANS2866E An error occurred creating virtual
machine 'VM-name'.
Explanation
vCloud protection runtime library is not loaded by the Explanation
backup-archive client.
An error occurred creating the virtual machine during
the restore operation.
System action
The operation is stopped System action
The virtual machine is not restored.
User response
Verify that the vCloud runtime library exist in the User response
'plugins' folder under the client installation folder.
See the client error log for more detailed information
ANS2864E A Hyper-V operation was about the error.
attempted, but the Hyper-V role

262 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS2867E An error occurred querying virtual Explanation
machine 'VM-name'. Removal of the recovery snapshot of a virtual machine
does not reset the last successful backup time
Explanation maintained internally. The lack of a reset creates an
An error occurred querying the virtual machine during inconsistency between the backup time and the hard
the restore operation. disk configuration of the virtual machine. A full backup
fixes the ambiguity and prevent data loss.
System action
System action
The virtual machine is not restored.
An inconsistency in the virtual machine configuration
was detected.
User response
See the client error log for more detailed information User response
about the error.
Avoid deleting the recovery snapshot between back up
ANS2868E An error occurred removing virtual operations.
machine 'VM-name'.
ANS2872E The process was unable to restore
a virtual disk user metadata entry
Explanation of virtual machine 'vmname' to
An error occurred removing the virtual machine during disk 'diskpath'.
the restore operation.
Explanation
System action
An attempt to restore a user metadata entry of a disk
The virtual machine is not restored. failed. The user metadata of the disk may inaccessible
or unreachable.
User response
System action
See the client error log for more detailed information
about the error. A restore of a virtual disk.

ANS2869E A virtual machine on the

User response
hypervisor has a different name
but the same ID as virtual machine Check the user privileges include access to virtual disk
to restore 'VM-name' has. Restore writes or move the disk to an accessible location.
not allowed.
ANS2873I Virtual machine 'vmname' was
successfully restored. If this
Explanation
virtual machine was restored to a
A virtual machine with a different name and the same cluster, ensure that the cluster
ID than the virtual machine being restored exists on settings enable the restored
the hypervisor. virtual machine to operate in high
availability mode. High availability
System action settings, and the preferred set of
hypervisor nodes that can operate
The virtual machine is not restored. in high availability mode, might
not be set automatically.
User response
Choose a different virtual machine to restore to or Explanation
delete the existing virtuual machine. The specified virtual machine has been restored, but
ANS2870W the restore process does not alter Microsoft Failover
An incremental backup of virtual
Clustering High Availability settings. If you restored a
machine 'vmname' was requested,
virtual machine that you previously deleted, or if you
but the virtual machine lacks an
restored a virtual machine to a new name and location,
existing recovery snapshot. A full
the restored virtual machine might not be enabled as a
backup will be taken to prevent
high availability resource. Enable high availability for
data loss.

Chapter 2. ANS 0000-9999 messages 263

this virtual machine by using Microsoft Failover Cluster Explanation
Manager, System Center Virtual Machine Manager, or
The specified virtual machine is configured for high
by using PowerShell cmdlets.
availability, but must be deleted before it is restored.
To prevent the cluster service from attempting a
System action failover of the virtual machine to another cluster node,
Processing continues. IBM Spectrum Protect sets the RestartAction policy of
the indicated cluster resource to
"ClusterResourceDontRestart". After the restore is
User response
finished, IBM Spectrum Protect sets the RestartAction
Use Microsoft Failover Cluster Manager, System to its original value.
Center VM manager, or PowerShell to configure the
cluster to allow this virtual machine to perform in a System action
high availability configuration.
Processing continues.
ANS2876E Unable to access the required
stored NetApp Management Filer User response
credentials (user id and password)
for filer '' Usually no further user action is required. However, if
associated with storage virtual the restore operation is interrupted and subsequently
machine '' . restarted, then after the restore is finished, the
Make sure the SET PASSWORD - RestartAction policy of the resource must be manually
TYPE=FILER command was updated to its original value. In that case, use the
specified correctly to store the information in this message to update the
credentials. RestartAction policy to the original value.
ANS2878E Failed to change restart action for
Explanation cluster resources 'resourceName'
The user id and password for the specified NetApp from 'oldValue' to 'newValue'
management filer associated with the specified
storage virtual machine have been either not Explanation
configured or have been specified incorrectly.
IBM Spectrum Protect was unable to alter the
A storage virtual machine is associated with "RestartAction" policy of the specified cluster
management filer using the SET NETAPPSVM resource. The specified virtual machine is configured
command. Credentials for a management filer are for high availability, but must be deleted before it is
stored with the SET PASSWORD -TYPE=FILER restored. To prevent the cluster service from
command. attempting a failover of the virtual machine to another
cluster node, IBM Spectrum Protect tries to set the
System action RestartAction policy of the indicated resource to
"ClusterResourceDontRestart". After the restore is
Processing stops. finished, IBM Spectrum Protect tries to set the
RestartAction to its original value. However, an
User response attempt to alter the RestartAction policy was
unsuccessful.
Use the 'set password -type=filer' command to define
the user id and password for the specified NetApp
Management Filer. Use the 'set netappsvm' command System action
to associated a storage virtual machine with a Processing continues.
management filer. Ensure that both of these
commands were specified correctly and retry the
User response
snapshot differential backup operation.
After the restore is finished, the RestartAction policy of
ANS2877I Restart action for cluster resource the resource must be manually changed to its original
'resourceName' is changed from value. Use the information in this message to update
'oldValue' to 'newValue' the RestartAction policy to its original value.
ANS2888E Backup VM Full VM Incremental is
unable to run.

264 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 A valid IBM Spectrum Protect for failed vms num out of existing vms
Virtual Environments license file num VMs were not restored.
(license-file) cannot be located.
Explanation
Explanation
Although the vApp restore operation on the vCloud
The license file was not found, or cannot be opened completed successfully, one or more VMs were not
because of permissions, or the file is corrupted. restored.

System action System action

The system returns to the calling procedure. The operation completed successfully. However, some
VMs were not restored.
User response
User response
Check permissions on file. See if the license file is in
the correct place. Check the dsmerror.log file for information about why
the VMs were not restored. Then, try the operation
ANS2889I The vApp 'vapp name' was again. If the problem persists, visit the IBM Support
successfully restored under the Portal for additional information at http://
name 'new vapp name' www.ibm.com/support/entry/portal/.

Explanation ANS2900E IBM Spectrum Protect for Virtual

Environments detected that the
The restore operation was succesful in restoring the scan domain was not specified.
vApp into the specified name.
Explanation
System action
While parsing the command line options, no scan
This message is for informational purposes only. domain was detected. This error occurred because the
-domain option was not specified.
User response
No action is required. System action

ANS2890E The file to restore already exist The operation cannot continue without a valid scan
and the number of copies with domain.
same backup date has been
reached on the specified target User response
location! Run the operation again and specify the -domain
option.
Explanation
ANS2901E IBM Spectrum Protect for Virtual
On the specified target location the file to restore Environments detected that the
already exist, a copy of the file with appended the domain user was not specified.
backup date exist and the number of files with same
backup date has been reached.
Explanation

System action While parsing the command line options, no domain

user was detected. This error occurred because the -
The file is skipped. user option was not specified.

User response System action

Check on the target location if copies of the same file The operation cannot continue without a valid domain
can be removed or restore the file to a different user.
location.
ANS2891W The vApp 'vapp name' was User response
successfully restored. However, Run the operation again and specify the -user option.

Chapter 2. ANS 0000-9999 messages 265

ANS2902E Save domain password failed in ANS3000I communication-type
function func-name with return communications available on port
code return-code. port-number.

Explanation Explanation
An unexpected write access error occurred when the The specified communications are available on the
function tried to save the domain password. Write specified port number.
access does not exist to either the registry or to the
IBM Spectrum Protect for Virtual Environments on System action
Linux installation folder where the password file is
saved. None.

System action User response

The operation ends. None.

ANS3001W The default locale, English (United
User response States), is used because the
selected locale "locale" is not
Grant write access to either the registry or to the IBM
supported. The supported locales
Spectrum Protect for Virtual Environments on Linux
are as follows: supportedLocales
installation folder and try the operation again.
ANS2903E Read domain password failed in Explanation
function func-name with return
code return-code. The locale on the user's system or browser is not
supported.
Explanation
System action
An unexpected error occurred when the function tried
to read the domain password. The system defaults to the English (United States)
locale.
System action
User response
The operation ends.
Use the default locale or switch to one of the
supported locales.
User response
ANS3002I Session started for user userid
On Windows, verify that the password exists in the
registry. On Linux, verify that the password exists in (communication-method address).
the password file. Try the operation again.
Explanation
ANS2998I The option 'option' that was found
in the include/exclude file 'file- A session was started for the specified user.
name' at the line number: number
is not supported and will be System action
ignored by the client.
None.

Explanation
User response
The specified option is valid but not supported on the
None.
current platform and will be ignored by the client.
ANS3003I The new password is case
System action sensitive.
Processing continues.
Explanation

User response Your account has been updated to use case sensitive
password.
You can ignore the message or remove the option from
the include/exclude file.

266 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS3007I IBM Spectrum Protect client-name
terminating - idle for idle-minutes
None
minutes.

User response
Explanation
Make sure to remember the new password as you
The specified client is terminating because it has been
enter it, including character casing. For more details,
idle for the specified time. It will be automatically
contact your IBM Spectrum Protect administrator.
started when it is needed.
ANS3004E Session for user userid terminated
- invalid password entered. System action
The client program stops.
Explanation
A session was terminated for the specified user User response
because an invalid password was entered.
None.
System action ANS3008E Too many symbolic links were
detected while resolving name
The session with the specified user is terminated.
'file_name'

User response
Explanation
Re-start the remote client and enter the correct
password for the specified user. While trying to resolve the file name, too many
symbolic links were found.
ANS3005I Session for user userid terminated
- idle for idle-minutes minutes. System action
File skipped.
Explanation
A session was terminated for the specified user User response
because there was no activity on the session for the
specified number of minutes. Ensure that you do not have a looping symbolic link for
the file.
System action ANS3009E The Logical Volume Snapshot
The session with the specified user is terminated. Agent plugin library was not
found.
User response
Explanation
Re-start the remote client to begin a new session.
The Logical Volume Snapshot Agent (LVSA) plugin
ANS3006I Processing request for the IBM library should have been installed when the client was
Spectrum Protect Web Client (ip- installed, but it cannot be found.
address).
System action
Explanation
The selected operation is not performed.
A request for the Web Client is being processed.
User response
System action
Try the operation again. If the problem recurs, re-
None. install the IBM Spectrum Protect client software. If the
problem persists, contact IBM technical support for
User response further assistance.

None. ANS3010E The snapshot wizard operation

failed.

Chapter 2. ANS 0000-9999 messages 267

Explanation ANS3013E The specified snapshot provider is
not supported on this version of
The snapshot wizard operation failed with a non-zero
the operating system.
return code. Check the error log for additional
information.
Explanation
System action The specified snapshot provider is not supported on
the version of the operating system you are currently
The selected operation is not performed.
running. If another snapshot provider is available,
select it and retry the operation.
User response
Review the error log for any error messages, and then System action
retry the operation after correcting the cause for
The selected operation is not performed.
failure.
ANS3011E Previous changes have not been User response
commited.
The machine must be rebooted If another snapshot provider is available, select it and
before this operation can be retry the operation.
performed ANS3014E Expose snapshot failed for backup
document 'xml-backup-doc-file'.
Explanation
A previous operation required the machine to be Explanation
rebooted for the changes to take effect, but the Expose snapshot failed.
machine has not been rebooted. The machine must be
rebooted before this selected operation can be
System action
performed.
Processing stops
System action
User response
The selected operation is not performed.
See the dsmerror.log file for further details.
User response ANS3100E Unable to get the iSCSI initiator
Reboot the machine and then retry the operation. name. The Windows error is (error)
ANS3012E The Logical Volume Snapshot
Explanation
Agent is not installed. Use the
Setup Wizard to configure either The iSCSI initiator name is not configured on the
Online Image or Open File support system.
and choose the Logical Volume
Snapshot Agent as the snapshot System action
provider.
The operation stops.
Explanation
User response
The selected operation requires the Logical Volume
Snapshot Agent, but it is not installed. Use the Setup See the appropriate Microsoft Documentation about
Wizard to install the LVSA. how to configure the iSCSI initiator name.
ANS3101E The mount operation for virtual
System action machine 'vmname' failed with rc =
The selected operation is not performed. return-code. For more details,
check the Recovery Agent logs.
User response
Retry the operation after installing the Logical Volume
Snapshot Agent.

268 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
An error occurred during the mount operation. See the The operation stops.
output from the previous operation to identify the
cause of the error. User response
See the appropriate Microsoft Documentation about
System action
how to correct this iSCSI portal issue. Search http://
Processing stops. technet.microsoft.com/en-US/windowsserver for
iSCSI troubleshooting information.
User response ANS3105E Unable to connect all targets on
Review the recovery agent logs for information about the iSCSI Portal
how to resolve this issue. The target that is not connected is
'target'. Windows error is (error)
ANS3102I 'VMNAME' mounted successfully
and is ready
Explanation

Explanation The iSCSI portal is unable to connect all discovered

targets that were created by the IBM Spectrum Protect
The mount operation for the specified virtual machine Recovery Agent command-line interface.
completed successfully. As a result, the virtual
machine is ready for a file restore operation.
System action

System action The operation stops.

None.
User response

User response See the appropriate Microsoft Documentation about

how to correct this iSCSI portal issue. Search http://
None technet.microsoft.com/en-US/windowsserver for
ANS3103E Unable to load the dynamic link iSCSI troubleshooting information.
library (iscsidsc.dll). The Windows ANS3106E Windows Configuration Manager is
error is (error) unable to scan for new hardware.
Windows error is (error)
Explanation
The iSCSI dynamic link library (iscsidsc.dll) cannot be Explanation
found on the system. The new iSCSI disk connection cannot be detected by
the Windows Configuration Manager.
System action
The operation stops. System action
The operation stops.
User response
See the appropriate Microsoft Documentation about User response
how to install the dynamic link library (iscsidsc.dll). See the appropriate Microsoft Documentation about
ANS3104E A target was not found on the how to correct this hardware scan issue.
iSCSI portal ANS3107E The attempt to retrieve
The missing target is 'target' information for disk 'disk' failed
with Windows error (error).
Explanation
The iSCSI portal is unable to discover all of the targets Explanation
that were created by the IBM Spectrum Protect A Windows API call failed to retrieve the disk
Recovery Agent command-line interface. information.

Chapter 2. ANS 0000-9999 messages 269

System action Explanation
The operation stops. An error occurred while retrieving the mount with the
mount ID that is specified.
User response
System action
See the appropriate Microsoft Documentation for
information about how to resolve this Windows API Processing stops.
call issue.
ANS3108W The disk with label='label' is not User response
mounted because it was excluded No response is required.
during the backup (Reason:
'reason'). ANS3110E Unable to communicate with
Windows device 'device'. The
Windows error is (error)
Explanation
The disk cannot be mounted because it was excluded Explanation
during backup. It is not possible to recover files from
any of the file systems or volumes that use this disk. A Windows API call failed to open a Windows device.
Possible reasons for the disk exclusion are:
- The disk was explicitly excluded by using the System action
'exclude.vmdisk' option. - The disk is an independent
The operation stops.
disk, which cannot be backed up. The virtual machine
(VM) was backed up by using the
'vmprocessvmwithindependent yes' option, which User response
backs up normal disks while excluding independent See the appropriate Microsoft Documentation for
disks. - The disk contains one or more raw device information about how to resolve this Windows API
mapping volumes that are provisioned in physical call issue.
compatibility mode (pRDM), which cannot be backed
up. The virtual machine was backed up by using the ANS3111E Unable to mount the same
'vmprocessvmwithprdm yes' option, which backs up dynamic disks mutliple times.
normal disks while excluding pRDM disks. The disk 'disk' signature is the
same as the disk signature of
System action another disk that is online.

The operation continues. Explanation

User response It is not possible to attach a second disk to the system

with the same disk signature.
- If the data is on a normal disk, then ensure that the
disk is included in the backup. - If the data is on an System action
independent or pRDM disk, recreate the disk on the
restore machine. The data on the disk cannot be The operation stops.
restored because it was not backed up. - If a volume
was striped across both normal and independent User response
disks, use a full virtual machine restore rather than a
file-level restore. Note that the data on the striped The other disk with the identical disk signature must
volume will not be intact if all or part of the volume be dismounted before you can attempt the operation
was striped across independent disks, which are not again.
part of the VMware snapshot. - If files from the ANS3112E Windows Virtual Disk Service is
affected file systems or volumes must be recovered, not able to detect all new devices.
ensure that the disk is included in the backup.
ANS3109E The mount cannot be retrieved Explanation
because the following mount ID The Virtual Disk Service VDS is unable to access all
cannot be found: mountID iSCSI targets. Some targets are missing or not
working.

270 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The operation will be rolled back and stopped. See the appropriate Microsoft Documentation for
information about how to resolve this Windows API
User response call issue.

Determine why the data mover cannot access some ANS3116E The attempt to create directory
iSCSI targets. Determine that the IBM Spectrum 'dir' failed with Windows error
Protect server is working correctly. Determine that the (error).
iSCSI service is running. Search the Windows event log
for problems with the missing devices. Explanation
ANS3113E The virtual machine 'name' has at A Windows API call failed to create the directory.
least one mirror or RAID5 volume.
Mirror and RAID5 support is System action
disabled!
The operation stops.
Explanation
User response
During the mount operation it was detected that the
virtual machine has a mirror or RAID5 volumes. The See the appropriate Microsoft Documentation for
support for such volumes were diabled by the information about how to resolve this Windows API
Administrator. call issue.
ANS3117E The mount volume attempt at
System action directory 'dir' failed with Windows
The operation stops. error (error).

User response Explanation

Contact the Administrator for more information. A Windows API call failed to mount the specified
volume.
ANS3114E The attempt to retrieve
information for volume 'volume' System action
failed with Windows error (error).
The operation stops.
Explanation
User response
A Windows API call failed to retrieve the volume
information. See the appropriate Microsoft Documentation for
information about how to resolve this Windows API
call issue.
System action
ANS3118E Unable to determine the operating
The operation stops.
system type of the VM to be
restored.
User response
See the appropriate Microsoft Documentation for Explanation
information about how to resolve this Windows API
call issue. The operating system type of the VM to be restored
cannot be determined. This issue can occur when the
ANS3115E The attempt to bring disk 'disk' restore parameter -VMOSType is not specified or it
online failed with Windows error specifies an incorrect operating system type.
(error).
System action
Explanation
The operation stops.
A Windows API call failed to bring the disk online.
User response
System action
Use the -VMOSType parameter to specify the correct
The operation stops. operating system type of the VM to be restored.

Chapter 2. ANS 0000-9999 messages 271

ANS3119W Operating system type "name1" is System action
detected but operating system Processing stops.
type "OSname" is specified.

User response
Explanation
To store the VM file restore data, the data mover
The operating system type of the detected VM does
application requires read and write access to the
not match the type specified with the restore C:\Documents and Settings\AllUsers\Application Data
parameter -VMOSType. Inconsistent operating system \Tivoli\TSM\ or C:\ProgramData\Tivoli\TSM folder.
types might negatively impact the mount operation. Set the access rights to this directory so that your user
The operation will continue using "OSname" as the has the correct rights.
operating system type. If the file was damaged it can be helpful to replace the
current version with the .bak file.
System action
ANS3124E The user session cannot be
The operation continues. retrieved because the context ID
cannot be found
User response
If the mount operation fails, try the operation again Explanation
and use automatic detection or specify the correct An error occurred while retrieving the current user
operating system. session. The error might be caused by a session that
ANS3122E The Microsoft iSCSI Initiator timed out.
Service encountered an error. The
Windows error is (error). System action
Processing stops.
Explanation
The Microsoft iSCSI Initiator Service encountered an User response
error during an iSCSI operation. This error caused the If the session timed out, log in again.
operation to stop.
ANS3125E The local data for file restore
System action mount with the ID: id and virtual
machine name 'name' cannot be
The operation stops. found!

User response Explanation

See the Microsoft iSCSI Initiator Service error message The local data set for the specified mount ID or virtual
to determine the cause of the error. If necessary, see machine name cannot be found.
the appropriate Microsoft Documentation for
information about how to resolve this iSCSI Initiator
System action
error.
The operation stops.
ANS3123E Unable to read or write the local
VM file restore data.
filename User response
File cannot be accessed or is Use the query "dsmc q vm <name> -
damaged. vmrestoretype=mount" command to get the correct
mount ID and virtual machine name for the cleanup.
Explanation
ANS3126E The node name of the mount proxy
For VM file restore operations, data must be stored on partner could not be found.
the local data mover in a directory that the user
running the restore can access. The data file might Explanation
also be damaged.
An error occurred while querying the IBM Spectrum
Protect server for the mount proxy partner. The node
could not be found. Communication with the mount

272 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
proxy partner is required to perform the restore Explanation
operation.
The mount cleanup operation for the specified virtual
machine completed.
System action
Processing stops. System action
None.
User response
Check the mount proxy partner node configuration and User response
ensure that the node is correctly configured and
None
running.
ANS3130E The mount cleanup operation for
ANS3127E The IP address or port of the
virtual machine 'vmname' failed
mount proxy partner could not be
with rc = return-code
found.

Explanation
Explanation
An error occurred during the mount cleanup operation.
An error occurred while querying the IBM Spectrum
See the output from the previous operations to identify
Protect server for the mount proxy partner. The IP
the cause of the error.
address or port of that partner could not be found. The
address and port are required to process file restores.
System action
System action Processing stops.
Processing stops.
User response
User response Check the dsmerror.log file for information about how
to resolve this issue.
Check the node configuration and ensure that the
mount proxy partner is correctly configured and ANS3131E The operation to disconnect the
running. Verify that the client acceptor daemon on the iSCSI targets from the Windows
mount proxy partner is running and able to connect to data mover failed.
the IBM Spectrum Protect server.
ANS3128E The node name of the Windows Explanation
mount proxy does not comply with An error occurred during the mount cleanup operation
IBM Spectrum Protect naming while disconnecting the iSCSI targets. See the output
conventions. from the previous operations to identify the cause of
the error.
Explanation
An error occurred while querying the IBM Spectrum System action
Protect server for Linux mount proxy partner. The Processing stops.
name of the Windows mount proxy does not comply
the naming convention. A correct name is required for
User response
processing of Linux VMs.
Open the Windows iSCSI Initiator Tool and disconnect
System action the targets and remove the target portal. Try the
operation again. The tool can be found in
Processing stops. "Administrative Tools" -> "iSCSI Initiator"
ANS3132E The Windows iSCSI Service is
User response
unable to get a list of all currently
Check the node configuration and ensure that the running sessions. The Windows
mount proxy name is correct. Use the web based error is (error)
configuration wizard to set up the configuration.
ANS3129I The mount cleanup of VM
'VMNAME' completed.

Chapter 2. ANS 0000-9999 messages 273

Explanation Explanation
The iSCSI Service could not get a list of all connected The iSCSI Service cannot remove the iSCSI Portal.
targets and the corresponding sessions.
System action
System action
The operation stops.
The operation stops.
User response
User response
See the Microsoft documentation for information to
See the Microsoft documentation for information to correct this iSCSI portal issue. Try the operation again.
correct this iSCSI issue. Try the operation again. Search http://technet.microsoft.com/en-US/
Search http://technet.microsoft.com/en-US/ windowsserver for iSCSI troubleshooting information.
windowsserver for iSCSI troubleshooting information.
ANS3136E The mount ID was not specified in
ANS3133E The target 'target' could not be the cleanup operation.
disconnected by the iSCSI portal.
The Windows error is (error) Explanation
The -MOUNTID parameter must be specified to
Explanation
perform a 'mountcleanup' operation.
The iSCSI portal is unable to disconnect all the
connected targets that were created by the recovery System action
agent command-line interface.
The operation stops.
System action
User response
The operation stops.
Use the query "dsmc q vm <name> -
vmrestoretype=mount" command to get the correct
User response
mount ID for the cleanup
See the Microsoft documentation for information to
correct this iSCSI portal issue. Try the operation again. ANS3137W 'VMNAME' mount completed with
Search http://technet.microsoft.com/en-US/ errors.
windowsserver for iSCSI troubleshooting information.
Explanation
ANS3134E The Windows iSCSI Service is
unable to get list of all currently The mount operation for the specified virtual machine
available portals. The Windows completed with errors. Only a subset of the virtual
error is (error) machine's disks are ready for a file restore operation.

Explanation System action

The iSCSI Service has a problem getting a list of all The VM disks that failed were reported in previous
available portals. messages.

System action User response

The operation stops. Review the previous error messages for the cause of
each failure.
User response ANS3138E The unmount of the volumes failed
See the Microsoft documentation for information to during the cleanup operation of
correct this iSCSI portal issue. Try the operation again. mount ID mountid
Search http://technet.microsoft.com/en-US/
windowsserver for iSCSI troubleshooting information. Explanation

ANS3135E The removal of iSCSI Portal An error occurred during the mount cleanup operation
'target' failed with a Windows while unmounting the volumes.
error of (error)

274 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS3142E The Windows Virtual Disk Service
encountered an error. The
Processing stops.
Windows error is (error)

User response
Explanation
See the output from the previous operations to identify
The Windows Virtual Disk Service is not working
the cause of the error.
correctly.
ANS3139E The attempt to unmount the disk
failed with Windows error (error). System action
The operation stops.
Explanation
The Windows API call failed to unmount the disks. User response
See the Microsoft documentation for information to
System action
correct this issue. Search http://
The operation stops. technet.microsoft.com/en-US/windowsserver for
Virtual Disk Service troubleshooting information.
User response ANS3143W The ISCSI service is not running.
See the Microsoft documentation for information to Its state is 'state'.
correct this issue; search the documentation for this
Windows error. Explanation
ANS3140E The connection to the following The ISCSI Service is not running.
iSCSI targets failed: 'target_list'.
System action
Explanation
The service maybe suspended, however operations
The iscsiadm command-line interface was not able to cannot continue.
connect to the specified iSCSI targets, from the Linux
mount proxy machine. User response
Start the ISCSI service.
System action
ANS3144W The ISCSI service is not running.
The operation stops.
File restore mount and instant
access operations will not work.
User response
If the target is already connected on the Linux mount Explanation
proxy machine, log out from the target, for example:
The ISCSI Service is not running. This service is
iscsiadm -m node -T targetname --logout Also, verify
required on the Windows and Linux mount proxy for
that the iSCSI server address is correctly specified.
file restore mount operations. This service is also
ANS3141W Mounting the following devices required for full VM instant access operations.
failed: 'device_list'.
System action
Explanation
Mount operations for file restore cannot continue.
It was not possible to mount the specified devices on Instant access operations cannot continue.
the Linux mount proxy machine.
User response
System action
Start the ISCSI service if you want to perform a file
The operation continues to mount the other devices. restore operation or instant access operation.
ANS3145E A Windows API call has failed.
User response
Perform a cleanup, or try to manually unmount the
devices on the Linux mount proxy machine.

Chapter 2. ANS 0000-9999 messages 275

Explanation System action
A Windows API call has failed. The operation continues.

System action User response

Operations cannot continue. The Linux mount proxy machine tried to reuse the
already connected targets. If the volumes are not
User response correctly mounted, manually disconnect the targets on
the Linux mount proxy machine. For example:
See the dsmerror.log for more information. iscsiadm -m node -T targetname --logout; iscsadm -m
ANS3146E The cleanup operation to unmount node -T targetname -o delete
the volume volume failed. The ANS3149E The iSCSI target 'target' failed to
mounted file system is busy. disconnect from the Linux
machine.
Explanation The message from the iscsiadm
command-line interface is:
An error occurred during the mount cleanup operation
message_output
while unmounting the volumes on the Linux mount
proxy machine.
Explanation
System action The iscsiadm command-line interface was unable to
disconnect the specified iSCSI target from the Linux
Processing stops.
machine.

User response
System action
Ensure the file system is not in use and then try the
The operation stops.
cleanup operation again, or manually unmount the
volume on the host.
User response
ANS3147W The iSCSI Target 'iscsi_target'was
disconnected successfully, but the See if the target is already disconnected on the Linux
attempt to delete the target failed. machine, or try to manually disconnect it. For example,
iscsadm -m node -T targetname --logout Verify that
the iSCSI server address is correctly specified.
Explanation
ANS3150W The block device 'block_device' of
It was not possible to delete the object after the target
type 'device_type' failed to mount.
was disconnected.
The system message is:
'system_message'
System action
The operation continues. Explanation
It was not possible to mount one or more devices on
User response the Linux machine.
Try to manually delete the object on the Linux
machine. For example: iscsiadm -m node -T System action
targetname -o delete
The operation continues to mount the other devices.
ANS3148W The iSCSI Target 'iscsi_target' was
already connected. User response
Perform a cleanup, or try to manually unmount the
Explanation devices on the Linux machine.
The target was already connected on the Linux mount
ANS3151E The initiator.iscsi file does not
proxy machine. This error can occur if a cleanup was
exist or cannot be opened.
not perfomed, or if the cleanup was only partially
successful.

276 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS3155I The Windows data mover is 'name'
(ip)
The file does not exist or cannot be opened.

Explanation
System action
The DNS name and the IP of the Windows data mover.
Operations cannot continue.

System action
User response
None.
The ISCSI service may not be installed.
ANS3152E The initiator.iscsi file does not User response
have a valid initiator id entry.
This information can be used to determine if hostname
and IP of the Windows data mover are correctly
Explanation
resolved. The information can help if the iSCSI
No ISCSI Initiator ID exists. connection is not working as expected.
ANS3156I The iSCSI server address used is
System action 'ip'
Operations cannot continue.
Explanation
User response This message returns the IP address of the iSCSI
The ISCSI servoce may not be installed. server.

ANS3153E The mount cleanup completed

System action
with error for mount ID 'mountid'
of virtual machine 'VMNAME'; Error None.
log 'errlog' is available on
'machinename'. User response
This information can be used to determine if the IP
Explanation
address of the iSCSI server address is correctly
An error occurred during the mount cleanup operation resolved. The information might help you troubleshoot
while unmounting the volumes. The mounted file problems if the iSCSI connection is not working as
systems may be busy. See the error log to identify the expected.
cause of the error.
ANS3157I The Linux data mover is 'name' (ip)
System action
Explanation
Processing stops.
The DNS name and the IP address of the Linux data
mover.
User response
Ensure the file systems are not in use and the cleanup System action
or manually unmount the volumes on the host.
None.
ANS3154E The ISCSI service is not installed.
User response
Explanation
This information can be used to determine if hostname
The ISCSI Service is not installed. and IP of the Linux data mover are correctly resolved.
The information might help you troubleshoot problems
System action if the iSCSI connection is not working as expected.

Operations cannot continue. ANS3158W The attempt to create the

Windows share failed with
User response Windows error (error). The share is
not created.
Install the ISCSI service for your platform.

Chapter 2. ANS 0000-9999 messages 277

Explanation ANS3161E The attempt to unexport Linux file
system failed with error: NFS
The creation of the Windows share failed with the
service is not running.
given user/group name.

Explanation
System action
exportfs command failed to unexport the directory on
The Windows share is not created. The operation
the Linux mount proxy.
continues.

System action
User response
The operation stops.
One common reason for failures is that the specified
user/group does not exist. Ensure that the Windows
user or group name exists and is accessible on the User response
Windows data mover. If this is a domain user or group, Resolve the error on the Linux mount proxy. Manually
the Windows data mover has to be part of that domain. unexport the directory.
If this does not resolve the problem, see the
appropriate Microsoft Documentation for information ANS3162I The Mount cleanup of VM
about this error code. 'VMNAME' with mount id 'Id' and
snapshot date 'date time'
ANS3159E The attempt to remove the completed.
Windows Share failed with
Windows error (error).
Explanation

Explanation The mount cleanup operation for the specified virtual

machine completed.
A Windows API call failed to remove the Windows
Share.
System action

System action None.

The operation stops.

User response

User response None

See the appropriate Microsoft Documentation for ANS3163W The Linux Operating System is not
information about how to resolve this Windows API at the minimum level. Mount
call issue. operations may not complete
successfully.
ANS3160W The attempt to export Linux file
system failed with error: NFS
Explanation
service is not running.
The Linux Operating System is not at the minimum
Explanation level.

exportfs command failed to make the directory on the

System action
Linux mount proxy available for NFS clients to mount.
Mount operations may not complete successfully.
System action
User response
The operation continues without creating the NFS
export. Upgrade the Linux operating system to at least the
minimum level.
User response ANS3164W The minimum level for 'os' is
Resolve the error on the Linux mount proxy. Manually 'level'.
export the directory. Your current level is 'actual'.

278 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
The Linux Operating System is not at the minimum Ensure that IBM Spectrum Protect Recovery Agent is
level. correctly installed and configured.
ANS3168E IBM Spectrum Protect Recovery
System action Agent service is not running.
Mount operations may not complete successfully.
Explanation
User response IBM Spectrum Protect Recovery Agent service is not
Upgrade the Linux operating system to at least the running.
minimum level.
System action
ANS3165W A Package installed on the Linux
Operating System is not at the Operations cannot continue.
minimum level. Mount operations
may not complete successfully. User response
Start IBM Spectrum Protect Recovery Agent service.
Explanation
The Recovery Agent can be started using "net start
A Package installed on the Linux Operating System is RecoveryAgent" or by referencing IBM Spectrum
not at the minimum level. Protect Recovery Agent in services.msc.
ANS3169E The mount proxy's operating
System action system must be Windows Server
Mount operations may not complete successfully. 2012 or newer operating system.

User response Explanation

Upgrade the package to at least the minimum level. The Windows operating system is not at the minimum
level.
ANS3166W The minimum level for package
'package' is 'level'.
System action
Your current level is 'actual'.
Processing stops.
Explanation
User response
A Package installed on the Linux Operating System is
not at the minimum level. Upgrade the Windows mount proxy to a supported
operating system.
System action ANS3170W The attempt to export Linux file
Mount operations may not complete successfully. system failed with error: exportfs
command failed.
User response
Explanation
Upgrade the package to at least the minimum level.
exportfs command failed to make the directory on the
ANS3167E IBM Spectrum Protect Recovery Linux mount proxy available for NFS clients to mount.
Agent service is not installed.
System action
Explanation
The operation continues without creating the NFS
IBM Spectrum Protect Recovery Agent service is not export.
installed.
User response
System action
Resolve the error on the Linux mount proxy. Manually
Operations cannot continue. export the directory.

Chapter 2. ANS 0000-9999 messages 279

ANS3171E The attempt to unexport Linux file User response
system failed with error: exportfs Check the command-line output for the messages that
command failed. specify what problems were encountered during the
operation.
Explanation
ANS3175E The VM mount cleanup failed.
exportfs command failed to unexport the directory on
the Linux mount proxy.
Explanation

System action An error occurred during the mount cleanup operation.

The operation stops.

System action

User response Processing stops.

Resolve the error on the Linux mount proxy. Manually

User response
unexport the directory.
Check the command-line output for the messages that
ANS3172T Restoring virtual machine 'source' specify what problems were encountered during the
to new VM with name 'destination'. operation.

Explanation ANS3176W Unable to locate the Windows user

or group named 'name'. The share
The specified virtual machine will be restored as a new is not created.
vm with a new name.
Explanation
System action
IBM Spectrum Protect was unable to map the
None specified user or group name to a Windows security
identifier.
User response
None. System action

ANS3173E The Linux devices failed to mount The Windows share is not created. The operation
correctly. continues.

Explanation User response

The Linux devices failed to mount correctly. One common reason for this message is that the
specified user or group does not exist. Ensure that the
Windows user or group name exists and is accessible
System action on the Windows data mover. If this is a domain user or
Mount operations did not not complete successfully. group, the Windows data mover has to be part of that
domain.
User response This message can also indicate that the Windows data
Verify that the Linux mount proxy server can mover is not able to access the active directory
communicate with the IBM Spectrum Protect server. domain server. Ensure that network problems are not
preventing the Windows data mover from
ANS3174E The virtual machine mount failed. communicating with the active directory domain
server.
Explanation ANS3177E No iSCSI target was connected.
An error occurred during the mount operation. Check your iSCSI options for
backup-archive client.
System action
Explanation
Processing stops.
No iSCSI target was found or connected on the Linux
mount proxy machine.

280 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The operation is rolled back. Some characters cannot be used on multi platform
environments. To solve compatibly problems only a
User response limited set of characters are allowed on this specific
parameter.
Check that iSCSI is setup correctly on your Windows
as well as your Linux mount proxy. One common Parameter "-MOUNTPoint" is restricted at [a-z][A-Z]
reason for a failure is that the VMISCSIServeraddress [0-9][:][/][\][_]
option is not specified or is set incorrectly in the Parameter "-MOUNTTag" is restricted at [a-z][A-Z]
options file of the Windows data mover. [0-9][_]
ANS3178E Volume 'volume' of type Parameter "-EXPORTParameter" is restricted on
'file_system_type' has not been Windows at [a-z][A-Z][0-9][ ][-][_][\][@]
unmounted. System message:
'system_message' Parameter "-EXPORTParameter" is restricted on Linux
at [a-z][A-Z][0-9][.][:]
Explanation
System action
An error occurred during the mount cleanup operation
while unmounting the volumes on the Linux mount The operation continues with modified parameter.
proxy machine.
User response
System action None
Processing stops. ANS3181E The registry key
HKEY_LOCAL_MACHINE\SYSTEM
User response \CurrentControlSet\Services
\partmgr\Parameters\CrPolicy is
Ensure the file system is not in use and then try the
set to an other value than 3.
cleanup operation again, or manually unmount the
volume on the Linux mount proxy.
Explanation
ANS3179W Another folder share with the
same name 'name' already exists. If the registry key HKEY_LOCAL_MACHINE\SYSTEM
\CurrentControlSet\Services\partmgr\Parameters
\CrPolicy is set to an other value than 3 it can be that
Explanation the machine hangs during a mount operation. Change
IBM Spectrum Protect was unable to create a folder the value to 3 and reboot the machine.
share with the specified name because a share with
that name already exists. System action
The operation stops.
System action
The folder share is not created. The operation User response
continues and the VM disks are mounted for file
restore on the mount proxy. The registry key HKEY_LOCAL_MACHINE\SYSTEM
\CurrentControlSet\Services\partmgr\Parameters
\CrPolicy is not documented by Microsoft. Sometimes
User response this key is set to a value other than 3 what can lead to
Use operating system commands to create the share problems with the mount operation. Set the value to 3
of the folder with a unique name and delete it before and reboot the machine.
running the dismount operation.
ANS3182E The mount cleanup operation
ANS3180W The parameter 'name' contains timed out waiting minutes minutes
characters that are not allowed for response from Linux Mount
and have been removed. Proxy.
Resulting value is 'new'

Chapter 2. ANS 0000-9999 messages 281

Explanation Explanation
The Windows Mount Proxy didn't receive any response The 'vgimportclone' command was not able to
from Linux Mount Proxy within the given timeout. The generate a new UUID for this LVM device, resulting in a
Linux Mount Proxy is possible in hanging state. duplicated UUID.

System action System action

Processing stops. The device of the target VM is skipped and not
mounted. The operation continues.
User response
User response
Check the status of Linux Mount Proxy machine and
mount proxy trace file for more details. In the case of a This problem has been observed on some Linux
complete system hang on umount, a reboot followed distributions where the 'vgimportclone' command
by manual mount cleanup of the Linux mount proxy was not able to generate a new UUID. In such case the
machine may be required. 'iscsiadm -m node -T ... --logout' command
may not able to remove such devices and a manual
ANS3183E Failed to revert volume mounted cleanup could be required e.g. by using the 'dmsetup
at . remove device_name' command. Note that such
situation could be also a signal that the target VM was
Explanation cloned from same template as the mount proxy. To
The volume revert operation failed. Try to mount the resolve the duplicated devices introduced due to a VM
volume manually. Find it's snapshot and attempt the machine clone, check the block devices of the target
revert operation. VM by using the 'blkid' command and make sure that
no duplicate UUIDs are present with the mount proxy
machines. If a duplicate device belongs to the target
System action VM and it is used, you need to assign it a new UUID or
The restore stops. remove such device.
ANS3185W A duplicate device UUID is found
User response on the mount proxy after the
Check IBM Spectrum Protect error log, Windows Event targets were connected. The
logs for more information. device 'new_device_name' with the
UUID 'new_device_uuid' of type
ANS3184W A duplicate device UUID has been 'new_device_type' is excluded from
found during the LVM activation the list of volumes to be mounted
phase of mount operation. The on the mount proxy.
'vgimportclone' system
command was not able to Explanation
generate a new UUID for the LVM
device 'LVMdeviceName' resulting The Linux operating system cannot to mount devices
in a duplicated UUID with the of this type when the UUID already exists on the
device 'LVMdeviceName2' of the system. This situation occurs because the target
mount proxy machine. The device virtual machine was cloned from the same template as
'LVMdeviceName3' has been the mount proxy.
excluded from the list of volumes
to be mounted on the mount System action
proxy. On some Linux distributions
this device could still be present The device for the target virtual machine is not
after the iSCSI disconnect phase mounted. The operation continues.
and a manual cleanup could be
required e.g. by using the User response
'dmsetup remove device_name' To resolve the duplicated devices that were
command. introduced because of a virtual machine clone, check
the block devices for the target virtual machine by
using the 'blkid' command and make sure that no
duplicate UUIDs are present for the mount proxy
machines. If a duplicate device belongs to the target

282 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
virtual machine and the device is in use, assign the ANS3401W The entity name is invalid.
device a new UUID or remove the device.
ANS3186W Opening and creating the block Explanation
devices failed. A volume with this name could not be found or is not
suitable for server-free operations.
Explanation
It was not possible to get the list of block devices on System action
the Linux mount proxy Processing stopped.

System action User response

The file restore operation stopped. Specify the correct name.
ANS3402W name: A system call func failed
User response
with code rc.
Check that the 'blkid' command is working correctly on
the Linux mount proxy machine. Explanation
ANS3187W Opening and creating the block An error occurred while obtaining information from the
devices failed. operating system. The volume information could not
be obtained.
Explanation
It was not possible to open the disk and create the System action
block devices on the Linux mount proxy machine. Processing can continue if the information being
obtained is not critical for the operation or if it is
System action expected behaviour in the context of the operation
being performed.
The file restore operation stopped.

User response
User response
Check the error log for any other messages that might
Check that on the Linux mount proxy machine, the
indicate a reason for the failure. Try to correct any
number of loop devices available are at least equal to
indicated problems, then try the operation again. If the
the number of virtual machine disks to mount. The
problem persists, contact IBM technical support for
advanced VMware transport mode is not supported on
further assistance.
the Linux mount proxy for file restore operations from
local backups. Use the vmvstortransport ndb option in ANS3403W Volume name cannot be opened
the server stanza of the mount proxy options file. If for reading. System error code is
you want to use NBDSSL, remove the /opt/tivoli/tsm/ err.
client/ba/bin/lib64/libdiskLibPlugin.so library and use
the vmvstortransport ndbssl option. Explanation
ANS3189W Original mount points can not be The named volume could not be opened. Examples of
found for guest system. why this can occur include, but are not limited to: the
device is not a valid system device, the device is
Explanation 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.
System action
The operation continues. System action
Processing stops.
User response
Check if /etc/fstab file exists and is accessible on User response
guest system.
Use your operating system's tools to obtain the
description of the error code. Also check the error log

Chapter 2. ANS 0000-9999 messages 283

for any other messages that might indicate a reason Explanation
for the failure. Try to correct any indicated problems,
The virtual machine is backed up successfully, but
then try the operation again. If the problem persists,
there is insufficient space available to write the last
contact IBM technical support for further assistance.
backup status in the 'Notes' field for the virtual
ANS3404W An error occured reading volume machine.
name.
System action
Explanation The backup operation completed.
The named volume could not be read. Examples of
why this can occur include, but are not limited to: the User response
data being read is outside the valid range of the
volume, or the device is locked by another application. Free some space in the 'Notes' field for the virtual
The operating system error code shown in the machine if the the last backup status is needed.
message indicates the specific reason for the failure. ANS3407W name is not local.

System action Explanation

If server-free data movement is used, processing The drive or filesystem is not local and is not suitable
continues using non-server-free data movement. for image backup.
Otherwise processing stops.
System action
User response
Processing stopped.
Use your operating system's tools to obtain the
description of the error code. Also check the error log
User response
for any other messages that might indicate a reason
for the failure. Try to correct any indicated problems, Specify a volume that is local.
then try the operation again. If the problem persists,
contact IBM technical support for further assistance. ANS3408E System call 'umount' failed for
volume 'volume' with errno='error'.
ANS3405W File system fs on volume name is Please take suitable action based
unknown. on errno and retry the operation.

Explanation Explanation
The file system on the volume is not supported for the Umount failed for the specified volume with the
operation being performed. indicated errno. Please take suitable action based on
errno and retry the operation.
System action
System action
If server-free data movement is used, processing
continues using non-server-free data movement. Processing stopped.
Otherwise processing stops.
User response
User response
Check errno for umount failure and take corrective
Check the error log for any other messages that might action before retrying the operation.
indicate a reason for the failure. Try to correct any
ANS3409W An error occurred writing to
indicated problems, then try the operation again. If the
problem persists, contact IBM technical support for volume name.
further assistance.
Explanation
ANS3406I Not enough space is available to
update the last backup status for IBM Spectrum Protect could not write to the named
virtual machine 'vm'. 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

284 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
shown in the message indicates the specific reason for Explanation
the failure.
The named function did not receive correct arguments
to proceed. Please check error log for additional errors
System action following this one for further explanation.
Processing stops.
System action
User response Processing stops.
Use your operating system's tools to obtain the
description of the error code. Also check the error log User response
for any other messages that might indicate a reason
Retry the operation. If problem persists contant your
for the failure. Try to correct any indicated problems,
IBM Spectrum Protect administrator.
then try the operation again. If the problem persists,
contact IBM technical support for further assistance. ANS3412I DiskMapper does not support
name for entity name.
ANS3410E The operating system refused a
request for memory allocation.
Explanation
Explanation The requested function is not implemented in
DiskMapper at this time. Please report this error to
The process requires access to memory in order to
your IBM Spectrum Protect administrator.
store information as processing proceeds. In this case,
more memory was requested than the operating
system would allocate. Possible reasons include: System action

The system is low on memory. Processing stops.

The process in which the program runs has
exceeded the maximum memory that it is allowed User response
to allocate. Contact your IBM Spectrum Protect administrator.
Some other error condition occurred that caused
the program to think it is out of memory. ANS3413I DiskMapper object 'name' type
'name' is not valid.
System action
Explanation
The process cannot complete the requested operation.
The named object is not valid on the originating client
User response system.

Close all unneeded applications and try the operation System action
again. If the operation still fails, try dividing the task
into serveral smaller units. For example, if a file Processing stops.
specification contains several high level directories,
run the IBM Spectrum Protect task serially for each User response
directory. If the task is an incremental backup, use the
option "-memoryefficientbackup=yes". Retry the operation. If the problem persists, review the
client error log for other messages that might be
For UNIX systems that support resource limits, check related to this problem. Contact your IBM Spectrum
to see b if the memory resource limit is too low by Protect administrator for additional help.
entering the following command: ulimit -a
ANS3414I Disk 'name' is not part of any
Based on the resulting data, you can ask the UNIX container defined on the system.
system root user to increase resource limits so that it
will override the current default. The UNIX system root
Explanation
user has the authority to increase resource limits.
None.
ANS3411E Invalid arguments were passed to
function name.
System action
None. This is informational message.

Chapter 2. ANS 0000-9999 messages 285

User response User response
None. Check the error log for any other messages that might
indicate a reason for the failure. Try to correct any
ANS3415W At least one of the disk containing
indicated problems, then try the operation again. If the
data for 'name' has bad blocks.
problem persists, contact IBM technical support for
further assistance.
Explanation
ANS3418W Memory allocation request for
One or more physical disks containing data blocks of image backup operation was
the above object has bad blocks and the requested refused by the operating system.
operation can not continue.
Explanation
System action
IBM Spectrum Protect requires access to memory in
The system may find a work-around to complete the order to store information about used blocks of a file
requested operation, pleasecheck console log and system. In this case, more memory was requested
error log for additional information on corrective than the operating system would allocate.
actions taken or suggested user action.
System action
User response
If imagegapsize is too small for a dedicated
Depending on the operation the process may suggest filesystem and the client faces out-of-memory
an alternate way to complete the operation. Check condition then the client automatically switches to full
your error log, sched log, or console log for additional volume backup. Operation continues with
information. imagegapsize = 0.
ANS3416E The volume 'name' is currently in
use by other process. User response
Some recommendations to avoid the out-of-memory
Explanation condition:
The operation requires exclusive access to the volume. check to see if the memory resource limit is too low
The most likely cause of this failure is that other by entering the following command: ulimit -a
process on the system has the volume opened. Then you can ask the UNIX system root user to
increase memory limit.
System action increase the value of the imagegapsize option.
The bigger imagegapsize is used, the less
Processing stopped.
memory is needed for image backup, but more
unused data is sent to server. And vice versa: the
User response smaller imagegapsize is used, the more memory
Check applications running on your system to ensure is needed for backup, but less unused data is sent
that volume is not opened by any if the process and to server. The outcome also depends much on how
then retry the operation. data is spread on the volume.

ANS3417W name: A system call func failed ANS3419W Failed to mount the VSS snapshot
with code rc - strerror for integrity check on virtual
machine 'vmname'. Integrity
check is skipped and the Microsoft
Explanation
Exchange Server transaction logs
An error occurred while obtaining information from the are not truncated.
operating system. The volume information could not
be obtained. Explanation
The virtual machine snapshot must be mounted to
System action
verify the integrity of the Microsoft Exchange Server
Processing can continue if the information being database files. The snapshot for the specified virtual
obtained is not critical for the operation or if it is machine was unable to be mounted. As a result, the
expected behaviour in the context of the operation operation did not verify the integrity of the Microsoft
being performed. Exchange Server database files.

286 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS4002E Error processing 'filespace-name':
volume label does not exist
The backup operation continues without an integrity
check and the Microsoft Exchange Server transaction
logs are not truncated. Explanation
The selected drive does not have a label.
User response
To prevent this error, configure a connection from the System action
guest virtual machine to the ESXi host. Then, try the IBM Spectrum Protect is unable to do the requested
operation again. operation without a drive or label entered.
ANS4000E Error processing 'filespace-name':
file space does not exist. User response
If the drive is a floppy drive, place a disk with a volume
Explanation label in it and retry the operation. If the disk is a hard
The specified file space (domain) is incorrect or does drive, ensure the drive has a volume label, and retry
not exist on the workstation. If the message results the operation.
from the BACKUP IMAGE command with the - ANS4003E Error processing 'filespace-name':
MODE=INCREMENTAL option, it means that you have duplicate volume label
entered the name of a raw logical volume. The encountered
MODE=INCREMENTAL option is not valid for raw
logical volumes.
Explanation
System action The selected drive has a duplicate volume label.
Because IBM Spectrum Protect uses the volume label
Processing stops. to keep track of backup/archive information, it cannot
back up or archive files from a drive with a duplicate
User response volume label.
Try the operation again, specifying an existing domain
(drive letter or file system name). If the message System action
resulted from improper use of the IBM Spectrum Protect cannot select the drive.
MODE=INCREMENTAL option, try the command again,
omitting that option.
User response
ANS4001E The file space for domain
If the volume needs to be available to the system, exit
'filespace-name' could not be
IBM Spectrum Protect, and assign a volume label to
found on the IBM Spectrum
the drive. Restart IBM Spectrum Protect and retry the
Protect server.
operation.

Explanation ANS4004E Error processing 'filespace

namepath-namefile-name':
The specified file space was expected to be found on destination file or directory is
the server, but it no longer exists. It is possible that a write locked
command was issued to delete the file space from the
server while the current operation was in progress.
Explanation
System action The file or directory being restored or retrieved from
the server cannot be written to because the
IBM Spectrum Protect processing stops. destination is write locked. Another operation might
have the file open and will not allow it to be updated.
User response
Try the operation again. If the problem recurs, check System action
the error log for any other messages that might File skipped.
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.

Chapter 2. ANS 0000-9999 messages 287

User response Explanation
Either determine which operation has the file write Access to the specified file or directory is denied. You
locked, or restore the file to another name or location. tried to read from or write to a file and you do not have
access permission for either the file or the directory.
ANS4005E Error processing 'filespace
namepath-namefile-name': file not
found System action
Processing stopped.
Explanation
The file being processed for backup, archive or migrate User response
no longer exists on the client. Another process deletes Ensure that you specified the correct file or directory
the file before it can be backed up, archived or name, correct the permissions, or specify a new
migrated by IBM Spectrum Protect. location.
ANS4008E Error processing 'filespace
System action
namepath-namefile-name': file is
File skipped. temporarily unavailable

User response Explanation

None. File is temporarily unavailable.
ANS4006E Error processing 'filespace
namepath-namefile-name': System action
directory path not found File skipped.

Explanation User response

The operating system returned a "path not found" Check and see if file is locked by other process. If not,
status when IBM Spectrum Protect attempted to retry the command.
access the directory. You either have specified a
directory that does not exist, as shown in the message ANS4009E Error processing 'filespace
(path-name), or the directory being processed no namepath-namefile-name': disk
longer exists on the client because another process full condition
deleted it before it could be backed up or archived by
IBM Spectrum Protect. Explanation
No more files can be restored or retrieved because the
System action destination disk is full.
The directory is skipped, processing continues
System action
User response The client prompts you for action:
Recheck all spelling and punctuation, particularly the • Retry this object
placement of directory delimiters (for example, "\").
• Skip this object
Correct the syntax if it is incorrect, then retry the
operation. Ensure that the path is specified correctly • Abort the action
and that the directory actually exists. Retry the
command with the corrected path and directory name. User response
If you cannot correct the directory name, use the
Exclude option to exclude the directory from the Select the appropriate action for this object. Create
operation. some free space on the destination disk before you
retry the operation. Another option is to restore or
ANS4007E Error processing 'filespace retrieve the file to another disk.
namepath-namefile-name': access
to the object is denied ANS4010E Error processing 'filespace
namepath-namefile-name': stale
NFS handle

288 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS4013E Error processing 'filespace
namepath-namefile-name': invalid
An NFS file system becomes stale.
file handle

System action
Explanation
File system skipped.
An internal system error occurred. A file operation
failed because an invalid file handle was passed.
User response
Verify that the NFS file system is mounted. If the System action
problem persists, unmount and remount the file
Processing stopped.
system, then try the operation again.
ANS4011E Error processing 'filespace User response
namepath-namefile-name': no file
handles available Report the problem to your system administrator, and
then retry the operation.
Explanation ANS4014E Error processing 'filespace
namepath-namefile-name':
All file handles for your system are currently in use. No
unknown system error (error-code)
more are available.
encountered. Program ending.
System action
Explanation
Processing stopped.
An unrecognized and unexpected error-code occurred
within the client program. This is a programming
User response failure and the client program ends.
Either free some file handles by ending other
processes, or modify your system setup to allow for System action
more files to be open at the same time.
processing stops.
ANS4012E 'filespace namepath-namefile-
name' already exists. It will be User response
skipped.
Try the operation again. If the problem continues,
report the error to your IBM Spectrum Protect
Explanation
administrator.
The client tried to restore or retrieve the specified file,
ANS4015E Error processing 'filespace
but the file already existed in the target restore
location and the user chose not to replace the existing namepath-namefile-name':
file. unexpected IBM Spectrum Protect
error (error-code) encountered
System action
Explanation
The file is skipped, a message is logged in
dsmerror.log, and restore or retrieve processing An unexpected error occurred. This might be a low-
continues with the next object. level system or communication error that IBM
Spectrum Protect cannot handle or recover from.
User response
System action
The file was skipped because either REPLACE NO was
in effect, causing all existing files and directories to be processing stops.
skipped, or REPLACE PROMPT was in effect, and when
prompted, the user chose to skip this file or all existing User response
directories and files. No additional action is necessary Try the operation again. If the problem continues, look
if the decision to skip the file was deliberate. for other indications of system problems to determine
Otherwise the operation can be retried using either where the problem exists. Most systems have error or
REPLACE ALL REPLACE PROMPT. event logs which may contain additional information.

Chapter 2. ANS 0000-9999 messages 289

See your system administrator or IBM Spectrum ANS4019E Error processing 'filespace
Protect administrator for further help. namepath-namefile-name': file
system is locked by system
ANS4016E Error processing 'filespace
namepath-namefile-name': file is
being executed; write permission Explanation
denied File system cannot be accessed because it is locked by
the system.
Explanation
The current file cannot be opened to write to because System action
it is currently being run by another operation. IBM Spectrum Protect cannot complete the operation.

System action User response

File skipped. See your system administrator.
ANS4020E The data format for object
User response
'filespace namepath-namefile-
Stop the operation that is running the file and retry the name' is unknown. The unknown
operation, or restore or retrieve the file to a different format usually occurs when the
name or directory. file was backed up or archived by
a later version of IBM Spectrum
ANS4017E Error processing 'filespace
Protect.
namepath-namefile-name': too
many symbolic links were
detected while resolving name Explanation
When a file is backed up or archived, IBM Spectrum
Explanation Protect includes some additional information about
the file. This message is issued if IBM Spectrum
While trying to resolve the file name, too many
Protect cannot recognize the information during a
symbolic links were found.
restore or retrieve operation. The most likely cause is
that the file was backed up or archived with a newer
System action version of IBM Spectrum Protect. If the file was
File skipped. 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
User response
otherwise affect processing since the file is skipped.
Ensure that you do not have a looping symbolic link for
the file. System action
ANS4018E Error processing 'filespace The file is not restored or retrieved. Processing
namepath-namefile-name': file continues with the next file.
name too long
User response
Explanation
Try the restore or retrieve operation again with a
The file name specified is too long to be handled by current version of the IBM Spectrum Protect client
IBM Spectrum Protect. software. If the problem persists, contact IBM
technical support for further assistance.
System action
ANS4021E Error processing 'filespace
File is skipped. namepath-namefile-name': file
system not ready
User response
Explanation
See the appropriate Using the Backup-Archive Client
book for the particular operating system, for the file The file system/drive was not ready for access.
names that are handled by IBM Spectrum Protect.

290 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS4025E Error processing 'filespace
namepath-namefile-name': file
Processing stopped.
exceeds user or system file limit

User response
Explanation
Ensure that the drive is available to IBM Spectrum
A file being backed up/restored or archived/retrieved
Protect, and then retry the operation.
exceeds system set limits for this user. Shown below
ANS4022E Error processing 'filespace are the filesize limits corresponding to various
namepath-namefile-name': file platforms.
system is invalid.
AIX
68,589,453,312 (64GB)
Explanation
HP-UX
The drive was not available for access. 1,099,511,627,775 (1TB-1)
Linux
System action 2,147,483,647 (2GB)
processing stops. Mac pre-OS9
2,147,482,624 (2GB-1K)
User response Mac OS9
18,446,744,073,709,551,616 (16EB)
Ensure that the drive is operational, and then try the
operation again. If this is unsuccessful, check the error NetWare
log. 4,294,963,200 (4GB -4KB)

ANS4023E Error processing 'filespace NUMA-Q DYNIX/ptx

namepath-namefile-name': file 4.5 1,095,216,660,480 (1TB-4GB)
input/output error OS/390
4,294,967,295 (4GB)
Explanation SGI
18,446,744,073,709,551,615 (16EB-1)
An error was found while reading from or writing to the
file. Solaris 2.6 or higher
1,099,511,627,775 (1TB-1)
System action Tru64 UNIX
1,099,511,627,776 (1TB)
File skipped.
UnixWare
2,147,483,647 (2GB)
User response
Windows ME (FAT32)
Check your system to ensure that it is operating 4,294,967,295 (4GB)
properly. For OS/2, run CHKDSK /F for the failing drive
which can be found in dsmerror.log. Windows NT/2000 (NTFS)
17,592,185,978,880 (16TB-64K)
ANS4024E Error processing 'filespace
namepath-namefile-name': file System action
write error
File skipped.
Explanation
User response
An error was found while writing to the file.
Ensure that the system limits are set properly.
System action ANS4026W Error processing 'filespace
File skipped. namepath-namefile-name': size of
'file-size' exceeded the maximum
file size limit on your system
User response
Check your system to ensure that it is operating
properly.

Chapter 2. ANS 0000-9999 messages 291

Explanation Explanation
You tried to restore or retrieve a file that has exceeded IBM Spectrum Protect tried to create a directory path,
the maximum file size limitation on your system. but is unable to because a file exists that has the same
name as a directory.
System action
System action
IBM Spectrum Protect cannot restore or retrieve the
file. Processing stopped.

User response User response

Restore or retrieve this file on a system that supports Remove the file that has the same name as the
the file size. See your system administrator. directory. Refer to the last restore/retrieve operation
and check all directories along the path.
ANS4027S Error processing 'filespace
namepath-namefile-name': ANS4030E Error processing 'filespace
internal program message 'value' namepath-namefile-name': disk
encountered space limit for this process
reached
Explanation
Explanation
An unexpected catastrophic program failure occurred,
indicated by value. The disk space allocated for the client owner is full.

System action System action

Processing stopped. Processing stopped.

User response User response

Retry the operation. If the problem continues, see your Free up disk space and retry the restore or retrieve
system administrator or service representative. operation.
ANS4028E Error processing 'filespace ANS4031E Error processing
namepath-namefile-name': cannot 'file_space_namepath_namefile_na
create file/directory entry me'. Name exceeds an internal
IBM Spectrum Protect limit.
Explanation
Explanation
The directory path for files being restored or retrieved
cannot be created. During a file operation, IBM Spectrum Protect
encountered a filename where at least one component
System action of the file name (file_space_name, path_name or
directory_name or file_name) exceeded an internal
File skipped. IBM Spectrum Protect maximum. The internal IBM
Spectrum Protect limits should not be confused with
User response the operating system limits for file_space_name,
path_name or directory_name, file_name.
Ensure that you have the proper authorization to
create the directory for file being restored or retrieved. Shown below are the IBM Spectrum Protect internal
file name limits for various platforms.
ANS4029E Error processing 'filespace
namepath-namefile-name': unable AIX HP-UX Solaris
to build a directory path; a file File_space_name 1024
Path_name or directory_name 1023
exists with the same name as a File_name 256
directory
Linux
File_space_name 1024
Path_name or directory_name 768
File_name 256

Windows XP/2000/2003

292 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 File_space_name 1024 Explanation
Path_name or directory_name 248
File_name 248 An unknown error occurred. This might be a low-level
system or communication error that IBM Spectrum
System action Protect cannot handle or recover from.

The file is skipped. System action

User response Processing stopped.

Reduce the size of the filename so that it is smaller User response

that the IBM Spectrum Protect internal limits.
Retry the operation. If the problem continues,
ANS4032E Error processing 'filespace determine where the problem exists. See your system
namepath-namefile-name': file is administrator for further help.
not compressed.
ANS4035W File 'filespace namepath-namefile-
Explanation name' currently unavailable on
server.
A file that was flagged as compressed was not
compressed, and the system failed. Explanation

System action You tried to restore or retrieve a file that is currently

not available from the IBM Spectrum Protect server.
Processing stopped.
System action
User response
IBM Spectrum Protect Cannot restore or retrieve the
See your system administrator to report this problem. file.
This error is a system failure.
ANS4033E Error processing 'filespace User response
namepath-namefile-name': file Try to restore or retrieve after the file was made
compressed on a different client available on the server. See your system administrator.
machine that has more memory
ANS4036E An error occurred saving the
Explanation registry key.

You are trying to restore a file that was backed up and Explanation
compressed on another client workstation that had
more memory than your client workstation. You The active registry key cannot be copied to the
cannot restore this file. When the file is restored, it is ADSM.SYS staging directory.
expanded and your workstation does not have enough
memory. System action
Registry backup operation terminates.
System action
IBM Spectrum Protect canceled the operation. User response
Check the space available on the Windows boot
User response partition to ensure there enough space to contain a
Obtain a machine with more memory and retry the copy of the Windows registry. This might require
operation. several megabytes of free space. Also check the
Windows permissions on the ADSM.SYS staging
ANS4034E Error processing 'filespace directory and ensure that the Windows user under
namepath-namefile-name': which you are running IBM Spectrum Protect has full
unknown system error access to that directory and its contents.
ANS4037E Object 'file-namefile-namefile-
name' changed during processing.
Object skipped.

Chapter 2. ANS 0000-9999 messages 293

Explanation please issue the following command on the IBM
Spectrum Protect Server: audit volume
The specified file-name was skipped during backup,
<volume_name> fix=no If there is any problem
archive, or migrate because it was changing during the
reported, you could move the data from that volume to
attempt to process it.
a new one (see command MOVE DATA) and try again
the restore. 2) There are communications problems
System action between the IBM Spectrum Protect Server and the
IBM Spectrum Protect skipped the object. IBM Spectrum Protect 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
User response
the card driver (AIX platform) or add provided by SUN
If you want the file backed up, archived, or migrated, suggested changes to some system network options
retry the operation. If it fails, determine why the object which have resolved this problem (SUN platform). 3)
is being changed. For more information on backing up, Please verify with your network support if during the
archiving, or migrating changing objects, see your restore there are no any problems between the IBM
system administrator. Spectrum Protect Client/Server that is originating the
file corruption.
ANS4038E An error occurred processing file
system 'filespace name'. ANS4040E Error processing 'filespace
namepath-namefile-name': file
Explanation system filespace name has
exceeded its space management
File system 'filespace name' is corrupted or contains quota.
one or more corrupted directories and cannot be
processed.
Explanation

System action IBM Spectrum Protect detects that the file system has
exceeded its quota. No more data can be migrated out
File system is skipped. of this file system.

User response System action

Check your system to ensure that it is operating IBM Spectrum Protect will not migrate files from this
properly. For the Windows environment, run CHKDSK file system.
utility for the failing drive. More information about
corrupted directories can be found in dsmerror.log.
User response
ANS4039E Error processing 'filespace Recall some files, or ask the system administrator to
namepath-namefile-name': increase the quota for this file system.
compressed file is corrupted and
cannot be expanded. ANS4041E A Windows Server 2008 or 2008
R2 VMware guest cannot be
Explanation restored with a non-Windows data
mover.
The compressed file cannot be expanded correctly due
to one of the following reasons:
Explanation
There is a problem on the tape.
A Windows data mover must run certain commands to
There is a communications problem. complete the restore of the Active Directory. Non-
The compressed file was corrupted on the IBM Windows data movers do not have the necessary tools
Spectrum Protect Server. to complete this operation. Windows VMware guests
that are at Windows Server 2012 or higher are not
System action affected by this restriction.
File skipped.
System action
User response Processing stops.
1) The compressed file is corrupted because there is a
problem on the tape. To know if this is the problem,

294 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Use a Windows data mover to complete this action. Rename the file in question to a unique name.
ANS4042E Object name 'filespace namepath- ANS4046E There is an error processing
namefile-name' contains one or 'filespace-namepath-namefile-
more unrecognized characters and name': the object is corrupted and
is not valid. unreadable.

Explanation Explanation
The file name, directory name, or volume label syntax You tried to read from or write to a file or directory that
is incorrect. is corrupted. The corrupted file is skipped. If this is a
directory, the objects contained in the directory and its
System action subdirectories are skipped.

The file is skipped.

System action

User response This object will be skipped.

Check the disk for errors.

User response
ANS4044E Error processing 'filespace- Check your system to ensure that the filespace is not
namepath-namefile-name': Case- corrupted by using system tools like chkdsk
sensitive name conflict exists. (Windows) or fsck (UNIX).

Explanation ANS4047E There is a read error on 'file-

namefile-namefile-name'. The file
While processing the specified file on the workstation, is skipped.
another file name was encountered with a similar
name which only differed in case. The Backup-Archive
Explanation
client does not allow names which differ only in case
on this platform and cannot guarantee the integrity of The specified file-name was skipped during backup
the file, so the file is skipped. archive because the file could not be read.
If you are performing a JFS2 snapshot based
System action operation, it is possible that the snapshot was not
This object will be skipped. 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
User response
preventing IBM Spectrum Protect client from reading
Rename the file in question to a unique name. the snapshot.
ANS4045E Error processing 'filespace-
namepath-namefile-name': Case- System action
sensitive name conflict exists. The IBM Spectrum Protect skipped the file.
directory tree will be skipped.
User response
Explanation
Check your system to ensure that it is operating
While processing the specified file on the workstation, properly.
another object name was encountered with a similar
name which only differed in case. The Backup-Archive If you are performing a JFS2 snapshot based
client does not allow names which differ only in case operation, please use the default snapshotcachesize
on this platform and cannot guarantee the integrity of of 100% and ensure that the volume group has
the file, so the directory and all of the objects sufficient disk space to allocate snapshots at least as
contained within it are skipped. large as the file system and retry the operation.
ANS4048W LAN-Free connection failed.
System action
This object will be skipped.

Chapter 2. ANS 0000-9999 messages 295

Explanation User response
ENABLELANFREE option is set to YES for this session, None required.
but an attempt to establish LAN-Free connection
ANS4051E Error processing 'filespace
failed.
namepath-namefile-name': The
decryption option is in effect, but
System action the user ID under which back-up
The IBM Spectrum Protect client will failover to non or archive is being run is not
LAN-Free support. authorized to decrypt this
encrypted-file-system (EFS) file.
User response
Explanation
Review the IBM Spectrum Protect error.log for LAN-
Free failures. Check your LAN-Free setup and verify The file being processed is encrypted by an encrypted
that all components are working properly. file system (EFS). The option is specified to back-up or
archive the file in decrypted form. The user ID under
ANS4049I Established LAN-Free connection. which the back-up or archive is being run does not
have decryption rights for this file.
Explanation
ENABLELANFREE option is set to YES for this session System action
and the IBM Spectrum Protect client successfully The file is skipped.
established LAN-Free connection with server, after the
LAN-Free connection was broken.
User response

System action There are three possible ways to make decryption

work:
The IBM Spectrum Protect client will communicate
with the server via LAN-Free. • Re-encrypt the file under the encryption key of a
group to which both the owner and the back-up/
archive user IDs belong
User response
• Add the back-up/archive user ID to the list of users
Review the IBM Spectrum Protect error.log for LAN- authorized to decrypt this file
Free errors. Check your LAN-Free setup and verify that
all components are working properly. • Run the back-up or archive under the owner's user
ID, if possible
ANS4050W Scheduled action 'schedule-action'
did not execute for schedule ANS4052E Error processing 'filespace
'schedule-name' as the IBM namepath-namefile-name':
Spectrum Protect administrator Encrypted-file-system (EFS) file
has been disabled from executing cannot be restored, because file
the scheduled action on the client. system does not support restore
from the raw-EFS back-up data, or
possibly because the restore
Explanation
function does not have write
One or more of the client options - schedcmddisabled, access to the directory.
srvprepostscheddisabled, srvprepostsnapdisabled,
restretrscheddisabled, have been set to YES on the Explanation
client thereby preventing the IBM Spectrum Protect
administrator from executing one of the following The file being processed is encrypted by an encrypted
scheduled actions on the client - preschedule, file system (EFS). The file was backed up in the raw
postschedule, presnapshot, postsnapshot or encrypted format. Either the target filesystem does not
scheduled operating system commands, restore or support the encrypted format, or restore does not
retrieve operations. have write access to the directory to which the file is to
be restored.
System action
System action
The scheduled operation will not be executed and a
message will be logged to IBM Spectrum Protect The restore is terminated.
Server indicating this.

296 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
• The file cannot be restored to this location if the file There are three situations in which this problem can
system is not the AIX Enhanced Journaled File occur:
System (JFS2)
• You just performed initial activation of EFS on the
• If the file is JFS2 but EFS is not enabled, then EFS AIX system, and have not logged out. AIX does load
must be enabled before the file can be restored the keys for the session running at the time of initial
• If the user ID under which restore is being run does activation. Solution: Logout and login again.
not have write permission for the directory, the • The login password has been changed recently, and
permissions must be changed or the restore must be you normally run with the EFS password the same as
run under a different user ID the login password. AIX does not automatically
change the EFS password when you change the login
ANS4053E Error processing 'filespace path
password. Solution: Issue 'efskeymgr -n' to set the
filename': The file cannot be
EFS password to be the same as the login password.
restored because the file system
or operating system does not • You need to run the decrypting backup when the EFS
support the Encrypting File password is different from the login password.
System (EFS) data. Solution: Issue 'efskeymgr -o ksh' to launch a new
shell with the keys loaded. AIX will prompt you for
Explanation the EFS password as you launch the shell. Run the
backup from the new shell.
The specified object was backed-up as raw Encrypting
File System (EFS) data. The client is trying to restore or ANS4055E Cannot update file space
retrieve the object to a destination that does not 'filespace-name': the file space
support the EFS data. The location might not support version on the IBM Spectrum
the EFS data for one of the following reasons: Protect server is not compatible
with this client
• The operating system does not provide the support,
or is a release that does not include the support
Explanation
• EFS support has not been activated on the operating
system The file space on the IBM Spectrum Protect server is
not compatible with this client. This is caused by
• The target file system does not support the EFS data performing a backup or archive operation with a client
and then using a down-level client and attempting a
System action backup or archive operation targeting the same file
The object is not restored or retrieved. Processing space.
continues with the next object. 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
User response operation is attempted with a client V5.5 or lower.
If this file must be restored, restore it to an AIX
operating system environment supporting EFS data. System action
ANS4054E Error processing 'filespace Processing stops.
namepath-namefile-name': The
encryption key is not loaded. User response
Use the correct level of the client.
Explanation
ANS4056E Object 'object-name' returned by
The file being processed is encrypted by an encrypted
file system (EFS). The option is specified to backup or the IBM Spectrum Protect server
archive the file in decrypted form. The encryption key, has a high-level name that
required to decrypt the file, is not loaded in the kernel exceeds the maximum length of
keyring. 6000 characters. The file or
directory cannot be processed.
System action
Explanation
The file is skipped.
The IBM Spectrum Protect server returned information
about a backup or archive version with a high level

Chapter 2. ANS 0000-9999 messages 297

name that exceeds 6000 characters. The high-level replication failover values to the
name is the directory path that contains the object (file options file.
or directory).
This message is displayed when all of the following Explanation
conditions are true: A write failure is often a result of insufficient access
• The object was backed up or archived by a version permissions to the options file, but could also be
6.1 or lower IBM Spectrum Protect client. caused by the lack of available disk space. The
replication server connection information can not be
• The object was backed up or archived to a version saved and failover will not be possible.
5.5 or lower IBM Spectrum Protect server.
• IBM Spectrum Protect client version 6.2 or higher is System action
attempting to perform an operation that causes the
IBM Spectrum Protect server to return information The operation failed.
about this object to the client. Note: During
incremental backup, the server returns information User response
to the client about active backup versions which is
Check the local disk for possible causes of the write
used to determine which files have changed.
error, and check to see that sufficient access to the
Beginning with IBM Spectrum Protect server version options file is configured.
6.1, the maximum high level name length was reduced
from 8192 characters to 6000 characters. Objects ANS4059I The option
with high level names that exceed 6000 characters are USEREPLICATIONFailover is set to
not supported for backup or archive. Beginning with NO. The node will not fail over to
IBM Spectrum Protect backup-archive client version the secondary server
6.2, the maximum high level name length was similarly
reduced. Explanation
This option will prevent the node from connecting to
System action the replication server in the event of a failure of the
The file or directory specified in the message is primary server.
skipped. Processing will continue with the next object.
System action
User response The client will not connect to the primary server and
Contact your IBM Spectrum Protect server processing stops.
administrator for further assistance.
User response
ANS4057W Unable to process object 'fs' with
nested file system mounted on it No response is required.
during snapshot based backup. ANS4061I Connected to secondary server
secondary server; in fail over
Explanation mode. Home server is: home
Snapshot based backup of objects with mounted file server;
systems on them are not supported.
Explanation
System action The node is configured for replication and has
The backup operation continues without specified successfully connected to the secondary server. This
object. message is to notify the server administrator that a
node has connected to the secondary server in fail
over mode.
User response
To prevent this behaviour unmount file system from System action
specified object and retry the operation.
Processing continues.
ANS4058I A write failure occurred while
attempting to save node User response
None.

298 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS4063W IBM Spectrum Protect application Explanation
protection cannot copy the The operation requires that a proxy access for the data
application metafile 'App- center node is granted to the data mover node.
Metadata-File-Name' from the
following VM: 'VM-Name'.
Individual database restore from System action
this backup is not supported. Operation is canceled for the specified vApp.
Check health of application
writers and databases User response

Explanation Run configuration wizard or configuration editor to

configure proper nodes relashionship.
The application metafile was not found on the guest
machine. ANS4066I Snapshot operation attempt x of y
for the guest virtual machine 'VM'
failed using "sType" snapshot.
System action
Reattempting snapshot with
The operation completes. However, the application "sType2" snapshot.
metafile was not copied.
Explanation
User response
The snapshot operation has failed. A snapshot retry
Make sure that the application VSS writers are running operation has been scheduled.
on this guest machine, and the application database is
in the state to allow the backup. For Exchange check System action
that databases are mounted. For SQL check databases
are online. Then try the operation again. Retrying snapshot.

ANS4064I Restoring vCloud Director vApp User response

'vapp name' from Organization
VDC 'org vdc name' from Check the error log for any other messages that might
organization 'org name' indicate a reason for the failure. Correct any problems
Target vApp name is 'restored vapp and try the operation again.
name'
ANS4067E Snapshot operation attempt x of y
Restore VAPP command started.
for the guest virtual machine 'VM'
Total number of vApps to process:
failed using "sType" snapshot.
vapps num to restore
Backup failed.

Explanation
Explanation
The restore vApp operation completed.
All snapshot retry attempts of the guest virtual
machine failed.
System action
This message is for informational purposes only. System action
Processing stops.
User response
No action is required. User response
ANS4065E Proxy rejected: data mover node Check the error log for any messages that indicate a
'dm node' has not been granted reason for the failure. Correct any problems and try the
proxy authority for target node operation again. If the problem persists, search the
'target_node', associated with IBM Spectrum Protect Support web site (http://
Organization vDC 'OVDC name' of www.ibm.com/software/sysmgmt/products/support/
Organization 'Org Name'. IBMTivoliStorageManager.html) for known solutions.
ANS4068I Restored virtual machine 'VM' was
backed up using a "VMware Tools
with file system quiescing and

Chapter 2. ANS 0000-9999 messages 299

 application quiescing disabled" User response
snapshot.
Use dsmc SET PASSWORD -type=DOMAIN 'domain
This is equivalent to a "crash-
\userid' 'password' to update the username and
consistent" backup.
password. And then retry the operation.

Explanation ANS4071E 'VM-Name' cannot be restored

because it was backed up with a
The restored virtual machine was backed up using a newer version of the client.
"VMware Tools with file system quiescing and
application quiescing disabled" snapshot. Application
Explanation
Protection feature is not available.
The client version that attempted to restore the virtual
System action machine is earlier than the client version that backed
up the virtual machine. The virtual machine cannot be
Restore of the VM continues. restored with an earlier client version.

User response System action

None The virtual machine is not restored. Processing
ANS4069E The Windows domain credentials continues with the next virtual machine.
cannot be found. Use the Data
Protection for VMware vSphere User response
GUI configuration editor to set the
Upgrade the client to a version that is compatible with
Windows domain credentials.
the client version that backed up the virtual machine.

Explanation ANS4072E Error processing 'filespace

namepath-namefile-name': unable
The required Windows domain administrator to create symbolic link; a file or
credentials were not set. directory exists with the same
name as the symbolic link
System action
Processing stops. Explanation
IBM Spectrum Protect tried to create a symbolic link,
User response but is unable to because a file or directory exists that
has the same name as the symbolic link.
Set the Windows domain administrator credentials in
the Data Protection for VMware vSphere GUI
configuration editor. System action

ANS4070E Windows domain credentials are Processing stops.

incorrect. Verify the credentials
and use dsmc SET PASSWORD - User response
type=DOMAIN 'domain\userid'
Remove the file or the directory that has the same
'password' to update the
name as the symbolic link. Refer to the last restore/
username and password.
retrieve operation.

Explanation ANS4073W Snapshot operation attempt x of y

for the guest virtual machine 'VM'
The supplied credentials are incorrect. The system failed using "sType" snapshot.
failed to authenticate to the Windows domain using Reattempting snapshot with
these credentials. "sType2" snapshot.

System action Explanation

Processing stops The snapshot operation has failed. A snapshot retry
operation with different snapshot type has been
scheduled.

300 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Retrying snapshot with different snapshot type. The file content.spsig is missing. Or the file is damaged
or the signature of the file does not match. See client
User response log file for more information.

Check the error log for any other messages that might
System action
indicate a reason for the failure. Correct any problems
and try the operation again. Processing stops.
ANS4077E File 'filespace namepath-namefile-
name' is encrypted by Microsoft User response
EFS and contains at least one Make sure that the data in the Operations Center, such
sparse data stream. The operating as the client package or Update Manager package, is
system does not support restore correct or download the correct version in the
for this file so it is not backed up Operations Center.
or restored.
ANS4079E One or more files failed the
signature check.
Explanation
An error in the Microsoft Windows API prevents Explanation
successful restore of files that meet the following
conditions: The signature of one or more files does not match the
contents of content.spsig. See the client log file for
• The file is encrypted by Microsoft Encrypting File more information.
System (EFS) at the time it was backed up
• The file includes at least one data stream (alternate System action
"named" stream or unnamed stream) that is sparse
Processing stops.
• The operating system is any edition of Microsoft XP,
Microsoft Windows Server 2003, or Microsoft
User response
Windows Server 2003 R2
Make sure that the data in the Operations Center, such
Because the file cannot be restored, IBM Spectrum
as the client package or Update Manager package, is
Protect does not back it up. The problem is
correct or download the correct version in the
documented by Microsoft at http://
Operations Center.
support.microsoft.com/kb/2525290.
ANS4081E Error processing 'filespace-name':
System action file space type is not supported.
The file is not backed up or restored. Processing
continues with the next object or ends if there are no Explanation
further objects. The specified file space type is not currently supported
by IBM Spectrum Protect on this platform.
User response
If this message is issued during a backup operation, System action
you can do the following: The unsupported file system is skipped. Processing
• Disable EFS encryption for the file so that it can be continues with the next file system.
backed up.
• If a backup copy of the file is not necessary, you can User response
exclude it from backup. Refer to the documentation for information on what
file space types are supported.
ANS4078E Content file content.spsig is
missing, is damaged or failed the ANS4083I New node password has been
signature check. generated.

Chapter 2. ANS 0000-9999 messages 301

Explanation System action
The client logged in using administrative id rather than Processing continues.
node name. New random node password has been
generated and recorded. User response
Retry the operation. If the problem persists, contact
System action
IBM Spectrum Protect technical support.
Processing continues.
ANS4087E An attempt to load data for the
wizard failed.
User response For more information, please see
None. the log file.

ANS4084E Error processing 'filespace-

Explanation
namepath-namefile-name': cannot
get file status. An attempt to load data for the wizard failed as the
remote agent is probably unavailable.
Explanation
System action
While processing the file, the lstat() call set
EOVERFLOW error code. Processing stopped.

System action User response

This file will be skipped. Check the log for reason for the failure.
ANS4089W File server file-server-name has
User response been upgraded to Data ONTAP
The file is skipped. Processing continues with the next version
file. 'version.modifcation.submodificati
on'. Perform a full incremental
ANS4085I Assigned 'number' objects from backup by specifying option
previous systemstate backup to createnewbase=migrate as soon
the new systemstate backup. as possible.

Explanation Explanation
Objects in the previous System State backup have not The file server has been upgraded to a version that
changed and were assigned to the new System State supports unicode file names for incremental backup
backup. using snapshot difference. Perform a full incremental
in order to backup any files with unicode names that
System action may have been skipped by the previous version of the
IBM Spectrum Protect client.
Processing continues.

System action
User response
Processing continues.
None.
ANS4086W Failed to assign unchanged objects User response
from previous systemstate backup
to the new systemstate backup. Perform a full incremental by specifying the command
Objects will be backed up. line option createnewbase=migrate with the snapdiff
option as soon as possible.
Explanation ANS4090I File server file-server-name has
been upgraded to Data ONTAP
Objects in the previous System State backup have not
version
changed and should be assigned to the new
'version.modifcation.submodificati
systemstate backup. Due to error assign operation
on'. Perform a full incremental
failed and objects will be backed up.
backup by specifying option

302 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 createnewbase=migrate as soon IBM technical support for additional assistance. Your
as possible. IBM Spectrum Protect administrator can help you
configure the trace.
Explanation ANS4137E Error processing 'filespace
The file server has been upgraded to a version that namepath-namefile-name':
supports unicode file names for incremental backup exceeded maximum number of
using snapshot difference. Perform a full incremental links allowed
in order to backup any files with unicode names that
may have been skipped by the previous version of the Explanation
IBM Spectrum Protect client.
Link cannot be restored or retrieved because the
destination file system has exceeded maximum
System action number of links allowed.
Processing continues.
System action
User response The client prompts you for action:
Perform a full incremental backup by specifying the • Skip this object
command line option createnewbase=migrate with the
snapdiff option as soon as possible. • Abort the action

ANS4092E Data mover platform is not User response

supported for instant access/
restore operations. Select the appropriate action for this object. Restore or
retrieve the link to another file system.
Explanation ANS4148E Full VM backup of Virtual Machine
The instant access/restore operation failed. 'vmname' failed with RC rc

System action Explanation

The instant access/restore operation failed. The The Full VM backup of virtual machine failed.
reason for the failure is unsupported platform.
System action
User response The full backup of the virtual machine finished with
The instant access/restore operation should be failures. The next virtual machine in the vmlist will be
performed from a supported data mover platform. processed. The reason for the failure is written to the
local client error log.
ANS4099E The system volume cannot be
identified. Therefore the system User response
state cannot be backed up.
Check the local client error log for reason for the
failure.
Explanation
The system volume contains the hardware-specific ANS4150E Incremental backup of Virtual
system state files that are needed to start Windows, Machine 'vmname' failed with RC
such as Ntldr, Boot.ini, Ntdetect.com or Bootmgr. If rc
the system volume cannot be identified, then these
files cannot be backed up. Therefore it is not possible Explanation
to back up the system state.
The incremental backup of virtual machine volumes
failed.
System action
Systemstate backup stops. System action
The backup of the virtual machine finished with
User response failures. The next virtual machine in the vmlist will be
Try the operation again. If the problem persists, obtain processed. The reason for the failure is written to the
a service trace that captures the problem and contact local client error log.

Chapter 2. ANS 0000-9999 messages 303

User response ANS4154E Possible cause Virtual Machine is
not running and does not have a
Check the local client error log for reason for the
static IP address.
failure.
ANS4151E Failure mounting Virtual Machine Explanation
'vmname'. RC=rc
The backup of virtual machine failed.
Explanation
System action
The VMware failed to mount virtual machine disk.
The backup of the virtual machine finished with
failures. The next virtual machine in the vmlist will be
System action
processed. The reason for the failure is written to the
The backup of the virtual machine can not continue. local client error log.
The next virtual machine in the vmlist will be
processed. Refer to dsmerror.log for detailed error User response
message for the reason for the failure.
Check the local client error log for reason for the
failure.
User response
ANS4155E The virtual machine 'vmname' was
Refer to dsmerror.log for detailed error message.
not found on the vSphere server.
ANS4152E Failure initializing VMware virtual
machine environment. RC=rc. Explanation
Refer to IBM Spectrum Protect
error log for detailed error The backup of the virtual machine failed because the
messages. specified virtual machine name was not found. It is
possible that the virtual machine name was entered
incorrectly or contains unsupported characters. Only
Explanation
virtual machine names that contain 7-bit ASCII
Failure initializing VMware virtual machine characters are supported, and the operation will fail if
environment. Refer to IBM Spectrum Protect error log the name contains other characters.
for detailed error messages.
System action
System action
The backup of the virtual machine failed. The next
The backup can not continue. virtual machine in the vmlist will be processed. Check
the client error log for additional error messages.
User response
User response
Refer to IBM Spectrum Protect error log for detailed
messages. Check the local client error log for reason for the
failure.
ANS4153E Hostname could not be found for
Virtual Machine 'vmname' • If the virtual machine name was entered incorrectly,
try the operation again with the correct machine
Explanation name.
• If the virtual machine name contains characters
The backup of virtual machine failed.
other than 7-bit ASCII characters, either change the
virtual machine name so it contains only 7-bit ASCII
System action characters, or do not include the virtual machine for
The backup of the virtual machine finished with backup operations.
failures. The next virtual machine in the vmlist will be ANS4156E File level VM backup of virtual
processed. The reason for the failure is written to the machine 'vmname' not supported.
local client error log. File level VM backup not support
on non Windows platform guest
User response OS. Platform type: 'platform'.
Check the local client error log for reason for the
failure.

304 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation same backup operation. Backup of
virtual machine 'vmfullname' can
The backup of virtual machine failed.
not continue without a unique
object name.
System action
The backup of the virtual machine finished with Explanation
failures. The next virtual machine in the vmlist will be
The backup of virtual machine failed.
processed. The reason for the failure is written to the
local client error log.
System action
User response The backup of the virtual machine finished with
failures. The next virtual machine in the vmlist will be
Back up the virtual machine using the
processed. The reason for the failure is written to the
VMBACKUPType=FULLvm option.
local client error log.
ANS4159E Backup of Virtual Machine
'vmname' failed. rc=rc. User response
Choose a unique name for the virtual machine.
Explanation
ANS4162E The virtual machine 'virtual-
The backup of virtual machine failed.
machine-name' has not been
previously backed up.
System action
The backup of the virtual machine finished with Explanation
failures. The next virtual machine in the vmlist will be
The specified virtual machine has not been previously
processed. The reason for the failure is written to the
backed up, so can not be specified for restore.
local client error log.

System action
User response
The specified virtual machine is skipped, and the next
Check the local client error log for reason for the
virtual machine in the restore list is processed.
failure.
ANS4160E Proxy Rejected: Proxy authority User response
has not been granted to Agent
Node: 'agent_node' for Target Verify the virtual machine name to be restored, and re-
Node: 'target_node'. try the operation.
ANS4164W Compression is currently enabled,
Explanation but the virtual machine backup for
'virtual-machine-name' is not
The backup of virtual machine failed.
compressed because client-side
deduplication is not being used.
System action
The backup of the virtual machine finished with Explanation
failures. The next virtual machine in the vmlist will be
Compression can only be used with virtual machine
processed. The reason for the failure is the node has
CTL and Data files when the files are stored in a
not been granted proxy authority to access the node
storage pool that is enabled for client-side
named by the backup proxy node. The IBM Spectrum
deduplication. This message is issued when the client
Protect administrator must first grant proxy authority.
is configured for compression and virtual machine CTL
or Data files are directed to a storage pool that is not
User response enabled for client-side deduplication.
The IBM Spectrum Protect server administrator must
grant proxy authority for this node. See the System action
administrator command "Grant Proxynode".
Backup continues, and data is not compressed.
ANS4161E Duplicate virtual machine name
'vmname' was detected in the

Chapter 2. ANS 0000-9999 messages 305

User response ANS4167E Creating a Virtual Machine, but the
datastore 'virtual-machine-name'
If you intend to compress virtual machine CTL and
was not found.
Data files, then update your IBM Spectrum Protect
configuration so that both types of files are directed to
storage pools that are enabled for client-side Explanation
deduplication. If you intend to compress virtual The Virtual Machine being creating must have a valid
machine Data files but not CTL files, then update your datastore to be created.
IBM Spectrum Protect configuration so that the Data
files are directed to a storage pool that is enabled for
System action
client-side deduplication. Set the
VMSKIPCTLCOMPRESSION to YES in your client Check the virtual machine datastore specified for
options file. If you do not intend to use compression, correctness.
then set COMPRESSION NO in your client options file.
ANS4165E Creating a Virtual Machine, but the User response
hostname 'virtual-machine-name' Correct the virtual machine datastore specified and
was not found. retry the restore.
ANS4168E VMware has reported an error via
Explanation
their SOAP interface. On the
The Virtual Machine being creating must have a valid Detailed Status Report panel, view
hostname to be created. the last error message reported.
Also check the error log for more
System action information about the problem
that occurred.
Check the virtual machine hostname specified for
correctness.
Explanation
User response The command to VMware failed to complete. The error
returned is displayed on the Restore or Backup
Correct the virtual machine hostname specified and summary panel under the Last Error Message section.
retry the restore.
ANS4166E Creating a Virtual Machine, but the System action
datacenter 'virtual-machine-name'
An error occurred, and the operation failed.
was not found. The name may be
incorrect or may be located in a
VMware folder and require the User response
folder name such as vmfolder/ Check the reported error and correct the problem.
dcname. Usually the reason for the error is a user-supplied
value which is not valid for the operation.
Explanation
ANS4169E A write failure occurred on the
The Virtual Machine being created must have a valid local disk proxy used to
datacenter to be created. temporarily store the virtual
machine virtual disk information.
System action The write failure can be caused by
the lack of available disk space on
Processing stops. the drive used to store this
information. The VMBACKDIR
User response option can be used to assign a
Check the virtual machine datacenter specified for different disk location for this
correctness. If the datacenter is contained in a folder purpose. Check the drive being
then the full datacenter name, complete with the used and ensure that there is
folder path, must be specified, such as vmfolder/ enough space available for this
dcname. operation.

306 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
There was a write error from the local disk used to The full backup of the virtual machine finished with
store the virtual machine virtual disk information. failures. The next virtual machine in the vmlist will be
Usually the write error is due to lack of disk space, lack processed. The reason for the failure is written to the
of write permissions, or some similar problem with the local client error log.
local disk. The VMBACKDIR option can be used to
assign a different disk location if the local drive does User response
not have enough free space for the operation.
Check the local client error log for reason for the
failure.
System action
ANS4177E Full restore of VMware virtual
A disk write error occurred, and the operation failed.
machine 'vmname' failed with
RC=rc, mode='restore_or_revert',
User response target node
Check the local disk for possible causes of the write name='target_node_name', data
error, and use the VMBACKDIR option to assign mover node
another disk if needed. name='data_mover_node_name'

ANS4170E Can not create a Virtual Machine

Explanation
on VMware release 'release-
version-target' which was backed The full restore of the virtual machine failed.
up from VMware release 'release-
version-source'. System action
The full restore of the virtual machine finished with
Explanation
failures. The next virtual machine in the vmlist will be
The Virtual Machine being created was backed up from processed. The reason for the failure is written to the
a version of VMware which is not compatible with the local client error log.
target VMware release version being used for the
restore. User response
Check the local client error log for reason for the
System action
failure.
Processing stops.
ANS4179I IBM Spectrum Protect application
protection did not truncate the
User response Microsoft SQL Server logs on VM
Restore the Virtual Machine to a VMware system which 'VM'.
is compatible with the level from which the Virtual
Machine was backed up. Explanation
ANS4174E Full VM backup of VMware Virtual The SQL server logs were not truncated because the
Machine 'vmname' failed with following option was specified for this virtual machine:
RC=rc mode=full_or_incr, target INCLUDE.VMTSMVSS vname OPTIONS=KEEPSQLLOG
node name='target_node_name',
data mover node System action
name='data_mover_node_name'
The operation completes.
Explanation
User response
The Full VM backup of virtual machine failed. If the
virtual machine (VM) name contains the word Remove the OPTIONS=KEEPSQLLOG option to enable
AGGREGATE, the statistics that are shown represent truncation of the SQL logs when a backup completes.
the total value of all VM guests that are backed up per ANS4187W CPU and Memory Resource
data mover. Allocation configuration settings
cannot be restored when the IBM
Spectrum Protect data mover
node is connected directly to a

Chapter 2. ANS 0000-9999 messages 307

 Virtual Center managed ESX/ESXi Explanation
host. These settings have been
The operation requires that a proxy access for the data
skipped.
center node is granted to the data mover node.

Explanation
System action
The VMware vStorage APIs do not support the restore
Operation is canceled for the specified vApp.
of CPU and Memory Resource Allocation configuration
settings when connected directly to an ESX/ESXi host
that is managed by a Virtual Center. User response
Look for errors in error log and correct any problems.
System action Run configuration wizard or configuration editor to
ensure proper nodes configuration.
CPU and Memory Resource Allocation configuration
settings are skipped. Processing continues. ANS4194E Encryption is currently enabled,
but is not supported for
User response incremental forever backups of
virtual machines (-MODE=IFFULL
Virtual machine CPU and Memory Resource Allocation or -MODE=IFINCREMENTAL) .
configuration settings will be restored when the IBM
Spectrum Protect data mover node connects directly
Explanation
to a vCenter Server. Modify the VMCHOST to connect
the IBM Spectrum Protect data mover to a vCenter Client encryption of virtual machine incremental
Server. forever backups (-mode=IFFULL or -
mode=IFINCREMENTAL) is not supported. In order to
ANS4191E Restore VM operation failed using
avoid the unintentional storage of unencrypted data on
'san' transport mode. In some
the server, the backup operation stops.
cases switching from SAN to
network-based VM restores can be
successful. System action
The virtual machine backup stops.
Explanation
Restore VM operations that fail using SAN transport User response
mode can often be successful over a LAN path. If a Remove the encryption options for this operation and
restore vm operation fails using the 'SAN' transport run it again. You can use Secure Sockets Layer (SSL)
mode, set the client option VMVSTORTRANSPORT to encryption to encrypt the data over the network. If the
"nbd:nbdssl" and try the restore vm operation again. backup data must be encrypted in IBM Spectrum
Protect storage pools, use an alternative backup
System action method such as full and incremental backups (-
mode=FULL and -mode=INCREMENTAL), or in-guest
Restore VM operation failed using 'san' transport
backups.
mode. Restore may be successful using 'nbd:nbdssl'
transport modes. ANS4195E The target node for Organization
VDC 'OrgVDC name' in
User response Organization 'Org name' was not
found. As a result, vApp 'vApp
Restore VM operation failed using 'san' transport name' cannot be backed up.
mode. In some cases network-based VM restores can
be successful when using 'nbd' or 'nbdssl' transport
modes. The VMVSTORTRANSPORT option can used to Explanation
restrict the IBM Spectrum Protect client to use only Either the IBM Spectrum Protect node for the specified
the specified transport modes. organization VDC was not found on the IBM Spectrum
Protect server, or information about the Organization
ANS4193E vApp 'vApp name' cannot be
VDC node was not found in the Provider VDC node.
processed because data mover
'dm node' cannot connect to the
target node 'target_node'. System action
Back up of the specified vApp stops. Processing
continues to the next vApp.

308 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Go to the Configuration page and click 'Run the Reduce the data usage of the datastore or increase the
Configuration Wizard' to verify that all required IBM threshold in the VMDATASTORETHRESHOLD option.
Spectrum Protect nodes are registered on the IBM Then, back up the virtual machine again.
Spectrum Protect server. If required, register a new
ANS4202E The Deployment Manager failed to
data mover node. Make sure that the organization VDC
install language pack: language
belongs to the provider VDC that this data mover node
pack name. The Microsoft Installer
protects.
error code was error code.
ANS4199W File 'file name' is not backed up as
part of the system state because Explanation
cluster disk 'volume name' is not
accessible. The previous language pack has been uninstalled, and
the installation of the new language pack failed.
Explanation
System action
The indicated file or directory was returned by VSS as
part of the backup file list of the writer. However, the Processing continues.
cluster disk where the file is located is not accessible.
The reasons for this problem can be that the cluster User response
disk is offline or belongs to another node.
For more information about Windows installer error
messages, go to the Microsoft Developer Network
System action (MSDN) technical library at http://
The file is not backed up. Processing continues. msdn.microsoft.com/en-us/library and search on
"Windows Installer Error Messages".
User response Check the install log on the client computer.
This problem is documented in Microsoft knowledge ANS4204E The Operating System of the client
base topic 980794 http://support.microsoft.com/ computer: 'os name' is not
default.aspx?scid=kb;EN-US;980794. The topic supported by the target version:
includes a hotfix. With the hotfix, you can specify a 'target version'
registry key that contains a list of one or more files to
be excluded from VSS enumeration. IBM Spectrum Explanation
Protect does not back up files that are not enumerated
by VSS. If the volume is brought online to the node The operating system level of the client computer is no
performing the system state backup, then it cannot be longer supported by the target level.
backed up. You must remove the volume from the
registry key and restart the system before you can System action
back up the volume.
If you do not want to implement the hotfix for this Processing stops.
problem, IBM Spectrum Protect continues to issue this
message. User response

ANS4200E The virtual machine 'vmname' Check the release documentation for information on
could not be backed up because supported operating system levels.
the data usage of datastore ANS4206E The Deployment Manager received
'datastore' exceeded the datastore an error while extracting from
threshold of percentused percent. installation image: image name.

Explanation Explanation
The data usage of the datastore used by the virtual The installation image might be missing, corrupted, or
machine exceeds the threshold set by the there might be insufficient disk space on the client
VMDATASTORETHRESHOLD option. computer.

System action System action

The virtual machine is not backed up. Deployment Manager stops.

Chapter 2. ANS 0000-9999 messages 309

User response System action
Make sure that there is sufficient disk space on the Processing stops.
client computer.
Make sure that all of the Windows self extracting client User response
images on the client computer are valid. Log on to the client machine and check the backup-
ANS4207E The Deployment Manager was archive client error log.
unable to initiate the final ANS4213E Automatic restart of the client
connection between the server computer was required because
and the updated backup-archive reason
client.
Explanation
Explanation
The Deployment Manager determined that the
After the automatic client deployment, the dsmc query deployment requires restarting the client.
session command from the updated backup-archive
client was not successful. Automatic restart is not enabled. The Deployment
Manager process cancels the deployment.
System action The current client is not uninstalled or updated.
The Deployment Manager process ends.
System action
User response Deployment Manager cancels the client deployment
and stops
Log on to the client computer and check the backup-
archive client error log.
User response
ANS4210E The Deployment Manager failed to
install package: 'client package Reschedule the client deployment.
name'. The Microsoft Installer ANS4215E The automatic deployment path
error code was 'system from the current client code
architecture' version 'source version' to the
client package version 'target
Explanation version' is not supported.
The previous client package has been uninstalled, and
the installation of the new client package failed. Explanation
None
System action
Processing stops. System action
Processing stops.
User response
Check the technote for Microsoft Installer error code User response
description: http://www-01.ibm.com/support/ Refer to the Backup-Archive Client documentation in
docview.wss?uid=swg21050782&rs=663 the information center.
Check the install log on the client computer. Reschedule the client deployment with an appropriate
ANS4212E The Deployment Manager failed to target level.
restart service: servicename ANS4217E The Deployment Manager received
an error while setting up the client
Explanation API. The standard API function
being invoked is API setup function
After the automatic client deployment, the IBM
name.
Spectrum Protect client services failed to start.

310 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The Deployment Manager process failed when setting Reschedule with automatic restart (autoreboot)
up the client API. enabled.

System action User response

Processing stops. None
ANS4221E The architecture of the package:
User response 'package architecture' does not
Check the error log on the client computer. match the current client: 'system
architecture'
ANS4218E The Deployment Manager received
an error while initializing the
Explanation
client API. The standard API
function being invoked was API The setup script was unable to retrieve the matching
setup function name. package from the server.

Explanation System action

The Deployment Manager process failed when Processing stops.
initializing the client API.
User response
System action
Ensure that the client packages for all architectures
Processing stops. are available on the server.
ANS4222E The Deployment Manager is
User response unable to read information in file:
Check the error log on the client computer. file name.

ANS4219E The Deployment Manager received

Explanation
an error while creating a pipe for
the standard output of the child Deployment Manager failed to open a file containing
process. required system information.

Explanation System action

The Deployment Manager failed to create a pipe for Processing stops.
the standard output of the child process.
User response
System action
Check the error log on the client computer.
Processing stops.
ANS4227E The Deployment Manager failed to
install package: 'client package
User response name'. The client computer is out
Check the error log on the client computer. of disk space. The Microsoft
Installer error code was 'error
ANS4220E The Deployment Manager is code'
unable to determine if IBM
Spectrum Protect processes are
Explanation
still running.
The previous client package has been uninstalled, and
Explanation the installation of the new client package failed
because the client computer is out of disk space.
The Deployment Manager could not determine
whether all IBM Spectrum Protect processes were
System action
shut down successfully.
Processing stops.

Chapter 2. ANS 0000-9999 messages 311

User response possible the other messages provide details of the
deployment.
Check the technote for Microsoft Installer error code
description: http://www-01.ibm.com/support/
docview.wss?uid=swg21050782&rs=663 System action

Check the install log on the client computer. The Deployment Manager process continues. The
client computer will be shut down and restarted
ANS4228E The Deployment Manager failed to immediately after all language packs are deployed, or
install language pack: 'language immediately if there are no language pack to install.
pack name'. The client computer is
out of disk space. The Microsoft User response
Installer error code was 'error
code' None
ANS4232E Self-extracting installation image:
Explanation image name cannot be found.
The previous language pack has been uninstalled, and
the installation of the new language pack failed Explanation
because the client computer is out of disk space.
The Deployment Manager could not find the required
installation image.
System action
Processing continues. System action
Processing stops. Client deployment will be cancelled.
User response
Check the technote for Microsoft Installer error code User response
description: http://www-01.ibm.com/support/
Check the server's activity log or the scheduler log on
docview.wss?uid=swg21050782&rs=663
the client computer. Reshcedule the client
Check the install log on the client computer. deployment.
ANS4229I The client computer is required to ANS4234E The deployment for language
restart to complete the new packs failed.
Backup-Archive client installation.
Explanation
Explanation
The Deployment Manager failed to install one or more
The deployment of the new backup-archive client will language packs. It is possible the other messages
not be complete until the client computer is restarted. provide details of the installation.
The restart is scheduled to happen immediately after
all language packs are deployed. System action
The Deployment Manager process continues.
System action
The Deployment Manager process continues. The User response
client computer will be shut down and restarted after
all language packs are deployed, or immediately if Check the error log and installation on the client
there are no language pack to install. computer. Identify the language packs that failed to
install and manually deploy them.
User response ANS4235I The deployment manager cannot
None log events to the server.

ANS4230I The client computer will be shut Explanation

down and restarted immediately.
The Deployment Manager is unable to log events to
the server. It is possible the other messages provide
Explanation
details of the communications.
The Deployment Manager needs to restart the client
computer to complete the client deployment. It is

312 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
The Deployment Manager process continues. Events Processing stops if SKIPMISSINGSYSWFILES option is
will be logged locally on the client machine only. set to NO. Processing continues if
SKIPMISSINGSYSWFILES option is set to YES.
User response
User response
Check network connection and the error log on the
client computer. Verify that this file can be skipped during system state
backup.
ANS4242E The setup script encountered a
warning or error while retrieving ANS4252W architecture, schedule-name,
the client package for the domain-name : The client
architecture architecture. The deployment was not completed
error level is error level error level. pending the restart of the client
computer. The deployment
Explanation manager did not restart the client
computer automatically because
It is possible that the client package is not available on the AUTODEPLOY option was set
the server. to NOREBOOT.

System action Explanation

Processing stops. The previous client has been uninstalled, and the
installation of the new client was not completed
User response pending the restart of the client computer. The
architecture of the client, schedule name, and domain
Ensure that client packages for all architectures are
name are identified at the beginning of the message
available on the server. Check the backup-archive
text.
client error log for more detailed error messages.
ANS4248E The client is already at the target System action
level: target version.
The Deployment Manager process completes.
Explanation
User response
Processing stopped because the automatic client
deployment feature does not support the installation Manually restart the client computer as soon as
of a client to a workstation that is already at its target possible.
level. ANS4253E There was not enough disk space
on the client computer. Required
System action space: package space bytes;
available space: system space
Your current backup-archive client is not affected.
bytes.

User response
Explanation
Refer to the Backup-Archive Client documentation in
The deployment manager determined there was
the information center.
insufficient free disk space for the client deployment.
Reschedule the client deployment with an appropriate
target level. System action
ANS4251W writername file 'filename': not Processing stops.
found.
User response
Explanation
Free up required disk space and reschedule the client
The indicated VSS writer file or directory was returned deployment.
by VSS as part of the backup file list of the writer.
However, the object does not exist on the disk. ANS4254E The deployment manager detected
. an HSM client on the workstation

Chapter 2. ANS 0000-9999 messages 313

 that it needs to deploy the Explanation
Backup-Archive client to.
The deployment manager could not parse or extract
the required information from the specified file.
Explanation
An attempt was made to deploy the Backup-Archive System action
client to a workstation that already has the HSM client
Processing stops.
installed. The Backup-Archive client cannot be
deployed to a workstation that has the HSM client.
User response
System action Check the error log file on the client workstation.
Processing stops. ANS4258E The deployment manager received
the Windows "OpenSCManager
User response failed" error message.

Uninstall the HSM client and reschedule the Backup-

Explanation
Archive client deployment.
The deployment manager could not connect to the
ANS4255E There is not enough memory for
Windows service control manager to start the client
the deployment manager to create
scheduler. In general, this error occurs because the
the system information object
user who is initiating the task does not have sufficient
authority.
Explanation
The system information object could not be created System action
because there is not enough available RAM to
Processing stops.
temporarily write the data into.

User response
System action
Ensure that the user who starts the client scheduler
Processing stops.
has administrative privileges.

User response ANS4259E The client scheduler is not started

as a root user.
Close all unneeded applications on the client
workstation and reschedule the deployment.
Explanation
ANS4256E The DSMI_DIR environment
The client scheduler requires root user privileges to
variable is not defined.
upgrade the client code.

Explanation
System action
The deployment manager cannot initiate a connection
Processing stops.
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 User response
client scheduler. Log in as root and start the client scheduler.
ANS4260E The installation file system is not
System action
writeable.
Processing stops.
Explanation
User response
The deployment manager cannot write to the
Read the available documentation to determine how to installation file system.
use the client scheduler to create a client deployment
task. System action
ANS4257E The deployment manager cannot Processing stops.
parse information in file: file name.

314 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Check the installation file system permissions. It is The deployment manager received an error while
possible that the current client node runs in a uninstalling the current client.
virtualized environment using the client code installed
in a shared storage of the physical environment. System action
Reschedule the client deployment with the client node
in the physical environment. Processing stops.

ANS4261E The deployment manager cannot User response

upgrade the Backup-Archive
Client. Check the deployment manager log and trace files on
the client workstation for more details on the error.
Explanation You might have to manually uninstall the client.

The Backup-Archive Client cannot be upgraded ANS4264E The deployment manager failed to
because either the current location is not the default install the backup-archive client.
installation location or the DSM_DIR, DSMI_DIR,
DSM_CONFIG and DSMI_CONFIG environment Explanation
variables are defined with a relative path and not an
The current client was uninstalled and the deployment
absolute path.
manager received an error while installing the new
client code.
System action
Processing stops. System action
Processing stops.
User response
Check the installation directory of the current Backup- User response
Archive Client. If the Backup-Archive Client is not
Check the deployment manager log and trace files on
installed in the default location, manually upgrade the
the client workstation for more details on the error.
Backup-Archive Client. If the DSM_DIR, DSMI_DIR,
Manully install the new client after the issue is
DSM_CONFIG and DSMI_CONFIG environment
resolved.
variables are defined with a relative path, define them
with an absolute path and try the client deployment ANS4265I Client deployment options are not
again. specified in the scheduler
command or from client services.
ANS4262E The preview of the client
installation failed.
Explanation
Explanation The default client options file will be used. The
deployment manager might not report the correct
The deployment manager did not uninstall the current
server and node information when reporting status.
client. The client code is unchanged.

System action
System action
Processing continues.
Processing stops.

User response
User response
Avoid initiating the client deployment directly from the
Check the deployment manager log and trace files on
command-line, instead, always start the client
the client workstation for specific issues identified
scheduler as a Windows service.
during the preview. Reschedule a deployment after
any issues are resolved. ANS4266I The deployment manager failed to
install non-English language
ANS4263E The deployment manager failed to
pack(s).
uninstall the backup-archive
client.

Chapter 2. ANS 0000-9999 messages 315

Explanation System action
The previous packages were uninstalled, and the Processing continues.
installation of one or more new language packs were
not successful. User response
The client scheduler is interrupted during the
System action
deployment.
Processing continues.
ANS4270I The deployment manager and the
new client installation packages
User response were downloaded to directory: file
Check the deployment trace file on the client name.
workstation for specific language pack information.
Explanation
ANS4267I The deployment manager failed to
install the hardware plugin The download directory contains everything required
package. to complete the new client deployment. Deployment
log and trace files can be found in the log/ sub-
Explanation directory.

The previous package was uninstalled. The installation

System action
of the new hardware plugin package failed.
Processing continues.
System action
User response
Processing stops.
Obtain log and trace files from the download directory
User response for problem determination. The files are found within
the log/ sub-directory.
Check the deployment trace file on the client
workstation. ANS4271E The deployment package is
missing one or more required
ANS4268I The deployment manager failed to installation image files.
install the journal-based backup
package.
Explanation

Explanation The client deployment package might not have been

imported correctly to the server. It is possible that the
The previous journal-based backup package was deployment package is not retrieved completely to the
uninstalled. The new journal based backup package client computer, due to a lack of disk space.
installation failed.
System action
System action
Processing stops.
Processing stops.
User response
User response
Ensure that client packages are available on the server
Check the deployment trace file on the client and there is sufficient disk space on the client
workstation. computer. Check the backup-archive client error log
ANS4269W The deployment manager is file for more detailed error messages.
stopping the scheduler or the CAD ANS4272E The processor type of the package:
processes. package processor type does not
match the current client: system
Explanation processor type.
.
Before deploying the new client, the deployment
manager must stop the scheduler and CAD processes.
After the deployment, the processes must be
restarted.

316 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS4275E The deployment manager cannot
restart the scheduler or the CAD
The processor type supported by the client package
processes.
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 Explanation
deployment manager to connect to the server and Before exiting, the deployment manager could not
report the error. restart the Backup-Archive Client scheduler or CAD
processes. The deployment manager stopped the
System action processes prior to the client upgrade.
Processing stops.
System action
User response Processing continues.
Verify that you are using the correct client package for
the processor architecture of the computer that you User response
want to upgrade. Then restart the deployment. Log on to the Backup-Archive Client workstation and
ANS4273E The deployment manager detected check the error log file. If you have set environment
a journal based backup (JBB) variables make sure they are not defined using relative
client on the workstation where it path.
needs to deploy the Backup- ANS4276E The deployment manager cannot
Archive Client. obtain information about the
scheduler or the CAD processes.
Explanation
An attempt was made to deploy the Backup-Archive Explanation
Client to a workstation that already has the JBB client The deployment manager needs process information
installed. On some platforms, the Backup-Archive in order to stop and restart the Backup-Archive Client
Client cannot be deployed to a workstation that has scheduler or CAD processes.
the JBB client installed.
System action
System action
Processing stops.
Processing stops.
User response
User response
Log on to the Backup-Archive Client workstation and
Uninstall the JBB client and reschedule the Backup- check the error log file and the deployment manager
Archive Client deployment. error log file.
ANS4274E The deployment manager cannot ANS4277E The target operating system
stop the scheduler or the CAD version target operating system
processes. does not meet the minimum
required version minimum
Explanation required version
The deployment manager tried to shut down the
Backup-Archive Client scheduler or CAD processes but Explanation
the Backup-Archive Client might be busy with other The operating system version is earlier than the
tasks. version required by the automatic deployment
package.
System action
Processing stops. System action
The deployment is canceled.
User response
Reschedule the Backup-Archive Client deployment.

Chapter 2. ANS 0000-9999 messages 317

User response User response
Ensure that the version being deployed is supported Manually uninstall the IBM Spectrum Protect client
by the target operating system. directly from the non-global zones and reschedule the
deployment.
ANS4278E The deployment manager cannot
obtain information about the ANS4282E Sparse-root non-global zone(s)
Logical Volume Snapshot Agent were found with IBM Spectrum
(LVSA). Protect Backup-Archive Client that
was installed from the non-global
Explanation zone: zone names.

The deployment manager needs to determine whether

Explanation
an LVSA is installed on the client workstation.
One or more non-global zones are sharing the /usr file
System action system with the global zone. The IBM Spectrum
Protect Backup-Archive Client is installed in the global
Processing stops. zone with the -G parameter and also installed
manually in the non-global zone(s). You cannot update
User response the IBM Spectrum Protect Backup-Archive Client in
the global zone because it will update the version of
Log on to the Backup-Archive Client workstation and
GSKit that is shared with the sparse-root non-global
check the error log file and the deployment manager
zones that are not part of the automatic deployment.
error log file.
ANS4280E Automatic client deployment is System action
not allowed on the client
workstation. Processing stops.

Explanation User response

One or more of the running client services include Manually upgrade the Backup-Archive Client or install
AUTODEPLOY = NO in the option file. 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,
System action and you can then deploy the client automatically on all
Processing stops. such zones.
ANS4283E There is not enough disk space on
User response path to uncompress GSKit
Change the AUTODEPLOY option on the client and packages. Required space:
reschedule the client deployment. req_space bytes; available space:
avail_space bytes.
ANS4281E The update manager cannot
remove the TIVsmCapi package Explanation
from non-global zone(s): zone
name. The deployment manager determined that there is not
enough free disk space to uncompress GSKit
Explanation packages.

APAR IC57433 prevents the removal of the TIVsmCapi System action

package on Solaris on a sparse-root, non-global zone if
uninstalling is done from the global zone. Processing stops.

System action User response

Processing stops. 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

318 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 for a sparse-root, non-global zone System action
that shares the /usr file system
The backup of the virtual machine finished with
with the global zone.
failures. The next virtual machine in the vmlist will be
processed. The reason for the failure is written to the
Explanation local client error log.
The automatic client deployment task that was
attempted is not supported and will be cancelled. User response
Check the local client error log for reason for the
System action failure.
Processing stops. ANS4292E No virtual machine found.

User response Explanation

Install the Backup-Archive Client from the global zone No virtual machine found with name or specified in
or manually upgrade the Backup-Archive Client. domain option.
ANS4285E The update restore operation to an
existing virtual machine 'VmName' System action
failed. The virtual machine is not
Processing stopped.
in power off state.

User response
Explanation
Specify a correct VM name or domain option.
The update restore operation to an existing virtual
machine is not supported for a running machine and ANS4293E Backup of VMware vApp 'vApp
will be aborted. name' in Organization VDC 'Org
VDC name' of organization 'Org
System action name' failed.
Restore aborted.
Explanation

User response The vApp backup operation failed. This error message
is a summary message and does not contain detailed
Turn off the virtual machine and re-run the update information.
restore command.
ANS4290E Only one virtual machine can be System action
selected for restore.
The configuration information and VMs for the
specified vApps are not backed up. Processing
Explanation continues to the next vApp.
Restoring multiple virtual machines is not allowed.
Only one virtual machine can be selected for restore. User response
Check the previous messages in the dsmerror.log file
System action for more details about this vApp .
No processing occurs. ANS4295W The virtual machine 'vmname' was
backed up using the Windows VSS
User response system provider. You must
Select only one virtual machine for restore. manually revert or delete the
shadow copy on the restored
ANS4291E Virtual Machine could not be found volumes or you may experience
on VMware server. degraded performance and an out-
of-space condition.
Explanation
The backup of virtual machine failed.

Chapter 2. ANS 0000-9999 messages 319

Explanation System action
At backup time, application protection was not able to The Deployment Manager process completes.
back up the VM within the 10-second VSS limit.
Therefore, the Windows VSS system provider was User response
used. If you are restoring the application, the volume
will be automatically reverted. However, if you are Check the warning messages from the server
restoring the entire VM, you must manually revert or administration center, the server activity log, or error
delete the shadow copy. log on the client computer for more information.
ANS4298E architecture, schedule,
System action new_device_type: The client
deployment was cancelled. The
The virtual machine is restored, including the system
previous event causing the
provider shadow copy.
cancellation is:

User response
Explanation
Verify that the restore was successful, and the data is
This is a generic message that the client deployment
not corrupt. If the data is not corrupt, you can delete
was cancelled. The Deployment Manager does not
the shadow copy. However, if the data is corrupt,
uninstall or update the current client. It is possible the
revert the shadow copy to restore data integrity. You
other messages provide details of the deployment.
can figure out which shadow copy to delete or revert
by looking for the dsmShadowCopyID.txt file in the The architecture of the client, schedule name, and
domain name are identified at the beginning of the
root directory of each restored volume. Then, use the
message text.
diskshadow delete or revert command.
ANS4296I architecture, schedule-name, System action
domain-name: The Deployment
Manager process was started Processing stops.
successfully. Deployment Manager
Version Information: version User response
Check the warning messages from the server
Explanation administration center, the server activity log, or error
The Deployment Manager process was started as a log on the client computer for more information.
post schedule command. This is the first message ANS4299E architecture, schedule-name,
from the Deployment Manager. The architecture of the domain-name: The client
client, schedule name, and domain name are identified deployment failed. The previous
at the beginning of the message text. event causing the failure is: event

System action Explanation

Deployment Manager continues to process. This is a generic message that the client deployment
failed. It is possible that other messages provide
User response details of the failure. The architecture of the client,
schedule name, and domain name are identified at the
None
beginning of the message text.
ANS4297W architecture, schedule-name,
domain-name: Client deployment System action
was completed with warnings:
Processing stops.
Explanation
User response
This is a generic warning message. It is possible the
other messages provide details of the deployment. Check the warning messages from the server
The architecture of the client, schedule name, and administration center, the server activity log, or error
domain name are identified at the beginning of the log on the client computer for more information.
message text.

320 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS4300I architecture, schedule-name, Explanation
domain-name: Client deployment The specified vCloud Director vApp has not been
was completed successfully. previously backed up, so can not be specified for
restore.
Explanation
The Deployment Manager process completes. System action
The specified vCloud Director vApp is skipped, and the
System action next vApp in the restore list is processed.
Processing stops.
User response
User response Verify the vCloud Director vApp name to be restored,
None and re-try the operation.

ANS4301I IBM Spectrum Protect detected ANS4304I IBM Spectrum Protect could not
Microsoft Active Directory Domain detect the IBM Spectrum Protect
Controller on virtual machine 'VM'. for Virtual Environments license.
Active Directory Domain Controller
will not be protected on VM 'VM'.
Explanation
The virtual machine contains Microsoft Active Explanation
Directory Domain Controller.
The virtual machine contains Microsoft Active
Directory Domain Controller, but a IBM Spectrum
System action
Protect for Virtual Environments license is not
IBM Spectrum Protect saved additional information detected. The Domain Controller will not be protected.
about this virtual machine.
System action
User response
Install IBM Spectrum Protect for Virtual Environments
None 7.1 or later to protect Active Directory.

ANS4302W IBM Spectrum Protect failed to

User response
detect if Microsoft Active Directory
Domain Controller on virtual None
machine 'VM'.
ANS4305W Backup of VMware vApp 'vApp
name' in Organization VDC 'Org
Explanation
VDC name' of organization 'Org
There was an error while checking if the virtual name' completed. Some VMs were
machine contains Microsoft Active Directory Domain not backed up.
Controller. mode: 'Incremental Forever -
full_or_incr'
System action target node name:
'target_node_name'
IBM Spectrum Protect continues backing up this data mover node name:
virtual machine. 'data_mover_node_name'
VMs backup status: number of VM
User response backed up out of number of VMs in
vApp VMs backed up successfully.
Check IBM Spectrum Protect error log for additional
information.
Explanation
ANS4303E The vCloud Director vApp 'vapp-
The vApp backup operation completed successfully.
name' has not been previously
However, one or more VMs for the specified vApp were
backed up.
not backed up. These VMs will not be created during
the restore operation.

Chapter 2. ANS 0000-9999 messages 321

System action Explanation
Processing continues to the next vApp. A rebalance operation was requested for the named
schedule. A rebalance can be complete or minimal. A
User response Minimal rebalance is performed automatically at the
end of each schedule. You can configure a complete
Check the dsmerror.log file for this vApp for more rebalance by using the option settings,
information about this message. Resolve the problem, VMREBALANCESCHEDULEPERIOD and
then try the operation again. VMREBALANCESCHEDULEONLY.
ANS4308E Full VM backup of 'hypervisor'
Virtual Machine 'vmname' failed System action
with RC=rc mode=full_or_incr, The rebalance operation begins.
target node
name='target_node_name', data
mover node User response
name='data_mover_node_name' No action is required.
ANS4319E Rebalance schedule error
Explanation
occurred while processing the
The Full VM backup of virtual machine failed. timestamp file.

System action Explanation

The full backup of the virtual machine finished with An error occurred while a tagged schedule was
failures. The next virtual machine in the vmlist will be processing a local timestamp file. The timestamp file
processed. The reason for the failure is written to the will be recreated after the next schedule is run.
local client error log.
System action
User response
The schedule completed.
Check the local client error log for reason for the
failure. User response
ANS4311E Full VM restore of 'hypervisor' The timestamp file name is based on the schedule
Virtual Machine 'vmname' failed name. It has the format
with RC=rc target node "rebalance_timestamp_schedulename.file" Deleting
name='target_node_name', data the file may help. The timestamp file will be recreated
mover node after the next schedule is run.
name='data_mover_node_name'
ANS4441E 'fs' is a 'fstype' file system, which
is not a supported file system type
Explanation
for file backup, image backup or
The Full VM restore of the virtual machine failed. archive.

System action Explanation

The full restore of the the virtual machine finished with The specified file system is not supported for any type
failures. The next virtual machine in the vmlist will be of backup. IBM Spectrum Protect does not support
processed. The reason for the failure is written to the backup and archive or image backup for this type of
local client error log. volume.

User response System action

Check the local client error log for reason for the The file system is skipped. Processing continues with
failure. the next file system.
ANS4313I Rebalance Schedule sched-name
Type: balance-type User response
Refer to the IBM Spectrum Protect client manual for a
complete list of supported file systems.

322 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS4442E 'VM-Name' a backup cannot be System action
created because the virtual The mount of the virtual machine finished with
machine has assigned disk with failures.
duplicate disk identifiers.

User response
Explanation
Review the local client error log for the reason for the
The client detected that the virtual machine has failure.
assigned disk with duplicate disk identifiers. The disk
may have been copied. A backup cannot be created on ANS4449E A cleanup of the file restore mount
a virtual machine that have duplicate disk identifiers. of hypervisor type Virtual Machine
'vmname' failed. The data center
System action node name is 'data center node
name', the mount proxy node
The virtual machine is not backuped. Processing name is 'mount proxy node name'.
continues with the next virtual machine.
Explanation
User response
The cleanup of file restore mount operation of the
Check that the virtual disks has diffrent disk identifiers virtual machine failed.
and update the virtual machine configuration to match
any changes to the file system. If the problem persists,
System action
contact an administrator of the Hyper-V server.
The cleanup of mount of the virtual machine finished
ANS4443E 'fs' is a CSVFS file system, which is with failures.
not a supported file system type
for file backup, image backup or
archive. User response
Review the local client error log for the reason for the
Explanation failure.
Microsoft Cluster Shared Volumes File Systems ANS4450E The mount proxy platform is not
(CSVFS) are NTFS or ReFS volumes that are added to supported for file restore mount
Cluster Shared Volumes. These volumes are intended operations.
for Hyper-V and expanded support for SQL, not for
regular file data. IBM Spectrum Protect does not Explanation
support file level backup and archive or image backup
for CSVFS volumes. The file restore mount operation failed. The mount
proxy platform is unsupported or the IBM Spectrum
Protect Recovery Agent is not correctly installed and
System action
configured.
The file system is skipped. Processing continues with
the next file system. System action
The file restore mount operation failed.
User response
Refer to the IBM Spectrum Protect client manual for a User response
complete list of supported file systems.
Ensure that the IBM Spectrum Protect Recovery Agent
ANS4446E A file restore mount operation for is installed and configured correctly and run the file
hypervisor type Virtual Machine restore mount operation from a supported mount
'vmname' failed. The data center proxy platform.
node name is 'data center node
name', the mount proxy node ANS4451E The Windows iSCSI service is not
name is 'mount proxy node name'. available.

Explanation
The file restore mount operation of the virtual machine
failed.

Chapter 2. ANS 0000-9999 messages 323

Explanation ANS4904E The instant access operation for
the 'vmname' virtual machine
The Windows iSCSI service is not available on the
failed. The target node is
mount proxy machine. It is either not started or is not
'target_node_name and the data
installed or configured correctly.
mover node is
'data_mover_node_name'.
System action
Processing stops. The file restore mount operation Explanation
fails.
The instant access operation for the virtual machine
failed.
User response
Ensure that the iSCSI service is up and running on the System action
mount proxy machine.
Errors occurred and the instant access operation did
ANS4900W Schedule 'schedule-name' has not complete.
opened a new session with the
server. User response
See the client error log to determine the cause of the
Explanation
failure.
A scheduled event endsbecause of a connection
failure. The scheduled event had to be restarted ANS4907E Instant restore of VMware Virtual
outside its normal startup window to continue the Machine 'vmname' failed. target
operation. node name='target_node_name',
data mover node
name='data_mover_node_name'
System action
The scheduled event is completed using more than Explanation
one session.
The instant restore of the virtual machine failed.
User response
System action
None required. If this is a recurrent condition, you may
want to check for network problems. The instant restore of the the virtual machine finished
with failures. The reason for the failure is written to the
ANS4901E The following object contains one local client error log.
or more unmatched quotation
marks and cannot be processed: User response
'filespace path filename'.
Check the local client error log for reason for the
failure.
Explanation
ANS4910E The cleanup operation for the
The file name in the file list contains unmatched
quotes. If a line in the file list begins with a single or 'vmname' virtual machine failed.
double quotation mark this quotation mark is The target node is
considered to be an opening quotation mark. The 'target_node_name' and the data
corresponding closing quotation mark of the same mover node is
type must be at the end of the line. If there is no 'data_mover_node_name'.
closing quotation mark or the closing quotation mark
has been encountered in the middle of the line, it is an Explanation
invalid input. The cleanup operation for the virtual machine failed.

System action System action

The object is skipped. Errors occurred and the cleanup operation did not
complete.
User response
Correct the specification of the object.

324 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
See the client error log to determine the cause of the Check the Windows event log for the reason for the
failure. failure.
ANS4915I Object increased in size during ANS4937I Resending file file in a new
compression: filespace transaction session to recover
pathfilename from the transmission error.

Explanation Explanation
The file increased in size during compression. None.

System action System action

Processing contiues. The file is resent.

User response User response

None. None.
ANS4917E A failure occurred while accessing ANS4938I Virtual machine: 'vm-name' disk:
the VMware libraries. The required 'disk-name' is excluded by size.
files for the virtual machine
backup were not found. Explanation
The files are installed only if the
client is defined as a data mover in The option file or command given excluded the disk
IBM Spectrum Protect for Virtual from backup processing.
Environments.
System action
Explanation The disk is not processed.
A failure occurred while accessing the VMware
libraries for the virtual machine environment. User response
If the disk is intentionally excluded, then this message
System action is expected behavior. Otherwise modify the command
The backup operation cannot continue. or option file to include the disk.
ANS4942E The file specification 'string' is
User response invalid.
Install the IBM Spectrum Protect for Virtual
Environments package to use the client to back up Explanation
virtual machines. The operating system indicated that the file
ANS4936E The snapshot of virtual machine specification is invalid. One possible reason is that the
'vmname' failed and a snapshot file specification contains unrecognized characters.
cannot be attempted again. Another possible cause is incorrect use of quotation
marks in the file specification.
Explanation
System action
The snapshot of the virtual machine failed with a
permanent error. Such as the Hyper-V writer is not Processing stopped.
responding. Another snapshot attempt will not be
made. User response
Enter a correct file specification as described in the
System action Using the Backup-Archive Client book for the particular
The snapshot of the virtual machine finished with an operating system. Ensure that the file specification
error. Processing continues to the next virtual contains valid characters. Verify correct use of
machine. quotation marks for specifications that contain blanks
spaces. If multiple file specifications are used, make

Chapter 2. ANS 0000-9999 messages 325

sure that any use of quotation marks does not cause User response
the file specifications to be treated as a single file
Use the "dsmc backup vm ..." command with the -
specification.
preview option to display a listing of the disk labels
ANS4944I Virtual machine: 'vm-name' disk: which exist on the virtual machine. Check the spelling
'disk-name' is excluded by user. of the disk label and correct the disk label and then
retry the 'backup vm' operation.
Explanation ANS4948E A specified virtual disk was not
The option file or command given excluded the disk found on the virtual machine.
from backup processing.
Explanation
System action You must specify a virtual disk label name which exists
The disk is not processed. on the virtual machine.

User response System action

If the disk is intentionally excluded, then this message Processing stops.

is expected behavior. Otherwise modify the command
or option file to include the disk. User response
ANS4946W Warning: virtual machine: 'vm- For a backup operation, use the "dsmc backup vm ..."
name' disk: 'disk-name' excluded command with the -preview option to display a listing
by user, was not found. of the disk labels which exist on the virtual machine.
For a restore operation, use the "dsmc query vm ..."
Explanation command with the -detail option to display a listing of
the disk labels which exist on the virtual machine
The specified virtual disk does not exist on the virtual backup. Check the spelling of the disk label and
machine. correct the disk label and then retry the operation.
ANS4972W File server file-server-name has
System action
been upgraded to Data ONTAP
Processing continues. version
'version.modifcation.submodificati
User response on'. This version does not support
unicode file names for snapshot
Use the "dsmc backup vm ..." command with the - difference incremental backup.
preview option to display a listing of the disk labels Upgrade to a version that supports
which exist on the virtual machine. Since the disk was unicode file names as soon as
specified to be excluded from the backup, the backup possible.
will continue. However it is possible that a disk will
included in the backup which was not desired, check
Explanation
the spelling of the disk label, and correct the disk label
if an undesired disk is now included in the backup The file server has been upgraded from a version that
operation. supports unicode file names for incremental backup
using snapshot difference to a version that does not. If
ANS4947E Error: virtual machine: 'vm-name' you have upgraded from Data ONTAP version 7.3.3 (or
disk: 'disk-name' included by user, later) to 8.0, you lose the ability to back up files with
was not found. unicode file names when performing snapshot
difference incremental backup.
Explanation
The specified virtual disk does not exist on the virtual System action
machine. Processing continues. However, files with unicode
names are not backed up.
System action
Processing stops.

326 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Upgrade to a version that supports unicode file names Ensure that the file is not locked by another process. If
as soon as possible. If you have upgraded from Data the file is not locked, retry the command.
ONTAP version 7.3.3 (or later) to 8.0, upgrade to 8.1
ANS4988W File 'filespace namepath-namefile-
(or later). If it is not possible to upgrade at this time,
name' is currently unavailable on
you can suppress this warning message by renaming
server and has been skipped.
the file space on the IBM Spectrum Protect server and
performing a snapshot difference incremental backup.
Explanation
ANS4973E An error occurred accessing NTFS
security information for file You tried to restore or retrieve a file that is currently
'filespace namepath-namefile- not available from the IBM Spectrum Protect server.
name' This is most likely a temporary condition.

Explanation System action

An access denied error occurred while attempting to IBM Spectrum Protect cannot restore or retrieve the
access NTFS security info rmation. file.

System action User response

The object is skipped. Try to restore or retrieve the file again after the file
becomes available on the server. If the problem
persists, see your IBM Spectrum Protect administrator
User response
for assistance.
See your system administrator or bypass the failing
check by using SkipNTSecu rity option. ANS4989E Error processing 'filespace
namepath-namefile-name': the
ANS4974E Error processing 'filespace directory is in use by another
namepath-namefile-name': a process. All objects in the
required NT privilege is not held. directory and any of its
subdirectories are skipped.
Explanation
Explanation
The user account running IBM Spectrum Protect does
not possess a required NT user right/pr ivilege for The specified directory is being used by another
performing the current operation. process. You tried to read from or write to a directory
that is currently being used by another process. The
System action objects contained in the directory and its
subdirectories are not backed up.
The object is skipped.
System action
User response
Processing stopped for that directory. If other files and
Your system administrator has the authority to grant directories were also specified in this backup, they are
the needed privilege. processed
ANS4987E Error processing 'filespace
namepath-namefile-name': the User response
object is in use by another process Ensure that you specified the correct directory name,
correct the permissions, or specify a new location.If
Explanation the directory name is correct, retry the backup when
The specified file is being used by another process. no process has exclusive use of the directory.
You tried to read from or write to a file that is currently ANS4991I Application Type Application
being used by another process. Message Id Application Message

System action
File skipped.

Chapter 2. ANS 0000-9999 messages 327

Explanation User response
This is a message sent by the application you are Refer to the documentation for the application that
currently running with IBM Spectrum Protect. you are using.
ANS4997E Error processing 'filespace
System action namepath-namefile-name': file
IBM Spectrum Protect logs the application message. system quota reached condition -
no space left.
User response
Explanation
Refer to the documentation for the application that
you are using. No more files can be restored or retrieved because the
quota of the destination file system has been reached.
ANS4992W Application Type Application
Message Id Application Message
System action

Explanation The client prompts you for action:

This is a message sent by the application you are • Retry this object
currently running with IBM Spectrum Protect. • Skip this object
• Abort the action
System action
IBM Spectrum Protect logs the application message. User response
Select the appropriate action for this object. Create
User response some free space or increase the quota on the
Refer to the documentation for the application that destination file system before you retry the operation.
you are using. Another option is to restore or retrieve the file to
another file system.
ANS4993E Application Type Application
Message Id Application Message 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 Explanation
currently running with IBM Spectrum Protect.
Access to the specified file link is denied. You tried to
read information for file link and you do not have
System action access permission for this object.
IBM Spectrum Protect logs the application message.
System action
User response Processing of System State stops.
Refer to the documentation for the application that
you are using. User response
ANS4994S Application Type Application Try the operation again. If the problem persists,
Message Id Application Message contact IBM technical support for additional
assistance.
Explanation ANS4999I The following message was too
This is a message sent by the application you are long to log to the server:
currently running with IBM Spectrum Protect. 'shortened message with message
number'
System action
Explanation
IBM Spectrum Protect logs the application message.
The message text and inserts are too large to send to
the server in the available internal buffer.

328 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action more than one IBM Spectrum Protect server, make
sure you are connecting to the correct server. If you
The message number message is written to the local
are unable to find a suitable management class,
client error log, then shortened and sent to the server
contact your IBM Spectrum Protect administrator for
as a part of this message. The message is reduced in
further assistance.
length by substituting '...' in the middle of the original
message. ANS5006W The policy set does not contain
any backup copy groups. The
User response process is unable to continue the
backup.
The message referred to has been shortened, but
describes the error that occurred. See the
Explanation
documentation for that message for more information.
You tried to back up the files using a policy set that
ANS5003S The management class assigned to
contained no backup management information.
directories does not exist.

System action
Explanation
The process did not back up the files.
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 User response
invalid management class name. See your IBM Spectrum Protect administrator for
assistance in associating your node with a policy set
System action containing a management class that has a backup
copy group. Then try the operation again.
processing stops.
ANS5007W The policy set does not contain
User response any archive copy groups. IBM
Spectrum Protect is unable to
Remove the current DIRMC option from the client continue the archive.
options file, then run DSMC QUERY MGMTCLASS -
DETAIL to view information about available
management classes. Make sure the management Explanation
class you select has a backup copy group. If you have You tried to archive the files using a policy set that
more than one IBM Spectrum Protect server, make contains no archive management information.
sure you are connecting to the correct server. If you
are unable to find a suitable management class, System action
contact your IBM Spectrum Protect administrator for
further assistance. IBM Spectrum Protect did not archive the files.

ANS5004S There is no backup copy group in

User response
the management class used for
directories. See the error log. See your IBM Spectrum Protect administrator for
assistance in associating your node with a policy set
Explanation containing a management class that has an archive
copy group. Then try the operation again.
The DIRMC option names a management class that
contains no backup copy group. ANS5008W Incorrect password entered

System action Explanation

processing stops. You entered a password that was incorrect.

User response System action

Remove the current DIRMC option from the client IBM Spectrum Protect cannot connect to the server
options file, then run DSMC QUERY MGMTCLASS - without the correct password.
DETAIL to view information about available
management classes. Make sure the management
class you select has a backup copy group. If you have

Chapter 2. ANS 0000-9999 messages 329

User response System action
Reenter the password, or ask your system IBM Spectrum Protect cannot complete the requested
administrator for the current password. operation.
ANS5009W New password entries are not the
same User response
Close all unneeded applications and retry the
Explanation operation. Reducing the scope of queries and the
amount of data returned might also help, or see your
During the change password, update password, or system administrator.
open registration dialog, the two entries for the new
password were not the same. ANS5014I Backup completed

System action Explanation

The password was not changed on the server. The backup was completed.

User response System action

Backspace over both of the new passwords and IBM Spectrum Protect backed up the files.
reenter them, ensuring that they match.
ANS5011I Backup stopped by user User response
Continue with normal operations.
Explanation
ANS5015I Restore stopped by user
You requested to stop the backup operation.
Explanation
System action
You requested to stop the restore operation.
Backup stopped.
Attention: If you were restoring files with
"overwrite" option specified, the file you
User response restored last can be damaged (partially
Continue with normal operations. overwritten).

ANS5012E Server out of backup data storage System action

space
Restore stopped.
Explanation
User response
The server ran out of space in its backup data storage.
Continue with normal operations.
System action ANS5016E Not enough memory for the
IBM Spectrum Protect cannot complete the requested requested restore operation.
backup operation. Any files displayed on the lower half
of the backup activity panel were successfully backed Explanation
up.
Not enough memory is available for the requested
restore operation.
User response
See your system administrator. System action
ANS5013E Not enough memory for backup Processing stops.
operation
User response
Explanation Close all unneeded applications and retry the
IBM Spectrum Protect cannot allocate memory for the operation. Reducing the scope of queries and the
specified backup operation.

330 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
amount of data returned can also help, or see your User response
system administrator.
Report the problem to your IBM Spectrum Protect
ANS5017I Restore completed system administrator, who can allocate more
resources to archive storage.
Explanation ANS5021I Archive completed
A restore was completed.
Explanation
System action An archive was completed.
IBM Spectrum Protect restored the files.
System action
User response IBM Spectrum Protect archived the files.
Continue with normal operations.
User response
ANS5018E Not enough memory for archive
operation Continue with normal operations.
ANS5022I Retrieve stopped by user
Explanation
The client cannot allocate memory for the requested Explanation
archive operation.
You requested to stop the retrieve operation.

System action Attention: If you were retrieving files with

"overwrite" option specified, the file you
Processing stops. retrieved last can be damaged (partially
overwritten).
User response
Close all unneeded applications and retry the System action
operation. Reducing the scope of queries and the Retrieve stopped.
amount of data returned might also help, or see your
system administrator.
User response
ANS5019I Archive stopped by user Continue with normal operations.

Explanation ANS5023E Not enough memory for retrieve

operation
You requested to stop the archive operation.
Explanation
System action
The process in which the program runs has exceeded
Archive stopped. the maximum allocated memory.

User response System action

Continue with normal operations. Processing ends.
ANS5020E The IBM Spectrum Protect server
is out of archive data storage User response
space. Close all unneeded applications and retry the
operation. Reducing the scope of queries and the
Explanation amount of data returned might also help, or see your
The server ran out of space in its archive data storage. system administrator.
ANS5024I Retrieve completed
System action
Client cannot complete the requested archive Explanation
operation. A retrieve was completed.

Chapter 2. ANS 0000-9999 messages 331

System action Explanation
IBM Spectrum Protect retrieved the files. The operation successfully completed.

User response System action

Continue with normal operations. None.
ANS5025E The node name contains invalid
characters. User response
None.
Explanation
ANS5029E This operation cannot continue
The specified node name has invalid characters. due to an error on the IBM
Spectrum Protect server. See your
System action IBM Spectrum Protect server
administrator for assistance.
Current operation has been cancelled.
Explanation
User response
The IBM Spectrum Protect server encountered an
Retry with another node name that has valid error condition that prevents the IBM Spectrum
characters. Protect client operation from continuing. Your IBM
ANS5026W MatchAllChar and Spectrum Protect server administrator can review the
MatchOneChar options MUST IBM Spectrum Protect server activity log for more
precede Include/Exclude options details about the error.

Explanation System action

The MatchAllChar and MatchOneChar options must The processing stopped.

precede any include-exclude options.
User response
System action Contact your IBM Spectrum Protect server
Current application ends administrator for assistance. The administrator can
review the IBM Spectrum Protect server activity log for
further information about the conditions that lead to
User response this error.
Move the MatchAllChar and MarchOneChar options
ANS5030E No objects on server match query
before any include-exclude options.
ANS5027W Objects of different types cannot Explanation
be backed up at the same time.
No objects on the server match the query operation
being performed.
Explanation
Backing up objects of different types at the same time System action
is not allowed in certain scenarios. For example,
backing up Hyper-V and VMware virtual machines at The processing stopped.
the same time is not possible.
User response
System action Ensure the names are properly entered.
No processing takes place. ANS5031E Client aborted transaction

User response Explanation

Select objects of the same type to perform backup The client system ended the operation with the server
operation. and ended the current transaction.
ANS5028I Successful completion

332 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
The processing stopped. Ask the administrator to check the activity log for any
messages related to this error that might help identify
User response the problem.

Restart the session. ANS5034E You entered an incorrect

password.
ANS5032W Active object not found
Explanation
Explanation
You entered an incorrect current password or you
An attempt was made to expire an object, but the entered a new password that does not fulfill the
server was unable to find an active backup version of password length requirements set on the server.
the object. This message is preceded by message
ANS1228E which specifies the object name.
System action
For instance, this message could be issued if two
separate client processes are backing up the same file The processing stops.
system at the same time. If one of the processes
expires a file, then the server will make that file User response
inactive. If the second process subsequently attempts
to expire that same file, the server will not find an Retry the session with the correct password. If this
active version of the file, so the second process will fails or you have forgotten your password, ask the
issue this message for that file. administrator to assign a new password.
ANS5035E Node is in use.
System action
The object is not expired. Processing continues with Explanation
the next object.. The node you are running on is in use by another
operation on the server. This might be from another
User response client or from some activity on the server.
Review the console output, schedule log, or error log
and locate the ANS1228E message that immediately System action
precedes this message. ANS1228E will identify the The processing stopped.
object that could not be expired. Examine the
conditions under which the problem occurred and
assess whether those conditions explain the User response
occurrence of this message. For example, this Retry the operation, or see your system administrator
message could appear if multiple instances of the to see what other operations are running for your
client were attempting to back up the file system node.
concurrently. If the reason this message occurred can
not be determined and the message occurs when the ANS5036E Expiration date must be greater
operation is tried again, then contact support for than today's date
further assistance. Also try searching for this message
number on http://www.ibm.com for possible solutions. Explanation
ANS5033E Server has no data for the object. Archive expiration date is too low, the date must be
greater than today's date.
Explanation
System action
Server tried to do a restore or retrieve on an object
that has no data associated with it. If a corrective The current operation is canceled.
action is possible, it is with the server.
User response
System action Retry archiving the file with an expiration date that is
Server ends the current operation. higher than today's date.
ANS5037W The requested data is offline

Chapter 2. ANS 0000-9999 messages 333

Explanation Explanation
For the restore or retrieve operation, one or more of Server media mount not possible. The server timed out
the requested files must be recalled from offline waiting for a mount of an offline volume.
storage media (generally tape). The wait time depends
on your site's offline storage management policies. System action
File skipped.
System action
CLient waits for offline storage media to become User response
available and then continues.
Retry later when server volumes can be mounted.
Ensure that the MAXNUMMP (maximum number of
User response
mount points) defined on the server for this node is
None. greater than 0.
ANS5038E Object too large for server limits. ANS5041E Size estimate exceeded.

Explanation Explanation
The object is too large. The configuration of the server The total amount of data for a backup or archive
does not have any data storage space that accepts the operation exceeds the estimated size originally sent to
object. the server for allocating data storage space. This
happens when many files are growing by large
System action amounts while the backup or archive operation is in
session.
File skipped.
System action
User response
Processing stopped.
See your system administrator to determine the
maximum file (object) size for which your site's server
User response
is configured.
Retry the operation. If the problem continues, check
ANS5039E Server out of data storage space. what other processes are running on the client
machine that are generating large amounts of data.
Explanation Disable those operations while the backup or archive
The server does not have any space available to store operation is taking place.
the object. ANS5042E File data is currently unavailable
on the IBM Spectrum Protect
System action server
Ended the current operation.
Explanation
User response The IBM Spectrum Protect client was trying to restore
or retrieve data that is currently unavailable on the
You can take any of the following actions:
IBM Spectrum Protect server. Possible causes are:
• For client, set COMPRESSALWAYS=NO and
• Data is corrupted at the IBM Spectrum Protect
COMPRESSIon=YES in the options file (DSM.OPT),
server
then the file will be resent uncompressed if it grows
during compression. • The IBM Spectrum Protect server encountered a
read error
• Request the system administrator to add space to
the storage pool. • File is temporarily involved in a reclaim operation at
the server
• The system administrator can also turn off disk
caching in the disk storage pool, and issue MOVE • The IBM Spectrum Protect requested a tape volume
DATA commands to each disk pool volume to clear that is unavailable. Typical reasons for a volume to
out the cached bitfiles. be unavailable: a disk volume is offline, the volume is
marked unavailable due to an I/O error, or a tape
ANS5040E Server media mount not possible. volume is checked out of the tape library.

334 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stopped. Update your password. You may use the SET
PASSWORD command, or have the administrator
User response update your node.

Try the operation again at a later time. If the problem ANS5046E Session rejected: Unknown or
continues, contact your IBM Spectrum Protect server incorrect node ID entered
administrator for further assistance. The administrator
can review the IBM Spectrum Protect server activity Explanation
log for messages related to the problem.
The node name you entered is not known by the
ANS5043W Unexpected retry request. The server, or you are attempting to access a file migrated
server found an error while writing to a different node.
the data.
System action
Explanation
The current operation is canceled. You are not allowed
None. to connect to the server until your node name is
registered with the server. If attempting to access a
System action migrated file, your node name must be the same node
which migrated the file.
The client retries the operation.
User response
User response
Ensure that you entered your node name correctly. If
None. yes, see your system administrator. Verify that the
ANS5044E Session rejected: All server server is using closed registration and that your node
sessions are currently in use. name is registered with the server.
ANS5047E Session rejected: Duplicate ID
Explanation entered. Node already logged onto
server
Server has all available sessions in use and cannot
accept a new one at this time.
Explanation
System action Another process using this node name is active with
the server.
Server canceled the current operation.

System action
User response
Cannot connect to the server. Canceled the current
Retry the operation.If the problem continues, see your
operation.
system administrator to increase the number of
concurrently active sessions to the server.
User response
ANS5045E The session is rejected. Your
password has expired. 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
Explanation node name.
Your password has expired.
ANS5048E Please choose a filespace.The
filespace to delete/set access
System action cannot be found.
Server canceled the current operation. You are not
allowed to connect to the server until the password is Explanation
updated.
The filespace to delete cannot be found.

Chapter 2. ANS 0000-9999 messages 335

System action ANS5052E Session rejected: Downlevel
server code version.
The system returns to the calling procedure.

Explanation
User response
The server version and your client version do not
Verify the filespace name.
match. The server code is downlevel.
ANS5049E Session rejected: The server is
disabled System action
The current operation is canceled.
Explanation
The server is in a disabled state and cannot be User response
accessed for normal activity.
See your system administrator to see what version to
run for your location.
System action
ANS5053W The operation was stopped by the
Canceled the current operation.
user.

User response
Explanation
Retry the operation after the server returns to an
The operation was stopped at the request of the user.
enabled state. If the problem continues, see your
This usually occurs when the 'Q' key is pressed two
system administrator.
times.
ANS5050E The server is not configured to
allow open registration. System action
Processing stopped.
Explanation
No authorization. Registration is required by your User response
system administrator. The server is not configured to
allow open registration. None.
ANS5054E The operating system refused a
System action request for memory allocation.
Session not started.
Explanation
User response The client requires access to memory in order to store
information as processing proceeds. In this case, more
You must obtain a node and password from your
memory was requested than the operating system
system administrator.
would allocate. Possible reasons include:
ANS5051S Session rejected: the client code is
• The system is low on memory.
down-level
• The process in which the program runs has
exceeded the maximum allocated memory.
Explanation
• Some other error condition occurred. No memory is
The server version and your client version do not available.
match. The client code is downlevel.
System action
System action
Client cannot complete the requested operation.
The current operation is canceled.
User response
User response
Close all unneeded applications and try the operation
See your system administrator to see what version to again. If the operation still fails, try dividing the task
run for your location. into several smaller units. For example, if a file
specification contains several high-level directories,

336 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
run the task serially for each directory. If the task is an Explanation
incremental backup, use the option "-
All file handles for your system are currently in use. No
memoryefficientbackup=yes".
more are available.
ANS5055E File not found during Backup,
Archive or Migrate processing. No System action
file specification entered.
Processing stopped.
Explanation
User response
The file being processed for backup, archive or migrate
no longer exists on the client. Another process deleted Either free some file handles by ending other
the file before it could be backed up, archived or processes, or modify your system setup to allow for
migrated. more files to be open at the same time.
ANS5059E The file exists and cannot be
System action overwritten.
File skipped.
Explanation
User response The file being restored or retrieved exists and cannot
be overwritten due to lack of authority or access
None.
permissions.
ANS5056E The specified directory path could
not be found. System action
The file is skipped.
Explanation
An invalid or unreachable directory path was specified. User response
Verify that you have sufficient access permissions to
System action overwrite the file, then try the operation again. If the
Processing stopped. problem persists, contact your system administrator
or administrator for further assistance.
User response ANS5060E Invalid parameter passed.
Try the operation again using a valid directory path.
Explanation
ANS5057E Access to the specified file or
directory is denied. The system encountered an internal program error due
to an invalid parameter.
Explanation
System action
Access to the specified file or directory is denied. You
tried to read from or write to a file and you do not have The system returns to the calling procedure.
access permission for either the file or the directory.
User response
System action Ask your service representative to check the error log.
Processing stopped.
ANS5061E An invalid file handle passed.
Report how you got this system
User response error.
Ensure that you specified the correct file or directory
name, correct the permissions, or specify a new Explanation
location.
An internal system error occurred. A file operation
ANS5058E No file handles available failed because of an invalid file handle.

System action
Processing stops.

Chapter 2. ANS 0000-9999 messages 337

User response ANS5092S Server out of data storage space.
Try the operation again. If the failure persists, obtain a
service trace that captures the problem and contact Explanation
technical support for additional assistance. Your The server does not have any more space available to
administrator can help you configure the trace. store the object.
ANS5062E Disk full
System action
Explanation IBM Spectrum Protect ended the current operation.
Operation has stopped because the destination disk is
full. User response
Report to your system administrator that a storage
System action pool on the server is full.
Processing stopped. ANS5093S SLM_LICENSE_EXCEEDED: The
client licenses for IBM Spectrum
User response Protect are exceeded. See your
IBM Spectrum Protect
Free up disk space and retry the operation
administrator.
ANS5083E Drive specification contains
wildcard character. Explanation
Adding a new enrollment will exceed the product
Explanation
license count for this IBM Spectrum Protect server.
Drive name shouldn't contain wildcard character.
System action
System action
The client enrollment or connection request ends.
Wildcarded objects skipped.
User response
User response
See your IBM Spectrum Protect administrator to
Use valid drive specification. delete unused enrollments or negotiate an increase in
the number of allowed licenses for your server.
ANS5091S The IBM Spectrum Protect server
does not currently have space in ANS5094E Session Rejected. Sufficient server
the storage pool for this file. This memory is not available.
might be a temporary condition.
Explanation
Explanation
The server does not have enough memory to allow
This message is typically issued when the storage pool your client to establish a connection with the server.
in which the data is being placed does not have
sufficient to store the data, but that the space will be System action
available soon. For example, a storage pool migration
may free up sufficient space to store the data. Session was not started.

System action User response

Process ends. Retry later or see your system administrator.

ANS5122E The specified filespace does not
User response exist on the server. The filespace
This is possibly a temporary condition. Try the might have been deleted by
operation again at a later time. If the error persists, another client or an administrator.
contact your IBM Spectrum Protect administrator, who
can examine server console and error logs to locate
the cause of the problem.

338 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The specified filespace does not exist on the server. Current operation has been cancelled.
Your administrator might have already deleted the
filespace or another client using your client's node User response
name might have deleted it.
Retry with another node name that does not have any
invalid characters.
System action
ANS5126S Filespaces with duplicate names
IBM Spectrum Protect ends the current operation.
are not supported. Unmount the
duplicate file space.
User response
The filespace you selected does not exist any more. Explanation
See your IBM Spectrum Protect administrator for help
The selected file space has a duplicate volume label.
in finding how the filespace was deleted.
Because IBM Spectrum Protect uses the volume label
ANS5123S Open registration failed because to keep track of backup/archive information, it cannot
the specified node name is already back up or archive files from a file space with a
defined in the server. duplicate volume label.

Explanation System action

Open registration failed because a node is defined on IBM Spectrum Protect cannot select the volume.
the server with the same name.
User response
System action
If the file space needs to be available to the system,
Current operation has been cancelled. exit IBM Spectrum Protect, and assign a volume label
to the file space. Restart the process and retry the
User response operation. Otherwise, unmount the duplicate file
space.
Retry with another node name.
ANS5127I IBM Spectrum Protect has
ANS5124S Open registration failed because detected an incomplete setup!
there is no default domain. The system options file 'dsm.sys'
was not found, while the client
Explanation options file 'file-path' exists!
The wizard will guide you through
Open registration failed because a default policy
the configuration process of the
domain does not exist in which to place your node. A
initial basic IBM Spectrum Protect
default policy domain is required to fully support open
client options files replacing your
node registration.
current option file. Would you like
to continue?
System action
Current operation has been cancelled. Explanation
IBM Spectrum Protect has detected an incomplete
User response setup. The system options file, dsm.sys, was not
See your IBM Spectrum Protect administrator for found. Additionally, a user options file, dsm.opt, was
assistance in registering your node. found. To complete the configuration the configuration
wizard will create dsm.sys and replace dsm.opt with
ANS5125S Open registration failed because minimal settings.
an invalid node name was
specified. System action

Explanation IBM Spectrum Protect may stop

Open registration failed because the specified node

name has invalid characters.

Chapter 2. ANS 0000-9999 messages 339

User response ANS5132I Filespace deletion canceled by
user
If the current version of dsm.opt is needed, rename
the file and restart IBM Spectrum Protect. If the
current version is not needed, select yes and allow Explanation
IBM Spectrum Protect to replace the file. You requested to cancel the filespace deletion
ANS5128E The management class for this file operation.
did not have a backup copy group.
System action
Explanation The filespace deletion operation stopped.
For backup operations, a file may only be bound to a
management class that has a backup copy group. User response
Continue with normal operations.
System action
ANS5133I Filespace 'filespace' was deleted
IBM Spectrum Protect did not back up the file.
Explanation
User response
The specified filespace was successfully deleted.
See your IBM Spectrum Protect system administrator
for assistance in finding a management class with the
System action
required copy group. The administrator may also
define such a management class for you. IBM Spectrum Protect deleted the filespace.
ANS5129E The management class for this file
did not have an archive copy group User response
specified. Continue with normal operations.
ANS5134E Unable to delete the filespace
Explanation
because this node does not have
For archive operations, a file may only be bound to a permission to delete archived or
management class that has an archive copy group. backed up data.

System action Explanation

The file was not archived. You tried to delete a filespace that you do not have
permission to access.
User response
System action
See your IBM Spectrum Protect system administrator
for assistance in finding a management class with the Processing stopped.
required copy group. The administrator may also
define such a management class for you. User response
ANS5130W No filespaces selected for deletion Ensure that you specify the correct filespace, or
specify a filespace you have access to.
Explanation
ANS5135I Archive delete stopped by user
You requested a deletion operation without selecting a
client domain. Explanation
You requested to stop the archive delete operation.
System action
IBM Spectrum Protect cannot perform a deletion System action
without a domain selected.
Archive delete stopped.
User response
User response
Select the volumes you want to delete and retry the
operation. Continue with normal operations.

340 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS5138I Archive delete completed System action
Processing stopped; waiting for user intervention.
Explanation
An archive delete was completed. User response
Answer "Yes" to switch back to accessing the server as
System action the original node.
IBM Spectrum Protect deleted the archived files. ANS5148W The server needs to do a one-time
conversion of your archive data
User response before you can continue. This
operation may take a long time,
Continue with normal operations.
and cannot be canceled once it has
ANS5139E Your node does not have started. Are you willing to wait for
permission to delete archived the conversion to complete?
files.
Explanation
Explanation The server must do a conversion of the archive data
Your node is registered at the server with the before continuing. The conversion could take a long
ARCHDELETE option set to 'NO'. Therefore your node is time, and cannot be canceled once it is started.
not allowed by the server to delete archived files.
System action
System action Processing stopped; waiting for user intervention.
Archived files were not deleted.
User response
User response Answer "Yes" to start the archive data conversion. If
See your IBM Spectrum Protect system administrator. you answer "No", the current operation will be
The administrator has authority to delete archived canceled.
files, and can also grant that authority to your node.
ANS5150E An active restore for the same
ANS5145W Server cannot restart the last source file specification exists.
restore request. Do you want to Unable to continue with this
restore without restart? request.

Explanation Explanation
The restart restore token has expired. The server Currently, there is an active restore for the same
cannot restart the restore from where it last ended. source file specification. Another restore of the same
source file specification cannot be started.
System action
System action
Processing stopped; waiting for user intervention.
The requested restore fails.
User response
User response
Retry the request without restart or abort the request.
Start another restore with a different source file
ANS5146W You cannot perform this operation specification.
while accessing data for another
node. Do you wish to switch back ANS5151S This node currently has a pending
to accessing your own node? restartable restore session. The
requested operation cannot
Explanation complete until this session either
completes or is canceled.
The user cannot perform the selected operation while
accessing another users data.

Chapter 2. ANS 0000-9999 messages 341

Explanation Explanation
This operation can not be completed because a You tried to back up or migrate a file that is implicitly
restartable restore session is pending. The operation is excluded.
not allowed because the restartable session and the
current operation affect the same file space. System action
IBM Spectrum Protect will not back up or migrate an
System action
implicitly excluded file.
IBM Spectrum Protect ended the current operation.
User response
User response
None.
Issue the Query Restore command to view a list of
ANS5155E The valid password is not
your restartable restore sessions in the server
available. The IBM Spectrum
database. Issue the Cancel Restore command to
Protect administrator for your
cancel any unneeded restartable restore sessions.
system must run IBM Spectrum
ANS5152S Session Rejected: The server is not Protect and enter the password to
licensed for this platform type. store it locally.
See your IBM Spectrum Protect
administrator. Explanation
The file containing the stored password for the
Explanation
specified server is unavailable.
The server license governs the types of client that can
connect to it. The license for this server does not System action
include the requesting client type.
Process ends.
System action
User response
The client enrollment or connection request ends.
The system administrator for your system must set
and store a new password.
User response
ANS5158S Filespace deletion is in progress.
See your IBM Spectrum Protect administrator who
must upgrade the server license to accept your client Try again later.
type.
Explanation
ANS5153E Session Rejected: The server does
not allow a signon as a Unicode The filespace is in the process of being deleted.
enabled client.
System action
Explanation IBM Spectrum Protect cannot complete the requested
The client cannot establish a connection to the server operation.
because of a unicode enabling mismatch between
server and client. User response
Try the operation again later. If the filespace was
System action being deleted, it could take awhile for it to complete. If
Session was not started. the problem continues, report the problem to your
system administrator.
User response ANS5164E Backup or archive of drives with
See your system administrator immediately. duplicate volume labels is not
allowed.
ANS5154I File is implicitly excluded
Explanation
You tried to back up or archive a drive that has a
duplicate volume label. Because IBM Spectrum

342 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Protect uses the volume label to keep track of backup Explanation
or archive information, it cannot back up or archive
Conflicting options SESSIONINIT=serveronly and
files from a drive with a duplicate volume label.
DEDUPLICATION=yes were specified. This
combination is not allowed.
System action
IBM Spectrum Protect cannot select the drive for System action
backup or archive operations.
Processing stops.

User response
User response
If the volume needs to be available to the system, exit
Use client-initiated sessions or disable client-side
IBM Spectrum Protect and assign a unique volume
deduplication
label to the drive. Restart IBM Spectrum Protect and
try the operation again. ANS5178E Restart of the RSM service failed.
Restart the RSM service manually.
ANS5165E Drive has no volume label.
Backup/Archive not allowed.
Explanation
Explanation RSM database files have been restored from the IBM
Spectrum Protect server and imported. The client has
You tried to backup or archive a drive that has no
tried to restart the RSM service on the user's behalf
volume label.
but has run into a problem.

System action
System action
IBM Spectrum Protect rejected the selected drive.
Processing stopped.

User response
User response
If the drive is a floppy drive, place a disk with a volume
Restart the RSM service manually.
label in it and retry the operation. If the disk is a hard
drive, ensure the drive has a volume label, and retry ANS5179E Client is unable to continue.
the operation. Exiting program.
ANS5176W The requested virtual machine
operation cannot be performed Explanation
because a virtual machine backup Client ran into a problem and is unable to continue.
or restore operation is already in This error message is usually preceded by other error
progress. Please retry the messages. Resolve those errors and try again.
operation after the first operation
completes.
System action

Explanation Program terminates.

A virtual machine operation is already in progress, so

User response
the requested virtual machine operation cannot be
performed until the first operation complets. Fix the problem(s) that preceded this message and
then restart the client.
System action ANS5181E Invalid selection; A specific
Processing stops backup set must be selected.

User response Explanation

Wait for the first virtual machine operation to A selection was made that might result in multiple
complete, and then restart the current request. backup sets being restored at the same time, but
restoring multiple backup sets at the same time is not
ANS5177E Client-side deduplication and supported.
server-initiated sessions are
mutually exclusive.

Chapter 2. ANS 0000-9999 messages 343

System action ANS5186E Server is downlevel, System
Services and System State backup
The backup set restore was not performed.
disabled for this session.

User response
Explanation
Select a specific backup set to be restored.
The operation cannot be performed because server
ANS5182E Multiple backup sets can not be version is downlevel.
restored at the same time.
System action
Explanation
System Service and System State backup is disabled
Multiple backup sets were selected to be restored, but for this session.
restoring multiple backup sets at the same time is not
supported. User response
Must use level 5.2.0 or higher server.
System action
ANS5187E Unable to set SHAREAS extended
The backup set restore was not performed.
attribute for file:
'pathname'
User response Return code: 'returncode' 'strerror'
Select a specific backup set to be restored. Reason code: 'reasoncode'

ANS5183W Objects of different types cannot

Explanation
be restored at the same time.
You must be the file owner or have superuser
Explanation authority.

Restoring objects of different types is not allowed. For

System action
example, restoring Backup Sets and regular file
objects at the same time is not possible. File processed without setting attribute.

System action User response

No processing takes place. The attribute must be set manually.
ANS5188E Periodic Full plus Incremental VM
User response backups have been deprecated.
Select objects of the same type to perform restore Please use Incremental Forever
operation. Full or Incremental Forever
Incremental to perform virtual
ANS5184E Illegal Operation On Following machine backups.
Object: object
Explanation
Explanation
Periodic Full plus Incremental virtual machine
Requested operation cannot be performed on this backups have been deprecated.
object.
System action
System action
Processing stops
This object will be skipped.
User response
User response
Restart the virtual machine backup and use
Try another operation on this object, or try the same Incremental Forever Full or Incremental Forever
operation on another object. Incremental instead for the backup mode.
ANS5189E Online SystemState restore has
been deprecated. Please use

344 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 offline WinPE method for User response
performing system state restore.
Start Certificate Services and try the operation again.

Explanation ANS5194E Certificate Services is online.

Online restore is not supported.
Online SystemState restore has been deprecated.
Explanation
System action
Certificate Services is online when performing a
Processing stops restore operation. Online restore is not supported.

User response System action

Perform the system state restore using offline WinPE Processing stopped.
method.
ANS5191E NT Active Directory is not online. User response
Offline backup is not supported.
Stop Certificate Services and try the operation again.

Explanation ANS5196W Invalid encryption key password

entered.
NT Active Directory is not online when performing a
backup operation. Offline backup is not supported.
Explanation
System action The encryption key password supplied does not meet
the IBM Spectrum Protect requirements. This key can
Processing stopped. be up to 63 bytes in length and include the following
characters: A-Z Any letter, A through Z, uppercase or
User response lowercase 0-9 Any number, 0 through 9 + Plus . Period
Reboot computer and turn on Active Directory, and try _ Underscore - Hyphen & Ampersand
the operation again.
System action
ANS5192E NT Active Directory is online.
Online restore is not supported. IBM Spectrum Protect allows you to try again.

Explanation User response

NT Active Directory is online when performing a Enter the correct encryption key password.
restore operation. Online restore is not supported. ANS5201E The specified function is not
implemented
System action
Processing stopped. Explanation
The specified function is not implemented.
User response
Reboot computer and enter Active Directory repair System action
mode, then try the operation again. Processing stopped.
ANS5193E Certificate Services is not online.
Offline backup is not supported. User response
Correct the command and retry the operation.
Explanation
ANS5202I One or more system objects were
Certificate Services is not online when performing a excluded from processing by
backup operation. Offline backup is not supported. entries in the include-exclude list.

System action
Processing stopped.

Chapter 2. ANS 0000-9999 messages 345

Explanation User response
One or more system objects were excluded from Examine the Windows 2000 File Replication Service
processing by entries in the include-exclude list and Event log to insure the system volume was
the client did not process them. successfully initialized. Restart the service and retry
the backup operation
System action ANS5210E System Volume restore failed.
Excluded objects skipped.
Explanation
User response IBM Spectrum Protect encountered an error while
None. restoring files of the Windows 2000 System Volume

ANS5204W Only one backup set may be

System action
selected for restore.
Processing stopped.
Explanation
User response
Restoring multiple backup sets is not allowed. Only
one backup set may be selected and restored. Examine the Windows 2000 File Replication Service
Event log to insure the system volume was
System action successfully initialized. Restart the service and retry
the restore operation.
No processing takes place.
ANS5211E The cluster service is offline. The
User response cluster service must be online to
perform an authoritative cluster
Only one backup set may be selected for restore. database restore operation.
ANS5208E An invalid date or time was
entered. Explanation
The cluster service must be online to restore the
Explanation cluster database. IBM Spectrum Protect tried to start
the service and failed. It is possible that an
An invalid date or time value was entered. Either the
authoritative restore cannot be done.
syntax of the value was not correct, or an actual value
(for example, "45" for month) was invalid.
System action
System action Processing stops.
Processing stops.
User response
User response Start the cluster service and retry the operation.
Identify and correct the invalid date or time value. ANS5212E An error occurred while trying to
Refer to the user's guide of the corresponding platform rename file space.
for the correct date syntax.
ANS5209E System Volume backup failed. Explanation
This operation can not be completed because the file
Explanation space could not be renamed.
IBM Spectrum Protect encountered an error while
backing up files of the Windows 2000 System Volume System action
IBM Spectrum Protect ended the current operation.
System action
Processing stopped. User response
Contact system administrator for more information.

346 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS5215E function-type is not allowed on User response
object 'object'. Use the DSMC QUERY SESSION command to verify
Object is not sent to the server. your authorization. Ask your IBM Spectrum Protect
administrator to provide the necessary authorization.
Explanation
ANS5219W Objects of different groups cannot
The operation could not be performed on this object. be restored at the same time.
For example, if this is an image operation, the selected
path is a file or a directory and therefore is not a valid
Explanation
object for image operations.
Restoring objects of different groups is not allowed.
System action
System action
This object is skipped.
No processing takes place.
User response
User response
Verify that the object named is of a type supported by
the command. For example, if a filespace name is Select objects of the same group to perform restore
required but a directory name was given, change the operation.
name so it includes only the filespace name.
ANS5222E The archive description exceeds
ANS5216E Could not establish a TCP/IP 254 characters.
connection with address 'tcp-
addr:tcp-port'. The TCP/IP error is Explanation
'tcp-err-string' (errno = errno).
IBM Spectrum Protect places a maximum length of
254 characters on the archive description.
Explanation
A TCP/IP connection was attempted with a server or System action
agent program and failed.
processing stops.
System action
User response
Processing stops.
Issue the command again and specify a shorter valid
archive description.
User response
ANS5224W Error error code encountered while
Ensure that the target TCP/IP address and port
number is correct. Check to ensure that a IBM reverting to the restored snapshot.
Spectrum Protect server or agent has been started at
the target TCP/IP address and is configured to listen at Explanation
the port listed in the message. After the virtual machine disks are restored, the virtual
ANS5217E Your node does not have machine is reverted to the restored state. The
permission to delete backed up specified error was encountered while performing this
files. revert operation.

Explanation System action

You cannot delete backed up files unless your IBM Processing continues
Spectrum Protect administrator has authorized your
node to do so. User response
Try powering on the restored virtual machine. If it fails
System action to start, re-try the restore process.
IBM Spectrum Protect does not delete the backed up ANS5225W Error error code encountered while
files. removing the restored snapshot.

Chapter 2. ANS 0000-9999 messages 347

Explanation Explanation
After the virtual machine disks are restored, the virtual During a parallel backup operation, concurrent backup
machine is reverted to the restored state, and the sessions required additional server mount points to
snapshot is removed. The specified error was perform the backups in parallel. The client attempted
encountered while removing the snapshot. to obtain the additional mount points, but the client
requests exceeded the number of mount points
System action (MAXNUMMP) defined for the node. In an effort to
make the backup occur, the client reduced the
Processing continues VMMAXPARALLEL option to 1, but was still unable to
obtain a mount point. The backup operation was
User response stopped.
Try powering on the restored virtual machine. If it fails
to start, re-try the restore process. System action

ANS5226E The virtual machine backup The backup operation was stopped
operation failed.
User response
Explanation Check the console or schedule log for additional
The virtual machine backup operation failed. Check information. Retry the operation at a later time. Ensure
the error log for details on why the operation failed. VMMAXPARALLEL is set to a value less than or equal to
MAXNUMMP.
System action ANS5229E The Snapshot is already mounted
for backup 'backup-name'.
Processing stops

Explanation
User response
The Snapshot is currently mounted on the local
Review the console output and error logs for the
machine or a remote machine. No mount operation on
details on the problem. Fix any issues and restart the
the snapshot will be allowed until it has been
operation.
unmounted.
ANS5227E IBM Spectrum Protect detected an
error where both a snapshot name System action
was specified, and a request to
create a snapshot were specified. Processing stops

Explanation User response

Either a snapshot name should be specified, or a See the dsmerror.log file for further details.
request for IBM Spectrum Protect to create the ANS5230E The Snapshot is already imported
snapshot should be specified, but not both. to the local system for backup
'backup-name'.
System action
Processing stops. Explanation
The Snapshot is currently imported on the local
User response machine. This maybe becasue the Snapshot is in use
or it was not created with the Import VSS snapshots
This is an internal error and should be reported to your
only when needed feature enabled.
service representative.
ANS5228E A backup VM operation failed System action
because VMMAXPARALLEL was
reduced to 1 and the client still Processing stops
cannot obtain a server mount
point. User response
Remote Mount operation not allowed on snapshots
that are currenlty imported.

348 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS5231E VMDK size reported by VMware persists, contact your
vSphere API is different than administrator.
actual size of vmdk file. Reissue
the restore command with the Explanation
testflag -
VMRESTORE_INCVMDKSIZE. The virtual machine is powered off or the Windows
domain administrator credentials is not correct.
Explanation
System action
VMDK size reported by VMware vSphere API for virtual
machine configuration is different than actual size of Processing stops.
vmdk file. This can be the result of running a storage
alignment tool on vmdk files before backup. User response
Ensure that the virtual machine is powered on. Use
System action dsmc SET PASSWORD -type=DOMAIN 'domain
Restore processing stops. \userid' 'password' to update the Windows
domain credentials. Then, try the operation again.
User response ANS5235E The virtual machine cannot be
reached or a firewall is blocking
Reissue the restore command with the testflag -
the connection to the machine.
VMRESTORE_INCVMDKSIZE.
ANS5232I The virtual machine backup Explanation
operation was skipped.
The file restore interface cannot reach the virtual
machine or a firewall is blocking the connection.
Explanation
The virtual machine backup operation was skipped. System action
Check the error log for details on why the operation
was skipped. Processing stops.

System action User response

Processing of the virtual machine is skipped Ensure that the virtual machine is powered on. If the
virtual machine is powered on, review the firewall
rules to ensure that the correct ports are opened. Also
User response ensure that the virtual machine host name and TCP/IP
Review the console output and error logs for the address are resolving in the DNS server and there are
details. no network issues.

ANS5233E The directory cannot be found in ANS5236E You do not have permission to
the specified backup. The top- restore the file to the destination
level directory is displayed. folder.

Explanation Explanation
An invalid or unreachable directory path was specified. The user does not have permission to restore files to
the selected destination.
System action
System action
The top-level directory is displayed instead.
Processing stops.
User response
User response
Select a valid directory and change the backup again.
Ensure that the user has proper permissions to restore
ANS5234E The system cannot connect to the files to selected location.
virtual machine or the machine is
powered off. If the problem ANS5237E File Restore is not set up correctly
or the virtual machine cannot be

Chapter 2. ANS 0000-9999 messages 349

 reached. Contact your Explanation
administrator for assistance.
Some Linux machines have a limited number of loop
devices. For file restore operations of a local snapshot,
Explanation it is required that each Linux proxy machine have a
The user is unable to log in to the file restore interface free loop device for each volume to mount.
due to one of the following reasons:
System action
• The configuration of File Restore is incorrect
because the Windows domain credentials do not The file restore operation stops.
have the correct permissions.
• The virtual machine is powered off or a firewall is User response
blocking the connection. Increase the number of loop devices on the Linux
• A network issue. mount proxy machine or install the Linux mount proxy
on a Linux distribution where the number of loop
System action devices is not limited.

Processing stops. ANS5240E Setting up device mappings for the

disk flat file 'flat file' by using the
User response kpartx command on the Linux
mount proxy machine failed with
The administrator can take the following actions to rc 'rc'.
correct the problem:
• Ensure that the Windows domain credentials Explanation
provided in the configurations notebook has the
A failure occurred trying to create devices with the
correct permissions to connect to the virtual
Linux utility command kpartx.
machine.
• Ensure that the virtual machine is powered on and System action
any firewall has been updated to allow connections
from the mount proxy machine. The file restore operation stops.
• Ensure that the mount proxy machine is able to
connect to the virtual machine manually to ensure User response
there is no networking issue. Check that the kpartx Linux command is working
ANS5238E Cannot get list of Linux block correctly on the Linux mount proxy machine.
devices on the Linux mount proxy ANS5241E Mounting block device
machine. 'device_name' to 'mount-point'
failed with rc 'rc'.
Explanation
The Linux command blkid to get the list of block Explanation
devices fails. A file restore operation was unable to mount the
original block device on the Linux mount proxy. The
System action mount command on the Linux mount proxy produced
an unexpected error and the related block device was
The operation stops.
not mounted. The specified volume was skipped.

User response
System action
Check that the blkid Linux command is working
File restore operations continue with the next device.
correctly on the Linux mount proxy machine.
ANS5239E Cannot add the disk flat file 'flat User response
file because no free loop devices
are available on the Linux mount Update the Linux mount proxy OS. This behavior has
proxy machine. been observed with LVM on a guest machine with
Redhat 7.3 and Redhat 6.5 on the mount proxy.

350 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS5242E Assembling the RAID device Explanation
'device' failed with rc 'rc'. Refer to product manual for more information about
the TCPWINDOWSIZE option.
Explanation
A failure occurred trying to assemble a RAID device on System action
the Linux mount proxy.
The operation continues with the maximum value
allowed by IBM Spectrum Protect.
System action
Marking device as 'mount_failed' and continuing the User response
file restore operation. Set TCP window size to a value in the allowable range.

User response ANS5246W TCPWINDOWSIZE optionCur is

specified, but exceeds the
Check the consistency of the RAID device. maximum value allowed by the
ANS5243E Activating LVM device number operating system.
'device-number' failed with rc 'rc'. TCPWINDOWSIZE optionNew will
be used instead.
Explanation
Explanation
A failure occurred trying to activate LVM device on the
Linux mount proxy. The specified value is within the range allowed by IBM
Spectrum Protect, but the operating system restricts
the value to something less.
System action
Marking device as 'mount_failed' and continuing the System action
file restore operation.
The operation continues with the maximum value
allowed by the operating system.
User response
Check the consistency of the LVM device. User response
ANS5244E It is not possible to detect the Set TCP window size to a value allowed by the
original mount points because the operating system.
etc path cannot be found in any
mounted volumes. ANS5247E The configuration for File Restore
is not complete. Contact your
administrator for assistance.
Explanation
To detect the original mount points, it is required to Explanation
read the fstab and mtab files that are present in the
etc path. The user is unable to log in to the file restore interface
because the Windows domain credentials are missing.
System action
System action
The file restore operation continues.
Processing stops.
User response
User response
Check that the original virtual machine guest has a
valid etc path. The administrator must provide the Windows domain
administrator credentials in the File Restore page of
ANS5245W TCPWINDOWSIZE optionCur is the configuration notebook in the Data Protection for
specified, but exceeds the VMware vSphere GUI.
maximum value allowed by IBM
Spectrum Protect. ANS5248E It is not possible to detect the
TCPWINDOWSIZE optionNew will original mount points because the
be used instead. original virtual machine guest file

Chapter 2. ANS 0000-9999 messages 351

 system information cannot be Explanation
read. rc='rc'.
IBM Spectrum Protect was not able to take a snapshot
because the snapshot provider is not available.
Explanation
To detect the original mount points, it is required to System action
read the fstab file that is present in the etc path.
Processing stopped.

System action
User response
The file restore operation continues.
If you are attempting an operation using the Microsoft
Volume Shadow Copy service make sure that Volume
User response Shadow Copy service is installed on the system and
Check that the original virtual machine guest has a also ensure that the IBM Spectrum Protect snapshot
valid fstab file. plugin "pivss.dll" is present.

ANS5249E The virtual machine restore ANS5252E IBM Spectrum Protect attempted
operation failed. to execute a system command
which failed.
command : command
Explanation
rc : rc
The virtual machine restore operation failed. Check the
error log for details on why the operation failed. Explanation
IBM Spectrum Protect needed to execute a system
System action
command in conjunction with a snapshot operation.
Processing stops
System action
User response
Processing stops.
Review the console output and error logs for the
details on the problem. Fix any issues and restart the User response
operation.
See your system administrator.
ANS5250E An unexpected error was
encountered. ANS5253W The system could not create
IBM Spectrum Protect function Volume Shadow Copy Services
name : function-name staging directory 'dir'.
IBM Spectrum Protect function :
function-desc Explanation
IBM Spectrum Protect return
The system was unable to create a user-specified
code : TSM-rc
location for the Volume Shadow Copy Services staging
IBM Spectrum Protect file : file-
area. The default staging area on the system drive will
name (line-number)
be used instead.

Explanation
System action
None.
Processing continues.

System action
User response
Processing stops.
Check the option to specify the staging area for
Volume Shadow Copy Services operations and specify
User response a valid location.
Contact the IBM Spectrum Protect administrator with ANS5254E The Volume Shadow Copy Services
the information provided in this message. snapshot plugin 'pivss.dll' was not
ANS5251E The snapshot provider is not found.
available for this operation.

352 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation • For off-load backup requests, the provider does not
support transportable media
The system cannot find the VSS snapshot plugin
'pivss.dll' in any of the plugin locations. • For local backup requests, the provider does not
support persistent snapshots
System action • For backup requests of Hyper-V virtual machines
that are located on the volume with a Cluster Shared
Processing stops. Volume File System and the
VSSUSESYSTEMPROVIDER option is set to YES
User response
Check the IBM Spectrum Protect installation to ensure System action
the plugin was installed correctly. Processing stops.
ANS5255E Unable to copy local file 'local-file'
to remote location 'remote-file'. User response
Try the backup again, and use a supported backup
Explanation destination. If you are backing up Hyper-V VMs and
An attempt to transfer a file to a remote system failed.. the VSSUSESYSTEMPROVIDER option is set to YES, try
the operation again, with the
VSSUSESYSTEMPROVIDER option set to NO.
System action
Processing stops. ANS5258E Microsoft volume shadow copy
snapshot initialization failed.
User response
Explanation
Ensure that the directory path on the remote system
exists and that the IBM Spectrum Protect application IBM Spectrum Protect encountered an error while
has the proper authority to write to that location. initializing the Microsoft Volume Shadow Copy Service
for backup or restore. The IBM Spectrum Protect error
ANS5256W Cannot find the original mtab file. log and Windows event log can contain additional
information about this error.
Explanation
System action
To detect the original mount points, it is required to
read the original mtab information. In some Linux IBM Spectrum Protect stops the operation.
distributions, the mtab file could be a symbolic link to /
proc/self/mounts that could interfere with the Linux User response
mount proxy.
Try the operation again. If the error persists, review
the IBM Spectrum Protect error log and Windows
System action
event log for information related to this error. Use the
The file restore operation continues. Windows command VSSADMIN LIST WRITERS to
determine the status of the Volume Shadow Copy
User response service. Reboot the machine to clear the volume
shadow copy error state. If the system is a Domain
Check that the original virtual machine guest has a Controller and the Active Directory service is stopped,
valid mtab file. restart the Active Directory service.
ANS5257E The volume 'volume' does not ANS5259W Failed to update volume 'volume'
support the requested VSS for read-write access used for
operation. 'volume'.

Explanation Explanation
The volume does not support the requested VSS Changing the volume to read-write access requires
operation. Some reasons for this error include the exclusive access to the volume. If the volume is
following conditions: opened by any application, this operation will fail.
• For off-load backup requests, a hardware provider
cannot be found

Chapter 2. ANS 0000-9999 messages 353

System action Explanation
Processing continues. Snapshot restore is not possible due to an error at this
time. IBM Spectrum Protect will automatically fail over
User response to other restore method to complete the restore
operation.
Close all the applications using the volumes and use
operating system's interface to mount failed volume
System action
for read-write access.
Processing continues.
ANS5260W Restore object 'volume' has
volume either source 'volume' or
target 'volume' volume that has User response
already been selected for restore Check the error log for more information from
from a different snapshot messages preceding this one to identify the error
volumes. It will be restore using condition.
file-level copy.
ANS5263E Snapshot module for 'snapshot
provider' failed with error 'error
Explanation
msg'.
This error can occur when multiple objects are
selected for snapshot restore and have data Explanation
overlapping on the volumes and were selected for
restore from different backup versions. Snapshot The snapshot module for identified snapshot provider
restore can only be performed from one local backup. failed to perform the operation and returned with the
identified error.
System action
System action
The restore object identified in the message will be
restored using the file-level copy after snapshot Restore may automatically failover to alternate restore
restore is completed. method 'file-level copy from snapshot volume' if
possible. Otherwise, processing stops.
User response
User response
Retry the restore of identified object separately for
faster restore using snapshot. Check the error log for more information from
messages preceding this one. Use snapshot provider
ANS5261W An attempt to create a snapshot interface to identify and correct the problem.
has failed.
Another attempt will be made to ANS5264W No snapshot plugin found for
create the snapshot in number 'snapshot provider' snapshot
seconds. provider.

Explanation Explanation

An attempt to create a snapshot has failed with a The snapshot restore requires a plugin for the
retryable error. The program will wait for a short time specified snapshot provider type. The plugin must be
and retry the operation. installed under IBM Spectrum Protect directory.

System action System action

None. Restore will failover to alternate restore method of

'file-level copy from snapshot volume'.
User response
User response
Check the IBM Spectrum Protect error logs for
additional information. Contact your IBM Spectrum Protect administrator to
obtain and install the required plugin module.
ANS5262I Snapshot restore will failover to
file-level copy from snapshot ANS5265W Snapshot restore has already been
volume. initialized using 'snapshot

354 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 provider' provider module. Another ANS5268W The Microsoft Volume Shadow
module for 'snapshot provider' Copy Services writer 'name'
provider can not be loaded at the current state (state) is not valid for
same time for restore of 'object the current operation.
name'.
Explanation
Explanation
None.
This error occurs when restoring multiple LOCAL
backup objects that were created using different System action
snapshot providers. Snapshot restore can only be
done using one snapshot interface. 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
System action
writer is still in the incorrect state, the operation will
Restore will failover to file-level copy restore from fail.
snapshot volume.
User response
User response
Determine if there are other Volume Shadow Copy
If snapshot restore is desired for the object identified Services operations that are occurring concurrently
in the message, restore it using a separate command. with the current operation.
ANS5266E File-level copy restore of 'object ANS5269E The Microsoft Volume Shadow
name' failed. Copy Services writer 'name'
current state (state) is not valid for
Explanation the current operation or cannot be
determined. The last error
Data files could not be copied from the local backup to reported is 'error'.
their destination, causing restore to fail.
Explanation
System action
None.
Processing continues to another object, if multiple
objects are selected for restore.
System action

User response Processing stops.

Check the error log for more information from

User response
messages preceding this one.
Check the Microsoft event log to determine if there are
ANS5267E Disk Mapper module failed for the
any problems with the writer.
operation.
ANS5270E A VSS restore request with
Explanation timestamp 'time1' conflicts with a
restore request with timestamp
An underlying IBM Spectrum Protect operation has 'time2'
failed to perform the operation due to a system error.
Explanation
System action
A VSS restore request was issued which requires
Processing stops. restoring multiple components which reside in VSS
backup documents with different backup timestamps.
User response For example, a user backs up Exchange storage group
Check the error log for more information from STG1 on Monday and Exchange storage group STG2 on
messages preceding this one to identify cause of the Tuesday. On Wednesday, the user tries to restore
failure. Contact IBM Spectrum Protect administrator STG1 and STG2.
for more information.

Chapter 2. ANS 0000-9999 messages 355

System action Explanation
Processing stops. None.

User response System action

Resubmit the restore request as separate requests for Processing stops.
each component. For example, if you receive this error
trying to restore Exchange storage groups STG1 and User response
STG2, resubmit a restore request for storage group
STG1 and a separate restore request for storage group See the error log for additional information.
STG2. ANS5274E A Microsoft Volume Shadow Copy
ANS5271E A Microsoft Volume Shadow Copy Services writer is in an invalid
Services writer is in an invalid state after backup completion.
state before snapshot
initialization. Explanation
None.
Explanation
None. System action
Processing stops.
System action
Processing stops. User response
See the error log for additional information.
User response
ANS5275E A Microsoft Volume Shadow Copy
See the IBM Spectrum Protect error logs for additional Services writer is in an invalid
information. state before restore initialization.
One of the VSS writers is in an invalid or unexpected
state. Try the command "vssadmin list writers" and Explanation
check the state of VSS writers. Writers must be in
STABLE state before IBM Spectrum Protect can None.
continue with VSS operations. Some of the writers can
recover automatically from minor errors. In most System action
cases, restarting a writer solves the problem. The Processing stops.
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 User response
determine which service to restart. See the error log for additional information.
ANS5272E A Microsoft Volume Shadow Copy ANS5276E A Microsoft Volume Shadow Copy
Services writer is in an invalid Services writer is in an invalid
state after snapshot initialization. state after preparing for a restore
operation.
Explanation
Explanation
None.
None.
System action
System action
Processing stops.
Processing stops.
User response
User response
See the error log for additional information.
See the error log for additional information.
ANS5273E A Microsoft Volume Shadow Copy
Services writer is in an invalid
state after taking a snapshot.

356 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS5277E A Microsoft Volume Shadow Copy Explanation
Services writer is in an invalid For more information, see the IBM Spectrum Protect
state after restore termination. client error log. This message is always accompanied
by error log message ANS5279E if the object was not
Explanation found or by ANS5250E for other causes, for example,
None. access was denied. These messages identify the
object in question.
System action
System action
Processing stops.
Processing stopped.
User response
User response
See the error log for additional information.
See the user response based on other messages in the
ANS5278W Cannot detect all the original client error log.
mount points because the number
of standard devices mounted ANS5281E A remote backup failure has
'device-number' is different than occurred.
the number of standard devices remote node name : node
found in fstab and mtab files remote address : address
'device-number'. multi-node name : multi-node
error message : msg return code :
rc
Explanation
This is a requisite for the recognition of the standard Explanation
devices.
For more information, see the IBM Spectrum Protect
client error log on the remote system.
System action
The file restore operation continues. System action
Processing stopped.
User response
Check that the devices are correct in the fstab and User response
mtab of the virtual machine guest.
See the user response based on other messages in the
ANS5279E Error processing 'filename': file not client error log.
found.
ANS5282E A remote backup failure has
occurred.
Explanation
The file being processed for backup, archive, or Explanation
migrate, no longer exists on the client. Another
process deleted the file before it was backed up, For more information, see the IBM Spectrum Protect
archived, or migrated by IBM Spectrum Protect. client error log.

System action System action

Processing stops. Processing stopped.

User response User response

None. See the user response based on other messages in the

client error log.
ANS5280E Object enumeration from a file set
or file list failed. ANS5283E The operation was unsuccessful.

Explanation
None.

Chapter 2. ANS 0000-9999 messages 357

System action does not have the VSS fixes applied and the system
state backup files were created by an operating
Processing stopped.
system level that did have the VSS fixes applied.

User response
System action
See the user response based on other messages in the
Processing stops.
client error log.
ANS5284I IBM Spectrum Protect has User response
detected an incomplete setup!
The client options file 'dsm.opt' The restore procedure for Windows system state
was not found, while the system requires that the operating system version and service
options file 'file-path' exists! pack level used to initiate the restore be at the same
The wizard will guide you through operating system and service pack level used to create
the configuration process of the the system state backup. In addition note the
initial basic IBM Spectrum Protect following:
client options files replacing your • On Windows 2003 systems you must also apply the
current option file. Would you like VSS rollup package KB940349 prior to performing
to continue? the Ssystem state restore.
• On Windows Vista you must apply the same service
Explanation pack that was installed at the time of backup prior to
IBM Spectrum Protect has detected an incomplete performing the system state restore.
setup. The user options file, dsm.opt, was not found. ANS5286I The VSS Instant Restore operation
Additionally, a system options file, dsm.sys, was was successful but some existing
found. To complete the configuration the configuration VSS snapshots have been deleted
wizard will create dsm.opt and replace dsm.sys with by the VSS provider.
minimal settings.
Explanation
System action
A successful VSS Instant Restore operation was
IBM Spectrum Protect may stop performed for snapshot volumes that were in a
dependent relationship. In order for the restore
User response process to succeed, it was necessary to remove the
If the current version of dsm.sys is needed, rename snapshot volumes causing the dependency. Those
the file and restart IBM Spectrum Protect. If the snapshot volumes typically represent newer snapshot
current version is not needed, select yes and allow backups. This forced IBM Spectrum Protect to remove
IBM Spectrum Protect to replace the file. the backups that included the deleted snapshots. This
situation is typical when using SAN Volume Controller
ANS5285E The Microsoft Volume Shadow (SVC) space-efficient volumes that have multiple
Copy Services (VSS) backup XML snapshots.
document is not valid for restore.
For more information, see the System action
client error log.
Processing continues.
Explanation
User response
Microsoft has released a Volume Shadow Copy
Services (VSS) update in the following operating None.
system versions: ANS5287W VSS restore operation will be
• Windows 2003 update rollup package KB940349 performed using VSS Fast Restore
because the XIV VSS Hardware
• Windows Vista Service Pack 1
Provider is at level 2.2.2.
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

358 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS5290W Devices of type 'device_type' are
not supported. Skipping device
XIV VSS Hardware Provider 2.2.2 has issues with VSS
'device_name'.
Instant Restore. Please update the XIV VSS Hardware
Provider to version 2.2.3, or later.
Explanation
System action The device detected is not supported.
Processing continues.
System action
User response The device for the target virtual machine is not
mounted. The operation continues.
Update XIV VSS Hardware Provider to version 2.2.3, or
later.
User response
ANS5288W Test flag DISCARDZEROFILEDATA
enabled. Discarding data for zero Use a different type of device on the guest machine.
length object file-name Only ext2,ext3,ext4,xfs, btrfs and reiserfs are
supported devices.
Explanation ANS5291E An error occurred while
attempting to delete the
During the restore of a zero length file or directory,
temporary linked clone virtual
data was decompressed. This data could be Extended
Attributes, Alternate Streams, or ACL data. By default machine 'linked clone name'
this data is restored. Because the (rc=return code). Check if this
DISCARDZEROFILEDATA test flag is set the data is virtual machine still exists and
discarded. delete it manually.

System action Explanation

The data is discarded and processing continues It was not possible to delete the linked clone virtual
machine. This temporary virtual machine was created
for file restore purposes to mount a local snapshot.
User response This virtual machine may have been manually
Note the file or directory name in this message and renamed, or accidentally modified or deleted.
determine if the discarded data needs to be reset
through some other means. System action
ANS5289W The sequence of the devices is not The file restore cleanup operation continues.
correct and it is not possible to
identify all the original mount User response
points. The volume 'volume' is not
consistent. The detection of the Check if this virtual machine still exists and delete it
original mount points is stopped. manually.
ANS5292E A valid password file was not
Explanation found for server 'server-name'. The
The correct order of the devices is required for the administrator for your system
recognition of the standard devices. must run the backup-archive
client and enter the password to
store it locally. Additionally, the
System action administrator needs to give the
The detection of the original mount points is stopped. non-administrative user read
The file restore operation continues. access to the password file.

User response Explanation

Check that the devices are correct in the fstab and The file containing the stored password for the
mtab files of the virtual machine guest. specified server server-name is unavailable.

Chapter 2. ANS 0000-9999 messages 359

System action readable by the current user or to give the current user
read/write permissions to the password file.
Processing ends.
ANS5296I The virtual machine 'vm-name'
User response contains one or more virtual disks
that are of type Thick Eager Zero.
The administrator for your system must set and store a Creating disks of this type can
new password and make the password file readable by take a long time. This restore
the non-administrative user. operation might time out before
ANS5293E A valid password file was found the disks are ready.
for server 'server-name', but it
does not have read access granted Explanation
to non-administrative users. The
Restoring a VM that has Thick Eager Zero virtual disks
administrator for your system
can take a long time to complete because the disks are
needs to change the password
zero-filled to obscure any previous content. The time
files to allow non-administrative
that is required to provision a Thick Eager Zero disk
users to read the files or the user
depends on processing loads on the VMware
needs to become an authorized
resources (vCenter and datastores).
user.

System action
Explanation
None
The file containing the stored password for the
specified server server-name is not readable by non-
administrative users. User response
Reattempt the restore operation at a time when the
System action processing load is light on the datacenter and vCenter
resources
Processing ends.
ANS5298E A Flashcopy background copy is in
User response progress between source volume:
and target volume: .
The administrator for your system must set the
password files to be readable by the non-
administrative user. Explanation
A Flashcopy background copy from a previous
ANS5294E The current user is not an IBM
operation is not complete for the given source and
Spectrum Protect Authorized user.
target volumes.
You must be an IBM Spectrum
Protect Authorized user to
perform the current operation. System action
Command will fail.
Explanation
In order to perform normal IBM Spectrum Protect User response
operations you must be an Authorized user. Please Please wait until the background copy is complete and
refer to the 'IBM Spectrum Protect UNIX and Linux retry the command.
Backup-Archive Clients Installation and User's Guide'
for details configuring your environment to allow the ANS5300E Error detected in specified file list
system user to become an IBM Spectrum Protect 'file list name' during processing of
Authorized user. line line number:
found an invalid external object
System action ID / inode number / inode
generation number / restore order
Processing ends. number / alias entry: 'invalid
entry'.
User response Invalid line: 'invalid entry'
The administrator must update the dsm.sys options
file to set the PASSWORDDIR option to a location

360 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
File list parsing failed because of an invalid entry. IBM Spectrum Protect has processed the specified
number of IBM Spectrum Protect server and file list
System action objects.

The operation aborted because of an file list error.

System action

User response Processing continues.

Correct the invalid file list entry and restart the

User response
operation.
None.
ANS5301E Error detected in specified file list
'file list name' during processing of ANS5304E program-name: synchronous file
line line number: deletion failed for external object
found an invalid ordering of ID: external object ID.
external object IDs.
ext. object ID of previous file: Explanation
previous external object ID
ext. object ID of current file: The HSM client could not delete an object on the IBM
current external object ID Spectrum Protect Server.

Explanation System action

File list parsing failed because of an invalid ordering of The current file is skipped for synchronous file deletion
the external object IDs. and the process will continue.

System action User response

The operation aborted because of an file list error. Check the IBM Spectrum Protect server log file.
ANS5307E The session is rejected. The server
User response does not allow a signon of a client
Correct the invalid file list ordering and restart the that is not enabled for space-
operation. management retention-protection.

ANS5302E File list stream error to file 'file list Explanation

name' detected during processing
of line line number. The client cannot establish a connection to the server
because the server is enabled for space-management
retention-protection and the client is not.
Explanation
File list processing failed because of an stream error. System action
The session is not started.
System action
The operation aborted because of an file list stream User response
error.
See your system administrator.
User response ANS5308W No matching NAS nodes were
Check the specified file list and restart the operation. found on the server.

ANS5303I ***** date Processed count IBM Explanation

Spectrum Protect server and count
file list objects ***** You tried to start a backup or restore of a NAS system
but the IBM Spectrum Protect client was not able to
find a corresponding node on the server that is
configured to access the NAS system.

Chapter 2. ANS 0000-9999 messages 361

System action System action
The NAS backup or restore window will be closed. The object is skipped, a message is logged in
dsmerror.log, and restore processing continues with
User response the next object.

See your IBM Spectrum Protect administrator for

User response
assistance in associating your node with a NAS node
that has the authority to access the NAS system on the The object was skipped because either REPLACE NO
server. Then try the operation again. was in effect, causing all existing objects to be
skipped, or REPLACE PROMPT was in effect, and when
ANS5821E Cannot connect to Active prompted, the user chose to skip this object. No
Directory. additional action is necessary if the decision to skip
the object was deliberate. Otherwise the operation can
Explanation be retried using either REPLACE ALL (automatically
IBM Spectrum Protect could not connect to Active replace existing object) or REPLACE PROMPT (prompt
Directory. The Active Directory is either not running or the user whether to replace the object).
you don't have enough permissions to use it. ANS5824E Invalid Active Directory search
specification.
System action
Processing stops. Explanation
The search specification for Active Directory objects is
User response not valid.
Make sure your system is set up as Active Directory
controller and the the service is active. Make sure you System action
are logged in as a user with sufficient rights to Processing stops.
administer the Active Directory.
ANS5822E No Active Directory objects match User response
query. Refer to the documentation for supported Active
Directory syntax.
Explanation
ANS5825E Reanimate 'tombstone-name' to
A search has been performed in Active Directory; 'distinguished-name' failed. See
however, no objects matching the query were found. the error log for more details.

System action Explanation

Processing stops. An attempt to reanimate Active Directory tombstone
object has been performed, but an error occurred.
User response
Make sure you specify a valid distinguished name of System action
Active Directory object or a container, or a valid Processing continues to process all other tombstone
wildcarded name, and that you have sufficient rights to objects per user's request.
administer the Active Directory.
ANS5823W Object exists, skipping User response
None.
Explanation
ANS5826E Restoring to a read-only domain
The client tried to restore the specified object, but the controller is not allowed.
object already existed in the target restore location
and the user chose not to replace the existing object.
Explanation
An attempt to restore to a read-only domain
controller.

362 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS5830E Restore of object 'tombstone-
name' is not allowed by Active
Processing stops.
Directory.

User response
Explanation
None.
Object of certain types cannot be restored. This is a
ANS5827E A backup copy of the Active system limitation.
Directory database was not found.
System action
Explanation
Processing continues to process all other objects per
An attempt to restore Active Directory objects from a user's request.
database that was not backed up.
User response
System action
None.
Processing stops.
ANS5831E Restore for this object is not
allowed by Active Directory.
User response
Verify the Active Directory was backed up with system Explanation
state.
Object of certain types cannot be restord. This is a
ANS5828E A system state file space was not system limitation.
found on the server. Active
Directory functions can not be System action
executed.
Processing continues to process all other objects per
user's request.
Explanation
An attempt to restore the Active Directory database User response
from a system state backup that does not exist.
None.
System action ANS5832E Reanimate tombstone object
Processing stops. failed. See the error log for more
details.
User response
Explanation
Verify that system state was backed up or back up the
An attempt to reanimate Active Directory tombstone
system state then retry the command.
object has been performed, but an error occurred.
ANS5829E A system state backup on the
specified date was not found. System action
Active Directory functions can not
be executed. Processing continues to process all other tombstone
objects per user's request.
Explanation
User response
An attempt to restore the Active Directory database
from a system state backup that does not exist. None.
ANS5833E This system is a Domain Controller
System action but the Active Directory service is
Processing stops. stopped. You can not perform the
operation unless the Active
Directory service is running.
User response
Verify that system state was backed up on the
specified date or specify a new date.

Chapter 2. ANS 0000-9999 messages 363

Explanation ANS5836W One or more attributes were not
restored. See the error log.
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 Explanation
service is running, it can be in online state or in offline During processing of an Active Directory object, one or
state. When you query or restore Active Directory more object attributes could not be restored.
objects, or back up the system state, the Active
Directory service must be online. When you restore the
System action
system state, the Active Directory service must be
offline (but not stopped). Processing continues to process all other Active
Directory objects per user's request.
System action
User response
Processing stopped.
Check the error log for detailed information on which
User response attribute(s) could not be restored.

If you are querying or a restoring the Active Directory ANS5837W 'object name': attribute 'attribute
objects or backing up the system state, put the Active name' could not be restored.
Directory service in online state by starting the Active
Directory service. If you are restoring the system state, Explanation
put the Active Directory service in offline state by
rebooting to the Active Directory Restore Mode. When The listed attribute could not be restored during
the Active Directory service is in the appropriate state, processing on the Active Directory object.
retry the operation.
System action
ANS5834E Unexpected LDAP error occurred.
See the error log for more details. Processing continues to process all other Active
Directory objects per user's request.
Explanation
User response
An unexpected error occurred during Active Directory
tombstone reanimation. None.
ANS5838E The utility dsamain.exe does not
System action exist on the system. You cannot
Processing continues to process all other tombstone perform the operation unless IBM
objects per user's request. Spectrum Protect can launch this
utility.
User response
Explanation
Check the error log for detailed information on the
LDAP error. You attempted to launch dsamain.exe, but the utility
does not exist.
ANS5835E An LDAP operation returned return
code: 'error string' System action
Processing stopped.
Explanation
An unexpected error occurred during Active Directory User response
tombstone reanimation.
Verify that the dsamain.exe utility exists in the
Windows system32 directory. When you can run the
System action
utility independently of IBM Spectrum Protect, retry
Processing continues to process all other tombstone the operation.
objects per user's request.
ANS5839E The Active Directory object
specification is not allowed.
User response
None.

364 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
You attempted to restore the domain object (starting Object class error violation occurred during tombstone
with "DC="), or you attempted to restore all objects reanimation. This can happen if the Active Directory
("name=*"), or you did not specify anything. schema was modified and is no longer compatible with
the tombstone.
System action
System action
Processing stops.
Processing continues to process all other objects per
User response user's request.

Modify the specification then retry the operation.

User response
ANS5840E The current user is not a member Recreate the failing object manually or restore it from
of the Administrators group, and a backup.
cannot perform this function.
ANS5843E Object class violation.
Explanation
Explanation
You must be a member of the Administrators group to
perform the Active Directory objects function. Object class error violation occurred during tombstone
reanimation. This can happen if the Active Directory
System action schema was modified and is no longer compatible with
the tombstone.
Processing stops.
System action
User response
Processing continues to process all other objects per
Log on with a user who is a member of the user's request.
Administrators group or add this user to the
Administrators group then retry the operation.
User response
ANS5841E Active Directory database could Recreate the failing object manually or restore it from
not be opened. a backup.

Explanation ANS5844E Unable to update password.

An error occurred while opening the restored Active

Explanation
Directory database.
An error occurred during the password update
System action attempt.

Processing stopped.
System action

User response The password is not updated on the server.

Make sure ntdsutil.exe utility is located in the same

User response
directory with IBM Spectrum Protect client
executables. If it doesn't exist, reinstall the client. Try to update the password again.
Verify that the dsamain.exe utility exists in the
ANS5845E Unable to update password
Windows system32 directory. When you can run the
utility independently of IBM Spectrum Protect, retry because the maximum number of
the operation. If the problem persists, contact the update attempts has been
support. exceeded.

ANS5842E 'tombstone-name': object class Explanation

violation.
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

Chapter 2. ANS 0000-9999 messages 365

character requirements for our passwords; or there System action
was a mismatch between the first and second times
IBM Spectrum Protect released the objects that were
the new password was entered.
selected.

System action
User response
The password is not updated.
Continue with normal operations.

User response ANS6586E Recovery Agent operation failed.

• Make sure the original password is entered correctly.

Explanation
Contact your IBM Spectrum Protect administrator for
further assistance if you do not know the original The Recovery Agent operation on a VMVSS snapshot
password. failed.
• Make sure the new password meets the password
length and character requirements. System action
• You will be prompted to enter the new password two Processing stops.
times, so make sure it is entered correctly both
times. User response
ANS5876I SET EVENT Activate Retention Check the Recovery Agent logs and error messages,
completed resolve the problem, and try the operation again.

Explanation ANS6587W VMVSS backup failed to back up

Exchange mailbox history from
The Data Retention ACTIVATE transaction has virtual machine 'VM-Name'.
completed.
Explanation
System action
An error occurred when a data mover tried to back up
IBM Spectrum Protect activated the objects that were the Exchange mailbox history from a virtual machine.
selected. The current version of Data Protection for Exchange
might not support uploading mailbox history at the
User response same time as a virtual machine backup. The error code
indicates the reason for the failure.
Continue with normal operations.
ANS5877I SET EVENT Hold completed System action
Processing continues without backing up the mailbox
Explanation history information.
The Data Retention HOLD transaction has completed.
User response
System action Try to back up mailbox history on guest vm by using
IBM Spectrum Protect held the objects that were Data Protection for Exchange command 'tdpexcc.exe
selected. backup * full /UpdateMailboxInfoOnly'. Upgrade Data
Protection for Exchange if the current product level
does not support mailbox history backup command.
User response
Use traceflags VMTSMVSS in data mover dsm.opt file
Continue with normal operations. to further diagnose the problem.
ANS5878I SET EVENT Release completed ANS6718E The path contains too many
nested subdirectories. The
Explanation maximum number of nested
directories is 1400.
The Data Retention RELEASE transaction has
completed.

366 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Scheduled actions and their corresponding action
number can be found by searching for this message on
To avoid exhausting system resources, the client stops
the IBM Spectrum Protect support site.
processing directory structures that exceed the
maximum nesting depth. Directories that exceed the
maximum nesting depth are not typical. System action
The scheduled action is not performed or queried.
System action
Processing of the current operation is stopped. User response
Search the IBM Spectrum Protect support site for this
User response message to find information about scheduled actions,
their corresponding action numbers and the client
Determine whether the directory is valid. Directory
version at which the action is supported. Then upgrade
structures of this depth are not typical, and could
your IBM Spectrum Protect client to a version that
indicate a problem with the file system structure. An
supports running this action as a scheduled event.
example of such a directory is if the directory is
Until the client is upgraded, you can run the action
cyclical. If the directory is not valid, remove or repair
manually if your version of the client supports it.
the directory, then try the operation again. If the
directory is valid, reduce the depth of the directory ANS7423E Use Set Access backup <vmname>
structure. Then try the operation again. Alternatively -TYPE=VM for VMware backup file
you can use an EXCLUDE.DIR statement to exclude the spaces. Use of the long form fs-
directory from backup or archive processing. Then try name is not allowed.
the operation again.
ANS7421W The archive attribute for file Explanation
filename cannot be reset. The You have chosen to set access using the long-form VM
return code from Windows API file space name. This name format is not platform
function SetFileAttributes() is rc. independent and requires special processing. Use the
-TYPE=VM option and supply only the VM name.
Explanation
The client was unable to reset the archive attribute for System action
the file indicated in the message. This error is due to The set access command is not processed.
an error received from the Windows API function
SetFileAttributes().
User response

System action Enter the set access command using the -TYPE=VM
option and the short form of the VM file space name
processing stops. which is simply the VM name.
ANS7500W Object 'object-name' could not be
User response
bound to management class
Try the operation again. If the problem persists, it may 'mgmt-specified' specified in an
be indicative of a problem with the file. Contact your 'option' statement.
system administrator or IBM Spectrum Protect
administrator for further assistance. Explanation
ANS7422E Unsupported action 'action' in The management class specified in an include
schedule 'schedule name'. statement was not valid. If the include statement is an
"INCLUDE.SIZE" statement the warning message will
Explanation be issued if an appropriate copygroup is defined for
the management class. For example, this warning will
The scheduled action is unknown to the current
be issued on a backup operation if no backup
version of the IBM Spectrum Protect client and cannot
copygroup is defined for the management class or this
be performed by means of a schedule. The most likely
message will be issued on an archive operation if no
cause is that the scheduled action requires a later
archive copygroup is defined for the management
version of the backup-archive client.
class.
The unsupported action is displayed as a number
because the text description is not available.

Chapter 2. ANS 0000-9999 messages 367

System action User response
The management class on the include statement is Enter a valid node name or see your system
ignored and processing continues. administrator for the correct syntax.
ANS7510E A NAS node cannot be used for
User response this operation.
Contact the IBM Spectrum Protect administrator to
correct the appropriate copygroup definition on the Explanation
IBM Spectrum Protect Server.
NAS nodes cannot be used for operations like Access
ANS7501E An invalid host address was Another Node.
received. Host address is too long.
System action
Explanation
IBM Spectrum Protect prompts you to enter a valid
An invalid host parameter was found in the HTTP node name.
Request. The parameter is too long. The maximum
length for a host address is 64 characters. User response
Enter a valid, non-NAS, IBM Spectrum Protect node
System action
name.
IBM Spectrum Protect returns HTTP error code 400
Bad Request. ANS7524E SSL is required.

User response Explanation

Use a host machine with a valid/shorter host address. SSL is required to protect the client password during
authentication.
ANS7502E An invalid filename was received.
Filename is too long. System action
Processing terminates.
Explanation
A filename passed to the dsmcad service is too long User response
and thus invalid.
Enable SSL communication or set SSLREQUIRED to
NO.
System action
ANS7525E SSL is required by server.
IBM Spectrum Protect returns HTTP error code 400
Bad Request.
Explanation
User response SSL is required to protect the client password during
authentication.
Retry connecting to dsmcad but use a valid/shorter
filename.
System action
ANS7507W The node name entry is invalid.
Please try again. Processing terminates.

Explanation User response

An invalid entry is entered on the Node Name field. Enable SSL communication or contact your IBM
Spectrum Protect server administrator.
System action ANS7526E The SNAPSHOTROOT option is not
IBM Spectrum Protect prompts you to enter a valid valid with either of the
node name. following options: -GROUPNAME
and -VIRTUALFSNAME.

368 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
The SNAPSHOTROOT option is incompatible with the - When you use the (-SNAPSHOTROOT) option with the
GROUPNAME and -VIRTUALFSNAME options and BACKUP IMAGE command, SNAPSHOTROOT must
cannot be used with either one of those options. specify the device name of the logical volume
containing the snapshot for the backup. An example
System action is /dev/fslv01 (on Unix) or \\?\GLOBALROOT\Device
\HarddiskVolumeShadowCopy1 (on Windows).
Processing stops.
With BACKUP IMAGE, SNAPSHOTROOT cannot be
used unless SNAPSHOTPROVIDERIMAGE has one of
User response
the following values in effect:
For information about backup-archive client
• VSS
processing options, see IBM Spectrum Protect
Backup-archive Clients Installation and User's Guide. • JFS2

ANS7527E The (-SNAPSHOTROOT) option is

System action
not valid in conjunction with num-
specs file specifications. Processing is stopped.

Explanation User response

The (-SNAPSHOTROOT) option must be used in For the correct use of the (-SNAPSHOTROOT) option,
conjunction with only one file specification. It cannot see the appropriate Backup-Archive Client Installation
be used with zero file specification (e.g., an and User's Guide book for your operating system.
INCREMENTAL command with no file specifications) or
with more than one file specification. ANS7531E The (-SNAPSHOTROOT) option is
invalid when processing the
NetWare NDS or Server Specific
System action Information.
Processing stopped.
Explanation
User response The (-SNAPSHOTROOT) option is only intended with
See the appropriate Using the Backup-Archive Client NetWare file server volumes and is not compatible
book for your operating system for correct use of the with processing the NDS or Server Specific
named option. Information on NetWare.

ANS7528E The (-SNAPSHOTROOT) option for

System action
GPFS fileset is not valid without
filelist Processing stopped.

Explanation User response

The (-SNAPSHOTROOT) option for GPFS fileset is only See the appropriate Using the Backup-Archive Client
supported using a filelist. book for your operating system for correct use of the
named option.
System action ANS7533E The specified file system 'obj-
Processing stopped. name' does not exist or is not
local.
User response
Explanation
See the appropriate Using the Backup-Archive Client
book for your operating system for correct use of the When you use the (-SNAPSHOTROOT) option, the
named option. target and source file systems must be valid, local file
systems. The file systems cannot be non-local, such as
ANS7529E The specified SNAPSHOTROOT a remote NetWare drive, a remote Windows drive, or
'obj-name' is not valid for the an NFS mount. The (-SNAPSHOTROOT) option is valid
BACKUP IMAGE command. for local operations only.

Chapter 2. ANS 0000-9999 messages 369

System action System action
Processing is stopped. Processing stops.

User response User response

For the correct use of the (-SNAPSHOTROOT) option, Ensure that the scout daemon is running. If the scout
see the appropriate Backup-Archive Client Installation daemon is not running, restart it and retry the
and User's Guide book for your operating system. command. If the scout daemon is running, wait until it
finishes the initial file system scan. You can check the
ANS7534W Initialization functions cannot current status of the scout daemon by using the
open /dev/tty special file. errno = dsmscoutd scanplan command.
errno-value, error message
ANS7544E ICC routine icc-routine failed with
Explanation the following error: "error-string".

Special file /dev/tty, required by command line

Explanation
internal editor could not be opened during
initialization. The system set the error code errno- There was an error within ICC cryptography library
value. while processing the data. For example, this problem
can occur when encrypted client data is corrupted, so
System action the restore operation cannot correctly decrypt it. This
message reports an error code and problem
Processing continues as if EDITOR option was set to description which can be used by IBM Spectrum
NO. Protect technical support personnel to determine the
cause of the failure.
User response
Check your terminal settings. System action

ANS7535W Command line internal editor can The processing stops.

not be initialized.
User response
Explanation Ensure IBM Spectrum Protect software is installed
EDITOR option is set to YES in the options file, but correctly. If needed, reinstall the software. Make sure
command line internal editor can not be started. you use the correct encryption key password for the
data. Make sure there are no IBM Spectrum Protect
server or network problems that may affect the
System action transfer of data. If the problem still exists, contact IBM
Processing continues as if EDITOR option was set to Spectrum Protect technical support.
NO
ANS7545E Unexpected error while encrypting
the data.
User response
Check previous messages to determine the reason Explanation
why the internal editor could not be started.
There was an error while encrypting the data. See the
ANS7543E Error: Scout is not available for error log for more information.
object query. Either scout is not
running or the initial file system System action
scan has not finished.
The object is not backed up.
Explanation
User response
The scout daemon must be running for the reconcile
process to do a query for all migrated files. If the scout Ensure IBM Spectrum Protect software is installed
daemon is not running or the initial file system scan correctly. If needed, reinstall the software. Retry the
has not finished you cannot run the reconcile tool in operation. If the problem still exists, contact IBM
orphan check mode. Spectrum Protect technical support.

370 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS7546E Unexpected error while decrypting ANS7552I timestamp ***** Processed count
the data. files *****

Explanation Explanation
There was an error while decrypting the data. See the IBM Spectrum Protect has processed the specified
error log for more information. This can happen if the number of files.
encrypted data has been corrupted while in storage,
during the network transfer, or both. System action
Processing continues.
System action
The object is not restored. User response
None.
User response
ANS7553W Disabled demand migration
Ensure IBM Spectrum Protect software is installed
(ENOSPC) on file system file-
correctly. If needed, reinstall the software. Make sure
system-name because of high
there are no IBM Spectrum Protect server or network
threshold, low threshold, and
problems that may affect the transfer of data. Retry
pmpercentage settings.
the operation. If the problem still exists, contact IBM
Spectrum Protect technical support.
Explanation
ANS7547E Unexpected error while digesting
the data. The settings of high threshold = 100, low threshold =
100, and pmpercentage = 0 are reserved to disable
demand migration and automigration. Used for GPFS
Explanation
driven migration.
There was an error while digesting the data. See the
error log for more information. System action
Processing continues.
System action
The object is not backed up. User response
None.
User response
ANS7554E provider option is required if
Ensure IBM Spectrum Protect software is installed
correctly. If needed, reinstall the software. Retry the HSMBACKENDMODE is set to
operation. If the problem still exists, contact IBM TSMFREE.
Spectrum Protect technical support.
Explanation
ANS7550E The absolute option requires using
the CreateNewBase=yes option You need to specify provider option for every operation
when performing a snapshot with dsmmigrate.
differential backup.
System action
Explanation The operation stopped.
The absolute option specified does not have any effect
when performing a snapshot differential backup. User response
Specify the provider option value for the operation.
System action
ANS7557E invalid provider.
Processing stopped.
Explanation
User response
You need to specify a valid provider for every
Try to use the CreateNewBase=yes option when operation with dsmmigrate.
performing a snapshot differential backup.

Chapter 2. ANS 0000-9999 messages 371

System action Explanation
The operation stopped. There is no valid library in hsm/bin directory.

User response System action

Specify a valid provider option value for the operation. The operation stopped.
ANS7558E target option is required if
HSMBACKENDMODE is set to User response
TSMFREE. Copy a valid external library to hsm/bin directory.
ANS7641I The user does not have
Explanation
administrative credentials to
You need to specify target option for every operation perform a full system state
with dsmmigrate. backup.

System action Explanation

The operation stopped. The user account used to perform system state
backup including ASR Writer data must be a member
User response of the Administrators group.

Specify the target option value for the operation.

System action
ANS7559E The absolute option requires System state backup skips ASR Writer data.
specifying the NoJournal option
when performing a Journal Based
Backup for backing up fs . User response
Log on with a user who is a member of the
Explanation Administrators group or add this user to the
Administrators group. Then try the system state
The absolute option specified does not have any effect backup again.
when performing journal based backups.
ANS7642E An error occurred creating the
System action registry directory structure.

Incremental backup is performed.

Explanation

User response An error occurred while creating the directory

structure to save or replace a registry key.
Verify that the file spaces specified are not associated
with journal based backup. If the -nojournal option is
System action
also specified, then this message will not appear.
Registry function fails.
ANS7566E Unable to load external library:
reason
User response
Explanation Ensure that the user account that is running the
backup of the registry has the proper authority. If the
There is no valid library in hsm/bin directory. user account has the proper authority, you might need
to restart the machine. There might be operations that
System action are pending which have a file or files in the registry
The operation stopped. directory structure locked.
ANS7650E The user does not have sufficient
User response privileges to execute IBM
Spectrum Protect.
Copy a valid external library to hsm/bin directory.
ANS7567E program-name:External recall
failed! Reason:

372 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The user account used to execute IBM Spectrum The processing stops.
Protect must have the "Back up files and directories"
and the "Restore files and directories" security User response
settings assigned.
Retry the operation. If the problem persists, turn off
deduplication and retry the operation.
System action
ANS7900I Deduplication cache has been
Processing stops.
reset because it is not
synchronized with the IBM
User response Spectrum Protect server
Assign the "Back up files and directories" and the
"Restore files and directories" security settings to the Explanation
account using the Windows Local Security Settings
The deduplication cache contains deduplicated extent
tool or use a different user-id to execute IBM
entries that do not exist on the IBM Spectrum Protect
Spectrum Protect.
server. This occurs when the extents are deleted from
ANS7660E An error occurred replacing one or the IBM Spectrum Protect server after they were
more registry keys. recorded in the deduplication cache.

Explanation System action

The registry key or keys being replaced are exclusively The deduplication cache is reset, and all cache entries
held by another process. The registry keys were are removed. The processing continues.
previously restored but the system was not restarted.
User response
System action
None
processing stops.
ANS7901W Client deduplication and option-
name are mutually exclusive.
User response
Restart the system and try the restore operation again. Explanation
ANS7709E Restore operation failed. Not all The following features cannot be used with
files were restored. deduplication: lan-free, subfile, NAS, useTsmBuffers.

Explanation System action

Restore operation failed due to an error. Client deduplication is disabled.

System action User response

Operation completed. Review the configuration. Do not configure
deduplication with the lan-free, subfile, NAS, or
User response useTsmBuffers features.

Check the error log for more details. ANS7902I Client deduplication cache is full.
Cache is reset.
ANS7899E The client referenced a
deduplicated extent that does not
Explanation
exist on the IBM Spectrum Protect
server The number of entries cached in the client
deduplication cache has exceeded the configured size
Explanation for the cache.

The deduplicated extent has been deleted from the

System action
server during the backup or archive operation. If you
are using deduplication cache, it might be out of synch The deduplication feature is designed so that this
with the IBM Spectrum Protect server. happens periodically.

Chapter 2. ANS 0000-9999 messages 373

The cache is reset to no entries. pool. Deduplication is disabled and the transaction is
being resent.
User response
System action
You can reconfigure the client deduplication cache
size to a larger value to reduce the frequency of resets. Deduplication is disabled to allow the backup to
complete.
ANS7903W Client deduplication cache is
locked by another process.
User response
Explanation Contact your system administrator to add volumes to
the current storage pool.
Another process is using the client deduplication
cache. ANS7907W Connection to repository repos-
Only one process may use it at a time. name failed. Retrying with repos2-
name.
System action
Explanation
This process does not use the client deduplication
cache. Unable to connect to the FastBack DR Hub repository.
The server deduplication is not changed. Retry using FastBack server repository.

User response System action

You can serialize processes using the client Retry operation.
deduplication cache. Or you can reconfigure the
current process to use a different cache path to avoid User response
contention.
Specify a vaild repository.
ANS7904E Client deduplication and lan-free
or subfile backup are mutually ANS7908E Unable to mount FastBack
exclusive. snapshot policy 'Policy' client
'Client' volume 'Volume'. Reason:
reason
Explanation
Client deduplication and lan-free or subfile are Explanation
mutually exclusive.
IBM Spectrum Protect Mount failed.
System action
System action
Client deduplication is disabled.
IBM Spectrum Protect cannot continue processing.
User response
User response
Review the configuration. Do not configure
deduplication with the lan-free or subfile feature. Check the Recovery Agent logs for information about
why the mount operation failed to complete.
ANS7906W The current storage pool either ran
out of space or the current object ANS7912E FastBackMount or FastBackShell
exceeded the maxsize is not installed.
configuration parameter for the
storage pool, data will be stored Explanation
into the next pool - deduplication
Failure initializing FastBack environment.
is disabled.
FastBackShell or FastBackMount are not installed or
are not located in the FastBack install directory.
Explanation
The current storage pool on the IBM Spectrum Protect System action
server is either out of space or the current object
The FastBack operation cannot continue.
exceeded the maxsize configuration parameter for the
storage pool . Data will be stored in the next storage

374 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response volume to determine the reason for the failure. Refer
to the documentation for that message for more
Reinstall the software. The FastBackShell and
information.
FastBackMount must be installed on the dedicated
proxy computer. ANS7916E Failure initializing FastBack
environment.RC=rc
ANS7913E The given branch was not found in
the DR Hub repository.
Explanation
Explanation Failure initializing FastBack environment. Can not find
FastBackShell.exe command. The FastBackShell or
The parameter to the required fbbranch option is
FastBackMount is not installed or FastBackShell.exe
incorrect.
command is not located in the FastBack install
directory.
System action
The operation cannot continue. System action
The backup can not continue. The output of the
User response FastBack command will show the reason for the
Correct the parameter given for the fbbranch option. failure.

ANS7914E Incremental backup of FastBack User response

client 'vmname' failed with RC rc
Issue a FastBack command to determine the reason
Explanation for the failure. Refer to the documentation for that
message for more information. The FastBackShell and
The archive or incremental backup of FastBack client FastBackMount must be installed on the backup proxy
volumes failed. computer.
ANS7917E No FastBack snapshots found for
System action
input policy, client and volume
The archive or backup of FastBack client finished with combination.
failures. The next FastBack client will be processed.
The reason for the failure is written to the local client Explanation
error log.
Failure processing fbClientName option.
User response
System action
Check the local client error log for reason for the
failure. The backup cannot continue.

ANS7915E Failure mounting FastBack client User response

'vmname' with FastBack
command. RC=rc Check for errors in the FBClientName option value.
Refer to the documentation for the FBClientName
Explanation option for more information.

The FastBackMount command failed to mount a ANS7918E Failure locating mounted volumes
FastBack volume. for FastBack client 'vmname'
volumes. Failed with RC=rc
System action
Explanation
The archive or backup of the FastBack volume can not
continue. The next Volume in in line will be processed. FastBack client volumes can not be found. Volume
The output of the FastBackMount command will show mount points are not available on the backup proxy
the reason for the failure. computer.

User response System action

Check the local client error log for the reason for the The backup of the FastBack client can not continue.
failure. Issue a FastBack command for the FastBack The next FastBack client in the list will be processed.

Chapter 2. ANS 0000-9999 messages 375

The output of the FastBackMount command will show User response
the reason for the failure.
Ensure that there is at least one snapshot for this
FastBack volume, client, and policy. Ensure that a
User response correct object is specified as input.
Issue a fastbackshell mount add command for the ANS7938E Unable to dismount FastBack
FastBack client volume to determine the reason for the volume 'volName'. RC = rc
failure. Refer to the documentation for that message
for more information.
Explanation
ANS7919E Password for Host host could not
IBM Spectrum Protect Dismount failed.
be read from encrypted password
file.
System action
Explanation
Use dsmc SET PASSWORD -type=FastBack 'FastBack User response
hostname' 'userid' 'password' to save encrypted
password ANS7939E Invalid FastBack volume
specification.
System action
Explanation
The backup cannot continue.
You must enter at least one FastBack client with the "-
fbclientname=" option before entering a FastBack
User response
volume name.
Use dsmc SET PASSWORD -type=FastBack 'FastBack
hostname' 'userid' 'password' to save encrypted System action
password
ANS7936E objType objName not found in
User response
dump.
When entering a FastBack volume name, enter at least
Explanation one FastBack client name using the "-fbclientname="
option.
IBM Spectrum Protect server could not find the object
that is specified in the FastBack Dump command.. ANS7940W SUBDIR NO is not valid in this
context. SUBDIR will be forced to
System action YES for FastBack commands.

IBM Spectrum Protect skips the current object. Explanation

When using FastBack, SUBDIR is forced to YES to
User response
ensure that the whole volume is processed.
Ensure that there is at least one snapshot for this
FastBack volume, client, and policy. Ensure that a System action
correct object is specified as input.
SUBDIR is forced to YES.
ANS7937E No objType found in dump for input
objType1 objType2.
User response

Explanation To avoid this message, do not use SUBDIR NO with the

command.
IBM Spectrum Protect server found no clients for the
specified policy. IBM Spectrum Protect server found ANS7941E FastBack invalid repository name
no volumes for the specified FastBack client. or domain not set in password file
entry for hostname.
System action
IBM Spectrum Protect skips the current object.

376 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
IBM Spectrum Protect The FastBack repository name IBM Spectrum Protect
is invalid or the domain has not been set in the
password file when specifying the REP form of the User response
repository.
Correct the names of the clients specified.
System action ANS7945W The number of FastBack policies
specified policy is greater than the
IBM Spectrum Protect
number of FastBack policies found
policy.
User response
Issue the command dsmc set password server Explanation
userid:domain password -type=fastback.
IBM Spectrum Protect One or more of the FastBack
ANS7942E Maximum number of FastBack policies specified was not found. Look for message
objName objects exceeded. ANS7936E specifying the policy name.

Explanation System action

IBM Spectrum Protect The maximum number of IBM Spectrum Protect
FastBack objects shown in the message has been
exceeded. User response
Correct the names of the policies specified.
System action
IBM Spectrum Protect ANS7946E FastBack shell command
timeout.SSH Keys may not be
configured for no password.
User response
Re-run the command with no more than the maximum Explanation
number of objects specified.
IBM Spectrum Protect The FastBack shell command
ANS7943E The combination of objName and timeout. SSH may not be configured properly.
objName is invalid.
System action
Explanation
IBM Spectrum Protect
IBM Spectrum Protect The combination of options
specified is invalid. User response
Correct SSH configuration.
System action
ANS7947E The root user .ssh directory was
IBM Spectrum Protect
not found. SSH is not configured
properly.
User response
Re-run the command with a compatible set of options. Explanation
ANS7944W The number of FastBack clients IBM Spectrum Protect SSH is not configured properly
specified client is greater than the for the root user.
number of FastBack clients found
client. System action
IBM Spectrum Protect
Explanation
IBM Spectrum Protect One or more of the FastBack User response
clients specified was not found. Look for message
ANS7936E specifying the client name. Correct SSH configuration.

Chapter 2. ANS 0000-9999 messages 377

ANS7948E The public key for the FastBack System action
server was not found. SSH public IBM Spectrum Protect
keys are configured properly.

User response
Explanation
Correct the options specified on the commandr.
IBM Spectrum Protect The SSH public keys are not
configured properly for the root user. ANS7952E The package package required for
FastBack support is not installed.
System action
Explanation
IBM Spectrum Protect
IBM Spectrum Protect The required package is not
User response installed.

Correct SSH configuration.

System action
ANS7949E The connection to FastBack server IBM Spectrum Protect
failed.

User response
Explanation
Install and configure the required package.
IBM Spectrum Protect The connection to FastBack
server failed. ANS7953E The FastBack shell scripts
returned an unexpected error
System action error.

IBM Spectrum Protect

Explanation

User response IBM Spectrum Protect The FastBack shell scripts

returned an unexpected error.
Insure that the FastBack server on the target machine
is runing properly.
System action
ANS7950E The FastBack server is not IBM Spectrum Protect
installed on the target machine.
User response
Explanation
Correct the error.
IBM Spectrum Protect The FastBack server is not
installed on the target machine. ANS7954E The SSH connection failed. The
SSH daemon may not be started or
System action configured on the target machine

IBM Spectrum Protect

Explanation

User response IBM Spectrum Protect Ensure that the SSH daemon is
configured correctly.
Install the FastBack server on the target machine or
specify a different target machiner.
System action
ANS7951E The FastBackShell on the target IBM Spectrum Protect
machine returned with the
message errormsg .
User response
Explanation Correct the error.
IBM Spectrum Protect An error occurred with the ANS7955E The cygdrive-prefix is set
command issued to the FastBackShell on the target incorrectly.
machine.

378 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
IBM Spectrum Protect Ensure that cygdrive-prefix is None.
set to / in the ssh cygwin environment. The command
ANS8001I Return code return code value.
mount -s --change-cygdrive-prefix / can be use to set
the drive prefix correctly.
Explanation
System action The error code shown has been returned from the
preceding server command. This message is preceded
IBM Spectrum Protect
by a server message explaining the reason for the
error code.
User response
Correct the error. System action
ANS7956E Unable to execute cygwin shell None.
commands. The cygwin
environment may be incorrectly User response
None.
Explanation
ANS8002I Highest return code was return
IBM Spectrum Protect Use ssh to connect to the
code value.
cygwin shell and ensure that the cygwin environment
and cygdrive are configured correctly.
Explanation
System action At exit from the client, the highest return code
IBM Spectrum Protect encountered during the session is displayed.

User response System action

Correct the error. This value is used as the program exit code.

ANS7957E Unable discover the FastBackShell User response

location in the registry
None.
Explanation ANS8003I Process number process ID
IBM Spectrum Protect Check that the FastBackShell started.
was installed on the Windows FastBack server
machine. Explanation
As a result of the preceding server command, the
System action process whose ID is shown starts to execute the
command. The process can be monitored using the
IBM Spectrum Protect
QUERY PROCESS command.

User response
System action
Correct the error.
None.
ANS8000I Server command: 'command'.
User response
Explanation
None.
The specified command is being sent to the server.
ANS8004W Your password will expire within
This message is displayed when the command is
generated from a macro or when the client is running daysRemaining day(s).
in batch mode.
Explanation
System action The password for this id is about to expire.
The command is sent to the server for processing.

Chapter 2. ANS 0000-9999 messages 379

System action User response
Logging on to the IBM Spectrum Protect Server will not Run IBM Spectrum Protect client as root user or set
be prevented, however, the id will be locked out once PASSWORDACCESS to PROMPT.
it expires.
ANS8008W Redirection inside macro whose
output is redirected is ignored.
User response
Change the password or contact your IBM Spectrum Explanation
Protect administrator to get the password updated.
An output redirection symbol has been encountered
ANS8005E Java Applet failed to load. Please inside a macro. However, the output of the macro itself
ensure that the Java Java version (or a higher level macro) is already being redirected.
Plugin has been installed for this
browser. System action
The redirection request is ignored.
Explanation
Java Plugin is missing from browser. Since plugin is User response
not present, applet is not able to load.
None.
System action ANS8010E An attempt to backup or archive a
Applet unable to load and message displayed. file has exceed the maximum
number of retries.
User response
Explanation
Install appropriate plugin for browser in order to use
web client. After five unsuccessful attempts to backup or archive a
file, the client will no longer attempt to send the file to
ANS8006E Unable to generate an acceptable the server.
password.
System action
Explanation
File skipped.
An error occurred during a password update attempt
using a generated password. User response
Check the console or schedule log for additional
System action
information. Retry the operation at a later time.
The password is not updated on the server.
ANS8011W Rejected server-initiated session
with LDAP authentication from
User response peer name.
Contact your IBM Spectrum Protect administrator.
Explanation
ANS8007E The user is not authorized to
perform LDAP authentication. For security, the client will not accept server-initiated
sessions from servers that use LDAP authentication.
Explanation
System action
Your node uses LDAP authentication. Your
PASSWORDACCESS option is set to GENERATE but the The client-server session is not opened, and the
current user cannot access the stored password to schedule is not executed. The scheduler continues to
perform authentication. wait for contact by a server that uses LOCAL
authentication.
System action
User response
The operation is stopped.
If the client system is supposed to accept scheduled
events from the prompting IBM Spectrum Protect
server, either ask the IBM Spectrum Protect server

380 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
administrator to configure your node to use LOCAL specify all that information in your client options file or
authentication, or do not use server-initiated sessions. on the administrative client command line.
If the client system is not supposed to accept
ANS8015E File 'file spec', error code error
scheduled events from the prompting server, ask the
code from options processing.
IBM Spectrum Protect server administrator to remove
the client node name from the schedule on the
prompting server. Explanation

ANS8012E Option processing storage An unknown error code is returned from the routine
exhausted. that processes the client options file.

Explanation System action

During processing of the client options file, the client The administrative client session is ended.
runs out of memory.
User response
System action Attempt to determine the error and correct it. If the
The client session is ended. problem persists, contact your service representative.
ANS8016E Command line parameter
User response parameter number: 'parameter' is
Make more memory available and restart the too long.
administrative client.
Explanation
ANS8013I Invalid encryption key password
The specified command line parameter exceeds the
maximum length for a command line parameter.
Explanation
The key you entered does not match the key that was System action
used to encrypt the file during backup. The file can not
be restored unless the matching key is entered. The administrative client session is ended.

System action User response

User is prompted for encryption key password. Reissue the command with a shorter parameter.
ANS8017E Command line parameter
User response parameter number: 'parameter' is
Enter the correct encryption key password. not valid.

ANS8014E Insufficient information to connect Explanation

to host.
The command line parameter shown is not a valid
administrative client parameter.
Explanation
The client options file or command line, or both, do not System action
contain enough communications information to
successfully connect to the server system. For The administrative client session is ended.
example, with TCP/IP both the TCPPort number and
TCPServer address are required to make a connection. User response
Reissue the command with valid parameters.
System action
ANS8018E Administrative command not valid
The administrative client session is ended. in Console mode.

User response Explanation

Determine what information is needed to establish a The Console Mode option has been specified but the
connection for your communications method and then client encounters what appears to be a server
command on the command line.

Chapter 2. ANS 0000-9999 messages 381

System action Explanation
The administrative client session is ended. The file specified in the -OUTFILE parameter cannot
be opened, so output is written only to the standard
User response output stream.

Reissue the command with no server command.

System action
ANS8019E Id and password must be supplied Output that would have been written to the output file
in Batch mode. is written to the standard output stream.

Explanation User response

A server command has been encountered on the Allow processing to continue or exit the session and
command line, but no administrator ID or password, or correct the file name.
both, are specified.
ANS8023E Unable to establish session with
System action server.

The administrative client session is ended.

Explanation

User response The administrative client cannot start a session with

the requested server. This message is preceded by
Reissue the command and include the -ID and - another message that explains the reason for the
PASSWORD parameters on the command line. error.
ANS8020E Unable to open file 'file spec' for
output. System action
The administrative client session is ended.
Explanation
The file name specified in the -OUTFILE option cannot User response
be opened. Attempt to correct the error. If the problem persists,
contact your service representative.
System action
ANS8024E End of macro after continued
The -OUTFILE parameter is ignored. command line.

User response Explanation

Allow processing to continue or exit the session and A macro containing a continuation line has been
correct the file name. executed, but no more lines are found in the macro
ANS8021E Exiting Batch mode session due to file.
output file error.
System action
Explanation The continued command is ignored, and an error
The file specified in the -OUTFILE parameter cannot return code is set for the macro.
be opened for a session running in Batch mode.
User response
System action Correct the macro in error.
The administrative client session is ended. ANS8025E I/O Error reading command input.

User response Explanation

Reissue the command with a valid output file name or The client is unable to read an input command from
make space available for the output file. the terminal.
ANS8022E Output will be written only to
stdout.

382 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The administrative client session is ended. An error occurs during processing of a macro because
the -ITEMCOMMIT option is not specified on the
User response command line. Processing of this macro and any
higher level macro is terminated.
Correct the problem on the terminal and retry the
administrative session.
System action
ANS8026E Input line longer than maximum of All current macro processing ends.
max length characters. Use
continuation.
User response
Explanation Specify the -ITEMCOMMIT option on the command
line to ensure that the server commits each command
An input command line is longer than the maximum in the macro individually.
input line length allowed.
ANS8030E Substituted command longer than
System action maximum of max length
characters.
The input command is ignored.
Explanation
User response
After variable substitution, an input command is longer
Reissue the command with several lines using than the maximum command length allowed.
continuation characters.
ANS8027E Unterminated comment in System action
command. The input command is ignored.

Explanation User response

An input command contains an opening comment Reissue the command with fewer characters. This may
mark but no closing comment mark. require replacing a series of repeating blanks with a
single blank.
System action
ANS8031E Missing name of macro to execute.
The input command is ignored.
Explanation
User response
A macro command is encountered that does not
Reissue the command with matching comment marks. contain a macro name.
ANS8028E Command longer than maximum
of max length characters. System action
The command is ignored.
Explanation
An input command longer than the maximum User response
command length allowed has been entered. Reissue the macro command with a macro file name.

System action ANS8032E Could not allocate storage to

process macro 'file spec'.
The input command is ignored.
Explanation
User response
The client cannot allocate enough memory to process
Reissue the command with fewer characters. This the macro shown.
could mean replacing series of repeating blanks with a
single blank.
System action
ANS8029E Macro processing terminated. The macro is ignored and an error is returned.

Chapter 2. ANS 0000-9999 messages 383

User response System action
Make more memory available to the client and retry The command is ignored and an error is returned.
the macro command.
ANS8033E LDAP authentication is not User response
supported by Web client. Reissue the command with an output file name.
ANS8038E Unable to open file 'file spec' for
Explanation
redirection.
The id you entered uses LDAP authentication. LDAP
authentication is not supported by Web client. Explanation
A command has been entered that specifies an output
System action
redirection file, but the file cannot be opened.
Login is unsuccessful.
System action
User response
The command is ignored and an error is returned.
Use an id with LOCAL authentication.
ANS8034E Your administrator ID is not User response
recognized by this server. Reissue the command with a valid output file name or
make space available for the output file.
Explanation
ANS8041E The server connection has been
The administrator ID entered is not known to the lost and cannot be re-established.
requested server.
Explanation
System action
During an administrative session, the client discovers
The administrative session terminates. that the connection with the server has been severed;
an attempt to reestablish the connection fails.
User response
System action
Ensure that you are using a registered administrative
ID for the server to which you are connecting. The client session is ended.
ANS8036E Administrative command not valid
in Mount mode. User response
Determine the cause of the failure; then try to restart
Explanation the session at a later time. If the problem persists,
contact your service representative.
The Mount Mode option has been specified but the
client encounters what appears to be a server ANS8045E Communications error.
command on the command line.
Explanation
System action
An unexpected communications error occurs during an
The administrative client session is ended. administrative session.

User response System action

Reissue the command with no server command. The client session is ended.
ANS8037E Missing name for redirection file.
User response
Explanation Verify that communications are active between the
client and server machines. Server outages, processor
A command is entered that contains an output outages, and communication controller outages can
redirection symbol but no output file name. cause this error.

384 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS8046E The client connection with the such situation, restore the image to its original
server has ended due to an location.
unexpected error.
System action
Explanation Processing continues.
The error log might contain other messages related to
this error. User response
If it is not possible or not desirable to avoid performing
System action an image restore to an alternate destination, change
The client session ends. the UUID of either the original or restored volume.
Refer to your Linux documentation for instructions on
User response how to do this. You may also need to edit your /etc/
fstab manually to allow the original, the restored or
Check the communication link between the client and both volumes to mount.
server to ensure that it is operational. Examine the
client error log for additional messages related to this ANS8049E A connection with the server
error. cannot be established due to a
communications time-out.
ANS8047E The client connection with the
server has ended due to a Explanation
communications buffer overflow.
The error log might contain other messages related to
Explanation this error.

The error log might contain other messages related to System action
this error.
The client session ends.
System action
User response
The client session ends.
Check the communication link between the client and
User response server to ensure that it is operational. Examine the
client error log for additional messages related to this
Try the operation again. Check the communication link error.
between the client and server to ensure that it is
operational. Examine the client error log for additional ANS8050E The IBM Spectrum Protect server
messages related to this error. is not accepting administrative
sessions on the client port.
ANS8048W Warning! Performing image You must use the port number
restore of the Linux file system designated for administrative
'src' to an alternate destination sessions.
'dest' is not recommended as this
may result in duplicate UUIDs Explanation
leading to failed mounts after a
successful restore. The IBM Spectrum Protect server is configured to not
allow administrative sessions on the client TCP/IP
Explanation port. A different port number has been designated for
use by administrative sessions.
Performing an image restore of a Linux file system to
an alternate destination may result in duplicate UUID System action
leading to failed mounts after a successful restore. On
Linux, some file systems use UUID to identify The administrative session is not established.
themselves. If you took an image backup of such
volume and restored it to a different location, you will User response
have two volumes with the same UUID. If you use
UUID to define your file systems in /etc/fstab, be Use the TCPADMINPORT client option to specify the
aware that IBM Spectrum Protect may be unable to TCP/IP port number that the IBM Spectrum Protect
mount the restored file system correctly. To avoid server uses for administrative sessions. See your IBM

Chapter 2. ANS 0000-9999 messages 385

Spectrum Protect server administrator if you do not activity. The server activity log might contain
know the correct port number. additional information about this problem.
ANS8052E Unable to decrypt file 'filespace
namepath-namefile-name' System action
....Please try to restore this file The client session ends.
individually
User response
Explanation
The IBM Spectrum Protect administrator should
File could not be decrypted and restored. examine the IBM Spectrum Protect server activity log
to determine the source of the resource constraints.
System action Try the operation again when the server is under less
load.
File is not restored.
ANS8056E Your administrator ID is locked.
User response
Explanation
Restore the file separately.
The administrative ID entered has been locked by a
ANS8053E The network cannot be accessed. system administrator and cannot be used.

Explanation System action

The error log might contain other messages related to The client session is ended.
this error.
User response
System action
Contact your system administrator to unlock your ID.
The client session ends.
ANS8057E The requested language files are
User response not available.

Check the communication link between the client and

Explanation
server to ensure it is operational. Examine the client
error log for additional messages related to this error. The NLS repository for the language specified is not
Try the operation again. available.
ANS8054E No memory available to service
request. System action
The client session is ended.
Explanation
Sufficient server memory is not available. User response
Use a different language or obtain a copy of the NLS
System action repository for the language desired.
The client session is ended. ANS8058E The specified path is a Linux Btrfs
subvolume and is not valid for
User response image backup.

Retry the administrative session. If the problem

Explanation
persists, contact your service representative.
Linux Btrfs subvolumes are not supported for image
ANS8055E The server has insufficient backup.
resources to perform the
operation.
System action
Explanation The image backup operation is not performed.
The server ran out of resources. A lack of storage or
other problem condition does not allow any new

386 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response ANS8063E The remote IBM Spectrum Protect
Client Acceptor associated with
Try the operation again using a valid Linux Btrfs file
Node 'name' could not
system.
authenticate with the IBM
ANS8060E Error validating file 'VHDX file Spectrum Protect Server.
name'
Explanation
Explanation
Some IBM Spectrum Protect Client operations require
IBM Spectrum Protect cannot locate the file or the file the Backup/Archive Client to contact Clients on remote
format is not valid. machines. The remote machine in question cannot
authenticate with the IBM Spectrum Protect Server.
System action
System action
The backup operation does not start.
Processing stops.
User response
User response
Try the operation again. If the problem continues,
check the error log file for information about how to On the remote machine, create a new IBM Spectrum
resolve this issue. Protect password for the Client Acceptor or verify that
the current password is still valid before retrying the
ANS8061E Session Rejected: The server does operation.
not allow a signon
as a Unicode enabled ANS8064E Communication timeout. Reissue
administrative client the command.

Explanation Explanation
The administrative client is unable to establish a The connection to the server is ended because of a
connection to the server because of a unicode communication timeout from the server.
enabling mismatch between server and client.
System action
System action
The server does not process the command.
The client session is ended.
User response
User response
Reissue the command. If necessary, increase the
Register a new administrator from a different values of IDLETIMEOUT and COMMTIMEOUT options
administrative client or the server console, and signon in the server options file.
with the new administrator ID.
ANS8103W A command was not successful.
ANS8062E Client-to-Client communication is command : command
not allowed to take place when IBM Spectrum Protect function
IBM Spectrum Protect Server name : function-name
authentication is turned off. error output : error-output
return code : return code
Explanation IBM Spectrum Protect file : file-
name (line-number)
Client-to-Client communication requires IBM
Spectrum Protect Authentication to be enabled.
Explanation

System action IBM Spectrum Protect client called an external

program that failed.
Processing stops.
System action
User response
Depending on the circumstances, the failure may or
Turn IBM Spectrum Protect Server authentication on may not prevent further processing.
using the Set AUthentication ON command.

Chapter 2. ANS 0000-9999 messages 387

User response System action
See addition information in the error log. Use the Processing stopped.
information provided in this message for
troubleshooting or when talking with IBM Spectrum User response
Protect support.
Specify a valid server name for this command.
ANS8104W Cannot determine EFS status of
the file system 'file-system name', ANS8201E Windows Hyper-V incremental
errno='errnor number', processing backups require Windows 2012 or
data normally. later. On Windows Server 2016 or
later, the virtual machine version
must be greater than 5.
Explanation
IBM Spectrum Protect cannot determine EFS status on Explanation
the specified filesystem. No EFS specific processing
will take place for files on this filesystem. If EFS is IBM Spectrum Protect can only perform incremental
indeed enabled on the filesystem, all accessaible files backups of Windows Hyper-V on Windows operating
will be backedup in cleartext. systems of Windows Server 2012 and later. If running
on Windows Server 2016 or later than the virtual
machine version must be greater than 5.
System action
The filesystem will be processed as a regular System action
filesystem.
The incremental backup operation was stopped.
User response
User response
Contact your system administrator to determine the
cause of the error reported in the message. To access incremental backups for Windows Hyper-V,
upgrade the operating system to Windows Server
ANS8105W Unable to remove snapshot for 2012 or later. On Windows Server 2016 and later, the
volume 'filespace-name'. virtual machine version must be greater than 5 to
support Microsoft Hyper-V Resilient Change Tracking
Explanation (RCT).
IBM Spectrum Protect client was unable to remove the ANS8503I No matching option found for
snapshot used for image backup. pattern: 'pattern'.

System action Explanation

Processing continues. You specified a pattern which does not match the
name of any supported option.
User response
System action
See additional information in the error log. Use
lvdisplay command to view the active snapshots and This message is the only response to your query.
lvremove command to remove the snapshot manually.
ANS8106E Support for multiple IBM User response
Spectrum Protect servers is Specify a different pattern or omit the pattern to
enabled on this node. display all options.
The server name must be specified
for this command. ANS8563E Recall mode has an invalid value:
invalidValue.
Explanation
Explanation
When a node is enabled to support multiple IBM
Spectrum Protect servers, the command must specify The recall mode you try to enable on the system is not
a valid IBM Spectrum Protect server name. existing.

388 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
None. A browser program cannot be found, so it is not
possible to access the IBM Spectrum Protect Web site
User response and online documentation.

Check the value of the recall option.

System action
ANS8565W ProgramName: list of recall IDs not IBM Spectrum Protect continues to process user
found in queue. These recalls are requests.
already finished:

User response
Explanation
For UNIX platforms, a list of supported browsers is
The program is not able to find the recall IDs and is not provided in the README. Install the required browser
able to delete these processes. to access the IBM Spectrum Protect Web sites and
online documentation.
System action
ANS8780E A browser program cannot be
None. found or cannot be started.
Check the 'file-name' file on your
User response local machine for more
information.
Check that recall IDs exist and are correct.
ANS8778E A browser program cannot be Explanation
found or cannot be started.
An error occurred executing the A browser program cannot be found, so it is not
command. possible to access the Web site or online
command documentation.
Verify that a browser is installed
and works correctly on your local System action
machine. IBM Spectrum Protect continues to process user
requests.
Explanation
A browser program cannot be found, so it is not User response
possible to access the IBM Spectrum Protect Web site Install a browser to access the Web site or online
and online documentation. documentation.

System action ANS8809E The LD_LIBRARY_PATH is either

not set or is set incorrectly. Ensure
IBM Spectrum Protect continues to process user that the LD_LIBRARY_PATH
requests. environment variable contains the
installation directory path name.
User response
For the Windows platform, the default system browser Explanation
is used. Verify that a browser is installed on your The LD_LIBRARY_PATH must be set and it must
machine. contain the installation directory path.
ANS8779E A browser program cannot be
found or cannot be started. System action
One of the following browsers is The VMware backup or restore operation fails.
required: browser-list
Verify that one of these browsers
is installed and works correctly on User response
your local machine. Set the LD_LIBRARY_PATH and ensure that it contains
the Backup/Archive client installation directory.

Chapter 2. ANS 0000-9999 messages 389

ANS8810E The LD_LIBRARY_PATH is either User response
not set or is set incorrectly. Ensure Contact your system administrator.
that the LD_LIBRARY_PATH
environment variable contains the ANS8819E The following trace flag(s) are not
installation directory. valid: trace-flag-list.
Correct them before continuing.
Explanation
Explanation
The LD_LIBRARY_PATH must be set and it must
contain the installation directory path. One or more of the trace flags are not valid.

System action System action

The VMware backup or restore operation fails. Prompts the user to correct the trace flags.

User response User response

Set the LD_LIBRARY_PATH and ensure that it contains Correct the wrong trace flags.
the Backup/Archive client installation directory.
ANS8830W Different server name stanzas
ANS8811E VMware operations can not be run (HSM-stanza and BA-stanza) for
when the hardware plugin product file-system-name file system for
TIVsm-BAhdw is installed and space management and backup-
loaded. Please either uninstall the archive.
hardware product TIVsm-BAhdw,
or set the option DONTLOAD Explanation
PIHDW in the options file to
prevent the hardware plugin from The server name stanzas you specified for the space
being loaded. 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.
Explanation
VMware operations are incompatible with the System action
hardware plugin product libraries.
Processing continues.
System action
User response
The VMware backup or restore operation fails.
If you want to allow inline backup and stub restore for
the file system, the MIGRATESERVER and
User response
DEFAULTSERVER options must specify the same
Uninstall the hardware product product TIVsm- SERVERNAME stanza in dsm.sys. You may also choose
BAhdw, or set the option DONTLOAD PIHDW to to supply a server stanza name using the
prevent the hardware plugin from being loaded. SERVERNAME option in dsm.opt or on the command
line. In either case the stanza name must match the
ANS8818E An error occurred trying to apply stanza specified in the MIGRATESERVER option.
your changes.
Your changes have not been ANS8939E An unexpected error occurred
applied to the system. trying to filter the directory tree.
Contact your system rc=return-code
administrator.
Explanation
Explanation
The filter was not applied to the directory tree.
An error occurred trying to apply your changes.
System action
System action
The directory tree is not filtered.
User changes are not applied.

390 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
Contact your system administrator for further The paramter value was rejected.
assistance.
ANS8946E RPC call failed. User response
In case you tried to set the specified value manually,
Explanation choose a value from the specified range instead. If the
value is read from a file system's space management
Unable to connect receiver recall daemon. configuration file (located at [fs]/.SpaceMan/
hsmfsconfig.xml), edit the file accordingly. The name
System action of the filesystem can be determined from a
Processing stopped. subsequent error message.
ANS9007W program name: invalid 'parameter
User response name' value: value (must be in
[minimum value..maximum value]).
System is not operating correctly or recall daemons
are not started.
Explanation
ANS8956E Port port which is specified by the
HSMRPCPORT option is already in The program found an invalid parameter in the space
use management configuration of a filesystem.

Explanation System action

The port specified by the HSMRPCPORT option is in The paramter value was rejected.
use by a different process.
User response
System action In case you tried to set the specified value manually,
Processing stopped. 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/
User response hsmfsconfig.xml), edit the file accordingly. The name
Update the HSMRPCPORT with new available port of the filesystem can be determined from a
number and restart HSM daemons subsequent error message.

ANS8957E Start of RPC Server process failed ANS9008W Compression is enabled. Recall
mode for file file-name cannot be
Explanation set to partial.

dsmrecalld can not start RPC server. Explanation

System action IBM Spectrum Protect can only set file attributes to a
uncompressed migrated file. This file has been
Processing stopped. migrated with compression enabled.

User response System action

Error detail can be found in system log. IBM Spectrum Protect does not set the file attributes.
ANS9005W program name: invalid 'parameter
name' value: value (must be in User response
[minimum value..maximum value]). Recall the file to state resident disable compression
and migrate the file again. Retry the operation.
Explanation
ANS9009E program name: found invalid
The program found an invalid parameter in the space space management configuration
management configuration of a filesystem. for 'filesystem'.

Chapter 2. ANS 0000-9999 messages 391

Explanation Explanation
The program found an invalid space management IBM Spectrum Protect could not write and save the
configuration for the given filesystem. space management configuration file for the given
filesystem.
System action
System action
The space management configuration was rejected for
the given filesystem . When updating an existing IBM Spectrum Protect did not save the space
configuration, invalid configurations to set are ignored. management configuration information. If you tried to
When a persistent configuration file is invalid, the add space management for this filesystem, it was not
filesystem will appear to not have space management added. If you tried to update the space managment
enabled. configuration, it was probably not updated. If an
existing configuration file in old format was read
User response successfully, but could not be converted to XML
format, space management will be active for this
In case you tried to update space management for this filesystem with the configuration from the old file.
filesystem manually, enter a valid configuration
instead. In case the persistent configuration file is
User response
invalid, edit the file accordingly; alternatively, you can
add space management explicitly (which will remove / Determine if there is any reason why the given file
overwrite the existing configuration). The reason for cannot be written.
the configuration can be determined from a preceding
error message. The filesystem's space management ANS9012E error-program: Command must be
configuration file is located at 'filesystem'/.SpaceMan/ run by root user.
hsmfsconfig.xml.
Explanation
ANS9010E program name: could not parse
space management configuration IBM Spectrum Protect requires that a root user
file 'configuration file' for perform this operation.
filesystem.
System action
Explanation IBM Spectrum Protect terminates the operation.
The space management configuration file for the given
filesystem is present but its content appears to have User response
invalid format.
Change to root user, and then retry the operation.

System action ANS9016E Cannot get space management

migration status for path.
The configuration was rejected. The filesystem will
appear to not have space management enabled.
Explanation

User response An error occurred while trying to get the space

management migration status. Either the permissions
Check the given space management configuration file; for the status file are not set correctly, or the status
it is supposed to contain a well-formed XML document file is damaged.
with a root element named 'HsmFsConfig'. To create a
new configuration file, you can simply add space
System action
management to this filesystem.
IBM Spectrum Protect terminates the operation.
ANS9011E program name: could not write
space management configuration
file 'configuration file' for User response
filesystem. The root user should check the permissions of the
status file, or contact the service representative.
ANS9017W error-program: Minimum number
of recall daemons min-dsmrecalld
cannot be greater

392 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 than maximum number of recall Explanation
daemons max-dsmrecalld;
A recall daemon stops abnormally.
defaulting to minimum min-
dsmrecalld and maximum max-
dsmrecalld. System action
IBM Spectrum Protect terminates the operation.
Explanation
A minimum number of recall daemons has been User response
entered that is greater than the maximum number of Try the operation again. If the problem persists, send
recall daemons. the core file to IBM technical support for analysis.
ANS9022E error-program Recall daemon (pid
System action
process-ID) ended abnormally,
IBM Spectrum Protect uses defaults instead of the status: status.
values specified in the client system options file
(dsm.sys). Explanation
A recall daemon stopped abnormally.
User response
Correct the MINRECALLDAEMONS and System action
MAXRECALLDAEMONS options in the client system
options file and retry the operation. The operation does not complete.

ANS9020E A session could not be established

User response
with a IBM Spectrum Protect
server or client agent. The return Try the operation again. If the problem persists, send
code is tsm-error;. the core file to IBM technical support for analysis.
ANS9024E Starting with this release all
Explanation candidate processing is done
An issue prevented the client from making a internally by the IBM Spectrum
connection with the IBM Spectrum Protect server. Protect monitor daemon. Thus -c
Additional detail is not available to include with this is no longer a valid
message. However, additional messages are likely to option for dsmreconcile.
be reported in the IBM Spectrum Protect error log.
Explanation
System action The command line options -c and -Candidates are no
Processing stops. longer valid for dsmreconcile as all candidates
processing is now performed by dsmmonitord.
User response
System action
Check the error log for additional messages. Refer to
those messages to determine how to resolve any IBM Spectrum Protect detected an invalid option.
reported issues. If the IBM Spectrum Protect-error is dsmreconcile is exiting.
-50, there is a communication failure. Typical causes
of this error include misconfiguration of the server User response
TCP/IP address or port. Verify the configuration and
Don't use options -c and -Candidates with
that the client system network is connected. Verify
dsmreconcile anymore.
that a firewall does not prevent access to the IBM
Spectrum Protect server. Finally, verify that the IBM ANS9025E The Data Protection for
Spectrum Protect server is running and accepting WebSphere plug-in version and
connections on the expected port. the backup-archive client version
ANS9021E do not match. Please upgrade your
error-program Unknown recall
Data Protection for WebSphere
daemon (pid process-ID)
plug-in.
terminated abnormally, status:
status.

Chapter 2. ANS 0000-9999 messages 393

Explanation System action
The release and version of the Data Protection for IBM Spectrum Protect does not set the file attributes.
WebSphere plug-in is downlevel from the release and
version of the Backup-Archive Client. User response
Retry this operation with attributes that do not conflict
System action
with each other. This error also appears if you try to
None set partial recall mode for an executable file.
ANS9031W File file-name is not a migrated
User response file.
Upgrade Data Protection for WebSphere to the proper
release and version. Explanation
ANS9028E program name: could not acquire IBM Spectrum Protect can only set file attributes to a
lock for filesystem. migrated file. This file has not been migrated.

Explanation System action

Prior to modifying a space management configuration IBM Spectrum Protect does not set the file attributes.
file, it is required to lock the file in order to avoid
concurrent access. If acquiring the lock fails, there User response
was a concurrent access.
Migrate this file, and then retry the operation.
System action ANS9032W File file-name is not in an HSM
The action was cancelled. managed file system.

User response Explanation

Retry the same request or determine the process IBM Spectrum Protect detects that the file is not in an
holding the lock. HSM managed file system, and therefore, it cannot
perform the operation requested.
ANS9029E The WebSphere server is running,
but the server must be shut down System action
for a restore operation. Shut down
the WebSphere server and try the IBM Spectrum Protect does not set the file attributes.
restore operation again.
User response
Explanation Add space management to the file system, migrate the
The WebSphere server must be brought down to file, and then retry the operation.
perform a restore. ANS9034E The restore operation did not
complete, due to a change in the
System action original WebSphere environment.
The restore operation fails.
Explanation
User response The data must be restored to the same environment
Shut down the WebSphere server and try the restore that it was backed up from. This includes items such
operation again. as cell name, node name, and the location where
WebSphere is installed.
ANS9030W Cannot set conflicting attributes to
file file-name. System action
The restore operation does not complete.
Explanation
IBM Spectrum Protect cannot set the file attributes
because the requested attributes are in conflict with
one another.

394 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Perform the restore procedure in the DP for None.
WebSphere book.
ANS9036W program-name: migrated file(s) System action
are missing on server for number None
stub file(s).
Look in 'file-spec' for file names. User response

Explanation Run "dsmc show plugins" at the command prompt to

see the available plug-ins on the system.
IBM Spectrum Protect cannot find the migrated file(s)
on the server. ANS9057W error-program: cannot get space
information for file-system: error.
System action
Explanation
Processing continues.
IBM Spectrum Protect cannot get the space
information for the file system.
User response
Look in the path mentioned in the message for the file System action
name. Also ensure that you are working with the
correct server for this file. Processing continues.

ANS9050I program-name: One or more User response

specified options are not valid.
Verify that space management has been added to the
Explanation file system.

IBM Spectrum Protect The specified options are not ANS9059E error-program: process cannot
valid. No option was changed. detach to become a daemon.

System action Explanation

Processing continues without changed options. IBM Spectrum Protect process cannot detach itself to
become a daemon.
User response
System action
Verify the specified options and correct the command
line options for the command. IBM Spectrum Protect cannot start the daemon as
requested. IBM Spectrum Protect stops.
ANS9051I program-name: The options were
successfully changed. User response

Explanation Retry the operation.

IBM Spectrum Protect Update of options was ANS9060W error-program: cannot get and
successful. increase limit of open files.

System action Explanation

Processing continues with changed options. IBM Spectrum Protect either cannot get the limit of the
number of open files, or cannot increase the limit of
the number of open files.
User response
Continue normal processing. System action
ANS9054E The plug-in was not found. IBM Spectrum Protect cannot increase the number of
open files, and was not able to complete the
operation.

Chapter 2. ANS 0000-9999 messages 395

User response operating system process limit. Then restart the HSM
daemons or reboot the system.
Free some file space by ending some processes or
removing some files, and retry the operation. ANS9065E File 'filename' or file 'filename2'
has been added or removed during
ANS9062E File 'filename' has changed during
the backup.
the backup.

Explanation
Explanation
A file was added or removed during the backup.
A file changed during the backup. Check the
dsmerror.log file for a list of files that have changed.
System action
System action The backup fails.
The backup fails.
User response
User response Try the backup again.
Try the backup again. ANS9067W error-program: error updating
dsmmigfstab file for file-system.
ANS9063E error-program: file system file-
system is out of inodes.
Explanation
Explanation IBM Spectrum Protect found an error in updating the
dsmmigfstab file for this file system.
IBM Spectrum Protect cannot get space for the file
system because the file system is out of inodes.
System action
System action IBM Spectrum Protect does not update the
dsmmigfstab file.
IBM Spectrum Protect cannot get space via migration.

User response
User response
See the preceding error message and correct the error
Remove some files to make more inodes available and
if possible. Then, retry the operation. If problem
retry.
persists, contact your system administrator.
ANS9064E error-program: Cannot fork a new
ANS9068I program-name: dsmmigfstab file
process: error.
updated for file system file-
system.
Explanation
IBM Spectrum Protect cannot fork a new process that Explanation
is needed. If the operating system errno is EAGAIN,
IBM Spectrum Protect successfully updated the
then the limit on the total number of processes
dsmmigfstab file for the file system.
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 System action
ENOMEM, then there is not enough memory to create Processing continues.
the process.
User response
System action
Continue with normal operation.
IBM Spectrum Protect cannot complete the requested
operation. ANS9069I program-name: all file systems are
reactivated to previous states.
User response
Depending on the error code (errno), either allocate
additional virtual memory (swap space) or increase the

396 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
IBM Spectrum Protect has reactivated all file systems IBM Spectrum Protect does not deactivate space
managed by HSM to their previous states before the management for FSM file systems.
global deactivation.
User response
System action
Make sure space management is installed correctly
Processing continues. and retry the operation.
ANS9073W program-name: error deactivating
User response space management for file system
Continue with normal operation. file-system.

ANS9070I program-name: space

Explanation
management is now deactivated
for all HSM file systems. IBM Spectrum Protect found an error in trying to
deactivate the file system.
Explanation
System action
IBM Spectrum Protect has deactivated space
management for all file systems listed in the IBM Spectrum Protect does not deactivate space
dsmmigfstab file. management for the file system.

System action User response

Processing continues. Make sure space management is installed correctly
and retry the operation.
User response ANS9074I program-name: space
Continue with normal operation. management functions have been
locally deactivated for file system
ANS9071W program-name: error reactivating file-system.
space management for all HSM file
systems.
Explanation

Explanation IBM Spectrum Protect has locally deactivated space

management functions like migration, recall and
IBM Spectrum Protect found an error in trying to reconciliation for the file system.
reactivate space management.
System action
System action
Processing continues.
IBM Spectrum Protect does not reactivate space
management for HSM file systems.
User response

User response Continue with normal operation.

Make sure space management is installed correctly ANS9075W program-name: error reactivating
and retry the operation. space management for file system
file-system.
ANS9072W error-program: error deactivating
space management for all FSM file
Explanation
systems.
IBM Spectrum Protect found an error in trying to
Explanation reactivate space management for the file system.

IBM Spectrum Protect found an error in trying to

System action
deactivate space management.
IBM Spectrum Protect does not reactivate space
management for the file system.

Chapter 2. ANS 0000-9999 messages 397

User response System action
Verify that the specified file system is mounted and IBM Spectrum Protect is unable to complete the
that HSM is enabled for this file system. Then try the requested operation.
operation again. If the problem persists, contact IBM
technical support for additional assistance. Provide User response
the /etc/filesystems (or equivalent file) and the output
from the mount and dsmdf commands. Refer to the immediately preceding error message and
retry the operation.
ANS9076I program-name: space
management functions have been ANS9079W program-name: no migrated files
locally reactivated for file system matching search criteria found.
file-system.
Explanation
Explanation IBM Spectrum Protect did not find any migrated files
IBM Spectrum Protect has locally reactivated space matching the search criteria.
management functions like migration, recall and
reconciliation for the file system. Please, note however System action
that the space management might still be globally
IBM Spectrum Protect cannot complete the requested
deactivated.
operation.

System action
User response
Processing continues.
Retry the operation with a different search criteria.

User response ANS9080E program-name: not enough space

in file system or storage pool to
Continue with normal operation. recall all migrated files.
ANS9077I program-name: removed space
management from file system file- Explanation
system.
IBM Spectrum Protect detects there is not enough
space in the file system to hold all the migrated files if
Explanation all are recalled. If you are using GPFS storage pools,
IBM Spectrum Protect removed space management. each pool needs to have enough space to recall it's
The file system is now a native file system. files.

System action System action

Processing continues. IBM Spectrum Protect does not attempt to recall all
the migrated files.
User response
User response
Continue with normal operation.
Make room in the file system by increasing the file
ANS9078W Space management is not system size or removing some files. Retry the
removed from file system file- operation.
system.
ANS9081W program-name: orphaned stub
file(s) detected in file system file-
Explanation
system.
IBM Spectrum Protect was not able to remove space
management from this file system. Possible causes: Explanation
Kernel extension is downlevel. IBM Spectrum Protect detected one or more orphaned
Program is downlevel. stub files. Either the migration server was changed in
Insufficient disk space. the client system options file after the file was
migrated, or the migration server database is
damaged.

398 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
IBM Spectrum Protect does not attempt to remove Add space management to the file system, if
space management from the file system. appropriate, and then retry the operation. If the file
system is not locally managed, retry the operation on
User response the node managing the file system.

Determine the cause of orphaned stub files. Switch to ANS9085E program-name: file system file-
the correct migration server and recall the migrated system is not managed by space
files. Retry the operation. management.

ANS9082W program-name: error encountered

Explanation
while reconciling file system file-
system. There is no entry for the file system in the
dsmmigfstab file.
Explanation
System action
IBM Spectrum Protect encountered an error
performing reconciliation on the file system. IBM Spectrum Protect will not perform space
management functions on this file system.
System action
User response
Processing continues.
Add space management to the file system, if
User response appropriate, and then retry the operation.

Refer to other messages displayed or messages in the ANS9086E program-name: A DMAPI error
log to correct the problem. Then retry the operation. occured adding space
management to file system file-
ANS9083W program-name: cannot deactivate system, it is possible DMAPI is
space management on file system disabled on this file system. The
file-system. system set the error code: errno =
errno-value
Explanation
IBM Spectrum Protect cannot deactivate space Explanation
management on the file system. IBM Spectrum Protect encountered an error and
cannot add space management to the file system.
System action
Processing continues. System action
The Space management cannot be added to file
User response system.
Correct the error if possible and retry the operation.
User response
ANS9084E program-name: file-system is not
managed or not locally managed Verify that DMAPI is enabled for this file system and
by space management. retry the operation.
ANS9087I Space management is successfully
Explanation added to file system file-system.
There is no entry for the file system in the
dsmmigfstab file or the file system is managed by Explanation
another node. IBM Spectrum Protect has added space management
to the file system, and will now monitor its space
System action usage. You can also perform other space management
operations on this file system.
IBM Spectrum Protect will not perform space
management functions on this file system.

Chapter 2. ANS 0000-9999 messages 399

System action System action
Processing continues. Processing continues.

User response User response

Continue with normal operation. Correct the file system name, and retry the operation.
ANS9088W program-name: space ANS9091E The WebSphere backup validation
management is already active for failed. One or more files were
file system filesystem. added, removed, or changed
during the backup.
Explanation
Explanation
This message is issued when trying to add space
management to a filesystem with space management One or more files have been added, removed, or
already activated. It is not possible to add space changed from the time WebSphere was queried to the
management for a filesystem that already has space time that all the data was sent to the IBM Spectrum
management activated. Protect server. Check the dsmerror.log file for a list of
files that were added, removed, or changed.
System action
System action
The action was cancelled.
The backup fails.
User response
User response
In case you wanted to update the filesystem's space
management configuration instead, use the Try the backup again. Do not install new WebSphere
appropriate update command. applications or change the WebSphere configuration
while in the backup window.
ANS9089E The group backup validation
failed. One or more files were ANS9093W program-name: cannot update
added, removed, or changed migration candidates list file-
during the backup. name.

Explanation Explanation
One or more files have been added, removed, or IBM Spectrum Protect cannot update the migration
changed from the time WebSphere was queried to the candidates list because not enough memory is
time that all the data was sent to the IBM Spectrum available to create a temporary file.
Protect server. Check the dsmerror.log file for a list of
files that were added, removed, or changed. System action
Processing stops.
System action
The backup fails. User response
Make some memory available by ending some
User response
processes, and then retry the operation.
Try the backup again.
ANS9094W program-name: no candidates
ANS9090E program-name: file-system is not a found in file system file-system.
valid file system name.
Explanation
Explanation
IBM Spectrum Protect found no files eligible for
IBM Spectrum Protect received an invalid file system migration in the file system after running
name. The file system is not mounted, or is not dsmreconcile.
mounted correctly.
System action
Processing continues.

400 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Continue with normal operation. File name for search pattern can not be found in the
IBM Spectrum Protect server database as a migrated
ANS9098E program-name: space file.
management does not support file
system file-system.
System action
Explanation No query result.
The space management does not support this type of
file system. Space management supports only true User response
local file systems (e.g. JFS on AIX). Space Verify that the search patter is correct.
management does not support other types of file
systems (AFS, NFS, etc). ANS9117E Virtual machine 'VM_name'
contains one or more of the
following unsupported special
System action
characters special_characters_list.
Processing of the file system stopped.
Explanation
User response
The specified virtual machine name contains
None. characters that are not supported for virtual machine
backup and restore operations. The following
ANS9099E program-name: space characters are not supported in names of restored
management is not active for file virtual machines: ":;'\"*?,<>/\\|"
system file-system.
System action
Explanation
The backup or restore for the specified virtual machine
IBM Spectrum Protect found the file system did not failed.
have space management activated.
User response
System action
Rename the virtual machine without using
Processing of that file system stopped. unsupported special characters.

User response ANS9121I Activate completed.

Reactivate space management for the file system.

Explanation
ANS9100E Unable to open file 'filename' for A Domino activate databases operation was
output. completed.

Explanation System action

The file name specified cannot be opened. IBM Spectrum Protect activated the databases.

System action User response

Make sure that user has access to write to specified Continue with normal operations.
file, or use different file name.
ANS9126E program-name: cannot determine
User response whether space management is
active or inactive for file-system
Output will not be saved. Please specify different file due to error: error.
or check permissions on chose file.
ANS9101E Migrated files matching 'file-name' Explanation
could not be found. The program 'program-name' indicated in the message
text was unable to obtain statistics for file system 'file-
system'. Therefore the program cannot determine

Chapter 2. ANS 0000-9999 messages 401

whether space management is activated, deactivated, Explanation
or globally deactivated on that file system. The
This message is issued when trying to add space
message text includes a description of the Unix errno
management to a filesystem with space management
error that occurred while trying to get the state of
already activated.
space management.

System action
System action
The action was cancelled.
IBM Spectrum Protect stops the operation.

User response
User response
Check the filesystem's space management
Verify that the file system is mounted and accessible.
configuration and consider updating it in case it does
Using the appropriate tools for that file system, check
not match your needs. It is not possible to add space
whether there are any I/O or other integrity errors on
management for a filesystem that already has space
that file system. Then try the operation again. If the
management activated.
operation fails, then a system reboot might clear the
error condition. If, after taking these actions the ANS9134E program name: space
problem persists, contact IBM technical support for management not active for
assistance. filesystem.
ANS9128I Inactivate logs completed.
Explanation
Explanation The program requested the space management
configuration for a file system where space
A Domino inactivate log operation was completed.
management is not active.

System action
System action
IBM Spectrum Protect inactivated the log.
The action was cancelled.

User response
User response
Continue with normal operations.
In case you entered the filesystem specification, check
ANS9130E The virtual machine name for correct spelling. It is not possible to perform space
contains only whitespace management actions on a filesystem with space
characters. management not activated.
ANS9135E program name: space
Explanation management for filesystem not
The virtual machine name that was specified contains controlled by the local node.
only whitespace characters. A name consisting of only
whitespace characters is not supported for virtual Explanation
machine backup and restore operations.
The program requested the space management
configuration for a file system where space
System action management is active, but not controlled by the local
The backup or restore for the specified virtual machine node. In cluster environments, some space
failed. management actions are allowed from the owner node
only.
User response
System action
Rename the virtual machine using valid characters. Try
the operation again. The action was cancelled.

ANS9133E program name: space User response

management already active for
filesystem. Determine the controller node for this filesystem and
retry.

402 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS9136E program name: could not remove System action
configuration file for filesystem. The backup for the specified virtual machine fails.

Explanation
User response
During removal of space management for the given Rename the virtual machine so that its name contains
filesystem, this configuration file could not be
supported characters.
removed.
ANS9146E The dsmrecalld daemon process
System action running on node local-node cannot
reach the counterpart on node
Space management could not be deactivated for this remote-node. RPC error code:
filesystem. rpcStat-value, reason: rpcStat-
explanation
User response
Determine the reason why the file could not be Explanation
removed and retry. IBM Spectrum Protect dsmrecalld executable running
ANS9137I File: file-name is not premigrated. on the local node was unable to connect to the remote
counterpart executable via RPC.
Explanation
System action
File must be premigrated to migrate it.
Processing of the current operation is stopped.
System action
User response
The file was skipped.
Login to the indicated remote node and ensure that
the dsmrecalld daemon processes are running. If the
User response daemon processes are running but the warning
The migration of premigrated files requires that the file continues, make sure that the appropriate RPC
is in premigration state. services are up and running on both nodes. To do so: -
on Linux, run 'service portmap status' or 'service
ANS9140E The migration options rpcbind status' or 'systemctl status rpcbind' command
premigration and stub cannot be depending on the Linux distribution in use; - on AIX,
combined. run 'lssrc -s portmap' command. If the RPC error
reason is "Program not registered" or the RPC error
Explanation persists even upon the RPC service restart, restart all
the HSM daemons via 'dsmmigfs restart' command on
The migration option premigration and stub are mutual
both nodes.
exclusive. Both options end in different results for the
same file. ANS9147E program-name: cannot read file-
spec: error.
System action
Command ends without changes to the file. Explanation
IBM Spectrum Protect cannot read this file.
User response
Use the migration options premigration and stub in System action
different instances of the command. IBM Spectrum Protect cannot fully complete the
ANS9145E requested operation.
Virtual machine will not be backed
up because it has an empty name.
User response
Explanation An error occurred reading an HSM managed file
system status file. Verify that the file system is
The specified virtual machine name is empty. This is
mounted and enabled for HSM and is actually
not supported for virtual machine backup and restore
managed by HSM and then try the operation again. If
operations.
the problem persists, contact IBM technical support

Chapter 2. ANS 0000-9999 messages 403

for further assistance. Provide the output from the ANS9152E program-name: cannot deactivate
mount, dsmdf and ls -l [file system name] commands. space management for whole
system: error.
ANS9148E program-name: cannot find mount
point for file system file-system.
Explanation
Explanation Space management cannot be deactivated for the
whole machine.
IBM Spectrum Protect cannot find file system mount
point.
System action
System action IBM Spectrum Protect cannot deactivate space
management support.
IBM Spectrum Protect cannot complete the requested
operation.
User response
User response The HSM global status is inaccessible, possibly due to
concurrent access. Try the operation again. If the
The specified file system is not currently mounted.
problem continues, examine the output of the shell
Mount the file system and try the operation again.
command ps -aef as well as the contents of /etc/
ANS9150I Archive log completed. adsm/SpaceMan/config/dmiFSGlobalState.pid. If a pid
is stored in this file and it does correspond to a running
Explanation process, remove the dmiFSGlobalState.pid file and
retry the operation. If the problem persists, reboot the
A Domino archive log operation was completed. system and repeat the appropriate analysis for your
file system type.
System action
ANS9153E program-name: cannot reactivate
IBM Spectrum Protect archived the log. space management for whole
system: error.
User response
Explanation
Continue with normal operations.
Space management cannot be reactivated for the
ANS9151E An unexpected program error was whole machine.
encountered .
IBM Spectrum Protect function
name : function-name System action
IBM Spectrum Protect function : IBM Spectrum Protect cannot reactivate space
function-desc management support.
IBM Spectrum Protect return
code : TSM-rc User response
IBM Spectrum Protect file : file-
name (line-number) The HSM global status is inaccessible, possibly due to
concurrent access. Try the operation again. If the
Explanation problem continues, examine the output of the shell
command ps -aef as well as the contents of /etc/
None. adsm/SpaceMan/config/dmiFSGlobalState.pid. If a pid
is stored in this file and it does correspond to a running
System action process, remove the dmiFSGlobalState.pid file and
retry the operation. If the problem persists, reboot the
Processing stops. system and repeat the appropriate analysis for your
file system type.
User response
ANS9154E program-name: cannot deactivate
Check error log for more information. Contact the IBM space management for file system
Spectrum Protect administrator with the information file-system: error.
provided in this message.

404 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
Space management cannot be deactivated for the file IBM Spectrum Protect cannot create a temporary file.
system.
System action
System action
IBM Spectrum Protect cannot complete its operation.
IBM Spectrum Protect unable to deactivate space
management support for the file system. User response
Check with the Unix mount shell command that /tmp
User response
and /etc exist as separate file systems on your system.
The HSM file system status is inaccessible, possibly Use the df command to check whether they are full.
due to concurrent access. Try the operation again. If Create additional space by deleting files or increasing
the problem continues verify that the file system is the file system size.
mounted and that HSM is enabled on the file system
ANS9160E program-name: cannot write to
with the Unix shell commands mount and dsmdf. If the
temporary file or status filefile-
problem persists, reboot the system and try the
spec: error.
operation again.
ANS9155E program-name: cannot reactivate Explanation
space management for file system
file-system: error. IBM Spectrum Protect cannot complete writing to the
temporary file.
Explanation
System action
Space management cannot be reactivated for the file
system. IBM Spectrum Protect cannot complete the requested
operation.
System action
User response
IBM Spectrum Protect cannot reactivate space
management support to the file system. 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
User response
mounted and has space available. If this message
The HSM file system status is inaccessible, possibly resulted from a shell command, mount the file system
due to concurrent access. Try the operation again. If and create additional space if necessary, then retry the
the problem continues, verify that the file system is operation. If the message did not result from a shell
mounted and that HSM is enabled on the file system command, restart the daemons. If the problem
with the Unix shell commands mount and dsmdf. If the persists, reboot the system.
problem persists, reboot the system and try the
ANS9161E Invalid backupset file or device
operation again.
name entered.
ANS9156I Rollforward completed.
Explanation
Explanation
The backupset file or device name specified does not
A Domino DB2 rollforward operation was completed. contain a valid backupset.

System action System action

IBM Spectrum Protect rollforward the Domino DB2 Processing stopped.
database log.
User response
User response
Specify a file name or device that contains a valid
Continue with normal operations. backupset and retry the operation.
ANS9159E program-name: unable to create ANS9162W Object: 'dir-name' is skipped for
temporary file. recall: It is a directory.

Chapter 2. ANS 0000-9999 messages 405

Explanation ANS9165E program-name cannot open
directory directory-spec due to the
The object is a directory. Space management does not
following error: error.
recall directories.

Explanation
System action
The directory indicated in the message text cannot be
IBM Spectrum Protect does not recall this object
opened. The message text includes a description of
because it is a directory.
the error that occurred.

User response
System action
None.
The requested operation is not completed.
ANS9163W program-name: Could not acquire
the recall daemon session id. User response
Try to correct the error condition that is indicated in
Explanation
the message text, then try the operation again. If the
Could not set up the event disposition for the file problem persists, contact IBM technical support for
system, because the recall daemon session could not further assistance.
be acquired. It seems the recall daemon is not
ANS9166I A 'backup type' backup version
running. Recall requests will not be handled, which
means the IBM Spectrum Protect client for space backup date 'datetime' is not
management can't react to recall requests for this file consistent with local repository
system. and has been deleted from the
server (object name='filespace
namepath-namefile-name', ID =
System action 'object-id:object-id').
IBM Spectrum Protect could not set up the recall
event handling. The recall event handling is not Explanation
enabled for this filesystem.
The specified backup instance of the named object is
not valid with local repository contents. This could
User response happen if local repository is modified or got corrupted
Start or restart the recall daemon. on the client system. This backup can not be restored,
therefore it will be deleted on the server.
ANS9164W program-name: Could not acquire
the monitor daemon session id.
System action

Explanation The specified backup object will be deleted on the

server. Processing will continue.
Could not set up the event disposition for the file
system, because the monitor daemon session could
User response
not be acquired. It seems the monitor daemon is not
running. Thus the thresholds for file system usage will None.
not be monitored and the NOSPACE event will not be
ANS9167W The client cache for adaptive
handled, which means the file system may run out of
space. subfile backup is corrupt and
cannot be used.
System action
Explanation
IBM Spectrum Protect could not set up the NOSPACE
event handling. The NOSPACE event handling is not The adaptive subfile cache has become corrupt. While
enabled for this filesystem. the backup client can detect the corruption, the reason
for the corruption cannot be determined.
User response
System action
Start or restart the monitor daemon.
The IBM Spectrum Protect client will proceed with
standard selective or incremental backup. The cache

406 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
will be rebuilt so that subsequent backups will use the ANS9174I A backup delete completed.
adaptive subfile technique.
Explanation
User response
A Backup delete was completed.
If the problem persists, contact IBM technical support
for assistance. Be prepared to provide the client error System action
log, which will contain additional messages that might
be useful for support to help identify the problem. IBM Spectrum Protect deleted backup files.

ANS9169E program-name: cannot create ANS9177W All data events for remote recalls
directory directory-spec, reason. running on node: 'cluster node ID',
hostname: 'cluster node hostname'
are going to be aborted.
Explanation
IBM Spectrum Protect cannot create this directory. Explanation
The remote node is not responding, so all DMAPI data
System action
events which are currently being processed on this
IBM Spectrum Protect does not create this directory. remote node should be aborted. This warning is likely
caused by an RPC communication issue between the
User response local node and the specified remote node.
Verify that this directory does not already exist, and
System action
that its parent directory has proper permissions.
The dsmrecalld distributor process is going to abort all
ANS9170E program-name: file-system is not a
data events (if any) which are currently being
mounted local file system.
processed on the specified remote node.

Explanation
User response
IBM Spectrum Protect did not find that this file system
Ensure that the network and host connection are
is properly mounted.
configured correctly. Then, retry the recall operation.

System action ANS9178E program-name cannot open file

file-spec due to the following error:
IBM Spectrum Protect ignores the file system. error.

User response Explanation

Verify that this file system is local and mounted and The program indicated in the message text was unable
activated properly. to open the specified file. The message text also
ANS9171E An error internal to IBM Spectrum includes a description of the error that occurred when
Protect has occurred. The it tried to open the file.
following string is too long: error.
System action
Explanation The requested operation does not complete.
None.
User response
System action Verify that the file system on which the file resides is
The requested operation does not complete. mounted, then try the operation again. A system
reboot might clear up the problem. If the problem
persists, contact IBM technical support for further
User response
assistance.
A system reboot might clear up the problem, after
ANS9179W The operation completed
which the operation should be tried again. If the
problem persists, contact IBM technical support for successfully. However, some error
further assistance. occurred on creation of the
required vApps list.

Chapter 2. ANS 0000-9999 messages 407

Explanation ANS9186E program-name: cannot open
mounted file system file-system:
One or more of the items included in the vApps
error.
specification were not found. This can be caused by a
change in the vCD organizations configuration or a user
mistake in the provided vApp spec. Explanation
IBM Spectrum Protect cannot open mounted file
System action system.
The operation completes successfully
System action
User response IBM Spectrum Protect ignores the file system.
Check the local client error log for a reason for the
failure and check the command specification. Correct User response
any issues and execute the command again. Verify that this file system is mounted and activated
ANS9180W An entry in the password file could properly.
not be decrypted. ANS9201W LAN-free path failed.

Explanation Explanation
The password failed decryption validation. A LAN-free connection could not be made.

System action System action

The password in the password file will be ignored. You The system will connect to the server without using
will be prompted for the password, unless the process the LAN-free path.
is running in the background, such as in scheduling
mode.
User response

User response Verify your LAN-free setup.

Enter the password when prompted. ANS9203E ENABLELANFREE can not be used
when HSM is installed.
ANS9184E program-name cannot allocate
memory due to the following error:
Explanation
error.
The IBM Spectrum Protect Client has detected that
Explanation HSM is installed on the system. LAN-free is not a valid
option when HSM is installed.
A memory allocation error occurred. The message text
includes a description of the error that occurred. • This error occurs on AIX when this file is found: /usr/
tivoli/tsm/client/hsm/bin/dsmrecalld
System action • This error occurs on Solaris when this file is
found: /opt/tivoli/tsm/client/hsm/bin/dsmrecalld
The requested operation does not complete.

System action
User response
An invalid option is detected and processing stops.
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 User response
your operating system's administrative tools to check Remove the ENABLELANFREE option from the system
virtual memory (swap space) on your system, and option file. ENABLELANFREE can only be used when
increase it if necessary. Check whether an application HSM is not installed.
is consuming available virtual memory. A system
reboot might also clear up the problem. If the problem ANS9220E The name of the virtual machine
persists, contact IBM technical support for further 'VM_name' contains
assistance. 'VM_name_length' characters. This
length exceeds the maximum

408 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 allowed by the hypervisor Explanation
'hypervisor_name' which is
IBM Spectrum Protect has finished reconciling the file
'max_hypervisor_VM_name_length'
system.
characters.

System action
Explanation
Processing continues.
The length of the name of the virtual machine exceeds
the maximum length allowed by the hypervisor.
User response
System action Continue with normal operations.
The restore of the specified virtual machine failed. ANS9251E ProgramName: Cannot parse
command-line options correctly.
User response
Explanation
Rename the virtual machine with a name that does not
exceed the maximum length set by the hypervisor. Try An internal program error occurred trying to parse the
the restore operation again. command-line arguments.
ANS9240W Could not acquire the serial
number of disk 'disk-name' at LUN System action
LUN-id. The program is not able to process the request.

Explanation User response

IBM Spectrum Protect was not able to determine the Use the -h or -help option to see what options are
serial number of the specified disk. The disk may not allowed on the command-line, then retry the request.
support SCSI inquiries of the Vital Product Data on
page 0x80. ANS9252I Value of environment variable:
envVar.
System action
Explanation
Server-free data movement will not be possible for
data residing on the specified disk. None.

User response System action

None. This message is informational.

ANS9249E File 'file-namefile-namefile-name'

User response
accessed during migration. File
skipped. None.
ANS9255I An empty status file will be
Explanation generated.
The specified file-name was not migrated because the
file was accessed by another process during the Explanation
attempt to migrate it.
The HSM status file is missing or can not be opened.
An empty status file will be created.
System action
IBM Spectrum Protect left the file resident. System action
File data migration will continue to work normally.
User response
If you want the file migrated, stop the process which is User response
accessing the file and retry the migration.
Please run dsmreconcile to create a complete status
ANS9250I File system 'file-system' file.
reconciliation completed.

Chapter 2. ANS 0000-9999 messages 409

ANS9256E File 'file-namefile-namefile-name' ANS9267E program-name: File system file-
is currently opened by another system has exceeded its quota.
process.
Explanation
Explanation
IBM Spectrum Protect detects that the file system has
The file is locked by a migration or recall operation. A exceeded its quota. No more data can be migrated out
file can be the object of only one recall process or one of this file system.
recall operation at a time.
System action
System action
IBM Spectrum Protect will not migrate files from this
The file is skipped. file system.

User response User response

If this error is not a result of a parallel file migration or Recall some files, or ask the system administrator to
recall operation, then this error might be due to the increase the quota for this file system.
previous cancelled migration or recall operation. In
ANS9278E Failure processing vmList option.
this case, restart the dsmrecalld daemon and try the
RC=rc
operation again.
ANS9263W You cannot restore both active and Explanation
inactive versions of System State.
Failure processing vmList option.
Explanation
System action
Restoring an active copy and inactive copy of System
State is not allowed. The backup can not continue.

System action User response

No processing takes place. Check for errors in the vmList option value. Refer to
the documentation for the vmList option for more
information.
User response
ANS9279E Failure locating Virtual Machine
Select either the active copy or the inactive copy to
perform restore operation. 'vmname' volumes. Failed with
RC=rc
ANS9264E Incremental backup of Virtual
Machine 'vmname' failed with RC Explanation
rc
Virtual machine volumes can not found. Volume mount
points are not available on Backup Proxy machine.
Explanation
The incremental backup of virtual machine volumes System action
failed.
The backup of the virtual machine can not continue.
The next virtual machine in the vmlist will be
System action
processed. The output of the vcbMounter command
The backup of the virtual machine finished with will show the reason for the failure.
failures. The next virtual machine in the vmlist will be
processed. The reason for the failure is written to the User response
local client error log.
Issue a vcbMounter command for the virtual machine
to determine the reason for the failure. Refer to the
User response
documentation for that message for more information.
Check the local client error log for reason for the
ANS9280E 'vmname' option must be set when
failure.
running this operation.

410 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation - The space that a file occupies (the allocated size) is
at least as great as the value of the minmigfilesize
A required option for the command is missing.
option.

System action
System action
The operation can not continue.
IBM Spectrum Protect does not migrate this file
because migration does not free additional space.
User response
Set the missing option using the Preference Editor or User response
the command line.
Verify that the settings of the stubsize option and the
ANS9283E No virtual machines have been minmigfilesize option are appropriate for your
associated with the Schedule Tag migration requirements.
'schedule'.
ANS9289W Object: 'dir-name' is skipped for
migration: It is a directory.
Explanation
The command cannot execute because no virtual Explanation
machines were found using the provided schedule
The object is a directory. Space management does not
name. This error can also be caused by incorrect
migrate directories.
settings for the 'Excluded' tag.

System action
System action
IBM Spectrum Protect does not migrate this object
Processing stopped.
because it is a directory.

User response
User response
Try the operation again. Specify a schedule name that
None.
matches a relevant schedule.
ANS9290W File: file-name is skipped for
ANS9287E Invalid or unsupported device.
migration: The file type is either
unknown or unsupported.
Explanation
The logical volume device is either invalid or Explanation
unsupported.
The file either cannot be read, is not a regular file, or
Refer to the documentation for device type support for
its type is unknown to the HSM client. The HSM client
image backup.
migrates only regular files and does not migrate
directories, symbolic links, and special files.
System action
The logical volume operation is not performed. System action
IBM Spectrum Protect does not migrate this file.
User response
For image backup source or image restore destination, User response
specify a device of one of the supported types.
None.
ANS9288W File: file-name of logical size file-
ANS9291E program-name: A conflicting space
logical-size and allocated size file-
management program is already
allocated-size is too small to
running in the file-system file
qualify for migration.
system.
Re-run this program later in this
Explanation file system.
To be eligible for migration, a file must satisfy all of the
following size criteria:
- The file logical size is larger than the value of the
stubsize option.

Chapter 2. ANS 0000-9999 messages 411

Explanation System action
IBM Spectrum Protect detected another program IBM Spectrum Protect cannot send a severe error
running in the file system that cannot run at the same message to the specified error message program.
time as the program your tried to initiate. The
following programs cannot run at the same time for a User response
file system:
Check to make sure the program exists and that it
dsmreconcile accepts standard input when run. It is usually best if
dsmautomig ERRORPROG specifies the fully qualified file name of
dsmmigfs remove. the program.
Also, dsmmigfs remove cannot run while a migration ANS9294I No files matching 'file-name' were
process is running in the file system. found.

System action Explanation

IBM Spectrum Protect will not run the program at this You entered a search pattern or file name that cannot
time. be found in the local file system.

User response System action

Try running the program later. Processing stopped.
ANS9292E program-name: Cannot access
lock file lock-file/lock-filelock-file: User response
error Ensure that your search pattern is correct, or specify a
new search string.
Explanation
ANS9296W Performing image backup of the
IBM Spectrum Protect cannot access a lock file due to entire volume for volume name.
an error. The lock file provides serialization of certain The IMAGEGAPSIZE option and
programs to prevent conflicting processes from used block image backup is not
running at the same time. supported for non-JFS2 file
systems on AIX.
System action
Explanation
IBM Spectrum Protect will not run the program at this
time. None.

User response System action

Check the permissions on the directories leading up to The entire volume is backed up.
the lock file and also the permissions on the program
executable. User response
ANS9293E The space management cannot Refer to the client manual for additional information
access ERRORPROG error-program: regarding the IMAGEGAPSIZE option and used block
error image backup.
ANS9297W File file-name is skipped for
Explanation
migration: No backup copy found.
IBM Spectrum Protect encountered an error trying to
access the program specified with the ERRORPROG Explanation
option in your client system options file (dsm.sys).
This message will appear only the first time this error A management class is assigned to the file with the
occurs. 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 Spectrum Protect checks only the

412 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
migration server for a backup copy. If the migration User response
server and backup server are different servers, IBM
Run reconciliation to reconcile the file system. Retry
Spectrum Protect does not find a backup copy of the
operation.
file.
ANS9300I Migrated files found in file system
System action file-system.
Check for any error encountered
The file is skipped. during recall.

User response Explanation

Back up this file on the migration server, or assign a Remove space management failed because there are
management class to this file that does not require a migrated files in the file system. IBM Spectrum Protect
current backup copy. Try the operation again. was unable to recall any files, or some of the migrated
ANS9298W File file-name is skipped for files may have failed during a recall operation.
migration: Backup copy found is
not current. System action
IBM Spectrum Protect remove processing stops.
Explanation
A management class is assigned to the file with the User response
attribute MIGREQUIRESBKUP set to YES. This option
Check for error messages that occurred during the
requires that there exists a current backup copy of the
recall process, correct any problems, and retry the
file before migration. However, the backup copy found
remove process.
on the migration server is an old version. This file is not
migrated. Note: IBM Spectrum Protect checks only the ANS9301E Full VM backup of Virtual Machine
migration server for a backup copy. If the migration 'vmname' failed with RC rc
server and backup server are different servers, there
must be a valid backup copy of the file on the Explanation
migration server.
The Full VM backup of virtual machine failed.
System action
System action
The file is skipped.
The full backup of the virtual machine finished with
User response failures. The next virtual machine in the vmlist will be
processed. The reason for the failure is written to the
Back up the current file on the migration server, or local client error log.
assign a management class to this file that does not
require a current backup copy. Retry the operation. User response
ANS9299I Cannot get the number of Check the local client error log for reason for the
migrated files for file system file- failure.
system.
ANS9302E The Restore VM command does
Explanation not support
VMBACKUPTYPE=FILE data.
Failed to get the number of migrated files on the file VM File level restore must be run
system. The number is stored in the status file for the from inside the virtual machine or
file system. with the 'asnodename' option.

System action Explanation

If you are removing space management from the file The Restore VM function not supported for file level
system, processing stops. Space management is not data.
removed.
System action
The system does not process your requested action.

Chapter 2. ANS 0000-9999 messages 413

User response ANS9306E An invalid Hyper-V VM list 'string'
was entered.
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 Explanation
the command with VMBACKUPTYPE=FULLVM. You entered a Hyper-V VM list that contains incorrect
ANS9303E Full VM restore of Virtual Machine characters or contains wildcard characters.
'vmname' failed with RC rc
System action
Explanation Processing stopped.
The Full VM restore of virtual machine failed.
User response
System action Enter a correct Hyper-V VM list.
The full restore of the virtual machine finished with ANS9307E No Hyper-V VM name or VMList
failures. The next virtual machine in the vmlist will be entered
processed. The reason for the failure is written to the
local client error log.
Explanation

User response No Hyper-V VM name or VMList parameter was

specified.
Check the local client error log for reason for the
failure.
System action
ANS9304E VMware Converter tool not
Processing stopped.
installed on system.

User response
Explanation
Specify a correct Hyper-V VM name or VMList
VMware Converter tool install could not be detected
parameter.
on system.
ANS9308E No match found for the Hyper-V
System action VM name or VMList 'string' entered
The full virtual machine image files have been restored
Explanation
successfully at the specified location.
No match found for the Hyper-V VM name or VMList
User response parameter entered.

No further action is necessary. The full virtual machine

System action
images files can be used by various tools. VMware
Converter tool can be installed on system. Processing stopped.
ANS9305E An invalid Hyper-V VM name
'string' was entered. User response
Specify a correct Hyper-V VM name or VMList
Explanation parameter.
You entered a Hyper-V VM name that contains ANS9309E Pick option specified but also a
incorrect characters or contains wildcard characters. value for the Hyper-V VM name or
VMList 'string' entered
System action
Explanation
Processing stopped.
You cannot specify the -pick option and also include a
User response Hyper-V VM name or VMList parameter.

Enter a correct Hyper-V VM name.

414 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action ANS9316T File system 'file-system' undelete
completed.
Processing stopped.

Explanation
User response
IBM Spectrum Protect has finished undeleting the file
Specify the -pick option without a Hyper-V VM name or
system.
VMList parameter.
ANS9311E No Hyper-V VMs exist on the IBM System action
Spectrum Protect server
Processing continues.
Explanation
User response
No filespaces representing a Hyper-V Virtual Machine
currently exist on the IBM Spectrum Protect server. Continue with normal operations.
ANS9330E The virtual machine that was
System action specified on the string command
could not be found or was
Processing stopped.
excluded from the operation.

User response
Explanation
You must successfully backup a Hyper-V Virtual
The command cannot complete because the virtual
Machine before using this command.
machine could not be found or was excluded from the
ANS9312S program-name: Cannot change operation.
owner/group on file: file-name:
error System action
Processing stopped.
Explanation
IBM Spectrum Protect cannot change the ownership or User response
group, or both for the specified file. This change is
necessary for space management to run properly. Try the operation again. Specify a correct VM name or
DOMAIN option. This error can also be caused by
incorrect settings for the VMHOST, VMHOSTCLUSTER,
System action
VMFOLDER, VMDATASTORE, -VM options, or the
Processing stops. 'Excluded' tag. The VMHOST option value must be
specified as an IP address or as a server name that is
User response in fully qualified domain name (FQDN) format. The
host name that you specify must match the host name
Ensure that directory permissions allow the file owner as it is displayed in the vCenter server in the Host and
or group to be changed. Reissue the command. Clusters view. This host name could can be the fully
ANS9313E program-name: The TMP directory qualified host name (FQDN), the shortened domain
is full. name, or the host IP address.
ANS9331W VMware vCenter or ESX Server
Explanation userid and password for VMC Host
<host> VMC Userid <userid> could
The TMP directory from the operating system is full.
not be read from encrypted pwd
file.
System action
Process stops. Explanation
VMware vCenter or ESX Server userid and password
User response could not be read from encrypted password file.
Delete some files in the TMP directory and retry the
operation. System action
Processing stops.

Chapter 2. ANS 0000-9999 messages 415

User response System action
Use dsmc SET PASSWORD -type=VM 'vCenter The processing continues with the next file.
hostname' 'userid' 'password' to save encrypted
password. User response
ANS9332E VMware vCenter or ESX Server If possible, perform either an orphan check reconcile
userid and password not set. Use or an inline incremental backup of the initial file, so
dsmc SET PASSWORD -type=VM that the alias is updated on the server. Then, retry the
'vCenter hostname' 'userid' operation. Otherwise, contact IBM Spectrum Protect
'password' to save encrypted support for further investigation and problem
password. resolution.
ANS9347W Warning:'domain-keyword'
Explanation
specified on Domain will be
VMware vCenter or ESX Server userid and password ignored when connecting to
could not be read from encrypted password file. VMware ESX/ESXi host. Connect
to VMware vCenter to process this
System action domain.

Processing stops.
Explanation

User response None.

Use dsmc SET PASSWORD -type=VM 'vCenter

System action
hostname' 'userid' 'password' to save encrypted
password. Domain keyword is ignored.
ANS9333E Unable to re-create 'file-name' as a
stub file due to Unix-system-call() User response
failure; errno: error; reason: 'error- Connect to VMware vCenter to process this domain.
reason'.
ANS9350E Backup operation failed due to
volume mixture.
Explanation
Please refer to explanation section
IBM Spectrum Protect was unable to re-create the for additional information.
specified file as a stub due to an error.
Explanation
System action
IBM Spectrum Protect failed to create the backup
The processing continues with the next file. because of the mixture of volumes was detected.
Some volumes selected meet the requirements for
User response importing snapshots only when needed and some do
not. This situation occurs when a backup operation is
Please, look into the dsmerror.log for further error requested and the "Import VSS snapshots Only When
details. If the affected file path doesn't exist, restore it Needed" feature is enabled and not all the volumes
from your backup (if any) or re-create it manually, then involved in the backup operation are managed by a
re-try the operation. Make sure that the specified file VSS Hardware Provider that supports transportable
system is IBM Spectrum Protect space managed, snapshots. Additionally the situation can also occur in
writable and in consistent state. a clustered environment during a backup operation,
ANS9334E Wrong alias 'alias-name' received when not all the volumes involved in the backup
from the server. operation are managed by a VSS Hardware Provider
that supports transportable snapshots.
Explanation
System action
IBM Spectrum Protect could not build a valid
pathname for a migrated file due to the invalid alias processing stops.
received from the server.

416 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Try the operation again by splitting the backup An invalid node or owner name has been entered in
operation. Ensure that all the volumes involved in the the SET ACCESS command.
backup operation are either managed by a Hardware
Provider that supports transportable snapshots or that System action
all the volumes involved in the operation do not
support transportable snapshots. Additionally you may Processing stops.
also turn off the "Import VSS snapshots Only When
Needed" feature to allow the backup to allow the User response
mixure.
Enter the SET ACCESS command using the correct
ANS9351E Data was not available on server node or owner name.
and was skipped.
ANS9355E VMware vStorage VI Web Service
API reported error message: vstor-
Explanation api-msg
The data to be restored is not available on the server,
so it will not be restored. Explanation
The VMware vStorage VI Web Service API reported an
System action error with the specified message text.
The data is skipped, and the restore processing
continues with the next object to be restored. System action
Processing stops.
User response
Contact your IBM Spectrum Protect administrator. User response
ANS9352E SAN was chosen as the transport Check the dsmerror log file for additional information,
for at least one of the disks in the and contact the IBM Spectrum Protect administrator
operation, but the SAN policy is with the information provided in this message.
not OnlineAll for this datamover.
ANS9356E A VMware vStorage API error was
SAN cannot be used unless the
reported.
SAN policy is OnlineAll.

Explanation
Explanation
A VMware vStorage API was reported. See other
SAN was chosen as the transport because either the
messages displayed and logged for additional
default transport setting was used, or it was specified
information about the problem.
in the VMVSTORTRANSPORT option. In order to use
SAN as the transport mode, the SAN policy must be
set to OnlineAll. System action
Processing stops.
System action
Restore processing stops. User response
Check the dsmerror log file for additional information,
User response and contact the IBM Spectrum Protect administrator
with the information provided in this message.
Set the SAN policy to OnlineAll, or set
VMVSTORTRANSPORT to something other than SAN, ANS9357E HOTADD was chosen as the
such as NBD. Then try the restore operation again. transport for at least one of the
disks in the operation, but the SAN
ANS9354E The node or owner name 'node'
policy is not OfflineAll for this
specified in the SET ACCESS
datamover. HOTADD cannot be
command exceeds the maximum
used unless the SAN policy is
allowed length (64).
OfflineAll.

Chapter 2. ANS 0000-9999 messages 417

Explanation User response
HOTADD was chosen as the transport because either Set the migration low threshold higher than the
the default transport setting was used, or it was recommended-minimum size of the file system.
specified in the VMVSTORTRANSPORT option. In order
ANS9361W program-name: file-system: the
to use HOTADD as the transport mode, the SAN policy
configured pre-mig premigration is
must be set to OfflineAll.
greater than the difference
between the configured low-
System action threshold low threshold and the
Restore processing stops. recommended-minimum size of
the file system Min_size.
User response
Explanation
Set the SAN policy to OfflineAll, or set
VMVSTORTRANSPORT to something other than IBM Spectrum Protect premigration percentage below
HOTADD, such as NBD. Then try the restore operation the low threshold may not leave sufficient space for
again. the file system, and can result in endless attempts to
find migration candidates. Usage of the file system
ANS9359W program-name: file-system: high may be higher than the recommended minimum of low
threshold high-threshold exceeds threshold on GPFS and Veritas because these types of
recommended maximum max- file system allocate some space for metadata.
threshold maximum percentage.
System action
Explanation
Processing continues.
System performance can be impacted. There can be
delays from waiting for demand migration.
User response

System action Lower the premigration setting.

Processing continues. ANS9362W program-name: file-system:

MAXFILES max-files is less than
User response used inodes used inodes in the file
system. MAXFILES will be set to
Set the migration high threshold lower than the file the minimum possible value.
system capacity.
ANS9360W program-name: file-system: Explanation
configured low-threshold low The specified MAXFILES value is below the number of
threshold is below the files already existing in the file system. The value will
recommended minimum floor- be ignored, and CFI will default to the minimum
percent low threshold. possible size according to the number of currently
used inodes.
Explanation
IBM Spectrum Protect low threshold is not System action
recommended to be less than teh minimum space Processing continues.
required by this file system and may result in endless
attempts to find migration candidates. Usage of the file
User response
system may be higher than the recommended
minimum of low threshold on GPFS and Veritas Increase the value of MAXFILES.
because these types of file system allocate some
ANS9363W program-name: file-system:
space for metadata.
MAXFILES max-files is more than
files total available inodes in the
System action file system. MAXFILES will be set
Processing continues. to the maximum possible value.

418 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation ANS9368W WARNING: VMware Host Userid
<hostuserid> read from pwd file
The specified MAXFILES value is above the number of
different than VMCUSER option
available inodes in the file system. The value will be
value <vmcuserid>. Using
ignored, and CFI will default to the maximum size that
VMCUSER option value.
corresponds to the number of available inodes.

Explanation
System action
None.
Processing continues.

System action
User response
Processing stops.
Decrease the value of MAXFILES.
ANS9364E Failure initializing virtual machine User response
environment. Refer to
dsmerror.log for detailed error Contact the IBM Spectrum Protect administrator with
messages. the information provided in this message.
ANS9369W WARNING: VMware VirtualCenter
Explanation or ESX Server User Password for
VMC Host <host> VMC Userid
Failure initializing virtual machine environment. Refer
to dsmerror.log for detailed error messages. <userid> set in options file.

System action Explanation

The backup can not continue. None.

User response System action

Refer to dsmerror.log for detailed error message. Processing stops.

ANS9365E VMware vStorage API error for User response

virtual machine 'VM-name'.
IBM Spectrum Protect function Contact the IBM Spectrum Protect administrator with
name : function-name the information provided in this message.
IBM Spectrum Protect file : file- ANS9370W Use Preferences Editor or dsmc
name (line-number) SET PASSWORD -type=VM
API return code : TSM-rc 'VirtualCenter hostname' 'userid'
API error message : function-desc 'password' to save encrypted
password.
Explanation
None. Explanation
The VMCPW option was found either in an option file or
System action on the command line. While this method of entry is
allowed, it presents a security risk because the
Processing stops.
password is in plain text and not encrypted.

User response
System action
If virtual machine backup fails and the error message
The option is accepted and the VMC password is used
points to function ReadEnvironmentVariableInGuest(),
in the current session.
verify the validity of guest virtual machine login
credentials, update virtual machine login credentials
on data mover if necessary. Contact the IBM Spectrum User response
Protect administrator with the information provided in To save the encrypted password, use the Preferences
this message. Editor VM Backup panel or the command:
dsmc SET PASSWORD -type=VM 'VirtualCenter
hostname' 'userid' 'password'

Chapter 2. ANS 0000-9999 messages 419

ANS9371I program-name: file-system: The ANS9374E VMware vStorage virtual storage
specified MAXFILES value is 0. driver service is not running or
The CFI size will be calculated could not be found.
automatically now. Make sure VMware 'vstor2-
mntapi20-shared.sys' service is
Explanation installed and running. Install the
VMware vStorage API runtime
IBM Spectrum Protect The specified maxfiles value is files.
0, which means that the CFI size is managed
automatically now.
Explanation

System action Failure initializing VMware vStorage API environment.

IBM Spectrum Protect continues.

System action

User response The backup can not continue.

none.
User response
ANS9372E Unable to create the virtual Make sure the VMware 'vstor2-mntapi20-shared.sys'
machine to be restored due to an service is installed and running. Install the VMware
invalid host name, datacenter vStorage API runtime files.
name, or datastore name.
ANS9376E The Backup VM command domain
Explanation keyword 'domain-keyword' was
specified, but this domain does
IBM Spectrum Protect was unable to create the virtual not contain any virtual machines.
machine to be restored because an invalid host name, This error can also occur if the
datacenter name, or datastore name was specified. value for the VMHOST parameter
Check the dsmerror log file for information on the is not specified as an IP address or
specific reason for the failure. as a fully qualified domain name.

System action Explanation

Processing stops. The command cannot complete because the virtual
machine could not be found.
User response
Check the dsmerror log file for additional information, System action
and contact the IBM Spectrum Protect administrator Processing stops.
with the information provided in this message.
ANS9373E The backup of virtual machine User response
'vm-name' stopped because the Try the operation again. Ensure that the value for the
backup operation was not VMHOST parameter is specified as an IP address or as
progressing. a fully qualified domain name. The host name that you
specify must match the host name as it is displayed in
Explanation the vCenter server in the Host and Clusters view. This
IBM Spectrum Protect detected a deadlock, which could be the fully qualified host name (FQDN), the
prevents the backup operation of the virtual machine shortened domain name, or the host IP address.
to finish. The backup operation was cancelled. ANS9377E No virtual machine is specified on
the string command or the virtual
System action machine domain list could not be
processed.
The backup of the virtual machine was cancelled.

Explanation
User response
No virtual machine found with name or specified in
Retry the backup of the virtual machine. If the problem
domain option.
persists, contact IBM Software Support.

420 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action VMFOLDER or VMDATASTORE options. The VMHOST
option value must be specified as an IP address or as a
Processing stops.
server name that is in fully qualified domain name
(FQDN) format. The host name that you specify must
User response match the host name as it is displayed in the vCenter
Specify a correct VM name or domain option. server in the Host and Clusters view. This could be the
fully qualified host name (FQDN), the shortened
ANS9378E Unexpected error while domain name, or the host IP address.
fingeprinting the data
ANS9381I The value set for vmlist option will
be migrated to the new domain
Explanation
option.
There was an error while fingerprinting the data. See
the error log for more information. Explanation
New option has been set.
System action
The object is not backed up. System action
Processing continues.
User response
Retry the operation. Retry the operation without User response
client-side deduplication. If the problem persists,
contact IBM Spectrum Protect technical support. None.

ANS9379E Unexpected error while ANS9383E The required files for the virtual
deduplicating the data machine operations were not
found.
The files are installed only if the
Explanation
client is defined as a data mover in
There was an error while deduplicating the data. See IBM Spectrum Protect for Virtual
the error log for more information. Environments.

System action Explanation

The object is not backed up. A failure occurred when initializing the virtual machine
environment.
User response
System action
Retry the operation. Retry the operation without
client-side deduplication. If the problem persists, The operation cannot continue.
contact IBM Spectrum Protect technical support.
ANS9380E The virtual machine that was User response
specified on the string command Install IBM Spectrum Protect for Virtual Environments
could not be found. package to use the client to back up virtual machines.
ANS9384W Unable to get VMware Changed
Explanation
Block Tracking(CBT) data for
The command cannot complete because the virtual virtual machine 'virtual machine
machine could not be found. name'. Full VM backup continues,
and includes both used and
System action unused areas of the disk.

Processing stopped.
Explanation

User response IBM Spectrum Protect was unable to obtain Changed

Block Tracking(CBT) data for the specified virtual
Try the operation again. Specify a correct VM name or machine. The backup continues, but instead of
DOMAIN option. This error can also be caused by backing up just the used blocks (in the full VM backup
incorrect settings for the VMHOST, VMHOSTCLUSTER, case), or just the changed blocks (in the incremental

Chapter 2. ANS 0000-9999 messages 421

VM backup case), the entire virtual machine is backed User response
up. This backup includes both the used and unused
See the error log dsmerror.log for information about
blocks of the disk.
why the changed block data is not obtained.

System action ANS9387W An incremental backup for virtual

machine 'virtual machine name' is
The backup continues. not possible because changed
block information cannot be
User response obtained. A full VM backup is
attempted instead.
See the error log dsmerror.log for information about
why the changed block data is not obtained.
Explanation
ANS9385W Error returned from VMware
vStorage API for virtual machine Changed block information is required to perform an
'VM-name' in vSphere API function incremental backup, but the information could not be
__ns2__QueryChangedDiskAreas. obtained from the virtual machine. The information
RC=API return code, Detail can be missing if two nodes back up the same virtual
message: API message machine. One node runs a daily incremental backup,
and the other node runs a weekly full backup. After the
weekly full backup runs, the next daily backup cannot
Explanation
obtain changed block information, so a full backup is
None. run instead of an incremental backup. Subsequent
daily backups will be incremental until the next weekly
System action full backup.

CBT processing stops.

System action

User response The backup continues as a full backup instead of an

incremental backup.
Contact the IBM Spectrum Protect administrator with
the information provided in this message.
User response
ANS9386W Changed block tracking is not Search the IBM Spectrum Protect support site IBM
supported for virtual machine Spectrum Protect Support Portal (https://
'virtual machine name'. A FULL www.ibm.com/mysupport/s/topic/
backup of the disk will be 0TO50000000IQWvGAO/spectrum-protect) for this
performed and will include both message number, for other possible causes of this
used and unused areas of the disk. error.

Explanation ANS9388E The management class

'management class name'
IBM Spectrum Protect was unable to obtain Changed specified for the 'option name'
Block Tracking(CBT) data for the specified virtual option is invalid, or does not have
machine because changed block tracking is not a backup copy group.
supported. RDM disks in physical mode, virtual disks
attached to shared virtual SCSI bus, and VMs with
Explanation
hardware version 6 or earlier are not supported. The
backup continues, but instead of backing up just the The management class name for the specified option
used blocks (in the full VM backup case), or just the does not exist, or it exists but does not have a valid
changed blocks (in the incremental VM backup case), backup copy group.
the entire virtual machine is backed up. This backup
includes both the used and unused blocks of the disk. System action
Processing stops.
System action
The backup continues. User response
Verify that the specified management class name is
valid, and that it contains a valid backup copy group.

422 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS9389W The DEDUP backup attempt was System action
unsuccessful for virtual machine Restore processing continues.
'virtual machine name'. Retry
#retry attempt number with DEDUP
disabled. User response
Following guest OS restore: remove and reattach the
Explanation guest Linux boot disk, select Guest Boot Option to
enter EFI setup configuration on next boot, power on
The attempt to backup the virtual machine with the guest, enter EFI Boot Maintenance, add Boot
DEDUP enabled was unsuccessful. Instead of failing Device, select unnamed volume, give it a label, save
the backup right away, an attempt is being made to and commit changes, continue with boot.
backup the virtual machine with DEDUP disabled.
ANS9392W No backupset name entered.
System action
Explanation
Processing continues with DEDUP disabled.
You must provide a backupset for this operation.
User response
System action
Check the log files for messages as to why DEDUP
failed. If future attempts to backup using DEDUP fail, Processing stops.
contact your system administator.
ANS9390W The DEDUP backup attempt was User response
unsuccessful for virtual machine Specify a valid backupset name.
'virtual machine name'. Retry
#retry attempt number with DEDUP ANS9393W Incorrect backupset name
still enabled. entered.

Explanation Explanation

The attempt to backup the virtual machine with The backupset name provided was invalid. Wildcards
DEDUP enabled was unsuccessful. Instead of failing are not allowed.
the backup right away, an attempt is being made to
retry the backup of the virtual machine with DEDUP System action
still enabled.
Processing stops.

System action
User response
Processing continues with DEDUP still enabled.
Specify a valid backupset name.

User response ANS9394W No backupset file or device name

entered.
Check the log files for messages as to why DEDUP
failed. If future attempts to backup using DEDUP fail,
contact your system administator. Explanation
You must provide a backupset file or device name for
ANS9391W Linux guest OS with EFI Boot
this operation.
enabled is not fully supported by
IBM Spectrum Protect VMware
backup. Manual steps may be System action
required following restore to Processing stops.
enable the virtual machine to
power on correctly.
User response

Explanation Specify a valid backupset file or device name.

A restored Linux guest OS with EFI boot enabled may ANS9395E The filespace has been migrated to
not successfully start. Manual steps are required to the incremental forever model;
successfully boot the guest OS.

Chapter 2. ANS 0000-9999 messages 423

 MODE=FULL and MODE=INCR are System action
not valid.
IBM Spectrum Protect will use the VMware Tools to
provide application consistency.
Explanation
You must run only incremental forever backup types User response
(IFINCR or IFFULL) if the filespace has been migrated
Exclude the virtual machine from application
to the incremental forever type.
protection by removing the INCLUDE.VMTSMVSS
option for this virtual machine.
System action
ANS9398E IBM Spectrum Protect application
Processing stops. protection failed to initialize on
virtual machine 'VM'. See the error
User response log for more details.
Specify either MODE=IFFULL or MODE=IFINCR.
Explanation
ANS9396W Virtual machine 'VM' is not
running. IBM Spectrum Protect IBM Spectrum Protect application protection
Application Protection will not be encountered an error during initialization.
used while backing up this VM.
System action
Explanation Processing stops.
IBM Spectrum Protect Application Protection can only
protect VMs that are running. User response
See the error log for more details. Correct the error(s)
System action and try the operation again.
IBM Spectrum Protect Application Protection uses the ANS9399W program-name: lock file access
VMWare tools to provide application consistency. error for operation value on path
value value with errno text value.
User response
Turn on the virtual machine or exclude it from IBM Explanation
Spectrum Protect application protection by removing A lock file operation has failed.
the INCLUDE.VMTSMVSS option for this virtual
machine. If you want logs to be truncated use
System action
INCLUDE.VMTSMVSS to protect this machine.
IBM Spectrum Protect logs the condition and
ANS9397W IBM Spectrum Protect application
continues processing, or exits if directory not found.
protection cannot protect this
machine. Virtual machine 'VM'
does not have operating system or User response
applications supported by IBM Correct the configuration.
Spectrum Protect application
protection. ANS9400W Unable to restore NVRAM file for
vm 'virtual machine name'. Manual
Explanation steps may be required following
restore to enable the virtual
The application protection can be used only for virtual machine to power on correctly.
machines that have operating systems or applications
that are supported by IBM Spectrum Protect Explanation
application protection. Refer to the product
documentation for the list of supported operating IBM Spectrum Protect was unable to upload NVRAM
systems and applications. file for the specified virtual machine. The restore
continues, but a restored guest OS with EFI boot
enabled may not successfully start. Manual steps may
be required to successfully boot the guest OS.

424 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The restore continues. The data that IBM Spectrum Protect would have
backed up for a virtual machine would not match the
User response data needed for a correct backup. The backup has
been cancelled to prevent data loss.
Following guest OS restore if guest OS fails to boot:
remove and reattach the guest OS boot disk, select
System action
Guest Boot Option to enter EFI setup configuration on
next boot, power on the guest, enter EFI Boot The backup is cancelled to prevent data loss.
Maintenance, add Boot Device, select unnamed
volume, give it a label, save and commit changes, User response
continue with boot.
Retry the backup. If this error occurs again, contact
ANS9401E program-name: Cannot kill recall IBM Software Support.
daemon.
ANS9404E Error creating the specified Virtual
Machine. See log files for more
Explanation
information.
IBM Spectrum Protect A request for killing the recall
daemon failed. This may occur during node failover. Explanation
An error was encountered creating the Virtual
System action
Machine. Look in the dsmerror.log for additional
none. information on why the Virtual Machine could not be
created.
User response
System action
Continue with normal operation unless further errors
occur. Processing stops.
ANS9402E program-name: Cannot notify
process name to recover HSM User response
operations on a failing node. Check the dsmerror.log for more specific messages on
why the virtual machine could not be created.
Explanation
ANS9405I program-name: The takeover of
In order to assume the functionality of a failing partner filesystem file system started.
node, the dsmwatchd daemon must notify the local
daemons. Explanation
The local activation of the specified file system started
System action
successfully.
none.
System action
User response
IBM Spectrum Protect on the local node will try to
Communication cannot be established with the HSM activate the file system that is space managed on
daemon specified in this message. Check whether the another node.
target daemon is running. Start or restart the target
daemon as appropriate. If the problem persists, User response
restart the GPFS cluster.
None.
ANS9403E IBM Spectrum Protect has
detected that the data to back up ANS9410W VMware Tools are either not
does not match the list of data to runnning or out-of-date on virtual
back up that was sent from the machine 'VM'. IBM Spectrum
virtual machine. The backup of Protect application protection
'VM-Name' cannot continue. cannot be used.

Chapter 2. ANS 0000-9999 messages 425

Explanation Explanation
IBM Spectrum Protect application protection requires The instant restore and instant access operations do
that VMware tools are installed and running with an not support restores of virtual machines that are in
up-to-date version on the virtual machine. VVOL datastores. VVOL datastores do not support Raw
Device Mapping (RDM), which is required for these
System action operations.

IBM Spectrum Protect will not provide application

System action
consistency. Application logs are not truncated.
The operation fails.
User response
User response
Install and/or upgrade and/or start VMware Tools on
the virtual machine or exclude it from the application For instant restore operations, specify a datastore and
protection by removing the INCLUDE.VMTSMVSS temporary datastore that is not a VVOL datastore.
option for this virtual machine. For instant access operations, specify a datastore that
is not a VVOL datastore.
ANS9411E VSS provider registration failed.
Command 'command' failed with ANS9414E Application protection is enabled
Windows RC=return code for virtual machine 'VM-name',
however, this virtual machine
Explanation resides on a Virtual Volume (VVol)
datastore. Application protection
IBM Spectrum Protect was unable to register the VSS needs to be disabled in order to
provider on the virtual machine. back up this virtual machine.

System action Explanation

Processing stops. Application protection is not supported for virtual
machines that reside on VVol datastores.
User response
Restart the virtual machine and try the operation System action
again. The operation fails.
ANS9412E program-name: Failover is
disabled on the local machine. User response
Aborting failover ... Disable application protection by removing the
include.vmtsmvss option from the options file and
Explanation back up the virtual machine again.
IBM Spectrum Protect Failover operations were ANS9415E Failed to copy 'source' to
disabled either by the system or the user. 'destination' with VMware RC=rc
on virtual machine 'guest VM
System action name'.
None.
Explanation
User response IBM Spectrum Protect was unable to copy a file to the
virtual machine.
Check failover policy if necessary.
ANS9413E The instant restore or instant System action
access operation failed because
these operations do not support Processing stops.
virtual machines that are in virtual
volume (VVOL) datastores. User response
Verify that the source file exists and the destination is
accessible. Restart the virtual machine and try the
operation again.

426 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS9416E Cannot create the directory System action
'source' on the virtual machine Restore processing stops.
with Windows RC=rc

User response
Explanation
Disable VMware Changed Block Tracking (CBT) on the
IBM Spectrum Protect client was unable to create the
target VM, or set VMVSTORTRANSPORT to something
specified directory on the virtual machine. It is other than SAN, such as NBD. Then try the restore
possible that the directory exists and is locked by a operation again.
process.
ANS9419W VMware Changed Block
System action Tracking(CBT) cannot be enabled
or reset for virtual machine 'virtual
Processing stops. machine name' due to an existing
snapshot. Full VM backup
User response continues, and includes both used
and unused areas of the disk.
Verify the the specified directory does not exist on the
virtual machine. Restart the virtual machine and try
the operation again. Explanation

ANS9417E IBM Spectrum Protect application VMware does not allow changing state of Changed
protection could not freeze the Block Tracking(CBT), when a snapshot exists. The
VSS writers on the virtual machine backup continues, but instead of backing up just the
named 'VM'. See the error log for used blocks (in the full VM backup case), or just the
more details. 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.
Explanation
IBM Spectrum Protect application protection System action
encountered an error while freezing the VSS writers.
The backup continues.
System action
User response
Processing stops
Delete snapshot on the target vm to allow CBT to be
enabled or reset.
User response
ANS9420W VMware Changed Block
Use the 'vssadmin list writers' command to
Tracking(CBT) cannot be enabled
determine if any VSS writers detect errors on the
or reset for virtual machine 'virtual
virtual machine. Restart the VM. Retry the operation. If
machine name' due to an existing
the retry fails, see the error log for details about the
snapshot. Full VM backup
errors.
continues, and includes both used
ANS9418E SAN was chosen as the transport and unused areas of the disk.
for at least one of the disks in the
operation, but VMware Changed Explanation
Block Tracking (CBT) is enabled on
the target VM. SAN cannot be used VMware does not allow changing state of Changed
to update existing VM, when CBT Block Tracking(CBT), when a snapshot exists. The
is enabled. 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),
Explanation the entire virtual machine is backed up. This backup
SAN was chosen as the transport because either the includes both the used and unused blocks of the disk.
default transport setting was used, or it was specified
in the VMVSTORTRANSPORT option. In order to use System action
SAN as the transport mode, VMware Changed Block
Tracking (CBT) has to be disabled on the target VM. The backup continues.

Chapter 2. ANS 0000-9999 messages 427

User response System action
Delete snapshot on the target vm to allow CBT to be The virtual machine is not backed up. Processing
enabled or reset. continues with the next virtual machine.
ANS9421E VM backup failed for virtual
machine 'virtual machine name' User response
because one of the disks has size Carry out one or more of the following actions and
that is not multiple of 1MB. then try the backup again.
• Check the VMVSTORTRANSPORT option value and
Explanation verify that the desired transport modes are available.
VMware does not support backup of disks with size • Add NBD or NBDSSL to the VMVSTORTRANSPORT
that is not multiple of 1MB. The backup fails. option.
• Check the "%TEMP%/VMWARE-%USER%" directory
System action for leftover files from a previous backup. Leftover
The backup fails. files can prevent the use of advanced transport
modes. This directory can be safely deleted as long
as no other VM operations are running.
User response
Increase the affected disk size to be a multiple of ANS9428E program-name: The takeover of
1MB. filesystem file system failed to
start.
ANS9422I program-name: The rollback of
filesystem file system started. Explanation
The local activation of the specified file system failed
Explanation
to start. Please, note that only file systems which are
The local activation of the specified file system started space managed on another node within the same
successfully. cluster can be taken over. Additionally, the file system
must be mounted locally.
System action
System action
IBM Spectrum Protect on the local node will try to
activate the file system that is space managed on IBM Spectrum Protect will not take over the file
another node. system.

User response User response

None. Make sure the file system is mounted locally and
managed with the IBM Spectrum Protect client for
ANS9427E The virtual machine 'virtual
space management on another node within the same
machine name' disk 'virtual
cluster and retry the operation.
machine disk name' could not be
opened because none of the ANS9431E IBM Spectrum Protect application
allowed transports ('allowed protection failed to thaw VSS
transport modes') is available. writers on virtual machine 'VM'.
See the IBM Spectrum Protect
Explanation error log for more details.
The disk can only be opened using one of the transport
Explanation
modes specified in the VMVSTORTRANSPORT option.
However, none of the specified transport modes were IBM Spectrum Protect application protection
available, so the disk cannot be opened.Since none of encountered an error while thawing VSS writers.
the specified transport modes was available, the disk
could not be opened. System action
Processing stops

428 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response System action
See the error log for more details. Verify that all VSS Aborting operation.
writers are not reporitng errors by running command
'vssadmin list writers'. Restart the virtual machine and User response
try the operation again. If the retry fails, see the error
log for details about the errors. Run dsmmigfs enableFailover on the local node and
repeat the operation.
ANS9432W IBM Spectrum Protect application
protection failed to truncate ANS9447E The virtual machine 'virtual
application logs on virtual machine name' disk could not be
machine 'VM'. opened because none of the
allowed transports is available.
Explanation
Explanation
IBM Spectrum Protect application protection
encountered an error while completing VSS backup The disk can only be opened using one of the transport
operation. The applications were successfully modes specified in the VMVSTORTRANSPORT option.
quiesced, but their logs were not truncated. However, none of the specified transports modes was
available, so the disk cannot be opened.
System action
System action
Application logs are not truncated.
The virtual machine is not backed up. Processing
continues with the next virtual machine.
User response
See the error log for more details. Verify that all VSS User response
writers are not reporting errors by running command
'vssadmin list writers'. Restart the virtual Carry out one or more of the following actions and
machine and try the operation again. If the retry fails, then try the backup again.
see the error log for details about the errors. On the • Check the console output and error logs for
guest VM, verify that a mounted volume is not online. information about which transport modes are
Use the Recovery Agent to dismount and remove any allowed.
existing mount directories. Then, try the backup
• Check the VMVSTORTRANSPORT option value and
operation again.
verify that the desired transport modes are available.
ANS9433E program-name: dm_send_msg • Add NBD or NBDSSL to the VMVSTORTRANSPORT
failed with errno Errno. option.
• Check the "%TEMP%/VMWARE-%USER%" directory
Explanation for leftover files from a previous backup. Leftover
Unable to execute DMApi call. files can prevent the use of advanced transport
modes. This directory can be safely deleted as long
System action as no other VM operations are running.

Aborting operation. ANS9450W program-name: No eligible

filesystem for takeover.
User response
Explanation
Check consistency of the GPFS daemon.
None of the locally mounted GPFS filesystems
ANS9443E program-name: The operation matches with the remotely managed filesystems of the
cannot be executed in a failure node.
deactivated failover environment.
System action
Explanation
Aborting takeover operation.
The operation relies on an active failover environment.

Chapter 2. ANS 0000-9999 messages 429

User response Explanation
Check that the filesystems of the remote failure node The specified file system is not a GPFS file system or
get managed elsewhere within the node set. has an old GPFS version.
ANS9451E program-name: GPFS or the SP
switch is down locally. Aborting System action
takeover activities ... The requested operation stops.

Explanation User response

IBM Spectrum Protect GPFS is not functional locally. Please update to a supported version of GPFS.
ANS9459E Using the specified
System action
MAXCANDIDATES parameter would
Aborting takeover operation. produce an out-of-space
condition in the parent filesystem
User response of /etc/adsm/SpaceMan/
candidatesPool. Based on
Check switch and VSD status. The local system must the current free space situation
be unfenced. the maximum value for the
ANS9452E program-name: The DMApi is not MAXCANDIDATES parameter is
functional locally. Aborting value.
takeover activities ...
Explanation
Explanation The automigration candidate pools for the selected
The operation stopped because the DMApi interface is filesystem require MAXCANDIDATES per 10 KB plus a
not accessible. safety buffer of 5 MB of memory under /etc/adsm/
SpaceMan/candidatesPool , which exceeds the
available space.
System action
Aborting takeover operation. System action
IBM Spectrum Protect Abort operation.
User response
Check GPFS status. User response
ANS9453E program-name: Could not Increase the filesystem size or choose a smaller value
determine the GPFS storage pool for the MAXCANDIDATES parameter. You may also
id for file 'file-path'. Reason: create a dedicated filesystem with sufficient space for
reason the migration pools under /etc/adsm/SpaceMan/
candidatesPool. Kill the dsmscout processes after
Explanation performing this option.

The processed file does not exist or is located on a file ANS9462E Failover functionality is not
system without storage pool support. supported with this HSM release.

System action Explanation

The requested operation stops. The IBM Spectrum Protect user ran dsmmigfs with
the failover flag on an unsupported platform.
User response
System action
Please check the input parameters and if DMAPI is
enabled on the file system. IBM Spectrum Protect ends the operation.
ANS9457E program-name: Could not
User response
determine the storage pools of file
system 'file-system'. Reason: None.
reason

430 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS9469E Warning! Unable to write a Explanation
complete migration candidate list DMAPI session is recovered.
due to low space in the parent
filesystem of name.
System action
Explanation This message is for informational purposes only.
IBM Spectrum Protect Low space in filesystem which
stores the migration candidates files. User response
No action is required.
System action
ANS9480E program-name: The rollback of
IBM Spectrum Protect The executable writes a partial filesystem file system failed to
migration candidates list. start.

User response Explanation

Increase the filesystem size or create a dedicated The local activation of the specified file system failed
filesystem with sufficient size under the given path. to start. Please, note that a rollback can only be
performed after the space management of the file
ANS9474E program-name: Lost my session system was moved from the local node to another
with errno: errno . Trying to node during failover. Additionally, the file system must
recover. be mounted locally.

Explanation System action

The DMAPI session is not valid. IBM Spectrum Protect will not roll back the file
system.
System action
Trying to recover session. User response
Make sure the file system is mounted locally and
User response managed with the IBM Spectrum Protect client for
Check the failure node. You might have to recover the space management on another node within the same
local GPFS daemon. cluster and retry the operation.

ANS9475W IBM Spectrum Protect application ANS9487W program-name: cannot query the
protection failed to cleanup after a right on session session for file
VSS backup on virtual machine handle = filehandle
VM. token = token. Reason : error

Explanation Explanation

IBM Spectrum Protect application protection The Space Management cannot query the right on a
encountered an error while cleaning up after a VSS file.
backup operation.
System action
System action Processing of the file is interrupted.
None
User response
User response Continue with normal operation.
See the error log for more details. Restart the virtual ANS9488E IBM Spectrum Protect uses the
machine and try the operation again. If the problem Java Runtime Environment (JRE),
persists, contact IBM technical support for further but either the JRE could not be
assistance. found in the 'jrePath' directory, or
ANS9476I program-name: Recovered my DM the JRE version could not be
session sid. determined. Possible reasons are

Chapter 2. ANS 0000-9999 messages 431

 that there is a problem with the System action
product installation, or the TEMP
Processing stops
or TMP environment variables are
set to a directory that is
inaccessible by the user. User response
Re-install the product or install a required version of
Explanation JRE and try again.
JRE was not found in the IBM Spectrum Protect ANS9491E The password credentials for
installation directory. virtual machine 'guest VM name'
could not be found. Use dsmc SET
System action PASSWORD -type=VMGUEST 'VM
guest name' 'userid' 'password' to
Processing stops save encrypted password.

User response Explanation

Re-install the product or install a required version of The required password was not found.
JRE and try again. If JRE is already installed on your
machine, then make sure the PATH environment
System action
variable contains path to javaw.exe. In addition to that,
verify that the TEMP and TMP environment variables Processing stops
each point to an existing directory, and that the user
has sufficient permissions to access the directory. User response
ANS9489E Java Runtime Environment (JRE) Use dsmc SET PASSWORD -type=VMGUEST 'VM guest
was not found. name' 'userid' 'password' to save encrypted password.
And then retry the 'backup vm' operation.
Explanation
ANS9492E Destination size is not equal to
JRE was not found. source

System action Explanation

Processing stops The space allocation for the selected destination is not
the same as the source.
User response
System action
If you have already installed JRE, verify that the \"java
\" executable can be reached via an appropriate PATH The restore operation is not performed.
environment variable setting. Otherwise, install the
required JRE version. For more details on the User response
hardware and software requirements, see the
following technote: http://www-01.ibm.com/support/ Choose a different destination which is equal in size to
docview.wss?uid=swg21505139 For more details on the source.
how to configure the data mover nodes in a vSphere ANS9493E The credentials found for virtual
environment, see "Advanced configuration tasks"
machine 'guest VM name' are
appendix of the IBM Spectrum Protect for Virtual
incorrect. Verify the credentials
Environments "Data Protection for VMware Installation
and use dsmc SET PASSWORD -
Guide".
type=VMGUEST 'VM guest name'
ANS9490E Cannot find httpagent.jar in the 'userid' 'password' to update the
IBM Spectrum Protect client username and password.
installation directory.
Explanation
Explanation The supplied credentials are incorrect. Failed to
The required file was not found. authenticate to guest VM using these credentials.

432 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
Processing stops Processing stops

User response User response

Use dsmc SET PASSWORD -type=VMGUEST 'VM guest There is already another virtual machine backup in
name' 'userid' 'password' to update the username and process via another datamover. Please wait for the
password. And then retry the 'backup vm' operation. other virtual machine backup to complete and re-try
the operation. Or there was a crash or CTRL+C during
ANS9494E Command 'command' completed the previous virutal machine backup. Please wait 10
with RC=return code on virtual minutes and re-try the operation.
machine 'guest VM name'.
ANS9497W Virtual machine 'VM' resides on an
Explanation ESX Server or vCenter that is not
supported by IBM Spectrum
A remote command either timed out or failed. Protect application protection.
IBM Spectrum Protect application
System action protection will not be used.
Processing stops
Explanation
User response Refer to the product documentation for the list of
supported ESX and vCenter versions.
Increase the value of VMTIMEOUT option and try the
operation again.
System action
ANS9495E Failed to login to virtual machine
'guest VM name' because the IBM Spectrum Protect will use the VMware Tools to
VMware Tools are not running in provide application consistency.
the guest machine. Verify that the
VMware tools are running and that User response
no other program has access or is Exclude the virtual machine from application
making any changes to this VM. protection by removing the INCLUDE.VMTSMVSS
option for this virtual machine.
Explanation
ANS9498W A valid IBM Spectrum Protect for
Failed to login to virtual machine because the VMware Virtual Environments license file
Tools are not running in the guest machine. (license-file) cannot be located.
IBM Spectrum Protect application
System action protection will not be used.
Processing stops
Explanation
User response The license file was not found, or cannot be opened
because of permissions, or the file is corrupted.
Make sure that the VMware tools are running and that
no other program has access or is making changes to
this VM. And then retry the 'backup vm' operation. System action

ANS9496E Unable to lock virtual machine VM IBM Spectrum Protect will use the VMware Tools to
for application protection. provide application consistency.

Explanation User response

The virtual machine is being backed up by another Check permissions on file. See if the license file is in
process. Only one process is allowed to use IBM the correct place.
Spectrum Protect application protection during a ANS9499W VMware tools on virtual machine
backup of a virtual machine at a time. 'VM' need to be updated. IBM
Spectrum Protect application
protection will still be used.

Chapter 2. ANS 0000-9999 messages 433

Explanation ANS9502W program-name: cannot remove
event disposition on session
IBM Spectrum Protect application protection requires
session for file system mountdir
that VMware Tools are up to date.
token = token. Reason : error

System action
Explanation
IBM Spectrum Protect will use the VMware Tools to
Event dispositions could not be removed from the file
provide application consistency.
system.

User response
System action
Update VMware Tools on the virtual machine
Processing continues.
ANS9500W program-name: cannot disposition
the mount event. Reason: error User response
Verify that the file system is mounted and that dmapi
Explanation
is enabled on that file system. If the problem persists,
The system wide mount event could not be unmount and remount the file system, then try the
dispositioned. Mount events will not be received by operation again. If the problem still persists, reboot
this daemon. the system.
ANS9503I program-name: events have been
System action set and dispositioned on session
Processing continues. session for file system filesystem-
name
User response
Explanation
Try to resolve the problem and restart the recall
daemon. If the problem cannot be resolved Setting events and dispositioning these on a DM
immediately, kill and restart the recall daemon after session enables the file system for Space Management
an Space Management supported file system has been support.
added using dsmmigfs or after a file system has been
mounted using the mount command. System action
ANS9501W program-name: cannot set event Processing continues.
disposition on session session for
file system mountdir User response
token = token. Reason : error
Continue with normal operation.
Explanation ANS9504W program-name: The file system
Events could not be dispositioned on the file system. filesystem-name is not mounted or
No events will be received for this filesystem. HSM is is mounted with wrong options.
not enabled for this file system.
Explanation
System action Either the file system is not mounted or it has been
Processing continues. mounted with incorrect options.

User response System action

The file system must be one of the supported native IBM Spectrum Protect continues.
file systems in order for the Space Management to
support it. Verify that the mount options the file User response
system are correct. Correct the problem and remount Mount the file system or remount it with corrected
the file system. mount options.
ANS9505E program-name: cannot initialize
the DMAPI interface. Reason: error

434 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
IBM Spectrum Protect client failed to perform Space Management cannot release the right on a file.
implementation-defined initialization of the DMAPI
interface. System action
Processing of the file is interrupted.
System action
The dm_init_service() function failed. User response
Continue with normal operation.
User response
ANS9509W program-name: received an
If you are running IBM Spectrum Protect as a non-root
unexpected event of type event-
user and you have IBM Spectrum Protect Space
type on session session.
Management client installed, make sure that the
dsmrootd daemon is up and running, then retry the
operation. If you don't have the Space Management Explanation
client installed, retry the operation under the root user The Space Management daemon received an
authority. unexpected event. This event has not been
ANS9506E program-name: The provided dispositioned.
filespace argument 'argument' has
an invalid format. System action
IBM Spectrum Protect ignores event and continues.
Explanation
Occurs if you are on a GPFS file system and the file User response
system parameter was not in the correct format.
Continue with normal operation.

System action ANS9510E program-name: cannot get event

messages from session session,
The requested operation stops. expected max message-length =
msglen, returned message-length
User response = return-length. Reason : error
See the dsmautomig documentation for the correct
syntax. Explanation

ANS9507E program-name: cannot request the Space Management encountered an error while trying
right on session session for file to receive a message on a DM session.
handle filehandle
token = token. Reason : error System action
Processing continues.
Explanation
Space Management cannot request the required right User response
on a file.
Continue with normal operation.

System action ANS9511E program-name: cannot read DM

attributes on session session for
Processing of the file is interrupted. file: name = name handle = handle
token = token. Reason : error
User response
Continue with normal operation. Explanation

ANS9508W program-name: cannot release the Space Management cannot read the DM attributes of a
right on session session for file DM object, usually a file. If the file name is not
handle = filehandle available, it will be displayed as an empty string or as
token = token. Reason : error <NA>.

Chapter 2. ANS 0000-9999 messages 435

System action ANS9515E program-name: cannot set the
migration information. Reason:
Processing of the file is interrupted.
error

User response
Explanation
Continue with normal operation.
Space Management cannot set the migration
ANS9512E program-name: cannot set DM information of a file, because Space Management
attributes on session session for cannot create a file handle from the file or from the file
file handle = filehandle token = system.
token. Reason : error
System action
Explanation
Processing of the file is interrupted.
Space Management cannot set DM attributes for a DM
object, usually a file. User response
Continue with normal operation.
System action
ANS9516E program-name: cannot create an
Processing of the file is interrupted.
user event message on session
session. Reason: error
User response
Continue with normal operation. Explanation
ANS9513E program-name: cannot remove DM Space Management cannot create an user event
attributes on session session for message, needed to reference rights on a file to be
file handle = filehandle token = processed.
token. Reason : error
System action
Explanation
Processing of the file is interrupted.
Space Management cannot remove DM attributes for a
DM object, usually a file. User response
Continue with normal operation.
System action
ANS9518E program-name: cannot respond to
Processing of the file is interrupted.
an event message on session
session using token token
User response Reason : error
Continue with normal operation.
Explanation
ANS9514E program-name: cannot create a
file handle from path. Reason: An event message could not be responded to
error (returned to the system).

Explanation System action

Space Management cannot create a file handle from Space Management continues.
the given file.
User response
System action
If a user process is unexpectedly blocked and cannot
Processing of the file is interrupted. be killed, see your system administrator.
ANS9519W program-name: cannot set
User response eventlist for a file system on
Continue with normal operation. session session
token = token fs-handle = fs-
handle. Reason : error

436 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation Explanation
An eventlist could not be set on a file system. None of The program can not create a file system handle from
the events will be generated by the system on this file the file system name. If Reason is Operation not
system. permitted, the dmapi functionality may be disabled for
the file system.
System action
System action
Space Management continues.
Processing of the file system is interrupted.
User response
User response
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If If Reason is Operation not permitted, enable dmapi
the problem still persists, reboot the system. functionality for the file system and retry.
ANS9520E program-name: cannot set a ANS9523E program-name: is unable to verify
managed region on session session the stub size for the file on session
for file handle = filehandle token = session
token. Reason : error file handle = filehandle token =
token. Reason : error
Explanation
Explanation
A managed region could not be set on a file. No events
will be generated for this file. A correct stub size could not be determined by the
system.
System action
System action
Processing of the file is interrupted.
The system stops migration of the file.
User response
User response
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If Try the operation again. If the problem persists, verify
the problem still persists, reboot the system. that the file system is mounted with dmapi enabled. If
the problem still persists, restart the system.
ANS9521E program-name: cannot get the file
attributes on session session ANS9524W program-name: adjusted stubsize
for file handle = handle token = to an allowed value on session
token. Reason : error session
file handle = filehandle token =
Explanation token
old stubsize = old-size new
Space Management cannot read the attributes of a file. stubsize = new-size

System action Explanation

Processing of the file is interrupted. The predefined stubsize for the file should be
corrected to accommodate to the boundary and
User response rounding constraints imposed by the DMAPI
implementation. Space Management can also change
Try the operation again. If the problem persists, verify
the stubsize during migration if the predefined
that the file system is mounted with dmapi enabled. If
stubsize value is larger than the logical file size.
the problem still persists, reboot the system.
ANS9522E program-name: can not create a System action
file system handle from path.
Reason: error Space Management continues.

User response
Continue with normal operation.

Chapter 2. ANS 0000-9999 messages 437

ANS9525E program-name: is unable to create System action
a stub file on session session Processing stops.
for file handle = handle token =
token. Reason : error
User response
Explanation Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If
An error occurred while creating a stub file. the problem still persists, restart the system.

System action ANS9529W program-name: cannot obtain the

handle of a file system state file
Processing of the file is interrupted.
Explanation
User response
IBM Spectrum Protect space management could not
Continue with normal operation. find the handle of a file system state file that is stored
ANS9526E program-name: cannot open the in the global state file. This can occur if either space
state file filename for writing. management is querying a file system that has no HSM
Reason: error support added, or the file system state file is
corrupted, or the global state file is corrupted.
Explanation
System action
The global or file system state file could not be
opened. IBM Spectrum Protect continues or stops processing,
depending on the situation.
System action
User response
Processing stops.
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If
User response the problem still persists, restart the system.
Try the operation again. If the problem persists, verify
ANS9530W program-name: cannot remove an
that the file system is mounted with dmapi enabled. If
entry for file-system from the
the problem still persists, restart the system.
global state file.
ANS9527E program-name: cannot write to the
state file filename. Reason: error Explanation
The entry for the file system in the dmiFSGlobalState
Explanation file cannot be removed. Possible reasons:
Space Management could not write to the state file. • There is not enough memory to create temporary file
name for temporary file system table.
System action
• There is not enough free space or inodes to create
Processing stops. temporary file system table
• The real or temporary file system table files cannot
User response be opened.
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If System action
the problem still persists, restart the system. IBM Spectrum Protect does not remove the entry from
ANS9528W program-name: cannot read from the global state file.
the state file filename.
. The file is corrupted and will be User response
recreated.
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If
Explanation the problem still persists, restart the system.
Space Management could not read from the state file.

438 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
ANS9531E program-name: cannot create a Explanation
DM session: old session = The Space Management program cannot find a
oldsession previously used DMAPI session on the system
session info = session-info.
Reason : error
System action
Explanation The Space Management program will open a new
DMAPI session
Space Management could not create a DM session.

User response
System action
Continue with normal operation if a new DMAPI
Processing stops. session can be created. Issue error if a new DMAPI
session cannot be created.
User response
ANS9535E program-name: a file handle could
Try the operation again. If the problem persists restart not be created from the file
the system. descriptor file-descriptor.
ANS9532W program-name: cannot destroy the Reason: error
session session. Reason: error
Explanation
Explanation Space management could not create a file handle.
Space Management could not destroy a DM session.
System action
System action Processing of the file is interrupted.
Processing continues.
User response
User response Try the operation again. If the problem persists, verify
Try the operation again. If the problem persists, verify that the file system is mounted with dmapi enabled. If
that the file system is mounted with dmapi enabled. If the problem still persists, restart the system.
the problem still persists, restart the system. ANS9536E program-name: cannot query an
ANS9533W program-name: failed getting all event message on session session.
sessions. Reason: error Reason: error

Explanation Explanation

Space management could not get all DM sessions on The space management recall service was not able to
the system. identify whether a recall request was initiated from the
NFS daemon.
System action
System action
Processing stopped.
Processing of the file is interrupted.
User response
User response
Try the operation again. If the problem persists, verify
that the file system is mounted with dmapi enabled. If Verify the NFS daemon is properly running and retry
the problem still persists, restart the system. the recall operation.

ANS9534W program-name: cannot find ANS9537E program-name: Invalid storage

existing DMAPI session for the pool 'storagepool' for file system
program. Reason: error 'filesystem'.

Explanation
No storage pool with that name exists on the specified
file system.

Chapter 2. ANS 0000-9999 messages 439

System action ANS9543W program-name: The IBM Spectrum
Protect client needs blocks-num1
The requested operation stops.
free file system blocks to be able
to handle the nospace condition on
User response file system filesystem-name,
Please make sure the storage pool exists on the errno: error-num, reason: error-str.
specified file system. Currently blocks-num2 blocks with
a block size of block-size bytes are
ANS9538W program-name: request request for available.
DM file attributes not recognized
Explanation
Explanation
Either the client is not able to get status information
An unknown request type has been encountered that for the file system or there is insufficient space in the
cannot be handled. file system. The message reports zero blocks if the file
system status information is not available.
System action
Processing continues. System action
Processing continues.
User response
Continue with normal operation. User response

ANS9539E program-name: cannot create a If there is insufficient space in the file system, free the
file system handle from the required space or increase the file system capacity. If
file handle = filehandle. Reason : this is due to an input output error, perform an
error appropriate file system check (e.g. fsck). Then try the
operation again.
Explanation ANS9545E program-name: cannot get a lock
for lockdirlockfile to continue
A file system handle could not be created from a file
processing.
handle.

Explanation
System action
Space management could not obtain a lock for a file.
Processing continues.

System action
User response
processing stops.
Continue with normal operation.
ANS9542E program-name: the file attributes User response
could not be set on session session
for file handle = filehandle token = Try the operation again. If problem persists, restart
token flag = flag HSM. If problem still persists, restart the system.
Reason : error ANS9546E IBM Spectrum Protect cannot
perform instant restore because
Explanation Microsoft Active Directory Domain
Controller was detected on virtual
Space management could not update file attributes.
machine.

System action
Explanation
Processing of the file is interrupted.
The virtual machine contains Microsoft Active
Directory Domain Controller. It cannot be recovered
User response using instant restore.
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.

440 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
Processing stops. Processing stopped.

User response User response

Use a regular restore to recover the virtaul machine. File system must be entirely local.
ANS9548W Cannot complete remote file ANS9554E program-name: command for file
access for inode:'inode number', system mountdir
alias:'file name'. Reason : error

Explanation Explanation
Space management cannot complete the remote file An attempt to enable or disable xdsm api functionality
access. The file may be migrated to an IBM Spectrum on the file system failed. If the attempt was to enable
Protect migration server that could be temporarily HSM, then HSM is not enabled for this file system.
unavailable. The file may be an orphan stub.
System action
System action
Processing continues.
Process terminates the current operation.
User response
User response
The file system must be of type JFS2 in order for the
Check to see whether the server has been disabled by Space Management to successfully set the managed
the system administrator, then retry the operation. To attribute. Verify that the file system is of the correct
check whether the file is an orphan stub or not, run type.
dsmreconcile for the affected file system. Note: the
file alias may be displayed as 'unavailable' if the ANS9556E Number of CTL files on disk
connection to server is unavailable or 'orphan' if the (number of CTLs on disk) do not
appropriate file copy cannot be located on a particular match the expected value (number
migration server. of CTLs in cache).

ANS9550W File recall has been discontinued. Explanation

The number of CTLs files counted in VCM lib cache
Explanation
should be equal to that in the local disks.
Recall stops because the file being recalled would
cause the file system to run out of space. System action
Processing is aborted.
System action
Process terminates the current operation. User response
None.
User response
ANS9576E Not enough space in filesystem to
Increase the file system space, or remove unneeded
files, or wait until space management has migrated create meta data file!
files off the file system by demand or threshold At least space space required!
migration, or manually migrate files. Then retry the
operation. Explanation

ANS9552E program-name: cannot add space A disk full error occurred attempting to create the
management to file-system; path metadata file. Please migrate some files in filesystem
includes non-local file system. to free at least space kb.

Explanation System action

An attempt was made to add space management to a Processing stops.

file system whose path contains non-local elements.

Chapter 2. ANS 0000-9999 messages 441

User response System action
None. Processing ends.
ANS9577E An exception "msg"!
Unable to use meta file! User response
None.
Explanation
ANS9592E A SOAP TCP connection error has
An internal error occurred. The dsmscout is unable to happened!
use the meta data file!
Explanation
System action
The SOAP communication system had an TCP error.
Processing stops. Please see errorlog file for more detailed information!

User response System action

None. Processing ends.
ANS9578E An unknown error occurred!
User response
Explanation None.
An internal error has occurred. The dsmscout is unable ANS9593E A SOAP HTTP communication
to use the meta data file! The file has been deleted. A error has happened!
new meta data file will be created.
Explanation
System action
The SOAP communication system had an HTTP error.
Processing stops. Please see errorlog file for more detailed information!

User response System action

None. Processing ends.
ANS9590E The SOAP error information:
message failed, reason: message User response
None.
Explanation
ANS9594E An internal SOAP error has
The detailed SOAP error message is created from happend!
gSOAP communication module and does not exist in
the chosen language! Explanation
The SOAP communication system had an internal
System action
error. Please see errorlog file for more detailed
Processing continues. information!

User response System action

Verify your system and retry the operation. Processing ends.
ANS9591E A SOAP UDP connection error has
happened! User response
None.
Explanation
ANS9595E The SOAP communication system
The SOAP communication system had an UDP error. is out of memory!
Please see errorlog file for more detailed information!

442 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
The SOAP communication system had an memory Processing of the file is interrupted. Processing
error. Please see errorlog file for more detailed continues with the next file.
information!
User response
System action
Review dsmerror.log for preceding messages that
Processing ends. might have more specific information about the error.
Verify that the file system is consistent and mounted
User response with DMAPI support enabled. Then retry the operation.
If the problem persists, contact IBM technical support
None. for further assistance.
ANS9596E The SOAP communication ended ANS9618W The mount point of HSM managed
unexpected! file system has been changed from
'old mount point' to 'new mount
Explanation point'.
The SOAP communication system had an EOF error.
Please see errorlog file for more detailed information! Explanation
The mount event of HSM managed file system on a
System action different mount point has been received.
Processing ends.
System action
User response The dsmrecalld master process is going to proceed
with mounting of the HSM managed file system.
None.
ANS9613E program-name: Stub size of User response
stubsize bytes is not supported on
filesystem. Ensure that the HSM file space is renamed on the IBM
Spectrum Protect server in accordance with the new
HSM managed file system mount point. Otherwise, a
Explanation subsequent reconciliation job will report all previously
The given stub size value not a multiple of the file migrated files (if any) as orphans.
system block size and cannot be supported.
ANS9645W The vApps backup operation
completed. However, one or more
System action vApp backups failed.
The program aborts the operation.
Explanation
User response There were successfull vApp backups but there were
Use a correct stub size. backup failures as well. The operation is considered
successfull.
ANS9616E program-name: cannot get
migration information for System action
migrated-file-alias on file-system-
name The backup operation completed successfully.

Explanation User response

Space management cannot access the specified file Check the console output and error logs for
system object using the system DMAPI functions. This information about why the backups failed. Correct any
condition might occur if DMAPI support is not enabled issues and try backing up the failed vApps again.
for the file system, or if there is an inconsistency in the
ANS9669W program-name: file-system CFI is
file system. This message is typically preceded by
out of range.
other messages that have more specific information
about the error.

Chapter 2. ANS 0000-9999 messages 443

Explanation Explanation
IBM Spectrum Protect CFI is out of range on the Invalid options or option values were encountered
specified file system. The scout daemon could not while reading the options file.
insert a new file entry into the CFI during the file
system scan. As a result, it may not provide enough System action
candidates for the next automigration.
This message is displayed. Further action depends on
your response.
System action
Processing continues. User response
Click "Yes" to allow the process to turn the invalid line
User response
into comments. If you click "No", you will exit
Please, reconsider the MAXFILES option setting for the immediately.
file system. The CFI size should likely be increased via
ANS9779E Unable to open options file '' for
'dsmmigfs update /fs -MAXFiles=n' command.
writing.
ANS9674W One or more of the required vApps
could not be retreived. Explanation
An error occurred while tried to open options file for
Explanation
writing to update it.
Not all of the vApps that were required by the given
specification could be retreived. This can be caused by System action
a change in the vCD vApps definition or a user mistake
in the provided vApp spec. Program exits.

System action User response

The operation will proceed, as there are still existing Check file and directory access permissions or correct
items to operate on. invalid entries in your options file manually.
ANS9780I The vCenter does not have NSX-T
User response setup, the virtual machine NIC
Check the provided vApps specification to make sure cannot be restored. Use the
the specification matches the existing configuration. VMDEFAULTNETWORK option to
Correct any issues and try the operation again. define the network to create the
NIC in.
ANS9733E File: File-name excluded by the
Include/Exclude list Explanation
The virtual machine NIC was defined as an opaque
Explanation
NSX-T device and NSX-T can not be found in the
You tried to back up the named file-name that was location the virtual machine is being restored to.
specified to be excluded from backup.
System action
System action
The virtual machine can be restored but the NIC
IBM Spectrum Protect did not back up the file. cannot be restored.

User response User response

Specify the file using the Include option and retry the After the virtual machine has been restored a new NIC
operation. card can be added.
ANS9778E Error(s) were detected in options ANS9782S The selected backupset was
file: '' Do you want IBM Spectrum generated by a newer version of
Protect to comment out the line the backup server, and the new
with errors and continue? backupset version is not
supported by this client; The

444 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 backupset data cannot be restored backupset, access the backupset from a IBM
by this version of the client. Spectrum Protect server.
ANS9827W Error accessing the Recall daemon
Explanation lock file: file name.
The backupset you are attempting to restore was
generated by a newer server that has a different level Explanation
of functionality. The client you are using does not
There is a problem accessing the recall daemon lock
recognize this newer format so it cannot restore the
file.
data from the backupset.

System action
System action
Unable to determine if the recall daemon is running.
Processing stopped.
Because the recall daemon is needed to perform file
recalls, the recall fails.
User response
Restore the backupset with a client that is at the same User response
or higher level as the server that was used to generate
Check with the system administrator. The recall
the backupset.
process needs read access to the /etc/adsm/
ANS9806W The file system type is not SpaceMan/dsmrecalld.pid file.
supported.
ANS9828W File: file-name is skipped for
migration: The file is either AFM
Explanation uncached or dirty.
The file system is not a type supported by space
management. Explanation
If using GPFS Active file management, the file could
System action either be uncached or dirty.
Unable to add space management to the file system. Uncached (no file data available in cache. Access
would cause replication from home)
Dirty (changed file data in cache. No valid replication in
User response
home)
There is a mismatch between the HSM client and the
file system type specified. If the file system type is System action
consistent with the intent, install an HSM client that
supports it, then try the operation again. Only one HSM The file is skipped from processing.
client can be installed at a time.
User response
ANS9807W The specified backupset file does
not contain a backupset of type Uncached (fetch the file from home to cache and rerun
"file" for the specified nodename. the processing)
Dirty (replicate the file from cache to home and rerun
Explanation the processing)

Local backupset support is limited to backupsets that ANS9829W Recall daemon is not running.
contain file data; Image backupsets are not supported
locally. The specified backupset does not contain a Explanation
backupset with file data for the node name specified.
The recall daemon is not running.

System action
System action
Processing stopped.
IBM Spectrum Protect recall fails.

User response
User response
Specify a different backupset file to restore file data
Ask the system administrator to start a recall daemon
from a backupset. To restore an image from a
by issuing the dsmrecalld command.

Chapter 2. ANS 0000-9999 messages 445

ANS9842E The watch daemon is not running Explanation
properly. An attempt to read from tape at the specified
blocksize failed; Tha maximum blocksize allowed for
Explanation the scsi driver is shown.
The watch daemon is either not running, has no dmapi
session, or is not connected to group services. System action
Processing stopped.
System action
The IBM Spectrum Protect action fails. User response
If the maximum blocksize is less than the blocksize
User response used by the operation, run the dsmmaxsg utility to
Ask the system administrator to check GPFS, the update the maximum blocksize allowed for the scsi
group services, and to restart a watch daemon by driver, and then retry the operation. If the maximum
issuing the dsmwatchd command. blocksize is greater than or equal to the blocksize
used, then verify that the tape installed and operating
ANS9845E Space management action ends. correctly and retry the operation.
ANS9857W The restored HSM for Windows
Explanation stub file may be an orphan: stub
The requested space management operation is ended file name
because the watch daemon is not working properly.
Explanation
System action
The restored stub file may not be accessible in the
Processing Ends. HSM client archive and thus it possibly cannot be
recalled.
User response
System action
Look for previous messages.
Stub file is restored.
ANS9849W Local backupset cannot be
expanded; Only full backupset
User response
restore is supported locally.
Check if the stub file can be accessed.
Explanation ANS9858E The backup-archive operation did
Local backupsets cannot be expanded to show not run. The backup-archive
volumes, directories, and files. Only full backupset operation involves stub files that
restore is supported from local backupsets. were migrated with the HSM for
Windows client. The installed HSM
System action for Windows client version version.
release. level is incompatible with
Processing stopped. installed backup-archive client
version version. release. level.
User response
To restore specific volumes, directories, and files from Explanation
a backupset, restore the backupset from the IBM The backup-archive client uses the HSM for Windows
Spectrum Protect server. client for backup-archive operations that involve
ANS9850E migrated files. The HSM for Windows client and the
Tape read error; Max Blocksize is
backup-archive client must be at the same PTF level.
blocksize. Attempted to read
blocksize blocksize. Run
dsmmaxsg to update scsi driver System action
max blocksize allowed and retry The backup-archive operation does not run for any
operation. files. Migrated files and resident files are not
processed.

446 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response Explanation
Uninstall the current HSM for Windows client and The backup verification system detected the stream of
install an HSM for Windows client at the same PTF data of the virtual machine was being sent to the
level as the backup-archive client. server in the wrong order. The backup has ended to
prevent data loss.
ANS9890W program-name: The file system
filesystem is already owned by
that node. System action
The backup operation for this VM ends.
Explanation
The file system is already owned by that node.. User response
Try the backup again. If the error persists, contact IBM
System action Software Support.
None. ANS9911E The backup verification system
detected that some data was not
User response sent during the backup of virtual
machine vm_name. The backup
None. has been halted.
ANS9892E Unable to find snapshot(s) in the
local repository. Explanation
The backup verification system detected that some
Explanation data on one of the objects sent to the server is
The requested volume snapshot(s) were not found in missing. The backup has been halted to prevent data
the local repository. loss.

System action System action

Processing stops. The backup operation for this virtual machine ends.

User response User response

Ensure the operation is issued with the proper Try the backup again. If the error persists, contact IBM
nodename and/or server address. In a non-cluster Software Support.
environment perform the operation from a different ANS9912E An error occurred when
host with the expected hostname. Retry the operation. attempting to create a VMware
ANS9895W Space management in file system vSphere Virtual Volume (VVol)
file system is not active. object. This could be the result of
an incompatibility between the
virtual machine and the datastore
Explanation
or insufficient available storage
You tried to select a file in a file system for which space.
space management is inactive.
Explanation
System action
An error occurred when attempting to create an object
The process continues with normal operation. in a VVol datastore.

User response System action

Reactivate space management for the file system, and The operation fails.
then proceed with selecting files.
ANS9910E User response
The stream of data to backup
guest vm name was sent in the Specify a different destination datastore and retry the
wrong order. The backup cannot operation.
continue.

Chapter 2. ANS 0000-9999 messages 447

ANS9913W The VM backup operation that ANS9916I VMCUSER does not have one or
uses SAN transport mode failed. more required vSphere privileges
to create/update/cancel Tasks in
Explanation vSphere related to this operation.
The operation will continue.
This issue typically occurs when the data mover that
specifies the SAN transport mode does not have SAN
Explanation
access to the VMware datastore.
VMCUSER does not have one or more required
System action vSphere privileges to create/update/cancel Tasks
related to this operation. This is informational only and
The operation fails. does not affect the Backup/Restore operation.

User response System action

Specify a different transport mode and retry the A Task related to this operation may not show up in
operation. the vSphere Client due to missing privileges. The
ANS9914W The VM backup operation may fail operation will continue.
because SAN transport mode is
not supported for vVol datastores. User response
The vSphere Task provides additional information
Explanation about IBM Spectrum Protect initiated VM Backup/
The data mover specifies the SAN transport mode. Restore operations including progress as well as the
This transport mode is not supported in an ability to cancel these tasks from the vSphere Client.
environment that contains VMware Virtual Volume Please refer to the 'VMware vCenter Server user
(Vvol) datastores. privilege requirements' section of the 'IBM IBM
Spectrum Protect for Virtual Environments: Data
Protection for VMware User's Guide.'
System action
ANS9917E Size estimates that correspond to
The operation fails.
the expected control files for vm
name do not match.
User response
Specify a different transport mode and retry the Explanation
operation.
During the verify operation, the control files that were
ANS9915E The guest vm name is missing found on the server do not match the expected size
expected data files from the estimate of the data files for one or more disks.
previous backups. The backup
operation continues based on the System action
setting of the VMVERIFYAction
option. The backup operation for this VM continues based on
the setting of the VMVERIFYIFAction option.
Explanation
User response
During the verify operation, the number of data files
that were found on the server are insufficient to match Run a full VM backup for this virtual machine. Or,
the requirements of the control files. specify the VMVERIFYAction option to force a full VM
backup.
System action ANS9918E Cannot open migration candidates
list for file-system.
The backup operation for this VM continues based on
the setting of the VMVERIFYIFAction option.
Explanation
User response Cannot access the migration candidates list for the
specified file system.
Run a full VM backup for this virtual machine. Or,
specify the VMVERIFYAction option to force a full VM
backup.

448 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The system continues normal operation. During a verify operation, the number of control files
that were found on the server do not match the
User response expected number for this disk. For disks on NFS
datastores: Because of how VMware processes disk
Select OK to return. size changes and because the Change Block Tracking
ANS9919E Failed to find the expected control (CBT) QueryChangedDiskAreas API does not support
files for vm name. change ID "*", the backup operation cannot determine
whether the the disk size was changed, the disk was
moved to NFS datastore or some other error occurred.
Explanation
During a verify operation, the number of control files System action
that were found on the server do not match the
expected amount for one or more disks. The backup operation for this VM proceeds based on
the VMVERIFYIFAction option.
System action
User response
The backup operation for this VM continues based on
the VMVERIFYIFAction option. Perform a full VM backup for this virtual machine or
specify the VMVERIFYIFAction option to force a full
VM backup.
User response
ANS9922I VMVERIFYIFLatest is enabled for
Perform a full VM backup for this virtual machine or
vm name (action: type).
specify the VMVERIFYAction option to force a full VM
backup.
Explanation
ANS9920W Forcing a full vm backup for vm
name. This VM operation verifies the control files from the
previous backup to ensure that all expected files are
on the server.
Explanation
During a verify operation, the number of control files System action
that were found on the server do not match the
expected amount for one or more disks. As a result, a The operation proceeds based on the value of the
full VM backup is performed. VMVERIFYIFAction option.

System action User response

The backup operation for this VM is a full backup Ensure the VERIFYIFAction option is set to the wanted
instead of an incremental backup. value.
ANS9923W Forcing a full backup for vm name.
User response
Ensure the VERIFYIFAction option is set to the wanted Explanation
value. The MAX capacity of MBLK is not enough for the disks
ANS9921E Virtual machine disk, vm name in the incremental backup. A full backup will be
(disk label), verification check performed.
failed (size on disk/ ctl size). If the
disk is on an NFS datastore and System action
the disk size was recently changed The backup operation for this VM is a full backup
or the disk was moved from non- instead of an incremental backup.
NFS datastore to NFS datastore,
the verification failure is expected
and a full backup is required. User response
None.

Chapter 2. ANS 0000-9999 messages 449

ANS9924W A full backup for the vm name Explanation
virtual machine will be performed This file cannot be migrated because it has not yet
because of added disk capacity. reached the age for migration.

Explanation System action

The disk capacity of the virtual machine has increased
The file resides in state resident.
since the last backup. A full backup and a Changed
Block Tracking (CBT) reset will be performed.
User response
System action The minimal age of a file to be eligible for migration is
two minutes. Retry the migration operation after two
The backup operation for this virtual machine is a full minutes or use processing option
backup instead of an incremental backup. HSMENABLEIMMediatemigrate YES to force the
migration.
User response
ANS9959W IBM Spectrum Protect acceptor
No action is required. received a non-critical network
ANS9950W Streaming and partial recall error errno, IBM Spectrum Protect
modes can not be set for files return code : TSM-rc.
migrated using external backend.
Explanation
Explanation The communication problem happened while listening
Streaming or partial recall modes are not supported for inbound connection but the IBM Spectrum Protect
for files in this mode. acceptor continues running.

System action System action

Operation aborted. Processing continues.

User response User response

Special recall modes are only available for files No further action is required, it can be safely ignored.
migrated using IBM Spectrum Protect Server as a ANS9984W PFR plugin library was not found.
backend.
ANS9951I File: file-name has already been Explanation
migrated. PFR plugin library should have been installed when the
client was installed, but it cannot be found.
Explanation
You tried to migrate a file that is already migrated. System action
Note that you may get this message if the file is hard The selected operation is not performed.
linked with another, already migrated file.

User response
System action
None.
The file is skipped.
ANS9987W Partial recall mode is not set for
User response full-file-name

None.
Explanation
ANS9958E File 'file-namefile-namefile-name Partial recall mode is not set for the specified file.
has not yet reached the age for
migration. File skipped.
System action
The recall is not performed for the specified file.
Processing stopped.

450 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response policy domain, and the correct domain has the
management class).
Set the partial recall mode on the file ("dsmattr -
recallmode=partialrecall" command) and re-try the • Remove the INCLUDE statement if it is no longer
operation. necessary to bind the files to the management class.

ANS9989W Management class mcName ANS9992E The following options must be set
specified on the INCLUDE before running this operation:
statement in file-name at line line- VMCHOST or VMCUSER.
number does not exist.
Explanation
Explanation VMCHOST or VMCUSER is missing from the options
Management class named on the INCLUDE statement file.
in the file-name file does not exist in your assigned
policy set on the server. System action
Operation cannot continue without options being set.
System action
The object is bound to the default management class. User response
Manually edit the options file or use the preferences
User response editor to set these options.
• Update the INCLUDE statement so that it specifies a
ANS9993E Not able to override options.
valid management class.
• Define the management class named on the Explanation
INCLUDE statement (if it is intended to have a
management class with that name). The process can not override the options.
• Verify that the node is in the correct policy domain
(perhaps the node was accidentally put in the wrong System action
policy domain, and the correct domain has the The command is not processed.
management class).
• Remove the INCLUDE statement if it is no longer User response
necessary to bind the files to the management class.
None.
ANS9990W Management class mcName
specified on INCLUDE statement ANS9994W Can not get response message,
in client option set does not exist. timeout reached.

Explanation Explanation

Management class named on the INCLUDE statement The timeout was reached before getting response
in client option file does not exist in your assigned message. The option override could be successful.
policy set on the server.
System action
System action The command processed.
The object is bound to the default management class.
User response
User response None.
• Update the INCLUDE statement so that it specifies a ANS9995W The value of the
valid management class. VMMAXBACKUPSESSIONS option
• Define the management class named on the is 'ivmMaxBackupSessions'. This
INCLUDE statement (if it is intended to have a value must be greater than or
management class with that name). equal to the value of the
• Verify that the node is in the correct policy domain VMMAXPARALLEL option, which is
(perhaps the node was accidentally put in the wrong 'ivmMaxParallel'.

Chapter 2. ANS 0000-9999 messages 451

 The value will be set to the value run "kill -15 dsmwatchd_pid" command; - on Linux:
of the VMMAXPARALLEL option. run "systemctl restart hsm" command.
ANS9998W The DMAPI dm_punch_hole()
Explanation function failed to discard local file
The number of server sessions that are specified by data blocks during migration of
the VMMAXBACKUPSESSIONS option must be equal 'file-name' file.
to or greater than the number of virtual machines that
are specified by the VMMAXPARALLEL option. Explanation
The migration operation succeeded, but it was unable
System action to discard the file local file data blocks due to a DMAPI
The operation continues. dm_punch_hole() function issue. As a result, the file
system occupation didn't change upon such a
migration.
User response
Set the value of the VMMAXBACKUPSESSIONS option System action
to a value that is greater than or equal to the value of
the VMMAXPARALLEL option. The migration operation continues.

ANS9996W The node has exceeded the

User response
maximum tape mounts that are
allowed. No new sessions will be To re-stub the file, perform a subsequent normal recall
added for 'vm-name'. operation, followed by one more migrate operation. If
the cause of this message can not be determined or
Explanation resolved, contact your support representative.

The node has exceeded the maximum tape mounts ANS9999E ():
that are allowed. No new sessions will be added for
the backup VM. Explanation
This message carries diagnostic text relating to a client
System action process or algorithm. This information is intended for
The backup operation continues. reporting processing exceptions and other non-
standard situations that occur on the IBM Spectrum
Protect client. The (component), (code), and (text) will
User response
vary depending upon the cause of the message and
Use the MAXNUMMP parameter for the UPDATE NODE the client process or algorithm that issues the
command on the server to increase the number of message.
allowed tape mounts for this node.
ANS9997W The dsmwatchd daemon failed to System action
register failover mode: 'failover- Client processing may or may not continue depending
mode' on nodeID: 'node-ID'. upon the cause of this message.

Explanation User response

The dsmwatchd daemon was unable to register an Examine error messages that may have been
appropriate HSM failover callback on the mentioned displayed before and/or after this message and correct
node. any problems, if possible. If the cause of this message
can not be determined or resolved, contact your
System action support representative. If you contact your support
representative, the entire text of this message should
The dsmwatchd daemon operation continues without
be reported.
HSM failover support.

User response
To register the HSM failover callback, restart the
dsmwatchd daemon on the affected node: - on AIX:

452 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Chapter 3. API return codes

IBM Spectrum Protect V8.1.9 API return codes are listed. The format of the return codes is described.
In addition, some messages that are issued for SSL processing include GSKit return codes. For more
information, see IBM Global Security Kit return codes.

API return code format

This section explains the API (Application Programming Interface) return code format. For each return
code, the following information is provided:
• The return code number. This number corresponds to the number in the dsmrc.h header file.
• The severity code. This letter is an indication of the severity that generated the return code. The severity
codes and their meanings are:
S Severe error Processing cannot continue.
E Error Processing cannot continue.
W Warning Processing can continue, but problems might develop later.
You should be cautious.
I Information Processing continues. User response is not necessary.
• 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.
• The explanation. This field explains the circumstances under which this return code might be
generated.
• The system action. This field describes what action IBM Spectrum Protect is going to take in response
to the return code.
• 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

IBM Spectrum Protect V8.1.9 API return codes are listed in ascending numeric order. The complete
return code is documented.
-452 E DSM_RC_SHM_NOTAUTH System action
Insufficient authority to connect to The session is rejected and processing stops.
the shared memory region

User response
Explanation
Run the command under the uid of the processing
The user issuing the command does not have authority running dsmserv, if possible. Otherwise contact your
to connect to the shared memory segment. When the system administrator for further help.
shared memory segment is created by the server, it
will be owned by the effective uid of the server process -451 E DSM_RC_SHM_FAILURE An error
(dsmserv). Only processes running under this uid or occurred using the Shared Memory
root will be allowed to connect to the segment (and protocol
thus to the server).

© Copyright IBM Corp. 1993, 2019 453

Explanation as the one used by the server. If the problem
continues, contact your system administrator for
An error has occurred while reading or writing data
further help.
through the Shared Memory communications protocol.
-057 E DSM_RC_TCPIP_LOADFAILURE
System action The TCP/IP load function failed.

IBM Spectrum Protect cannot complete the requested

Explanation
operation.
An error occurred while locating a function. The
User response TCP/IP load function failed.

Check the trace log for additional information and retry

System action
the operation. If the problem continues, see your
system administrator for further help. Processing stopped.
-450 E DSM_RC_SHM_TCPIP_FAILURE
Session rejected: TCP/IP User response
connection failure for Shared Verify your TCP/IP installation.
Memory
-056 E DSM_RC_TCPIP_DLL_
LOADFAILURE An error occurred
Explanation
while loading a library.
An attempt to connect to the local server using the
Shared Memory protocol has failed during initial Explanation
TCP/IP communications. This error can occur if the
server is not listening on the correct port, or if the An error occurred while loading a library. The TCP/IP
server is down. DLL load failed.

System action System action

Session rejected. Processing stopped. Processing stopped.

User response User response

Retry the operation, or wait until the server comes Verify your TCP/IP installation.
back up and retry the operation. If the problem
-055 E DSM_RC_WINSOCK_MISSING The
continues, see your system administrator for further
TCP/IP WINSOCK.DLL file cannot
help.
be found.
-190 E DSM_RC_NP_ERROR Session
rejected: Named Pipes connection Explanation
failure.
The TCP/IP WINSOCK.DLL file cannot be found.

Explanation
System action
An attempt to connect to the server using Named
Processing stopped.
Pipes communications failed. This might have
occurred if an incorrect NAMEDPIPENAME was
specified in the options files or if your system User response
administrator canceled a backup operation. Verify your TCP/IP installation.

System action -054 E DSM_RC_NETWORK_UNREACHAB

LE The specified TCP/IP host name
Processing stopped. is unreachable

User response Explanation

Retry the operation, or wait until the server comes The TCP/IP host name specified in the
back up and retry the operation. Ensure that the value TCPSERVERADDRESS statement cannot be reached.
specified on the NAMEDPIPENAME option is the same

454 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action User response
Processing stopped. The server was not fully initialized, is not currently
running, was not enabled for TCP/IP communications,
User response or an incorrect TCP/IP port number was specified. If
the problem continues, see your system administrator.
Check your options file for the correct
TCPSERVERADDRESS statement. See your -051 E DSM_RC_CONN_TIMEDOUT The
administrator for the correct name of the server. attempt to establish a TCP/IP
connection timed out before the
-053 E DSM_RC_BAD_HOST_NAME An connection was made.
invalid TCP/IP address was
specified.
Explanation

Explanation The Object of the connection attempt failed to respond

within the the allotted wait time. In the case of the B/A
The TCP/IP address specified by the IBM Spectrum client, this message is preceded in dsmerror.log by
Protect client's TCPSERVERADDRESS setting could not message ANS5216E that gives details of the
be found on the network. Common reasons for this connection that failed. The condition may be
error include: temporary.
• The TCPSERVERADDRESS client option specifies the
wrong TCP/IP address for the IBM Spectrum Protect System action
server".
processing stops.
• The machine that hosts the IBM Spectrum Protect
server is not on the network. User response
• A network problem is preventing the IBM Spectrum
• Restart the IBM Spectrum Protect client and retry
Protect client from reaching the machine that hosts
the operation.
the IBM Spectrum Protect server.
• Check the client options file and verify that
System action TCPSERVERADDRESS and TCPPORT specify the
correct TCP/IP address and port number for your
processing stops. IBM Spectrum Protect server.
• Verify that network connectivity exists between the
User response IBM Spectrum Protect client machine and the IBM
Verify that the TCPSERVERADDRESS and TCPPORT Spectrum Protect server machine.
settings have the correct values for your IBM • If the problem persists, see your IBM Spectrum
Spectrum Protect server. Use your operating system's Protect administrator for further assistance.
"ping" (or similar) utility to ensure that your machine
can locate the machine that hosts the IBM Spectrum -050 E DSM_RC_TCPIP_FAILURE Session
Protect server across the network. Try the operating rejected: TCP/IP connection
again. If the problem persists, ask your IBM Spectrum failure.
Protect administrator for further assistance.
Explanation
-052 E DSM_RC_CONN_REFUSED An
attempt to establish a TCP/IP An attempt to connect to the server using TCP/IP
connection was rejected by the communications failed. This can be a result of
host 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
Explanation
backup operation.
An attempt to establish a TCP/IP connection was
rejected by the server. System action
Session rejected. Processing stopped.
System action
Processing stopped.

Chapter 3. API return codes 455

User response System action
Retry the operation, or wait until the server comes Processing stopped.
back up and retry the operation. If the problem
continues, see your system administrator for further User response
help.
Ensure the names are properly entered. If the object is
0000 I DSM_RC_OK Successfully done. part of a backupset generated prior to a node name
change, ensure that the node name is the same as the
Explanation node for which the backup set was generated.
The operation successfully completed. 0003 E DSM_RC_ABORT_BY_CLIENT
Client ended transaction
System action
Explanation
None.
The client system ended the operation with the server
User response and ended the current transaction.

None.
System action
0001 E DSM_RC_ABORT_SYSTEM_ERROR Processing stopped.
This operation cannot continue
due to an error on the IBM
Spectrum Protect server. See your User response
IBM Spectrum Protect server Restart the session.
administrator for assistance.
0004 W DSM_RC_ABORT_ACTIVE_NOT_
FOUND An active backup version
Explanation
could not be found.
The IBM Spectrum Protect server encountered an
error condition that prevents the IBM Spectrum Explanation
Protect client operation from continuing. Your IBM
Spectrum Protect server administrator can review the An attempt was made to expire an object, but the IBM
IBM Spectrum Protect server activity log for more Spectrum Protect server was unable to find an active
details about the error. backup version of the object. This message is
preceded by message ANS1228E which specifies the
object name.
System action
For instance, this message could be issued if two
Processing stopped. separate client processes are backing up the same file
system at the same time. If one of the processes
User response expires a file, then the IBM Spectrum Protect server
will make that file inactive. If the second process
Contact your IBM Spectrum Protect server subsequently attempts to expire that same file, the
administrator for assistance. The administrator can IBM Spectrum Protect server will not find an active
review the IBM Spectrum Protect server activity log for version of the file, so the second process will issue this
further information about the conditions that lead to message for that file.
this error.
0002 E DSM_RC_ABORT_NO_MATCH No System action
objects on server match query The object is not expired. Processing continues with
the next object.
Explanation
No objects on the server match the query operation User response
being performed. If this object is part of a backupset • Review the console output, schedule log, or error log
generated on a node, and the node name is changed and locate the ANS1228E message that immediately
on the server, any backup set objects that were precedes this message. ANS1228E will identify the
generated prior to the name change will not match the object that could not be expired.
new node name.

456 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
• Examine the conditions under which the problem Explanation
occurred and assess whether those conditions
The node you are running on is in use by another
explain the occurrence of this message. For
operation on the server. This might be from another
example, this message could appear if multiple
client or from some activity on the server.
instances of the client were attempting to back up
the file system concurrently.
System action
• If the reason this message occurred can not be
determined and the message occurs when the Processing stopped.
operation is tried again, then contact IBM support for
further assistance. Also try searching for this User response
message number on http://www.ibm.com for
possible solutions. Retry the operation, or see your system administrator
to see what other operations are running for your
0005 E DSM_RC_ABORT_NO_DATA The node.
IBM Spectrum Protect server has
no data for the object. 0008 E DSM_RC_ABORT_EXPDATE_TOO_
LOW Expiration date must be
greater than today's date
Explanation
IBM Spectrum Protect tried to do a restore or retrieve Explanation
on an object that has no data associated with it. If a
corrective action is possible, it is with the IBM Archive expiration date is too low, the date must be
Spectrum Protect server. greater than today's date.

System action System action

IBM Spectrum Protect ends the current operation. IBM Spectrum Protect canceled the current operation.

User response User response

Ask the IBM Spectrum Protect administrator to check Retry archiving the file with an expiration date that is
the IBM Spectrum Protect activity log for any higher than today's date.
messages related to this error that might help identify 0009 W DSM_RC_ABORT_DATA_OFFLINE
the problem. The requested data is offline.
0006 E DSM_RC_ABORT_BAD_VERIFIER
You entered an incorrect Explanation
password. For the restore or retrieve operation, one or more of
the requested files must be recalled from offline
Explanation storage media (generally tape). The wait time depends
You entered an incorrect current password or you on your site's offline storage management policies.
entered a new password that does not fulfill the
password length requirements set on the server. System action
IBM Spectrum Protect waits for offline storage media
System action to become available and then continues.
Processing stops.
User response
User response None.
Retry the session with the correct password. If this 0010 E DSM_RC_ABORT_EXCLUDED_BY_
fails or you have forgotten your password, ask the IBM SIZE Object too large for server
Spectrum Protect administrator to assign a new limits
password.
0007 E DSM_RC_ABORT_NODE_IN_USE Explanation
Node in use The object is too large. The configuration of the server
does not have any data storage space that accepts the
object.

Chapter 3. API return codes 457

System action 0013 E DSM_RC_ABORT_SIZESTIMATE_
EXCEED Size estimate exceeded
File skipped.

Explanation
User response
The total amount of data for a backup or archive
See your system administrator to determine the
operation exceeds the estimated size originally sent to
maximum file (object) size for which your site's server
the server for allocating data storage space. This
is configured.
happens when many files are growing by large
0011 E DSM_RC_ABORT_NO_REPOSIT_ amounts while the backup or archive operation is in
SPACE Server out of data storage session.
space
System action
Explanation
Processing stopped.
The server does not have any space available to store
the object. User response
Retry the operation. If the problem continues, check
System action
what other processes are running on the client
Processing Ends. machine that are generating large amounts of data.
Disable those operations while the backup or archive
User response operation is taking place.

You can take any of the following actions: 0014 E DSM_RC_ABORT_DATA_

UNAVAILABLE File data currently
• Request the system administrator to add space to unavailable on server
the storage pool.
• For IBM Spectrum Protect client, set Explanation
COMPRESSALWAYS=NO and COMPRESSIon=YES in
the options file (DSM.OPT), then the file will be The file data is currently unavailable on the server. A
resent uncompressed if it grows during retrieve or restore operation was attempted. Possible
compression. causes are:
• For API Applications, consult the application's • Data was corrupted at the server
documentation for recommendations regarding • Server found a read error
compression.
• File is temporarily involved in a reclaim operation at
• Turn off disk caching in the disk storage pool, and the server
issue MOVE DATA commands to each disk pool
volume to clear out the cached bitfiles. • Server requested a tape volume that was marked
unavailable.
0012 E DSM_RC_ABORT_MOUNT_NOT_
POSSIBLE Server media mount not System action
possible
Processing stopped.
Explanation
User response
Server media mount not possible. The server timed out
waiting for a mount of an offline volume. 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
System action
any requests were made for a tape volume that was
File skipped. unavailable. A tape volume may be marked
unavailable if prior read errors were encountered or
User response the volume is checked out of the tape library.

Retry later when server volumes can be mounted. 0015 E DSM_RC_ABORT_RETRY

Ensure that the MAXNUMMP (maximum number of Unexpected retry request. The
mount points) defined on the server for this node is IBM Spectrum Protect server
greater than 0.

458 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 found an error while writing the System action
data.
Processing ends.

Explanation
User response
None.
This is a temporary problem. Retry later or see your
system administrator.
System action
0020 E DSM_RC_ABORT_FS_NOT_
If the current operation supports another attempt, the DEFINED The specified file space
client tries the operation again. Otherwise, processing does not exist on the server. The
stops. file space might have been deleted
by another client or an
User response administrator.
None.
Explanation
0016 E DSM_RC_ABORT_NO_LOG_SPACE
The server does not have enough The specified file space does not exist on the server.
recovery log space to Your system administrator deleted the file space or
continue the current operation another client using your client's node name deleted it.

Explanation System action

The server ran out of recovery log space. Current operation has been cancelled.

System action User response

Processing ends. Check the file space name to see if it is correct, and
retry the operation.
User response 0021 S DSM_RC_ABORT_NODE_ALREADY
This error is a temporary problem. Retry later or see _ DEFED Open Registration failed
your system administrator. because the specified node name
is defined in the server
0017 E DSM_RC_ABORT_NO_DB_SPACE
The server does not have enough Explanation
database space to continue
the current operation Open registration failed because a node is defined in
the server with the same name.
Explanation
System action
The server ran out of database space.
Current operation has been cancelled.
System action
User response
Processing ends.
Retry with another node name.
User response 0022 S DSM_RC_ABORT_NO_DEFAULT_
See your system administrator. DOMAIN Open Registration failed
because no default domain exists
0018 E DSM_RC_ABORT_NO_MEMORY
The server does not have enough Explanation
memory to continue the current
operation. Open registration failed because a default policy
domain does not exist for you to place your node.
Explanation
System action
The server ran out of memory.
Current operation has been cancelled.

Chapter 3. API return codes 459

User response System action
See your system administrator. The current operation ends.
0023 S DSM_RC_ABORT_INVALID_
NODENAME Open Registration User response
failed because an invalid node Make sure all objects are bound to a valid
name was specified management class, or upgrade the client to the proper
level.
Explanation
0025 E DSM_RC_ABORT_DEST_NOT_
Open registration failed because the specified node DEFINED Server problem:
name contains invalid characters. Destination not defined.

System action Explanation

Current operation has been cancelled. Server problem: Destination not defined.

User response System action

Retry with another node name that does not have any Processing stopped.
invalid characters.
0024 S DSM_RC_ABORT_INVALID_POL_ User response
BIND A policy management Have your service representative check the error log.
problem has occurred on the IBM
Spectrum Protect server. 0026 S DSM_RC_ABORT_WAIT_FOR_
SPACE The IBM Spectrum Protect
server does not currently have
Explanation
space in the storage pool for this
The client error log and IBM Spectrum Protect server file. This may be a temporary
activity log may contain additional information about condition.
this error.
Explanation
System action
This message is typically issued when the storage pool
Processing is stops. in which the data is being placed does not have
sufficient space to store the data, but the space will be
User response available soon. For example, a storage pool migration
might free up sufficient space to store the data.
Try the operation again. If the problem persists,
examine the client error log and IBM Spectrum Protect
System action
server activity log for additional information about this
error. If the problem cannot be resolved, then obtain a Current operation has been cancelled.
SERVICE trace that captures the problem and contact
IBM technical support for additional assistance. Your User response
IBM Spectrum Protect administrator can help you
configure the trace. Try the operation at a later time. If this fails, contact
the IBM Spectrum Protect administrator and request
0024 E DSM_RC_ABORT_NO_INVALID_ more storage pool space.
POL_BIND An object in the
transaction has been bound to an 0027 E DSM_RC_ABORT_NOT_
invalid management class. AUTHORIZED The file space
cannot be deleted because this
node does not have permission to
Explanation
delete archived or backed up data.
One of the objects in the transaction is bound to a
management class that is not part of this node's Explanation
policy, or the management class type is not supported
for this client level. You cannot delete the file space data unless your IBM
Spectrum Protect administrator has authorized your

460 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
node to do so. Authorization permits you to delete Explanation
backup data, archive data, or both.
The node or user is trying to perform an operation that
either exceeds license values, or is not licensed.
System action
Delete processing fails. System action
The session is rejected or the transaction is cancelled,
User response ending the current operation.
Use the DSMC QUERY SESSION command to verify
your authorization. Ask your IBM Spectrum Protect User response
administrator to provide the necessary authorization
See your system administrator.
or to delete the file space for you.
0032 E DSM_RC_ABORT_DUPLICATE_
0028 E DSM_RS_ABORT_RULE_ALREADY
OBJECT A duplicate object was
_ DEFED 'Access rule' Access Rule
found, operation cannot complete.
already defined for node 'node'.
Old rule must be deleted before
new one can be defined. Explanation
A duplicate object was found, operation cannot
Explanation complete.
You are trying to define authorization for the specified
node, which already has authorization defined. System action
The requested operation failed.
System action
IBM Spectrum Protect did not redefine authorization User response
for the specified node. Try the operation with a different file specification.

User response 0033 E DSM_RC_ABORT_INVALID_

OFFSET partialObjOffset value for
Update the authorization, or delete the old rule and partial object retrieve is invalid.
define a new one, or use the current authorization.
0029 S DSM_RC_ABORT_NO_STOR_ Explanation
SPACE_STOP Server out of data The partialObjOffset value for partial object retrieve is
storage space invalid.

Explanation System action

The server does not have space available to store the The system returns to the calling procedure.
object.
User response
System action
Specify a valid value.
Processing Ends.
0034 E DSM_RC_ABORT_INVALID_
User response LENGTH partialObjLength value
for partial object retrieve is
Report to your system administrator that a storage invalid.
pool on the server is full.
0030 E DSM_RC_ABORT_LICENSE_ Explanation
VIOLATION The operation is not partialObjLength value for partial object retrieve is
permitted due to server licenses invalid.
values.
System action
The system returns to the calling procedure.

Chapter 3. API return codes 461

User response User response
Specify a valid value. See documentation for the merge test parameters.
0036 E DSM_RC_END_NODE_NOT_ 0047 E DSM_RC_ABORT_INVALID_
AUTHORIZED The node or user OPERATION An invalid operation
does not have proper authority to was attempted on a node
perform this operation
Explanation
Explanation
The operation is not valid.
The node or user does not have proper authority to
perform this operation. System action
Current operation has ended.
System action
The transaction is ended. User response
Contact your system administrator for more
User response
information.
Check the authority for the specified object.
0048 E DSM_RC_ABORT_STGPOOL_
0041 E DSM_RC_ABORT_EXCEED_MAX_ UNDEFINED The specified target
MP This node has exceeded its storage pool is not defined.
maximum number of mount
points. Explanation
The storage pool is not defined.
Explanation
Either no tape or sequential disk mount points are System action
permitted for this operation, or the maximum number
of mount points allowed are already in use. The Current operation has ended.
operation can not be completed. The IBM Spectrum
Protect administrator defines the maximum number of User response
mount points with the MAXNUMMP property of your
Contact your system administrator for more
node definition.
information.

System action 0049 E DSM_RC_ABORT_INVALID_DATA_

FORMAT A target storage pool
The object is skipped does not have the correct data
format for the given node type.
User response
If you are performing any other operations that might Explanation
be using mount points, wait until those operations are none
complete, then try the failed operation again.
Otherwise contact your IBM Spectrum Protect
System action
administrator for further assistance
Current operation has ended.
0045 E DSM_RC_ABORT_MERGE_ERROR
The specified objects failed the
merge test. User response
Contact your system administrator for more
Explanation information.
The specified objects failed the merge test, operation 0050 E DSM_RC_ABORT_DATAMOVER_
cannot complete. UNDEFINED No associated data
mover is defined for the given
System action node.
The requested operation failed.

462 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation authority, or is not known by the
server
none

Explanation
System action
The user ID, which is either IBM Spectrum Protect
Current operation has ended.
node name or administrative user ID, is not known by
the server. Possible reasons for this include:
User response
Your node name is not registered with the IBM
Contact your system administrator for more Spectrum Protect server
information. The node name is correct but does not have a
0051 E DSM_RC_REJECT_NO_RESOURCE corresponding administrative ID with the same
S Session rejected: All server name and client owner authority
sessions are currently in use you are attempting to access a file that was
migrated to a different node.
Explanation
System action
IBM Spectrum Protect has all available sessions in use
and cannot accept a new one at this time. Current operation has been cancelled.

System action User response

Current operation has been cancelled. Do the following checks:
Check that your IBM Spectrum Protect user ID is
User response entered correctly.
Retry the operation. If the problem continues, see your Check the administrative ID associated with your
system administrator to increase the number of IBM Spectrum Protect node and verify that the IBM
concurrently active sessions to the server. Spectrum Protect node name has a matching
administrative ID with client owner authority for the
0052 E DSM_RC_REJECT_VERIFIER_ node. If it does not, your IBM Spectrum Protect
EXPIRED The session is rejected. administrator needs to create it.
Your password has expired. Check that the server is using closed registration
and that your node name is registered with the
Explanation server.
The password for IBM Spectrum Protect user ID has If attempting to access a migrated file, your node
expired. It can be either IBM Spectrum Protect node name must be the same node that migrated the
name password or administrative user ID password or file.
both. 0054 E DSM_RC_REJECT_DUPLICATE_ID
Session rejected: Duplicate ID
System action entered
Current operation has been cancelled. You are not
allowed to connect to the server until the password is Explanation
updated. Another process using this node name is active with
the server.
User response
Update your password. It may require updating the System action
node name password or the corespondent IBM Spectrum Protect cannot connect to the server.
administrative ID password or both. You may use the Current operation has been cancelled.
SET PASSWORD command, or have the IBM Spectrum
Protect administrator update your node or your
User response
administrative ID.
If you are running a UNIX-based system, ensure that
0053 E DSM_RC_REJECT_ID_UNKNOWN
another process is not active with IBM Spectrum
Session rejected: User ID is
Protect under the same name. Also, ensure that your
incorrect, does not have admin
node name is unique to the server so that it cannot be

Chapter 3. API return codes 463

used by another person. See your system 0058 S DSM_RC_REJECT_SERVER_
administrator to identify the owner of that node name. DOWNLEVEL Session rejected:
Downlevel server code version
0055 E DSM_RC_REJECT_SERVER_
DISABLED Session rejected:
Server disabled. Explanation
The server version and your client version do not
Explanation match. The server code is downlevel.
The server is in a disabled state and cannot be
accessed for normal activity. System action
Current operation has been cancelled.
System action
Current operation has been cancelled. User response
See your system administrator to see what version of
User response IBM Spectrum Protect to run for your location.
On the IBM Spectrum Protect server, run the ENABLE 0059 E DSM_RC_REJECT_ID_IN_USE
SESSIONS administrative command. Try the operation Session Rejected: The specified
again after the server returns to an enabled state. If node name is currently in use
the problem continues, see your system administrator.
0056 E DSM_RC_REJECT_CLOSED_ Explanation
REGISTER The server is not The node name you specified is in use on the server.
configured to allow open
registration
System action

Explanation Session was not started.

No authorization. Registration is required by your

User response
system administrator. The server is not configured to
allow open registration. The server is probably performing a task that prevents
your node from establishing a session. Retry later or
System action check with your system administrator.

Session not started. 0061 E DSM_RC_REJECT_ID_LOCKED

Session Rejected: The specified
User response node name is currently locked.

You must obtain a IBM Spectrum Protect node and Explanation

password from your system administrator.
The node name you specified is currently locked on
0057 S DSM_RC_REJECT_CLIENT_ the server.
DOWNLEVEL Session rejected:
Downlevel client code version
System action

Explanation Session was not started.

The server version and your client version do not

User response
match. The client code is downlevel.
Check with your system administrator to find out why
System action your node name is locked.

Current operation has been cancelled. 0062 S DSM_RC_SIGNONREJECT_

LICENSE_MAX SLM LICENSE
User response EXCEEDED: The client licenses for
IBM Spectrum Protect are
See your system administrator to see what version of exceeded.
IBM Spectrum Protect to run for your location. See your system administrator.

464 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation System action
Adding a new enrollment will exceed the product Session was not started.
license count for IBM Spectrum Protect.
User response
System action
This error is a temporary problem. Retry later or see
Execution of the client enrollment or connection your system administrator.
request ends.
0066 E DSM_RC_REJECT_INTERNAL_
ERROR The session is rejected.
User response The IBM Spectrum Protect server
See your system administrator. has an internal error.

0063 E DSM_RC_REJECT_NO_MEMORY
Explanation
Session Rejected: The server does
not have enough memory to The client cannot establish a connection to the IBM
allow a connection to be Spectrum Protect server because of an internal server
established. error.

Explanation System action

The server does not have enough memory to allow The session was not started.
your client to establish a connection with the server.
User response
System action
Notify your IBM Spectrum Protect administrator of this
Session was not started. error.
0067 S DSM_RC_SIGNONREJECT_
User response INVALID_CLI Session Rejected:
Retry later or see your system administrator. The server is not licensed for this
platform type.
0064 E DSM_RC_REJECT_NO_DB_SPACE See your system administrator.
Session Rejected: The server does
not have enough database
Explanation
space to allow a connection to be
established. The server is not licensed for the requesting client
type.
Explanation
System action
The server ran out of database space.
Execution of the client enrollment or connection
System action request ends.

Session was not started.

User response

User response See your system administrator.

See your system administrator. 0068 E DSM_RC_CLIENT_NOT_

ARCHRETPROT The session is
0065 E DSM_RC_REJECT_NO_LOG_SPAC rejected. The server does not
E Session Rejected: The server allow a signon of a client that is
does not have enough recovery log not archive-retention protection
space to allow a connection to be enabled.
established.
Explanation
Explanation
The client cannot establish a connection to the server
The server ran out of recovery log space. because the server is enabled for archive-retention
protection enabled and the client is not.

Chapter 3. API return codes 465

System action System action
The session is not started. The IBM Spectrum Protect operation ends.

User response User response

See your system administrator. Contact your systems administrator to enable client-
initiated sessions for your node or update the
0069 E DSM_RC_SESSION_CANCELED SESSIONINITIATION option and run the client
Session Rejected: The session was scheduler.
canceled by the server
administrator. 0075 E DSM_RC_REJECT_WRONG_PORT
Wrong server port.
Explanation
Explanation
The server administrator canceled the current client
session. You were trying to open a backup/archive client
session on the server port set up for administrative
System action sessions only.

Execution of the client connection request ends.

System action

User response The IBM Spectrum Protect operation ends.

See your system administrator.

User response
0073 E DSM_RC_REJECT_INVALID_ Contact your systems administrator and/or use the
NODE_TYPE An inconsistency was correct values for TCP port and TCP Admin Port.
detected between the client node
and 0079 E DSM_RC_CLIENT_NOT_
the node that is registered to the SPMRETPROT The session is
IBM Spectrum Protect server. rejected. The server does not
allow a signon of a client that is
Explanation not enabled for space-
management retention-protection.
The user has probably coded the node option
incorrectly. For instance, the node that is registered to
Explanation
the IBM Spectrum Protect server might be a type of
NAS, but the node is actually a non-NAS client. The client cannot establish a connection to the server
because the server is enabled for space-management
System action retention-protection and the client is not.

Operation ends.
System action

User response The session is not started.

Ensure that the node name is correct in the client

User response
options file. Make sure to use a node of type NAS only
with the nasnodename option. See your system administrator.
0074 E DSM_RC_REJECT_INVALID_ 0101 W DSM_RC_USER_ABORT The
SESSIONINIT Server does not operation was stopped by the
allow client-initiated connections user.
for this node.
Explanation
Explanation
The operation was stopped at the request of the user.
The node is not allowed to initiate connections due to This usually occurs when the 'Q' key is pressed two
the configuration parameters for this node on the times.
server. Server is able to initiate connections to the
client scheduler running in prompted mode.

466 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action the file before it could be backed up, archived or
migrated by IBM Spectrum Protect.
Processing stopped.

System action
User response
File skipped.
None.
0102 E DSM_RC_NO_MEMORY file User response
name(line number)The operating
system refused a IBM Spectrum None.
Protect request for memory 0105 E DSM_RC_PATH_NOT_FOUND The
allocation. specified directory path
'pathname' could not be found.
Explanation
IBM Spectrum Protect requires access to memory in Explanation
order to store information as processing proceeds. In An invalid or unreachable directory path was specified.
this case, more memory was requested than the
operating system would allocate. Possible reasons
System action
include:
Processing stopped.
The system is low on memory.
The process in which the program runs has
exceeded the maximum allocated memory. User response
Some other error condition occurred. No memory is Try the operation again using a valid directory path.
available.
0106 E DSM_RC_ACCESS_DENIED Access
to the specified file or directory is
System action denied
IBM Spectrum Protect cannot complete the requested
operation. Explanation
Access to the specified file or directory is denied. You
User response tried to read from or write to a file and you do not have
Close all unneeded applications and try the operation access permission for either the file or the directory.
again. If the operation still fails, try dividing the task
into several smaller units. For example, if a file System action
specification contains several high-level directories,
run the IBM Spectrum Protect task serially for each Processing stopped.
directory. If the IBM Spectrum Protect task is an
incremental backup, use the option "- User response
memoryefficientbackup=yes". Ensure that you specified the correct file or directory
For UNIX systems that support resource limits, you name, correct the permissions, or specify a new
can check if the memory resource limit is too low by location.
entering the following command: ulimit -a
0106 E DSM_RC_ACCESS_DENIED The
Based on the resulting data, you can ask the UNIX specified file is being used by
system root user to increase the resource limit above another process
the current default limit. The UNIX system root user
has the authority to increase resource limits. Explanation
0104 E DSM_RC_FILE_NOT_FOUND File The specified file is being used by another process.
not found during Backup, Archive You tried to read from or write to a file that is currently
or Migrate processing being used by another process.

Explanation System action

The file being processed for backup, archive or migrate Processing stopped.
no longer exists on the client. Another process deleted

Chapter 3. API return codes 467

User response 0110 E DSM_RC_INVALID_HANDLE An
invalid file handle was passed;
Ensure that you specified the correct file or directory
system error.
name, correct the permissions, or specify a new
location.
Explanation
0107 E DSM_RC_NO_HANDLES No file
handles available An internal system error occurred: A file operation
failed because of an invalid file handle.
Explanation
System action
All file handles for your system are currently in use. No
more are available. processing stops.

System action User response

Processing stopped. 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
User response
IBM Spectrum Protect administrator can help you
Either free some file handles by ending other configure the trace.
processes, or modify your system setup to allow for
0111 E DSM_RC_DISK_FULL Processing
more files to be open at the same time.
stopped; Disk full condition
0108 E DSM_RC_FILE_EXISTS The file
exists and cannot be overwritten. Explanation
No more files can be restored or retrieved because the
Explanation
destination disk is full.
The file being restored or retrieved exists and cannot
be overwritten due to lack of authority or access System action
permissions.
Processing stopped.
System action
User response
The file is skipped.
Free up disk space, or restore or retrieve the file to
another disk.
User response
0113 E DSM_RC_PROTOCOL_VIOLATION
Verify that you have sufficient access permissions to
overwrite the file, then try the operation again. If the Protocol violation
problem persists, contact your system administrator
or IBM Spectrum Protect administrator for further Explanation
assistance. A communications protocol error occurred. The
0109 E DSM_RC_INVALID_PARM Invalid communication subsystem is not properly defined or is
parameter was found. itself in error.

Explanation System action

The system encountered an internal program error due Processing Ends.

to an invalid parameter.
User response
System action Verify that the communication processes are operating
The system returns to the calling procedure. properly, and then retry the operation.
0114 E DSM_RC_UNKNOWN_ERROR An
User response unknown system error has
Ask your service representative to check the error log. occurred from which IBM
Spectrum Protect cannot recover.

468 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation since the destination directory is
full.
An unknown error occurred. This might be a low-level
system or communication error from which IBM
Spectrum Protect cannot recover. Explanation
No more files can be restored or retrieved since the
System action destination directory is full.
Processing stops.
System action
User response Processing stopped.
Try the operation again. If the problem persists, review
the IBM Spectrum Protect error log for any related User response
messages. Obtain a service trace that captures the Free up disk space, or restore or retrieve the file to
problem and contact IBM technical support for another disk.
additional assistance. Your IBM Spectrum Protect
administrator can help you configure the trace. 0118 E DSM_RC_LOOPED_SYM_LINK Too
many symbolic links were
0115 E DSM_RC_UNEXPECTED_ERROR detected while resolving name
An unexpected error occurred.
Explanation
Explanation
While trying to resolve the file name, too many
This is usually caused by a low-level system error or symbolic links were found.
communication error from which IBM Spectrum
Protect cannot recover.
System action

System action File skipped.

Processing stopped.
User response

User response Ensure that you do not have a looping symbolic link for
the file.
Examine the client error log for any additional
messages that might be related to this problem. Try 0119 E DSM_RC_FILE_NAME_TOO_LONG
the operation again. If the problem persists, contact The file name is too long and can
IBM Spectrum Protect technical support for further not be processed by IBM Spectrum
assistance. Protect

0116 E DSM_RC_FILE_BEING_EXECUTED
Explanation
File is in use; Write permission
denied. The size limit for file names may vary by operating
system. The most common limit is 256 characters. The
Explanation file name being processed exceeds the limit supported
by IBM Spectrum Protect on this system.
The current file cannot be opened to write to because
it is currently being run by another operation.
System action

System action The file is skipped.

File skipped.
User response

User response Enter HELP FILE SPEC or see the client manual for the
operating system on which you are receiving this error.
Stop the operation that is running the file and retry the The "File specification syntax" section of the manual
operation, or restore or retrieve the file to a different explains file name lengths supported by IBM Spectrum
name or directory. Protect.
0117 E DSM_RC_DIR_NO_SPACE No more 0120 E DSM_RC_FILE_SPACE_LOCKED
files can be restored or retrieved File system is locked by system

Chapter 3. API return codes 469

Explanation User response
File system cannot be accessed because it is locked by Get authorization from the other node.
the system.
0124 E DSM_RC_FILE_SPACE_NOT_
FOUND File space 'filespace-name'
System action does not exist
The operation cannot be completed.
Explanation
User response The specified file space (domain) is incorrect or does
See your system administrator. not exist on the machine.

0121 I DSM_RC_FINISHED The operation

System action
is finished.
Processing stopped.
Explanation
User response
The operation is finished.
Retry the operation specifying an existing domain
System action (drive letter or file system name).

The system returns to the calling procedure. 0125 E DSM_RC_TXN_ABORTED

Transaction aborted
User response
Explanation
Proceed with next function call.
The current transaction between the server and the
0122 E DSM_RC_UNKNOWN_FORMAT The client stopped. A server, client, or communication
file has an unknown format. failure cannot be recovered.

Explanation System action

The process tried to restore or retrieve a file, but it had Current operation has been cancelled.
an unknown format.
User response
System action
Retry the operation. If the problem continues, see your
The file is skipped. system administrator to isolate the problem.
0126 E DSM_RC_SUBDIR_AS_FILE IBM
User response
Spectrum Protect cannot build a
The file was either backed up by another application, directory path because a file exists
or the data is invalid. If the file belongs to this system, with the same name as
try the operation again. If the problem persists, the directory.
contact IBM technical support for further assistance.
0123 E DSM_RC_NO_AUTHORIZATION Explanation
Not authorized to restore the other None
node's data.
System action
Explanation
Processing stopped.
The client is not authorized to restore the other node's
data.
User response

System action Remove or rename the file that has the same name as
the directory. Alternatively, you can restore the
The system returns to the calling procedure. directory to a different location.

470 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
0127 E DSM_RC_PROCESS_NO_SPACE more memory than your client workstation. You
Disk space limit for this process cannot restore this file. When the file is restored, it is
reached expanded and your workstation does not have enough
memory.
Explanation
System action
The disk space allocated for the client owner is full.
Current operation has been cancelled.
System action
User response
Processing stopped.
Obtain a machine with more memory and retry the
User response operation.

Free up disk space and retry the restore or retrieve 0131 E DSM_RC_COMPRESSED_DATA_
operation. CORRUPTED The compressed file
is corrupted and cannot be
0128 E DSM_RC_PATH_TOO_LONG expanded correctly.
Destination directory path length
exceeds system maximum Explanation

Explanation The compressed file cannot be expanded correctly due

to one of the following reasons:
The path name specified plus the path name in the
restored file name combine to create a name whose There is a problem on the tape.
length exceeds the system maximum. There is a communications problem.
The compressed file was corrupted on the IBM
System action Spectrum Protect Server.

Processing stopped. System action

User response File skipped.

Specify a destination path that, when combined, is less User response

than the system maximum.
1) The compressed file is corrupted because there is a
0129 E DSM_RC_NOT_COMPRESSED File problem on the tape. To know if this is the problem,
is not compressed; System failure. please issue the following command on the IBM
Spectrum Protect Server: audit volume
Explanation <volume_name> fix=no If there is any problem
reported, you could move the data from that volume to
A file that was flagged as compressed was not
a new one (see command MOVE DATA) and try again
compressed, and the system failed.
the restore. 2) There are communications problems
between the IBM Spectrum Protect Server and the
System action IBM Spectrum Protect Client and the results is that the
Processing stopped. 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
User response
suggested changes to some system network options
See your system administrator to report this problem. which have resolved this problem (SUN platform). 3)
This error is a system failure. Please verify with your network support if during the
restore there are no any problems between the IBM
0130 E DSM_RC_TOO_MANY_BITS File
Spectrum Protect Client/Server that is originating the
compressed on a different client
file corruption.
machine that has more memory
0131 S DSM_RC_SYSTEM_ERROR An
Explanation internal program error occurred.
You are trying to restore a file that was backed up and
compressed on another client workstation that had

Chapter 3. API return codes 471

Explanation problem persists, contact IBM technical support for
further assistance.
An unexpected condition was encountered and the
operation can not continue. This might be a 0134 E DSM_RC_NO_LEADING_DIRSEP
programming error. The objName field has no leading
directory separator.
System action
Explanation
processing stops.
The objName field does not have a leading directory
User response separator.

Try the operation again. If the problem persists,

System action
contact your IBM Spectrum Protect administrator or
IBM technical support for further assistance. The system returns to the calling procedure.
0132 E DSM_RC_NO_SERVER_RESOURCE
S The IBM Spectrum Protect User response
server is out of resources. Correct the value for the objName.
0135 E DSM_RC_WILDCARD_DIR
Explanation
Wildcards are not allowed in the
A lack of a storage resource or a maximum value objName directory path.
condition does not allow any new activity.
Explanation
System action
Wildcards are not allowed in the objName directory
Current operation has been cancelled. path.

User response System action

Try the operation again at a later time. If the problem The system returns to the calling procedure.
continues, contact your IBM Spectrum Protect
administrator to isolate what resource is unavailable. User response
The IBM Spectrum Protect administrator can check
the IBM Spectrum Protect server activity log for Correct the value for the objName.
messages that might explain the problem.
0136 E DSM_RC_COMM_PROTOCOL_ERR
0133 E DSM_RC_FS_NOT_KNOWN The OR The session is rejected: There
file space for domain 'domain- was a communications protocol
name' could not be found on the error.
IBM Spectrum Protect server.
Explanation
Explanation An unexpected network message was received by the
The specified file space was expected to be found on client. This could be caused by network problems or a
the server, but it no longer exists. It is possible that a programming error.
command was issued to delete the file space from the
server while the current operation was in progress. System action
The current operation has been cancelled.
System action
IBM Spectrum Protect processing stops. User response
Verify that your communication path is functioning
User response properly and try the operation again. If the problem
Try the operation again. If the problem recurs, check persists, contact your IBM Spectrum Protect
the error log for any other messages that might administrator for further assistance.
indicate a reason for the failure. Try to correct any 0137 E DSM_RC_AUTH_FAILURE Session
indicated problems, then try the operation again. If the
rejected: Authentication failure

472 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
Authentication failure. You entered an incorrect user id Retry the operation. If the problem continues, contact
or password. your system administrator.
0146 S DSM_RC_TOO_SMALL The area for
System action the include/exclude pattern is too
Current operation has been cancelled. small.

User response Explanation

Enter your correct user id and password. If you cannot The area for the include/exclude pattern is too small.
remember the correct user id or password, see your This is a programming failure and the client program
system administrator to have new credentials ends.
assigned for your node name.
System action
0138 E DSM_RC_TA_NOT_VALID The
dsmtca execution/owner Processing stopped.
permissions are invalid.
User response
Explanation
Retry the operation. If the problem continues, contact
The dsmtca execution/owner permissions are invalid. your system administrator.
0147 S DSM_RC_UNCLOSED There is no
System action closing bracket in the pattern.
Processing stopped.
Explanation
User response There is no closing bracket in the pattern. This is a
Have your system administrator check the installation programming failure and the client program ends.
instructions for the client to ensure that the dsmtca
permissions are set correctly. System action
0139 S DSM_RC_KILLED Process killed. Processing stopped.

Explanation User response

Processing stopped. This is a programming failure and Retry the operation. If the problem continues, contact
the client program ends. your system administrator.
0148 S DSM_RC_NO_STARTING_
System action DELIMITER Include/Exclude
Processing stopped. pattern must start with a directory
delimiter
User response
Explanation
Retry the operation. If the problem continues, contact
your system administrator. The include or exclude pattern must start with a
directory delimiter.
0145 S DSM_RC_WOULD_BLOCK The
dsmtca would block the operation.
System action

Explanation Processing stopped.

The dsmtca blocks the operation. This is a

User response
programming failure and the client program ends.
Correct the syntax for the pattern.
System action 0149 S DSM_RC_NEEDED_DIR_
Processing stopped. DELIMITER A beginning or ending

Chapter 3. API return codes 473

 directory delimiter is missing from Explanation
the Include/Exclude pattern.
The size of the file after compression is greater than
the size of the file before compressed.
Explanation
1. The include/exclude pattern has a '...' without a System action
beginning or ending directory delimiter.
Even though the size of the file increased, the file is
2. For Windows, the drive seperator is not compressed.
immediately followed by a directory delimiter.
User response
System action
None.
Processing stopped.
0156 E DSM_RC_INV_COMM_METHOD An
unsupported communications
User response
method was specified.
Correct the syntax for the pattern.
0151 S DSM_RC_BUFFER_OVERFLOW The Explanation
data buffer overflowed. None.

Explanation System action

The data buffer overflowed. This is a programming processing stops.
failure and the client program ends.
User response
System action
Specify a communications interface that is supported
Processing stopped. by the IBM Spectrum Protect client on your operating
system. See the IBM Spectrum Protect client manual
User response for your operating system for further information on
configuring IBM Spectrum Protect client
Retry the operation. If the problem continues, contact communications.
your system administrator.
0157 S DSM_RC_WILL_ABORT The
0154 E DSM_RC_NO_COMPRESS_MEMOR transaction will be aborted.
Y Insufficient memory for file
compression/expansion
Explanation
Explanation The server encountered an error and will abort the
transaction.
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 System action
storage is made available. For a backup or archive, try The transaction will be aborted. The reason code is
running without compression if storage cannot be passed on the dsmEndTxn call.
made available.
User response
System action
Issue the dsmEndTxn with a vote of
Processing stopped. DSM_VOTE_COMMIT and examine the reason code.
0158 E DSM_RC_FS_WRITE_LOCKED
User response
Destination file or directory is
Free up extra storage for the operation to continue, or write locked
run the backup or archive process without
compression enabled. Explanation
0155 T DSM_RC_COMPRESS_GREW The file or directory being restored or retrieved from
Compressed Data Grew the server cannot be written to because the

474 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
destination is write locked. Another operation might User response
have the file open and will not allow it to be updated.
Ensure that the drive is available , and then retry the
operation.
System action
0164 E DSM_RC_FIO_ERROR File input/
File skipped. output error

User response Explanation

Either determine which operation has the file write An error was found while reading from or writing to the
locked, or restore the file to another name or location. file.
0159 I DSM_RC_SKIPPED_BY_USER A
file was skipped during a restore System action
operation because the file is off
File or file system is skipped.
line and the application has
chosen not to wait for a tape
mount. User response
Check your system to ensure that it is operating
Explanation properly. For OS/2, run CHKDSK /F for the failing drive
which can be found in dsmerror.log.
A file was skipped during a restore operation because
the file is off line and the application has chosen not to 0165 E DSM_RC_WRITE_FAILURE File
wait for a tape mount. write error

System action Explanation

File skipped. An error was found while writing to the file.

User response System action

Verify the application sets the mountWait value File skipped.
correctly on dsmBeginGetData.
0160 E DSM_RC_TA_NOT_FOUND Unable User response
to find the dsmtca module. Check your system to ensure that it is operating
properly.
Explanation
0166 E DSM_RC_OVER_FILE_SIZE_ LIMIT
IBM Spectrum Protect was unable to find the dsmtca File exceeds system/user file
module in the specified directory. limits

System action Explanation

Processing ends. A file being restored or retrieved exceeds system set
limits for this user.
User response
System action
Make sure the dsmtca module is in the directory
specified by DSMI_DIR. File skipped.
0162 E DSM_RC_FS_NOT_READY File
system/drive not ready User response
Ensure that the system limits are set properly.
Explanation
0167 E DSM_RC_CANNOT_MAKE Cannot
The file system/drive was not ready for access. make file/directory

System action
Processing stopped.

Chapter 3. API return codes 475

Explanation Explanation
The directory path for files being restored or retrieved This process requires keyboard input, but non-
cannot be created. interactive processes are unable to read input from
keyboard.
System action
System action
File skipped.
processing stops.
User response
User response
Ensure that you have the proper authorization to
create the directory for file being restored or retrieved. Perform the following actions to resolve this error:
Make sure that you have write access.
• Run the product in interactive mode.
0168 E DSM_RC_NO_PASS_FILE • Ensure your password is set correctly.
Password file is not available.
0174 E DSM_RC_REJECT_PLATFORM_
MISMATCH Session rejected: Node
Explanation
type mismatch
The file containing the stored password for the
specified server-name is unavailable. Explanation
Your node name is associated with a different type of
System action
operating system and cannot be used on this system.
Processing ends.
System action
User response
Current operation has been cancelled.
The root user must set and store a new password.
0169 E DSM_RC_VERFILE_OLD User response
PASSWORDACCESS is GENERATE, If you need a new node name, see your system
but password needed for server administrator to assign a new one to you. Generally,
'server-name'. you have a unique node name for each machine and
Either the password is not stored operating system pair that requires access to the
locally, or it was changed at the server.
server.
0175 E DSM_RC_TL_NOT_FILE_OWNER
Explanation Not file owner

Either the password is not stored locally, or it was Explanation

changed at the server.
The file cannot be backed up because the client is not
the file owner.
System action
IBM Spectrum Protect prompts you for the password if System action
IBM Spectrum Protect is running in the foreground.
The file is skipped.
User response
User response
If IBM Spectrum Protect was running as a background
process, issue any IBM Spectrum Protect command None.
from the foreground. Enter the password in answer to 0177 S DSM_RC_UNMATCHED_QUOTE
the prompt. Then try your background IBM Spectrum
Quotes are not matched
Protect command again.
0173 E DSM_RC_INPUT_ERROR The Explanation
process is running in a non-
The quotes specified in the pattern are not the same
interactive mode, but requires
and do not make a set.
user input.

476 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
Processing stopped. The management class for this file does not have an
archive copy group specified. This file will not be
User response archived.

Correct the pattern by using matching quotes in the

System action
syntax.
Processing stopped.
0184 E DSM_RC_TL_NOBCG The
management class for this file
does not have a valid backup copy User response
group. Add a valid archive copy group to the management
This file will not be backed up. class, and then retry the operation.
0187 E DSM_RC_PS_INVALID_ARCHMC
Explanation
Invalid management class entered
The management class for this file does not have a
backup copy group specified. This file will not be Explanation
backed up.
You entered an invalid management class.
System action
System action
Processing stopped.
Requested operation is not possible.
User response
User response
Add a valid backup copy group to the management
class, and then retry the operation. Retry the operation using a valid management class.

0185 W DSM_RC_TL_EXCLUDED File 'file- 0188 S DSM_RC_NO_PS_DATA Either the

namefile-namefile-name' excluded node does not exist on the server
by Include/Exclude list or there is no active policy set for
the node.
Explanation
Explanation
You can not back up, archive, or migrate files that are
excluded. This error occurs when you try to access another
node's data. Either the node is not registered with the
IBM Spectrum Protect server, or there is no active
System action
policy set for the node.
The file can not be processed.
System action
User response
Processing stops.
If the file is intentionally excluded, then this message
can be ignored. Otherwise modify the include/exclude User response
list, restart the client, and try the operation again.
Contact your IBM Spectrum Protect administrator for Verify that the node whose data you are trying to
further assistance. access is registered with the IBM Spectrum Protect
server. If you have more than one IBM Spectrum
0186 E DSM_RC_TL_NOACG The Protect server, make sure you are connecting to the
management class for this file correct server, then try the operation again. If the
does not have a valid archive copy problem persists, contact your IBM Spectrum Protect
group. administrator for further assistance.
This file will not be archived.
0189 S DSM_RC_PS_INVALID_DIRMC The
management class assigned to
directories does not exist.

Chapter 3. API return codes 477

Explanation User response
The management class named on the DIRMC option Contact your system administrator for more
does not exist in your assigned policy set on the information.
server. The error log contains an entry showing the
0232 E DSM_RC_ABORT_ITEM_IN_USE
invalid management class name.
An Operation for the requested
node and file space is already in
System action progress.
processing stops.
Explanation
User response A request has been made to use a data mover to
Remove the current DIRMC option from the client perform an operation for the indicated node and file
options file, then run DSMC QUERY MGMTCLASS - space. Since an operation for this node and file space
DETAIL to view information about available is already in progress, the new operation cannot be
management classes. Make sure the management performed.
class you select has a backup copy group. If you have
more than one IBM Spectrum Protect server, make System action
sure you are connecting to the correct server. If you
Current operation has ended.
are unable to find a suitable management class,
contact your IBM Spectrum Protect administrator for
further assistance. User response

0190 S DSM_RC_PS_NO_CG_IN_DIR_MC Retry the operation at a later time.

There is no backup copy group in 0233 E DSM_RC_ABORT_LOCK_CONFLICT
the management class used for System resource in use
directories.
Explanation
Explanation
A required resource is in use by another command or
The DIRMC option names a management class that process.
contains no backup copy group.
System action
System action
Current operation has ended.
processing stops.
User response
User response
Retry the operation at a later time.
Remove the current DIRMC option from the client
options file, then run DSMC QUERY MGMTCLASS - 0234 E DSM_RC_ABORT_SRV_PLUGIN_
DETAIL to view information about available COMM_ERROR Server plugin
management classes. Make sure the management communication error
class you select has a backup copy group. If you have
more than one IBM Spectrum Protect server, make Explanation
sure you are connecting to the correct server. If you
are unable to find a suitable management class, Communication between a server plugin module and a
contact your IBM Spectrum Protect administrator for NAS filer failed.
further assistance.
System action
0231 E DSM_RC_ABORT_MOVER_TYPE
Unknown Remote Mover type Current operation has ended.

Explanation User response

The specified Remote Mover type is unknown. Contact your system administrator for more
information.
System action 0235 E DSM_RC_ABORT_SRV_PLUGIN_
Current operation has ended. OS_ERROR Server plugin detected

478 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
 unsupported NAS filer operating Explanation
system.
An operation was attempted on a remote disk that is
not defined.
Explanation
A plugin module detected that a NAS filer is running an System action
unsupported operating system or operating system
The current operation stops.
level.

User response
System action
Define the proper remote disk.
Current operation has ended.
0239E DSM_RC_ABORT_BAD_
User response DESTINATION Input destination
does not match expected
Contact your system administrator for more destination.
information.
0236E DSM_RC_ABORT_CRC_FAILED The Explanation
CRC received from the Server does
Input destination does not match expected
not match the CRC calculated by
destination.
the client.

System action
Explanation
The current operation stops.
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 User response
failure. Retry operation with proper destination.
0240E DSM_RC_ABORT_DATAMOVER_
System action
NOT_AVAILABLE Data mover is
In some cases, the client can indicate the failure to the not available.
server and retry the operation.
Explanation
User response
Data mover is not available.
Check the trace log for additional information and retry
the operation. If the problem persists, contact your System action
system administrator.
The current operation stops.
0237E DSM_RC_ABORT_INVALID_
GROUP_ACTION An invalid
User response
operation was attempted on a
group leader or group member. Retry operation with a proper Data mover.
0241E DSM_RC_ABORT_STGPOOL_COPY
Explanation _ CONT_NO Operation failed
An invalid operation was attempted on a logical group. because the copy continue option
was set to NO.
System action
Explanation
The current operation stops.
Operation failed because the copy continue option was
set to NO.
User response
Retry a valid operation. System action
0238E DSM_RC_ABORT_DISK_ The current operation stops.
UNDEFINED Remote disk not
defined.

Chapter 3. API return codes 479

User response Explanation
This abort code indicates that a store operation, like This server only supports archive operations, backup is
backup or archive failed because the copy continue not allowed.
option was set to NO. The sysadmin will need to
resolve the problem on the server end. System action
0242E DSM_RC_ABORT_RETRY_SINGLE_ The current operation ends.
TXN Transaction failed because of
a problem during a store User response
operation.
Use only archive operations with this server.
Explanation 0248 E DSM_RC_ABORT_DELETE_NOT_
Transaction failed because of a problem during a store ALLOWED Deleting this object:
operation. This error is typical when the next storage "fshlll" is not allowed.
pool has a different copy storage pool list and we
switch to this pool in the middle of a transaction. Explanation
The object is either under a hold and cannot be
System action deleted, or it is on a retention-protection enabled
Transaction is aborted. server and has not expired.

User response System action

Resend objects in separate transactions. The object is skipped and processing continues.

0245 E DSM_RC_ABORT_PATH_ User response

RESTRICTED The current client
configuration does not comply Check the status of the object through a query to see if
with the value of the it is held, or when it expires.
DATAWRITEPATH or
0249 E DSM_RC_ABORT_TXN_LIMIT_
DATAREADPATH server option for
EXCEEDED The number of objects
this node.
in this transaction exceed
TXNGROUPMAX values.
Explanation
The values of the DATAWRITEPATH and Explanation
DATAREADPATH server options specify where the
There are too many objects in this transaction.
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, System action
you will get this error message if DATAWRITEPATH The current operation ends.
contains a LAN value and the client is configured to
use LAN-free protocol, or vice versa.
User response

System action Try the operation again with fewer objects in the
transaction, or increase the TXNGROUPMAX value on
Processing stopped. the server.
0250 E DSM_RC_ABORT_OBJECT_
User response
ALREADY_HELD fshlll is already
Check the client, server, and storage agent logs to under hold.
determine why the client was not able to send data
LAN-free. Make sure the client configuration and Explanation
server options are compatible.
One of the objects in the transaction The specified
0247 E DSM_RC_ABORT_INSERT_NOT_ object is already under hold, and it cannot be placed
ALLOWED This server does not under a new hold.
support backup operations.

480 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action (for example, open registration, file space delete or
password update).
The current operation ends. This object is skipped and
processing continues.
System action
User response Processing ends.
Issue a query to see the status of the objects, and try
the operation again, without the object that is already User response
held. If the activity is required, the administrator for this
0292 E DSM_RC_TCA_FORK_FAILED Error system must perform it.
starting the dsmtca or dsmenc 0297 E DSM_RC_TCA_SEMGET_ERROR
process. Error allocating semaphores.

Explanation Explanation
An error has occurred starting the dsmtca or dsmenc An error has occurred because the semaphores you
process; specifically, the fork() function has failed. are attempting to allocate have become insufficient.

System action System action

Processing ends. Processing ends.

User response User response

Probable system error. If the problem persists, restart Ask your system administrator for assistance, and
the workstation. possibly increase the number of semaphores in your
0295 E DSM_RC_TCA_INVALID_REQUEST system.
The IBM Spectrum Protect dsmtca 0298 E DSM_RC_TCA_SEM_OP_ERROR
received an invalid request. Error setting semaphore value or
waiting on semaphore.
Explanation
The dsmtca or dsmenc process was invoked by the Explanation
backup-archive client and received an unknown An error has occurred while attempting to set or wait
request argument in the call. on a semaphore.

System action System action

Processing ends. Processing ends.

User response User response

It is possible that the dsmtca or dsmenc process was Probable system error. If the problem persists, restart
mistakenly invoked by a process other than the the workstation.
backup-archive client. If that is not the case, then this
is an internal error. If the problem recurs, contact your 0400 E DSM_RC_INVALID_OPT An invalid
IBM service representative. option was found during option
parsing.
0296 E DSM_RC_TCA_NOT_ROOT This
action requires IBM Spectrum
Explanation
Protect administrative authority
on this system. An invalid option was found.

Explanation System action

An activity has been attempted that must be The system returns to the calling procedure.
performed by the IBM Spectrum Protect administrator

Chapter 3. API return codes 481

User response User response
Verify the options in dsm.opt, dsm.sys, and the options Make sure that the options file you want to use exists,
string. Check the error log for more details about the it has the read rights set for the user that is running the
error. on the AS/400 platform, verify the options in operation, and it is in the standard file encoding of the
*LIB/QOPTIBM Spectrum Protect(APIOPT). system. For example, on Windows the expected file
encoding is ANSI. Review the configuration
0405 E DSM_RC_NO_HOST_ADDR information in the IBM Spectrum Protect client manual
TCPSERVERADDRESS not defined specific to your operating system. If the problem
for this server in the System persists, ask your IBM Spectrum Protect administrator
Options File for further assistance.

Explanation 0408 E DSM_RC_MACHINE_SAME A

virtual node name must not equal
The TCPSERVERADDRESS for this server is not defined either a node name or the system
in the server name stanza in the system options file. host name.

System action Explanation

IBM Spectrum Protect initialization fails and the A VIRTUALNODENAME option was entered with a
program ends. name the same as either a NODENAME option or the
system host name.
User response
See the IBM Spectrum Protect administrator for your System action
system, and make sure that the server to which you Initialization fails and the program ends.
are trying to connect, has a valid TCPSERVERADDRESS
defined in the system options file.
User response
0406 S DSM_RC_NO_OPT_FILE Options If the virtual node name entered was the same as the
file 'file-name' could not be found, host name, remove the virtual node name option. If it
or it cannot be read. was the same as the node name option, you can
remove either one, depending upon the intended
Explanation usage. Node name is used to assign an alternate name
Common reasons for this error include: to your system. Virtual node name is used to access
another system's server data.
• The default options file does not exist.
0409 E DSM_RC_INVALID_SERVER Server
• You specified the -OPTFILE option when starting the
name not found in System Options
IBM Spectrum Protect client, but the options file you
File
provided does not exist.
• The DSM_CONFIG (or DSMI_CONFIG if you are using Explanation
the IBM Spectrum Protect API) environment variable
specifies an options file that does not exist. The system options file does not contain the
SERVERNAME option.
• You specified the -OPTFILE option when starting the
IBM Spectrum Protect client, but the options file that
you provided is not in the standard file encoding of System action
the system. For example, on Windows the expected IBM Spectrum Protect initialization fails and the
file encoding is ANSI. program ends.
• You specified the -OPTFILE option when starting the
IBM Spectrum Protect client, but the options file that User response
you provided does not have appropriate read
permissions for the user that is running the See the IBM Spectrum Protect administrator for your
operation. system, and make sure that the system options file
contains the server name.
System action 0410 E DSM_RC_INVALID_KEYWORD An
invalid option keyword was found
IBM Spectrum Protect client processing stops.
during option parsing.

482 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation that the current user does not have permission to write
to the tracefile in the directory specified. It is also
An invalid option keyword was found in the dsmInit
possible that no space is available at the tracefile
configuration file, the option string, dsm.sys, or
location.
dsm.opt.

System action
System action
Processing stops.
The system returns to the calling procedure.

User response
User response
Make sure the tracefile option points to a valid path
Correct the spelling of the option keywords. Verify that
and that the user has proper permissions to write to
the dsmInit configuration file only has a subset of the
the specified file.
dsm.sys options. Check the error log for more details
about the error. 0427 E DSM_RC_CANNOT_OPEN_LOGFILE
Initialization functions cannot
0411 S DSM_RC_PATTERN_TOO_COMPLE
open the error log file specified.
X The include or exclude pattern
cannot be parsed.
Explanation
Explanation The error log file could not be opened during
initialization. The specified path may be incorrect. It is
The pattern is formatted incorrectly or is too complex
also possible that the current user does not have
to be interpreted.
permission to write to the logfile in the directory
specified. It is also possible that no space is available
System action at the given logfile location.
Processing stopped.
System action
User response Processing terminates.
Verify that the include or exclude pattern is specified
correctly. If the pattern is correct, then contact IBM User response
technical support for further assistance.
Make sure the logfile option points to a valid path and
0412 S DSM_RC_NO_CLOSING_BRACKET that the user has proper permissions to write to the
Include/Exclude pattern is file specified.
missing a closing bracket
0600 E DSM_RC_DUP_LABEL A duplicate
volume label exists. The operation
Explanation cannot continue.
The include or exclude pattern is incorrectly
constructed. The closing bracket is missing. Explanation
For removable media, IBM Spectrum Protect uses the
System action volume label as the file space name. To prevent data
Processing stopped. from different volumes being stored in the same file
space on the IBM Spectrum Protect server, backup or
archive of removable media volumes having duplicate
User response
volume labels is not allowed.
Correct the syntax for the pattern.
0426 E DSM_RC_CANNOT_OPEN_ System action
TRACEFILE Initialization functions The requested operation does not run.
cannot open the trace file
specified. User response

Explanation Change the volume labels on the removable media

volumes so that there are no duplicate labels. Then
The file could not be opened during initialization. The
specified path might be incorrect. It is also possible

Chapter 3. API return codes 483

restart IBM Spectrum Protect and try the operation 0612 E DSM_RC_NLS_INVALID_CNTL_
again. REC Unable to use message text
file.
0601 E DSM_RC_NO_LABEL The drive has
no label. The operation cannot
continue. Explanation
The system is unable to use the message txt file
Explanation (dscenu.txt or dsmclientV3.cat for AIX) because of an
invalid control record. On the AS/400 platform this file
Backup or archive of removable media requires that
is QANSAPI/QAANSENU(TXT).
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 system returns to the calling procedure.
System action
The requested operation does not run. User response
Install the message text file again.
User response
0613 E DSM_RC_NLS_INVALID_DATE_
Create a volume label on the removable media, then FMT Invalid value for
try the operation again. DATEFORMAT specified.
0610 E DSM_RC_NLS_CANT_OPEN_TXT
Unable to open message text file. Explanation
An invalid value is specified for DATEFORMAT.
Explanation
The system is unable to open the message txt file System action
(dscenu.txt or dsmclientV3.cat for AIX). On the The system returns to the calling procedure.
AS/400 platform this file is QANSAPI/
QAANSENU(TXT).
User response

System action Specify a valid value.

The system returns to the calling procedure. 0614 E DSM_RC_NLS_INVALID_TIME_

FMT Invalid value for
User response TIMEFORMAT specified.

Verify that the dscenu.txt file is in the directory pointed Explanation

to by DSMI_DIR. For AIX, verify that the
dsmclientV3.cat file has a symbolic link An invalid value is specified for TIMEFORMAT.
to /usr/lib/nls/msg/<locale>/dsmclientV3.cat .
System action
0611 E DSM_RC_NLS_CANT_READ_HDR
Unable to use message text file. The system returns to the calling procedure.

Explanation User response

The system is unable to use the message text file Specify a valid value.
(dscenu.txt or dsmclientV3.cat for AIX) because of an
0615 E DSM_RC_NLS_INVALID_NUM_FM
invalid header. On the AS/400 platform this file is
QANSAPI/QAANSENU(TXT). T Invalid value for
NUMBERFORMAT specified.
System action
Explanation
The system returns to the calling procedure.
An invalid value is specified for NUMBERFORMAT.

User response
Install the message text file again.

484 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action 0927 E DSM_RC_NOT_ADSM_AUTHORIZE
D Only a IBM Spectrum Protect
The system returns to the calling procedure.
authorized user can perform this
Action.
User response
Specify a valid value. Explanation
0620 E DSM_RC_LOG_CANT_BE_OPENED User must be a IBM Spectrum Protect authorized user
Unable to open error log file. to perform this action. User is not password authorized
and this action requires authorization.
Explanation
System action
The system is unable to open the error log file.
Processing stopped.
System action
User response
The system returns to the calling procedure.
User must be root user, or user must be the owner of
User response the executable and the set effective user id bit is set to
'on' ('s' bit).
Verify the DSMI_LOG value and access permission. On
the AS/400 platform, verify the value specified for 961 E DSM_RC_DIRECT_STORAGE_
ERRORLOGNAME in the API options file. AGENT_UNSUPPORTED Direct
connection to the Storage Agent is
0621 E DSM_RC_LOG_ERROR_WRITING_ not allowed.
TO_LOG The log file cannot be
written to.
Explanation

Explanation You cannot connect directly to the Storage Agent.

There was an error writing to the log file.

System action

System action Processing stopped.

The system returns to the calling procedure.

User response

User response To perform Lanfree operations using the Storage

Agent, specify the ENABLELANFREE option in your
Verify the DSMI_LOG value and access permission. on options file, and restart the process.
the AS/400 platform, verify the value specified for
ERRORLOGNAME in the API options file. 963 E DSM_RC_FS_NAMESPACE_
DOWNLEVEL The long namespace
0622 E DSM_RC_LOG_NOT_SPECIFIED has been removed from the local
The log file name was not file space. If you wish to proceed
specified. with the backup/archive
operation, rename your file space
Explanation on the server.
The system is unable to open the error log file.
Explanation
System action The process has detected that the server namespace
is NTW:LONG, but the local volume does not have long
The system returns to the calling procedure.
name support. If you would like to back up the volume
using the short names, rename the file space on the
User response server. If you would like to back up using long names,
Verify the DSMI_LOG value and access permission. On add the long namespace support back to the volume in
the AS/400 platform, verify the value specified for question.
ERRORLOGNAME in the API options file.

Chapter 3. API return codes 485

System action Explanation
Processing stopped. The function being used requires a more current IBM
Spectrum Protect Server and IBM Spectrum Protect
User response Storage agent

Add the long namespace support to the volume or

System action
rename(remove) the corresponding server file space.
The operation fails.
0996 E DSM_RC_SERVER_DOWNLEVEL_
FUNC The IBM Spectrum Protect
server is downlevel and does not User response
support the requested function. Upgrade your IBM Spectrum Protect Server and IBM
See error log for version Spectrum Protect Storage agent to a level that
information. supports this function. See error log for version
information.
Explanation
1376 E DSM_RC_DIGEST_VALIDATION_
The function being used requires a more current IBM ERROR Error processing 'filespace
Spectrum Protect Server. name path-namefile-name'; end-
to-end digest validation failed.
System action
Explanation
The operation fails.
Cryptographic digest of the restored or retrieved data
User response did not match the digest generated during the backup
or archive operation. Possible causes are a
Upgrade your IBM Spectrum Protect Server to a level transmission error, data corruption, or a hash collision.
that supports this function. See error log for version
information.
System action
0997 E DSM_RC_STORAGEAGENT_ Processing stops
DOWNLEVEL The IBM Spectrum
Protect Storage Agent is
downlevel and does not support User response
the requested function. See error Try the restore operation again. If the problem
log for version information. persists, contact IBM technical support for additional
assistance.
Explanation
2000 E DSM_RC_NULL_OBJNAME The
The function being used requires a more current IBM object name pointer is NULL.
Spectrum Protect Storage Agent.
Explanation
System action
There is no value provided for the object name pointer.
The operation fails.
System action
User response
The system returns to the calling procedure.
Upgrade your IBM Spectrum Protect Storage Agent to
a level that supports this function. See error log for User response
version information.
Provide an address for the dsmObjName structure.
0998 E DSM_RC_SERVER_AND_SA_
DOWNLEVEL The IBM Spectrum 2001 E DSM_RC_NULL_DATABLKPTR The
Protect Server and IBM Spectrum data block pointer is NULL.
Protect Storage agent are
downlevel and do not support the Explanation
requested function. See error log
There is no value provided for the data block pointer.
for version information.

486 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action Explanation
The system returns to the calling procedure. The server did not respond with the policy information.

User response System action

Provide an address for the DataBlk structure. The system returns to the calling procedure.
2002 E DSM_RC_NULL_MSG msg
parameter for dsmRCMsg is a User response
NULL pointer. Verify the server policy definitions.
2008 E DSM_RC_ZERO_BUFLEN The
Explanation
dataBlk bufferLen value is zero.
The message parameter for dsmRCMsg is a NULL
pointer. Explanation
The value for the dataBlk bufferLen is zero.
System action
The system returns to the calling procedure. System action
The system returns to the calling procedure.
User response
Allocate enough space for the message parameter. User response
2004 E DSM_RC_NULL_OBJATTRPTR The Provide a non-zero value for the bufferLen.
object attribute pointer is NULL.
2009 E DSM_RC_NULL_BUFPTR The
dataBlk bufferPtr is NULL.
Explanation
There is no value provided for the object attribute Explanation
pointer.
There is no value provided for the dataBlk bufferPtr.
System action
System action
The system returns to the calling procedure.
The system returns to the calling procedure.
User response
User response
Provide an address for the ObjAttr structure.
Provide an address for the bufferPtr.
2006 E DSM_RC_NO_SESS_BLK There is
no server session information. 2010 E DSM_RC_INVALID_OBJTYPE The
objType is invalid.
Explanation
Explanation
The server did not respond with the session
information. The value for the objType is invalid.

System action System action

The system returns to the calling procedure. The system returns to the calling procedure.

User response User response

Verify the server status. The value for dsmObjName.objType must be:

2007 E DSM_RC_NO_POLICY_BLK There DSM_OBJ_FILE or DSM_OBJ_DIRECTORY for

is no server policy information. Backup, or
DSM_OBJ_FILE for Archive.
2011 E DSM_RC_INVALID_VOTE The
dsmEndTxn vote is invalid.

Chapter 3. API return codes 487

Explanation User response
The dsmEndTxn vote is invalid. For dsmDeleteFS the repository must be one of the
following:
System action • DSM_ARCHIVE_REP
The system returns to the calling procedure. • DSM_BACKUP_REP
• DSM_REPOS_ALL.
User response
2016 E DSM_RC_INVALID_FSNAME
The vote must be DSM_VOTE_COMMIT or Filespace name should start with
DSM_VOTE_ABORT. the directory delimiter.
2012 E DSM_RC_INVALID_ACTION The
update action is invalid. Explanation
The filespace name is invalid.
Explanation
The dsmUpdateFS or dsmUpdateObj action is invalid. System action
The system returns to the calling procedure.
System action
The system returns to the calling procedure. User response
Filespace name should start with the directory
User response delimiter.
Correct the action value. Valid values are defined in 2017 E DSM_RC_INVALID_OBJNAME The
dsmapitd.h and documented in our Using the API object name is either an empty
book. string or has no leading delimiter.
2014 E DSM_RC_INVALID_DS_HANDLE
There was an error in the IBM Explanation
Spectrum Protect API internals. The object name is invalid because of an empty string
or there is no leading delimiter.
Explanation
The system encountered an error in the API internals. System action
The system returns to the calling procedure.
System action
The system returns to the calling procedure. User response
Verify the format of the dsmObjName full path.
User response
2018 E DSM_RC_INVALID_LLNAME Low
Shut down the process and retry the operation. Verify level qualifier of the object name
that any previous dsmInit calls were cleaned up and should start with the directory
terminated by a dsmTerminate call. If the problem delimiter.
continues, contact your system administrator or
service representative.
Explanation
2015 E DSM_RC_INVALID_REPOS The The low level qualifier for the object name is invalid.
repository type is invalid.
System action
Explanation
The system returns to the calling procedure.
The repository type is invalid.

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

488 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
2019 E DSM_RC_INVALID_OBJOWNER User response
The object owner is invalid. The sendType must be one of the following:

Explanation stBackup
stArchive
The object owner must be either the root user, or the stBackupMountWait
object owner must be the same as the session owner.
stArchiveMountWait

System action 2023 E DSM_RC_INVALID_PARAMETER

The dsmDeleteObj delType is
The system returns to the calling procedure. invalid.

User response Explanation

Verify the session owner and object owner. The dsmDeleteObj delType is invalid.
2020 E DSM_RC_INVALID_ACTYPE The
dsmBindMC sendType is invalid. System action
The system returns to the calling procedure.
Explanation
The dsmBindMC sendType is invalid. User response
The delType must be dtBackup or dtArchive.
System action
2024 E DSM_RC_INVALID_OBJSTATE The
The system returns to the calling procedure. query Backup objState is invalid.

User response Explanation

The sendType must be one of the following: The query Backup objState is invalid.
stBackup
stArchive System action
stBackupMountWait The system returns to the calling procedure.
stArchiveMountWait
2021 E DSM_RC_INVALID_RETCODE no User response
text available for this return code. The qryBackupData.objState must be one of the
following:
Explanation
DSM_ACTIVE
The dsmRC parameter for dsmRCMsg is an DSM_INACTIVE
unsupported return code. DSM_ANY_MATCH

System action 2025 E DSM_RC_INVALID_MCNAME The

management class name was not
The system returns to the calling procedure. found.

User response Explanation

Specify a valid value. A query or send operation is unable to find the
2022 E DSM_RC_INVALID_SENDTYPE The management class name.
dsmSendObj sendType is invalid.
System action
Explanation The system returns to the calling procedure.
The dsmSendObj sendType is invalid.
User response
System action Verify the management class name.
The system returns to the calling procedure.

Chapter 3. API return codes 489

2026 E DSM_RC_INVALID_DRIVE_CHAR Explanation
The drive letter is not an The number of objects (numObjId) specified on the
alphabetic character. dsmBeginGetData call exceeds DSM_MAX_GET_OBJ |
DSM_MAX_PARTIAL_GET_OBJ.
Explanation
The drive letter is not an alphabetic character. This System action
return code is valid on Microsoft Windows only. The system returns to the calling procedure.

System action User response

The system returns to the calling procedure. Check the number of objects before calling
dsmBeginGetData. If it is greater than
User response DSM_MAX_GET_OBJ | DSM_MAX_PARTIAL_GET_OBJ,
Verify that the drive designation is an alphabetic then issue multiple Get call sequences.
character. The referenced field is 2030 E DSM_RC_NEWPW_REQD The new
dsmDosFSAttrib.driveLetter. password value is NULL or blank.
2027 E DSM_RC_NULL_FSNAME The
Register Filespace name is NULL. Explanation
There is no value provided for new password.
Explanation
There is no value provided for the Register Filespace System action
name. The system returns to the calling procedure.

System action User response

The system returns to the calling procedure. Provide a new password on dsmChangePW.

User response 2031 E DSM_RC_OLDPW_REQD The old

password value is NULL or blank.
Provide a filespace name on dsmRegisterFS.
2028 E DSM_RC_INVALID_HLNAME High Explanation
level qualifier of the object name There is no value provided for old password.
should start with the directory
delimiter.
System action
Explanation The system returns to the calling procedure.
The high level qualifier for the object name is invalid.
User response
System action Provide an old password on dsmChangePW.
The system returns to the calling procedure. 2032 E DSM_RC_NO_OWNER_REQD On
dsmInit, the owner is not allowed
User response to establish a session when
PASSWORDACCESS=generate.
High level qualifier of the object name should start
with the directory delimiter.
Explanation
2029 E DSM_RC_NUMOBJ_EXCEED The PASSWORDACCESS=GENERATE establishes a session
number of objects on with the current login user as the owner. The
dsmBeginGetData exceeds application should set clientOwnerNameP to NULL
DSM_MAX_GET_OBJ | when PASSWORDACCESS=GENERATE is in effect.
DSM_MAX_PARTIAL_GET_OBJ.

490 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
System action System action
The system returns to the calling procedure. Whether The system returns to the calling procedure.
the application can continue processing depends on
how the application handles the error. User response
Ensure that you have ordered the Data Protection for
User response
Oracle, and install the key file.
This message applies to applications that utilize the
2041 E DSM_RC_BAD_CALL_SEQUENCE
IBM Spectrum Protect API, and is intended primarily
The sequence of calls is invalid.
for the vendor of the application for which the
message is issued. Depending on the application, this
could be a configuration issue. Explanation

Consult the documentation for the application and Then API requires function calls to be made in a
verify that the application is configured correctly. If the specific sequence. The function calls were not made in
problem persists, contact the application vendor for the expected sequence. The error can be triggered by
further assistance. the following issues:

2033 E DSM_RC_NO_NODE_REQD On • An error in the network.

dsmInit, the node is not allowed • A bug in the IBM Spectrum Protect API.
when • A bug in the IBM Spectrum Protect server.
PASSWORDACCESS=generate.
• A bug in the application (IBM or third party) that uses
the IBM Spectrum Protect API.
Explanation
PASSWORDACCESS=generate establishes a session System action
with the current hostname as the node.
The system returns to the calling procedure.
System action
User response
The system returns to the calling procedure.
An end user can respond in the following ways:
User response • Check the network for errors.
When using PASSWORDACCESS=generate, set • Look for clues in the IBM Spectrum Protect server
clientNodeNameP to NULL. activity log file, client side dsierror.log log file, and
log files that are specific to the problem application.
2034 E DSM_RC_KEY_MISSING The key
• Search the IBM support pages for APARs that match
file is missing.
the problem. The support site is at IBM Spectrum
Protect Support Portal (https://www.ibm.com/
Explanation mysupport/s/topic/0TO50000000IQWvGAO/
The key file for Data Protection for Oracle cannot be spectrum-protect)
found. • If the API application is developed by a third party
(not IBM), search that third party's support pages for
System action known issues that match the problem.
The system returns to the calling procedure. If none of the above actions resolve the problem,
report the problem to the vendor of the application
User response that uses the IBM Spectrum Protect API.

Ensure that you have ordered the Data Protection for A developer of an application that uses the IBM
Oracle, and install the key file. Spectrum Protect API must investigate the reason for
the problem, including reviewing the IBM Spectrum
2035 E DSM_RC_KEY_BAD The key file Protect API state diagram. The IBM Spectrum Protect
content is invalid. API state diagram is in the product documentation at
IBM Spectrum Protect product documentation
Explanation (https://www.ibm.com/support/knowledgecenter/
SSEQVQ_8.1.9/tsm/welcome.html)
The key file content for Data Protection for Oracle is
invalid.

Chapter 3. API return codes 491

2042 E DSM_RC_INVALID_TSMBUFFER Explanation
The tsmBuffHandle is invalid, or An internal API buffer array error occurred.
the value of dataPtr is invalid.

System action
Explanation
The system returns to the calling procedure.
An invalid value for a handle or dataPtr has been
passed into the API.
User response
System action Try the operation again. If the problem continues,
contact your system administrator or service
The system returns to the calling procedure. representative.

User response 2046 E DSM_RC_INVALID_DATABLK

When using useTsmBuffers,
There is a problem with the calling application. Verify dataBlk must be NULL in calls to
the values of the tsmBuffHandle and dataptr passed to dsmSendObj and dsmGetObj.
the API.
2043 E DSM_RC_TOO_MANY_BYTES The Explanation
number of bytes copied into the The value for dataBlk must be NULL when using
tsmBuffer is larger than the useTsmBuffers.
allowed value.
System action
Explanation
The system returns to the calling procedure.
An invalid number of bytes was copied to a tsmBuffer.
User response
System action
There is a problem with the calling application.
The system returns to the calling procedure. Contact your application provider

User response 2047 E DSM_RC_ENCR_NOT_ALLOWED

Encryption is not allowed when
There is a problem with the calling application. Verify using useTsmBuffers.
the number of bytes copied into the tsmBuffer.
2044 E DSM_RC_MUST_RELEASE_BUFFE Explanation
R dsmTerminate cannot finish useTsmBuffers does not support encryption.
because the application is holding
on to 1 or more tsmBuffers.
System action
Explanation The system returns to the calling procedure.
An application is trying to terminate a session, but is
still holding some tsmBuffers. User response
Try the operation again, without using useTsmBuffers,
System action or disable encryption for this operation.
The system returns to the calling procedure. 2048 E DSM_RC_OBJ_COMPRESSED This
object cannot be restored/
User response retrieved using useTsmBuffers,
because it is compressed.
The application must return all buffers for this session
by calling tsmReleaseBuffer, and then issue
Explanation
dsmTerminate.
useTsmBuffers does not support compression.
2045 E DSM_RC_BUFF_ARRAY_ERROR An
internal error occurred in the
tsmBuffer array. System action
The system returns to the calling procedure.

492 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response that bEncryptKeyEnabled is set to
true.
Try the operation again, without using useTsmBuffers.
2049 E DSM_RC_OBJ_ENCRYPTED This Explanation
object cannot be restored/
retrieved using useTsmBuffers, There was no encryption key found in the password
because it is encrypted. file, or no key was provided by the application.

Explanation System action

useTsmBuffers does not support encryption. The system returns to the calling procedure.

System action User response

The system returns to the calling procedure. If you are using -encryptkey=prompt, make sure there
is a value in encryptionPasswordP and that
bEncryptKeyEnabled is set to true.
User response
2053 E DSM_RC_ENCR_CONFLICT
Try the operation again, without using useTsmBuffers.
Conflicting encryption key options
2050 E DSM_RC_WILDCHAR_NOTALLOW have been specified.
ED On dsmSendObj, wildcards are
not allowed for the objName. Explanation
When using the ENABLEENCRYPTKEY option, the
Explanation parameter bEncryptKeyEnabled for the IBM Spectrum
On dsmSendObj, wildcards are not allowed for the Protect API dsmInitExIn_t and tsmInitExIn_t
objName. structures cannot be set to bTrue.

System action System action

The system returns to the calling procedure. The system returns to the calling procedure.

User response User response

Provide a fs, hl, and ll on the dsmObjName. Either remove the ENABLEENCRYPTKEY option from
the options file, or set the parameter
2051 E DSM_RC_POR_NOT_ALLOWED bEncryptKeyEnabled to bFalse in the program using
When using useTsmBuffers, a the IBM Spectrum Protect API.
restore/retrieve with partial object
restore is not allowed. 2060 E DSM_RC_FSNAME_NOTFOUND
The filespace to delete/set access
Explanation cannot be found.

useTsmBuffers does not support partial object restore. Explanation

System action The filespace to delete cannot be found.

The system returns to the calling procedure. System action

User response The system returns to the calling procedure.

Make sure the calling application is either using Partial User response
object restore or useTsmBuffers.
Verify the filespace name.
2052 E DSM_RC_NO_ENCRYPTION_KEY
No encryption key was found. If 2061 E DSM_RC_FS_NOT_REGISTERED
you are using -encryptkey=prompt On dsmSendObj, dsmDeleteObj, or
make sure there is a value in the dsmUpdateFS the filespace is not
encryptionPasswordP field and registered.

Chapter 3. API return codes 493

Explanation User response
On dsmSendObj, dsmDeleteObj, or dsmUpdateFS, the Install the latest IBM Spectrum Protect API library.
filespace is not registered.
2065 E DSM_RC_WRONG_VERSION_PAR
M The caller's structure version is
System action different than the IBM Spectrum
The system returns to the calling procedure. Protect library version.

User response Explanation

Verify the filespace name. The caller's structure version is different than the IBM
Spectrum Protect library version.
2062 W DSM_RC_FS_ALREADY_REGED On
dsmRegisterFS the filespace is
System action
already registered.
The system returns to the calling procedure.
Explanation
User response
On dsmRegisterFS the filespace is already registered.
Ensure that the stVersion field is set with the value in
System action the header file. Recompile the application with the
latest header files.
The system returns to the calling procedure.
2070 E DSM_RC_NEEDTO_ENDTXN Issue
User response dsmEndTxn and then begin a new
transaction session.
Verify the filespace name.
2063 E DSM_RC_OBJID_NOTFOUND On Explanation
dsmBeginGetData the objID is This transaction must be ended and a new one must
NULL. be started due to one of the following reasons:
The destination changed.
Explanation
The byte limit is exceeded
On dsmBeginGetData, the objID is NULL. The maximum number of objects is exceeded.

System action System action

The system returns to the calling procedure. The system returns to the calling procedure.

User response User response

Verify the following: Issue dsmEndTxn and start a new transaction session.
The dsmGetList is not NULL. 2080 E DSM_RC_OBJ_EXCLUDED The
Each objID is not NULL. backup or archive object is
The dsmGetList numObjId is not zero. excluded from processing.
2064 E DSM_RC_WRONG_VERSION On
dsmInit, the caller API version is Explanation
different than the IBM Spectrum The backup or archive object is excluded from
Protect library version. processing.

Explanation System action

On dsmInit, the caller API version is later than the IBM The system returns to the calling procedure.
Spectrum Protect library version.
User response
System action
Verify the objName and Exclude lists.
The system returns to the calling procedure.

494 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
2081 E DSM_RC_OBJ_NOBCG The backup User response
object does not have a copy group. The sndArchiveData.descr string must be less than or
equal to DSM_MAX_DESCR_LENGTH.
Explanation
2101 E DSM_RC_OBJINFO_TOOLONG The
The backup object does not have a copy group. sendObj ObjAttr.objInfo is too
long.
System action
The system returns to the calling procedure. Explanation
The sendObj ObjAttr.objInfo is too long.
User response
Verify server policy definitions. System action

2082 E DSM_RC_OBJ_NOACG The archive The system returns to the calling procedure.
object does not have a copy group.
User response
Explanation The objInfo field must be less than or equal to
The archive object does not have a copy group. DSM_MAX_OBJINFO_LENGTH.
2102 E DSM_RC_HL_TOOLONG The
System action sendObj dsmObjName.hl is too
long.
The system returns to the calling procedure.

Explanation
User response
The sendObj dsmObjName.hl is too long.
Verify server policy definitions.
2090 E DSM_RC_APISYSTEM_ERROR System action
Memory used by the IBM
Spectrum Protect API has been The system returns to the calling procedure.
corrupted.
User response
Explanation The hl field must be less than or equal to
Memory used by the IBM Spectrum Protect API has DSM_MAX_HL_LENGTH.
been corrupted. 2103 E DSM_RC_PASSWD_TOOLONG The
password, or encryptionPassword
System action string provided is too long.
The system returns to the calling procedure.
Explanation
User response The value provided for password or
encryptionPassword is too long.
Retry the operation. If the problem continues, contact
your system administrator or service representative.
System action
2100 E DSM_RC_DESC_TOOLONG The
sendObj Archive description is too The system returns to the calling procedure.
long.
User response
Explanation The password or encrypionPassword field must be
The sendObj Archive description is too long. less than DSM_MAX_VERIFIER_LENGTH.
2104 E DSM_RC_FILESPACE_TOOLONG
System action The sendObj dsmObjName.fs is
too long.
The system returns to the calling procedure.

Chapter 3. API return codes 495

Explanation User response
The sendObj dsmObjName.fs is too long. Set size estimate greater than 0 in dsmSendObj.
2110 E DSM_RC_INVALID_ACCESS_TYPE
System action The dsmSetAccess access Type is
The system returns to the calling procedure. invalid.

User response Explanation

The fs field must be less than or equal to The dsmSetAccess accessType is invalid.
DSM_MAX_FS_LENGTH.
System action
2105 E DSM_RC_LL_TOOLONG The
sendObj dsmObjName.ll is too The system returns to the calling procedure.
long.
User response
Explanation
The accessType must be one of the following:
The sendObj dsmObjName.ll is too long.
atBackup
atArchive
System action
2111 E DSM_RC_QUERY_COMM_FAILURE
The system returns to the calling procedure.
Communications error with server
during object query
User response
The ll field must be less than or equal to Explanation
DSM_MAX_LL_LENGTH.
An unexpected communications error occurred during
2106 E DSM_RC_FSINFO_TOOLONG On an object query to the server.
RegisterFS or UpdateFS the
fsAttr's fsInfo is too long. System action
Processing stopped.
Explanation
On RegisterFS or UpdateFS the fsAttr's fsInfo is too User response
long.
Verify that communications are active between the
client and server machines. Server outages, processor
System action outages, and communication controller outages can
The system returns to the calling procedure. cause this error.
2112 E DSM_RC_NO_FILES_BACKUP No
User response files have been previously backed
The fsInfo field must be less than or equal to up for this filename/filespace.
DSM_MAX_FSINFO_LENGTH.
Explanation
2107 E DSM_RC_SENDDATA_WITH_ZERO
_ SIZE Cannot Send data with a You tried to set access to files when no files for the
zero byte sizeEstimate. specified filename, drive or file system were previously
backed up.
Explanation
System action
You cannot send data for an object with size estimate
= 0. Processing stopped.

System action User response

The system returns to the calling procedure. Ensure that the correct drive or file system was
specified and that files are backed up for you to set
access.

496 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
2113 E DSM_RC_NO_FILES_ARCHIVE No User response
files have been previously The message referred to has been shortened, but
archived for this filename/ describes the error that occurred. See the
filespace.
documentation for that message for more information.

Explanation 2200 I DSM_RC_MORE_DATA On

dsmGetNextQObj or dsmGetData
You tried to set access to files when no files for the there is more available data.
specified filename, drive or file system were previously
archived.
Explanation

System action On dsmGetNextQObj or dsmGetData there is more

available data.
Processing stopped.
System action
User response
The system returns to the calling procedure.
Ensure that the correct drive or file system was
specified and that files are archived for you to set
User response
access.
Call the function again.
2114 E DSM_RC_INVALID_SETACCESS
Invalid format for Set Access 2210 E DSM_RC_BUFF_TOO_SMALL The
command. dataBlk buffer is too small for the
query response.
Explanation
Explanation
The SET ACCESS command must have at least three
operands, the first of which must be either BACKUP or The dataBlk buffer is too small for the query response.
ARCHIVE. A validly formed file specification must
follow. System action
The system returns to the calling procedure.
System action
Processing stopped, the command is not executed. User response
On dsmGetNextQObj ensure that the dataBlk buffer is
User response
at least as big as the query response structure.
Use the HELP SET ACCESS command for complete
2228 E DSM_RC_NO_API_CONFIGFILE
details of usage, then enter the SET ACCESS command
using the correct syntax. The configuration file specified on
dsmInit cannot be opened.
2120 E DSM_RC_STRING_TOO_LONG The
following message was too long to Explanation
log to the server: 'shortened
message with message number' The configuration file specified on dsmInit cannot be
opened.
Explanation
System action
The message text and inserts are too large to send to
the server in the available internal buffer. The system returns to the calling procedure.

System action User response

The message number message is written to the local Verify the file name.
client error log, then shortened and sent to the server 2229 E DSM_RC_NO_INCLEXCL_FILE The
as a part of this message. The message is reduced in Include/Exclude definition file
length by substituting '...' in the middle of the original was not found.
message.

Chapter 3. API return codes 497

Explanation User response
The Include/Exclude definition file was not found. Run this program as a root user.
2301 E DSM_RC_NEEDTO_CALL_BINDMC
System action You must issue dsmBindMC before
The system returns to the calling procedure. dsmSendObj.

User response Explanation

Verify the file name on the Inclexcl option. You must issue dsmBindMC before dsmSendObj.

2230 E DSM_RC_NO_SYS_OR_INCLEXCL
System action
Either the dsm.sys file was not
found, or the Inclexcl file specified The system returns to the calling procedure.
in dsm.sys was not found.
User response
Explanation
Modify your program.
Either the dsm.sys file was not found, or the Inclexcl
2302 I DSM_RC_CHECK_REASON_CODE
file specified in dsm.sys was not found.
The dsmEndTxn vote is ABORT, so
check the reason field.
System action
The system returns to the calling procedure. Explanation
After a dsmEndTxn call, the transaction is aborted by
User response either the server or client with a DSM_VOTE_ABORT
The dsm.sys file must be in the directory referenced by and the reason is returned.
the environment variable DSMI_DIR. Verify the file
name on the Inclexcl option in the dsm.sys file. System action
2231 E DSM_RC_REJECT_NO_POR_ The system returns to the calling procedure.
SUPPORT Partial Object Retrieve
is not supported on this server. User response
Check the reason field for the code which explains why
Explanation
the transaction has been aborted.
The IBM Spectrum Protect server specified by the user
2400 E DSM_RC_ALMGR_OPEN_FAIL
does not support partial object retrieve.
License file could not be opened.
System action
Explanation
The system returns to the calling procedure.
The license file was not found, or could not be opened
because of permissions or the file is corrupted.
User response
Specify a IBM Spectrum Protect server which supports System action
the partial object retrieve function.
The system returns to the calling procedure.
2300 E DSM_RC_NEED_ROOT Only a
UNIX root user can execute User response
dsmChangePW or dsmDeleteFS.
Check permissions on file. See if the license file is in
the correct place.
Explanation
2401 E DSM_RC_ALMGR_READ_FAIL
Only a UNIX root user can execute dsmChangePW or
dsmDeleteFS. Read failure on the license file.

System action
The system returns to the calling procedure.

498 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Explanation User response
The license file was not found, or could not be opened User needs to obtain a new license.
because of permissions, or the file is corrupted.
2405 E DSM_RC_ALMGR_TRIAL_EXPRD
This is an expired try and buy
System action license.
The system returns to the calling procedure.
Explanation
User response The registration string is not valid.
Check permissions on file. See if the license file is in
the correct place. System action
2402 E DSM_RC_ALMGR_WRITE_FAIL The system returns to the calling procedure.
Write failure on the license file.
User response
Explanation
User needs to obtain a new license.
The license file was not found, or could not be opened
4580 E DSM_RC_ENC_WRONG_KEY Error
because of permissions or the file is corrupted.
processing 'filespace namepath-
namefile-name'; invalid encryption
System action key.
The system returns to the calling procedure.
Explanation
User response The key you entered does not match the key that was
Check permissions on file. See if license file is in the used to encrypt the file during backup. The file can not
correct place. be restored unless the matching key is entered.

2403 E DSM_RC__ALMGR_DATA_FMT
System action
Data in the license file is not in a
valid format. processing stops.

Explanation User response

The license file is not valid. Try the restore operation again and provide the correct
key.
System action 4582 E DSM_RC_ENC_NOT_AUTHORIZED
The system returns to the calling procedure. User is not authorized to encrypt
file-space
User response namedirectory_pathfile_name.

User needs to obtain a new license. Explanation

2404 E DSM_RC_ALMGR_CKSUM_BAD The user is not authorized to encrypt the file.
The checksum in the license file Normally, only a IBM Spectrum Protect authorized
does not match the user or a root user can use IBM Spectrum Protect
licenseregistration string. encryption. However, a certain combination of
PASSWORDACCESS and ENCRYPTKEY options may
Explanation allow encryption operations by a non-authorized user.
The registration string is not valid.
System action
System action The file is not backed up or restored.
The system returns to the calling procedure.
User response
Log in as a root or IBM Spectrum Protect authorized
user and try the operation again. See IBM Spectrum

Chapter 3. API return codes 499

Protect Backup-Archive Client Installation and User's User response
Guide for the correct usage of the ENCRYPTKEY
Ensure that the latest cluster software is installed on
option.
the system.
4584 E DSM_RC_ENC_TYPE_UNKOWN
4602 E DSM_RC_CLUSTER_LIBRARY_
Error processing 'filespace
NOT_LOADED CLUSTERNODE is
namepath-namefile-name':
set to YES but the cluster software
unsupported encryption type.
is not available
on this system.
Explanation
The files you are trying to restore or retrieve have been Explanation
backed up or archived by a later version of the IBM
The load library that the operating systems provides to
Spectrum Protect client. The file encryption method is
obtain the cluster name is not available on this system.
not supported by the current client.

System action
System action
Processing ends.
Object skipped.

User response
User response
Ensure that the cluster software is installed on the
Restore or retrieve the file with the most recent
system.
version of the IBM Spectrum Protect client.
4603 E DSM_RC_CLUSTER_NOT_MEMBER
4600 E DSM_RC_CLUSTER_INFO_
_ OF_CLUSTER CLUSTERNODE is
LIBRARY_NOT_LOADED
set to YES but this machine is not
CLUSTERNODE is set to YES but
a member of a
the Cluster Information Daemon is
cluster.
not
started.
Explanation
Explanation This machine is not a member of a cluster node.
Possible causes are that the cluster service has not
The HACMP Cluster Information Daemon must be
been configured correctly, or that the cluster is in the
started in order to specify the CLUSTERNODE option.
process of initialization.

System action
System action
Processing ends.
Processing ends.

User response
User response
Start the HACMP Cluster Information Dameon.
Ensure that the cluster software is configured
4601 E DSM_RC_CLUSTER_LIBRARY_ properly. If the cluster is in the process of
INVALID CLUSTERNODE is set to initialization, retry the operation at a later time.
YES but the cluster load library is
4604 E DSM_RC_CLUSTER_NOT_ENABLE
not valid.
D CLUSTERNODE is set to YES but
the cluster service is not enabled
Explanation on this system.
The load library that the operating system provides to
obtain the cluster name is not valid. A possible cause Explanation
is an out-of-date load library which does not contain
The cluster service has not been enabled on this
the proper routines this product expects.
system.

System action
System action
Processing ends.
Processing ends.

500 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
User response User response
Enable the cluster service on the system. Ensure that the remote node is properly configured
and connected to the IBM Spectrum Protect server by
4605 E DSM_RC_CLUSTER_NOT_
using TLS. This validates the remote node
SUPPORTED The CLUSTERNODE
configuration and ensures that the information that is
option is not supported on this related to the remote node is sent to the server.
system.
5702 E DSM_RC_PROXY_REJECT_NO_
Explanation RESOURCES Proxy Rejected: The
IBM Spectrum Protect server has
This option is not supported on this system. run out of memory.

System action Explanation

Processing ends. There is not enough memory available to allow this
operation to continue.
User response
Disable the CLUSTERNODE option in the local options System action
file. Current operation has been cancelled.
4606 E DSM_RC_CLUSTER_UNKNOWN_
ERROR An unexpected error User response
(retcode) occurred while the Try the operation again. If the problem continues, see
program was trying to obtain the your system administrator to increase the amount of
cluster name from the system. memory of the server.

Explanation 5705 E DSM_RC_PROXY_REJECT_

DUPLICATE_ID Proxy Rejected:
An unknown error occurred while the program was The ASNODENAME and NODENAME
trying to obtain the cluster name from the cluster options have the same value.
service. The error code is the reason code provided
directly from the cluster service being used in this
Explanation
operating system environment.
The ASNODENAME and NODENAME options cannot have
System action the same value.

Processing ends.
System action

User response The current operation is cancelled.

Consult the documentation for your clustering

User response
software for an explanation of the reason code. Insure
that your clustering service is operational, then try the Use the ASNODENAME option only to access another
IBM Spectrum Protect operation again. node. It is not necessary to set the ASNODENAME
option to access your own node. Remove the
5200 E DSM_RC_ABORT_CERTIFICATE_ ASNODENAME option from your option file unless you
NOT_FOUND The remote node is are actually trying to access a node that you have been
not properly configured on the IBM granted authority to access with the administrative
Spectrum Protect server. command "Grant Proxynode".

Explanation 5710 E DSM_RC_PROXY_REJECT_ID_IN_

USE Proxy Rejected: The node
The remote node is not properly configured on the IBM name you specified in the
Spectrum Protect server. ASNODENAME option is locked.

System action Explanation

Processing stopped. The IBM Spectrum Protect administrator has locked
the node you specified as the ASNODENAME option.

Chapter 3. API return codes 501

System action System action
The IBM Spectrum Protect operation ends. Processing stops.

User response User response

The IBM Spectrum Protect server administrator must Remove the ASNODENAME option from the options
unlock the node before you can access it. Try the file or do not use the FROMNODE option.
operation later, or check with your IBM Spectrum
5748 E DSM_RC_PROXY_INVALID_
Protect administrator.
CLUSTER The ASNODENAME
5717 E DSM_RC_PROXY_REJECT_ option cannot be used with the
INTERNAL_ERROR Proxy CLUSTERNODE option.
Rejected: The server has an
internal error. Explanation
None.
Explanation
The client cannot proxy to the node named by the System action
ASNODENAME option because of an internal server
error. Processing stops.

System action User response

Current operation has been cancelled. Remove the ASNODENAME option and retry the
operation.
User response 5749 E DSM_RC_PROXY_INVALID_FUNCT
See your system administrator immediately. ION The operation that is being
attempted cannot be invoked
5722 E DSM_RC_PROXY_REJECT_NOT_ using the ASNODENAME option.
AUTHORIZED Proxy Rejected:
Proxy authority has not been Explanation
granted to this node.
None.
Explanation
System action
The node has not been granted proxy authority to
access the node named by the ASNODENAME option. Processing stops.
The IBM Spectrum Protect administrator must first
grant proxy authority. User response
Remove the ASNODENAME option and retry the
System action operation.
The IBM Spectrum Protect operation ends. 5801 E DSM_RC_CRYPTO_ICC_ERROR
Unexpected error in cryptography
User response library.
The IBM Spectrum Protect server administrator must
grant proxy authority for this node. See the Explanation
administrator command "Grant Proxynode". There was an unexpected error in the cryptography
5746 E DSM_RC_PROXY_INVALID_ library. See the error log for more information.
FROMNODE The ASNODENAME
option is not valid with the System action
FROMNODE option.
processing stops.

Explanation
User response
None.
Check the error log for ANS1467E to determine the
cause of failure. Verify you IBM Spectrum Protect

502 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
client is installed properly. If needed, reinstall client
and/or API. If the problem still exists, contact IBM
Spectrum Protect technical support.

Chapter 3. API return codes 503

504 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Appendix A. Accessibility features for the IBM
Spectrum Protect product family
Accessibility features assist users who have a disability, such as restricted mobility or limited vision, to
use information technology content successfully.

Overview
The IBM Spectrum Protect family of products includes the following major accessibility features:
• Keyboard-only operation
• Operations that use a screen reader
The IBM Spectrum Protect family of products uses the latest W3C Standard, WAI-ARIA 1.0
(www.w3.org/TR/wai-aria/), to ensure compliance with US Section 508 (www.access-board.gov/
guidelines-and-standards/communications-and-it/about-the-section-508-standards/section-508-
standards) and Web Content Accessibility Guidelines (WCAG) 2.0 (www.w3.org/TR/WCAG20/). To take
advantage of accessibility features, use the latest release of your screen reader and the latest web
browser that is supported by the product.
The product documentation in IBM Knowledge Center is enabled for accessibility. The accessibility
features of IBM Knowledge Center are described in the Accessibility section of the IBM Knowledge Center
help (www.ibm.com/support/knowledgecenter/about/releasenotes.html?view=kc#accessibility).

Keyboard navigation
This product uses standard navigation keys.

Interface information
User interfaces do not have content that flashes 2 - 55 times per second.
Web user interfaces rely on cascading style sheets to render content properly and to provide a usable
experience. The application provides an equivalent way for low-vision users to use system display
settings, including high-contrast mode. You can control font size by using the device or web browser
settings.
Web user interfaces include WAI-ARIA navigational landmarks that you can use to quickly navigate to
functional areas in the application.

Vendor software
The IBM Spectrum Protect 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 accessibility information about its products.

Related accessibility information

In addition to standard IBM help desk and support websites, IBM has a TTY telephone service for use by
deaf or hard of hearing customers to access sales and support services:

TTY service
800-IBM-3383 (800-426-3383)
(within North America)

For more information about the commitment that IBM has to accessibility, see IBM Accessibility
(www.ibm.com/able).

© Copyright IBM Corp. 1993, 2019 505

506 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Notices
This information was developed for products and services offered in the US. This material might be
available from IBM in other languages. However, you may be required to own a copy of the product or
product version in that language in order to access it.
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, MD-NC119
Armonk, NY 10504-1785
US

For license inquiries regarding double-byte character set (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.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

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 jurisdictions 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 websites are provided for convenience only and do not in
any manner serve as an endorsement of those websites. The materials at those websites are not part of
the materials for this IBM product and use of those websites is at your own risk.
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 Director of Licensing

IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

© Copyright IBM Corp. 1993, 2019 507

 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 document 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.
The performance data discussed herein is presented as derived under specific operating conditions.
Actual results may vary.
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 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 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_.

Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business
Machines Corp., 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 www.ibm.com/legal/copytrade.shtml.
Adobe is a registered trademark of Adobe Systems Incorporated in the United States, and/or other
countries.
Linear Tape-Open, LTO, and Ultrium are trademarks of HP, IBM Corp. and Quantum in the U.S. and other
countries.
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the
United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other
countries, or both.
Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or
its affiliates.
UNIX is a registered trademark of The Open Group in the United States and other countries.
VMware, VMware vCenter Server, and VMware vSphere are registered trademarks or trademarks of
VMware, Inc. or its subsidiaries in the United States and/or other jurisdictions.

508 Notices
Terms and conditions for product documentation
Permissions for the use of these publications are granted subject to the following terms and conditions.
Applicability
These terms and conditions are in addition to any terms of use for the IBM website.
Personal use
You may reproduce these publications for your personal, noncommercial use provided that all
proprietary notices are preserved. You may not distribute, display or make derivative work of these
publications, or any portion thereof, without the express consent of IBM.
Commercial use
You may reproduce, distribute and display these publications solely within your enterprise provided
that all proprietary notices are preserved. You may not make derivative works of these publications,
or reproduce, distribute or display these publications or any portion thereof outside your enterprise,
without the express consent of IBM.
Rights
Except as expressly granted in this permission, no other permissions, licenses or rights are granted,
either express or implied, to the publications or any information, data, software or other intellectual
property contained therein.
IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use
of the publications is detrimental to its interest or, as determined by IBM, the above instructions are
not being properly followed.
You may not download, export or re-export this information except in full compliance with all
applicable laws and regulations, including all United States export laws and regulations.
IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS
ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-
INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Privacy policy considerations

IBM Software products, including software as a service solutions, (“Software Offerings”) may use cookies
or other technologies to collect product usage information, to help improve the end user experience, to
tailor interactions with the end user, or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings can help enable you to
collect personally identifiable information. If this Software Offering uses cookies to collect personally
identifiable information, specific information about this offering’s use of cookies is set forth below.
This Software Offering does not use cookies or other technologies to collect personally identifiable
information.
If the configurations deployed for this Software Offering provide you as customer the ability to collect
personally identifiable information from end users via cookies and other technologies, you should seek
your own legal advice about any laws applicable to such data collection, including any requirements for
notice and consent.
For more information about the use of various technologies, including cookies, for these purposes, see
IBM’s Privacy Policy at http://www.ibm.com/privacy and IBM’s Online Privacy Statement at http://
www.ibm.com/privacy/details in the section entitled “Cookies, Web Beacons and Other Technologies,”
and the “IBM Software Products and Software-as-a-Service Privacy Statement” at http://www.ibm.com/
software/info/product-privacy.

Notices 509
510 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
Glossary
A glossary is available with terms and definitions for the IBM Spectrum Protect family of products.
See the IBM Spectrum Protect glossary.

© Copyright IBM Corp. 1993, 2019 511

512 IBM Spectrum Protect: Client Messages and Application Programming Interface Return Codes
IBM®

Product Number: 5725-W98

5725-W99
5725-X15
5725-X18
5725-X04