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

100 lines
6.4 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="SFLRNA (Subfile Records Not Active) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword with the Subfile Initialize (SFLINZ) keyword on the subfile control record format so that your program can initialize a subfile with no active records. To do this, your program sends an output operation to the subfile control record format with the SFLINZ keyword selected." />
<meta name="description" content="Use this record-level keyword with the Subfile Initialize (SFLINZ) keyword on the subfile control record format so that your program can initialize a subfile with no active records. To do this, your program sends an output operation to the subfile control record format with the SFLINZ keyword selected." />
<meta name="DC.subject" content="SFLRNA (Subfile Records Not Active) keyword, Subfile Records Not Active (SFLRNA) keyword" />
<meta name="keywords" content="SFLRNA (Subfile Records Not Active) keyword, Subfile Records Not Active (SFLRNA) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsflnz.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="rzakcmstdfsfrna" />
<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>SFLRNA (Subfile Records Not Active) keyword for display files</title>
</head>
<body id="rzakcmstdfsfrna"><a name="rzakcmstdfsfrna"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLRNA (Subfile Records Not Active) keyword for display files</h1>
<div><p>Use this record-level keyword with the Subfile Initialize (SFLINZ)
keyword on the subfile control record format so that your program can initialize
a subfile with no active records. To do this, your program sends an output
operation to the subfile control record format with the SFLINZ keyword selected.</p>
<div class="section"><div class="p">The subfile itself becomes active. Subfile records
are not considered active unless one of the following conditions occurs: <ul><li>Your program sends an output operation to the subfile record format, placing
data in one of the subfile records. The subfile record becomes active but
is not considered changed unless the SFLNXTCHG keyword is also in effect.</li>
<li>After your program displays the subfile, the workstation user types data
into subfile records. The records typed in become active and
changed.</li>
</ul>
</div>
<p>This keyword has no parameters.</p>
<p>SFLRNA is normally used
so that a program can write some records to the subfile before displaying
it, and the workstation user can then add records to the subfile.</p>
<div class="p">When
your program displays a subfile initialized with the SFLINZ and SFLRNA keywords
in effect, fields in inactive records have the following values: <ul><li>Character fields are blank.</li>
<li>Numeric fields are zero-filled.</li>
<li>An input-only field with a constant value specified has the constant value.</li>
</ul>
</div>
<p>Your program cannot send an input operation to an inactive subfile
record. Issuing a get-next-changed operation to one of the subfile records
returns the record only when the record has become active and has been changed.</p>
<p>Your
program cannot send output operations to active records (SFLRNA not specified).
It must send update operations. Also, your program cannot send update operations
to inactive records (SFLRNA specified). It must send output operations.</p>
<p>The
SFLINZ keyword is required when SFLRNA is specified.</p>
<p>SFLRNA cannot be
specified for a message subfile (identified by the SFLMSGRCD keyword on the
subfile record format).</p>
<p>If the subfile record format contains field
selection, SFLRNA is not valid.</p>
<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 SFLRNA keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
A*
A* (at least one displayable field)
A*
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(17)
00070A SFLDSP SFLDSPCTL
00080A SFLINZ
00090A SFLRNA
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="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfsflnz.htm" title="Use this record-level keyword on the subfile control record format to specify that the i5/OS operating system is to initialize all records in the subfile on an output operation to the subfile control record format (identified by the SFLCTL keyword).">SFLINZ (Subfile Initialize) keyword for display files</a></div>
</div>
</div>
</body>
</html>