ILANTIMEOUT(3)

HP-UX

NAME

ilantimeout − sets LAN client response wait time

SYNOPSIS

#include <sicl.h>

int ilantimeout (id, tval);
INST id;
long tval;

DESCRIPTION

Ilantimeout sets the length of time that the application (LAN client) will wait for a response from the LAN server. Once an application has manually set the LAN timeout via this function, the software will no longer attempt to determine the minimum LAN timeout which should be used. Instead, the software will simply use the value set via this function. In this function, tval defines the timeout in milliseconds. A value of zero (0) disables timeouts.

Not all computer systems can guarantee an accuracy of one millisecond on timeouts. Some computer clock systems only provide a resolution of 1/50th or 1/60th of a second. Other computers have a resolution of only 1 second. Note that the time value is always rounded up to the next unit of resolution.

This function does not affect the SICL timeout value set via the itimeout function. The LAN server will attempt the I/O operation for the amount of time specified via itimeout before returning a response.

If the SICL timeout used by the server is greater than the LAN timeout used by the client, the client may timeout prior to the server, while the server continues to service the request. This use of the two timeout values is not recommended, since under this situation the server may send an unwanted response to the client.

RETURN VALUE

This function returns zero (0) if successful, or a non-zero error number if an error occurs.

AUTHOR

ilantimeout was developed by HP.

Hewlett-Packard Comapny — September 29, 1999

Museum