Change User SMTP (CHGUSRSMTP)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change User SMTP (CHGUSRSMTP) command allows you to change a user profile's entry in the local SMTP mailbox directory. The directory contains mailbox information for use with SMTP and POP3.
Restrictions:
- You must have security administrator (*SECADM) special authority to change entries in the directory for user profiles different than the current user profile.
- You must have security administrator (*SECADM) special authority to configure FORWARDING and ORIGINATOR parameters.
Top |
Parameters
Keyword | Description | Choices | Notes |
---|---|---|---|
USRPRF | User profile | Simple name | Required, Key, Positional 1 |
ALIAS | SMTP mailbox alias | Character value, *NONE, *SAME | Optional |
DOMAIN | SMTP domain alias | Element list | Optional |
Element 1: Domain index | 1-10, *DFT, *NONE | ||
Element 2: Domain Name | Character value, *DFT | ||
SDDNAME | SDD name compatibility | Character value, *DFT, *SAME | Optional |
SDDADR | SDD address compatibility | Character value, *DFT, *SAME | Optional |
FORWARDING | Forwarding to | Character value, *SAME, *NONE | Optional |
ORIGINATOR | Originating from | Character value, *SAME, *NONE | Optional |
Top |
User profile (USRPRF)
Specifies the user profile of the local SMTP mailbox directory entry to be changed.
- name
- Specifies the name of a valid user profile.
Top |
SMTP mailbox alias (ALIAS)
Specifies the alias to use as an alternate name for your mailbox in the local SMTP mailbox directory.
- *SAME
- Use the same value for ALIAS that was previously set.
- *NONE
- No alias is specified. The server will only use the user profile name as the mailbox.
- character value
- Specifies the alias for the mailbox. The characters specified must be able to be converted from your Job CCSID to the ISO8859-1 charset. Up to 50 characters can be specified.
Top |
SMTP domain alias (DOMAIN)
Specifies the alias to use as an alternate name for your e-mail domain in the local SMTP mailbox directory.
Element 1: Domain index
- *DFT
- No domain alias index specified. if domain alias name specified, it will be used.
- *NONE
- No domain alias specified. The server will only use the system's hostname and domain as your email domain.
- 1-10
- Domain alias index specified. This index identifies which value configured in the SMTP domain alias (ALIASDMN) parameter for the Change SMTP Attributes (CHGSMTPA) command is used.
Element 2: Domain name
- *DFT
- No domain alias name specified. if domain alias index specified, it will be used, if both *DFT specified, nothing to change.
- character value
- Specifies the alias for the email-domain. The valid domain alias should be defined through CHGSMTPA by parameter ALIASDMN first.
Top |
SDD name compatibility (SDDNAME)
Specifies the System Distribution Directory (SDD) Name to use when interfacing this mailbox with the Mail Server Framework (MSF)
- *SAME
- Use the same value for SDDNAME that was previously set.
- *DFT
- The first 8 characters of the user profile identifies the SDD user. The last few characters may be replaced with numbers if there are duplicate SDD names with the same SDD Address.
- character value
- Specifies the SDD name to use. Up to 8 characters can be specified.
Top |
SDD address compatibility (SDDADR)
Specifies the System Distribution Directory (SDD) address to use when interfacing this mailbox with the Mail Server Framework (MSF)
- *SAME
- Use the same value for SDDADR that was previously set.
- *DFT
- The first 8 characters of the system's host name are used.
- character Value
- Specifies the SDD address to use. Up to 8 characters can be specified.
Top |
Forwarding to (FORWARDING)
Specifies mail going to the current local SMTP user will be automatically forwarded to a new address.
- *SAME
- Use the same value for FORWARDING that was previously set.
- *NONE
- No Forwarding specified.
- character value
- Specifies the Forwarding for the mailbox. Up to 200 characters can be specified. The format of an e-mail address is mailbox@domain. The mailbox can be any character that can be converted to ISO-8859-1, but if there are unprintable characters the mailbox must be encapsulated with double quotation marks. The domain must be upper or lower case latin characters, period, dash, or underscore. You must have security administrator (*SECADM) special authority to configure the FORWARDING parameter.
Top |
Originating from (ORIGINATOR)
Specifies who the "From:" field in MIME file will be displayed as. If the current user profile differs from the "Originating from", then the "Sender:" field in MIME file will be displayed as the current user profile.
- *SAME
- Use the same value for ORIGINATOR that was previously set.
- *NONE
- No Originator specified.
- character value
- Specifies the Originator for the mailbox. Up to 200 characters can be specified. The format of an e-mail address is mailbox@domain. The mailbox can be any character that can be converted to ISO-8859-1, but if there are unprintable characters the mailbox must be encapsulated with double quotation marks. The domain must be upper or lower case latin characters, period, dash, or underscore. You must have security administrator (*SECADM) special authority to configure the ORIGINATOR parameter.
Top |
Examples
Example 1: Change Mailbox Alias for a User Profile
CHGUSRSMTP USRPRF(XXXX) ALIAS(YYYY) DOMAIN(*DFT ZZZ.COM)
This command changes the mailbox for the user profile XXXX in the local SMTP directory. This mailbox will accept both XXXX@HOSTNAME.DOMAIN and YYYY@ZZZ.COM. When using an API or command that automatically looks up the originator the originator email address will be YYYY@ZZZ.COM.
Example 2: Change SDD Compatibility for a User Profile
CHGUSRSMTP USRPRF(XXXX) SDDNAME(YYYY) SDDADR(ZZZZ)
This command changes the user profile XXXX entry in the local SMTP directory. This mailbox will have the SDD address YYYY ZZZZ when seen in the Mail Server Framework (MSF). This overrides the default SDD compatibility setting which would have been XXXX (first 8 chars of the system HOSTNAME).
Top |
Error messages
*ESCAPE Messages
- TCP5064
- SMTP user &1 not changed.
- TCP90A8
- *SECADM special authority required to do requested operation.
- TCP9999
- Internal system error in program &1.
Top |