Hylafax jobcontrol

Материал из OpenWiki
Перейти к: навигация, поиск

оригинал данного руководства на английском: http://hylafax.sourceforge.net/man/jobcontrol.php


jobcontrols - Механизм изменения параметров отдельно каждого задания


Описание

Параметр конфигурации HylaFAX JobControlCmd определяет скрипт, который используется, чтобы изменить параметры конкретного задания, например с учетом дневного или ночного времени отправки.

Скрипту передается соответствующий идентификационный номер работы как первый и единственный аргумент.

Результатом работы программы должна быть ASCII последовательность, содержащая текстовые строки вида:

    param: value 

Значения параметров должны быть в таком же формате как и в других конфигурационные файлы HylaFax, то есть значения могут быть заключены в кавычки (""). Все что находится в строке после "#" игнорируется. Порядок следования значений важен. Последняя установка параметра перекрывает все предыдущие установки этого параметра. Если значение не определено - используется значение по умолчанию этого параметра и файла конфикурации faxq.

Ниже перечислены основные параметры которые относятся к параметрам отдельных заданий. Подробное описание можно найти в документации HylaFax.config (русс) кроме параметров Modem,Priority и RejectNotice которые описаны ниже.

Параметр Тип Признака По умолчанию Описание
MaxConcurrentCalls integer 1 max параллельное рабочее место обработать для предназначения
MaxDials integer unlimited Целое число неограниченные max телефонные звонки сделать, чтобы передать работу
MaxSendPages integer unlimited max страницы, чтобы разрешить в посылании
MaxTries integer 3 max пытается передать работу
Modem string Any Любой ModemGroup, чтобы использовать для предназначения
Notify string - уведомление отвергает для работы
Priority integer - приоритет использовать для работы
RejectNotice string - уведомление отклонения для передает работу
TimeOfDay string Any ограничения времени-дневного по умолчанию
VRes integer - Вертикальное решение
UseXVRes integer - Использование расширенных решений



Параметр Modem определяет через какую группу модемов (ModemGroup) должно отправляться задание. Если пользователь назначает ModemGroup для определенного задания, где все модемы - за пределами этого ModemGroup, значение параметра Modem игнорируется и перекрывается назначением пользователя. Аналогично, если пользователь назначает ModemGroup для определенной работы, где некоторые, но не все, модемы включены в этот ModemGroup, тогда значение Modem станет содержащим набором модемов, найденных в обоих.

Зарегистрировать параметр позволяет, что отвергание любого уведомления просит клиента, которого требуют в работе. Варианты не "ни один", "когда повторно стоящийся в очереди", "когда сделано", и "когда done+requeued". The Notify parameter allows an override of whatever notification request the client requested in the job. Options are ``none, ``when requeued, ``when done, and ``when done+requeued.

Параметр Приоритета управляет приоритетом назначить на работу. Это отвергает любой приоритет, который требует submitter. The Priority parameter controls the priority to assign to the job. This overrides any priority requested by the submitter.

Параметр RejectNotice управляет, отклонить ли рабочие места к предназначению. Рабочие места, которые отклонены, сделаны так, не помещая телефонный звонок, и связанное сообщение возвращено к работе submitter. Это средство может использоваться, чтобы отвергнуть звонящие чувствительные телефонные номера; например The RejectNotice parameter controls whether or not to reject jobs to the destination. Jobs that are rejected are done so without placing a phone call and the associated message is returned to the job submitter. This facility can be used to disallow calling sensitive phone numbers; for example

   RejectNotice: "Звонки в экстренные телефоны не разрешены"RejectNotice: "Calls to emergency numbers are not permitted"

Параметр VRes управляет вертикальным решением. Возможные ценности 98 (нормальное решение, эквивалентное sendfax-l выбор) и 196 (высокое разрешение, эквивалентное sendfax-m выбор). The VRes parameter controls the vertical resolution. Possible values are 98 (normal resolution, equivalent to sendfax -l option) and 196 (fine resolution, equivalent to sendfax -m option).

Параметр UseXVRes используется, чтобы позволить или повредить использование расширенных решений, поддержанных приемником. Возможные ценности 1 (позвольте расширенное использование решений, эквивалентное sendfax-G выбор), и 0 (повреждают расширенное использование решений). Этот параметр заменяет использование VRes. The UseXVRes parameter is used to enable or disable the usage of extended resolutions supported by the receiver. Possible values are 1 (enable extended resolutions usage, equivalent to sendfax -G option) and 0 (disable extended resolutions usage). This parameter supersedes the usage of VRes.

