_timeout

#timeout

###Set the timeout for query, secs_query, and port_query functions.

Syntax

status = timeout seconds ;

Arguments

1. int seconds

Number of seconds until timeout occurs.

Return Value

str status

• $ACKNOWLEDGE : Timeout value was set.

The STATUS variable is set to $ACKNOWLEDGE

• %BOUNDS : Invalid timeout seconds.

The STATUS variable is set to %BOUNDS

Warnings

• %BOUNDS : Invalid timeout seconds.

Exceptions

• %ARGUMENT: Invalid arguments. Usage: status = timeout seconds ;

Description

A timeout value can be set at any point before the query. When the query function is executed. the timer is started. If the timer expires before a reply message is received, then a timeout event is triggered. The query function will return with the STATUS value set to "%TIMEOUT".

Examples

puts "Create an example for the function 'timeout'" ;

Related Links

None