Change User SMTP (CHGUSRSMTP)

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:

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 *DFT, *NONE, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
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

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.

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.

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, the valid domain alias index can be got through CHGSMTPA by parameter ALIASDMN.

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.

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.

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.

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).

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.