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