В дополнение к вышеупомянутым параметрам любые другие параметры, которые определены, автоматически накоплены и переданы к программам, призванным faxq, таким как faxsend и pagesend. (Отметьте, что в случае пакетных заданий, что эти параметры будут относиться ко всем рабочим местам в партии.) Это - удобный механизм для того, чтобы определить параметры конфигурации для всех модемов, не имея необходимость изменять каждый определенный для модема файл конфигурации. Например, In addition to the above parameters, any other parameters that are specified are automatically accumulated and passed to programs invoked by faxq, such as faxsend and pagesend. (Note that in a batched-jobs instance that these parameters will apply to all jobs in the batch.) This is a convenient mechanism for defining configuration parameters for all modems without having to modify each modem-specific configuration file. For example,

   SessionTracing: 0x4fSessionTracing: 0x4f

Этот механизм также облегчает управлять, передают связанные параметры согласно телефонному номеру предназначения. Например, чтобы повредить использование ECM и ограничить передать скорость, помещая международные телефонные звонки можно было бы использовать: This mechanism also makes it easy to control transmit-related parameters according to the destination phone number. For example, to disable use of ECM and restrict the transmit speed when placing international phone calls one might use:

   DesiredBR: 3DesiredBR: 3
   DesiredEC: 0DesiredEC: 0
   DesiredDF: 1DesiredDF: 1


ПРИМЕРЫEXAMPLES Изменение (наложение) параметр MaxDials к 3 для всех исходящих звонков. Change (overlap) MaxDials parameter to 3 for all outgoing calls.

1. Создайте файл bin/jobcontrol со следующим содержанием: 1. Create file bin/jobcontrol with the following content:

  #!/bin/sh#!/bin/sh
  повторите "MaxDials: выход 0echo "MaxDials:    exit 0

2. Гарантируйте, что bin/jobcontrol отмечен как выполнимый: 2. Ensure that bin/jobcontrol is marked as executable:

   chmod +x bin/jobcontrolchmod +x bin/jobcontrol

3. Добавьте параметр JobControlCmd к hylafax-config (5F); (etc/config) файл: 3. Add parameter JobControlCmd to hylafax-config(5F); (etc/config) file:

   JobControlCmd: bin/jobcontrolJobControlCmd: bin/jobcontrol

Программа средств управления вероятно должна будет отнестись к sendq файлу, соответствующему работе, чтобы получить информацию, такую как набранный номер, владелец работы, или число посылает попытки. С этой целью функция parseQfile была помещена в bin/common-functions, чтобы помочь в этом. Например: The controls program will likely need to refer to the sendq file corresponding to the job in order to obtain information such as the number being dialed, the job owner, or the number of send attempts. For this purpose the parseQfile function has been placed in bin/common-functions to assist in this. For example:

   #!/bin/sh#!/bin/sh
   . etc/setup.cacheetc/setup.cache
   . bin/common-functionsbin/common-functions
   1 QFILE=sendq/q$QFILE=sendq/q$1
   parseQfileparseQfile
   случай "$tottries $owner-$number-" вcase "$number-$owner-$tottries" in
       5551212-lee-3), повторяют "Class1ECMSupport: нет";;5551212-lee-3) echo "Class1ECMSupport: no";;
       *-sam-*), повторяют "LocalIdentifier: +1.800.555.1212";;*-sam-*) echo "LocalIdentifier: +1.800.555.1212";;
       911-*), повторяют "RejectNotice: \"Призывает 911, не разрешены \"";;911-*) echo "RejectNotice: \"Calls to 911 are not permitted\"";;
   esacesac
   выход 0exit 0


ПРИМЕЧАНИЯNOTES JobControlCmd управляют каждый раз шаги работы в очередь пробега ("ГОТОВОЕ" государство), и вся продукция эффективна на каждом случае. Если администратор желает изменить продукцию, основанную на последовательности попытки, то с ценностями q-файла нужно консультироваться в процессе. Кроме того, обычай вариантов, таких как Приоритет мог быть запутывающим, поскольку это будет по существу препятствовать работе увеличиться или уменьшиться в приоритете работы как обычно ожидающийся после попыток требования. JobControlCmd is run each time the job moves into the run-queue ("READY" state), and all output is effective on each instance. If the administrator wishes to vary output based on the attempt sequence, then the q-file values should be consulted in the process. Furthermore, blind usage of options such as Priority could be confusing as it would essentially prevent a job from increasing or decreasing in job priority as usually expected after call attempts. СМ. ТАКЖЕSEE ALSO faxq (8C), hylafax-config (5F), re_format (7).