CHGDSTA (Change Distribution Attributes)

CHGDSTA Command syntax diagram

 

Purpose

The Change Distribution Attributes (CHGDSTA) command changes the content of message services attributes for mail distributions and the OfficeVision program.

Restriction: You must have security administrator (*SECADM) authority to use this command.

 

Optional Parameters

KEEPRCP
Specifies the recipient information that is stored and sent within each mail distribution. Information can be stored and sent for the primary recipient and the copy recipients.

*SAME: The value does not change.

*BCC: The copy recipients that are not identified on the distribution are stored and sent within each mail distribution. This is the default value at the time of system installation.

*ALL: All recipients of the distribution, whether or not they are identified on the distribution, are stored and sent within each mail distribution.

*NONE: The recipients are not stored or sent within mail distributions.

USEMSFLCL
Specifies if the Mail Service Framework (MSF) will be used by the office mail services for local-to-local mail.

*SAME: The value does not change.

*NO: Local-to-local office mail will be distributed directly by the mail services and will not use the Mail Service Framework (MSF). This is the default value at the time of system installation.

*YES: Local-to-local office mail will use the Mail Service Framework (MSF) for distribution of mail.

SMTPRTE
Specifies the special User ID and Address that the mail services will use to route mail, within this system and/or the SNADS network to the SMTP/MIME gateway node, that have internet addresses as recipients. Within the SNADS network this User ID and Address should appear to be on the node where the TCP/IP SMTP/MIME gateway is active. At the gateway node this User ID and Address must have a preferred address of PREFADR(NETUSRID *IBM ATCONTXT) in the system distribution directory entry. More information about specifying the user ID and address is in the SNA Distribution Services book.

*SAME: The value does not change.

*NONE: There is no route to the SMTP/MIME gateway defined on this system. When this is specified, internet addresses can not be entered on the SNDDST command or on the office products send panels. More information about specifying the user ID and address is in the SNA Distribution Services Link to PDF book.

Element 1: User ID

user-ID: Specify the user ID of the route to the SMTP/MIME gateway.

Element 2: Address

address: Specify the address of the route to the SMTP/MIME gateway. The address must be specified if a user ID is specified.

Example for CHGDSTA

CHGDSTA  KEEPRCP(*ALL)  SMTPRTE(INET USERS)

This command changes the distribution attribute so that all recipients of the distribution are stored and sent within each mail distribution. It also sets the Internet address route to the User ID and Address, INET USERS.

Error messages for CHGDSTA

*ESCAPE Messages

CPF90D5
Distribution description not changed.
CPF900B
User ID and address &1 &2 not in System Distribution Directory.
CPF900C
Sign on and verify of user failed.
CPF905C
Error occurred trying to find a translation table.
CPF9096
Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.