ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/prref.htm

89 lines
6.0 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="concept" />
<meta name="DC.Title" content="Reference for printer files (position 29)" />
<meta name="abstract" content="Use this position to specify R in position 29 to copy the attributes of a previously defined named field (the referenced field) to the field that you are defining. (If you do not specify R, you must specify the field attributes.)" />
<meta name="description" content="Use this position to specify R in position 29 to copy the attributes of a previously defined named field (the referenced field) to the field that you are defining. (If you do not specify R, you must specify the field attributes.)" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstposy1.htm" />
<meta name="DC.Relation" scheme="URI" content="../dds/specref.htm" />
<meta name="DC.Relation" scheme="URI" content="prtlen.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstptreffl.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="prref" />
<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 printer files (position 29)</title>
</head>
<body id="prref"><a name="prref"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Reference for printer files (position 29)</h1>
<div><p>Use this position to specify R in position 29 to copy the attributes
of a previously defined named field (the <em>referenced field</em>) to the field
that you are defining. (If you do not specify R, you must specify the field
attributes.) </p>
<p>For example, you might want to reference fields for
an externally defined file to print a report from a database file.</p>
<p>When using the reference function, specify the referenced field name, even
if it is the same as the referencing field. (The referenced field name can
be in a previously created database file specified on the REF or REFFLD keywords.)
The field attributes referenced are the length, data type, and decimal positions
of the field, as well as the ALIAS, FLTPCN, TEXT, DATFMT, DATSEP, TIMFMT,
TIMSEP, and editing keywords.</p>
<p>If the referenced field name is the same as the field that you are defining,
specify R in position 29 and the name of the field that you are defining in
positions 19 through 28. If the referenced field is different from the field
that you are defining, specify the name of the referenced field with the REFFLD
keyword.</p>
<p>Position 29 must be blank at the file and record levels.</p>
<p>You can specify the name of the file defining the referenced field as a
parameter value with the REF or the REFFLD keyword.</p>
<div class="p">If you do not want to copy all the attributes from the previously defined
field, specify those attributes for the field that you are defining, as follows:
<ul><li>To override editing keywords (EDTCDE or EDTWRD), specify EDTCDE or EDTWRD
for the field that you are defining. To delete these keywords, specify DLTEDT
for the field that you are defining.</li>
<li>Validity checking keywords (CHECK, COMP, RANGE, VALUES), if specified
for the referenced field, are ignored in the printer file.</li>
</ul>
</div>
<div class="p">When you override some specifications, others are affected: <ul><li>If you specify a value for data type, field length, or decimal positions
for the field that you are defining, editing keywords are not copied from
the referenced field.</li>
<li>Packed decimal and binary fields are not supported for printer files.
Therefore, when you reference fields of these types, the data type is converted
to zoned decimal (S in position 35) in the printer file.</li>
</ul>
<div class="note"><span class="notetitle">Note:</span> After the printer file is created, the referenced
file can be deleted or changed without affecting the field definitions in
the printer file. To incorporate changes made in the referenced file, delete
and re-create the printer file.</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakdmstposy1.htm" title="You can find how to specify the first 44 positions of the data description specifications form for printer files in this topic.">Positional entries for printer files (positions 1 through 44)</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../dds/specref.htm">When to specify REF and REFFLD keywords for DDS files</a></div>
<div><a href="prtlen.htm" title="Use these positions to specify the field length for each named field (unless you copy it from a referenced field).">Length for printer files (positions 30 through 34)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rzakdmstptreffl.htm" title="Use this field-level keyword when referring to a field under one of these three conditions in this topic.">REFFLD (Referenced Field) keyword in printer files</a></div>
</div>
</div>
</body>
</html>