'\" t
.\" @(#)lmat.1m	1.3 01 Oct 1998 SMI
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
.\" Copyright (c) AT&T 1997. All rights reserved. 
.\" @(#)at.rof	1.3 9/23/96
.TH lmat 1m "18 Mar 1997"
.if n .tr \--
.SH "NAME"
lmat - schedules commands or programs to run on a server at a specified time or date.  (Note that there also exists an MS-DOS at
command.)
.SH "SYNOPSIS"
.nf
.ft 4
lmat [id] [/delete]
lmat time [/every:date[,...] | /next:date [,...]] command 
.ft
.SH DESCRIPTION
Use the lmat command to run commands at regularly scheduled intervals.
To display a list of scheduled commands, type lmat without options.
Commands scheduled with the lmat utility run as background processes;
no output is displayed at the server.
.P
To redirect the output to a file, use the redirection symbol ( > )
and the full path name. If you redirect output to a file,
enclose the command you are scheduling in quotation marks.
.P
Scheduled tasks are not lost if you stop the server, but
the server must be running at the time the commands are scheduled to execute.
.SH OPTIONS
.SS id
An identification number assigned to a scheduled command.
.SS time
Specifies the time when command is to run.  It is expressed
as hours:minutes in a 24-hour notation (00:00 [midnight] through 23:59).
.SS command
Specifies the command that is to run on the Advanced Server.
When the command requires a path name as an argument,
use the absolute path name.  
.SS /delete
Cancels a scheduled command.  If id is omitted, all scheduled commands on the server are canceled.
.SS /every:date[,...]
Runs the command on each specified day(s) of the week or month.
Specify date as one or more days of the week (M, T, W, Th, F, S, Su)
or one or more days of the month (using numbers 1 through 31).
Separate multiple date entries with a comma.  If date is omitted,
the current date is assumed.
.SS /next:date[,...]
Runs the command on the next occurrence of the day.
Specify date as one or more days of the week (M, T, W, Th, F, S, Su)
or one or more days of the month (using numbers 1 through 31).
Separate multiple date entries with a comma.  If date is omitted,
the current date is assumed.
.SH EXAMPLES
To display a list of commands scheduled on the server, type the following command:
.sp.5
	net admin \e\eservername /command lmat 
.sp.5
To learn more about a command with the identification number 3, type the following command:
.sp.5
	net admin \e\eservername /command lmat 3
.sp.5
To cancel all commands scheduled on a server, clear the lmat schedule by typing the following command:
.sp.5
	net admin \e\eservername /command lmat /delete.SF