IBM Tivoli Storage Resource Manager
Messages
Version 1 Release 2
SC32-9079-00
IBM Tivoli Storage Resource Manager
Messages
Version 1 Release 2
SC32-9079-00 Note! Before using this information and the product it supports, be sure to read the general information under “Notices”, on page 119.
Second Edition (April 2003) | This edition applies to Version 1 Release 2 of the IBM Tivoli Storage Resource Manager (product numbers | 5698-SRM, 5698-SRC, and 5698-SRD) and to any subsequent releases until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2003. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents
Preface ...... v Getting help ...... 1 IBM Tivoli Storage Resource Manager Publications . v IBMLink Assistance ...... 1 || Related Publications ...... v Describing an error with keywords ...... 2 IBM International Technical Support Center Publications (Redbooks) ...... vi Chapter 2. Messages ...... 5 IBM Tivoli Storage Resource Manager Web Site . . vi Translations ...... vi Appendix. Notices ...... 119 Contacting customer support ...... vi Trademarks ...... 120 Reporting a problem ...... vii Glossary ...... 123 Chapter 1. Introduction ...... 1 Understanding messages ...... 1
© Copyright IBM Corp. 2003 iii iv IBM Tivoli Storage Resource Manager: Messages Preface
This publication contains explanations and suggested actions for messages issued by IBM Tivoli Storage Resource Manager.
IBM Tivoli Storage Resource Manager Publications The following table lists IBM Tivoli Storage Resource Manager publications.
Publication Title Order Number IBM Tivoli Storage Resource Manager Installation Guide SC32-9066 IBM Tivoli Storage Resource Manager Configuration and Getting Started SC32-9067 IBM Tivoli Storage Resource Manager Messages SC32-9079 IBM Tivoli Storage Resource Manager Quick Reference GC32-9068 IBM Tivoli Storage Resource Manager User’s Guide SC32-9069 IBM Tivoli Storage Resource Manager for Chargeback Quick Reference GC32-9073 IBM Tivoli Storage Resource Manager for Chargeback User’s Guide SC32-9074 IBM Tivoli Storage Resource Manager for Databases Quick Reference GC32-9070 IBM Tivoli Storage Resource Manager for Databases User’s Guide SC32-9071 IBM Tivoli Storage Resource Manager Warehouse Enablement Pack: SC32-9077 Implementation Guide IBM Tivoli Storage Resource Manager for NAS User’s Guide SC32-9072
The publications are also available from the IBM publications center: http://www.ibm.com/software/tivoli/library/
The IBM Tivoli Storage Resource Manager publications are included with the product code. The IBM Tivoli Storage Resource Manager library in all translated languages is available on the following CD-ROM:
Title Order Number IBM Tivoli Storage Resource Manager Publications CD-ROM SCD7-0463
| The Tivoli Software Glossary includes definitions for many of the technical terms | related to Tivoli software. The Tivoli Software Glossary is available, in English only, | at the following Web site:
http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm
| Related Publications | The following table lists related IBM® product publications.
||| Title Order Number | IBM Total Storage Common Information Model Agent for the Enterprise GC35-0485 | Storage Server: Installation and Configuration Guide
© Copyright IBM Corp. 2003 v IBM International Technical Support Center Publications (Redbooks) The International Technical Support Center (ITSC) publishes Redbooks, which are books on specialized topics. You can order publications through your IBM representative or the IBM branch office serving your locality. You can also search for and order books of interest to you by visiting the IBM Redbooks™ home page at: http://www.redbooks.ibm.com/redbooks.
IBM Tivoli Storage Resource Manager Web Site To find IBM Tivoli Storage Resource Manager support information and publications begin at this Web site:
http://www-3.ibm.com/software/sysmgmt/products/support/ IBMTivoliStorageResourceManager.html
From the IBM Tivoli Storage Resource Manager page, you can find information about storage resource management and the latest product information.
Translations Selected IBM Tivoli Storage Resource Manager publications have been translated into languages other than American English. Contact your service representative for more information about the translated publications and whether these translations are available in your country.
Contacting customer support For support for this or any Tivoli® product, you can contact IBM customer support in one of the following ways: v Visit the IBM Tivoli Storage Resource Manager technical support Web site at http://www-3.ibm.com/software/sysmgmt/products/support/ IBMTivoliStorageResourceManager.html v Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. You can access IBMLINK at http://www2.ibmlink.ibm.com. v Submit a problem management record (PMR) electronically at http://www.ibm.com/software/support/. See “Reporting a problem” on page vii for details.
Customers in the United States can also call 1-800-IBM-SERV (1-800-426-7378).
International customers should consult the Web site for customer support telephone numbers.
Hearing-impaired customers should visit the TDD/TTY Voice Relay Services and Accessiblity Center Web site at http://www.ibm.com/able/voicerelay.html.
You can also review the IBM Software Support Handbook, which is available on our Web site at http://techsupport.services.ibm.com/guides/handbook.html.
When you contact customer support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site. vi IBM Tivoli Storage Resource Manager: Messages The support Web site offers extensive information, including a guide to support services (the IBM Software Support Handbook); frequently asked questions (FAQs); and documentation for all IBM Software products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases.
All Tivoli publications are available for electronic download or order from the IBM Publications Center:http://www.ibm.com/software/tivoli/library/
We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please complete our customer feedback survey at http://www-3.ibm.com/software/sysmgmt/products/support/Tivoli_Escalation_Process.html Reporting a problem Please have the following information ready when you report a problem: v The IBM Tivoli Storage Resource Manager version, release, modification, and service level number. v The communication protocol (for example, TCP/IP), version, and release number you are using. v The activity you were doing when the problem occurred, listing the steps you followed before the problem occurred. v The exact text of any error messages.
Preface vii viii IBM Tivoli Storage Resource Manager: Messages Chapter 1. Introduction
IBM Tivoli Storage Resource Manager helps you manage your resources by providing network resource discovery, reporting, and management capabilities.
Understanding messages The following examples describe the IBM Tivoli Storage Resource Manager message format: ADG 0020 E Where: ADG Identifies the function (in this case the administrative GUI). See “Function identification keyword” on page 2 for a list of components and their identifiers. 0020 Message number. E Message type. Where I = Information E = Error W = Warning L = Label
Message text variables appear in italics.
Getting help This section describes the following: v How to obtain help with processing errors by using Internet and IBMLink™/ServiceLink v How to describe errors with keywords v How to obtain online message help v What information to have available when you contact your service representative IBMLink Assistance IBM Tivoli Storage Resource Manager message help explanations may suggest that you contact your service representative for additional help with processing errors.
Online help is available through IBMLink/ServiceLink.
If your installation has access to IBMLink/ServiceLink, an interactive online database program, you can: v Search for an existing authorized program analysis report (APAR) that is similar to your problem. v Search for an available program temporary fix (PTF) for the existing APAR. v Order the PTF if it is available. v Create an Electronic Technical Response (ETR) problem report to get assistance from a IBM Tivoli Storage Resource Manager service representative.
© Copyright IBM Corp. 2003 1 Describing an error with keywords When you use IBMLink/Servicelink or call your service representative, accurately describe the problem so that the service representative may quickly help you solve the problem. Identify the processing error with a full set of keywords whenever possible. A keyword is a word or an abbreviation used to describe a single aspect of a program failure. Each keyword describes an aspect of a processing error.
The following example displays the necessary set of keywords:
56980200n R120 type command function
Where Represents 56980200n Component identification keyword R111 Release level keyword type Type-of-failure keyword command Command keyword function Function keyword
Function identification keyword The component identifiers for IBM Tivoli Storage Resource Manager are listed below:
Identifier Function ADG Administrative GUI AGT Agent ALR Alert BTM ESS Common Information Model Agent CBG Chargeback GUI CBS Chargeback server DBA Database agent DBG Database GUI DBS Database server GEN General GUI GUI only INS Install JSG, JSS Database NAA, NAG, NAS NAS SAA, SAG, SAN (some SAS messages are related to filesystem extension) SAS SRV STA, STG, Base product (some STA and STS messages are related to filesystem STS extension)
Type-of-Failure keyword The following keywords identify the type of failure that may occur:
Keyword Description ABENDxxx Use this keyword when the system ends abnormally. INCORROUT Use this keyword when incorrect output is received or expected output is missing. LOOP Use this keyword if a part of the program code runs endlessly; include situations in which a part of the output repeats continuously.
2 IBM Tivoli Storage Resource Manager: Messages Keyword Description MSGmessage number Use this keyword when a message: v Indicates an internal program error v Is issued in a set of conditions that should not cause it to be issued v Contains invalid or missing data See “Understanding messages” on page 1 for a description of the message format. WAIT Use this keyword when you receive no response within a reasonable time that can be perceived as poor response or poor performance. order number Use this keyword when a programming problem appears to be caused by incorrect, missing, or ambiguous information in one of the IBM Tivoli Storage Resource Manager publications. Enter the order number of the publication in place of xxxxxxxxxx. Include the letter prefix and version number, but omit all hyphens, for example, SC324697000. Refer to “IBM Tivoli Storage Resource Manager Publications” on page v for a list of the IBM Tivoli Storage Resource Manager publications. PERFM Use the performance keyword only when system performance cannot be improved by tuning and performance is below explicitly stated expectations.
Command keyword Build keywords based on IBM Tivoli Storage Resource Manager commands. Function keyword Use keywords that refer to IBM Tivoli Storage Resource Manager functions.
Chapter 1. Introduction 3 4 IBM Tivoli Storage Resource Manager: Messages Chapter 2. Messages
ADG0020E IBM Tivoli SRM for Databases is not ADG0516E The agent is not licensed for product installed. name. Explanation: IBM Tivoli Storage Resource Manager for Explanation: The agent is not licensed for this IBM Databases is not installed. Tivoli Storage Resource Manager product. Administrator Response: If you would like to Administrator Response: Contact IBM customer perform a Database Configuration, the IBM Tivoli technical support. Storage Resource Manager for Databases product must be installed. ADG0518E You must assign an agent to each monitored Symmetrix disk array or ADG0022E IBM Tivoli SRM NAS Component is not unlicense the disk array. installed. Explanation: You must assign an agent to each Explanation: If you would like to perform a NAS monitored Symmetrix disk array or unlicense the disk Configuration, the IBM Tivoli Storage Resource array. Manager NAS Component must be installed. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support to obtain a valid product license. technical support. AGT0002E Invalid invocation: swtchusr. ADG0282E Invalid key specified - Enter a key for Explanation: Invalid invocation of the swtchusr product name. command. Explanation: Invalid key specified - Enter a key for Administrator Response: Contact IBM customer the product. technical support. Administrator Response: You entered an invalid product key, enter a valid product key. If you are not AGT0003I Agent registered. sure about your product key, Contact IBM customer technical support. Explanation: This is an informational message informing you that the Agent has been registered. ADG0287E Invalid key specified - key for product name already exists. AGT0004I Agent started. Explanation: Invalid key specified - key for the Explanation: This is an informational message product already exists. informing you that the Agent has been started. Administrator Response: You entered an invalid product key, enter a valid product key. If you are not AGT0006E Process process number is already sure about your product key, contact IBM customer connected to the server. technical support. Explanation: The identified Process is already connected to the server. ADG0504E Unable to instantiate editor class: class name. Administrator Response: Contact IBM customer technical support. Explanation: Unable to instantiate editor class. Administrator Response: Contact IBM customer AGT0007E Another process is already connected to technical support. the server. Explanation: Another process is already connected to ADG0511E Available licenses exceeded. the server, and only one process can be connected to the server at one time. Explanation: Available licenses exceeded. Administrator Response: Only one process can be Administrator Response: Contact IBM customer connected to the server at one time, kill all processes technical support. and restart the server.
© Copyright IBM Corp. 2003 5 AGT0008E • AGT0037W
AGT0008E Job-type should be job type, but it is job AGT0018E Close of pipe failed. type. Explanation: An error occurred While trying to close a Explanation: The Job-type for the scheduled job is pipe. invalid. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support. AGT0031E User user name does not exist. AGT0010E Class not found: class name. Explanation: While trying to perform a swtchusr Explanation: The class identified was not found in the command, it was determined that the identified User Classpath. does not exist. Verify that the User does exist. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support.
AGT0011E class name does not inherit from class AGT0032E Cannot exec user command shell shell -- name. errno = arguments error message. Explanation: The class identified is not inherited from Explanation: An error occurred while trying to the correct class. execute the specified command. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support.
AGT0012E class name does not have appropriate AGT0033E initgroups command(shell) fails -- errno = constructor. arguments error message. Explanation: The identified class does not have Explanation: The initgroups command for the User appropriate constructor. identified has failed with the reported error message. Administrator Response: Contact IBM customer Administrator Response: Make sure the user exists technical support. and has the proper authority, if the problem still persists contact IBM customer technical support. AGT0013E Error constructing class name. AGT0034E Cannot create log-file in directory -- errno Explanation: An error occurred trying to construct the = arguments error message. identified class. Explanation: A log-file cannot be created in the Administrator Response: Contact IBM customer specified directory. technical support. Administrator Response: Contact IBM customer technical support. AGT0016E Read from pipe failed. Explanation: An error occurred While trying to Read AGT0035W Error reading logical volume. from a pipe. Explanation: The specified logical volume can not be Administrator Response: Contact IBM customer read. technical support.
AGT0036W Error deserializing from file name. AGT0017E Write to pipe failed. Explanation: An error has occurred trying to Explanation: An error occurred While trying to write deserialize the job state from the specified file. to a pipe. Administrator Response: Contact IBM customer AGT0037W Premature end of file -- file name. technical support. Explanation: An end of file condition occurred on the specified file before all information needed was read.
6 IBM Tivoli Storage Resource Manager: Messages AGT0038W • AGT0053W
AGT0038W Class class name not found restoring AGT0046W In agent.config, key name is not an from file name. integer -- default of default key number used. Explanation: The specified class was not found restoring from it from the specified file. Explanation: In agent.config, the Key Name specified is not an integer value, the default value for that key will be used. AGT0039W Object restored from file name is not class name, Object is class name. Administrator Response: Check the agent.config file for the specified Key Name and correct the value to be Explanation: The object restored from specified file is a valid integer. not the class that was expected.
AGT0047E In agent.config, key name is not a valid AGT0040E Agent Shutting down. port. Explanation: The Agent is shutting down, review the Explanation: In agent.config, the key name specified is Agent logs for any error information. not a valid port number. Administrator Response: Contact IBM customer Administrator Response: Check the agent.config file technical support. for the specified Key Name and correct the value to be a valid port number. AGT0041E Agent Not registered. Explanation: The Agent Not registered. AGT0048E In agent.config, no value supplied for key name. Administrator Response: The Agent must be registered in Administrative Services. Explanation: In agent.config, no value supplied for was supplied for the specified key name. AGT0042E Error writing file name. Administrator Response: Contact IBM customer technical support. Explanation: An error occurred while trying to write the specified filename. AGT0049E Too many unreported jobs. Administrator Response: Contact IBM customer technical support. Explanation: Too many unreported jobs. Administrator Response: Contact IBM customer AGT0043E Error serializing to file name. technical support. Explanation: An error has occurred trying to serializing an object to the specified filename. AGT0050E Error parsing configuration file. Administrator Response: Contact IBM customer Explanation: An error has occurred while parsing the technical support. configuration file. Administrator Response: Contact IBM customer AGT0044E Fatal error -- cannot connect to self port technical support. number. Explanation: A fatal error has occurred while trying to AGT0051W Config file had at least one bad value. connect to port 127.0.0.1. Explanation: While parsing the Config file, at least Administrator Response: Contact IBM customer one bad value was found. technical support. AGT0052W Cannot create temporary file in directory. AGT0045E Error parsing config file on line line Explanation: A temporary file cannot be created in the number. specified directory. Explanation: An error has occurred while parsing the specified Config File at the specified line number. AGT0053W Tried to send signal process number to Administrator Response: Contact IBM customer nonexistent PID process number. technical support. Explanation: Tried to send signal to nonexistent process.
Chapter 2. Messages 7 AGT0054W • AGT0075E
AGT0054W No running job (job name, job number). AGT0068E Cannot fork -- command: command name. Explanation: A running job with the specified name Explanation: An error has occurred trying to fork the and number were not found. specified command. Administrator Response: Contact IBM customer AGT0055E Jobs are not allowed to run as root. technical support. Explanation: Jobs are not allowed to run as root. AGT0069E open(/proc/uptime) fails. Administrator Response: Contact IBM customer technical support. Explanation: An error has occurred trying to obtain the last boot time. AGT0056I NOTICE: Server moved to computer Administrator Response: Contact IBM customer name:port number. technical support. Explanation: The server moved to the specified host and port number. AGT0070E read(/proc/uptime) fails. Explanation: A failure occurs trying to read the last AGT0059I Received request to shut down request boot time. type. Administrator Response: Contact IBM customer Explanation: Received request to shut down agent. technical support.
AGT0060I Exiting normally. AGT0071E /proc/uptime doesn’t look right. Explanation: The Agent is exiting normally exiting Explanation: The last boot time does not look right. normally. Administrator Response: Contact IBM customer technical support. AGT0061I Exiting abnormally. Explanation: The Agent has exited abnormally. AGT0072E Cannot determine system-boot time. Explanation: The system-boot time cannot be AGT0062E Cannot fork job. determined. Explanation: The attempt to fork the job failed. Administrator Response: Contact IBM customer technical support. Administrator Response: Contact IBM customer technical support. AGT0073E Problem creating up-time poller. AGT0064E Putative SID has too few hyphens: Explanation: A problem occurred while creating security identifier. up-time poller. Explanation: The Putative SID has too few hyphens. Administrator Response: Contact IBM customer technical support. Administrator Response: Contact IBM customer technical support. AGT0074E Unsupported Operating System. AGT0066E Error reaping. Explanation: The Agent is trying to be started on an unsupported Operating System. Explanation: Error reaping. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support.
AGT0075E Cannot query key namekey value. AGT0067E Error waiting for process process name. Explanation: The registry key value specified cannot Explanation: An error occurred while waiting for the be queried. specified process to complete. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support.
8 IBM Tivoli Storage Resource Manager: Messages AGT0076E • AGT0110E
AGT0076E Perf title data title not found. AGT0088W Cannot find any domain controller for domain domain name. Explanation: The performance data title was not found in the registry. Explanation: The domain controller for the specified domain cannot be found. Administrator Response: Contact IBM customer technical support. AGT0097E Command not found: fdisk command. AGT0077E <
Chapter 2. Messages 9 AGT0111I • AGT0128W
AGT0111I Re-reading config file. AGT0120E Error transmitting shutdown request to agent. Explanation: The config file is being reread. Explanation: An error occurred while transmitting shutdown request to the agent. AGT0112E This product is not fully installed. To try again, stop and restart this agent. Administrator Response: Contact IBM customer technical support. Explanation: This product is not fully installed. To try again, stop and restart this agent. AGT0121E Unable to create socket. Administrator Response: Contact IBM customer technical support. Explanation: An error occurred while trying to create a socket. AGT0113E Cannot create temporary file in directory Administrator Response: Contact IBM customer error message. technical support. Explanation: A temporary file cannot be created in the specified agent home directory because of the error AGT0122I The agent is already down. message specified. Explanation: An informational message letting the Administrator Response: Contact IBM customer user know that the agent is already down. technical support. AGT0123W Unable to determine if agent is active. AGT0114E Cannot write to file file name error Sending shutdown request. message. Explanation: It cannot be determined if the agent is Explanation: The specified file cannot be written active, so a shutdown request is being sent. because of the following error. Administrator Response: Contact IBM customer AGT0124E Unable to create restartable job technical support. directory: directory name. Explanation: The restartable job directory can not be AGT0115E Fork failed. created. Explanation: The Fork command failed. Administrator Response: Contact IBM customer technical support. Administrator Response: Contact IBM customer technical support. AGT0126E Unable to restart job from file file name. AGT0116E Cannot exec command name. Explanation: The job from the specified file is unable to be restarted. Explanation: The command cannot be executed. Administrator Response: Contact IBM customer Administrator Response: Contact IBM customer technical support. technical support.
AGT0127E Unable to restart job job name.namerun AGT0118E Upgrader is not okay. numberrun number. Explanation: The agent upgrader failed. Explanation: The specified job with the specified run Administrator Response: Contact IBM customer number is unable to be restarted. technical support. Administrator Response: Contact IBM customer technical support. AGT0119I version, modification and release. Explanation: An informational message that displays AGT0128W Cannot retrieve global structure. the Version Modification and Release of the product. Explanation: The global structure cannot bet retrieved.
10 IBM Tivoli Storage Resource Manager: Messages AGT0129W • ALR0004W
AGT0129W A system call failed in the agent AGT0137E Cannot determine working directory! program. Explanation: The working directory cannot be Explanation: A system call to determine the number determined. of processors failed when called in the agent program. Administrator Response: Contact IBM customer technical support. AGT0130E The upgrader program parameters are missing. AGT0138W product name is not licensed on this Explanation: The parameters that are to be sent to the computer. upgrader program are missing. Explanation: The specified product is not licensed on Administrator Response: Contact IBM customer this computer. technical support. AGT0139E An initial probe can not be performed. AGT0131I Exit Status = exit message. Explanation: Since the product is not licensed, an Explanation: This is an informational message that initial probe can not be performed. displays the exit status of the Agent. Administrator Response: Contact IBM customer technical support. AGT0132E Cannot find/create script