Client Messages and Application Programming Interface Return Codes

Transcription

1 Tivoli Storage Manager Version 6.2 Client Messages and Application Programming Interface Return Codes SC

2

3 Tivoli Storage Manager Version 6.2 Client Messages and Application Programming Interface Return Codes SC

4 Note: Before using this information and the product it supports, read the information in Notices on page 301. This edition applies to Version 6.2 of the IBM Tivoli Storage Manager (product numbers 5608-E01, 5608-E02, 5698-B19, 5608-E11, 5608-E12, 5608-E07, 5698-B21, 5608-E03) and to all subsequent releases and modification until otherwise indicated in new editions or technical newsletters. Copyright IBM Corporation 1993, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Preface v Who should read this guide v Publications v Tivoli Storage Manager publications..... vi Support information vii Chapter 1. Introduction to messages.. 1 Message format Interpreting return code messages Example one for QUERY EVENT command... 3 Example two for DEFINE VOLUME command.. 3 Chapter 2. ANS Client messages, version Changes from version to version New ANS messages Changed ANS messages Deleted ANS messages Version ANS messages Chapter 3. API return code format Appendix. Accessibility features for Tivoli Storage Manager Notices Trademarks Copyright IBM Corp. 1993, 2010 iii

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

7 Preface Who should read this guide Publications Tivoli Storage Manager is an enterprise-wide storage management application for the network. It provides automated storage management services to multi-vendor workstations, personal computers, and local area network (LAN) file servers. This publication contains explanations and suggested actions for messages issued by the following Tivoli Storage Manager components: v Administrative client v Backup-Archive client v Space Management (Hierarchical storage management (HSM) client for UNIX and Linux ) v Application programming interface (API) v Data Protection clients: DB2 UDB and Hardware Devices Snapshot Integration Modules Microsoft Exchange VSS and Hardware Devices Snapshot Integration Modules The target audience for this publication is system administrators who service the Tivoli Storage Manager components. IBM Tivoli Storage Manager publications and other related publications are available online. You can search all publications in the Tivoli Storage Manager Information Center: You can download PDF versions of publications from the Tivoli Storage Manager Information Center or from the IBM Publications Center at shop/publications/order/. Go to Tivoli Documentation Central to find information centers that contain official product documentation for current and previous versions of Tivoli products, including Tivoli Storage Manager products at developerworks/wikis/display/tivolidoccentral/tivoli+storage+manager. You can also order some related publications from the IBM Publications Center Web site. The Web site provides information about ordering publications from countries other than the United States. In the United States, you can order publications by calling Copyright IBM Corp. 1993, 2010 v

8 Tivoli Storage Manager publications Publications are available for the server, storage agent, client, and Data Protection. Table 1. IBM Tivoli Storage Manager troubleshooting and tuning publications Publication title Order number IBM Tivoli Storage Manager Client Messages and Application SC Programming Interface Return Codes IBM Tivoli Storage Manager Server Messages and Error Codes SC IBM Tivoli Storage Manager Performance Tuning Guide GC IBM Tivoli Storage Manager Problem Determination Guide GC Table 2. Tivoli Storage Manager server publications Publication title IBM Tivoli Storage Manager for AIX Installation Guide IBM Tivoli Storage Manager for AIX Administrator's Guide IBM Tivoli Storage Manager for AIX Administrator's Reference IBM Tivoli Storage Manager for HP-UX Installation Guide IBM Tivoli Storage Manager for HP-UX Administrator's Guide IBM Tivoli Storage Manager for HP-UX Administrator's Reference IBM Tivoli Storage Manager for Linux Installation Guide IBM Tivoli Storage Manager for Linux Administrator's Guide IBM Tivoli Storage Manager for Linux Administrator's Reference IBM Tivoli Storage Manager for Sun Solaris Installation Guide IBM Tivoli Storage Manager for Sun Solaris Administrator's Guide IBM Tivoli Storage Manager for Sun Solaris Administrator's Reference IBM Tivoli Storage Manager for Windows Installation Guide IBM Tivoli Storage Manager for Windows Administrator's Guide IBM Tivoli Storage Manager for Windows Administrator's Reference IBM Tivoli Storage Manager Server Upgrade Guide IBM Tivoli Storage Manager Integration Guide for Tivoli Storage Manager FastBack Order number GC SC SC GC SC SC GC SC SC GC SC SC GC SC SC SC SC Table 3. Tivoli Storage Manager storage agent publications Publication title IBM Tivoli Storage Manager for SAN for AIX Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Linux Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Sun Solaris Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Windows Storage Agent User's Guide Order number SC SC SC SC SC vi IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

