| 1 | {{{ |
| 2 | #!html |
| 3 | <PRE> |
| 4 | <!-- Manpage converted by man2html 3.0.1 --> |
| 5 | |
| 6 | |
| 7 | </PRE> |
| 8 | <H2>SYNOPSIS</H2><PRE> |
| 9 | <B>qalter</B> <I>[<options>]</I> <I><jobid></I> <I>[</I> <I><jobid></I> <I>...</I> <I>]</I> |
| 10 | |
| 11 | |
| 12 | </PRE> |
| 13 | <H2>DESCRIPTION</H2><PRE> |
| 14 | <B>qalter</B> changes properties of jobs already submitted to the queue man‐ |
| 15 | ager |
| 16 | |
| 17 | |
| 18 | </PRE> |
| 19 | <H2>OPTIONS</H2><PRE> |
| 20 | <B>-d</B> <B>--debug</B> |
| 21 | Turn on communication debugging |
| 22 | |
| 23 | <B>--help</B> Displays the usage and a brief descriptions of the options |
| 24 | |
| 25 | <B>--version</B> |
| 26 | Displays client revision and Cobalt version |
| 27 | |
| 28 | <B>-A</B> <B>--project</B> <B>project</B> |
| 29 | Associate the job with the allocation for project project. This |
| 30 | is used to properly account for machine usage. |
| 31 | |
| 32 | <B>--attrs</B> <B><attributes></B> |
| 33 | Modify attributes for jobs in args. Format |
| 34 | (attr1=val1:attr2=val2:...:attrN=valN)' |
| 35 | |
| 36 | <B>--dependencies'</B> |
| 37 | for jobs in args (jobid1:jobid2:..) |
| 38 | |
| 39 | <B>--disable_preboot</B> |
| 40 | If --mode script is specified, this will cause Cobalt to run the |
| 41 | job script without booting the block first. By default the |
| 42 | script is executed after the requested block is booted. |
| 43 | |
| 44 | <B>--enable_preboot</B> |
| 45 | If prebooting a block has been disabled, re-enable it. |
| 46 | |
| 47 | <B>--defer</B> |
| 48 | Defer jobs in the argument list for the current user. |
| 49 | |
| 50 | <B>-e</B> <B>--error</B> <B>stderr</B> <B>file</B> <B>path</B> |
| 51 | Send job stderr to file specified. |
| 52 | |
| 53 | <B>--geometry</B> <B><geometry_spec></B> |
| 54 | Sets the geometry of the block that the jobs should run on. |
| 55 | This is in the form of AxBxCxDxE. This must be the geometry of |
| 56 | the compute block. This may not be a fraction of a block. Geom‐ |
| 57 | etry may be unset if "None" is passed as the geometry specifica‐ |
| 58 | tion. |
| 59 | |
| 60 | <B>-h</B> <B>--held'</B> |
| 61 | hold jobs in args',action='store_true |
| 62 | |
| 63 | <B>--proccount</B> <B>process</B> <B>count</B> |
| 64 | Specify the number of processes to start |
| 65 | |
| 66 | <B>--run_users</B> <B>--user_list</B> <B><user1>:<user2></B> |
| 67 | Sets a colon-separated list of users for the job being submit‐ |
| 68 | ted. All users in this list will be able to execute cobalt com‐ |
| 69 | mands to control the job. The submitting user is always able to |
| 70 | run commands on a submitted job. |
| 71 | |
| 72 | <B>--run_project</B> |
| 73 | Appends the list of users in a project to the list of users |
| 74 | authorized to run commands on the submitted job. |
| 75 | |
| 76 | <B>-t</B> <B>--time</B> <B>wall</B> <B>clock</B> <B>time</B> |
| 77 | Specify the runtime for a job. The time specified is the full |
| 78 | amount in minutes allotted to the job for execution. If the job |
| 79 | runs over this limit, it will be killed. If colon-delimited time |
| 80 | is specified, the format is HH:MM:SS. |
| 81 | |
| 82 | Also note that relative time is allowed. A time argument with a |
| 83 | '+' at the beginning will add the argument amount to the current |
| 84 | walltime, while an argument with a '-' at the beginning will |
| 85 | subtract the argument amount from the current walltime. |
| 86 | |
| 87 | |
| 88 | </PRE> |
| 89 | <H2>SEE ALSO</H2><PRE> |
| 90 | <B><A HREF="http://trac.mcs.anl.gov/projects/cobalt/wiki/qsub.1.html">qsub(1)</A></B>, <B><A HREF="http://trac.mcs.anl.gov/projects/cobalt/wiki/qstat.1.html">qstat(1)</A></B> |
| 91 | |
| 92 | |
| 93 | </PRE> |
| 94 | <H2>BUGS</H2><PRE> |
| 95 | <B><A HREF="http://trac.mcs.anl.gov/projects/cobalt/wiki/qalter.1.html">qalter(1)</A></B> |
| 96 | </PRE> |
| 97 | |
| 98 | }}} |