ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdfrefld.htm

106 lines
6.5 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="REFFLD (Referenced Field) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to refer to a field when the name, record format, file, or library of the referenced field differs from its equivalent in positions 19 through 28." />
<meta name="description" content="Use this field-level keyword to refer to a field when the name, record format, file, or library of the referenced field differs from its equivalent in positions 19 through 28." />
<meta name="DC.subject" content="REFFLD (Referenced Field) keyword, Referenced Field (REFFLD) keyword" />
<meta name="keywords" content="REFFLD (Referenced Field) keyword, Referenced Field (REFFLD) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstpos29.htm" />
<meta name="DC.Relation" scheme="URI" content="../dds/specref.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstpos29.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="rzakcmstdfrefld" />
<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>REFFLD (Referenced Field) keyword for display files</title>
</head>
<body id="rzakcmstdfrefld"><a name="rzakcmstdfrefld"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">REFFLD (Referenced Field) keyword for display files</h1>
<div><p>Use this field-level keyword to refer to a field when the name,
record format, file, or library of the referenced field differs from its equivalent
in positions 19 through 28.</p>
<div class="section"><div class="p">Use this field-level keyword when referring to a field under one
of these conditions: <ul><li>The name of the referenced field is different from the name in positions
19 through 28.</li>
<li>The name of the referenced field is the same as the name in positions
19 through 28, but the record format, file, or library of the referenced field
is different from that specified with the REF keyword.</li>
<li>The referenced field occurs in the same DDS source file as the referencing
field.</li>
</ul>
</div>
<div class="p">The format of the keyword is: <pre>REFFLD([record-format-name/]referenced-field-name
[{*SRC | [library-name/]database-file-name}])</pre>
</div>
<p>The referenced-field-name
is required even if it is the same as the referencing field. Use the record
format name when the referenced file contains more than one record format.
Use *SRC (rather than the database-file-name) when the referenced field name
is in the same DDS source file as the referencing field. *SRC is the default
value when the database-file-name and library-name are not specified and the
REF keyword is not specified at the file level.</p>
<div class="note"><span class="notetitle">Note:</span> When you refer to
a field in the same DDS source file, the field you are referring to must precede
the field you are defining.</div>
<p>Specify the database-file-name (with
its library-name, if necessary) to search a particular database file.</p>
<p>If,
in the same DDS source file, you specify the REF keyword at the file level
and REFFLD at the field level, the particular search sequence depends on both
the REF and REFFLD keywords.</p>
<p>You must specify an R in position 29. In
some cases, some keywords specified with the field in the database file are
not included in the display file.</p>
<p>You can specify a distributed data
management (DDM) file on this keyword.</p>
<p>When using a DDM file, the database-file-name
and library-name are the DDM file and library names on the source system.
The referenced-field-name and the record-format-name are the field name and
the record format name in the remote file on the target system.</p>
<div class="note"><span class="notetitle">Note:</span> IDDU
files cannot be used as reference files.</div>
<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 REFFLD keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R FMAT1
00020A ITEM 5 3 1
00030A ITEM1 R 5 2REFFLD(ITEM)
00040A ITEM2 R 5 12REFFLD(FMAT1/ITEM)
00050A ITEM3 R 5 22REFFLD(ITEM FILEX)
00060A ITEM4 R 5 32REFFLD(ITEM LIBY/FILEX)
00070A ITEM5 R 5 42REFFLD(FMAT1/ITEM LIBY/FILEX)
00080A ITEM6 R 5 52REFFLD(ITEM *SRC)
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 class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzakcmstpos29.htm" title="You can specify R in this position to use the reference function of the i5/OS operating system to copy the attributes of a previously defined named field (called the referenced field) to the field you are defining.">Reference for display files (position 29)</a></div>
<div><a href="../dds/specref.htm">When to specify REF and REFFLD keywords for DDS files</a></div>
</div>
</div>
</body>
</html>