NAME

webjob-jqd-list-jobs - List jobs in the specified job queues and states.

SYNOPSIS

webjob-jqd-list-jobs [-aS] [-d jqd-dir] [-e queue[,queue[...]]] [-G group-file] [-s {all|state[,state[...]]}] -i queue[,queue[...]] job-regex [job-regex ...]

DESCRIPTION

This utility lists jobs in the specified job queues and states. Each job-regex argument is intepreted as a Perl regular expression.

OPTIONS

-a

Print statistics for all queues -- even if the tally for each job state is zero. This option has no effect unless -S is specified as well.

-d jqd-dir

Specifies the base directory where queues live. This directory must exist. The default value is /var/webjob/spool/jqd.

-e queue[,queue[...]]

Specifies one or more queues or queue groups that are to be excluded from the operation. Note that group names must be prefixed with '%'. For example, a group called 'test' must be specified as '%test'.

-G group-file

Specifies an alternate group file. The default group file is /var/webjob/config/jqd/groups.

-i queue[,queue[...]]

Specifies one or more queues or queue groups that are to be included in the operation. Note that group names must be prefixed with '%'. For example, a group called 'test' must be specified as '%test'.

-S

List job statistics about (rather than jobs in) the specified queues. Currently, this option prints the number of jobs in each job state.

-s {all|state[,state[...]]}

Restrict output to the specified list of job states. Currently, the following states are supported: 'hold', 'todo', 'sent', 'open', 'done', 'pass', 'fail', and 'foul'. You may also use the keyword 'all' as an alias for all states.

AUTHOR

Klayton Monroe

SEE ALSO

webjob-jqd-create-job(1), webjob-jqd-delete-job(1)

LICENSE

All documentation and code are distributed under same terms and conditions as WebJob.