ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakb_5.4.0.1/rzakbmstpreffld.htm

109 lines
6.4 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—physical files only" />
<meta name="abstract" content="Use this field-level keyword to refer to a field under one of these three conditions." />
<meta name="description" content="Use this field-level keyword to refer to a field under one of these three 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="rzakbmstlfkeyw.htm" />
<meta name="DC.Relation" scheme="URI" content="pfrefer.htm" />
<meta name="DC.Relation" scheme="URI" content="pfrefer.htm" />
<meta name="DC.Relation" scheme="URI" content="../dds/specref.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="preffld" />
<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>Physical and Logical Files, REFFLD</title>
</head>
<body id="preffld"><a name="preffld"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">REFFLD (Referenced Field) keyword—physical files only</h1>
<div><p>Use this field-level keyword to refer to a field under one of these
three conditions.</p>
<div class="section"><div class="p">These conditions are: <ul><li>When the name of the referenced field is different from the name in positions
19 through 28</li>
<li>When 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>When 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>
<div class="p">The referenced-field-name
is required even if it is the same as the name of the field being defined.
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 field
name being referred to is in the same DDS source file as the field being defined.
*SRC is the default value when the database-file-name and the library-name
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 being referred to must precede the field being defined.</div>
</div>
<p>Specify
the database-file-name (with its library-name, if necessary) to search a particular
database file.</p>
<p>An R must be in position 29. Some keywords specified
with the field being referred to are not included on the field being defined.
For more information, see the Reference for physical and logical files (position
29) topic.</p>
<p>If you specify REF at the file level and
REFFLD at the field level in the same DDS source file, the REFFLD specification
is used. The search sequence depends on both the REF and REFFLD keywords.</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> Interactive data definition utility (IDDU)
files cannot be used as reference files.</div>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to code
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>The default for lines 00030 and 00040
is to search the DDS source file where they are specified because the REF
keyword is not specified. In line 00080, the parameter *SRC explicitly specifies
this source file.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakbmstlfkeyw.htm" title="This topic lists valid keyword entries for describing physical and logical files. They are typed in positions 45 through 80 (functions).">Keyword entries for physical and logical files (positions 45 through 80)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="pfrefer.htm" title="You use this position to specify reference for physical files only.">Reference for physical and logical files (position 29)</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../dds/specref.htm">When to specify REF and REFFLD keywords for DDS files</a></div>
</div>
</div>
</body>
</html>