9 Table 4. Tivoli Storage Manager client publications Publication title IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User's Guide IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and User's Guide IBM Tivoli Storage Manager for Space Management for UNIX and Linux: User's Guide IBM Tivoli Storage Manager Using the Application Programming Interface Order number SC SC SC SC Table 5. Tivoli Storage Manager Data Protection publications Publication title IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SAP Installation and User's Guide for DB2 IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SAP Installation and User's Guide for Oracle Order number SC SC Support information You can find support information for IBM products from various sources. Start at the IBM Support Portal: You can select the products that you are interested in, and search for a wide variety of relevant information. Getting technical training Information about Tivoli technical training courses is available online. Go to these Web sites for training information: Tivoli software training and certification Choose from instructor led, online classroom training, self-paced Web classes, Tivoli certification preparation, and other training options at this site: Tivoli Support Technical Exchange Technical experts share their knowledge and answer your questions in these webcasts: support/supp_tech_exch.html Searching knowledge bases If you have a problem with IBM Tivoli Storage Manager, there are several knowledge bases that you can search. Begin by searching the Tivoli Storage Manager Information Center at From this Web site, you can search the current Tivoli Storage Manager documentation. Preface vii

10 Searching the Internet: If you cannot find an answer to your question in the Tivoli Storage Manager Information Center, search the Internet for the information that might help you resolve your problem. To search multiple Internet resources, go to the support Web site for Tivoli Storage Manager at Tivoli/Tivoli_Storage_Manager. You can search for information without signing in. Sign in using your IBM ID and password, if you want to customize the site based on your product usage and information needs. If you do not already have an IBM ID and password, click Sign in at the top of the page and follow the instructions to register. From the Support Web site, you can search various resources including: v IBM technotes v IBM downloads v IBM Redbooks publications v IBM Authorized Program Analysis Reports (APARs) Select the product and click Downloads to search the APAR list. If you still cannot find a solution to the problem, you can search forums and newsgroups on the Internet for the latest information that might help you resolve your problem. An independent user discussion list, ADSM-L, is hosted by Marist College. You can subscribe by sending an to listserv@vm.marist.edu. The body of the message must contain the following text: SUBSCRIBE ADSM-L your_first_name your_family_name. To share your experiences and learn from others in the Tivoli Storage Manager user community, go to the Tivoli Storage Manager wiki at developerworks/wikis/display/tivolistoragemanager. Using IBM Support Assistant: IBM Support Assistant is a complimentary software product that helps you with problem determination. You can install the stand-alone IBM Support Assistant application on any workstation. You can then enhance the application by installing product-specific plug-in modules for the IBM products that you use. IBM Support Assistant helps you gather support information when you need to open a problem management record (PMR), which you can then use to track the problem. For more information, see the IBM Support Assistant Web site at The product-specific plug-in modules provide you with the following resources: v Support links v Education links v Ability to submit problem management reports Find add-ons for specific products here: docview.wss?&uid=swg viii IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

11 Finding product fixes: A product fix to resolve your problem might be available from the IBM Software Support Web site. You can determine what fixes are available by checking the IBM Software Support Web site at v If you previously customized the site based on your product usage: 1. Click the link for your Tivoli Storage Manager product, or one of the other Tivoli Storage Manager components that you want to find a fix for. 2. Click Downloads, and then click Fixes by version. v If you have not customized the site based on your product usage, click Downloads and search for your product. Receiving notification of product fixes: You can receive notifications about fixes, flashes, upgrades, and other news about IBM products. To sign up to receive notifications about IBM products, follow these steps: 1. From the support page at click My notifications in the notifications module. 2. Sign in using your IBM ID and password. If you do not have an ID and password, click register now above the IBM ID and password. 3. Click the Subscribe tab to select your product family and click Continue. 4. Select the type of information that you want to receive, and add your personal preferences. You can specify how you want to be notified, how often, and you can also optionally select a folder for the notifications. 5. Click Submit. 6. For notifications for other products, repeat steps 4 and 5. Tip: You can also pick a product first, from the main support portal site, and then click in the Notifications section to create or update your subscription for that product. Contacting IBM Software Support You can contact IBM Software Support if you have an active IBM subscription and support contract and if you are authorized to submit problems to IBM. Before you contact IBM Software Support, follow these steps: 1. Set up a subscription and support contract. 2. Determine the business impact of your problem. 3. Describe your problem and gather background information. Then see Submitting the problem to IBM Software Support on page xi for information on contacting IBM Software Support. Preface ix

12 Setting up a subscription and support contract: Set up a subscription and support contract. The type of contract that you need depends on the type of product you have. For IBM distributed software products (including, but not limited to, IBM Tivoli, Lotus, and Rational products, as well as IBM DB2 and IBM WebSphere products that run on Microsoft Windows or UNIX operating systems), enroll in IBM Passport Advantage in one of the following ways: v v Online: Go to the Passport Advantage Web page at software/lotus/passportadvantage/, click How to enroll, and follow the instructions. By Phone: You can call IBMSERV ( ) in the United States, or for the phone number to call in your country, go to the IBM Software Support Handbook Web page at handbook/home.html and click Contacts. Determining the business impact: When you report a problem to IBM, you are asked to supply a severity level. Therefore, you must understand and assess the business impact of the problem you are reporting. Severity 1 Severity 2 Severity 3 Severity 4 Critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. Significant business impact: The program is usable but is severely limited. Some business impact: The program is usable with less significant features (not critical to operations) unavailable. Minimal business impact: The problem causes little impact on operations, or a reasonable circumvention to the problem has been implemented. Describing the problem and gather background information: When explaining a problem to IBM, it is helpful to be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions: v What software versions were you running when the problem occurred? v Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. v Can the problem be recreated? If so, what steps led to the failure? v Have any changes been made to the system? For example, hardware, operating system, networking software, and so on. v Are you using a workaround for this problem? If so, be prepared to explain it when you report the problem. x IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

