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

984 lines
36 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 (CHGDSTD)</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="CHGDSTD.Top_Of_Page"></a>
<h2>Change Distribution (CHGDSTD)</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="#CHGDSTD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDSTD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDSTD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDSTD"></a>
<p>The Change Distribution Description (CHGDSTD) command changes descriptive information (such as author, subject, or keywords) or access information about a distribution document in the mail basket. For some parameters, descriptive information can be deleted or added.
</p>
<p><b>Restrictions:</b> (1) To work on behalf of another user, you must be granted permission to work on behalf of the other user with the Grant User Permission (GRTUSRPMN) command. (2) The requester of the command must be enrolled in the system distribution directory. (3) Personal mail distribution cannot be requested by a requester working on behalf of another user.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDSTD.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="#CHGDSTD.DSTID"><b>DSTID</b></a></td>
<td valign="top">Distribution identifier</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DSTIDEXN"><b>DSTIDEXN</b></a></td>
<td valign="top">Distribution ID extension</td>
<td valign="top">1-99, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.COMMENT"><b>COMMENT</b></a></td>
<td valign="top">Comment</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.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"><a href="#CHGDSTD.SENSITIV"><b>SENSITIV</b></a></td>
<td valign="top">Sensitivity</td>
<td valign="top"><b><u>*SAME</u></b>, *NONE, *PERSONAL, *PRIVATE, *CONFIDENTIAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.PERSONAL"><b>PERSONAL</b></a></td>
<td valign="top">Personal</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.IMPORTANCE"><b>IMPORTANCE</b></a></td>
<td valign="top">Content importance</td>
<td valign="top"><b><u>*SAME</u></b>, *NORMAL, *LOW, *HIGH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.PTY"><b>PTY</b></a></td>
<td valign="top">Priority</td>
<td valign="top"><b><u>*SAME</u></b>, *NORMAL, *HIGH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DOCD"><b>DOCD</b></a></td>
<td valign="top">Document description</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DOCDATE"><b>DOCDATE</b></a></td>
<td valign="top">Document date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">Expiration date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.ACTDATE"><b>ACTDATE</b></a></td>
<td valign="top">Action due date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.CMPDATE"><b>CMPDATE</b></a></td>
<td valign="top">Completion date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.REFERENCE"><b>REFERENCE</b></a></td>
<td valign="top">Reference</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.STATUS"><b>STATUS</b></a></td>
<td valign="top">Status</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.PROJECT"><b>PROJECT</b></a></td>
<td valign="top">Project</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DOCLANGID"><b>DOCLANGID</b></a></td>
<td valign="top">Language ID</td>
<td valign="top"><i>Character value</i>, *JOB, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DOCCNTRYID"><b>DOCCNTRYID</b></a></td>
<td valign="top">Country or region ID</td>
<td valign="top"><i>Character value</i>, *JOB, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.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>*SAME</u></b>, *CURRENT, *RMV</td>
</tr>
<tr>
<td valign="top">Element 2: Time</td>
<td valign="top">
<i>Time</i>, <b><u>*SAME</u></b>, *CURRENT, *ENDOFDAY</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.AUTHOR"><b>AUTHOR</b></a></td>
<td valign="top">Author</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Author</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: New author</td>
<td valign="top">
<i>Character value</i>, *ADD, *RMV</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.DOCCLS"><b>DOCCLS</b></a></td>
<td valign="top">Document class</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.KWD"><b>KWD</b></a></td>
<td valign="top">Keyword</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Keyword</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: New keyword</td>
<td valign="top">
<i>Character value</i>, *ADD, *RMV</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.SUBJECT"><b>SUBJECT</b></a></td>
<td valign="top">Subject</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Subject</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: New subject</td>
<td valign="top">
<i>Character value</i>, *ADD, *RMV</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDSTD.FILCAB"><b>FILCAB</b></a></td>
<td valign="top">File cabinet location</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.CPYLST"><b>CPYLST</b></a></td>
<td valign="top">Copy list</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Copy list</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: New copy list</td>
<td valign="top">
<i>Character value</i>, *ADD, *RMV</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.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>
<tr>
<td valign="top" rowspan="3"><a href="#CHGDSTD.DOCCHRID"><b>DOCCHRID</b></a></td>
<td valign="top">Document character identifier</td>
<td valign="top">Single values: *SYSVAL, *DEVD, <b><u>*SAME</u></b><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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDSTD.DSTID"></a>
<h3>Distribution identifier (DSTID)</h3>
<p>Specifies the unique distribution identifier of the distribution. The identifier is assigned to the distribution by the system that originated it. Only incoming distributions can be changed. If the identifier represents an outgoing distribution, an error message is returned.
</p>
<dl>
<dt><b><i>distribution-id</i></b></dt>
<dd>The distribution identifier 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 the leading zeros. For example, 'NEWYORK SMITH 0204'. This parameter is required when *DSTID is specified on the Information to be sent prompt (TYPE parameter).
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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 2-digit extension has a value ranging from 01 through 99 that uniquely identifies duplicate distributions. The default value is 01.
</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.COMMENT"></a>
<h3>Comment (COMMENT)</h3>
<p>Specifies comments that describe the distribution document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The comment does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The comment is removed from the distribution document.
</dd>
<dt><b><i>comment</i></b></dt>
<dd>Specify up to 256 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.USRID"></a>
<h3>User identifier (USRID)</h3>
<p>Specifies which user ID address is associated with this request.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The person currently running the command is authorized to the distribution being changed.
</dd>
<dt><b><i>user-id address</i></b></dt>
<dd>Specify the user ID address that is authorized to the distribution to be changed. If the named user ID address differs from the current user ID address, the current user must be authorized to work on behalf of the named user by the Grant User Permission (GRTUSRPMN) command or by the OfficeVision/400 program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NORMAL</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.PTY"></a>
<h3>Priority (PTY)</h3>
<p>Specifies the speed with which the distribution is sent. The prior version's purpose for priority is no longer valid because it relates to the speed by which the distribution arrived at the system. To ensure compatibility with applications from previous releases, this parameter will remain. If the command is prompted without this parameter specified, this parameter is not displayed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NORMAL</b></dt>
<dd>The distribution document arrived through a normal-speed line.
</dd>
<dt><b>*HIGH</b></dt>
<dd>The distribution document arrived through a high-speed line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DOCD"></a>
<h3>Document description (DOCD)</h3>
<p>Specifies the description of the document being changed. This is the Document Interchange Architecture Profile document name field.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The document description does not change.
</dd>
<dt><b><i>document-description</i></b></dt>
<dd>Specify the new description of the document. A maximum of 44 characters can be specified, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DOCDATE"></a>
<h3>Document date (DOCDATE)</h3>
<p>Specifies any date the user wants to assign to the distribution document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The distribution document date does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The distribution document date is removed from the distribution document.
</dd>
<dt><b><i>document-date</i></b></dt>
<dd>Specify the distribution document date to be added or changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>Specifies the document expiration date beyond which the distribution document is no longer needed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The expiration date does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The expiration date is removed from the distribution document.
</dd>
<dt><b><i>expiration-date</i></b></dt>
<dd>Specify the expiration date to be replaced or added. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.ACTDATE"></a>
<h3>Action due date (ACTDATE)</h3>
<p>Specifies the date when the action requested is due.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The action due date does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The action due date is removed from the distribution document.
</dd>
<dt><b><i>action-due-date</i></b></dt>
<dd>Specify the action due date to be replaced or added. The action due date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.CMPDATE"></a>
<h3>Completion date (CMPDATE)</h3>
<p>Specifies the date when the action requested is completed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The completion date does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The completion date is removed from the distribution document.
</dd>
<dt><b><i>completion-date</i></b></dt>
<dd>Specify the completion date to be replaced or added. The date must be specified in the job date format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.REFERENCE"></a>
<h3>Reference (REFERENCE)</h3>
<p>Specifies a reference associated with the distribution document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The reference field does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The reference is removed from the distribution document.
</dd>
<dt><b><i>reference</i></b></dt>
<dd>Specify the document reference being changed or added. A maximum of 60 characters can be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.STATUS"></a>
<h3>Status (STATUS)</h3>
<p>Specifies the user-defined status indicator (In Process, Pending Approval, or Retired) of the distribution document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The status indicator does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The status indicator is removed.
</dd>
<dt><b><i>status</i></b></dt>
<dd>Specify the document status indicator being changed or added. A maximum of 20 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.PROJECT"></a>
<h3>Project (PROJECT)</h3>
<p>Specifies the project name with which the distribution document is associated.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The project name does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The project name is removed from the distribution document.
</dd>
<dt><b><i>project</i></b></dt>
<dd>Specify the distribution document project being replaced or added. A maximum of 10 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DOCLANGID"></a>
<h3>Language ID (DOCLANGID)</h3>
<p>Specifies the language identifier to be placed in this distribution document's interchange document profile (IDP).
</p>
<p>This parameter can be used to add a language identifier to the document's IDP if the identifier has not been specified previously, or to change the value of an existing language identifier.
</p>
<p>
<b>Note: </b>If you specify a value on this parameter and no value has previously been specified on the <b>Country or region ID</b> prompt (DOCCNTRYID parameter), you must also specify a country or region identifier.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The language identifier does not change.
</dd>
<dt><b>*JOB</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DOCCNTRYID"></a>
<h3>Country or region ID (DOCCNTRYID)</h3>
<p>Specifies the country or region identifier to be placed in this distribution document's interchange document profile (IDP).
</p>
<p>This parameter can be used to add a country or region identifier to the document's IDP if an identifier has not been specified previously, or to change the value of an existing country or region identifier.
</p>
<p>
<b>Note: </b>If you specify a value on this parameter and no value has previously been specified on the <b>Language ID</b> prompt (DOCLANGID parameter), you must also specify a language identifier.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The country or region identifier does not change.
</dd>
<dt><b>*JOB</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DSTEXPDATE"></a>
<h3>Distribution expiry indicator (DSTEXPDATE)</h3>
<p>Specifies the date and time at 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>*SAME</u></b></dt>
<dd>The value does not change.
<p>If *SAME is specified for both the distribution expiration date and distribution expiration time, no changes are made to the distribution expiration date and time.
</p>
<p>If *SAME is specified for the distribution expiration date and a value other than *SAME is specified for the distribution expiration time, the command checks for the existence of the distribution expiration date. If the distribution expiration date exists, the date remains unchanged and the time is changed as specified. If the distribution expiration date does not exist, an error message is issued indicating this condition, and you must specify something other than *SAME.
</p>
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The distribution expiration date is set to the current date.
</dd>
<dt><b>*RMV</b></dt>
<dd>The distribution expiration date and time are removed from the distribution document.
</dd>
<dt><b><i>distribution expiration date</i></b></dt>
<dd>Specify the value to use as the expiration date. 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>*SAME</u></b></dt>
<dd>The value does not change.
<p>If *SAME is specified for both the distribution expiration date and distribution expiration time, no changes are made to the distribution expiration date and time.
</p>
<p>If *SAME is specified for the distribution expiration time and a value other than *SAME is specified for the distribution expiration date, the system checks for the existence of the distribution expiration time. If the distribution expiration time exists, the time does not change and the date is change as specified. If the distribution expiration time does not exist, an error message is issued, and you must specify something other than *SAME.
</p>
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The distribution expiration time is set to the current time.
</dd>
<dt><b>*ENDOFDAY</b></dt>
<dd>An expiration time is 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 used as the expiration 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 QTIMSEP 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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.AUTHOR"></a>
<h3>Author (AUTHOR)</h3>
<p>Specifies the author or authors of the distribution document. A maximum of 20 characters can be specified, enclosed in apostrophes.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>author</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The author of the document does not change.
</dd>
<dt><b><i>author</i></b></dt>
<dd>Specify a current author that is changed or removed, or the author that is being added.
</dd>
</dl>
<p>The possible <b>new author</b> values are:
</p>
<dl>
<dt><b><i>new-author</i></b></dt>
<dd>Specify the new author to replace the current author associated with the distribution document.
</dd>
<dt><b>*ADD</b></dt>
<dd>The specified value is added to the information about the distribution document.
</dd>
<dt><b>*RMV</b></dt>
<dd>The specified value is removed from the information about the distribution document.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.DOCCLS"></a>
<h3>Document class (DOCCLS)</h3>
<p>Specifies the class associated with this distribution document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The document class does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The document class for the distribution document is removed.
</dd>
<dt><b><i>document-class</i></b></dt>
<dd>Specify the document class that is replaced or added. A maximum of 16 characters can be specified, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.KWD"></a>
<h3>Keyword (KWD)</h3>
<p>Specifies the keywords that can be used to describe the distribution document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>keyword</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The keywords do not change.
</dd>
<dt><b><i>keyword</i></b></dt>
<dd>Specify a current keyword that is changed or removed, or the keyword that is being added. A maximum of 60 characters can be specified, enclosed in apostrophes.
</dd>
</dl>
<p>The possible <b>new keyword</b> values are:
</p>
<dl>
<dt><b><i>new-keyword</i></b></dt>
<dd>Specify a new keyword to replace the current keyword. A maximum of 60 characters can be specified, enclosed in apostrophes.
</dd>
<dt><b>*ADD</b></dt>
<dd>The specified value is added to the information about the distribution document.
</dd>
<dt><b>*RMV</b></dt>
<dd>The specified value is removed from the information about the distribution document.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.SUBJECT"></a>
<h3>Subject (SUBJECT)</h3>
<p>Specifies the subject of the distribution document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>subject</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The subject of the distribution document does not change.
</dd>
<dt><b><i>subject</i></b></dt>
<dd>Specify a current subject to be changed or removed, or the subject being added. A maximum of 60 characters can be used.
</dd>
</dl>
<p>The possible <b>new subject</b> values are:
</p>
<dl>
<dt><b><i>new-subject</i></b></dt>
<dd>Specify a new subject to replace the current subject. A maximum of 60 characters can be used.
</dd>
<dt><b>*ADD</b></dt>
<dd>The specified document subject is added to the information about the distribution document.
</dd>
<dt><b>*RMV</b></dt>
<dd>The specified document subject is removed from the information about the distribution document.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.FILCAB"></a>
<h3>File cabinet location (FILCAB)</h3>
<p>Specifies the physical location where the distribution document is stored. This parameter is intended for printed distribution documents. It changes only the Document Interchange Architecture Profile field that refers to the printed document.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The file cabinet location does not change.
</dd>
<dt><b>*RMV</b></dt>
<dd>The file cabinet location is removed from the distribution document.
</dd>
<dt><b><i>file-cabinet-location</i></b></dt>
<dd>Specify the file cabinet location to be added or changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.CPYLST"></a>
<h3>Copy list (CPYLST)</h3>
<p>Specifies names or addresses of users who receive this distribution document.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible <b>copy list</b> values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The copy list does not change.
</dd>
<dt><b><i>copy-list</i></b></dt>
<dd>Specify a current copy list entry to be changed or removed, or a new copy list entry to be added.
</dd>
</dl>
<p>The possible <b>new copy list</b> values are:
</p>
<dl>
<dt><b><i>new-copy-list</i></b></dt>
<dd>Specify the new copy list entry to replace the current copy list entry.
</dd>
<dt><b>*ADD</b></dt>
<dd>The specified copy list entry is added to the information about the distribution list.
</dd>
<dt><b>*RMV</b></dt>
<dd>The specified copy list entry is removed from the information about the distribution list.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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>
<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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDSTD.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>*SAME</u></b></dt>
<dd>The character identifier does not change.
</dd>
</dl>
<dl>
<dt><b>*SYSVAL</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.
</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="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDSTD.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Deleting an Author</b>
</p>
<p>
<pre>
CHGDSTD DSTID('NEWYORK SMITH 0201') DSTIDEXN(01)
AUTHOR('John W. Baker' *DLT)
KWD('PC Attached Scanners' *ADD)
</pre>
</p>
<p>This command deletes one of the authors associated with a distribution document and adds a new keyword to the distribution document.
</p>
<p><b>Example 2: Changing the User-Defined Document Name</b>
</p>
<p>
<pre>
CHGDSTD DSTID('NEWYORK SMITH 0201') DSTIDEXN(02)
DOCD('S/38 1984 Sales') USRID(JACOBSON RCHJACOB)
</pre>
</p>
<p>In this example, a person authorized to work on behalf of JACOBSON is changing the user-defined document name associated with a document on the second distribution sent to the user.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDSTD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF90D5</b></dt>
<dd>Distribution description not changed.
</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>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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDSTD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>