93 lines
5.8 KiB
HTML
93 lines
5.8 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="RTNDTA (Return Data) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this record-level keyword to specify that, when your program sends an input operation to this record format, the i5/OS operating system is to return the same data that was returned on the previous input operation sent to this record format." />
|
||
|
|
<meta name="description" content="Use this record-level keyword to specify that, when your program sends an input operation to this record format, the i5/OS operating system is to return the same data that was returned on the previous input operation sent to this record format." />
|
||
|
|
<meta name="DC.subject" content="RTNDTA (Return Data) keyword, Return Data (RTNDTA) keyword" />
|
||
|
|
<meta name="keywords" content="RTNDTA (Return Data) keyword, Return Data (RTNDTA) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzakcmstdfrtndt" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>RTNDTA (Return Data) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfrtndt"><a name="rzakcmstdfrtndt"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">RTNDTA (Return Data) keyword for display files</h1>
|
||
|
|
<div><p>Use this record-level keyword to specify that, when your program
|
||
|
|
sends an input operation to this record format, the <span class="keyword">i5/OS™</span> operating system
|
||
|
|
is to return the same data that was returned on the previous input operation
|
||
|
|
sent to this record format.</p>
|
||
|
|
<div class="section"><p>The RTNDTA keyword is ignored if the record format has not already
|
||
|
|
been read. When the RTNDTA keyword is in effect, your program can reread data
|
||
|
|
on the display without requiring the <span class="keyword">i5/OS</span> operating system
|
||
|
|
to actually pass data from the display device to your program.</p>
|
||
|
|
<p>This
|
||
|
|
keyword has no parameters.</p>
|
||
|
|
<div class="p">The RTNDTA keyword is ignored in the following
|
||
|
|
situations: <ul><li>On the input portion of an input/output operation (Put-Get operation)</li>
|
||
|
|
<li>On an input operation that is preceded by an output operation to the same
|
||
|
|
record format</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The RTNDTA keyword has effect only on an input operation sent
|
||
|
|
to the same record format without an intervening output operation to that
|
||
|
|
record format.</p>
|
||
|
|
<div class="p">You can use RTNDTA as follows: <ul><li>Use RTNDTA to allow a main program to read a record format that is changed
|
||
|
|
by a workstation user. The data read tells the main program which subprogram
|
||
|
|
to call. The subprogram sends an input operation to the same record format,
|
||
|
|
with RTNDTA in effect, to read the same data. This procedure can substitute
|
||
|
|
for passing parameters to subprograms. <div class="note"><span class="notetitle">Note:</span> SHARE(*YES) must be specified
|
||
|
|
for both display files.</div>
|
||
|
|
</li>
|
||
|
|
<li>Use RTNDTA to allow an RPG III program to perform file maintenance with
|
||
|
|
less locking of records in the database. For instance, the program reads a
|
||
|
|
database record and displays the record at the display device. The workstation
|
||
|
|
user reviews the record, makes any required changes, and presses the Enter
|
||
|
|
key. While the workstation user is making changes, the database record, if
|
||
|
|
locked, is unavailable to other programs. Hence it is recommended to leave
|
||
|
|
the database record unlocked. However, when the program reads the record from
|
||
|
|
the display and updates the database record, the database record overlays
|
||
|
|
the internal representation of the display record in the program. Instead
|
||
|
|
of preventing the overlay by using different field names for the display record
|
||
|
|
and the database record, the program rereads the display file. With RTNDTA
|
||
|
|
specified, the program retrieves the display record again and can then finish
|
||
|
|
updating the database.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>If the UNLOCK keyword is specified, the RTNDTA keyword cannot
|
||
|
|
be specified.</p>
|
||
|
|
<p>Option indicators are not valid for this keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the RTNDTA keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R RECORD1 RTNDTA
|
||
|
|
00020A FLD1 5 I 2 2
|
||
|
|
00030A FLD2 5 B 3 2
|
||
|
|
A</pre>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|