13 Submitting the problem to IBM Software Support: You can submit the problem to IBM Software Support online or by phone. Online Go to the IBM Software Support Web site at support/entry/portal/open_service_request/software/ Software_support_(general). Sign in to access IBM Service Requests, and enter your information into the problem submission tool. By phone For the phone number to call in your country, go to the contacts page of the IBM Software Support Handbook at webapp/set2/sas/f/handbook/home.html. Preface xi

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

15 Chapter 1. Introduction to messages Message format This information contains explanations and suggested actions for messages issued by Tivoli Storage Manager products and components. This introduction contains information to help you understand the messages. The client can send statistics to the server providing information about a backup or restore. These statistics are informational messages that can be enabled or disabled to the various event logging receivers. These messages are not documented. Messages can appear on the server console, the administrative client, an operator terminal, the administrative graphical user interface, the backup-archive client, or the HSM (Hierarchical Storage Management) client. Tivoli Storage Manager provides an activity log to help the administrator track server activity and monitor the system. The activity log contains messages generated by the server, and is stored in the database. The server automatically deletes messages from the activity log after they have passed the specified retention period. Any messages sent to the server console are stored in the activity log. Examples of the types of messages stored in the activity log include: v When client sessions start or end v When migration starts or ends v When backed up files are expired from server storage v Any output generated from background processes See the Tivoli Storage Manager Administrator's Guide for more information about activity logs. Messages consist of the following elements: v A three-letter prefix. Messages have different prefixes to help you identify the Tivoli Storage Manager component that issues the message. Typically, all messages for a component have the same prefix. Sometimes a component issues messages with two or three different prefixes. For example, clients issue messages with ANS prefix. Client events that are logged to server have ANE prefix. And server common and platform-specific messages have ANR prefix. v A numeric message identifier. v A one-letter severity code. The following letters give an indication of the severity of the action that generated the message. The severity codes and their meanings are as follows: E Error Processing cannot continue. W Warning Processing can continue, but problems may occur later. I Information Processing continues. User response is not necessary. v v 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 accessible only in documentation. Copyright IBM Corp. 1993,

16 The image below presents a typical message. The callouts on the right of the image identify each element of the message. Message Prefix Message Number Message Type* ANR 0992 I Server installation complete. Message Text The server installation procedure has completed successfully. The server is now available for normal operation. Explanation System Action: Server completes installation processing. System Action User Response: User Response * I = Information E = Error S = Severe Error W = Warning K = Kernel message that originates from the hierarchical storage management (HSM) client Message variables in the message text appear in italics. Interpreting return code messages Many different commands can generate the same return code. The following examples are illustrations of two different commands issued that result in the same return code; therefore, you must read the descriptive message for the command. In these examples, two different commands yield the same return code, but they also return descriptive messages that are unique to each command. The two commands are q event standard dddd and def vol cstg05 primary. Both yield a generic message with return code: ANS5102I: Return Code 11. But the first command also yields a descriptive message: ANR2034I: QUERY EVENT: No match found for this query. And the second command also yields a unique, descriptive message: ANRxxxx: DEFINE VOLUME: Storage pool CSTG05 is not defined. 2 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

17 Example one for QUERY EVENT command Example two for DEFINE VOLUME command Chapter 1. Introduction to messages 3

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

19 Chapter 2. ANS Client messages, version 6.2 This section contains ANS messages for Tivoli Storage Manager clients 6.2. The following clients are included: v Administrative clients v Application program interface clients v Backup archive and space management (HSM) clients v Data Protection clients: DB2 UDB and Hardware Devices Snapshot Integration Modules Microsoft Exchange VSS and Hardware Devices Snapshot Integration Modules Version ANS messages that are new, changed, or deleted since release are listed in one section. All version ANS messages are documented in another section. Changes from version to version This section lists the version ANS messages that are new, changed, or deleted since version Only the message ID is listed. New ANS messages ANS2077E ANS2078E ANS2101E ANS4085I ANS4086W ANS4148E ANS4150E ANS4151E ANS4152E ANS4153E ANS4154E ANS4155E ANS4156E ANS4159E ANS4160E ANS4161E ANS4225W ANS4236E ANS4237W ANS4238E ANS4239E ANS4240E ANS4241I Copyright IBM Corp. 1993,

