FMF messages
FMF0003S An internal processing error has occurred.
Explanation
An internal processing error has occurred.
System action
Processing ends.
User response
Retry the operation. If this error persists, contact your service representative.
FMF0004E An unknown error has been detected.
Explanation
An internal processing error has occurred that prevents the generation of a message for a return code.
System action
Processing continues.
User response
Retry the operation. If this error persists, contact your service representative.
FMF0005E Out of memory. Stop other processes and try the operation again.
Explanation
The machine has run out of memory.
System action
Processing continues.
User response
Close unnecessary processes and try the operation again.
FMF0053E License file (licensefile) could not be opened.
Explanation
An attempt to read from the license file failed.
System action
Processing ends.
User response
Install the product again. This ensures that the correct license file is installed.
FMF0054E Read failure on license file (licensefile).
Explanation
An attempt was made to read from the license file. This attempt failed.
System action
Processing ends.
User response
Reinstall the product. This will ensure that the correct license file is installed.
FMF0055E Write failure on license file (licensefile).
Explanation
An attempt to write to the license file failed.
System action
Processing ends.
User response
Make sure enough space exists on the workstation to write to the license file. If enough space exists, run the command again.
FMF0056E Data in the license file (licensefile) is not in a valid format.
Explanation
An attempt to read information from the license file failed.
System action
Processing ends.
User response
Install the product again.
FMF0057E The checksum in the license file (licensefile) does not match the license string text.
Explanation
An attempt was made to read information from the license file. The checksum was not valid so it appears that the license file is not at the correct level.
System action
Processing ends.
User response
Reinstall the product.
FMF0058E The 'Try and Buy' license has expired.
Explanation
This 'Try and Buy' license that was detected has expired.
System action
Processing ends.
User response
This product is no longer valid for use. A valid license must be obtained before running the product.
FMF0100E Incomplete command:
Explanation
This message displays the incomplete command that was entered.
System action
Processing ends.
User response
Re-enter the complete command.
FMF0101E Invalid argument:
Explanation
This message displays the command that was entered, up to and including the invalid command or option argument that was detected.
System action
Processing ends.
User response
Re-enter the command specifying a valid argument for the command or option.
FMF0102E Invalid command:
Explanation
This message displays the invalid command that was entered.
System action
Processing ends.
User response
Re-enter a valid command.
FMF0103E Invalid option for the specified command:
Explanation
This message displays the command that was entered, up to and including the option that was detected as invalid for the command.
System action
Processing ends.
User response
Re-enter the command specifying valid command options.
FMF0104E Invalid option:
Explanation
This message displays the command that was entered, up to and including the invalid option that was detected.
System action
Processing ends.
User response
Re-enter the command specifying valid command options.
FMF0105E Missing argument:
Explanation
This message displays the command that was entered, up to and including the command or option whose required argument is missing.
System action
Processing ends.
User response
Re-enter the command specifying a valid argument for the command or option.
FMF0132W Tracing could not be started. Processing will continue.
Explanation
A problem prevented tracing from beginning.
System action
Processing will continue with the command entered.
User response
Refer to the other messages that display with this message to determine the problem.
FMF0133W Could not locate installation directory. Attempting to continue...
Explanation
An attempt was made to read the registry to determine where the Data Protection application client was installed. This attempt failed.
System action
Processing will continue with the command entered.
User response
There should be other messages along with this one. Refer to the other messages to determine the problem. If the problem can not be determined, it may be necessary to reinstall the application client code. This will ensure that the registry entries are set up correctly.
FMF0134W Could not locate log directory. Processing will continue...
Explanation
An attempt was made to read the registry to determine where the Data Protection application client log is located. This attempt failed.
System action
Processing will continue with the command entered.
User response
There should be other messages along with this one. Refer to the other messages to determine the problem. If the problem can not be determined, it may be necessary to reinstall the application client code. This will ensure that the registry entries are set up correctly.
FMF0150I Operation canceled by user.
Explanation
The user has requested the application client end by entering ctrl-C.
System action
Processing ends.
User response
None
FMF0151E Errors occurred while processing the request.
Explanation
Attempting to process the request entered, an error occurred.
System action
Processing ends.
User response
Attempt to determine the source of the errors from viewing the log file. Correct the problems and try running the command again.
FMF0152I Performance stats: seconds seconds spent in apicall API calls
Explanation
The indicated number of seconds were spent making API calls for the indicated system.
System action
Processing continues.
User response
None
FMF0153I Performance stats: seconds seconds spent in function
Explanation
The indicated number of seconds were spent the named function.
System action
Processing continues.
User response
None
FMF0154E The IBM Storage Protect Snapshot application client cannot work with the version of the IBM Storage Protect Snapshot API you have installed. Please install version version.release.level or greater.
Explanation
The version of the IBM Storage Protect Snapshot API currently installed on the system is older than the version used to build the IBM Storage Protect Snapshot application client.
System action
Processing ends.
User response
Install a version of the IBM Storage Protect Snapshot API at or later than the indicated level. A copy is distributed with the IBM Storage Protect Snapshot application client.
FMF0155E The IBM Storage Protect Snapshot application client cannot work with the release of IBM Storage Protect Snapshot API you have installed. Please install release version.release.level or greater.
Explanation
The release of the IBM Storage Protect Snapshot API currently installed on the system is older than the release used to build the IBM Storage Protect Snapshot application client.
System action
Processing ends.
User response
Install a release of the IBM Storage Protect Snapshot API at or later than the indicated level. A copy is distributed with the IBM Storage Protect Snapshot application client.
FMF0156E Could not load the IBM Storage Protect Snapshot API.
Explanation
The IBM Storage Protect Snapshot API could not be loaded.
System action
Processing ends.
User response
Ensure the IBM Storage Protect Snapshot API is correctly installed. Run the IBM Storage Protect Snapshot application client with the /TRACEFLAGS=API /TRACEFILE=filename options and view the tracefile to determine why it could not be loaded. Another possible cause is that the TSMAPI.DLL does not exist in the system directory. Re-install the IBM Storage Protect Snapshot API, if this is the case.
FMF0160E An authentication error occurred with your stored IBM Storage Protect Snapshot password.
Explanation
You were unable to log on to the IBM Storage Protect Snapshot server due an authentication error.
System action
Processing stops.
User response
The stored IBM Storage Protect Snapshot password may have become corrupted. Contact your IBM Storage Protect Snapshot server administrator.
FMF0161E Authentication error. The password entered is not valid. You are not logged on to the IBM Storage Protect Snapshot server.
Explanation
An incorrect password was entered.
System action
Processing stops.
User response
Enter the correct IBM Storage Protect Snapshot password and try again.
FMF0162E The passwords entered do not match. Please enter them again.
Explanation
An incorrect password was entered.
System action
Processing stops.
User response
Enter the passwords again.
FMF0163E The directory path needs to be fully-qualified.
Explanation
The /intopath option was specified without a fully-qualified path.
System action
Processing stops.
User response
Enter the command again and specify a fully-qualified path in the /intopath option.
FMF0167E The fully-qualified file name is too long.
Explanation
An attempt was made to use a fully-qualified file name that was too long. This attempt failed.
System action
Processing ends.
User response
None
FMF0200E File (filename) could not be opened for reading.
Explanation
An attempt was made to open a file for reading. This attempt failed.
System action
Processing ends.
User response
None
FMF0201E File (filename) could not be opened for writing.
Explanation
An attempt was made to open a file for writing. This attempt failed.
System action
Processing ends.
User response
None
FMF0202E Read failure on file (filename).
Explanation
An attempt was made to read from a file. This attempt failed.
System action
Processing ends.
User response
None
FMF0203E Write failure on file (filename).
Explanation
An attempt was made to write to a file. This attempt failed.
System action
Processing ends.
User response
None
FMF0204E File (filename) could not be closed.
Explanation
An attempt was made to close a file. This attempt failed.
System action
Processing ends.
User response
None
FMF0205E File (filename) statistics could not be obtained.
Explanation
An attempt was made to obtain file statistics. This attempt failed.
System action
Processing ends.
User response
None
FMF0206E Directory (directory) could not be created.
Explanation
An attempt was made to create a directory. This attempt failed.
System action
Processing ends.
User response
None
FMF0207E Directory path (directorypath) is too long.
Explanation
An attempt was made to use a directory path that was too long. This attempt failed.
System action
Processing ends.
User response
None
FMF0208E There is not enough disk space for the operation attempted.
Explanation
An attempted operation required more disk space than was available. The attempt failed.
System action
Processing ends.
User response
None
FMF0209E The rename of file (filename1) to (filename2) failed.
Explanation
An attempt was made to rename a file. This attempt failed.
System action
Processing ends.
User response
None
FMF0210E The IBM Storage Protect Snapshot high level qualifier is too long.
Explanation
An attempt was made to use a IBM Storage Protect Snapshot high level qualifier that was too long. This attempt failed.
System action
Processing ends.
User response
None
FMF0211E The IBM Storage Protect Snapshot low level qualifier is too long.
Explanation
An attempt was made to use a IBM Storage Protect Snapshot low level qualifier that was too long. This attempt failed.
System action
Processing ends.
User response
None
FMF0212E The IBM Storage Protect Snapshot filespace name is too long.
Explanation
An attempt was made to use a IBM Storage Protect Snapshot filespace name that was too long. This attempt failed.
System action
Processing ends.
User response
None
FMF0213E The maximum number of objects allowed per IBM Storage Protect Snapshot transaction is too small.
Explanation
In order to maintain backup data integrity, multiple backup objects are sent to the IBM Storage Protect Snapshot server in a single transaction. The IBM Storage Protect Snapshot server has indicated that the maximum number of objects allowed per transaction is less than the minimum required by the IBM Storage Protect Snapshot application client.
System action
Processing ends.
User response
Increase the maximum number of objects allowed per transaction on the IBM Storage Protect Snapshot server and retry the operation.
FMF0214E The backup object's management class backup copy group does not exist.
Explanation
The IBM Storage Protect Snapshot server has indicated that the backup object's management class backup copy group does not exist.
System action
Processing ends.
User response
Contact your IBM Storage Protect Snapshot server administrator.
FMF0215E All backup objects do not have the same management class backup copy destination.
Explanation
In order to maintain backup data integrity, multiple backup objects are sent to the IBM Storage Protect Snapshot server within a single transaction. All backup objects within a single transaction are required to have the same management class backup copy destinations.
System action
Processing ends.
User response
Contact your IBM Storage Protect Snapshot server administrator.
FMF0216E Unable to obtain space information for volume (volumename).
Explanation
An attempt was made to obtain space information for a volume. This attempt failed.
System action
Processing ends.
User response
None
FMF0217E The IBM Storage Protect Snapshot filespace name is invalid.
Explanation
The filespace name or directory delimeter is invalid.
System action
Processing ends.
User response
Check that the filespace name length, characters, and directory delimeters are valid.
FMF0218E The IBM Storage Protect Snapshot high level qualifier is invalid.
Explanation
The high level qualifier name or directory delimeter is invalid.
System action
Processing ends.
User response
Check that the high level qualifier name length, characters, and directory delimeters are valid.
FMF0219E The IBM Storage Protect Snapshot low level qualifier is invalid.
Explanation
The low level qualifier name or directory delimeter is invalid.
System action
Processing ends.
User response
Check that the low level qualifier name length, characters, and directory delimeters are valid.
FMF0256E The password in your IBM Storage Protect Snapshot options file has expired. Please change your password on the IBM Storage Protect Snapshot server using the 'change password' command and then either change or remove the password value in your options file.
Explanation
Your IBM Storage Protect Snapshot password has expired. You need to change your password.
System action
Processing ends.
User response
Obtain a new password for your IBM Storage Protect Snapshot server; node using the change password command or by asking your IBM Storage Protect Snapshot administrator to change your password.
FMF0257E Your password has expired.
Explanation
Your IBM Storage Protect Snapshot password has expired. A new password needs to be obtained.
System action
Processing ends.
User response
Obtain a new password for your IBM Storage Protect Snapshot node using the change password command or by asking your IBM Storage Protect Snapshot administrator to change your password.
FMF0258E You did not enter a valid password. Processing ends.
Explanation
The password that was entered was not a valid password.
System action
Processing ends.
User response
Re-enter the command specifying a valid password.
FMF0259E The password you entered for verification does not match the password you entered for your new password. Your password will not be changed.
Explanation
The password you entered for verification of your new password does not match the new password that was entered.
System action
Processing ends.
User response
Try again to change your password being sure to enter the same password for the new password and for the verification password.
FMF0260I Password successfully changed.
Explanation
The change password command completed successfully
System action
Processing ends.
User response
None
FMF0261I There are no backups for the server named servername.
Explanation
There are no backups on the IBM Storage Protect Snapshot server for the specified server name.
System action
Processing ends.
User response
None
FMF0262E Errors occurred while processing the VSS operation. Examine the Windows Event Logs and DSMERROR.LOG for additional details.
Explanation
While attempting to process a VSS operation, an unexpected error occurred.
System action
Processing ends.
User response
Attempt to determine the source of the error by examining the IBM Storage Protect Snapshot for Windows log file, the client error log file (DSMERROR.LOG), the Windows Application Event Log, the Windows System Event Log, and the VSS provider log file, if applicable. Additional instructions for Windows VSS operations are located in the IBM Storage Protect Problem Determination Guide. Correct the problem and retry the operation. If this error persists, contact your service representative.
FMF0267E The verify password entered does not match the new password entered.
Explanation
The verify password does not match the new password.
System action
Processing ends.
User response
Retry the command with a matching verify password.
FMF0292E An unknown error has been detected. rc = rc
Explanation
An error occured without an error message. The return code is displayed.
System action
Processing ends.
User response
Retry the operation. If this error persists, contact your service representative.
FMF0300E Invalid restore type.
Explanation
The type of restore requested is invalid.
System action
Processing ends.
User response
Re-enter the command specifying a valid restore type.
FMF0301E Invalid backup type.
Explanation
The type of backup requested is invalid.
System action
Processing ends.
User response
Re-enter the command specifying a valid backup type.
FMF0351E Invalid trace keyword - 'keyword'
Explanation
A TRACEFLAG option in the user configuration file or on the command line is incorrect.
System action
Client program did not initialize or tracing was not enabled in the applet.
User response
Correct the value.
FMF0368E Invalid trace file name (name too long).
Explanation
A TRACEFILE option in the preferences files used a file name that is too long.
System action
Client program did not initialize.
User response
Change the file name used as the TRACEFILE so that it is equal to or less than 255 characters in length.
FMF0383E Specifying the trace file 'link' as a symbolic link is not allowed.
Explanation
Trace file 'linkname' cannot be a symbolic link.
System action
The symbolic link 'linkname' is deleted, the trace file is recreated, and processing stops.
User response
Specify the trace file location with the 'tracefile' option.
FMF0384E Symbolic link 'linkname' to 'target' was successfully deleted.
Explanation
Log 'linkname' cannot be a symbolic link.
System action
The symbolic link 'linkname' is deleted, the log is recreated, and processing stops.
User response
Check the location of the new file. To specify the location of log files, refer to the user's manual for the 'errorlogname' option, the 'schedlogname' option, and the 'DSM_LOG' environmental variable.
FMF0385E Unable to delete symbolic link 'link'.
Explanation
Log 'linkname' cannot be a symbolic link.
System action
Processing stops.
User response
Delete the symbolic link 'linkname'.
FMF0476E program-name: cannot open file file-spec: error.
Explanation
Cannot open the file. The reason is given in the message.
System action
Cannot complete the requested operation.
User response
Retry the operation. If the problem continues, check with your system administrator.
FMF0480I Temp object renamed (Filespace: '', HL: '', and LL: ').
Explanation
After a legacy backup operation, it might be a temp object remains on TSM server but for SQL Server this backup is successful already. Rename this temp object to have consistent backup.
System action
User response
No action is required.
FMF0487E Specifying the error log 'link' as a symbolic link is not allowed.
Explanation
Error log 'linkname' cannot be a symbolic link.
System action
The symbolic link 'linkname' is deleted, the error log is recreated, and processing stops.
User response
Check the location of the new error log. To specify the location of the error logs, refer to the user's manual for the 'errorlogname' option and 'DSM_LOG' environmental variable.
FMF0488E Initialization functions cannot open the error log: log-name. errno = errno-value,
Explanation
The file log-name could not be opened during initialization. The system set the error code errno-value. If the reason given is "access denied," the current user does not have permission to write to the log in the directory specified. It is also possible that no space is available at the given log location. If the reason is errno = 13, Permission denied, you have the following policy setting control enabled, User Account Control: Turn on Admin Approval Mode.
System action
Processing terminates.
User response
Set the DSM_LOG (or DSMI_LOG) environment variable to a directory into which the current user can write. You may also use the ERRORLOGNAME option to specify a file to which the current has write permission. If the reason is errno = 13, Permission denied, you should run the same operation in administrator mode.
FMF0495E Failure writing to a IBM Storage Protect Snapshot log or log-related file: file-name, errno = errno-value, reason
Explanation
A failure was encountered when writing to one of the log files or a related file named file-name. The system set the error code errno-value. reason is the system explanation of that error code. Among other things, it is possible that no space is available at the given log location.
System action
Processing terminates.
User response
Set the DSM_LOG (or DSMI_LOG) environment variable to a directory with adequate space to write the log data.
FMF0496I Converting the log-file from continuous (pruning) mode to wrapping mode. This process may take several minutes.
Explanation
The log-file was previously in continouos mode where the only size control was through the use of ERRORLOGRETENTION or SCHEDLOGRETENTION option. This is the first occasion where ERRORLOGMAX or SCHEDLOGMAX is specified for this log, so its format must be changed and old data saved.
System action
Transition processing continues.
User response
None.
FMF0497I IBM Storage Protect Snapshot is converting the log-file from wrapping mode to continuous (pruning) mode. This process may take several minutes.
Explanation
The log-file was previously in wrapping mode where the size control was through the use of the ERRORLOGMAX or SCHEDLOGMAX option. This is the first occasion where ERRORLOGMAX or SCHEDLOGMAX is not specified for this log, so its format must be changed and old data saved.
System action
Transition processing continues.
User response
None.
FMF0498I count log records processed.
Explanation
This is just a progress report to let you know the process is still ongoing.
System action
Transition processing continues.
User response
None.
FMF0501E Invalid Proxy Configuration Detected: Target Node 'targetnode' is not listed as a valid node to proxy to for Node Name 'nodename'.
Explanation
The proxy node configuration on the Storage Protect Snapshot Server is not correct to support this VSS operation.
System action
The VSS operation stops.
User response
Contact the Storage Protect Snapshot Server administrator to have the correct GRANT PROXY commands issued to enable proxy authority for the nodes. If the error persists, contact your service representative.
FMF0515E Invalid DSMAGENT Node configuration found for node 'dsmagentnode'.
Explanation
The DSMAGENT Node specified is not configured properly.
System action
The VSS operation stops.
User response
Verify that the DSMAGENT Node specified is correct and that the client acceptor is running for the DSMAGENT Node. If the error persists, contact your service representative.
FMF0516I The Windows console event handler received a 'event' console event.
Explanation
A console event was received by one of the IBM Storage Protect Snapshot processes or programs. The following events can be recevied:
- Ctrl-C - This indicates either the user entered the ctrl-c sequence or that one of the Windows services was stopped.
System action
None.
User response
None.
FMF0517I An unexpected error was encountered. function name : function-name function : function-desc return code : TSM-rc file : file-name (line-number)
Explanation
None.
System action
Processing stops.
User response
Contact the IBM Storage Protect Snapshot administrator with the information provided in this message.
FMF0518E Backups selected for restore must have the same backup location (TSM or LOCAL).
Explanation
A VSS restore operation was submitted that specified multiple backup objects. The backup objects chosen had different backup locations. This is not allowed. All backup objects submitted in the same VSS restore operation must have the same backup location, either TSM or LOCAL, but not both.
System action
The VSS restore operation stops.
User response
Retry the VSS restore operation specifying one backup object at a time.
FMF0519E The VSS operation failed with rc = returncode.
Explanation
There was a failure when Storage Protect Snapshot performed the VSS operation.
System action
The VSS operation stops.
User response
Verify that the client acceptor is installed, configured, and running properly on the machine. Retry the operation. If the error persists, contact your service representative.
FMF0520E Failed to connect to Local DSMAGENT Node 'localdsmagentnode' at address:port 'address:portnumber'. Verify that the client acceptor is installed, configured, and running properly.
Explanation
An attempt was made to connect to the client acceptor running on the local machine. A communication error occurred when this connection was attempted.
System action
The operation stops.
User response
In order to perform VSS operations, you must have a client acceptor and a IBM Storage Protect Remote Client Agent Service (DSMAGENT) installed and configured properly. In addition, the client acceptor must be running. Verify that the client acceptor is installed, configured, and running properly on the local machine. If the error persists, contact your service representative.
FMF0521E Pruning functions cannot open the prune files: log-name. errno = errno-value,
Explanation
The file "log-name" could not be opened during pruning. The system set the error code errno-value. If the reason given is "access denied," the current user does not have permission to write to the file in the directory specified. It is also possible that no space is available at the given file location or another IBM Storage Protect Snapshot process started by different user id is performing pruning at the same time.
System action
Pruning stops, processing continues.
User response
Set the DSM_LOG (or DSMI_LOG) environment variable to a directory into which the current user can write.
FMF0522E DIAG:
Explanation
The message text is provided for diagnostic purposes and is meant to provide information to IBM support in problem determination.
System action
None.
User response
None.
FMF0524S Error 'errtxt' (errno=errno) occurred trying to write to audit log 'file-name'. The audit log function is disabled.
Explanation
There was an error encountered writing to the audit log (for example, there is not enough space on the disk).
System action
Audit logging is disabled for the rest of the operation. The return code for the operation is set to 12 to indicate that the contents of the audit log are incomplete.
User response
If this is an out of space condition either free up space on the volume or try to write the audit log to a volume with more space.
FMF0555E Invalid number of snapshots:
Explanation
System action
Policy was not created.
User response
Specify a number in the range: range: 1...9999 or NOLimit
FMF0556E Invalid number of days:
Explanation
System action
The Policy was not created.
User response
Specify a number in the range: range: 0...9999 or NOLimit
FMF0571E The specified policy was not found: 'policy'
Explanation
System action
User response
Please make sure that the specified policy exists.
FMF0572E The specified policy already exists: 'policy'
Explanation
System action
Policy was not created.
User response
Enter a different name for the policy.
FMF0573E The specified policy could not be updated: 'policy'
Explanation
This is due to a problem in virtual server database.
System action
Processing stops.
User response
Make sure that IBM Storage Protect Snapshot is configured correctly.
FMF0574E The specified policy could not be deleted: 'policy'
Explanation
This is due to a problem in virtual server database.
System action
Processing stops.
User response
Make sure that IBM Storage Protect Snapshot is configured correctly.
FMF0575E The specified policy could not be created: 'policy'
Explanation
This is due to a problem in virtual server database.
System action
Processing stops.
User response
Make sure that IBM Storage Protect Snapshot is configured correctly.
FMF0576I There were no items found.
Explanation
The query completed successfully, but no results were found.
System action
None.
User response
Change the specified search criteria.
FMF0581E One or more of the volume(s) volume-list could not be locked. See more details in the VSS Requester error log file (baclient\dsmerror.log).
Explanation
The system call to lock the volume(s) failed.
System action
Processing stopped.
User response
Please verify that no other application is accessing the volume(s). During restore of an image exclusive use of the volume is required.
FMF0583E Invalid name of policy specified. Valid input characters include alphanumeric charaters and underscore.
Explanation
System action
Policy was not created.
User response
Please specify a valid name.
FMF0585E Unable to connect to the client acceptor.
Explanation
Possible causes of this message include: The client acceptor is not running. The VSSALTSTAGINGDIR option setting in the TDP option file is not set to the same value as the VSSALTSTAGINGDIR option setting in the IBM Storage Protect Snapshot Remote Client Agent Service (DSMAGENT) option file. They must be set to the same value.
System action
The VSS operation stops.
User response
Ensure that the client acceptor is running. Ensure that the VSSALTSTAGINGDIR option setting in the TDP option file is set to the same value as the VSSALTSTAGINGDIR option setting in the IBM Storage Protect Snapshot Remote Client Agent Service (DSMAGENT) option file. After correcting the VSSALTSTAGINGDIR option inconsistency, retry the operation.
FMF0588E The value for the BACKUPDESTination option is not allowed. IBM Storage Protect Snapshot is only licensed to run data protection operations to a IBM Storage Protect Snapshot server. It is not licensed to backup or to restore locally managed snapshots.
Explanation
The value for the configuration option is not allowed. The only allowed value is TSM. IBM Storage Protect Snapshot is only licensed to run data protection operations to a IBM Storage Protect Snapshot server. It is not licensed to backup or to restore locally managed snapshots.
System action
Processing ends.
User response
Set the backup destination to TSM. In order to create and restore local VSS backups it is required to use and install a fully-featured valid license or to purchase an upgrade, and install IBM Storage Protect Snapshot.
FMF0589E You are not allowed to set REMOTEDSMAGentnode option. IBM Storage Protect Snapshot is not licensed to perform offloaded VSS backups.
Explanation
The REMOTEDSMAGentnode option is used to perform offloaded VSS backups.
System action
The operation stops.
User response
In order to perform offloaded VSS backups install a valid fully-featured license.
FMF0590E A Data Protection communication error with the IBM Storage Protect Snapshot server has occurred.
Explanation
Communications with the IBM Storage Protect Snapshot server has been lost.
System action
The operation stops.
User response
Correct the TCP/IP communications error with the IBM Storage Protect Snapshot server and retry the operation.
FMF0591I Communications with the IBM Storage Protect Snapshot server recovered.
Explanation
Communications with the IBM Storage Protect Snapshot server has been successfully recovered.
System action
None.
User response
Continue with normal operations.
FMF0592E The TCP/IP session with the IBM Storage Protect Snapshot server was canceled.
Explanation
The TCP/IP session with the IBM Storage Protect Snapshot server was cancelled.
System action
The operation stops.
User response
Correct the reason the IBM Storage Protect Snapshot server administrator cancelled the session and retry the operation.
FMF0593E IBM Storage Protect Snapshot is not licensed to perform offloaded VSS backups.
Explanation
Currently installed license does not allow to perform offloaded VSS backups. In order to use this feature it is necessary to install a valid fully-featured license.
System action
The operation stops.
User response
In order to perform offloaded VSS backups install a valid fully-featured license.
FMF0594E You cannot perform offloaded VSS backups in a standalone configuration.
Explanation
OFFLOAD option is not available in a standalone configuration.
System action
The operation stops.
User response
In order to perform offloaded VSS backups you have to configure IBM Storage Protect Snapshot to manage snapshot backups using a IBM Storage Protect Snapshot server. To do this, you can use the configuration wizard.
FMF0595E The options file 'optfile' does not exist. It is required for proper operation.
Explanation
The specified IBM Storage Protect API options file could not be found. It is required in order to complete the command.
System action
Processing ends.
User response
Make sure to complete IBM Storage Protect Snapshot configuration and try the operation again.
FMF0598E The application cannot run in safe mode.
Explanation
The application requires either Services or Drivers that are not available when running in safe mode.
System action
The application processing stops.
User response
Restart the system using the normal startup. When the system is started, run the application.
FMF0599E The application cannot establish a remote powershell connection.
Explanation
The application attempted to establish a remote powershell connection. The operation failed.
System action
The application processing stops.
User response
Verify you are using the correct credentials. For more information, see the Microsoft about_Remote_Troubleshooting Help topic.
FMF0601E There is a problem that causes processing to stop. To identify the source of the problem and the solution, look for details in the service level trace file.
Explanation
This problem occurs when either the local or remote Powershell cmdlet or script reports an error. Details about the error are not available until more trace file information is analyzed.
System action
Application processing stops.
User response
To identify the problem, look for information in the service level trace files. For more information about viewing trace files, see the Troubleshooting section of the technical documentation provided with the software.
FMF0602E While attempting to communicate with the remote client, a version check reveals that the versions do not match.
Explanation
During initialization between the local client and the remote client, version checking reveals that the versions do not match. This is usually the result of an upgrade of one client module without upgrading other client modules that are part of product solution.
System action
The calling procedure returns and control is passed back the user.
User response
Check the versions of all IBM Storage Protect Client products that communicate with each other and ensure that they are all at the same version, release, and level.
FMF0603S File 'file-name' could not be found, or it cannot be read.
Explanation
- The default options file does not exist.
- The DSM_CONFIG (or DSMI_CONFIG if you are using the IBM Storage Protect Snapshot API) environment variable specifies an options file that does not exist.
- You specified the TSMOPTFILE or FCMOPTFILE option when starting the IBM Storage Protect Snapshot client, but the option file you provided does not exist.
- You specified the TSMOPTFILE or FCMOPTFILE option when starting the IBM Storage Protect Snapshot client, but the configuration file that you provided does not have appropriate read permissions for the user that is running the operation.
- You specified the CONFIGFILE option when starting the IBM Storage Protect Snapshot client, but the configuration file you provided does not exist.
- You specified the CONFIGFILE option when starting the IBM Storage Protect Snapshot client, but the options file that you provided does not have appropriate read permissions for the user that is running the operation.
System action
IBM Storage Protect Snapshot client processing stops.
User response
Make sure that the file you want to use exists, it has the read rights set for the user that is running the operation, and it is in the standard file encoding of the system. For example, on Windows the expected file encoding is ANSI. Review the configuration information in the IBM Storage Protect Snapshot client manual specific to your operating system. If the problem persists, ask your IBM Storage Protect Snapshot administrator for further assistance.
FMF0604E The Backup you are mounting is not located on a SVC volume.
Explanation
Mounting with Snap Of A Snap is only supported with SVC volumes.
System action
Processing stopped.
User response
You may mount backps located as Read Only or Read Write with Snap Of A Snap disabled.
FMF0605E The SVC Hardware Provider is not installed.
Explanation
Mounting with Snap Of A Snap is only supported by the SVC Hardware Provider.
System action
Processing stopped.
User response
Install the SVC Hardware Provider. Or you may mount backps as Read Only or Read Write with Snap Of A Snap disabled.
FMF0606E The SVC Hardware Provider is not at minimum level.
Explanation
Mounting with Snap Of A Snap is only supported by the SVC Hardware Provider version 4.12 or higher.
System action
Processing stopped.
User response
Install SVC Hardware Provider version 4.12 or higher. Or you may mount backps as Read Only or Read Write with Snap Of A Snap disabled.
FMF0607E The SVC VSS Hardware Provider has reported an error.
Explanation
The SVC VSS Hardware Provider has reported an error.
System action
Processing stopped.
User response
See the SVC VSS Hardware Provider log for more details.
FMF0608E The backup type is not a COPY backup type.
Explanation
Only COPY or COPYFULL backup types maybe mounted read write when not useing the Snap Of A Snap feature
System action
Processing stopped.
User response
Enable the USESNAPOFASNAPTomount configuration option if you have a supported environemnt.
FMF0609E The backup has been modified and cannot be restored.
Explanation
When you mount COPY or COPYFULL type backups as read/write, the backup data is modified. A backup with modified data cannot be used for restore operations.
System action
Processing stopped.
User response
Use an alternative backup, one that has not been modified, for your restore operations.
FMF0649E The disk provider does not support the snap of a snap feature. See more details in the VSS Requester error log file (baclient\dsmerror.log).
Explanation
You can use the snap of a snap feature only on SVC and Storwize systems.
System action
Processing ends.
User response
Reset the USESNAPOFASNAPTOMOUNT option to No in the Data Protection configuration file and set MOUNTRW=Yes to mount the read/write backup.
FMF0650E The mount point provided is invalid. It must be an existing empty folder, or a drive letter in case you mount a file system backup.
Explanation
The mount point provided is invalid. It must be an existing empty folder, or a drive letter in case you mount a file system backup.
System action
Processing ends.
User response
Provide an existing empty folder, or a drive letter in case you mount a file system backup.
FMF1225E The command_stream command is not supported without an IBM Storage Protect Snapshot license.
Explanation
To issue the command, a license for IBM Storage Protect Snapshot is required. If an IBM Storage Protect Snapshot license does not exist, the command is not supported.
System action
None.
User response
Install an IBM Storage Protect Snapshot license, then issue the command again.
FMF1226E The local backup or clone cannot be deleted from current machine. It must be deleted from the machine where its snapshot was created.
Explanation
Delete operation failed because the snapshot information for the local backup or clone cannot be found in local machine.
System action
The operation stops.
User response
Delete the local backup or clone from the machine where its snapshot was created.
FMF1227E Node 'nodename' does not connect or register properly with IBM Storage Protect Snapshot Server.
Explanation
DSMAgent node cannot be connected or register properly.
System action
The VSS operation stops.
User response
Verify that the DSMAGENT Node specified is correct and that SSL is config correctly. If the error persists, contact your service representative.
FMF5814E Invalid command. IBM Storage Protect Snapshot for Windows does not support OFFLOAD with the combination specified for backup destination and version of Windows.
Explanation
The OFFLOAD option was specified with an unsupported backup destination. IBM Storage Protect Snapshot for Windows only supports offload with a backup destination of TSM, or if running on a Windows Server 2008 or later, backup destination TSM or BOTH.
System action
The backup operation is canceled.
User response
Retry the VSS offloaded backup operation specifying a valid backup destination.
FMF5815E Invalid command. IBM Storage Protect Snapshot for Windows does not support INTO option with the specified backup destination of LOCAL.
Explanation
The INTO option was specified with an unsupported backup destination. IBM Storage Protect Snapshot for Windows only supports INTO with a backup destination of TSM.
System action
The restore operation is canceled.
User response
Retry the VSS restore into operation specifying a valid backup destination.
FMF5816E Invalid command. The INTO option only supports one restore component per command.
Explanation
The INTO option was specified with multiple restore components. IBM Storage Protect Snapshot for Windows only supports INTO with a single restore component.
System action
The restore operation is canceled.
User response
Retry the VSS restore into operation specifying only one restore component.
FMF5817E The volume/mount point specified in the INTO option is not valid.
Explanation
The INTO option was specified with an invalid value.
System action
The restore operation is canceled.
User response
Retry the VSS restore INTO operation specifying a valid INTO value.
FMF5945E The following mount point is used as a mapped network share for 'share-name': 'drive-letter'.
Explanation
When a backup is mounted over a mapped network drive letter, the files on the mounted snapshot cannot be accessed using that drive letter.
System action
The operation stops.
User response
Specify an unassigned drive letter or mount point directory.
FMF5956I The logfile log file could not be pruned. Processing will continue.
Explanation
An attempt to prune the log was unsuccessful.
System action
Processing continues.
User response
The log file may not exist. If the log file exists, view the log for indications of possible problems.
FMF5957I The logfile log file was pruned successfully.
Explanation
The log file mentioned pruned successfully.
System action
Processing continues.
User response
None.
FMF5970I The operation was canceled by the user.
Explanation
The user has requested that the operation be canceled.
System action
Processing ends.
User response
None
FMF5976E An error was encountered with IBM Storage Protect Snapshot API initialization, rc = returncode. Examine the dsierror.log for more information or determine if the Storage Protect Snapshot API is installed properly.
Explanation
An attempt was made to run setup for the Storage Protect Snapshot API. However, errors were encountered.
System action
Processing continues.
User response
Examine the dsierror.log file to determine the problem. If this file does not exist, it is possible that the Storage Protect Snapshot API is not installed properly. If this is the case, reinstall the Storage Protect Snapshot API and try running the command again.
FMF5989E No components were found that match the criteria specified.
Explanation
None of the items specified match the components found on this machine.
System action
Processing ends.
User response
Correct the component specification and try the operation again.
FMF5990E There were no backups found that match the criteria specified.
Explanation
There are no backups found on the IBM Storage Protect Snapshot server for the specified criteria.
System action
Processing ends.
User response
Correct the backup specification and try the operation again.
FMF6011E The configuration file specified cannot be found.
Explanation
The file specified in the /configfile parameter cannot be found.
System action
Processing stops.
User response
Ensure the correct file name is specified.
FMF6012I The configuration file specified cannot be found. Creating configuration file 'configfile' with default settings.
Explanation
The file specified in the /configfile parameter cannot be found. The file specified gets created with default settings.
System action
Processing continues.
User response
None
FMF6013E Mount backup command failed. The mount point and or backup specified is invalid. Please refer to dsmerror.log for further details.
Explanation
The mount backup command failed. The backup specified may already be mounted and or the drive to map to may already be in used
System action
Processing stops
User response
Check to make sure that the backup specified is not already mounted and that the drive to map to is available.
FMF6014E Unmount backup command failed. Please refer to dsmerror.log for further details.
Explanation
The unmount backup command failed. The backup specified may not be mounted.
System action
Processing stops
User response
Check to make sure that the backup specified is mounted.
FMF6015E Invalid component list. Qualified and non-qualified objects can not be specified on the same command.
Explanation
A command was specified with a component list that contained qualifed and non-qualified objects. This is not valid.
System action
The operation stops.
User response
Enter the command again with a component list that contains all qualified or all non-qualified objects.
FMF6016E Conflicting arguments found. Point in Time options can not be specified on the same command as qualified objects.
Explanation
A command was specified with the point in time option and a component list that contained one or more qualifed objects. This is not valid.
System action
The operation stops.
User response
Correct the syntax and retry the operation.
FMF6017E An invalid duplicate object, 'object', was found in the component list. This is not valid on a RESTORE operation.
Explanation
A command was specified with a component list that contained duplicate objects. RESTORE operations do not support this.
System action
The operation stops.
User response
Correct the syntax and retry the operation.
FMF6018E IBM Storage Protect Snapshot was not able to obtain VSS component information.
Explanation
An error occurred when attempting to enumerate the VSS components for the operation. This could be the result of a VSS Requestor or VSS Writer error.
System action
The operation stops.
User response
Stop the IBM Storage Protect Remote Client Agent Windows service then stop and restart the IBM Storage Protect Client Acceptor Windows service. After that, retry the operation. If the problem persists, refer to the dsmerror.log file, the dsierror.log file, and/or the Windows Event Log for further details on the error.
FMF6019E In the component list that is specified, the following object is not valid: 'object'.
Explanation
The command that is entered includes a component list. The list of components contains one or more invalid objects. For example, when entering a BACKUP or RESTORE command, if the component list includes a volume or mount point that is not valid or is not eligible for back up, this message is displayed. In addition, the GUID volume name cannot be specified. For RESTORE, MOUNT BACKUP, or DELETE BACKUP commands, this message is displayed if the component list contains a backup specification that is not found in the backup inventory.
System action
The operation stops.
User response
Verify the correct syntax is used when entering the command. If the message is displayed again, verify the volume and mount point names are correctly identified. A misspelling can trigger this message.
FMF6020I The configuration file cannot be read. Creating configuration file 'configfile' with default settings.
Explanation
The file specified gets created with default settings.
System action
Processing continues.
User response
None
FMF6021E The value for the preference preference is not valid. See the FCMCLI HELP UPDATE/INSERT output or the User's Guide for valid command parameters.
Explanation
The preference being set is not valid.
System action
Processing ends.
User response
You can either run the command "fcmcli help update" or view the User's Guide for valid UPDATE command parameters.
FMF6026E PASSWORDACCESS is Generate. Either the stored password is incorrect or there is no stored password. If you do not have a stored password, use the -TSMPassword=xxx option to set and store your password.
Explanation
The PASSWORDACCESS option is set to generate in the client options file. However, no password is stored. An initial password needs to be stored.
System action
Processing ends.
User response
Invoke the command again using the -TSMPassword option. Any subsequent commands should now complete without specifying a password.
FMF6030E The IBM Storage Protect Snapshot VSS Fast Restore operation failed to restore the volume. Examine the FCMFSFR.LOG file for more details on the failure.
Explanation
IBM Storage Protect Snapshot attempted to perform a file-level copy of all files from the snapshot backup to the original source volume. There was a failure during the file-level copy operation. This can be caused by locked files or files that are in use by the operating system.
System action
Processing ends.
User response
Examine the FCMFSFR.LOG file that is located in the IBM Storage Protect Snapshot installation directory for specific details on the error. If you are not able to perform the VSS Fast Restore operation successfully, access the backup using the FCMCLI MOUNT command or the equivalent function in the MMC interface. After mounting the backup, use Windows Explorer or other operating system commands to copy the needed files.
FMF6031E The option /BACKUPDESTINATION is invalid when performing data protection operations using a IBM Storage Protect Snapshot virtual server.
Explanation
Data protection commands default to /BACKUPDESTINATION=LOCAL when performed against a IBM Storage Protect Snapshot virtual server. No other value is supported for this option. As a result it is no longer necessary to specify this parameter. For compatibility with other products values for /BACKUPDESTINATION can be specified as long as this is set to its only valid value. This means that /BACKUPDESTINATION option can only be set to LOCAL value.
System action
The operation stops.
User response
Retry the command removing the /BACKUPDESTINATION option.
FMF6037W The preference or preferences preference list that can be specified in the preference file preference file name are not valid for the current operation. Default values will be used instead.
Explanation
Some of the preference values specified in the configuration file are not valid for the current operation. Unless you specify valid corresponding options using the command line, default values will be used instead. Consult the Configuring or Reference information chapters of the FlashCopy Manager for Windows Installation and User's Guide for valid preference values.
System action
Processing continues.
User response
Check the configuration file and correct the preference values per those outlined in the Configuring or Reference information chapters of the FlashCopy Manager for Windows Installation and User's Guide.
FMF6038E The backup destination BOTH is not valid for current operation.
Explanation
The value BOTH for the BACKUPDESTINATION preference is not valid for current operation.
System action
The operation stops.
User response
Retry the command specifying the /BACKUPDESTINATION option with value LOCAL or TSM.