ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzake_5.4.0.1/rzakemsticfreff.htm

107 lines
6.3 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="REFFLD (Referenced Field) keyword for ICF files" />
<meta name="abstract" content="Use this field-level keyword when referring to a field under one of the several conditions." />
<meta name="description" content="Use this field-level keyword when referring to a field under one of the several conditions." />
<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="rzakemstckeyw.htm" />
<meta name="DC.Relation" scheme="URI" content="ref290.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="icfreff" />
<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>ICF Files, REFFLD</title>
</head>
<body id="icfreff"><a name="icfreff"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">REFFLD (Referenced Field) keyword for ICF files</h1>
<div><p><span>Use this field-level keyword when referring
to a field under one of the several conditions.</span></p>
<div class="section"><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 class="p">The format of the keyword is: <pre>REFFLD([record-format-name/]referenced-field-name [ {*SRC |
[library-name/]database-file-name}])</pre>
</div>
<div class="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, the library-name, and the REF keyword are not specified.
<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>
</div>
<p>Specify
the database-file-name (qualified by its library-name if necessary) when you
want to search a particular database file.</p>
<p>If,
in the same DDS source file, you specify REF at the file level and REFFLD
at the field level, the particular search sequence depends on both the REF
and REFFLD keywords. For more information, see the topic <a href="../dds/specref.htm">When to specify REF and REFFLD keywords
for DDS files</a>.</p>
<p>The letter R must be specified in position 29.
In some cases, if you specify a value for length, some keywords specified
with the field in the database file are not included in the ICF file. For
more information, see <a href="ref290.htm#ref290">Reference for ICF files (position 29)</a>.</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 the library-name are the DDM
file and library name 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> Interactive
data definition utility (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
00030A ITEM1 R REFFLD(ITEM)
00040A ITEM2 R REFFLD(FMAT1/ITEM)
00050A ITEM3 R REFFLD(ITEM FILEX)
00060A ITEM4 R REFFLD(ITEM LIBY/FILEX)
00070A ITEM5 R REFFLD(FMAT1/ITEM LIBY/FILEX)
00080A ITEM6 R REFFLD(ITEM *SCR)
A</pre>
<p>Because the REF keyword is not specified, the default
for lines 00030 and 00040 is to search the DDS source file in which they are
specified. In line 00080, the parameter value *SRC explicitly specifies the
source file.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakemstckeyw.htm" title="These topics contain the keyword entries that you can specify when you define ICF files.">DDS keyword entries for ICF files (positions 45 through 80)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="ref290.htm" title="Specify R in this position to use the reference function of the program to copy the attributes of a previously defined named field (called the referenced field) to the field you are defining.">Reference for ICF files (position 29)</a></div>
</div>
</div>
</body>
</html>