125 lines
8.3 KiB
HTML
125 lines
8.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="concept" />
|
||
|
|
<meta name="DC.Title" content="Reference for display files (position 29)" />
|
||
|
|
<meta name="abstract" content="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." />
|
||
|
|
<meta name="description" content="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." />
|
||
|
|
<meta name="DC.subject" content="reference positional entry" />
|
||
|
|
<meta name="keywords" content="reference positional entry" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstpsnent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfref.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfrefld.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../dds/specref.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="pos3034.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfrefld.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="rzakcmstpos29" />
|
||
|
|
<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>Reference for display files (position 29)</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstpos29"><a name="rzakcmstpos29"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Reference for display files (position 29)</h1>
|
||
|
|
<div><p>You can specify R in this position to use the reference function
|
||
|
|
of the <span class="keyword">i5/OS™</span> operating
|
||
|
|
system to copy the attributes of a previously defined named field (called
|
||
|
|
the <dfn class="term">referenced field</dfn>) to the field you are defining.</p>
|
||
|
|
<div class="p">The referenced field can be previously defined in either the display file
|
||
|
|
you are defining or a previously created database file (the database file
|
||
|
|
to be referred to is specified with the REF or REFFLD keyword). The field
|
||
|
|
attributes referred to are the length, data type, and decimal positions of
|
||
|
|
the field, as well as the following keywords: <ul><li>ALIAS (alternative name)</li>
|
||
|
|
<li>CCSID (Coded Character Set Identifier)</li>
|
||
|
|
<li>FLTPCN (floating-point precision)</li>
|
||
|
|
<li>TEXT</li>
|
||
|
|
<li>DATFMT</li>
|
||
|
|
<li>DATSEP</li>
|
||
|
|
<li>TIMFMT</li>
|
||
|
|
<li>TIMSEP</li>
|
||
|
|
<li>Editing and validity checking keywords</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>If you do not specify R, you cannot use the reference function for this
|
||
|
|
field and you must specify field attributes for this field.</p>
|
||
|
|
<p>Position 29 must be blank at the file, record, and help levels.</p>
|
||
|
|
<p>If the name of the referenced field is the same as the field you are defining,
|
||
|
|
you need only specify R in position 29 (in addition to specifying the name
|
||
|
|
of the field you are defining in positions 19 through 28). If the name of
|
||
|
|
the field you are defining is different from the name of the referenced field
|
||
|
|
you must specify the name of the referenced field with the REFFLD (Referenced
|
||
|
|
Field) keyword.</p>
|
||
|
|
<p>You can specify the name of the file defining the referenced
|
||
|
|
field as a parameter value with the REF (Reference) or the REFFLD keyword.</p>
|
||
|
|
<div class="p">You do not need to copy all attributes from the previously defined field
|
||
|
|
to the field you are defining. To override specific attributes of the referenced
|
||
|
|
field, specify those attributes for the field you are defining as follows: <ul><li>To override the EDTCDE (Edit Code) or EDTWRD (Edit Word) keywords, specify
|
||
|
|
EDTCDE or EDTWRD for the field you are defining. You can delete these keywords
|
||
|
|
by specifying the DLTEDT (Delete Edit) keyword for the field you are defining.</li>
|
||
|
|
<li>To override the CHECK (Check), COMP (Comparison), RANGE (Range), and VALUES
|
||
|
|
(Values) validity checking keywords and the CHKMSGID (Check Message Identifier)
|
||
|
|
keyword, specify any validity checking keyword for the field you are defining.
|
||
|
|
You can delete these keywords by specifying the DLTCHK (Delete Check) keyword
|
||
|
|
for the field you are defining.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="p">When you override some specifications, others are also affected, as follows:
|
||
|
|
<ul><li>If you specify keyboard shift attribute, field length, or decimal positions
|
||
|
|
for the field you are defining, neither editing nor validity checking keywords
|
||
|
|
are copied from the referenced field.</li>
|
||
|
|
<li>If you override the previously defined data type to character (by specifying
|
||
|
|
M, A, X, or W in position 35), decimal positions are not copied. However,
|
||
|
|
if you specify N, D, or I in position 35 and leave blanks in positions 36
|
||
|
|
and 37 (decimal positions), the field you define has the decimal positions
|
||
|
|
of the referenced field. For D, the decimal positions must be zero.</li>
|
||
|
|
<li>Packed decimal and binary fields are not supported for display files.
|
||
|
|
Therefore, when you refer to fields of these types, the data type assigned
|
||
|
|
is zoned decimal with a keyboard shift as follows: <ul><li>If editing is in effect for the field you are defining, the keyboard shift
|
||
|
|
is numeric only (Y in position 35).</li>
|
||
|
|
<li>If no editing is in effect for the field you are defining, the keyboard
|
||
|
|
shift is signed numeric (S in position 35).</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>When the referenced field contains the REFSHIFT (Reference Shift) keyword,
|
||
|
|
the value specified for REFSHIFT is used as the display file keyboard shift.
|
||
|
|
However, if the data type specified for the new field is not compatible with
|
||
|
|
the keyboard shift specified on the REFSHIFT keyword, the keyword is not copied
|
||
|
|
to the new field.</li>
|
||
|
|
</ul>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> After the display file is created, you can delete
|
||
|
|
or change the referenced file without affecting the field descriptions in
|
||
|
|
the display file. Delete and create the display file again to incorporate
|
||
|
|
changes made in the referenced file.</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstpsnent.htm" title="Use this information to specify the first 44 positions of the data description specifications (DDS) form for display files.">Positional entries for display files (positions 1 through 44)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="pos3034.htm" title="You must specify a length for each named field unless you are copying the length from a referenced field.">Length for display files (positions 30 through 34)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzakcmstdfref.htm" title="Use this file-level keyword to specify the name of a file from which field descriptions are to be retrieved or when you want to duplicate descriptive information from several fields in a previously described record format.">REF (Reference) keyword for display files</a></div>
|
||
|
|
<div><a href="rzakcmstdfrefld.htm" title="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.">REFFLD (Referenced Field) keyword for display files</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../dds/specref.htm" target="_blank">When to specify REF and REFLD keywords for DDS files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|