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

1632 lines
64 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Send Distribution (SNDDST)</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="SNDDST.Top_Of_Page"></a>
<h2>Send Distribution (SNDDST)</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="#SNDDST.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SNDDST.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SNDDST.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SNDDST"></a>
<p>The Send Distribution (SNDDST) command allows you to send a distribution to a user, to a list of users, or to a distribution list.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>If you are working on behalf of another user, you must have been granted permission to work for that user through the Grant User Permission (GRTUSRPMN) command.
</li>
<li>You need to be enrolled in the system distribution directory.
</li>
<li>You cannot request personal distribution if you are working for another user.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SNDDST.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="#SNDDST.TYPE"><b>TYPE</b></a></td>
<td valign="top">Information to be sent</td>
<td valign="top">*MSG, *DOC, *FILE, *IDP, *DSTID, *LMSG</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#SNDDST.TOUSRID"><b>TOUSRID</b></a></td>
<td valign="top">Recipient</td>
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional, Positional 2</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>
<tr>
<td valign="top">Element 3: Recipient type</td>
<td valign="top">
<b><u>*PRI</u></b>, *CC, *BCC</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.TOINTNET"><b>TOINTNET</b></a></td>
<td valign="top">Internet Recipient</td>
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Internet address</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Recipient type</td>
<td valign="top">
<b><u>*PRI</u></b>, *CC, *BCC</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DSTD"><b>DSTD</b></a></td>
<td valign="top">Description</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.MSG"><b>MSG</b></a></td>
<td valign="top">Message</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *DSTIDMSG</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.LONGMSG"><b>LONGMSG</b></a></td>
<td valign="top">Long Message</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.CFMDEL"><b>CFMDEL</b></a></td>
<td valign="top">Confirmation of delivery</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.SENSITIV"><b>SENSITIV</b></a></td>
<td valign="top">Sensitivity</td>
<td valign="top"><b><u>*NONE</u></b>, *PRIVATE, *PERSONAL, *CONFIDENTIAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.PERSONAL"><b>PERSONAL</b></a></td>
<td valign="top">Personal</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.IMPORTANCE"><b>IMPORTANCE</b></a></td>
<td valign="top">Content importance</td>
<td valign="top"><b><u>*NORMAL</u></b>, *LOW, *HIGH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.PTY"><b>PTY</b></a></td>
<td valign="top">Priority</td>
<td valign="top"><b><u>*NORMAL</u></b>, *HIGH, *LOW</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.USRID"><b>USRID</b></a></td>
<td valign="top">User identifier</td>
<td valign="top">Single values: <b><u>*CURRENT</u></b><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>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.DOCFILE"><b>DOCFILE</b></a></td>
<td valign="top">Document file</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Document file</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SNDDST.DOCMBR"><b>DOCMBR</b></a></td>
<td valign="top">Document member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCTYPE"><b>DOCTYPE</b></a></td>
<td valign="top">Document type</td>
<td valign="top">2-65535, <b><u>*DFT</u></b>, *FFT, *RFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.SNDFMT"><b>SNDFMT</b></a></td>
<td valign="top">Send format</td>
<td valign="top"><b><u>*NOCHG</u></b>, *NOTE, *FINALFORM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.SYSCOD"><b>SYSCOD</b></a></td>
<td valign="top">System code</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.DOCCHRID"><b>DOCCHRID</b></a></td>
<td valign="top">Document character identifier</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DSTID"><b>DSTID</b></a></td>
<td valign="top">Distribution identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DSTIDEXN"><b>DSTIDEXN</b></a></td>
<td valign="top">Distribution ID extension</td>
<td valign="top">0-99, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOC"><b>DOC</b></a></td>
<td valign="top">Document</td>
<td valign="top"><i>Character value</i>, *DOCID</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.FLR"><b>FLR</b></a></td>
<td valign="top">In folder</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCID"><b>DOCID</b></a></td>
<td valign="top">Document identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.IDPFILE"><b>IDPFILE</b></a></td>
<td valign="top">Profile file</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *DOCFILE, *DSTIDIDP<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Profile file</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SNDDST.IDPMBR"><b>IDPMBR</b></a></td>
<td valign="top">Profile member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCD"><b>DOCD</b></a></td>
<td valign="top">Document description</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b>, *DSTD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.AUTHOR"><b>AUTHOR</b></a></td>
<td valign="top">Author</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *USRID<br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCCLS"><b>DOCCLS</b></a></td>
<td valign="top">Document class</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.KWD"><b>KWD</b></a></td>
<td valign="top">Keyword</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.SUBJECT"><b>SUBJECT</b></a></td>
<td valign="top">Subject</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *DOCD<br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCDATE"><b>DOCDATE</b></a></td>
<td valign="top">Document date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b>, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.FILCAB"><b>FILCAB</b></a></td>
<td valign="top">File cabinet location</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.CPYLST"><b>CPYLST</b></a></td>
<td valign="top">Copy list</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">Expiration date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Creation date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b>, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.REFERENCE"><b>REFERENCE</b></a></td>
<td valign="top">Reference</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.ACTDATE"><b>ACTDATE</b></a></td>
<td valign="top">Action due date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b>, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.RPYDATE"><b>RPYDATE</b></a></td>
<td valign="top">Reply requested</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Date</td>
<td valign="top">
<i>Date</i>, <b><u>*NONE</u></b>, *CURRENT, *ANY</td>
</tr>
<tr>
<td valign="top">Element 2: Time</td>
<td valign="top">
<i>Time</i>, <b><u>*ENDOFDAY</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.STATUS"><b>STATUS</b></a></td>
<td valign="top">Document status</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.CMPDATE"><b>CMPDATE</b></a></td>
<td valign="top">Completion date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b>, *CURRENT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.PROJECT"><b>PROJECT</b></a></td>
<td valign="top">Project</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCLANGID"><b>DOCLANGID</b></a></td>
<td valign="top">Language ID</td>
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DOCCNTRYID"><b>DOCCNTRYID</b></a></td>
<td valign="top">Country or region ID</td>
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.ALWALTRCP"><b>ALWALTRCP</b></a></td>
<td valign="top">Allow alternate recipient</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.DISCLOSE"><b>DISCLOSE</b></a></td>
<td valign="top">Disclose recipient</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDDST.ALWX400CNV"><b>ALWX400CNV</b></a></td>
<td valign="top">Allow X.400 conversion</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.AUTUSR"><b>AUTUSR</b></a></td>
<td valign="top">Authorizing user</td>
<td valign="top">Single values: <b><u>*NONE</u></b><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>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.DSTEXPDATE"><b>DSTEXPDATE</b></a></td>
<td valign="top">Distribution expiry indicator</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Date</td>
<td valign="top">
<i>Date</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Time</td>
<td valign="top">
<i>Time</i>, <b><u>*ENDOFDAY</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SNDDST.CMDCHRID"><b>CMDCHRID</b></a></td>
<td valign="top">Command character identifier</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SNDDST.TYPE"></a>
<h3>Information to be sent (TYPE)</h3>
<p>Specifies the type of information that is sent and the parameters that are valid on this command.
</p>
<dl>
<dt><b>*MSG</b></dt>
<dd>Only the message specified on the <b>Message</b> prompt (MSG parameter) is sent.
</dd>
<dt><b>*DOC</b></dt>
<dd>The document specified on the <b>Document</b> prompt (DOC parameter) or the <b>Document identifier</b> prompt (DOCID parameter) is sent. The user must have authority for the document before it can be sent.
</dd>
<dt><b>*FILE</b></dt>
<dd>The database file specified on the <b>Document file</b> prompt (DOCFILE parameter) and the <b>Document member</b> prompt (DOCMBR parameter) is sent. The database file is sent without any changes. The user must have authority for the database file before it can be sent.
</dd>
<dt><b>*IDP</b></dt>
<dd>The interchange document profile (IDP) that is sent is specified on the <b>Profile file</b> prompt (IDPFILE parameter) and the <b>Profile member</b> prompt (IDPMBR parameter), or is specified in the document profile built by this command.
</dd>
<dt><b>*DSTID</b></dt>
<dd>The mail entry that is identified by the distribution ID is distributed. The distribution ID is called the distribution document name.
</dd>
<dt><b>*LMSG</b></dt>
<dd>The text specified on the Long Message prompt (LONGMSG parameter) is sent as an final-form text document (FFTDCA) note. LONGMSG allows up to 5000 characters, which is about one page of text. The "details" parameters (Subject, Reference, Author, Due Date, etc.) are supported with TYPE(*LMSG). The TOINTNET parameter is also supported with TYPE(*LMSG).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.TOUSRID"></a>
<h3>Recipient (TOUSRID)</h3>
<p>Specifies one of the following:
</p>
<ul>
<li>The user ID and address of zero or more users to whom the distribution is being sent
</li>
<li>The distribution list name of zero or more distribution lists containing the user ID and address of one or more users to whom the distribution is being sent.
</li>
</ul>
<p>A combination of user IDs and distribution lists can be used on the same command. Up to 300 user IDs and addresses can be specified.
</p>
<p>If no user ID and address are specified for the TOUSRID parameter, an internet address must be specified on the TOINTNET parameter.
</p>
<p>The possible User ID or List ID values are:
</p>
<dl>
<dt><b><i>user-ID</i></b></dt>
<dd>Specify the user ID of the user to whom the distribution is sent.
</dd>
<dt><b><i>list-ID</i></b></dt>
<dd>Specify the distribution list of users to whom the distribution is sent.
</dd>
</dl>
<p>The possible User Address or List Qualifier values are:
</p>
<dl>
<dt><b><i>user-address</i></b></dt>
<dd>Specify the user address of the user (specified in Element 1) to whom the distribution is sent.
</dd>
<dt><b><i>list-qualifier</i></b></dt>
<dd>Specify the distribution list qualifier of users (specified in Element 1) to whom the distribution is sent.
</dd>
</dl>
<p>The possible Recipient Type values are:
</p>
<dl>
<dt><b><u>*PRI</u></b></dt>
<dd>The user or distribution list is the primary recipient of the distribution.
</dd>
<dt><b>*CC</b></dt>
<dd>The user or distribution list is receiving a copy of the distribution sent to the primary recipient. However, this copy recipient is not identified on the distribution as a receiver on the distribution.
</dd>
<dt><b>*BCC</b></dt>
<dd>The user or distribution list is receiving a copy of the distribution. However, this copy recipient is not identified on the distribution as a receiver on the distribution.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.TOINTNET"></a>
<h3>Internet Recipient (TOINTNET)</h3>
<p>Specifies the internet address of one or more users to whom the distribution is being sent. If TOINTNET(*NONE) is specified, at least one user ID and address must be specified on the TOUSRID parameter. Up to 300 internet addresses can be specified.
</p>
<p>The TOINTNET parameter is not allowed when the TYPE keyword is *MSG.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No internet address is specified. This is a single value.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the internet address of a person or organization to whom the distribution is being sent. Up to 253 characters can be specified for each address.
</dd>
</dl>
<p>The possible Recipient Type values are:
</p>
<dl>
<dt><b><u>*PRI</u></b></dt>
<dd>The internet address is the primary recipient of the distribution.
</dd>
<dt><b>*CC</b></dt>
<dd>The internet address will receive a copy of the distribution sent to the primary recipient.
</dd>
<dt><b>*BCC</b></dt>
<dd>The internet address will receive a copy of the distribution. However, this copy recipient is not identified on the distribution as a receiver on the distribution.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DSTD"></a>
<h3>Description (DSTD)</h3>
<p>Specifies the description of the distribution. A maximum of 44 characters can be specified. This parameter is required and can not start with a blank character or be all blank characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.MSG"></a>
<h3>Message (MSG)</h3>
<p>Specifies whether a short message is sent with the distribution.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No message is sent.
</dd>
<dt><b>*DSTIDMSG</b></dt>
<dd>The message in the distribution document specified on the <b>Distribution identifier</b> prompt (DSTID parameter) is sent with the distribution.
</dd>
<dt><b><i>message-text</i></b></dt>
<dd>Specify the message (256 characters maximum) to send to the users.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.LONGMSG"></a>
<h3>Message (LONGMSG)</h3>
<p>Specify the text to send to the recipients as an final-form text document (FFTDCA).
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No text is sent. This is the default and required when TYPE is not *LMSG
</dd>
<dt><b><i>long-message-text</i></b></dt>
<dd>Specify the text (5000 characters maximum) to send to the recipients. The text will be put into an final-form text document (FFTDCA) that will be sent as a note.
<p>The text must be formatted by using the following controls within the text.
</p>
<ul>
<li>:/N - Will cause a new line (Carrier return).
</li>
<li>:/P - Will cause a new paragraph. New line plus a blank line. (Carrier return and Required carrier return)
</li>
</ul>
<p>The document is setup with 10 characters to the inch, the font ID is 11, the left margin at position 1, and the right margin at position 75. If :/N is not used to start a new line, the text will continue past the right margin and will not be viewable by some E-mail clients. Blanks are not removed from the text, but left in place for indentation and alignment. No extra text (ie. Recipient List, Date/Time, Subject, or Sender) is put into the document.
</p>
<p>Technical note to programmers: Any of the FFTDCA controls (in hexadecimal) can be inserted in the text to provide more control of the format if the controls above are not enough.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.CFMDEL"></a>
<h3>Confirmation of delivery (CFMDEL)</h3>
<p>Specifies whether the sender receives a confirmation of delivery notification when each receiver gets the distribution. Even though confirmation of delivery is not requested, the sender is still informed when the distribution is not delivered because of an user ID is not valid, a system failure, or a routing failure. If confirmation of delivery is requested, the sender is informed when the receiver receives, deletes, or runs another command against the distribution. To get this information, the sender must use the Query Distribution (QRYDST) command with *OUT specified on the <b>Incoming or outgoing</b> prompt (OPTION parameter).
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Confirmation of delivery is not requested.
</dd>
<dt><b>*YES</b></dt>
<dd>Confirmation of delivery is requested.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.SENSITIV"></a>
<h3>Sensitivity (SENSITIV)</h3>
<p>Specifies the level of sensitivity defined by the X.400 standard. The four levels include normal, personal, private and company confidential. Private distributions cannot be viewed by a user working on behalf of another user.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The distribution has no sensitivity restrictions.
</dd>
<dt><b>*PERSONAL</b></dt>
<dd>The distribution is sent to the recipient as an individual.
</dd>
<dt><b>*PRIVATE</b></dt>
<dd>The distribution contains information that should be accessed only by the recipient.
</dd>
<dt><b>*CONFIDENTIAL</b></dt>
<dd>The distribution contains information that should be handled according to company procedures.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.PERSONAL"></a>
<h3>Personal (PERSONAL)</h3>
<p>Specifies whether the document distribution is private or not. This parameter is replaced by SENSITIV but the PERSONAL parameter can still be used. However, because this parameter may be removed in a later release, whenever possible use the SENSITIV parameter.
</p>
<p>If PERSONAL(*YES) is used, the SENSITIV parameter must be omitted or it must be with the value SENSITIV(*NONE). If the command is prompted without this parameter specified, this parameter is not displayed.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Only the owner and users that have authorization to the distribution document can get access to distributions that are not sensitive. Users authorized to work on behalf of other users who have access to the distribution can access documents that are not sensitive. This value will map to SENSITIV(*NONE).
</dd>
<dt><b>*YES</b></dt>
<dd>Only the owner can get access to private distribution documents. Users authorized to work on behalf of other users who have access to the distribution document cannot get access to the distribution. This value will map to SENSITIV(*PRIVATE).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.IMPORTANCE"></a>
<h3>Content importance (IMPORTANCE)</h3>
<p>Specify low, normal or high importance. This is an indication to the recipient of the content importance of the distribution. It is different from priority which relates to the speed with which the distribution was sent.
</p>
<dl>
<dt><b><u>*NORMAL</u></b></dt>
<dd>A distribution of normal importance.
</dd>
<dt><b>*HIGH</b></dt>
<dd>A very important distribution.
</dd>
<dt><b>*LOW</b></dt>
<dd>A low importance distribution.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.PTY"></a>
<h3>Priority (PTY)</h3>
<p>Specifies whether the distribution is sent using low priority, normal priority or high priority. For distributions to remote receivers, the priority determines which 'SNADS Next System Queue' is used. Normal priority distributions use the normal next system queue. Low priority distributions use the normal next system queue with the lowest priority available within that queue. High priority uses the priority next system queue. The difference between low, high and normal priority depends on information, specified by the user, on the Configuration Distribution Services (CFGDSTSRV) command. The handling of priority distributions by other office system nodes can vary, but generally the high priority distributions take the faster path when there is a choice of paths. For distribution to local receivers, the priority determines whether a message is sent to the receiver's message queue to notify the receiver of the distribution. No message is sent for normal distributions.
</p>
<dl>
<dt><b><u>*NORMAL</u></b></dt>
<dd>Normal priority is used.
</dd>
<dt><b>*HIGH</b></dt>
<dd>High priority is used.
</dd>
<dt><b>*LOW</b></dt>
<dd>Low priority is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.USRID"></a>
<h3>User identifier (USRID)</h3>
<p>Specifies which user ID and user ID address should be associated with the request.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>You are performing the request for yourself.
</dd>
<dt><b><i>user-ID</i></b></dt>
<dd>Specify another user's user ID or your user ID. You must have been given permission to work on behalf of another user or have *ALLOBJ authority.
</dd>
<dt><b><i>user-ID-address</i></b></dt>
<dd>Specify another user's address or your address. You must have been given permission to work on behalf of another user or have *ALLOBJ authority.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCFILE"></a>
<h3>Document file (DOCFILE)</h3>
<p>Specifies the names of the database file and the library that contains the document data. The database file is a user-defined file or the output file specified in either the Receive Distribution (RCVDST) command or the Retrieve Document (RTVDOC) command. If an output file is specified, only the data portion of the document data record is read from the output file. The prefix is removed from the document data record.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the database file. If no library is specified as the library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the database file is located.
</dd>
<dt><b><i>data-base-file-name</i></b></dt>
<dd>Specify the name of the database file that contains the document data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCMBR"></a>
<h3>Document member (DOCMBR)</h3>
<p>Specifies the document database file member that is used.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member created in the database file is used.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the database file member that is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCTYPE"></a>
<h3>Document type (DOCTYPE)</h3>
<p>Specifies the type of document being used. This identifier is used by the system to determine whether the data stream can be handled properly.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The system creates the proper document type identifier based on the source of the data.
</dd>
<dt><b>*FFT</b></dt>
<dd>The document is in Final Form Text. This type of document is intended to be viewed and printed, but not edited, by the receiver.
</dd>
<dt><b>*RFT</b></dt>
<dd>The document is in Revisable Form Text. This type of document can be viewed, printed, and edited by the receiver.
</dd>
</dl>
<dl>
<dt><b><i>document-type-number</i></b></dt>
<dd>Specify a document type identifier value ranging from 2 through 65,535. The numbers from 2 through 32,767 are controlled by registering them with the IBM Document Interchange Architecture and are used for IBM-defined document types. The numbers ranging from 32,768 through 65,535 are not registered with IBM and can be used for non-IBM-defined document types. The meaning of these document types must be determined by defining the value of the system code on the <b>System code</b> prompt (SYSCOD parameter).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.SNDFMT"></a>
<h3>Send format (SNDFMT)</h3>
<p>Allows the user to specify the format of the document being sent.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The document is sent in the current format.
</dd>
<dt><b>*NOTE</b></dt>
<dd>The document is sent in a final form text document content architecture (FFTDCA) data stream as a note.
</dd>
<dt><b>*FINALFORM</b></dt>
<dd>The document is sent in FFTDCA.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.SYSCOD"></a>
<h3>System code (SYSCOD)</h3>
<p>Specifies the text used with the value specified on the <b>Document type</b> prompt (DOCTYPE parameter) to help uniquely identify the type of document being used. The receiver of the data stream determines the document data stream and processing requirements to edit, view, print, or change the document.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The system supplies a default system code. If the value specified on the <b>Document type</b> prompt (DOCTYPE parameter) is a number ranging from 2 through 32,767, the default is 'IBM AS/400 CL' and is retrieved from message CPX9026. If the value specified on the <b>Document type</b> prompt (DOCTYPE parameter) is in the range from 32,768 through 65,535, a system code must be specified.
</dd>
<dt><b><i>system-code</i></b></dt>
<dd>Specify the text that uniquely identifies the type of document being sent. A maximum of 13 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCCHRID"></a>
<h3>Document character identifier (DOCCHRID)</h3>
<p>Specifies the character identifier (graphic character set and code page) for the document data being used. The character identifier is related to the display device used to create the document data.
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
</dd>
</dl>
<dl>
<dt><b>*DEVD</b></dt>
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
</dd>
</dl>
<dl>
<dt><b><i>graphic-character-set code-page</i></b></dt>
<dd>Specify the graphic character set and code page values used to create the data being distributed.
</dd>
</dl>
<p>
<b>Note: </b>Both parts can be up to 5 digits in length.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DSTID"></a>
<h3>Distribution identifier (DSTID)</h3>
<p>Specifies the unique distribution identifier of the distribution. The distribution identifier is assigned by the system when the distribution is originated. Distribution identifiers can be found by using the Query Distribution (QRYDST) command. Identifiers are also returned from the Send Distribution (SNDDST) command.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No distribution identifier is used.
</dd>
<dt><b><i>distribution-id</i></b></dt>
<dd>Specify the 3-part distribution identifier which is composed of the second part of the sender's user ID (padded on the right to 8 characters), the first part of the sender's user ID (padded on the right to 8 characters), and a 4-digit zoned sequence number with leading zeros. For example, 'NEWYORK SMITH 0204'. This parameter is required when *DSTID is specified on the <b>Information to be sent</b> prompt (TYPE parameter).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DSTIDEXN"></a>
<h3>Distribution ID extension (DSTIDEXN)</h3>
<p>Specifies the extension of the distribution identifier (if any) specified on the <b>Distribution identifier</b> prompt (DSTID parameter). This extension uniquely identifies duplicate distributions. This 2-digit extension has a value ranging from 00 through 99 that uniquely identifies duplicate distributions. For incoming distributions, this extension ranges from 01 through 99. For confirmation of delivery distributions, this extension must be 00.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is no duplicate distribution. *NONE is equivalent to an extension of 01.
</dd>
<dt><b><i>distribution-id-extension</i></b></dt>
<dd>Specify the extension associated with the distribution. This is used to uniquely identify duplicate distributions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOC"></a>
<h3>Document (DOC)</h3>
<p>Specifies the name of the document being sent.
</p>
<dl>
<dt><b><i>document-name</i></b></dt>
<dd>Specify the user-assigned name (10 characters maximum) of the document to be sent.
</dd>
<dt><b>*DOCID</b></dt>
<dd>The document being sent is identified by the library-assigned document name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.FLR"></a>
<h3>In folder (FLR)</h3>
<p>Specifies the name of the folder that contains the document being sent. This is the user-assigned name given to the folder when it is created. If document name is specified on the <b>Document</b> prompt (DOC parameter), then *DOCID must not be specified.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The document is not located in a folder.
</dd>
<dt><b><i>folder-name</i></b></dt>
<dd>Specify the name of the folder that contains the document being sent. A folder name can consist of a series of folder names if the document being sent is located in a folder contained within another folder or folders.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCID"></a>
<h3>Document identifier (DOCID)</h3>
<p>Specifies the library-assigned name of the document. This is the name assigned to the document by the system when it was created. Documents filed outside the local system have only library-assigned document names. The library-assigned document names can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) command.
</p>
<p>Library-assigned document names are 24 characters in length with the following format:
</p>
<p>
<pre>
YYYYMMDDHHMNSSHSSNSNSNSN
</pre>
</p>
<p>where:
</p>
<p>
<pre>
YYYY = year
MM = month
DD = day
HH = hour
MN = minute
SS = second
HS = hundredths of a second
SNSNSNSN = system name
</pre>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No library-assigned document name is required when the document is identified on the <b>Document</b> prompt (DOC parameter).
</dd>
<dt><b><i>library-assigned-document-name</i></b></dt>
<dd>Specify the library-assigned name of the document being sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.IDPFILE"></a>
<h3>Profile file (IDPFILE)</h3>
<p>Specifies where the document profile information is located. If you specify this parameter, the remaining parameters after the <b>Profile member</b> prompt (IDPMBR parameter) are ignored, except the <b>Command character identifier</b> prompt (CMDCHRID parameter) and the <b>Document character identifier</b> prompt (DOCCHRID parameter).
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The interchange document profile (IDP) is supplied by other parameters on this command. There is no database file containing the IDP information. If *NONE is specified, the <b>Profile member</b> prompt (IDPMBR parameter) is ignored.
</dd>
<dt><b>*DSTIDIDP</b></dt>
<dd>The IDP information associated with the distribution document is used. The <b>Profile member</b> prompt (IDPMBR parameter) is ignored. This is valid only when TYPE (*DSTID) is specified.
</dd>
<dt><b>*DOCFILE</b></dt>
<dd>The database file specified for the document also contains the profile information. If *DOCFILE is specified, the <b>Document file</b>prompt (DOCFILE parameter) and <b>Document member</b> prompt (DOCMBR parameter) are used for the document profile information.
</dd>
<dt><b><i>data-base-file-name</i></b></dt>
<dd>Specify the name of the database file that contains the IDP. The document profile database file can be a user-defined file or the output file specified on the Receive Distribution (RCVDST) or Retrieve Document (RTVDOC) commands. If you specify a user-defined file, it must have the same format as the output file produced by RCVDST or RTVDOC. If an output file is specified, only the data portion of the document profile record is read from the output file. The prefix is removed from the document profile record.
</dd>
</dl>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the database file. If no current library is specified as the library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the database file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.IDPMBR"></a>
<h3>Profile member (IDPMBR)</h3>
<p>Specifies the interchange document file member name being used. This parameter is used only when a database file name is also specified on the <b>Profile file</b> prompt (IDPFILE parameter).
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member created in the database file is used.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the database file member being used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCD"></a>
<h3>Document description (DOCD)</h3>
<p>Specifies a description for the document being distributed. This information is in the Document Interchange Architecture IDP document name field.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The system generates a document description. For database files, the default format is library-name/file-name/member-name. For a description of a hard copy document, the default is the distribution description. For a description of a distribution document, the default is the document description associated with the distribution.
</dd>
<dt><b>*DSTD</b></dt>
<dd>The distribution description specified on the <b>Description</b> prompt (DSTD parameter) is used for the document description.
</dd>
<dt><b><i>document-description</i></b></dt>
<dd>Specify the description of the document. A maximum of 44 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.AUTHOR"></a>
<h3>Author (AUTHOR)</h3>
<p>Specifies the author or authors of the document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No author is identified for the document.
</dd>
<dt><b>*USRID</b></dt>
<dd>The user ID and address specified on the USRID parameter <b>User identifier</b> prompt(USRID parameter) is used as the author's name.
</dd>
<dt><b><i>document-author-name</i></b></dt>
<dd>Specify the name of the author or authors. A maximum of 50 authors can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCCLS"></a>
<h3>Document class (DOCCLS)</h3>
<p>Specifies the class associated with this document, such as MEMO, FORM, or SHEET.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No class is assigned to the document.
</dd>
<dt><b><i>document-class</i></b></dt>
<dd>Specify the document class. A maximum of 16 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.KWD"></a>
<h3>Keyword (KWD)</h3>
<p>Specifies the keywords that describe the document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No keywords are defined for this document.
</dd>
<dt><b><i>document-keyword</i></b></dt>
<dd>Specify the keywords to describe the document. A maximum of 50 keywords can be specified. Each keyword can have a maximum of 60 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.SUBJECT"></a>
<h3>Subject (SUBJECT)</h3>
<p>Specifies the subject or subjects of the document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No subject is defined for the document.
</dd>
<dt><b>*DOCD</b></dt>
<dd>The document description is used as the subject for the document.
</dd>
<dt><b><i>document-subject</i></b></dt>
<dd>Specify the subject or subjects of the document. A maximum of 50 subjects can be specified and each subject can have a maximum of 60 characters of text.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCDATE"></a>
<h3>Document date (DOCDATE)</h3>
<p>Specifies any date the user needs to assign to the document.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No date is assigned to the document.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The system assigns the current system date to the document.
</dd>
<dt><b><i>document-date</i></b></dt>
<dd>Specify the document date. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.FILCAB"></a>
<h3>File cabinet location (FILCAB)</h3>
<p>Specifies the location of the document. This parameter is intended to describe the location of printed documents. The interchange document profile (IDP) that refers to the printed document is distributed. This parameter is required if *IDP is also specified on the <b>Information to be sent</b> prompt (TYPE parameter) and *NONE is specified on the <b>Profile file</b> prompt (IDPFILE parameter).
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No filing cabinet reference is defined for this document.
</dd>
<dt><b><i>filing-cabinet-reference</i></b></dt>
<dd>Specify the text that describes where the printed document is located. A maximum of 60 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.CPYLST"></a>
<h3>Copy list (CPYLST)</h3>
<p>Specifies the names of the users that receive this document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No copy list is included for this document.
</dd>
<dt><b><i>recipient-list</i></b></dt>
<dd>Specify the names of the users that receive the document. A maximum of 50 names can be specified. Each name can have a maximum of 60 characters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>Specifies the date on which the document is no longer needed.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No document expiration date is specified.
</dd>
<dt><b><i>expiration-date</i></b></dt>
<dd>Specify the document expiration date. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.CRTDATE"></a>
<h3>Creation date (CRTDATE)</h3>
<p>Specifies the date the document was created.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No document creation date is specified.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current system date is used as the date the document was created.
</dd>
<dt><b><i>create-date</i></b></dt>
<dd>Specify the document creation date. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.REFERENCE"></a>
<h3>Reference (REFERENCE)</h3>
<p>Specifies a reference associated with the document.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No reference field is included for this document distribution.
</dd>
<dt><b><i>reference</i></b></dt>
<dd>Specify text that describes the reference associated with the document. A maximum of 60 characters can be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.ACTDATE"></a>
<h3>Action due date (ACTDATE)</h3>
<p>Specifies the due date for the requested action. If no action due date is specified and a reply request date is specified the action due date is set from the reply request date.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No action due date is specified.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date is used.
</dd>
<dt><b><i>action-due-date</i></b></dt>
<dd>Specify the value used as the action due date. The date must be specified in the format specified by the system value QDATFMT.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.RPYDATE"></a>
<h3>Reply requested (RPYDATE)</h3>
<p>Specifies the date and time a reply to the distribution is requested. This applies only to primary recipients.
</p>
<p>The possible Reply by date values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No reply is required.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current date is used. The time defaults to *ENDOFDAY and is set to 23:59:59.
</dd>
<dt><b>*ANY</b></dt>
<dd>A reply is requested but no date and time are specified.
</dd>
<dt><b><i>reply-by-date</i></b></dt>
<dd>Specify the value used as the reply requested date. The date must be specified in the format specified by the system value QDATFMT.
</dd>
</dl>
<p>The possible Reply by time values are:
</p>
<dl>
<dt><b><u>*ENDOFDAY</u></b></dt>
<dd>A reply is requested by the end of the specified date. The time is set to 23:59:59.
</dd>
<dt><b><i>reply-by-time</i></b></dt>
<dd>Specify the value used as the reply requested time.
<p>The time is specified in 24-hour format and can be specified with or without a time separator.
</p>
<p>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes, and ss=seconds. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
</p>
<p>With a time separator, specify a string of 5 or 8 digits (hours and minutes, or hours, minutes, and seconds). The time separator specified by the system value QTIMSEM is used to separate the hours, minutes, and seconds. If the command is entered from the command line, the string must be entered in apostrophes. If a time separator other than the separator used for your job is used, the command fails. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.STATUS"></a>
<h3>Document status (STATUS)</h3>
<p>Specifies the user-defined status of the document. Examples of status are: In Process, Pending Approval, or Retired.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No status is included in this document.
</dd>
<dt><b><i>status-of-document</i></b></dt>
<dd>Specify text that describes the status of the document. A maximum of 20 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.CMPDATE"></a>
<h3>Completion date (CMPDATE)</h3>
<p>Specifies the date when the requested action is completed.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No completion date is included.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The current system date is used as the completion date.
</dd>
<dt><b><i>date-complete</i></b></dt>
<dd>Specify the action completion date. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.PROJECT"></a>
<h3>Project (PROJECT)</h3>
<p>Specifies the project associated with the document.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No project field information is included in this document.
</dd>
<dt><b><i>project</i></b></dt>
<dd>Specify text that describes the project of the document. A maximum of 10 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCLANGID"></a>
<h3>Language ID (DOCLANGID)</h3>
<p>Specifies the language identifier to be placed in this document's interchange document profile (IDP).
</p>
<p>
<b>Note: </b>This parameter is ignored if the <b>Profile file</b> prompt (IDPFILE parameter) is specified, or if *MSG or *DOC is specified on the <b>Information to be sent</b> prompt (TYPE parameter).
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The language identifier specified for the job in which this command is entered is used.
</dd>
<dt><b><i>language-identifier</i></b></dt>
<dd>Specify a language identifier. Press the F4 key from the <b>Language ID</b> prompt (DOCLANGID parameter) to see a list of valid identifiers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DOCCNTRYID"></a>
<h3>Country or region ID (DOCCNTRYID)</h3>
<p>Specifies the country or region identifier to be placed in this document's interchange document profile (IDP).
</p>
<p>
<b>Note: </b>This parameter is ignored if the <b>Profile file</b> prompt (IDPFILE parameter) is specified, or if *MSG or *DOC is specified on the <b>Information to be sent</b> prompt (TYPE parameter).
</p>
<dl>
<dt><b><u>*JOB</u></b></dt>
<dd>The country or region identifier specified for the job in which this command is entered is used.
</dd>
<dt><b><i>country-or-region-identifier</i></b></dt>
<dd>Specify a country or region identifier. Press the F4 key from the <b>Country or region ID</b> prompt (DOCCNTRYID parameter) to see a list of valid identifiers.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.ALWALTRCP"></a>
<h3>Allow alternate recipient (ALWALTRCP)</h3>
<p>Specify if the distribution can be delivered to an alternate recipient, determined by the receiving system. This function is used only by X.400 network systems. This function provides the ability to direct certain mail to a specific user.
</p>
<p>The default of this field is *YES. Because the user might change the sensitivity field to private but might not change the alternate recipient field to no, The user might send a private item to an alternate recipient. No error message is generated for this condition.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Specifies the distribution can be delivered to an alternate recipient.
</dd>
<dt><b>*NO</b></dt>
<dd>Specifies the distribution cannot be delivered to an alternate recipient.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DISCLOSE"></a>
<h3>Disclose recipient (DISCLOSE)</h3>
<p>Specifies whether or not each recipient gets a list of the other recipients.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Disclose recipients.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not disclose recipients.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.ALWX400CNV"></a>
<h3>Allow X.400 conversion (ALWX400CNV)</h3>
<p>Specifies whether an X.400 conversion is allowed on the distribution being submitted. In certain circumstances, the end user knows the capabilities of the recipient and may indicate that the distribution is not to be converted. The system administrator can define whether or not conversion is to take place. This field allows the user to override that setting on a message by message basis. For example, if the gateway allows conversion, the user could specify that conversion is to be prohibited. This will take precedence over the gateway setting. The distribution would then not be converted.
</p>
<p>
<b>Note: </b>This field is valid only for X.400 support. This field will not affect AS/400 data stream transformations, such as RFT to FFTDCA.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Conversion may be performed on the distribution by the receiving system.
</dd>
<dt><b>*NO</b></dt>
<dd>No conversion is permitted on the distribution by the receiving system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.AUTUSR"></a>
<h3>Authorizing user (AUTUSR)</h3>
<p>Specifies the user ID and address of the user that authorized the content of this distribution. The authorizing user will receive a copy of the distribution.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No authorizing user.
</dd>
</dl>
<p>The possible User ID value is:
</p>
<dl>
<dt><b><i>user-ID</i></b></dt>
<dd>Specify the user ID of the user from whom the distribution is authorized.
</dd>
</dl>
<p>The possible User Address value is:
</p>
<dl>
<dt><b><i>user-address</i></b></dt>
<dd>Specify the user address of the user from whom the distribution is authorized.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.DSTEXPDATE"></a>
<h3>Distribution expiry indicator (DSTEXPDATE)</h3>
<p>Specifies the date and time on which the distribution is no longer needed in the mail log.
</p>
<p>The possible Distribution Expiration Date values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The distribution has no expiration date.
</dd>
<dt><b><i>dist-expiration-date</i></b></dt>
<dd>Specify the value to use as the expiration date for the distribution. The date must be in the format specified by the system value QDATFMT.
</dd>
</dl>
<p>The possible Distribution Expiration Time values are:
</p>
<dl>
<dt><b><u>*ENDOFDAY</u></b></dt>
<dd>An expiration time is requested by the end of the specified date. The time is set to 23:59:59.
</dd>
<dt><b><i>dist-expiration-time</i></b></dt>
<dd>Specify the value as the expiration time.
<p>The time is specified in a 24-hour format and can be specified with or without a time separator.
</p>
<p>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes, and ss=seconds. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
</p>
<p>With a time separator, specify a string of 5 or 8 digits (hours and minutes, or hours, minutes, and seconds). The time separator specified by the system value QTIMSEM is used to separate the hours, minutes, and seconds. If the command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator used for your job is used, the command fails. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDDST.CMDCHRID"></a>
<h3>Command character identifier (CMDCHRID)</h3>
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values. The character identifier is related to the display device used to enter the command.
</p>
<p>In some cases, the data is translated to a code page and character set that is interchangeable with other IBM OfficeVision/400 products. The interchangeable character set and code page is '697 500', except for the <b>User identifier</b> prompt (USRID parameter), <b>Recipient</b> prompt (TOUSRID parameter), and <b>Distribution identifier</b> prompt (DSTID parameter), for which it is '930 500'. In other cases, the code page and character set are attached to the field and sent with the field to allow the receiving terminal to correctly print and display the field.
</p>
<p>The following parameters are translated:
</p>
<ul>
<li><b>Recipient</b> (TOUSRID)
</li>
<li><b>Internet Recipient</b> (TOINTNET)
</li>
<li><b>User identifier</b> (USRID)
</li>
<li><b>Distribution identifier</b> (DSTID)
</li>
<li><b>Document system code</b> (SYSCOD)
</li>
<li><b>Message</b> (MSG)
</li>
<li><b>Description</b> (DSTD)
</li>
</ul>
<p>The code page and character set is attached to the following parameters:
</p>
<ul>
<li><b>Long Message</b> (LONGMSG)
</li>
<li><b>Document description</b> (DOCD)
</li>
<li><b>Author</b> (AUTHOR)
</li>
<li><b>Document class</b> (DOCCLS)
</li>
<li><b>Keyword</b> (KWD)
</li>
<li><b>Subject</b> (SUBJECT)
</li>
<li><b>File cabinet location</b> (FILCAB)
</li>
<li><b>Copy list</b> (CPYLST)
</li>
<li><b>Reference</b> (REFERENCE)
</li>
<li><b>Document status</b> (STATUS)
</li>
<li><b>Project</b> (PROJECT)
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
</dd>
</dl>
<dl>
<dt><b>*DEVD</b></dt>
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
</dd>
</dl>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the graphic character set to use.
</dd>
</dl>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the code page to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDDST.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Sending a Distribution on Behalf of Another User</b>
</p>
<p>
<pre>
SNDDST TYPE(*FILE) TOUSRID((JACKSON RCH38DB))
DOCTYPE(20000) SYSCOD(BRANDX)
DOCFILE(DEPT46ELIB/XTEXT) DOCMBR(GOLD1IPFS)
PTY(*HIGH) USRID(JACOBSON RCH38NBS)
DSTD('IPFS FOR GOLD1 PROJECT') CFMDEL(*YES)
MSG('Update section 1.2.4. Return for final printing')
</pre>
</p>
<p>This command sends a distribution that is being sent by someone (such as a secretary) who is authorized to work on behalf of JACOBSON. The document being sent is a BRANDX text document that is sent to another user who also has the BRANDX text processor.
</p>
<p><b>Example 2: Sending a Mail Log Entry</b>
</p>
<p>
<pre>
SNDDST TYPE(*DSTID) DSTID('NEWYORK SMITH 0204')
DSTIDEXN(02) TOUSRID((JACKSON RCH38DB))
MSG(*DSTIDMSG) CFMDEL(*YES)
</pre>
</p>
<p>This command sends a mail log entry that is identified by the distribution document name <b>NEWYORK SMITH 0204</b> that is distributed to user JACKSON at address RCH38DB. The message in the distribution document is distributed with the distribution.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDDST.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8A87</b></dt>
<dd>Document name &amp;2 not correct.
</dd>
<dt><b>CPF8A97</b></dt>
<dd>Folder name &amp;1 not correct.
</dd>
<dt><b>CPF89AA</b></dt>
<dd>*FINALFORM for send format (SNDFMT) valid only for *DOC for type (TYPE).
</dd>
<dt><b>CPF89AB</b></dt>
<dd>Specify *IDP or *MSG for type (TYPE) only with *NOCHG for send format (SNDFMT).
</dd>
<dt><b>CPF900B</b></dt>
<dd>User ID and address &amp;1 &amp;2 not in System Distribution Directory.
</dd>
<dt><b>CPF900C</b></dt>
<dd>Sign on and verify of user failed.
</dd>
<dt><b>CPF901A</b></dt>
<dd>Send distribution request failed.
</dd>
<dt><b>CPF903D</b></dt>
<dd>Incorrect document identifier specified.
</dd>
<dt><b>CPF905C</b></dt>
<dd>Error occurred trying to find a translation table.
</dd>
<dt><b>CPF9096</b></dt>
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDDST.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>