The "Execute shell command" field identifies a shell command to be executed upon receipt of a fax. The shell command is executed on the server.
The user who is associated with the dispatch record that specifies this action must have a login account on the server system. This is necessary to enable the system to spawn a new shell to execute the command.
Substitution patterns are expanded before the command is invoked. The following substitution patterns are allowed (they do not represent shell or environment variables):
$duration
- the duration (in seconds) of the fax reception
$faxline
- the fax line on which this fax was received
$file
- pathname of TIFF file containing incoming fax image
$pages
- number of pages in the TIFF file
$time
- arrival date and time in strftime
%c format
$tval
- arrival date and time as seconds since the epoch (i.e. the
same value that would be returned by the time
system call).
$tsi
- the remote fax number (if any). See also CSI and TSI Values.
For an example of a shell command action, see Printing Received Faxes Automatically