NAME

       qhold - hold pbs batch jobs

SYNOPSIS

       qhold [-h hold_list] job_identifier ...

DESCRIPTION

       The  qhold command requests that a server place one or more holds on a job.  A job that has a hold is not
       eligible for execution.  There are three supported holds: USER,  OTHER  (also  known  as  operator),  and
       SYSTEM.

       A  user  may  place  a USER hold upon any job the user owns.  An "operator", who is a user with "operator
       privilege," may place ether an USER or an OTHER hold on any job.  The batch administrator may  place  any
       hold on any job.

       If  no  -h  option  is  given,  the USER hold will be applied to the jobs described by the job_identifier
       operand list.

       If the job identified by job_identifier is in the queued, held, or waiting states, then all  that  occurs
       is  that  the  hold type is added to the job.  The job is then placed into held state if it resides in an
       execution queue.

       If the job is in running state, then the following additional action is taken to interrupt the  execution
       of  the job.  If checkpoint / restart is supported by the host system, requesting a hold on a running job
       will (1) cause the job to be checkpointed, (2) the resources assigned to the job will  be  released,  and
       (3) the job is placed in the held state in the execution queue.

       If  checkpoint  /  restart  is not supported, qhold will only set the the requested hold attribute.  This
       will have no effect unless the job is rerun with the qrerun command.

       The qhold command sends a Hold Job batch request to the server as described in the general section.

OPTIONS

       -h hold_list   Defines the types of holds to be placed on the job.

                      The hold_list argument is a string consisting of one or more of the letters "u",  "o",  or
                      "s" in any combination.  The hold type associated with each letter is:

                      u - USER

                      o - OTHER

                      s - SYSTEM

OPERANDS

       The    qhold    command    accepts    one    or    more    job_identifier    operands    of   the   form:
       sequence_number[.server_name][@server]

STANDARD ERROR

       The qhold command will write a diagnostic message to standard error for each error occurrence.

EXIT STATUS

       Upon successful processing of all the operands presented to the qhold command, the exit status will be  a
       value of zero.

       If the qhold command fails to process any operand, the command exits with a value greater than zero.

SEE ALSO

       qrls(1B),      qalter(1B),      qsub(1B),      pbs_alterjob(3B),     pbs_holdjob(3B),     pbs_rlsjob(3B),
       pbs_job_attributes(7B), pbs_resources_unicos8(7B)

Local                                                                                                  qhold(1B)