errno Return Values

invalid create request

The following is an example of an invalid create request: create(“/MYAPP”); 

cannot use type "PSL" with execute() command

For example, you cannot use: execute("PSL", "print(get_vars("/MEMORY"));" );

Instead, you should use: print(get_vars("/MEMORY")); 

unable to find requested environment variable

This error code is useful when you receive an empty return from the getenv() function because it distinguishes between an environment variable that is set to "" and one that does not exist in the environment. 

format argument specified for the history() function has invalid characters

Valid characters are n, t, and/or v. 

fseek() function was used on a pipe channel

The fseek() function only applies to file channels. 

dialog is gone and no queued values are available

No data is available for a non-blocking call.

No two reader processes (such as the read() orreadln() functions) can be blocked on the same channel.

The second reader process that attempts to block the shared channel will fail; in addition, a write() function on a read-blocked channel will also fail.

This helps enforce serialization for shared channels. 

the response_get_value() function is looking for a dynamic response box with an ID number that cannot be located; the response box may have been closed

or

the PSL chart() function used with CHART_PRINT or CHART_DESTROY and ID has been omitted 

Thesnmp() function attempted to use a socket that was already in use

This error may also result from using the snmp_trap_listen() and snmp_open() functions. 

There was an error in the way the function was called; one of the arguments supplied (or not supplied) for the function call was bad.

This error may occur for a variety of reasons. The following are a few of the problems that may generate this error:

• bad object id
• invalid object type
• no object type
• no object value
• required arguments missing
• the non-numeric value supplied on a function that requires a number
•  host name supplied but the host does not exist
• option supplied to a function that supports a limited number of options and the one supplied is not on the list

the parameter is valid but the timestamp was omitted

This indicates that no annotations exist for any value of the parameter in the PATROL Agent history database or the timestamp is specified and no annotation exists for the value of the parameter at that timestamp. 

the va_start()or va_arg() function was used incorrectly

The va_start() and va_arg() functions can only be used in the context of a user-defined function definition. 

The annotate() function was called before any data point was generated.

This occurs when the annotate() function is called before a set() function can set the parameter value. 

could not save annotation information

This occurs when an attempt to save the annotation data fails. The error may be caused by permission restrictions on the history database or as the result of an internal PATROL error. 

maximum number of remote sessions has been reached

This value can be increased/decreased by setting the maxOutboundRemoteSessions variable in the agent configuration file. 

fseek() function was used on a socket channel

The fseek() function applies only to file channels. 

ftell() function was used on a socket channel.

The ftell() function only applies to file channels.