Table of Contents

Generic Error Messages

Fatal Level Messages
Error Level Messages
Warning Level Messages
Info Level Messages
Debug

ProbeWatch Events

Error Messages

This appendix lists all of the non-Info Mediator specific error messages. See the Info Mediator sections in this manual for more information about Info Mediator specific error messages.

Generic Error Messages

Five classes of error messages exist: Fatal, Error, Warning, Info, and Debug. Each message is usually followed by two bullet points. The first provides further details on the error. The second provides a problem resolution or some indication of where to look for further details on the error.

Fatal Level Messages

The Info Mediator automatically terminates when these messages are issued.

Error Message   No matching field found for <field name>

Error Message   Field `<field name>' not found in status table

• The rules file being used refers to a field in the format @fieldname which does not exist in the status table.

• Check the rules file and correct the problem.

Error Message   Connection to InfoServer marked DEAD - aborting...

• The connection to the Cisco Info Server ceased (and store and forward is not enabled in the Info Mediator).

• Check whether the Cisco Info Server is available.

Error Message   Failed to set interfaces file location

Error Message   Failed to access OMNIHOME directory: <directory name>

• The Info Mediator was unable to locate the interfaces file.

• Check whether the OMNIHOME environment variable setting is pointing to the correct destination.

Error Message   Unknown data type returned from InfoServer

• The Cisco Info Server has returned unknown data.

• Check the Cisco Info Server.

Error Message   Failed to initialize

Error Message   Failed to create property

Error Message   Failed to set property

Error Message   Failed to define argument

Error Message   Failed to process arguments

Error Message   Session create failed - aborting

• Internal errors.

• Note the message and contact the Help desk. Refer to your support contract for more information about contacting the Help desk.

Error Message   Failed to connect - aborting

• The Cisco Info Server appears to be unavailable.

• Check that the Cisco Info Server is running, that the interfaces file on the system where the Info Mediator is installed has an entry for it, and that a networking problem doesn't exist between the two systems.

Error Message   Failed to read rules - aborting

• The properties or command line options are pointing to a non-existent rules file.

• Check the command line options and properties and set them to refer to the correct rules file.

Error Level Messages

The Info Mediator is likely to terminate when these messages are issued.

Error Message   Option -propsfile used without argument

• The -propsfile command line option must be followed by a parameter specifying where to find the properties file.

• Check the command line you are using to start the Info Mediator and supply a correct parameter.

Error Message   Unknown option: <option name>

• An option has been used on the command line to start the Info Mediator which is not supported by the Info Mediator.

• Check the Info Mediator documentation and the contents of the command line.

Error Message   Option <option name> used without argument

• The option expects a parameter which was not supplied.

• Check the Info Mediator documentation and the contents of the command line.

Error Message   Property <property name> for option <option name> does not exist

Error Message   Can't set generic property <property name> via command line

• An option in the Info Mediator is not mapped correctly to a property.

• Refer to your support contract for more information about contacting the Help desk.

Error Message   No extraction data for '<regexp>' - missing ()'s?

Error Message   Regexp doesn't match for '<string>'

• A regular expression in the rules file, being used in the extract() function, is missing parentheses, or the string data that is used to extract does not match the regular expression. Extract() is unable to extract data.

• Check the rules file and correct the problem.

Error Message   Failed to open Properties file: <properties file name>

• The Info Mediator is unable to open the properties file.

• Check the properties file or the command line and ensure the parameter is pointing to the correct destination.

Error Message   Properties file: <error description> at line <line no>

• An error exists in the format of the properties file.

• Check the properties file at the specified line number and correct the problem.

Error Message   Unknown property '<property name>' - ignored

• A property specified in the properties file does not exist within the Info Mediator.

• Check the properties file for the named property and see the Info Mediator documentation for supported properties.

Error Message   Regular Expression Error: <regexp>

• A regular expression is incorrectly formed in the rules file.

• Check the rules file for the regular expression and correct the entry.

Error Message   Failed to open Rules file: <rules file name>

• The rules file for the Info Mediator is not available or incorrectly specified.

• Check the properties file and/or command line and ensure the rules file is where the properties/command line specifies.

Error Message   Rules file: `<error description>' at line <line no>

• An error exists in the rules file format/syntax.

• Check the rules file at the specified line number and correct the problem.

Error Message   Failed to open file: <file name>

• A file referred to in the rules file (for example, with the table function) does not exist.

• Check the rules file and ensure the file is available.

Error Message   Unexpected value during results processing

Error Message   Results processing failed

Error Message   Unexpected return from results processing

• A problem exists at the Cisco Info Server.

• Check the Cisco Info Server.

Error Message   OS Error: <error message>

Error Message   Server '<server name>': <error message>

Error Message   Procedure '<procedure name>': <error message>

