"command"[TAB]"arg-or-macro"[TAB]...[NEWLINE]
stores commands (internals or externals) that have to be executed on a message file. The presence of this file is optional and if it does not exist, the default processing is to store the message in user mailbox. The 'MAILPROC.TAB' file can be either per user or per domain, depending where the file is stored. If stored inside the user directory, it applies only to the user whose directory hosts the 'MAILPROC.TAB', while if stored inside the domain directory, it applies to all users of such domain. Each argument can be a macro also (see [MACRO SUBSTITUTION]):
is substituted for the sender of the message
is substituted for the recipient of the message
is substituted for the real recipient ($(RCPT) could be an alias) of the message
is substituted for the message file path (the external command _must_ only read the file)
is substituted for the (AfterLogic XMail Server unique) message id
is substituted for the reference SMTP message id
copies the message file into a temporary one. It can be used with the 'external' command but in this case if it's external program responsibility to delete the temporary file. Do not use it with 'filter' commands since the filter will not be able to modify the real spool file
name of the SMTP authenticated user, or ``-'' if no authentication has been supplied
Supported commands:
[EXTERNAL]
"external"[TAB]"priority"[TAB]"wait-timeout"[TAB]"command-path"[TAB]=> "arg-or-macro"[TAB]...[NEWLINE]
where:
command keyword
process priority: 0 = normal -1 = below normal +1 = above normal
wait timeout for process execution in seconds: 0 = nowait
Be carefull if using $(FILE) to give the external command enough timeout to complete, otherwise the file will be removed by AfterLogic XMail Server while the command is processing. This is because such file is a temporary one that is deleted when AfterLogic XMail Server exits from 'MAILPROC.TAB' file processing. In case the external command exit code is '16', the command processing stops and all the following commands listed inside the file are skipped.
[FILTER]
"filter"[TAB]"priority"[TAB]"wait-timeout"[TAB]"command-path"[TAB]=> "arg-or-macro"[TAB]...[NEWLINE]
where:
command keyword
process priority: 0 = normal -1 = below normal +1 = above normal
wait timeout for process execution in seconds: 0 = nowait
With filters, it is not suggested to use $(TMPFILE), since the filter will not be able to change the message content in that way. Also, to avoid problems very difficult to troubleshoot, it is suggested to give the filter 'ENOUGH' timeout to complete (90 seconds or more). See [MESSAGE FILTERS] for detailed information about return codes. In the filter command, the ``Stop Filter Processing'' return flag will make AfterLogic XMail Server to stop the execution of the current custom processing file.
The 'filter' command will pass the message file to a custom external filter, that after inspecting it, has the option to accept, reject or modify it. Care should be taken to properly re-format the message after changing it, to avoid message corruption. The 'filter' command 'CANNOT' successfully change the private AfterLogic XMail Server's header part of the spool message.
[MAILBOX]
"mailbox"[NEWLINE]
With this command the message is pushed into local user mailbox.
[REDIRECT]
"redirect"[TAB]"domain-or-emailaddress"[TAB]...[NEWLINE]
Redirect message to internal or external domain or email address. If the message was for foo-user@custdomain.net and the file custdomain.net.tab contains a line:
"redirect" "target-domain.org"
the message is delivered to 'foo-user@target-domain.org'.
While the line:
"redirect" "user@target-domain.org"
redirects the message to user@target-domain.org.
[LREDIRECT]
"lredirect"[TAB]"domain-or-emailaddress"[TAB]...[NEWLINE]
Redirect the message to internal or external domain (or email address) impersonating local domain during messages delivery. If the message was for foo-user@custdomain.net and the file custdomain.net.tab contains a line:
"redirect" "target-domain.org"
the message is delivered to 'foo-user@target-domain.org'.
While the line:
"redirect" "user@target-domain.org"
redirects the message to 'user@target-domain.org'. The difference between ``redirect'' and ``lredirect'' is the following. Suppose A@B sends a message to C@D, that has a redirect to E@F. With ``redirect'' E@F will see A@B has sender while with ``lredirect'' he will see C@D.
[SMTPRELAY]
"smtprelay"[TAB]"server[:port][,options];server[:port][,options];..."[NEWLINE]
Send mail to the specified SMTP server list by trying the first, if fails the second and so on. Otherwise You can use this syntax:
"smtprelay"[TAB]"#server[:port][,options];server[:port][,options];..."[NEWLINE]
to have AfterLogic XMail Server random-select the order the specified relays. Each gateway definition can also contain options as a comma-separated list (see [SMTP GATEWAY CONFIGURATION] for more information).
[top]