The FTimes Project The HashDig Project The WebJob Project The PaD Project
Location: / Home / WebJob / Man Pages / webjob-jqd-change-state
Man Pages
WebJob
Home
                                                                                                                                                                                                       


NAME

webjob-jqd-change-state - Change the state of the specified queues or jobs.


SYNOPSIS

webjob-jqd-change-state [-d jqd-dir] [-e queue[,queue[...]]] [-G group-file] -i queue[,queue[...]] [-j {job-regex-file|-}] [-l log-file] [-t type] -s old-state-list:new-state [job-regex [job-regex ...]]


DESCRIPTION

This utility changes the state of the specified queues or jobs.


OPTIONS

-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 job assignment. 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 job assignment. Note that group names must be prefixed with '%'. For example, a group called 'test' must be specified as '%test'.

-j job-regex-file

Specifies a file containing job regular expressions -- one per line. These regular expressions are processed after those specified on the command line.

-l log-file

Specifies an alternate log file. The default value is /var/webjob/logfiles/jqd.log.

-s old-state-list:new-state

Change specified queues or jobs in one of the old states to the new state. The list of old states must adhere to the following format:

    {any|state[,state[...]]}

Currently, the following queue states are supported: 'active', 'frozen', and 'locked'.

Currently, the following job states are supported: 'hold', 'todo', 'sent', 'open', 'done', 'pass', 'fail', and 'foul'.

When specifying the old state value, you may use the keyword 'any' as an alias for all states. The new state value must be a single, valid state for the specified state type. Note that some state transitions may not be allowed.

-t type

Specifies the type of state, 'queue' or 'job', to change. The value for this option is not case sensitive. The default value is 'job'.


AUTHOR

Klayton Monroe


SEE ALSO

webjob-jqd-create-job(1), webjob-jqd-change-priority(1), webjob-jqd-delete-job(1), webjob-jqd-list-jobs(1)


LICENSE

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

Copyright 2000-2014 The WebJob Project, All Rights Reserved.
The FreeBSD Project SourceForge Logo KoreLogic, Inc.