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

107 lines
6.6 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="SFLDROP (Subfile Drop) 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 fold or to truncate 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 fold or to truncate subfile records that require more than one display line." />
<meta name="DC.subject" content="SFLDROP (Subfile Drop) keyword, Subfile Drop (SFLDROP) keyword" />
<meta name="keywords" content="SFLDROP (Subfile Drop) keyword, Subfile Drop (SFLDROP) 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="rzakcmstdfsdrop" />
<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>SFLDROP (Subfile Drop) keyword for display files</title>
</head>
<body id="rzakcmstdfsdrop"><a name="rzakcmstdfsdrop"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLDROP (Subfile Drop) 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 fold or to truncate subfile records that require
more than one display line.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>SFLDROP(CAnn | CFnn)</pre>
</div>
<p>Without
SFLDROP, the <span class="keyword">i5/OS™</span> operating system
displays the entire subfile record and folds it where needed. When SFLDROP
is specified, the <span class="keyword">i5/OS</span> operating system
first displays the subfile in truncated form; subfile records are truncated
to fit on one display line. When the workstation user presses the specified
key, the <span class="keyword">i5/OS</span> operating system
displays the records again in folded form. Each record continues onto subsequent
lines immediately following the line the record starts on.</p>
<p>By pressing
the specified key, the form of the displayed subfile changes from one state
to the other.</p>
<p>In the truncated form, more records are displayed than
are specified on the SFLPAG keyword. In the folded form, as many records are
displayed as are specified on the SFLPAG keyword.</p>
<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.</p>
<div class="note"><span class="notetitle">Notes:</span> <ol><li>A warning message is sent at file creation if the entire record fits on
a single display line.</li>
<li>If subfile size equals subfile page, SFLDROP is ignored. When several
display sizes are used (DSPSIZ keyword specified), SFLDROP is ignored only
for display sizes for which the subfile size equals subfile page. If the subfile
record format contains field selection, SFLDROP 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 SFLDROP are displayed at one time, the same
function key should be specified on each SFLDROP 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>SFLDROP can be specified on the same subfile control record format as
the SFLFOLD keyword. If both keywords are active, the SFLFOLD keyword is used.
Indicators are checked at the time the subfile is displayed. Both keywords
must use the same key.</li>
</ol>
</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 SFLDROP keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
A*
A* (subfile records should not fit on one screen line)
A*
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(34)
00070A SFLDSP SFLDSPCTL
00090A SFLDROP(CF03)
A</pre>
<p>When the subfile is displayed, the workstation user can
press the CF03 key to change the subfile from truncated to folded form and
from folded to truncated 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>