20 ANS4242E ANS4243I ANS4244E ANS4245I ANS4246E ANS4247I ANS4248E ANS4249E ANS4250E ANS4251W ANS4252E ANS4253E ANS4295W ANS7553W ANS7906W ANS7907W ANS7908E ANS7912E ANS7913E ANS7914E ANS7915E ANS7916E ANS7917E ANS7918E ANS7919E ANS7920E ANS7936E ANS7937E ANS7938E ANS7939E ANS7940W ANS7941E ANS7942E ANS7943E ANS7944W ANS7945W ANS7946E ANS7947E ANS7948E ANS7949E ANS7950E ANS7951E ANS7952E ANS7953E ANS7954E 6 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

21 ANS7955E ANS7956E ANS7957E ANS9305E ANS9306E ANS9307E ANS9308E ANS9309E ANS9311E ANS9364E ANS9365E ANS9368W ANS9369W ANS9370W ANS9371I ANS9373E ANS9374E ANS9375E ANS9376W ANS9377E ANS9378E ANS9379E ANS9380E ANS9381I ANS9383E ANS9669W Changed ANS messages In addition to the message number, the part of the message that has changed is listed. Message Number ANS0993E ANS1042S ANS1084E ANS1252W ANS1262E ANS1374W ANS1375W ANS1398E ANS1540E ANS1670E ANS1691I ANS1692E ANS1693E ANS1695E ANS1769E ANS1771W ANS1832W Change Explanation Message text, explanation Message text, explanation, system action, user response Message text Message text, explanation, system action Explanation, system action, user response Explanation, user response Message text, explanation Explanation, user response Message text, explanation, user response Message text, explanation, user response Explanation, user response Explanation, user response User response Explanation, user response Message text, explanation, system action Explanation Chapter 2. ANS Client messages, version 6.2 7

22 ANS0101E Message Number ANS1906I ANS1996W ANS1997W ANS1998W ANS2050E ANS2841E ANS4055E ANS4084E ANS4099E ANS4202E ANS4221E ANS4226 ANS4228E ANS4298E ANS4299E ANS4998E ANS5285E ANS5303I ANS7545E ANS7546E ANS7547E ANS7900W ANS7901W ANS7902I ANS7903W ANS7904E ANS9074I ANS9076I ANS9333E ANS9334E ANS9359W ANS9360W ANS9361W ANS9362W ANS9363W Change Explanation, system action Explanation, user response Explanation, user response Message text, system action Explanation, user response Message text Message text Message text Message text Message text, explanation, system action, user response Message text, explanation, user response Message type, message text, explanation, system action, user response Message text, explanation, system action Message text Message text Message text User response Message text Message text Message text Message text Message text, explanation, system action Message text, explanation, system action, user response Message text, explanation, system action, user response Message text, system action, user response Message text, explanation, system action, user response Message text, explanation Message text, explanation Message text (in casing or blank spaces only) User response Explanation, system action, user response Message text, explanation, system action, user response Message text, explanation, system action, user response Message text, explanation, system action, user response Message text, explanation, system action, user response Deleted ANS messages ANS4201E Version ANS messages This section documents the Tivoli Storage Manager clients ANS messages. The messages are listed in ascending numeric order. The complete message is documented, including message ID, message text, explanation, system action, and user response. This section also contains Diagnosis, Modification, or Tuning Information. Some of these messages include information about the Tivoli Storage Manager error log that you can use when working with your service representative. ANS0101E Unable to open English message repository file name. The default English message repository file cannot be opened. Either the file access permissions 8 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

23 ANS0102W ANS0110E prevent reading the file or the file is not present in the expected location. TSM is unable to complete the requested operation. Processing is terminated. Make sure the file in your DSM_DIR is set up properly. If the problem continues, see your system administrator for further help. ANS0102W Unable to open the message repository file name. The American English repository will be used instead. The default message repository file for the current locale cannot be opened. Either the file access permissions prevent reading the file, the file is not present in the expected location, or the language specified in the option file is not supported on this workstation. TSM continues processing using the English language message repository. Make sure the file in your DSM_DIR is set up properly. If the problem continues, see your system administrator for further help. ANS0103E Error trying to read header record from message repository file name. The message repository file header record cannot be obtained. TSM is unable to complete the requested operation. Make sure the file has not been altered from the installation. If the problem continues, see your system administrator for further help. ANS0105E Error trying to read index for message number from repository file name. The message text for the specified message number cannot be read. TSM is unable to complete the requested operation. Make sure the file has not been altered from the installation. If the problem continues, see your system administrator for further help. ANS0106E Message index not found for message number. The message repository file does not contain the message text for the message number. TSM is unable to complete the requested operation. Make sure the DSM_DIR is set up properly and it does not point to an old copy. If the problem continues, see your system administrator for further help. ANS0107E Error trying to read header for message number from repository file name. The message header information cannot be obtained for the message number in the message file. TSM is unable to complete the requested operation. Make sure the file has not been altered from the installation. If the problem continues, see your system administrator for further help. ANS0108E Error trying to read text for message number from repository file name. The message text cannot be obtained for the message number in the message file. TSM is unable to complete the requested operation. Make sure the file has not been altered from the installation. If the problem continues, see your system administrator for further help. ANS0109E Insufficient memory for allocation of message structure. There is not enough memory in your system to allocate the storage needed for the message text. TSM is unable to complete the requested operation. Stop TSM and restart TSM. Then retry the operation. If unsuccessful, close all unneeded applications and retry the operation. ANS0110E output. Unable to open error log file file name for output. The error log cannot be opened for TSM is unable to complete the requested operation. File permissions may be set such that writing is not allowed. Stop and restart TSM. Then retry the operation. If unsuccessful, make sure the file is not being locked by another application and that file permissions allow write access. Chapter 2. ANS Client messages, version 6.2 9

