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.

• 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.

• 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.

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

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

• The Cisco Info Server has returned unknown data.

• Check the Cisco Info Server.

• Internal errors.

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

• 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.

• 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.

• 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.

• 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.

• The option expects a parameter which was not supplied.

• Check the Info Mediator documentation and the contents of the 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.

• 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.

• 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.

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

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

• 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.

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

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

• 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.

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

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

• 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.

• A problem exists at the Cisco Info Server.

• Check the Cisco Info Server.

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

• 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).

• 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.

• 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.

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

• A required property has not been set.

• Check the properties file.

• The Info Mediator is unable to create an element.

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

• 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.

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

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

• 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.

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

• Check the rules file.

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

• 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.

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

Info Level Messages

These messages are for information purposes.

• 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.

• A field value has been set.

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

• A value requested from a lookup table is not available. The function in the rules file will return an empty 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.

• 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: Thu Mar 18 11:25:23 PST 1999
Copyright 1989-1999©Cisco Systems Inc.