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

106 lines
6.6 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="reference" />
<meta name="DC.Title" content="SFLFOLD (Subfile Fold) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword on the subfile control record format to assign a command attention (CA) or a command function (CF) key that the workstation user can press to truncate or to fold subfile records that require more than one display line." />
<meta name="description" content="Use this record-level keyword on the subfile control record format to assign a command attention (CA) or a command function (CF) key that the workstation user can press to truncate or to fold subfile records that require more than one display line." />
<meta name="DC.subject" content="SFLFOLD (Subfile Fold) keyword, Subfile Fold (SFLFOLD) keyword" />
<meta name="keywords" content="SFLFOLD (Subfile Fold) keyword, Subfile Fold (SFLFOLD) 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="rzakcmstdfsfold" />
<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>SFLFOLD (Subfile Fold) keyword for display files</title>
</head>
<body id="rzakcmstdfsfold"><a name="rzakcmstdfsfold"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLFOLD (Subfile Fold) keyword for display files</h1>
<div><p>Use this record-level keyword on the subfile control record format
to assign a command attention (CA) or a command function (CF) key that the
workstation user can press to truncate or to fold subfile records that require
more than one display line.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>SFLFOLD(CAnn | CFnn)</pre>
</div>
<p>When
the SFLFOLD keyword is specified, the subfile is first displayed in folded
form. When the workstation user presses the specified key, the <span class="keyword">i5/OS™</span> operating system
displays the records again in truncated form. By pressing the specified key,
the form of the displayed subfile changes from one state to the other. When
truncated, subfile records fit on one display line.</p>
<p>Without SFLFOLD,
the <span class="keyword">i5/OS</span> operating system displays
the entire subfile record folded where needed but the workstation user is
not given the option to display the subfile record in truncated form.</p>
<p>In
the folded form, as many records are displayed as are specified on the SFLPAG
keyword. In the truncated form, more records are displayed than are specified
on the SFLPAG keyword.</p>
<div class="p">The <span class="keyword">i5/OS</span> operating system
truncates subfile records in the middle of output-only fields. However, if
the truncation is in the middle of an input-capable field, the whole field
is omitted from the display. If this results in omitting the entire record
from the display, an error message is sent to the display and the record is
not truncated. Instead, it is displayed in folded form. <div class="note"><span class="notetitle">Notes:</span> <ol><li>A warning message (severity 10) is sent at file creation if the entire
record fits on a single display line.</li>
<li>If subfile size equals subfile page, an error message (severity 20) is
issued and SFLFOLD is ignored. When several display sizes are used (DSPSIZ
keyword specified), SFLFOLD is ignored only for display sizes for which the
subfile size equals subfile page. If the subfile record format contains field
selection, SFLFOLD is not valid.</li>
<li>If the subfile contains input-capable fields, it is recommended that you
specify a CF key rather than a CA key. If you specify a CA key in this situation,
changed data is lost when the key is pressed.</li>
<li>If several subfiles using SFLFOLD are displayed at one time, the same
function key should be specified on each SFLFOLD keyword. If the function
keys are different, only the key specified for the most recently displayed
subfile is in effect. Pressing the function key affects the subfile containing
the cursor. If the cursor is not positioned in a subfile, the function key
affects the upper subfile.</li>
<li>SFLFOLD can be specified on the same subfile control record format as
the SFLDROP keyword. If both keywords are active, SFLFOLD is used. Indicators
are checked at the time the subfile is displayed. Both keywords must use the
same key.</li>
</ol>
</div>
</div>
<p>Option indicators are valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the SFLFOLD keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
00020A*
00030A* (subfile records should not fit on one screen line)
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(34)
00070A SFLDSP SFLDSPCTL
00080A SFLFOLD(CF03)
A</pre>
<p>When the subfile is displayed, the workstation user can
press the CF03 key to change the subfile from folded to truncated form and
from truncated to folded form.</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>