24 ANS0113E ANS0205E ANS0113E Message repository file name has an invalid control record. The message repository file contains an incorrect control information. TSM is unable to complete the requested operation. Make sure the message file was not altered from the installation. Check DSM_DIR to make sure it is set up properly. message repository for the current locale cannot be opened. The iconv converter used to convert from UTF-8 to the current locale is not installed on this work station. TSM continues processing using the English language message repository. Make sure the required iconv converter is installed properly. If the problem continues, see your system administrator for further help. ANS0118E for output. Unable to open schedule log file 'file name' for output. The schedule log file cannot be opened TSM is unable to complete the requested operation. Stop TSM and restart TSM. Then retry the operation. If unsuccessful, make sure the file has not been locked by another application. ANS0119E Error trying to read response string for message number from repository file name. The response string information for the message number cannot be obtained from the message repository file. It is possible the message repository has been corrupted. TSM is unable to complete the requested operation. Make sure the message file was not altered from the installation. Check DSM_DIR to make sure it is set up properly. ANS0120E Message number number contains an invalid multibyte sequence for the current locale. An illegal multibyte sequence for the current locale was found in the message. Either the message repository has been corrupted or is coded in a language other than that of the current locale. TSM is unable to complete the requested operation. If the message repository is not corrupted, process the operation in the supported locale. ANS0121W Unable to open the iconv converter for the message repository file name. The American English repository will be used instead. The iconv converter for the default ANS0201E Invalid parameter was found. The system encountered an internal program error due to an invalid parameter. Ask your service representative to check the error log. ANS0202E Not authorized to restore the other node's data. The client is not authorized to restore the other node's data. ANS0203E Get authorization from the other node. The objname field has no leading directory separator. The objname field does not have a leading directory separator. ANS0204E Correct the value for the objname. Wildcards are not allowed in the objname directory path. Wildcards are not allowed in the objname directory path. ANS0205E log file. Correct the value for the objname. Unable to open error log file. The system is unable to open the error Verify the DSMI_LOG value and 10 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

25 ANS0206E ANS0217E access permission. On the AS/400 platform, verify the value specified for ERRORLOGNAME in the API options file. ANS0206E file. The log file cannot be written to. There was an error writing to the log Verify the DSMI_LOG value and access permission. on the AS/400 platform, verify the value specified for ERRORLOGNAME in the API options file. ANS0207E log file. The log file name was not specified. The system is unable to open the error Verify the DSMI_LOG value and access permission. On the AS/400 platform, verify the value specified for ERRORLOGNAME in the API options file. ANS0208E be found. ANS0209E The TCP/IP WINSOCK.DLL file cannot be found. The TCP/IP WINSOCK.DLL file cannot Verify your TCP/IP installation. An error occurred while loading a library. An error occurred while loading a library. The TCP/IP DLL load failed. ANS0210E Verify your TCP/IP installation. The TCP/IP load function failed. An error occurred while locating a function. The TCP/IP load function failed. ANS0211E Verify your TCP/IP installation. The object name pointer is NULL. There is no value provided for the object name pointer. Provide an address for the dsmobjname structure. ANS0212E The data block pointer is NULL. There is no value provided for the data block pointer. Provide an address for the DataBlk structure. ANS0213E The object attribute pointer is NULL. There is no value provided for the object attribute pointer. Provide an address for the ObjAttr structure. ANS0214E There is no server session information. The server did not respond with the session information. Verify the server status. ANS0215E There is no server policy information. The server did not respond with the policy information. Verify the server policy definitions. ANS0216E The datablk bufferlen value is zero. The value for the datablk bufferlen is zero. Provide a non-zero value for the bufferlen. ANS0217E The datablk bufferptr is NULL. There is no value provided for the datablk bufferptr. Provide an address for the bufferptr. Chapter 2. ANS Client messages, version

