sendq.5f man page

sendq/q* — HylaFAX outbound job description

Description

Files in the sendq directory specify transmission job requests. These files are created by hfaxd(8C), when submitting a job on behalf of sendfax(1) or sendpage(1). Job description files also reside in the doneq directory; they are moved there by faxq(8C) when a job completes.

Job description files are ASCII files with lines of the form

tag: value

where a tag is one of the identifiers described below and a value is either a string or number. Values start at the first non-blank character after the “:” and continue to the end of the line. Lines that end with a backslash character “\” are continued to the next line. Numeric values are decimal integers, except for chophreshold which is expressed as a floating point value.

The following table lists the possible tags and the required type of the associated value.

TagTypeDescription
chopthresholdfloatpage chopping threshold (inches)
commidstringcommunication identifier for last call
companystringreceiver's company
conntimeintegertotal connection time for all sessions
clientstringhost that submitted the job
coverstringcontinuation coverpage file
datastringunprocessed document of indeterminate type
!datastringprocessed document of indeterminate type
dataformatstringdata format used to transmit a facsimile
desiredbrintegerdesired maximum transmit speed
desireddfintegerdesired page data format
desiredecintegerdesired use of Error Correction Mode (ECM)
desiredstintegerdesired minimum scanline time
desiredtlintegerwhether or not to use tagline parameter
doneopstringoperation to perform when job is reaped
durationintegertotal duration time for all sessions
errorcodestringjob status error code
externalstringexternal form of dialstring
faxstringdocument ready for transmission
faxnumberstringorigin number to use sending
faxnamestringorigin name to use sending
groupidintegerHylaFAX job group identifier
ignoremodembusyintegerwhether or not to ignore a modem busy state
jobidintegerHylaFAX job identifier
jobtagstringuser-specified job identifier
jobtypestringjob type identification string
killtimeintegertime to give up trying to send job
locationstringreceiver's location
mailaddrstringemail address of sender
maxdialsintegermax number of times to dial
maxtriesintegermax number of attempts to send job
minbrintegerminimum required transmit speed
modemstringoutgoing modem to use
ndialsintegernumber of consecutive failed attempts to place call
nocountcoverintegerdon't include these pages in counts
notifystringemail notification specification
npagesintegernumber of pages transmitted
ntriesintegernumber of attempts to send current page
numberstringdialstring to use in placing call
ownerstringuser that owns the job
pagestringPIN in a page operation
pagechopstringwhitespace truncation handling
pagehandlingstringpage analysis information
pagelengthintegerfacsimile page length (millimeters)
pagewidthintegerfacsimile page width (millimeters)
passwdstringinfo to send in HDLC PWD frame
pclstringunprocessed PCL document
!pclstringprocessed PCL document
pollstringpolling request
postscriptstringunprocessed POSTSCRIPT document
!postscriptstringprocessed POSTSCRIPT document
priorityintegeruser-specified scheduling priority
probeonlyintegerif non-zero this identifies the probe type
receiverstringreceiver's identity
resolutionintegervertical resolution of facsimile
retrytimeintegertime to use between job retries
returnedintegerindicates return status value for the job
schedpriintegercurrent scheduling priority
senderstringidentity of sender
serverdocoverintegerwhether or not to have the server create the cover page
signalratestringsignalling rate at which a facsimile was sent
skippagesintegerskip this number of pages in the first document
skippedpagesintegerincrement page counts by this number
stateintegerjob scheduling state
statusstringjob status
subaddrstringinfo to send in HDLC SUB frame
taglinestringtagline format string
tiffstringunprocessed TIFF/F document
!tiffstringprocessed TIFF/F document
timeofdaystringtime of day restrictions
timezonestringtime zone to use for tagline formatting
totdialsintegertotal number of phone calls
totpagesintegertotal pages to transmit
tottriesintegertotal number of attempts to send job
tsistringTSI to transmit when sending
ttsintegertime to send job
useccoverintegerwhether or not to use a continuation cover page
usexvresintegerwhether or not to use highest vertical resolution

Parameters

Note that all files must be owned by the fax user. Pathnames for document files must be relative to the top of the HylaFAX spooling directory and not include “..”.

