516 lines
18 KiB
HTML
516 lines
18 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>Retrieve Document (RTVDOC)</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="RTVDOC.Top_Of_Page"></a>
|
||
|
|
<h2>Retrieve Document (RTVDOC)</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="#RTVDOC.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RTVDOC.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RTVDOC.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RTVDOC"></a>
|
||
|
|
<p>The Retrieve Document (RTVDOC) command allows you to retrieve information from a specific document.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>To retrieve any records from the document to a database file, you must have use (*USE) authority to the document or be working on behalf of a user that has *USE authority to the document.
|
||
|
|
</li>
|
||
|
|
<li>To check out the document, you must have at least change (*CHANGE) authority to the document, or be working on behalf of a user that has *CHANGE authority to the document.
|
||
|
|
</li>
|
||
|
|
<li>To work on behalf of another user, you must have either all object (*ALLOBJ) special authority or special permission (granted with the Grant User Permission (GRTUSRPMN) command).
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RTVDOC.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="#RTVDOC.FROMDOC"><b>FROMDOC</b></a></td>
|
||
|
|
<td valign="top">From 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="#RTVDOC.FROMFLR"><b>FROMFLR</b></a></td>
|
||
|
|
<td valign="top">From folder</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" rowspan="3"><a href="#RTVDOC.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="#RTVDOC.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="#RTVDOC.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 21 repetitions): *DOCD, *DOCCLS, *SUBJECT, *AUTHOR, *FILCAB, *CPYLST, *KWD, *DOCDATE, *FILDATE, *CRTDATE, *CHGDATE, *EXPDATE, *ACTDATE, *CMPDATE, *REF, *STATUS, *PROJECT, *IDP, *DOC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#RTVDOC.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="#RTVDOC.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="#RTVDOC.CHKOUT"><b>CHKOUT</b></a></td>
|
||
|
|
<td valign="top">Check out</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="#RTVDOC.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="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RTVDOC.FROMDOC"></a>
|
||
|
|
<h3>From document (FROMDOC)</h3>
|
||
|
|
<p>Specifies the name of the document being retrieved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-assigned name of the document being retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOCID</b></dt>
|
||
|
|
<dd>The document being retrieved is identified by the library-assigned document name that must be specified on the <b>Document identifier (DOCID)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.FROMFLR"></a>
|
||
|
|
<h3>From folder (FROMFLR)</h3>
|
||
|
|
<p>Specifies the name of the folder that contains the document being retrieved. This is the name assigned to the folder when it is created. This parameter must be specified if a document name is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No folder name is specified when the document is identified by the library-assigned document name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the folder that contains the retrieved document.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.OUTFILE"></a>
|
||
|
|
<h3>File to receive output (OUTFILE)</h3>
|
||
|
|
<p>Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file 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>
|
||
|
|
<p><b>Qualifier 1: File to receive output</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the database file to which the command output is directed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If a new file is created, the system uses QAOSIRTV in QSYS with a format name of OSRTVD as a model.
|
||
|
|
</p>
|
||
|
|
<p>This file can be reused when other RTVDOC commands are used. Output can be added to the file or can replace the existing records. The IBM-supplied database file QAOSIRTV in library QSYS cannot be specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.OUTMBR"></a>
|
||
|
|
<h3>Output member options (OUTMBR)</h3>
|
||
|
|
<p>Specifies the name of the database file member that receives the output of the command.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Member to receive output</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the file member that receives the output. If it does not exist, the system creates it.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Replace or add records</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
||
|
|
<dd>The system clears the existing member and adds the new records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ADD</b></dt>
|
||
|
|
<dd>The system adds the new records to the end of the existing records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.OUTDTATYP"></a>
|
||
|
|
<h3>Type of data for output (OUTDTATYP)</h3>
|
||
|
|
<p>Specifies the parts of information about the document that are written to the database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DFT</u></b></dt>
|
||
|
|
<dd>The document information record is written. This is the same as specifying *DOCD and *DOC.
|
||
|
|
<ul>
|
||
|
|
<li>Record code - 105, Document description
|
||
|
|
</li>
|
||
|
|
<li>Record code - 800, Document data
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All information records are written.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ACTDATE</b></dt>
|
||
|
|
<dd>The action due date record is written. The record code is 135.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AUTHOR</b></dt>
|
||
|
|
<dd>The author records are written. The record code is 145.
|
||
|
|
</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>*CPYLST</b></dt>
|
||
|
|
<dd>The copy list records are written. The record code is 150.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CRTDATE</b></dt>
|
||
|
|
<dd>The create date record is written. The record code is 110.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOCCLS</b></dt>
|
||
|
|
<dd>The document class record is written. The record code is 155.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOCD</b></dt>
|
||
|
|
<dd>The document description record is written. The record code is 105.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DOCDATE</b></dt>
|
||
|
|
<dd>The document date record is written. The record code is 120.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EXPDATE</b></dt>
|
||
|
|
<dd>The expiration date record is written. The record code is 115.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILCAB</b></dt>
|
||
|
|
<dd>The file cabinet reference record is written. The record code is 160.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILDATE</b></dt>
|
||
|
|
<dd>The file date record is written. The record code is 125.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IDP</b></dt>
|
||
|
|
<dd>The interchange document profile (IDP) is written. The record code is 500.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IDXDATE</b></dt>
|
||
|
|
<dd>The last indexed date record is written to the output file. OfficeVision/400 text search services must be installed if this value is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*KWD</b></dt>
|
||
|
|
<dd>The keyword records are written. The record code is 170.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PROJECT</b></dt>
|
||
|
|
<dd>The project record is written. The record code is 185.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REF</b></dt>
|
||
|
|
<dd>The reference record is written. The record code is 175.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REVDATE</b></dt>
|
||
|
|
<dd>The date of the last revision to the document content is written to the output file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STATUS</b></dt>
|
||
|
|
<dd>The status record is written. The record code is 180.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SUBJECT</b></dt>
|
||
|
|
<dd>The subject records are written. The record code is 165.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USEDATE</b></dt>
|
||
|
|
<dd>The date last used record is written. The record code is 200.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DOC</b></dt>
|
||
|
|
<dd>The document data record is written. The record code is 800.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.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="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.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="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.CHKOUT"></a>
|
||
|
|
<h3>Check out (CHKOUT)</h3>
|
||
|
|
<p>Specifies that the document being retrieved can be replaced with new or changed data. If the document is read only, then specify *NO. If the document being retrieved cannot be replaced, and *YES is specified, this will cause an error to occur.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The retrieve request only reads the data. Users requesting this function need only read (*READ) authority to the document. Public authority is *READ authority.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The document data can be updated and replaced later. Users requesting this function must have change (*CHANGE) authority. The document will be unavailable for other users to update until the replacement of this document is done. The replacement can be done by using the Replace Document (RPLDOC) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVDOC.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="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVDOC.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Copying All Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RTVDOC FROMDOC(MYDOC) FROMFLR(PERSONAL) USRID(*CURRENT)
|
||
|
|
OUTFILE(*CURLIB/MYFILE) OUTMBR(*FIRST) MBROPT(*ADD)
|
||
|
|
OUTDTATYP(*ALL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command copies all information about document MYDOC located in folder PERSONAL for the current user of this command. CHECKOUT(*NO) is assumed; therefore, the document data can only be read. The output is directed to the database file MYFILE in the user's current library and is added to the first member in that file.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Copying Default Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RTVDOC FROMDOC(SECOP) FROMFLR(PERSONAL) USRID(MARY SYSTEM1 )
|
||
|
|
CHKOUT(*YES)
|
||
|
|
OUTFILE(MARLIB/SECFILE) OUTMBR(*FIRST *ADD)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command copies the default information (*DOCD and *DOC) about document SECOP located in folder PERSONAL for MARY. The document can be updated with new data and then replaced. The current user of this command must have the authority to work on behalf of MARY given by Mary by using the GRTUSRPMN command. The output is directed to the database file SECFILE in Mary's library MARLIB. The output is added to the first member of SECFILE.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVDOC.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 &1 &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>CPF905F</b></dt>
|
||
|
|
<dd>Retrieval of document from library failed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9096</b></dt>
|
||
|
|
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
|
||
|
|
</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="#RTVDOC.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|