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

85 lines
5.2 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="SFLCLR (Subfile Clear) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword on the subfile control record format so that your program can clear the subfile of all records. This keyword differs from the SFLDLT keyword in that the subfile is not deleted." />
<meta name="description" content="Use this record-level keyword on the subfile control record format so that your program can clear the subfile of all records. This keyword differs from the SFLDLT keyword in that the subfile is not deleted." />
<meta name="DC.subject" content="SFLCLR (Subfile Clear) keyword, Subfile Clear (SFLCLR) keyword" />
<meta name="keywords" content="SFLCLR (Subfile Clear) keyword, Subfile Clear (SFLCLR) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.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="rzakcmstdfsfclr" />
<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>SFLCLR (Subfile Clear) keyword for display files</title>
</head>
<body id="rzakcmstdfsfclr"><a name="rzakcmstdfsfclr"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLCLR (Subfile Clear) keyword for display files</h1>
<div><p>Use this record-level keyword on the subfile control record format
so that your program can clear the subfile of all records. This keyword differs
from the SFLDLT keyword in that the subfile is not deleted.</p>
<div class="section"><p>It differs from the SFLINZ keyword in that after being cleared,
the subfile contains no data. Clearing the subfile does not affect the display.
However, after being cleared, the subfile contains no active records.</p>
<p>This
keyword has no parameters.</p>
<p>When active records already exist in the
subfile and all are to be replaced, your program can send an output operation
to the subfile control record format after selecting SFLCLR. This clears the
subfile and permits your program to write new records to the subfile (by issuing
output operations to the subfile record format while incrementing the relative
record number). Issuing an output operation to an already active subfile record
causes an error message to be returned to your program.</p>
<p>If SFLCLR is
in effect on an output operation and no records exist in the subfile, SFLCLR
is ignored.</p>
<p>This optional keyword is valid only for the subfile control
record format. Display size condition names are not valid for this keyword.</p>
<p>An
option indicator is required for this keyword to prevent the <span class="keyword">i5/OS™</span> operating system
from clearing the subfile on every output operation to the subfile control
record format.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the SFLCLR keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
A*
A* (at least one displayable field)
A*
00020A R SFLCTLR SFLCTL(SFLR)
00030A SFLPAG(17)
00040A SFLSIZ(17)
00050A 01 SFLDSP
00060A 01 SFLDSPCTL
00070A N01 SFLCLR
A</pre>
<p>The subfile is displayed when option indicator 01 is
set on for an output operation to SFLCTLR, and the subfile is cleared when
option indicator 01 is set off for an output operation to SFLCTLR. Normally,
the option indicators specified for SFLCLR are the reverse of the option indicators
specified for the SFLDSP and SFLDSPCTL keywords.</p>
</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>
</body>
</html>