QMOD(1MDQS)             COMMAND REFERENCE             QMOD(1MDQS)



NAME
     qmod - modify, hold, or delete a queued MDQS request

SYNOPSIS
     qmod [ -a atime ] [ -c count ] [ -f form ] [ -h ] [ --h ] [
     -k ] [ -m ] [ --m ]
     [ -p priority ] [ -q queue ] [user.]job# ...

DESCRIPTION
     Qmod modifies or deletes MDQS requests.  Only request
     parameters that are common to all types of requests can be
     changed.

     The command qstat(1mdqs) is used to obtain request
     identification.  To specify a request submitted by the
     current user, it is necessary only to specify the job
     number.  Only the superuser, the mdqs user, or a member of
     the systems group can modify a request submitted by other
     than the current user; in this case he or she must specify a
     request in the form user.job#.

OPTIONS
     -a atime
        Changes the start time on the job to the time specified.
        It is illegal to change the start time to sometime
        earlier than the submit time.  See getdate(5mdqs) for a
        description of time formats.

     -c copies
        Changes the number of copies requested to copies.

     -f forms
        Changes the forms for the request to the new value,
        forms.

     -h Places a hold to be put on the specified requests.  A
        held request keeps its place in the queue; another job
        can jump ahead of the held request if the held request is
        at the beginning of the queue.

     --h
        Removes a hold from the specified requests.

     -k Causes the requests specified to be killed (deleted).

     -m Adds the notification upon completion option to the
        requests.

     --m
        Removes mail notification upon completion.

     -p priority



Printed 5/12/88                                                 1

QMOD(1MDQS)             COMMAND REFERENCE             QMOD(1MDQS)



        Changes the priority of requests.  Only the superuser,
        the mdqs user or a member of the systems group may
        request a priority of 0.

     -q queue
        Changes the queue for the specified request to the new
        queue specified.  The request is then sorted into the
        queue in accordance with its submit time and priority.

EXAMPLES
     The first example will kill job 5 for the current user.  The
     second example will change the forms requested for jobs 6
     and 7 to wide paper, assuming either a system administrator
     or jondoe is submitting the modification.  Request id's (for
     example, jondoe.5, jondoe.6, and jondoe.7) are obtained from
     the program qstat.

          qmod -k 5
          qmod -f wide jondoe.6 jondoe.7

FILES
     etc/mdqsd        MDQS daemon

     /usr/spool/q     Top of spooling directory tree

     /etc/qconf       Configuration information for MDQS

     /usr/lib/mdqs/forms
                      List of available forms

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_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

SEE ALSO
     qstat(1mdqs), forms(5mdqs), mdqsd(8mdqs), and lprm(1mdqs).







Printed 5/12/88                                                 2

%%index%%
na:336,104;
sy:440,560;
de:1000,741;
op:1741,1289;3438,389;
ex:3827,606;
fi:4433,355;
rv:4788,665;
se:5453,225;
%%index%%000000000145