Learn more about Platform products at http://www.platform.com

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]



brequeue


Kills and requeues a job

SYNOPSIS

brequeue [-J job_name | -J "job_name[index_list]"] [ -u user_name | -u all ] [ job_ID | "job_ID[index_list]"] [-d] [-e] [-r] [-a] [-H]

brequeue [-h | -V]

DESCRIPTION

You can only use brequeue on a job you own, unless you are root or an LSF administrator.

Kills a running (RUN), user-suspended (USUSP), or system-suspended (SSUSP) job and returns it to the queue. A job that is killed and requeued retains its submit time but is dispatched according to its requeue time. When the job is requeued, it is assigned the PEND status or PSUSP if the -H option is used. Once dispatched, the job starts over from the beginning. The requeued job keeps the same job ID.

Use brequeue to requeue job arrays or elements of them.

By default, kills and requeues your most recently submitted job when no job_ID is specified.

With MultiCluster, you can only use brequeue on jobs in local queues. A job that is killed and requeued is assigned a new job ID on the cluster in which it is executed, but it retains the same job ID on the cluster from which it was submitted. For example, a job from cluster A that is killed and requeued and then run on cluster B will be assigned a new job ID on cluster B. However, when the bjobs command is used from cluster A, the submitting cluster, the job will be displayed with the original job ID. When the bjobs command is used from cluster B, the execution cluster, the job will be displayed with the new job ID.

OPTIONS

-J job_name | -J "job_name[index_list]"

Operates on the specified job.

Since job names are not unique, multiple job arrays may have the same name with a different or same set of indices.

-u user_name | -u all

Operates on the specified user's jobs or all jobs.

Only root and an LSF administrator can requeue jobs submitted by other users.

job_ID |"job_ID[index_list]"

Operates on the specified job or job array elements.

The value of 0 for job_ID is ignored.

-d

Requeues jobs that have finished running with DONE job status.

-e

Requeues jobs that have terminated abnormally with EXIT job status.

-r

Requeues jobs that are running.

-a

Requeues all jobs including running jobs, suspending jobs, and jobs with EXIT or DONE status.

-H

Requeues jobs to PSUSP job status.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

LIMITATIONS

brequeue cannot be used on interactive batch jobs; brequeue only kills interactive batch jobs, it does not restart them.

[ Top ]


[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]


      Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.