The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Ekahau::Response::Error - An error response from Ekahau

SYNOPSIS

Contains information about an error returned by the Ekahau Positioning Engine.

DESCRIPTION

Constructor

Generally you will not want to construct these objects yourself; they are created by Ekahau::Response, and use its constructor.

Methods

error ( )

Always returns true, to indicate this is an error object. This method can be used on an arbitrary Ekahau::Response object to find out if it represents an error or not.

error_level ( )

Returns an integer representing the severity of the error. Errors are ordered from least to most severe, so you can say things like if ($err-error_level >= EKAHAU_ERR_ERROR). Constants are used to refer to the various levels, which you can refer to as Ekahau::Response::Error::EKAHAU_ERR_CODE. You can also import these symbols into your program using the :codes tag, which allows them to be used without the Ekahau::Response::Error prefix. They can be imported like this:

   use Ekahau::Response::Error qw(:codes)

These constants represent the different error levels:

EKAHAU_ERR_WARNING

A small problem that should not affect tracking or other operations on the server.

EKAHAU_ERR_ERROR

An error that may affect tracking, but may still be recoverable.

EHAKAU_ERR_FATAL

A fatal error requires restarting Ekahau.

error_code ( )

Returns the code for this error. See Errors for a list of errors.

error_msg ( )

Returns the exact error response from the Ekahau engine.

error_info ( )

Returns a triple containing the error name, description, and explanation for this error.

error_name ( )

Returns the name of this error.

error_description

Returns a brief description of the error

error_explanation

Returns a longer explanation for this error.

Errors

EKAHAU_ERR_DEVICE_NOT_TRACKED

Device Not Tracked. The device is not being tracked

EKAHAU_ERR_HARDWARE_FAILURE

Hardware Failure. Network adapter has an internal error.

EKAHAU_ERR_ORDER_PRODUCT_TIMEOUT

Order Product Timeout. The device which you are trying to track might not be responding. Check that the device is still connected to the network and properly running Ekahau Client. Usually you get -1 error first.

EKAHAU_ERR_AUTHENTICATION_FAILED

Authentication Failed. Password or license is wrong.

EKAHAU_ERR_CONSUMER_TASK_NOT_STARTED

Consumer Task Not Started. If this occurs, contact Ekahau support.

EKAHAU_ERR_MALFORMED_REQUEST

Malformed Request. The Ekahau engine expected HELLO and TALK commands but received something else.

EKAHAU_ERR_DATABASE_VERSION_CLASH

Database Version Clash. Internal error, the system could not update the model database. Requires restarting the software

EKAHAU_ERR_UNKNOWN_PRODUCT

Unknown Product. If this occurs, contact Ekahau support.

EKAHAU_ERR_ORDER_REPLY_TIMEOUT

Order Reply Timeout. The device which you are trying to track might not be responding. Check that the device is still connected to the network and properly running Ekahau Client. Usually you get a EKAHAU_ERR_DEVICE_NOT_RESPONDING error first.

EKAHAU_ERR_UDP_SEND_ERROR

UDP Send Error. Could not send UDP packet

EKAHAU_ERR_AUTH_TIMEOUT

Authentication timeout. HELLO and TALK commands were not sent quickly enough

EKAHAU_ERR_CLIENT_DEVICE_REMOVED

Client Device Removed. Network adapter has been removed from the client device.

EKAHAU_ERR_UNSUPPORTED_PROTOCOL

Unsupported protocol. The requested protocol was not found.

EKAHAU_ERR_PRODUCTION_FAILED

Production Failed. If this occurs, contact Ekahau support.

EKAHAU_ERR_CLIENT_CANNOT_MEASURE_DATA

Client Cannot Measure Data. Ekahau Client can not get signal information from the network adapter.

EKAHAU_ERR_CONTEXT_NOT_FOUND

Location Context Not Found. No location context exists for the requested context ID

EKAHAU_ERR_LICENSE_VIOLATION

License Violation. Too many open sockets for your license.

EKAHAU_ERR_PRODUCER_NOT_RESPONDING

Producer Not Responding. The device which you are trying to track might not be responding. Check that the device is still connected to the network and properly running Ekahau Client. Usually you get -1 error first.

EKAHAU_ERR_DEVICE_LIMIT_EXCEEDED

Device Limit Exceeded. Device limit (how many devices your license allows you to track) is exceeded.

EKAHAU_ERR_DEVICE_NOT_FOUND

Device Not Found. The device has not been detected by the Positioning Engine

EKAHAU_ERR_AGENT_LOOKUP_FAILED

Agent Lookup Failed. If this occurs, contact Ekahau support.

EKAHAU_ERR_EMPTY_MODEL

Empty Model. Create a positioning model with Ekahau Manager and save it to the Positioning Engine

EKAHAU_ERR_ACCESS_DENIED

Access Denied. Authentication was OK, but the connect was refused either because your IP address is not allowed to connect, or because the server is too busy.

EKAHAU_ERR_CONSUMER_NOT_RESPONDING

Consumer Not Responding. The device which you are trying to track might not be responding. Check that the device is still connected to the network and properly running Ekahau Client. Usually you get -1 error first.

EKAHAU_ERR_DEVICE_NOT_RESPONDING

Device Not Responding. No data (any UDP packets) has been received from the device

AUTHOR

Scott Gifford <gifford@umich.edu>, <sgifford@suspectclass.com>

Copyright (C) 2005 The Regents of the University of Michigan.

See the file LICENSE included with the distribution for license information.

SEE ALSO

Ekahau::Response, Ekahau::Base.