PMDF popstore & MessageStore Manager's Guide

The forward command establishes a forwarding address for a given name in the popstore's addressing name space. The name need not correspond to an existing popstore account. Parameter names and associated values accepted by the command are listed in Table 4-8.

Table 4-8 forward command parameters

parameter=value		Description
fwd_from=username	Required	Username for which to establish the forwarding. Maximum string length is 32 bytes.
fwd_override=bvalue	Optional	Boolean value, 0 or 1, indicating whether or not to establish a forwarding for an existing popstore account. If bvalue is 0, then the forwarding will be disallowed if the fwd_from username corresponds to an existing account. Otherwise, the forwarding is permitted. When this parameter is omitted, a bvalue of 1 is assumed.
fwd_to=address	Required	Single RFC822 address to which to forward messages. The address can be either another popstore address or an address external to the popstore. Maximum length of the string is 252 bytes.
on_error=file-spec	Required	Name of the formatting file to use to format the results when the command fails.
on_success=file-spec	Required	Name of the formatting file to use to format the results when the command succeeds.

As an example, consider establishing a forwarding address for the existing user account jdoe to the RFC822 address Jane.Doe@example.com:

command=forward&fwd_from=jdoe&fwd_to=jane.doe@example.com& on_success=fwd_success.txt&on_error=fwd_error.txt