chopthreshold
The minimum trailing whitespace (in inches) that must appear on a page for it to be considered for “page chopping”. If this parameter is not specified then the value specified by the PageChopThreshold configuration parameter is used; see hylafax-config(5F).
commid
The communication identifier for the last outbound call placed for this job. This string is of the form “XXXXXXXX” where XXXXXXXX is a decimal sequence number in the range 1-99999999.
client
The fully qualified hostname for the machine from which the job was submitted. If the hostname is unknown at the time the job is submitted, then the host address in Internet standard “.” (dot) notation is supplied instead.
company
The receiver's company name as specified with the -x option to sendfax(1). This value is used only when creating continuation cover pages.
conntime
The total connection time in seconds for all of the sessions for this job.
cover
The pathname of a continuation cover page to send. The file must be TIFF/F (i.e. it must already be prepared for transmission). This document will be transmitted before any other documents listed in the file. See ContCoverPage and ContCoverCmd in hylafax-config(5F).
data
The pathname of a document to send. Once a document has been processed, it is marked as !data so that subsequent retries do not reprocess the document.
dataformat
The format used to transmit facsimile data. This item is recorded by faxsend(8C) so that notify(8C) can return it in a notification message.
desiredbr
The desired signalling rate to use for page data transmissions: 0 for 2400 bps, 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4 for 12000 bps, 5 for 14400 bps, 6 for 16800 bps, 7 for 19200 bps, 8 for 21600 bps, 9 for 24000 bps, 10 for 26400 bps, 11 for 28800 bps, 12 for 31200 bps, and 13 for 33600 bps (default).
desireddf
The desired data format to use for page data transmissions: 0 for 1-D MH, 1 for 2-D MR, 3 for 2-D MR with uncompressed data, and 4 for 2-D MMR (default).
desiredec
Which type of Error Correction Mode (ECM) to use: 0 to disable, 1 for 64-byte ECM, 2 for 256-byte ECM (default).
desiredst
The desired minimum scanline time to use for page data transmissions: 0 for 0 ms (default), 1 for 5 ms, 2 for 10ms/5ms, 3 for 10ms, 4 for 20ms/10ms, 5 for 20ms, 6 for 40ms/20ms, and 7 for 40ms. This value is used in selecting the negotiated session parameters.
desiredtl
Whether or not to use the format string specified by the tagline job parameter when imaging taglines on document pages. If this value is non-zero then per-job format string is used; otherwise the tagline format string specified in the server configuration file is used; see TagLineFormat in hylafax-config(5F).
doneop
The treatment the job should be given when it is processed by the faxqclean(8C) job cleaner program. The may be one of remove (to expunge the job description file and all associated documents that are not referenced by another job) or archive (to request that the job and associated documents be archived on the server machine). Consult faxqclean more details on other information that may be included in this string.
duration
The total duration time in seconds for all sessions for this job.
errorcode
The codified form of the status message intended for use by clients which provide customized status messages keyed from this standard index.
external
The external form of the dialstring. This string is used instead of the dialstring in any status and log messages. Clients can protect private information such as access codes that must be placed in dialstrings by supplying a “cleansed” version of the dialstring.
fax
The pathname of a TIFF/F document that is ready for transmission. If the pathname string has a leading “xx:”, then “xx” is interpreted to be the index of the first directory in the file to transmit (directories are numbered starting at zero).
faxnumber
The originating number to use when sending a fax. Parallels FAXNumber device config option.
faxname
The originating name to use when sending a fax.
groupid
The job group identifier, an integer number in the range 1 to 32000 assigned to each group of jobs by the HylaFAX software. Each job in a group of jobs submitted at the same time is assigned the same value by the HylaFAX software.
ignoremodembusy
1 if the job should ignore a modem busy status (requires server configuration to allow) 0 otherwise.
jobid
The job identifier, a unique integer number in the range 1 to 32000 assigned to each job by the HylaFAX software.
jobtag
A user-specified string that is intended for identification purposes. If this string is defined, it is returned to the user in notification messages instead of the job identifier.
killtime
The time to kill this job, expressed in seconds since 00:00:00 GMT, January 1, 1970.
location
The receiver's location as specified with the -y option to sendfax(1). This value is used only when creating continuation cover pages.
mailaddr
The electronic mail address to which notification messages should be directed.
maxdials
The maximum number of times the server should dial the phone. If the job cannot be completed in this number of calls, it is terminated.
maxtries
The maximum number of times the server should attempt to send a job; where an attempt is defined to be a session that makes it past Phase A of the CCITT T.30 protocol (for facsimile), or similar. If the job cannot be completed in this number of tries, it is terminated.
minsp
The minimum signalling rate to use for transmitting page data: 0 for 2400 bps (default), 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4 for 12000 bps, 5 for 14400 bps, 6 for 16800 bps, 7 for 19200 bps, 8 for 21600 bps, 9 for 24000 bps, 10 for 26400 bps, 11 for 28800 bps, 12 for 31200 bps, and 13 for 33600 bps.
modem
The outgoing modem to use to send the job, or “any” if any available modem is acceptable.
owner
The identity of the user that owns the job. Typically the owner is the user that created the job, though clients with administrative privileges can change the ownership of jobs. The value is the string specified in the USER command passed to hfaxd(8C) when a client logins in to the server.
nocountcover
Indicates the number of pages at the first document that should be ignored in page counting for the tagline.
notify
A specification of whether the sender wants notification: whenever the job is requeued after a failed attempt to transmit (“when requeued”), when the job is completed (“when done”), either of the above (“when done+requeued”), or not at all (“none”).
npages
The number of pages in the facsimile, including the cover page, that have been successfully transmitted.
ntries
The number of unsuccessful attempts that have been made to transmit the current page.
ndials
The number of consecutive unsuccessful attempts to establish carrier with the the remote device.
number
The dialstring to use to call the destination device.
page
a string with PIN and to use in processing a page transmit request.
pagechop
Whether or not to automatically truncate trailing whitespace on pages of outbound facsimile; see PageChop in hylafax-config(5F). The possible values are: “default” to use the setting of the PageChop configuration parameter, “none” to disable page chopping, “all” to enable chopping of all pages, and “last” to enable chopping of the last page of each document.
pagehandling
A string that contains per-page information used during facsimile transmission. Most of the information is used in the negotiation of session capabilities with optional information used in the implementation of page chopping. The string has three characters, say xxc, for each page to be transmitted. The xx characters are a hex-encoded specification of the session capabilities required to transmit the page. The c character is one of “M”, “S”, and “P”; where: “M” indicates there is another page to follow and that the page requires different T.30 session parameters be negotiated (an EOM code is to be transmitted). “S” indicates there is another page to follow, but the page uses the same session parameters (an MPS. code is to be transmitted). “P” indicates this is the last page to be transmitted (an EOP code is to be transmitted). In addition, if page chopping has been enabled and the page has enough trailing whitespace to be a candidate, then each three character string will be followed by a string of the form “ZXXXX”, where “XXXX” is a 4 digit hex-encoded count of the number of bytes of data to send for a chopped page.
pagelength
The desired page length in millimeters.
pagewidth
The desired page width in millimeters.
pcl
The pathname of a PCL document to send. Once a PCL document has been processed by faxsend, it is marked as !pcl so that subsequent retries do not reprocess the document.
poll
The value is a Caller Identification String (CIS) to use in making a polling request. If no CIS is specified then faxsend will form one from the FAXNumber configuration parameter.
postscript
The pathname of a POSTSCRIPT™ document to send. Once a POSTSCRIPT document has been processed by faxsend, it is marked as !postscript so that subsequent retries do not reprocess the document.
probeonly
If “1” then the call will terminate as complete when a fax connection is established. If “2” then the call will terminate as complete after fax handshaking signals are properly received from the receiver. In neither case are the documents actually transmitted.
receiver
The receiver's name. This value is used only when creating continuation cover pages.
resolution
The desired vertical resolution in lines per inch. This value should be either 98 or 196.
retrytime
The time, in seconds, to delay between each attempt to transmit a job that fails because of a communication-oriented problem. Normally jobs are scheduled according to a collection of configuration parameters that are tuned for the specific reason of each failure; e.g. see JobReqProto in hylafax-config(5F).
returned
Used internally to determine the last return value of the job send attempt.
sender
The “full name” of the sender of the facsimile.
serverdocover
1 if the job should have a server-generated cover page, 0 otherwise.
signalrate
The signalling rate used to transmit facsimile data. This item is recorded by faxsend(8C) so that notify(8C) can return it in a notification message.
skippages
Indicates to the server to skip-over this number of pages in the first document submitted, but to indicate in the page counts as if they were already transmitted (i.e. in a previous job). The server moves this number from skippages into skippedpages as soon as the document preparation occurs.
skippedpages
Indicates to the server to increment page counts by this number as if that number of pages were transmitted in a previous job.
state
The job scheduling state. Recognized values are: 1 (suspended, not being scheduled), 2 (pending, waiting for the time to send), 3 (sleeping, waiting for a scheduled timeout), 4 (blocked, waiting for concurrent activity to the same destination to complete), 5 (ready, ready to be processed except for available resources), 6 (active, actively being processed by HylaFAX), 7 (done, processing completed with success), and 8 (failed, processing completed with a failure).
status
Status information about the current state of the job. Typically this is the reason why the last attempt to send the facsimile failed.
subaddr
The SubAddress information to transmit when sending a facsimile. This string should be used by the receiver to route received facsimile documents.
tagline
The format string to use in imaging taglines on outgoing documents. Note that this parameter is only used if the desiredtl parameter is non-zero.
tiff
The pathname of a TIFF/F document to send. Once a TIFF document has been processed by faxsend, it is marked as !tiff so that subsequent retries do not reprocess the document.
timeofday
The time-of-day restrictions to place on the job. The syntax is identical to the similar TimeOfDay server-configuration option found in hylafax-config(5F).
timezone
The time zone locale setting to use in tagline formatting.
totdials
The total number of times the server has placed a call to the receiving phone number.
totpages
The total number of pages to be transmitted.
tottries
The total number of attempts to transmit a job; see maxtries above.
tsi
TSI to use when sending. This is only used if the device has been configured to allow it. Otherwise, the configured LocalIdentifier. is used.
tts
The time to send the job. If this value is non-zero, it is number of seconds since 00:00:00 GMT, January 1, 1970. Otherwise, a value of 0 is interpreted to mean process as soon as possible.
useccover
1 if the job should use a continuation cover page during retransmission, 0 otherwise.
usexvres
1 if the job should use the highest possible vertical resolution, 0 otherwise. See hylafax-server(5F) for a description of continuation cover pages.

See Also

sendfax(1), faxq(8C), faxqclean(8C), faxsend(8C), pagesend(8C), hfaxd(8C), hylafax-config(5F)

Info

May 12, 1996