Add User SMTP (ADDUSRSMTP)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add User SMTP (ADDUSRSMTP) command allows you to add a new entry to 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 add 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.
![Start of change](delta.gif)
![End of change](deltaend.gif)
Top |
Parameters
![End of change](deltaend.gif)
Keyword | Description | Choices | Notes |
---|---|---|---|
USRPRF | User profile | Simple name | Required, Positional 1 |
ALIAS | SMTP mailbox alias | Character value, *NONE | Optional |
DOMAIN | SMTP domain alias | Element list | Optional |
Element 1: Domain index |
![]() |
||
Element 2: Domain Name | Character value, *DFT | ||
SDDNAME | SDD name compatibility | Character value, *DFT | Optional |
SDDADR | SDD address compatibility | Character value, *DFT | Optional |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
![]() ![]() |
Top |
User profile (USRPRF)
Specifies the user profile to add to the local SMTP mailbox directory. When SMTP is using the local SMTP mailbox directory this is your absolute mailbox for your email address, and your login user profile for POP3.
- 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.
- *NONE
- No alias specified. The server will only use the user profile name as the mailbox.
- character value
- Specifies the alias for the mailbox. The characters specifed 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
- *NONE
- No domain alias specified. The server will only use the system's hostname and domain as your email domain.
- *DFT
- No domain alias specified. if domain alias name specified, it will be used.
- 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.
![Start of change](delta.gif)
Element 2: Domain name
- *DFT
- No domain alias name specified. if domain alias index specified, it will be used, if both *DFT specified, No domain alias specified. The server will only use the system's hostname and domain as your email domain.
- 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).
- *DFT
- The first 8 characters of the user profile identify 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).
- *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.
- *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.
- *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: Add User Profile to Local SMTP Directory
ADDUSRSMTP USRPRF(XXXX)
This command adds user profile XXXX to the local SMTP directory. All defaults are taken.
Example 2: Add User Profile to Local SMTP Directory and Specify an Alias Mailbox
ADDUSRSMTP USRPRF(XXXX) ALIAS(YYYY) DOMAIN(*DFT ZZZ.COM)
This command adds user profile XXXX to 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 3: Add User Profile to Local SMTP Directory and Specify SDD Compatibility
ADDUSRSMTP USRPRF(XXXX) SDDNAME(YYYY) SDDADR(ZZZZ)
This command adds user profile XXXX to 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
- TCP5072
- SMTP user &1 not added.
- TCP90A8
- *SECADM special authority required to do requested operation.
- TCP9999
- Internal system error in program &1.
Top |