26 ANS0218E ANS0227E ANS0218E The objtype is invalid. The value for the objtype is invalid. The value for dsmobjname.objtype must be: DSM_OBJ_FILE or DSM_OBJ_DIRECTORY for Backup, or DSM_OBJ_FILE for Archive. ANS0219E The dsmendtxn vote is invalid. The dsmendtxn vote is invalid. The vote must be DSM_VOTE_COMMIT or DSM_VOTE_ABORT. ANS0220E An invalid option was found during option parsing. An invalid option was found. Verify the options in dsm.opt, dsm.sys, and the options string. Check the error log for more details about the error. on the AS/400 platform, verify the options in *LIB/QOPTTSM(APIOPT). ANS0221E There was an error in the TSM API internals. The system encountered an error in the API internals. Shut down the process and retry the operation. Verify that any previous dsminit calls were cleaned up and terminated by a dsmterminate call. If the problem continues, contact your system administrator or service representative. ANS0222E The repository type is invalid. The repository type is invalid. For dsmdeletefs the repository must be one of the following: v DSM_ARCHIVE_REP v DSM_BACKUP_REP v DSM_REPOS_ALL. ANS0223E Filespace name should start with the directory delimiter. The filespace name is invalid. Filespace name should start with the directory delimiter. ANS0224E The object name is either an empty string or has no leading delimiter. The object name is invalid because of an empty string or there is no leading delimiter. full path. ANS0225E Verify the format of the dsmobjname Low level qualifier of the object name should start with the directory delimiter. The low level qualifier for the object name is invalid. Start the low level qualifier of the object name with the directory delimiter. ANS0226E The object owner is invalid. The object owner must be either the root user, or the object owner must be the same as the session owner. owner. ANS0227E Verify the session owner and object The dsmbindmc sendtype is invalid. The dsmbindmc sendtype is invalid. The sendtype must be one of the following: stbackup starchive stbackupmountwait starchivemountwait 12 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

27 ANS0228E ANS0236E ANS0228E The dsmsendobj sendtype is invalid. The dsmsendobj sendtype is invalid. The sendtype must be one of the following: stbackup starchive stbackupmountwait starchivemountwait ANS0229E dtarchive. ANS0230E The dsmdeleteobj deltype is invalid. The dsmdeleteobj deltype is invalid. The deltype must be dtbackup or The query Backup objstate is invalid. The query Backup objstate is invalid. The qrybackupdata.objstate must be one of the following: DSM_ACTIVE DSM_INACTIVE DSM_ANY_MATCH ANS0231E The management class name was not found. A query or send operation is unable to find the management class name. ANS0232E Verify the management class name. The drive letter is not an alphabetic character. The drive letter is not an alphabetic character. This return code is valid on Microsoft Windows only. Verify that the drive designation is an alphabetic character. The referenced field is dsmdosfsattrib.driveletter. ANS0233E The Register Filespace name is NULL. There is no value provided for the Register Filespace name. Provide a filespace name on dsmregisterfs. ANS0234E password. The new password value is NULL or blank. There is no value provided for new Provide a new password on dsmchangepw. ANS0235E password. The old password value is NULL or blank. There is no value provided for old Provide an old password on dsmchangepw. ANS0236E On dsminit, the owner is not allowed to establish a session when PASSWORDACCESS=generate. PASSWORDACCESS=GENERATE establishes a session with the current login user as the owner. The application should set clientownernamep to NULL when PASSWORDACCESS=GENERATE is in effect. Whether the application can continue processing depends on how the application handles the error. This message applies to applications that utilize the TSM API, and is intended primarily for the vendor of the application for which the message is issued. Depending on the application, this could be a configuration issue. Consult the documentation for the application and verify that the application is configured correctly. If the problem persists, contact the application vendor for further assistance. Chapter 2. ANS Client messages, version

28 ANS0237E ANS0247E ANS0237E On dsminit, the node is not allowed when PASSWORDACCESS=generate. PASSWORDACCESS=generate establishes a session with the current hostname as the node. When using PASSWORDACCESS=generate, set clientnodenamep to NULL. ANS0238E ANS0239E The sequence of calls is invalid. The sequence of calls is invalid. Verify the transaction call sequence. On dsmsendobj, wildcards are not allowed for the objname. On dsmsendobj, wildcards are not allowed for the objname. dsmobjname. ANS0240E ANS0241E Provide a fs, hl, and ll on the The filespace to delete/set access cannot be found. The filespace to delete cannot be found. Verify the filespace name. On dsmsendobj, dsmdeleteobj, or dsmupdatefs the filespace is not registered. On dsmsendobj, dsmdeleteobj, or dsmupdatefs, the filespace is not registered. ANS0242W Verify the filespace name. On dsmregisterfs the filespace is already registered. On dsmregisterfs the filespace is already registered. ANS0243E NULL. Verify the filespace name. On dsmbegingetdata the objid is NULL. On dsmbegingetdata, the objid is Verify the following: The dsmgetlist is not NULL. Each objid is not NULL. The dsmgetlist numobjid is not zero. ANS0244E On dsminit the caller's API version is different than the TSM library version. On dsminit the caller's API version has a higher value than the TSM library version. Install the latest TSM API library and trusted agent module. ANS0245E The caller's structure version is different than the TSM library version. The caller's structure version is different than the TSM library version. Ensure that the stversion field is set with the value in the header file. Recompile the application with the latest header files. ANS0246E Issue dsmendtxn and then begin a new transaction session. This transaction must be ended and a new one must be started due to one of the following reasons: The destination changed. The byte limit is exceeded The maximum number of objects is exceeded. Issue dsmendtxn and start a new transaction session. ANS0247E The backup or archive object is excluded from processing. The backup or archive object is excluded from processing. 14 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

