ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgdsta.htm

175 lines
6.7 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change Distribution Attributes (CHGDSTA)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CHGDSTA.Top_Of_Page"></a>
<h2>Change Distribution Attributes (CHGDSTA)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CHGDSTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDSTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDSTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDSTA"></a>
<p>The Change Distribution Attributes (CHGDSTA) command changes the content of message services attributes (X.400 support) for mail distributions and the OfficeVision/400 program.
</p>
<p><b>Restriction:</b> You need security administrator (*SECADM) authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDSTA.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTA.KEEPRCP"><b>KEEPRCP</b></a></td>
<td valign="top">Keep recipients</td>
<td valign="top"><b><u>*SAME</u></b>, *BCC, *ALL, *NONE</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTA.USEMSFLCL"><b>USEMSFLCL</b></a></td>
<td valign="top">Use MSF for local</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTA.SMTPRTE"><b>SMTPRTE</b></a></td>
<td valign="top">Route to SMTP gateway</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: User ID</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDSTA.KEEPRCP"></a>
<h3>Keep recipients (KEEPRCP)</h3>
<p>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.
</p>
<p>The number of recipients that will be kept (stored and sent within each mail distribution) is limited to 1000. This is not a limit on the number of recipients that a mail item can be sent to, only the number of recipients that are kept.
</p>
<p>When KEEPRCP(*BCC) is specified and more than 1000 recipients exist in the blind copy list, the recipients are not kept.
</p>
<p>When KEEPRCP(*ALL) is specified and more than 1000 recipients exist for the mail item, the recipients are not kept.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*BCC</b></dt>
<dd>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.
</dd>
<dt><b>*ALL</b></dt>
<dd>All recipients of the distribution, whether or not they are identified on the distribution, are stored and sent within each mail distribution.
</dd>
<dt><b>*NONE</b></dt>
<dd>The recipients are not stored or sent within mail distributions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTA.USEMSFLCL"></a>
<h3>Use MSF for local (USEMSFLCL)</h3>
<p>Specifies if the mail service framework (MSF) will be used by the office mail services for local-to-local mail.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>Local-to-local 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.
</dd>
<dt><b>*YES</b></dt>
<dd>Local-to-local mail will use the mail service framework (MSF) for distribution of mail.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTA.SMTPRTE"></a>
<h3>Route to SMTP gateway (SMTPRTE)</h3>
<p>Specifies the 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, that have an internet address 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.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no route to the SMTP/MIME gateway defined on this system. When this is specified, internet addresses cannot be entered on the SNDDST command or on the office products send panels.
<p>The possible User ID value is:
</p>
</dd>
<dt><b><i>user-ID</i></b></dt>
<dd>Specify the user ID of the route to the SMTP/MIME gateway.
<p>The possible Address value is:
</p>
</dd>
<dt><b><i>address</i></b></dt>
<dd>Specify the address of the route to the SMTP/MIME gateway. This address must be specified if a User ID is specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDSTA.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGDSTA KEEPRCP(*ALL) SMTPRTE(INET USERS)
</pre>
</p>
<p>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.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDSTA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>