QHOLD(1) General Commands Manual QHOLD(1) NAME qhold - hold back Univa Grid Engine jobs from execution SYNTAX qhold [ -h {u|o|s},... ] [ -help ] [ -si session_id ] [ job/task_id_list ] qhold [ -h {u|o|s},... ] [ -help ] [ -si session_id ] -u user_list DESCRIPTION Qhold provides a means for a user/operator/manager to place so called holds on one or more jobs pending to be scheduled for execution. As long as any type of hold is assigned to a job, the job is not eligible for scheduling. Holds can be removed with the qrls(1) or the qalter(1) command. There are three different types of holds: user User holds can be assigned and removed by managers, operators and the owner of the jobs. operator Operator holds can be assigned and removed by managers and oper- ators. system System holds can be assigned and removed by managers only. If no hold type is specified with the -h option (see below) the user hold is assumed by default. An alternate way to assign holds to jobs is the qsub(1) or the qal- ter(1) command (see the -h option). OPTIONS -h {u|o|s},... Assign a u(ser), o(perator) or s(system) hold or a combination thereof to one or more jobs. -help Prints a listing of all options. -si session_id Requests sent by this client to the sge_qmaster(1) daemon will be done as part of the specified session. If the switch is omit- ted or if NONE is specified as session_id then such requests will be executed outside the control of a session. Find more information concerning sessions in session_conf(5). -u username,... Changes are only made on those jobs which were submitted by users specified in the list of usernames. Managers are allowed to use the qhold -u "*" command to set a hold for all jobs of all users. If a user uses the -u switch, the user may specify an additional job/task_id_list. job/task_id_list Specified by the following form: job_id[.task_range][,job_id[.task_range],...] If present, the task_range restricts the effect of the qhold operation to the array job task range specified as suffix to the job id (see the -t option to qsub(1) for further details on array jobs). The task range specifier has the form n[-m[:s]]. The range may be a single number, a simple range of the form n-m or a range with a step size. Instead of job/task_id_list it is possible to use the keyword 'all' to modify the hold state for all jobs of the current user. ENVIRONMENTAL VARIABLES SGE_ROOT Specifies the location of the Univa Grid Engine standard configuration files. SGE_CELL If set, specifies the default Univa Grid Engine cell. To address a Univa Grid Engine cell qhold uses (in the order of precedence): The name of the cell specified in the environment variable SGE_CELL, if it is set. The name of the default cell, i.e. default. SGE_DEBUG_LEVEL If set, specifies that debug information should be writ- ten to stderr. In addition the level of detail in which debug information is generated is defined. SGE_QMASTER_PORT If set, specifies the tcp port on which sge_qmaster(8) is expected to listen for communication requests. Most installations will use a services map entry for the ser- vice "sge_qmaster" instead to define that port. SEE ALSO sge_intro(1), session_conf(5), qalter(1), qrls(1), qsub(1). COPYRIGHT See sge_intro(1) for a full statement of rights and permissions. Univa Grid Engine User Commands UGE 8.5.4 QHOLD(1)