@'

NAME
       admidisched - manage administrative command queue

SYNOPSIS
       admidisched -o delete [ -h host ... ] [ -qv ] job ...

       admidisched -o list [ -h host ... ] [ -qv ] [ job ...  ]

DESCRIPTION
       The admidisched command provides management capabilities for the
       idisched(1M) job queue.  The idisched job queue is a list of commands
       scheduled to run on remote hosts once the remote host(s) can be
       contacted.  Commands are placed on the idisched job queue by idi(1)
       or idiexec(1M) when idi (or idi_exec) can not run the submitted
       command on the remote host.  Jobs are automatically removed from the
       queue by idisched after successful execution or when the job has been
       in the queue too long.  admidisched allows the user to list the job
       queue and to manually delete jobs from the queue.

   Operations
       delete    Remove one or more scheduled commands from the idisched job
                 queue.

       list      Display the idisched job queue.  Default for job parameter
                 is all.

   Options
       -h host   Only manipulate jobs scheduled for execution on specified
                 host or list of hosts.  For a list of hosts, separate hosts
                 using spaces and/or commas.  When the -h option is not
                 specified, the operation will be performed for all hosts on
                 which remote commands are scheduled.

       -q        Quiet. When used with the list operation, produce an
                 unformatted listing (i.e. no headers, fields delimited by a
                 single space). Suppress confirmation prompts when used with
                 the delete operation. This option should be specified for
                 the delete operation if the command is embedded in a shell
                 script for which confirmation messages are not desired.

       -v        Verbose. When used with the list operation, produce a
                 formatted listing with headers and aligned columns.
                 Provide confirmation prompts when used with the delete
                 operation.  This option is enabled by default.

EXAMPLES
       List jobs 9 and 10 for all hosts in the idisched job queue.

                   admidisched -o list 9 10


       List all jobs scheduled for execution on hosts ´mach1´ and ´mach2´.

                   admidisched -o list -h "mach1 mach2"


       Delete jobs 9 and 10 scheduled for execution on hosts ´mach1´ and
       ´mach2´.

                   admidisched -o delete -h "mach1 mach2" 9 10


       Delete all jobs scheduled for remote execution on host ´mach 3´.

                   admidisched -o delete -h mach3 all

DIAGNOSTICS
   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       idi(1), idisched(1M), idid(1M),