• An error exists in the Sybase connection. A subsequent message from the Info Mediator that details the effect of this error should exist.

Error Message   Unknown message level `<message level string>' - using WARNING level

• The properties or command line specified a message level which is not supported.

• Check the properties and/or command line and use a supported message level (debug, info, warning, error, fatal).

Error Message   Could not set <fieldname> field

• The Info Mediator was unable to set a field value. This may be because the Cisco Info Server tables were modified so the default fields are no longer present.

• Check the Cisco Info Server.

Error Message   Could not send alert

• The Info Mediator was unable to send an alert (usually an internal alert) to the Cisco Info Server.

• Check whether the Cisco Info Server is available.

Error Message   Error Setting SIGQUIT Handler

Error Message   Error Setting SIGINT Handler

Error Message   Error Setting SIGTERM Handler

• The Info Mediator was unable to set up a signal handler for either a QUIT, INT, or TERM.

Error Message   PropGetValue failed

• A required property has not been set.

• Check the properties file.

Error Message   CreateAndSet failed

Error Message   CreateAndSet failed for attr: <element name>

• The Info Mediator is unable to create an element.

• Refer to your support contract for more information about contacting the Help desk.

Error Message   SessionProcess failed

• The Info Mediator was unable to process the alert against the rules file.

• Refer to your support contract for more information about contacting the Help desk.

Error Message   Failed to open message log: <file name>

• The Info Mediator is unable to open the specified logging file.

• Check the command line and/or properties file and correct the problem.

Error Message   SendAlert failed

• The Info Mediator was unable to send an alert to the Cisco Info Server.

• Check whether the Cisco Info Server is available.

Warning Level Messages

These messages are issued as warnings and should not cause the Info Mediator to terminate.

Error Message   New value for field <field name> truncated to <number>

• A string being copied into an alert field was truncated to fit the field.

• Check the rules file.

Error Message   Failed to set SYBASE in environment

• The Info Mediator was unable to override the SYBASE environment variable.

Error Message   Type mismatch for property '<property name>' - new value ignored

• A property has been set with the wrong data type.

• Check the properties file and/or command line options to ensure that the property is correctly set.

Error Message   Results processing failed

Error Message   Failed to retrieve connection status - attempting to continue

Error Message   Failed to install Client Message Callback

Error Message   Failed to install Server Message Callback

• A problem exists with the Cisco Info Server. The Info Mediator will try to continue.

Info Level Messages

These messages are for information purposes.

Error Message   Using stderr for logging

• The Info Mediator was unable to open a log file. It is now using stderr.

Debug

The debug error messages provide detailed errors and information messages on the internal functioning of the Info Mediator. These messages are aimed at Info Mediator developers, however, they are listed here for completeness.

Error Message   New value for field <field name> is <value>

• A field value has been set.

Error Message   OplInitialise() called more than once

• Multiple calls were made to the C Info Mediator API function OplInitialise() which can only be called once.

Error Message   A value for `<string>' doesn't exist in lookup table `<table name>'

• A value requested from a lookup table is not available. The function in the rules file will return an empty string.

Error Message   Failed to allocate memory (Requested size was <number> bytes)

Error Message   Attempted to free NULL pointer

Error Message   Attempted to realloc NULL pointer

Error Message   Failed to reallocate memory block at address <hex address> (Requested size was <number> bytes)

Error Message   Attempted to duplicate NULL string

Error Message   Failed to duplicate string

• An error or problem has occurred in the memory allocation or string handling components of the Info Mediator library. The library will cope with the problem.

Error Message   Failed to allocate command structure

Error Message   Failed to set command query

Error Message   Failed to send command

Error Message   Failed to allocate context structure

Error Message   Failed to initialize Sybase internals: <number>

Error Message   Failed to set username

Error Message   Failed to set password

Error Message   Failed to set appname

Error Message   Failed to set hostname

Error Message   Failed to connect

Error Message   Failed to fetch number of columns

Error Message   No columns in result set

Error Message   Failed to describe column

Error Message   Failed to bind column

Error Message   Got a row fail - continuing

Error Message   A problem or error has occurred at the Sybase connection or InfoServer connection level.

Error Message   Failed to flush alerts before EXIT

Error Message   Problem during disconnect before EXIT

Error Message   Problem during session destruction before EXIT

Error Message   Problem during shutdown before EXIT

• A problem or error has occurred during the shutdown of the Info Mediator.

ProbeWatch Events

In certain situations, an Info Mediator generates events of its own. These events can be used to detect problems with the Info Mediator.

ProbeWatch messages are passed through the rules file and are then converted into Cisco Info Center alerts. When possible, all rules should allow for this possibility. Table E-1 shows the ProbeWatch alert elements:

Posted: Wed Sep 29 18:54:35 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.