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

109 lines
7.5 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="SFLINZ (Subfile Initialize) keyword for display files" />
<meta name="abstract" content="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)." />
<meta name="description" content="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)." />
<meta name="DC.subject" content="SFLINZ (Subfile Initialize) keyword, Subfile Initialize (SFLINZ) keyword" />
<meta name="keywords" content="SFLINZ (Subfile Initialize) keyword, Subfile Initialize (SFLINZ) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfrna.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfpmq.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfmrc.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="rzakcmstdfsflnz" />
<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>SFLINZ (Subfile Initialize) keyword for display files</title>
</head>
<body id="rzakcmstdfsflnz"><a name="rzakcmstdfsflnz"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLINZ (Subfile Initialize) keyword for display files</h1>
<div><p>Use this record-level keyword on the subfile control record format
to specify that the <span class="keyword">i5/OS™</span> 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).</p>
<div class="section"><p>The fields in each subfile record are initialized to blanks for
character type fields, to nulls for floating-point type fields, to zeros for
other numeric type fields, or to the constant value specified on input-only
fields if the DFT keyword is specified.</p>
<p>When the subfile is displayed
(on an output operation to the subfile control record), all records in the
subfile are displayed with the same value. Any record previously written is
overwritten and no longer has its earlier value.</p>
<p>This keyword has no
parameters.</p>
<p>The following case is true when SFLINZ
is in effect on an output operation to the subfile control record format.
If keywords (such as DSPATR(HI)) are specified on fields in the subfile record
format and if option indicators are specified on those keywords, the subfile
is displayed as though all option indicators are off (hex F0). Note that a
keyword can be selected if N is specified for the option indicator.</p>
<p>After
your program sends an output operation to the subfile control record with
SFLINZ in effect, all records in the subfile are considered active but not
changed. They are considered changed only when the workstation user changes
them or when your program sends an output operation to the subfile record
format with the SFLNXTCHG keyword in effect.</p>
<p>To initialize a subfile
with no active records, use the SFLRNA (Subfile Records Not Active) keyword.</p>
<div class="p">In
general, use SFLINZ for the following purposes: <ul><li>Specify SFLINZ with the SFLRNA keyword so that your program can initialize
a subfile, then add records to that subfile without having the initialized
records considered active.</li>
<li>Specify SFLINZ with the SFLPGMQ keyword so that your program can build
a message subfile with a single output operation.</li>
</ul>
<div class="note"><span class="notetitle">Notes:</span> <ol><li>If field selection is used in the subfile record format, SFLINZ is not
valid. Your program can only initialize the subfile by a series of output
operations to the subfile record format, selecting fields as needed.</li>
<li>SFLINZ cannot be specified on the subfile control record format for a
message subfile (SFLMSGRCD) unless the SFLPGMQ keyword is also
specified at the field level in the same subfile control record format.</li>
</ol>
</div>
</div>
<p>Option indicators are valid for this keyword. Display
size condition names are not valid.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the SFLINZ keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
00020A*
00030A* (at least one displayable field)
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(17)
00070A 01 SFLDSP SFLDSPCTL
00080A 02 SFLINZ
00090A UNLOCK(*ERASE *MDTOFF)
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="rzakcmstdfsfrna.htm" title="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.">SFLRNA (Subfile Records Not Active) keyword for display files</a></div>
<div><a href="rzakcmstdfsfpmq.htm" title="Use this field-level keyword on the second (and last) field in the subfile record format for a message subfile.">SFLPGMQ (Subfile Program Message Queue) keyword for display files</a></div>
<div><a href="rzakcmstdfsfmrc.htm" title="Use this record-level keyword on the subfile record format to specify that this subfile is to be a message subfile and that the records displayed when the subfile is displayed are to be messages from a program message queue.">SFLMSGRCD (Subfile Message Record) keyword for display files</a></div>
</div>
</div>
</body>
</html>