---
name: "jobcontrol"
section: "8"
platform: "linux"
package: "hylafax-server"
version: "3:6.0.7-11.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/jobcontrol"
---

# jobcontrol(8)

per-job controls for HylaFAX servers

## NAME

jobcontrols - per-job controls for *HylaFAX* servers

## DESCRIPTION

The *HylaFAX* configuration parameter **JobControlCmd** specifies the script that is used to apply  per-job controls on job characteristics such as the time-of-day to place a call.

The controls program should produce a simple line-based ASCII output containing a series of records of the form:

param: value

which is parsed the same manner as all HylaFAX config files. Parameter values are parsed exactly as specified in [*hylafax-config*(5)](/hylafax-config/5.md); i.e. values with embedded whitespace may be enclosed in quote marks (\`\`"'').

Comments are introduced with a \`\`#'' character and extend to the end of the line.

The order of entries in the output is important. The last parameter value overrides any previous values. If the requested parameter is defined in the output, then the last value is returned, otherwise a default value is used from the *faxq* configuration file.

The following parameters may be specified on a per-job basis; consult [*hylafax-config*(5)](/hylafax-config/5.md) for a description of each parameter (except **RejectNotice** which is described below).

```
Tag	Type	Default	Description
MaxConcurrentCalls	integer		max concurrent jobs to process for a destination
MaxDials	integer	unlimited	max phone calls to make to transmit a job
MaxSendPages	integer	unlimited	max pages to permit in a send
MaxTries	integer		max attempts to transmit a job
Modem	string	Any	ModemGroup to use for destination
RejectNotice	string	-	rejection notice for transmit job
TimeOfDay	string	Any	default time-of-day restrictions
VRes	integer	-	Vertical resolution
UseXVRes	integer	-	Usage of extended resolutions
```

The **Modem** parameter controls which **ModemGroup** is used in sending faxes to the destination.  If the user assigns a **ModemGroup** for a specific job where all modems are outside of this **ModemGroup** matching a destination, then the value of **Modem** is overridden by the user's assignment.  Likewise, if the user assigns a **ModemGroup** for a specific job where some, but not all, of the modems are included in this **ModemGroup** matching a destination, then the value of **Modem** is overridden by the inclusive set of modems found in both.

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: "Calls to emergency numbers are not permitted"
```

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).

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.**

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*. This is a convenient mechanism for defining configuration parameters for all modems without having to modify each modem-specific configuration file.  For example,

```
    SessionTracing: 0x4f
```

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: 3
    DesiredEC: 0
    DesiredDF: 1
```

## NOTES

## SEE ALSO

[*faxq*(8)](/faxq/8.md), [*hylafax-config*(5)](/hylafax-config/5.md), [*re\_format*(7)](/re_format/7.md).