29 ANS0248E ANS0258I ANS0248E group. ANS0249E group. ANS0250E corrupted. Verify the objname and Exclude lists. The backup object does not have a copy group. The backup object does not have a copy Verify server policy definitions. The archive object does not have a copy group. The archive object does not have a copy Verify server policy definitions. Memory used by the TSM API has been corrupted. Memory used by the TSM API has been Retry the operation. If the problem continues, contact your system administrator or service representative. ANS0251E long. The sendobj Archive description is too long. The sendobj Archive description is too The sndarchivedata.descr string must be less than or equal to DSM_MAX_DESCR_LENGTH. ANS0252E The sendobj ObjAttr.objInfo is too long. The sendobj ObjAttr.objInfo is too long. The objinfo field must be less than or equal to DSM_MAX_OBJINFO_LENGTH. ANS0253E The sendobj dsmobjname.hl is too long. The sendobj dsmobjname.hl is too long. The hl field must be less than or equal to DSM_MAX_HL_LENGTH. ANS0254E The password, or encryptionpassword string provided is too long. The value provided for password or encryptionpassword is too long. The password or encrypionpassword field must be less than DSM_MAX_VERIFIER_LENGTH. ANS0255E The sendobj dsmobjname.fs is too long. The sendobj dsmobjname.fs is too long. The fs field must be less than or equal to DSM_MAX_FS_LENGTH. ANS0256E The sendobj dsmobjname.ll is too long. The sendobj dsmobjname.ll is too long. The ll field must be less than or equal to DSM_MAX_LL_LENGTH. ANS0257E On RegisterFS or UpdateFS the fsattr's fsinfo is too long. On RegisterFS or UpdateFS the fsattr's fsinfo is too long. The fsinfo field must be less than or equal to DSM_MAX_FSINFO_LENGTH. ANS0258I On dsmgetnextqobj or dsmgetdata there is more available data. On dsmgetnextqobj or dsmgetdata there is more available data. Chapter 2. ANS Client messages, version

30 ANS0259E ANS0268E ANS0259E Call the function again. The datablk buffer is too small for the query response. The datablk buffer is too small for the query response. On dsmgetnextqobj ensure that the datablk buffer is at least as big as the query response structure. ANS0260E An invalid option keyword was found during option parsing. An invalid option keyword was found in the dsminit configuration file, the option string, dsm.sys, or dsm.opt. Correct the spelling of the option keywords. Verify that the dsminit configuration file only has a subset of the dsm.sys options. Check the error log for more details about the error. ANS0261E The configuration file specified on dsminit cannot be opened. The configuration file specified on dsminit cannot be opened. ANS0262E not found. option. ANS0263E Verify the file name. The Include/Exclude definition file was not found. The Include/Exclude definition file was Verify the file name on the Inclexcl Either the dsm.sys file was not found, or the Inclexcl file specified in dsm.sys was not found. Either the dsm.sys file was not found, or the Inclexcl file specified in dsm.sys was not found. The dsm.sys file must be in the directory referenced by the environment variable DSMI_DIR. Verify the file name on the Inclexcl option in the dsm.sys file. ANS0264E Only a UNIX root user can execute dsmchangepw or dsmdeletefs. Only a UNIX root user can execute dsmchangepw or dsmdeletefs. ANS0265E Run this program as a root user. You must issue dsmbindmc before dsmsendobj. You must issue dsmbindmc before dsmsendobj. ANS0266I Modify your program. The dsmendtxn vote is ABORT, so check the reason field. After a dsmendtxn call, the transaction is aborted by either the server or client with a DSM_VOTE_ABORT and the reason is returned. Check the reason field for the code which explains why the transaction has been aborted. ANS0267E line. Invalid command line option/value: 'option' The option is not valid on this command Processing stops Verify that the option and value are not misspelled and are valid with the current command. ANS0268E the error log. Server problem: Destination not defined. Server problem: Destination not defined. Have your service representative check 16 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

31 ANS0269S ANS0279I ANS0269S The structured file data type is unknown. An unknown and unexpected error code occurred within the client program. The structured file data type is unknown. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0270S The data buffer overflowed. The data buffer overflowed. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0271E No more files can be restored or retrieved since the destination directory is full. No more files can be restored or retrieved since the destination directory is full. Free up disk space, or restore or retrieve the file to another disk. ANS0272I ANS0273E The operation is finished. The operation is finished. Proceed with next function call. The trusted agent execution/owner permissions are invalid. The trusted agent execution/owner permissions are invalid. Have your system administrator check the installation instructions for the client to ensure that the trusted agent permissions are set correctly. ANS0274S Process killed. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0275S Trusted agent would block the operation. The trusted agent blocks the operation. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0276S The area for the include/exclude pattern is too small. The area for the include/exclude pattern is too small. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0277S There is no closing bracket in the pattern. There is no closing bracket in the pattern. This is a programming failure and the client program ends. Retry the operation. If the problem continues, contact your system administrator. ANS0278S The transaction will be aborted. The server encountered an error and will abort the transaction. The transaction will be aborted. The reason code is passed on the dsmendtxn call. Issue the dsmendtxn with a vote of DSM_VOTE_COMMIT and examine the reason code. ANS0279I A file was skipped during a restore operation because the file is off line and the application has chosen not to wait for a tape mount. A file was skipped during a restore operation because the file is off line and the application has chosen not to wait for a tape mount. File skipped. Verify the application sets the mountwait value correctly on dsmbegingetdata. Chapter 2. ANS Client messages, version

