Please enable JavaScript to view this site.

CopiaFacts™ Reference Manual

Modify Default Active File Lock Time

$active_life [lockminutes | 0]

This command modifies the default time for which a lock file in the ACTIVE folder protects the actual FS file of the same name from access by another node. Files in the ACTIVE folder are also used to protect job instance UJP files from concurrent access from multiple nodes.

The parameter on this command is used as follows:

lockminutesThe time in minutes for which the ACTIVE lock is effective. When FS files are locked for document conversion, or when UJP files are locked, values smaller than 5 or greater than 60 will be altered to the nearest value in this range. While fax transmissions are in progress, values up to 600 can be used to accommodate transmission of faxes with hundreds of pages,

If a CopiaFacts node fails and is then restarted, FS files in use at the time will be automatically resubmitted; but when the node is not restarted, the FS files will remain locked until the ACTIVE file expires. Reducing the lockminutes value will therefore decrease the time it takes for CopiaFacts to recover the active items. The value should not be lowered beyond the time likely to be taken by a real fax transmission (after allowing for the fact that the fax settings protocol may step down the baud rate to be used).

You should increase the value above the default if you plan to send faxes which take more than 30 minutes to transmit.
Note that to send long faxes may also require an increase in the per-page time limits. See the variables:
BLADEWARE_SENDPAGE_TIMEOUT_MINUTES,
DIVA_PAGE_SEND_TIMEOUT_SECONDS,
XCAPI_PAGE_SEND_TIMEOUT_SECONDS

Default: 30 minutes

Example:

$active_life 20