373 lines
14 KiB
HTML
373 lines
14 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>Delete Distribution (DLTDST)</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="DLTDST.Top_Of_Page"></a>
|
|
<h2>Delete Distribution (DLTDST)</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="#DLTDST.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DLTDST.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DLTDST.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DLTDST"></a>
|
|
<p>The Delete Distribution (DLTDST) command allows you to delete your own distributions or to delete distributions for another user. This command also allows system operators to delete damaged distribution objects and dangling distribution objects (distribution objects that are not controlled by a distribution tracking object).
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If you are working on behalf of another user, you must have *ALLOBJ special authority or have been granted permission to work on behalf of the other user with the Grant User Permission (GRTUSRPMN) command.
|
|
</li>
|
|
<li>The requester of the command must be enrolled in the system distribution directory.
|
|
</li>
|
|
<li>Personal distribution cannot be requested if the requester is working on behalf of another user.
|
|
</li>
|
|
<li>Damaged and dangling distribution objects can be deleted only by the user who signs on and has *ALLOBJ authority.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DLTDST.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="#DLTDST.DSTID"><b>DSTID</b></a></td>
|
|
<td valign="top">Distribution identifier</td>
|
|
<td valign="top">Single values: *ERROBJ<br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DLTDST.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Incoming or outgoing</td>
|
|
<td valign="top"><b><u>*IN</u></b>, *OUT, *ERR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DLTDST.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="#DLTDST.DSTIDEXN"><b>DSTIDEXN</b></a></td>
|
|
<td valign="top">Distribution ID extension</td>
|
|
<td valign="top">Values (up to 50 repetitions): 0-99, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DLTDST.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *ALL<br>Other values (up to 50 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DLTDST.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="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DLTDST.DSTID"></a>
|
|
<h3>Distribution identifier (DSTID)</h3>
|
|
<p>Specifies the unique identifier of the distribution. The identifier was assigned to the distribution by the system that originated it. Distribution identifiers can be found by using the Query Distribution (QRYDST) command. Identifiers are also returned from the Send Distribution (SNDDST) command.
|
|
</p>
|
|
<p>You can enter multiple values for this parameter.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ERROBJ</b></dt>
|
|
<dd>The distributions to be deleted are damaged or dangling distribution objects.
|
|
<p>
|
|
<b>Note: </b>To delete a damaged or dangling distribution, a value must be specified also on the OBJ parameter.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>distribution-ID</i></b></dt>
|
|
<dd>Specify the distribution identifiers. You can specify:
|
|
<ul>
|
|
<li>up to a maximum of 50 identifiers
|
|
</li>
|
|
<li>sender's address (insert blanks on right to total 8 characters)
|
|
</li>
|
|
<li>sender's user ID (insert blanks on right to total 8 characters)
|
|
</li>
|
|
<li>zoned sequence number (4 digits with leading zeros)
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ul>
|
|
<li>Apostrophes are needed if blanks or special characters are in the distribution identifier.
|
|
</li>
|
|
<li>The distribution specified cannot be damaged or dangling.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTDST.OPTION"></a>
|
|
<h3>Incoming or outgoing (OPTION)</h3>
|
|
<p>Specifies whether the distribution named on the <b>Distribution identifier</b> prompt (DSTID parameter) is an incoming distribution, an outgoing distribution, or an error distribution.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*IN</u></b></dt>
|
|
<dd>An incoming distribution sent to the user is deleted.
|
|
</dd>
|
|
<dt><b>*OUT</b></dt>
|
|
<dd>An outgoing distribution from the user is deleted. An outgoing distribution is the status being saved by the system for a distribution sent to one or more users with confirmation of delivery requested.
|
|
</dd>
|
|
<dt><b>*ERR</b></dt>
|
|
<dd>An error status distribution is deleted. This is the status returned because an error occurred during routing of the distribution.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTDST.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="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTDST.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 extension is a 2-digit extension that ranging from 00 through 99.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>There is no duplicate distribution. *NONE is equivalent to an extension of 01 for incoming distributions. For outgoing and undelivered status distributions, this is equivalent to 00.
|
|
</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="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTDST.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies the damaged or dangling distribution objects to be deleted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No damaged or dangling distribution objects are deleted.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All damaged and dangling distribution objects are deleted.
|
|
</dd>
|
|
<dt><b><i>object-name</i></b></dt>
|
|
<dd>Specify the name of the damaged or dangling distribution object to be deleted.
|
|
<p>The object named can be a local or remote object.
|
|
</p>
|
|
<ul>
|
|
<li>Local object names consist of the sender's address (padded on the right with blanks to a maximum of 8 characters), the sender's user ID (padded on the right with blanks to a maximum of 8 characters), and a 4-digit zoned sequence number with leading zeros. For example:
|
|
<p>
|
|
<pre>
|
|
'NEWYORK SMITH 0204' or
|
|
UADDRESSUSERIDID0099
|
|
</pre>
|
|
</p>
|
|
<p>The apostrophes are needed if there are blanks or special characters in the distribution identifier. The distribution identifier is specified this way because blank characters are valid in a user ID or address.
|
|
</p>
|
|
</li>
|
|
<li>Remote object names consist of the remote system name and the system date and time. For example:
|
|
<p>
|
|
<pre>
|
|
'QOSRDIST091112509152355'
|
|
</pre>
|
|
</p>
|
|
<p>where QOSRDIST is the remote system name, 0911125 is the system date (November 25, 1991), and 09152355 is the system time (9:15:23:55).
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
<p>The distribution identifier for damaged or dangling distributions can be determined when the Save Document Library Object (SAVDLO) command is run and damaged or dangling distribution objects are identified.
|
|
</p>
|
|
<p>A maximum of 50 objects can be named to be deleted.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTDST.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>If the values specified on the <b>Distribution identifier</b> prompt (DSTID parameter) and <b>User identifier</b> prompt (USRID parameter) are being read from an output file created by the Query Distribution (QRYDST) command, specify '930 500' on this parameter.
|
|
</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="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTDST.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Deleting Incoming Distribution Sent to User</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTDST DSTID(('RCH38P BAKER 0019')) USRID(*CURRENT)
|
|
DSTIDEXN(02)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes an incoming distribution sent to the user.
|
|
</p>
|
|
<p><b>Example 2: Deleting Status of Outgoing Distribution</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTDST DSTID(('SYSTEM20 BRUCE 1361'))
|
|
USRID(*CURRENT) DSTIDEXN(00)
|
|
OPTION(*OUT) CMDCHRID(101 37)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes the status associated with an outgoing distribution. The DSTID parameter value is encoded with a character identifier where the code page is 37 and the character set is 101. The system performs translation on the DSTID parameter value before trying to locate the distribution on the distribution recipient index.
|
|
</p>
|
|
<p><b>Example 3: Deleting Incoming Distribution to Signed-On User</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTDST DSTID(('CHICAGO JONES 0013'))
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes an incoming distribution sent to a user who is signed on. The distribution extension defaults to '01' for incoming distributions. If duplicate distributions were sent, this command would only delete the first one.
|
|
</p>
|
|
<p><b>Example 4: Deleting All Damaged Distributions</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTDST DSTID(*ERROBJ) OBJ(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes all damaged and dangling distributions on the system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTDST.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF89BD</b></dt>
|
|
<dd>The object must be specified with DSTID(*ERROBJ).
|
|
</dd>
|
|
<dt><b>CPF900A</b></dt>
|
|
<dd>&2 distribution deleted, could not delete &1 distribution.
|
|
</dd>
|
|
<dt><b>CPF900B</b></dt>
|
|
<dd>User ID and address &1 &2 not in System Distribution Directory.
|
|
</dd>
|
|
<dt><b>CPF900C</b></dt>
|
|
<dd>Sign on and verify of user failed.
|
|
</dd>
|
|
<dt><b>CPF9016</b></dt>
|
|
<dd>Request to cancel distribution &2-&3-&4 unsuccessful for &1.
|
|
</dd>
|
|
<dt><b>CPF905C</b></dt>
|
|
<dd>Error occurred trying to find a translation table.
|
|
</dd>
|
|
<dt><b>CPF906C</b></dt>
|
|
<dd>Distribution not deleted.
|
|
</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="#DLTDST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|