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

550 lines
20 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>Receive Distribution (RCVDST)</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="RCVDST.Top_Of_Page"></a>
<h2>Receive Distribution (RCVDST)</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="#RCVDST.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RCVDST.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RCVDST.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RCVDST"></a>
<p>The Receive Distribution (RCVDST) command allows you to receive incoming distributions such as documents or files. The documents or files can be placed in folders or document objects or can be placed in an output file for processing.
</p>
<p><b>Restriction:</b> The requester of the command must be enrolled in the system distribution directory. If you request distribution information for another user, you must have been given permission to work on behalf of that user with the Grant User Permission (GRTUSRPMN) command. Personal distribution cannot be requested if the requester is working on behalf of another user.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RCVDST.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="#RCVDST.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" rowspan="3"><a href="#RCVDST.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="#RCVDST.DOC"><b>DOC</b></a></td>
<td valign="top">Document</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RCVDST.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, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RCVDST.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</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: File to receive output</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" rowspan="3"><a href="#RCVDST.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Output member options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Member to receive output</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top"><a href="#RCVDST.OUTDTATYP"><b>OUTDTATYP</b></a></td>
<td valign="top">Type of data for output</td>
<td valign="top">Single values: <b><u>*DFT</u></b>, *ALL<br>Other values (up to 24 repetitions): *DSTINFO, *MSG, *DOCD, *CRTDATE, *EXPDATE, *DOCDATE, *FILDATE, *CHGDATE, *ACTDATE, *CMPDATE, *AUTHOR, *CPYLST, *DOCCLS, *FILCAB, *SUBJECT, *KWD, *REF, *STATUS, *PROJECT, *RPYDATE, *AUTUSR, *DSTEXPDATE, *IDP, *DOC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCVDST.ACKRCV"><b>ACKRCV</b></a></td>
<td valign="top">Acknowledge receipt</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RCVDST.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="#RCVDST.KEEP"><b>KEEP</b></a></td>
<td valign="top">Keep in mail log</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RCVDST.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="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RCVDST.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 received. 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="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.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="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.DOC"></a>
<h3>Document (DOC)</h3>
<p>Specifies the name of the document object in which the distribution is placed when it is received. This document must not already exist and it is created as a private document. The document is either owned by you, or by an authority-granting user for whom you work.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The distribution being received is not placed in a document object.
</dd>
<dt><b><i>document-name</i></b></dt>
<dd>Specify the name of the document in which the distribution is placed. A maximum of 12 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.FLR"></a>
<h3>In folder (FLR)</h3>
<p>Specifies the name of the folder that contains the document receiving the distribution. The folder must already exist and you must have the authority to create new documents in the folder.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The document being received is not placed in a folder. Specify this value if the document is received into a database file for processing and <b>Document</b>(DOC parameter) is not specified.
</dd>
<dt><b><i>folder-name</i></b></dt>
<dd>Specify the name of the folder that contains the document. A folder name can consist of a series of folder names if the document is located in a folder contained within another folder. A maximum of 63 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the name and library of the database file to which the output is directed. If the output file does not exist, this command creates a database file in the specified library. The authority for users with no specific authority is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The output is not directed to a database file.
</dd>
<dt><b><i>data-base-file-name</i></b></dt>
<dd>Specify the name of the database file that receives the output.
</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 entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the library where the database file is located.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, the system uses QAOSIRCV in QSYS with a format name of OSRCVD as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<p>The possible <b>member to receive output</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If the member does not exist, the system creates a member with the name of the file specified on the <b>File to receive output</b> prompt (OUTFILE parameter).
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If the member does not exist, the system creates the file member. If the member already exists, the system adds records to the end of the member or clears the member and then adds the records.
</dd>
</dl>
<p>The possible <b>add or replace</b> values are:
</p>
<dl>
</dl>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The system clears the existing member and adds the new records.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*ADD</b></dt>
<dd>The system adds the new records to the end of the existing records.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.OUTDTATYP"></a>
<h3>Type of data for output (OUTDTATYP)</h3>
<p>Specifies which type of distribution data is written to the database file.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The following record codes are written to the output file:
<dl>
<dt><b>Record code</b></dt>
<dd><b> Description
</b></dd>
<dt><b>010</b></dt>
<dd>Distribution Description
</dd>
<dt><b>020</b></dt>
<dd>Message Text
</dd>
<dt><b>105</b></dt>
<dd>Document Description
</dd>
<dt><b>800</b></dt>
<dd>Document Data
</dd>
</dl>
</dd>
<dt><b>*ALL</b></dt>
<dd>All record formats are written to the output file.
</dd>
<dt><b>*DSTINFO</b></dt>
<dd>The distribution description record is written. The record code is 010.
</dd>
<dt><b>*MSG</b></dt>
<dd>The message text record is written. The record code is 020.
</dd>
<dt><b>*DOCD</b></dt>
<dd>The document description record is written. The record code is 105.
</dd>
<dt><b>*DOCCLS</b></dt>
<dd>The document class record is written. The record code is 155.
</dd>
<dt><b>*SUBJECT</b></dt>
<dd>The subject records are written. The record code is 165.
</dd>
<dt><b>*FILCAB</b></dt>
<dd>The file cabinet reference record is written. The record code is 160.
</dd>
<dt><b>*AUTHOR</b></dt>
<dd>The author records are written. The record code is 145.
</dd>
<dt><b>*KWD</b></dt>
<dd>The keyword records are written. The record code is 170.
</dd>
<dt><b>*CPYLST</b></dt>
<dd>The copy list records are written. The record code is 150.
</dd>
<dt><b>*FILDATE</b></dt>
<dd>The file date record is written. The record code is 125.
</dd>
<dt><b>*EXPDATE</b></dt>
<dd>The expiration date record is written. The record code is 115.
</dd>
<dt><b>*DOCDATE</b></dt>
<dd>The document date record is written. The record code is 120.
</dd>
<dt><b>*CRTDATE</b></dt>
<dd>The create date record is written. The record code is 110.
</dd>
<dt><b>*ACTDATE</b></dt>
<dd>The action due date record is written. The record code is 135.
</dd>
<dt><b>*CHGDATE</b></dt>
<dd>The date last changed record is written. The record code is 130.
</dd>
<dt><b>*CMPDATE</b></dt>
<dd>The completion date record is written. The record code is 140.
</dd>
<dt><b>*REF</b></dt>
<dd>The reference record is written. The record code is 175.
</dd>
<dt><b>*STATUS</b></dt>
<dd>The status record is written. The record code is 180.
</dd>
<dt><b>*PROJECT</b></dt>
<dd>The project record is written. The record code is 185.
</dd>
<dt><b>*AUTUSR</b></dt>
<dd>The authorizing Userid and Address is written. This is the user that authorized the content of this distribution. The record code is 190.
</dd>
<dt><b>*DSTEXPDATE</b></dt>
<dd>The distribution expiration date and time is written. The record code is 195.
</dd>
<dt><b>*RPYDATE</b></dt>
<dd>The reply requested date and time is written. The record code is 200.
</dd>
<dt><b>*IDP</b></dt>
<dd>The interchange document profile (IDP) is written. The record code is 500.
</dd>
</dl>
<dl>
<dt><b>*DOC</b></dt>
<dd>The document data records are written. The record code is 800.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.ACKRCV"></a>
<h3>Acknowledge receipt (ACKRCV)</h3>
<p>Specifies whether a confirmation of delivery (acknowledgement) is sent back to the sender of the distribution.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The confirmation of delivery (COD) is sent back to the sender.
</dd>
<dt><b>*NO</b></dt>
<dd>The confirmation of delivery is not sent back to the sender.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.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="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.KEEP"></a>
<h3>Keep in mail log (KEEP)</h3>
<p>Specifies whether the received distribution is deleted from the mail log or kept in the mail log.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>When all the information requested has been written to the OUTFILE or DOC, the distribution is removed from the user's incoming mail.
</dd>
<dt><b>*YES</b></dt>
<dd>When all the information requested has been written to the OUTFILE or to DOC, the distribution is not removed from the user's incoming mail.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RCVDST.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="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RCVDST.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Receiving Current User Distribution</b>
</p>
<p>
<pre>
RCVDST DISTID('SYSTEM1 USERA 0001')
OUTFILE(MYLIB/MYFILE) OUTMBR(MYMBR *ADD)
OUTDTATYP(*ALL) CMDCHRID(*DEVD)
</pre>
</p>
<p>This command receives the current user distribution into output file MYFILE located in library MYLIB. The distribution is added to member MYMBR. All output file information is added to the output file MYFILE.
</p>
<p><b>Example 2: Receiving Distribution Sent to a User</b>
</p>
<p>
<pre>
RCVDST DSTID('BAKER RCH38P 0019') DSTINDEXN(01)
OUTFILE(JOWLIB/DOCUMENTS) USRID(*CURRENT)
</pre>
</p>
<p>This command receives a distribution that was sent to a user. It is copied into the first member in a database file called DOCUMENTS in a library called JOWLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RCVDST.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>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>
<dt><b>CPF9098</b></dt>
<dd>Distribution not received.
</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>
<dt><b>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RCVDST.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>