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

457 lines
16 KiB
HTML
Raw Permalink 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>Replace Document (RPLDOC)</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="RPLDOC.Top_Of_Page"></a>
<h2>Replace Document (RPLDOC)</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="#RPLDOC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RPLDOC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RPLDOC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RPLDOC"></a>
<p>The Replace Document (RPLDOC) command is used to replace the document content and the interchange document profile (IDP) of a document that exists in the document library. This command places the new version of the document back into the document library. The document must be checked out before the data can be replaced.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The document must be checked out with the Retrieve Document (RTVDOC) command by the user specified on the USRID parameter before using this command.
</li>
<li>The user must have at least change (*CHANGE) authority for the document, all object (*ALLOBJ) special authority, or be working on behalf of a user who is authorized for the document.
</li>
<li>Authority to work on behalf of another user is granted with the Grant User Permission (GRTUSRPMN) command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RPLDOC.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="#RPLDOC.TODOC"><b>TODOC</b></a></td>
<td valign="top">Document</td>
<td valign="top"><i>Character value</i>, *DOCID</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RPLDOC.TOFLR"><b>TOFLR</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" rowspan="3"><a href="#RPLDOC.DOCFILE"><b>DOCFILE</b></a></td>
<td valign="top">Document file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 2</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="#RPLDOC.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="#RPLDOC.DOCPART"><b>DOCPART</b></a></td>
<td valign="top">Document part</td>
<td valign="top"><b><u>*DOC</u></b>, *IDP, *BOTH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RPLDOC.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="#RPLDOC.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"><a href="#RPLDOC.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" rowspan="3"><a href="#RPLDOC.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" rowspan="3"><a href="#RPLDOC.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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RPLDOC.TODOC"></a>
<h3>Document (TODOC)</h3>
<p>Specifies the name of the document where the data is being placed, or that the <b>Document identifier (DOCID)</b> parameter is used to specify the library-assigned document name where the data is being placed.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-assigned name of the document to be replaced.
</dd>
<dt><b>*DOCID</b></dt>
<dd>The document being replaced is identified by the library-assigned document name specified on the DOCID parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.TOFLR"></a>
<h3>In folder (TOFLR)</h3>
<p>Specifies the name of the folder that contains the document being replaced.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No folder is specified when the document is identified on the <b>Document identifier (DOCID)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the folder that contains the document being replaced. A folder name can consist of a series of folder names if the document being replaced is located in a folder that is contained in another folder. A maximum of 63 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file that contains the document data.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</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>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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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>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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.DOCPART"></a>
<h3>Document part (DOCPART)</h3>
<p>Specifies the part of the document to be replaced.
</p>
<p>
<b>Note: </b>If you specify *BOTH and the replacement of one fails, neither is replaced and the document remains checked out.
</p>
<dl>
<dt><b><u>*DOC</u></b></dt>
<dd>Replace the document content only. If no document content records exist in the specified file, the document is replaced but a message is returned to alert the user that no document content was replaced.
</dd>
<dt><b>*IDP</b></dt>
<dd>Replace only the interchange document profile (IDP) of the document. If this value is specified, IDP records (record code 500) must exist in the specified file or the command fails.
</dd>
<dt><b>*BOTH</b></dt>
<dd>Replace both the document content and the IDP of the document. If this value is specified, IDP records (record code 500) must exist in the specified file or the command fails.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.USRID"></a>
<h3>User identifier (USRID)</h3>
<p>Specifies which user ID and user ID address should be associated with the request.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>You are performing the request for yourself.
</dd>
</dl>
<p><b>Element 1: User ID</b>
</p>
<dl>
<dt><b><i>character</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 all object (*ALLOBJ) special authority.
</dd>
</dl>
<p><b>Element 2: Address</b>
</p>
<dl>
<dt><b><i>character</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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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 (DOC)</b> parameter.
</dd>
<dt><b><i>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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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>2-65,535</i></b></dt>
<dd>Specify a document type identifier value. 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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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>
<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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RPLDOC.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>The value specified on the <b>User identifier (USRID)</b> parameter is translated to character set and code page '930 500'.
</p>
<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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RPLDOC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RPLDOC TODOC(*DOCID) DOCFILE(*LIBL/MYFILE) DOCPART(*BOTH)
DOCID('1987060710102053SYSTEM1') DOCTYPE(*FFT)
</pre>
</p>
<p>This command replaces the document data and IDP with data in the file MYFILE. The data is placed in the document identified by the document identifier '1987060710102053SYSTEM1'. The document type is changed to Final Form Text.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RPLDOC.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>CPF906A</b></dt>
<dd>Document not replaced in library.
</dd>
<dt><b>CPF9096</b></dt>
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
</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="#RPLDOC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>