www.delorie.com/gnu/docs/uucp/uucp_69.html

search

	Buy GNU books!

Taylor UUCP

5.7.3.1 When to Call

time string [number]

Specify when the system may be called. The first argument is a time string; see 5.4 Time Strings. The optional second argument specifies a retry time in minutes. If a call made during a time that matches the time string fails, no more calls are permitted until the retry time has passed. By default an exponentially increasing retry time is used: after each failure the next retry period is longer. A retry time specified in the time command is always a fixed amount of time.

The time command may appear multiple times in a single alternate, in which case if any time string matches the system may be called. When the time command is used for a particular system, any time or timegrade commands that appeared in the system defaults are ignored.

The default time string is `Never'.

timegrade character string [number]

The character specifies a grade. It must be a single letter or digit. The string is a time string (see section 5.4 Time Strings). All jobs of grade character or higher (where 0 > 9 > A > Z > a > z) may be run at the specified time. An ordinary time command is equivalent to using timegrade with a grade of z, permitting all jobs. If there are no jobs of a sufficiently high grade according to the time string, the system will not be called. Giving the `-s' switch to uucico to force it to call a system causes it to assume there is a job of grade 0 waiting to be run.

The optional third argument specifies a retry time in minutes. See the time command, above, for more details.

Note that the timegrade command serves two purposes: 1) if there is no job of sufficiently high grade the system will not be called, and 2) if the system is called anyway (because the `-s' switch was given to uucico) only jobs of sufficiently high grade will be transferred. However, if the other system calls in, the timegrade commands are ignored, and jobs of any grade may be transferred (but see call-timegrade and called-timegrade, below). Also, the timegrade command will not prevent the other system from transferring any job it chooses, regardless of who placed the call.

The timegrade command may appear multiple times without using alternate. When the timegrade command is used for a particular system, any time or timegrade commands that appeared in the system defaults are ignored.

If this command does not appear, there are no restrictions on what grade of work may be done at what time.

max-retries number

Gives the maximum number of times this system may be retried. If this many calls to the system fail, it will be called at most once a day whatever the retry time is. The default is 26.

success-wait number

A retry time, in seconds, which applies after a successful call. This can be used to put a limit on how frequently the system is called. For example, an argument of 1800 means that the system will not be called more than once every half hour. The default is 0, which means that there is no limit.

call-timegrade character string

The character is a single character A to Z, a to z, or 0 to 9 and specifies a grade. The string is a time string (see section 5.4 Time Strings). If a call is placed to the other system during a time which matches the time string, the remote system will be requested to only run jobs of grade character or higher. Unfortunately, there is no way to guarantee that the other system will obey the request (this UUCP package will, but there are others which will not); moreover, job grades are historically somewhat arbitrary, so specifying a grade will only be meaningful if the other system cooperates in assigning grades. This grade restriction only applies when the other system is called, not when the other system calls in.

The call-timegrade command may appear multiple times without using alternate. If this command does not appear, or if none of the time strings match, the remote system will be allowed to send whatever grades of work it chooses.

called-timegrade character string

The character is a single character A to Z, a to z, or 0 to 9 and specifies a grade. The string is a time string (see section 5.4 Time Strings). If a call is received from the other system during a time which matches the time string, only jobs of grade character or higher will be sent to the remote system. This allows the job grade to be set for incoming calls, overriding any request made by the remote uucico. As noted above, job grades are historically somewhat arbitrary, so specifying a grade will only be meaningful if the other system cooperates in assigning grades. This grade restriction only applies to jobs on the local system; it does not affect the jobs transferred by the remote system. This grade restriction only applies when the other system calls in, not when the other system is called.

The called-timegrade command may appear multiple times. If this command does not appear, or if none of the time strings match, any grade may be sent to the remote system upon receiving a call.