32 ANS0280E ANS0298E ANS0280E Unable to find Trusted Agent module. TSM was unable to find the TSM Trusted Agent module in the specified directory. The name of the TSM Trusted Agent module is dsmtca. TSM ends. Make sure the Trusted Agent module is in the directory specified by DSMI_DIR. ANS0281E Access denied for dsmapitca. An attempt to access a system function has been denied. ANS0282E Contact your system administrator. Password file is not available. The file containing the stored password for the specified server-name is unavailable. password. ANS0283E TSM ends. The root user must set and store a new High level qualifier of the object name should start with the directory delimiter. The high level qualifier for the object name is invalid. High level qualifier of the object name should start with the directory delimiter. ANS0284E The number of objects on dsmbegingetdata exceeds DSM_MAX_GET_OBJ DSM_MAX_PARTIAL_GET_OBJ. The number of objects (numobjid) specified on the dsmbegingetdata call exceeds DSM_MAX_GET_OBJ DSM_MAX_PARTIAL_GET_OBJ. Check the number of objects before calling dsmbegingetdata. If it is greater than DSM_MAX_GET_OBJ DSM_MAX_PARTIAL_GET_OBJ, then issue multiple Get call sequences. ANS0285E The update action is invalid. The dsmupdatefs or dsmupdateobj action is invalid. Correct the action value. Valid values are defined in dsmapitd.h and documented in our Using the API book. ANS0286E The key file is missing. The key file for Tivoli Data Protection application client for Oracle cannot be found. Ensure that you have ordered the Tivoli Data Protection application client which contains TDP for Oracle, and install the key file. ANS0287E The key file content is invalid. The key file content for Tivoli Data Protection application client for Oracle is invalid. Ensure that you have ordered the Tivoli Data Protection application client which contains the TDP for Oracle, and install the key file. ANS0296I Encryption key passwords are not the same. Please try again... TSM found that the encryption key passwords do not match. key password. password. ANS0297E opened. ANS0298E You are prompted for the encryption Enter the correct encryption key Error opening specified file. The specified file could not be located or Attempts to open file failed. Make sure the file exists. Session Rejected: The specified user id is currently locked The user id you specified is currently locked on the server. Session was not started. Check with your system administrator 18 IBM Tivoli Storage Manager: Client Messages and Application Programming Interface Return Codes

33 ANS0299E ANS0312E to find out why your user id is locked. ANS0299E Scheduler cannot be started manually because the value of MANAGEDSERVICES option is SCHEDULE. if MANAGEDSERVICES SCHEDULE is indicated in the option file, the TSM scheduler cannot be started in the traditional manner. Scheduler stopped. If you are not going to use dsmcad to manage the schedule anymore, stop dsmcad and remove MANAGEDSERVICES option from the option file. ANS0301E The TSM DLL dsm3270.dll cannot be found in the user's path. The TSM DLL dsm3270.dll cannot be found in the user's path. established. Communications link is not Make sure that the TSM DLL dsm3270.dll is in a directory that is included in the user's path. ANS0302I ANS0304E Successfully done. The operation successfully completed. Unable to generate password because password access is not set to GENERATE. User issued the Generate Password command, but password access is not set to GENERATE in the options file. TSM none. Add PASSWORDACCESS GENERATE to your dsm.opt file. ANS0305E Unable to generate password because no NAS Node was specified. User issued the Generate Password command with class=nas, but no NAS node was specified. Retry the command and use the -nasnodename option. ANS0306E Unable to generate password because Class type is invalid or unknown. User issued the Generate Password command with an invalid or unknown class. Retry the command and use a supported class type option (class=client or class=nas). ANS0307I Password generated. User issued the Generate Password command and it was successful. ANS0308E Remote operation failed to start on obj-name. Status: status reason: reason The request to start a remote operation has failed for the indicated node and filespace. The status and the reason for the failure are shown. TSM ended the current operation. Contact your system administrator for more information. ANS0309E Remote operation failed to start on obj-name. Status: status The request to start a remote operation has failed for the indicated node and filespace. The status of the failure is shown. IBM Tivoli Storage Manager ended the current operation. Contact your system administrator for more information. ANS0311E The tsmbuffhandle is invalid, or the value of dataptr is invalid. An invalid value for a handle or dataptr has been passed into the API. There is a problem with the calling application. Verify the values of the tsmbuffhandle and dataptr passed to the API. ANS0312E The number of bytes copied into the tsmbuffer is larger than the allowed value. An invalid number of bytes was copied to a tsmbuffer. Chapter 2. ANS Client messages, version