PMDF popstore & MessageStore Manager's Guide


Previous Contents Index

4.3.4.8 forward Command: establish a forwarding address

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 


Previous Next Contents Index