BATCH(1MDQS)            COMMAND REFERENCE            BATCH(1MDQS)



NAME
     batch - MDQS batch command spooler

SYNOPSIS
     batch [ -a atime ] [ -m ] [ -o outfile ] [ -p priority ] [
     -q queue ] [ -s shell ]
     [ -u useraddr ] [ -v ] [ -R ruser ] [ commandfile ]

DESCRIPTION
     Batch is used to queue command files to be run by the
     Multi-Device Queueing System (MDQS).  The command files are
     basically shellfiles.  They can contain a single command or
     a series of commands.  If the commandfile argument is
     omitted, the commands are read from the standard input.  The
     batch command tries to record the environment that the user
     was in when the batch command was invoked, including
     exported shell variables and the current working directory.

     Batch is part of the MDQS.  Once the request has been
     queued, it can be modified or deleted using the qmod
     program, and the current status determined using the qstat
     program.

OPTIONS
     -a atime
        Do not start this request until after atime.  For the
        format of time specifications, see getdate(5mdqs).

     -m Cause a message to be generated upon the completion of
        the batch request and sent via mail(1mh) to the
        requesting user.

     -o outfile
        Causes the standard output and error output
        (filedescriptors 1 and 2) of the batch job to be
        redirected to the named file.

     -p priority
        Allows one to give a request a priority other than the
        default.  The default priority is in the middle of the
        range 0-10.  Only the superuser, the mdqs user or a
        member of the systems groups may request a priority of 0.

     -q queue
        Allows one to queue a request to a queue other than the
        default.  Queueing a request to other than a batch queue
        will give unpredictable results.

     -R ruser
        When a batch request is to execute on a remote host MDQS
        normally requires the requesting local user name to exist
        on the remote host with rsh(1n) privileges.  This option



Printed 4/6/89                                                  1

BATCH(1MDQS)            COMMAND REFERENCE            BATCH(1MDQS)



        allows one to specify another user on the remote host for
        rsh(1n) privileges.

     -s shell
        Causes the program shell to be used as the shell to
        interpret the command file instead of the default.  When
        the commands are read from standard input the default
        shell is the one specified by the environmental variable
        SHELL, if it is available.  Otherwise the default shell
        is (/bin/sh).

     -u useraddr
        Overrides the default notification address with the
        address useraddr. This address should be a valid address
        to your mailsystem.  The default notification address is
        the name of the invoker on the current host.

     -v Normally the batch command does its work silently.  The v
        (verbose) option makes batch acknowledge that the request
        has been queued and prints the request number.

FILES
     /usr/lib/mdqs/queue2
                      Second stage queuer

     /etc/mdqsd       MDQS daemon

     /usr/spool/q     Top of spooling directory tree

     /usr/lib/mdqs/shserver
                      Program called by the daemon to run shell

     /etc/qconf       Configuration information for MDQS

VARIABLES
     SHELL          The user's login shell.

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.



Printed 4/6/89                                                  2

BATCH(1MDQS)            COMMAND REFERENCE            BATCH(1MDQS)



     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

SEE ALSO
     qstat(1mdqs), qmod(1mdqs), getdate(5mdqs), mdqsd(8mdqs), and
     rsh(1n).
















































Printed 4/6/89                                                  3

%%index%%
na:360,86;
sy:446,578;
de:1024,1033;
op:2057,1426;3915,1039;
fi:4954,483;
va:5437,145;
rv:5582,662;6676,173;
se:6849,296;
%%index%%000000000155