IBM Support

IBM Spectrum Protect V8.1 Application Programming Interface (API) known problems and limitations

Question & Answer


This document contains warnings and known problems for the IBM Spectrum Protect V8.1 Application Programming Interface (API).


This document is divided into linked sections for ease of navigation. You can use the following links to navigate to the section of the document you want.



Common IBM Spectrum Protect API warnings
currently no known Client warnings for V8.1

Windows API warnings
currently no Windows Client warnings for V8.1


Known problems and limitations

Common IBM Spectrum Protect API known problems and limitations
currently no Client known problems and limitations for V8.1

Windows API known problems and limitations

  • Changed behavior with the passwordaccess oldPW parameter (internal reference: #147787)
    Problem: when passwordaccess is set generate and the 812 TSM API dsmChangePW/tsmChangePW  is called the parameter oldPW is ignored, instead the value of the currently stored password is used for the value of oldPW.
    NOTE : if passwordaccess is prompt the behavior is the same as before - the oldPW field value will be used.
    Workaround: No need for a work around. Applications will work just fine as they currently work. The only observed symptom is that regardless of the actual value in the oldPW filed if the user is authorized the stored password will be used and the operation will succeed.


Known issues and limitations found in previous version

  • When running the client as described in the Tivoli Field Guide "Tivoli Storage Manager Recovery Techniques Using Windows Preinstallation Environment (Windows PE)" you will receive the error message:

    ANS1464S Cannot load ICC encryption library

    Because the scenarios described in the field guide are not run from a fully installed TSM client, the registry entry indicating the location of the ICC encryption library is not created. Since the recovery scenarios described in the field guide do not involve TSM encrypted files, you can bypass this error by modifying your client options file and specifying the option ENCRYPTIONTYPE DES56. This prevents the client from attempting to load the ICC encryption library.

  • A writable log file is required for backup and restore operations. The DSMI_LOG environment variable or the dsm.sys file (on UNIX and Linux clients) or the dsm.opt file (on Windows clients) errorlogname option must be set to a path that the user of the application can write to. If the user performing the backup or restore does not have write permissions to the log file, the process will fail. The TSM API return code for this situation is 106 (Access to the specified file or directory is denied).


[{"Product":{"code":"SSEQVQ","label":"IBM Spectrum Protect"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF014","label":"iOS"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
12 November 2020