share/man/man1/atq.1

   1 '\" te
   2 .\" Copyright 1989 AT&T
   3 .\" Copyright (c) 1985 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   4 .\" Copyright (c) 1999 Sun Microsystems, Inc., All Rights Reserved.
   5 .TH ATQ 1 "Aug 13, 1999"
   6 .SH NAME
   7 atq \- display the jobs queued to run at specified times
   8 .SH SYNOPSIS
   9 .LP
  10 .nf
  11 \fBatq\fR [\fB-c\fR] [\fB-n\fR] [\fIusername\fR]...
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 The \fBatq\fR utility displays the \fBat\fR jobs queued up for the current
  18 user. \fBat\fR(1) is a utility that allows users to execute commands at a later
  19 date. If invoked by a user with the \fBsolaris.jobs.admin\fR authorization,
  20 \fBatq\fR will display all jobs in the queue.
  21 .sp
  22 .LP
  23 If no options are given, the jobs are displayed in chronological order of
  24 execution.
  25 .sp
  26 .LP
  27 When an authorized user invokes \fBatq\fR without specifying \fIusername\fR,
  28 the entire queue is displayed; when a \fIusername\fR is specified, only those
  29 jobs belonging to the named user are displayed.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The following options are supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-c\fR\fR
  38 .ad
  39 .RS 6n
  40 Displays the queued jobs in the order they were created (that is, the time that
  41 the \fBat\fR command was given).
  42 .RE
  43
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-n\fR\fR
  48 .ad
  49 .RS 6n
  50 Displays only the total number of jobs currently in the queue.
  51 .RE
  52
  53 .SH FILES
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB/var/spool/cron/atjobs\fR\fR
  58 .ad
  59 .RS 26n
  60 spool area for at jobs.
  61 .RE
  62
  63 .SH SEE ALSO
  64 .sp
  65 .LP
  66 \fBat\fR(1), \fBatrm\fR(1), \fBauths\fR(1), \fBcron\fR(8), \fBauth_attr\fR(4),
  67 \fBattributes\fR(5)