qmod(1MDQS) — UTek W2.3



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
          Changes the priority of requests.  Only the superuser,
          the mdqs user or a member of the systems group may



Printed 10/17/86                                                1



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



          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), lprm(1mdqs).









Printed 10/17/86                                                2

%%index%%
na:72,88;
sy:160,424;
de:584,681;
op:1265,1322;2731,267;
ex:2998,555;
fi:3553,342;
rv:3895,621;
se:4516,195;
%%index%%000000000142

Museum

Related Articles