JOBCONTROL(8)

🎀 JOBCONTROL — per-job controls for HylaFAX servers 🎀

okay bestie, so this is JOBCONTROL(8), a System Manager's Manual page, and it's genuinely one of those little gremlin config pages that runs your whole fax destiny. sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ DESCRIPTION ✨

So the HylaFAX configuration parameter JobControlCmd specifies the script that gets used to apply per-job controls on job characteristics — stuff like the time-of-day to place a call. like, the vibe of when and how a job goes out. 🦋

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); 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. so yes, you can absolutely leave little notes to yourself, she supports it 💅

the order of entries in the output is IMPORTANT bestie. 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. so like… last one wins. no cap. 🫶

---

👑 the parameters you can set per-job

The following parameters may be specified on a per-job basis; consult hylafax-config(5) for a description of each parameter (except RejectNotice, which is described below, because it's special like that).

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

---

💖 Modem (the group-chat moderator of modems)

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.

like it's giving venn diagram energy 🌈

---

🙈 RejectNotice (the polite-but-firm no)

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"

---

🌸 VRes (vertical resolution moment)

The VRes parameter controls the vertical resolution. Possible values are:

• 98 — normal resolution, equivalent to sendfax -l option
• 196 — fine resolution, equivalent to sendfax -m option

---

✨ UseXVRes (the upgraded glow-up resolution)

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
• 0 — disable extended resolutions usage

heads up: This parameter supersedes the usage of VRes. so if UseXVRes is in the room, VRes is lowkey just standing in the corner 🧚

---

🦋 and literally anything else you want

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

so like, one file, all the vibes, zero modem-by-modem chaos. periodt 💅

---

💀 NOTES 💀

nothing here bestie. the section exists. it's empty. it's giving minimalist. we respect it. 🎀

---

🔥 SEE ALSO 🔥

• faxq(8)
• hylafax-config(5)
• re_format(7)

---

k that's the whole page!! this one came from the System Manager's Manual, dated Mar 27, 2006, and it's the JOBCONTROL(8) page — go configure something slay, bestie, and remember: last value wins, always. 💖✨🎀