Chapter Contents

Previous

Next
TIMEOUT

TIMEOUT



Sets the amount of time that the local host waits for a packet from the remote host before re-sending the last local host packet

TELNET


Syntax
Syntax Description

Syntax

TIMEOUT n SECONDS;

Syntax Description

n
specifies the packet time-out period.

Details

The TIMEOUT statement specifies the amount of time that the local host waits for a packet of data from the remote host. This is also called the packet time-out period. A time-out is an error condition that is produced when a response is not received within a specified time period. When a time-out occurs, the link either

n specifies the packet time-out period. When the value of n is 0, the time-out period is 0; that is, the local host waits indefinitely for a data packet from the remote host. If you use the script to run the link interactively, the recommended TIMEOUT value is 0. If the remote host appears not to be responding, you can issue a break signal (usually CTRL-C) to interrupt the time-out. Abort the link and try to sign on again. Do not use this process unless you are sure that the remote host is not responding.

The default value for TIMEOUT is 0. SECOND is an alias for SECONDS.

If the time-out period specified is too short, a time-out may occur before the remote host can respond to the local host. In this case, a packet re-sent by the local host is discarded by the remote host. If the time-out period specified is too long, the system may wait longer than necessary before responding to errors that result from an unstable communications line.

The best reason for re-setting the TIMEOUT value to something other than 0 is when the local host needs to run unattended. In this case, set TIMEOUT to a value greater than the maximum time that the remote host needs to respond to a request from the local host. For example, if you remote-submit a PROC step that requires 2 minutes for the remote host to complete, the TIMEOUT value must be at least 120 seconds. See also MAXI and MAXO statements.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.