friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdfsfsiz.htm

147 lines
9.2 KiB
HTML
Raw Normal View History

Add readme and dist folders
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="SFLSIZ (Subfile Size) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword on the subfile control record format to specify the number of records in the subfile. The maximum number of records allowed is 9999. This keyword is required for the subfile control record format." />
<meta name="description" content="Use this record-level keyword on the subfile control record format to specify the number of records in the subfile. The maximum number of records allowed is 9999. This keyword is required for the subfile control record format." />
<meta name="DC.subject" content="SFLSIZ (Subfile Size) keyword, Subfile Size (SFLSIZ) keyword" />
<meta name="keywords" content="SFLSIZ (Subfile Size) keyword, Subfile Size (SFLSIZ) 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="rzakcmstdfsfsiz" />
<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>SFLSIZ (Subfile Size) keyword for display files</title>
</head>
<body id="rzakcmstdfsfsiz"><a name="rzakcmstdfsfsiz"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLSIZ (Subfile Size) keyword for display files</h1>
<div><p>Use this record-level keyword on the subfile control record format
to specify the number of records in the subfile. The maximum number of records
allowed is 9999. This keyword is required for the subfile control record format.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>SFLSIZ(number-of-records-in-subfile | &amp;number-of-records-in-subfile-field);</pre>
</div>
<p>The number-of-records-in-subfile parameter can be specified in 2 ways;
as a number or program-to-system field. The program-to-system field must be
defined with a length of 5 and data type S.</p>
<p>P-fields can be used for
the size of the subfile when using SFLEND with the *SCRBAR parameter. The
application can communicate to the <span class="keyword">i5/OS™</span> operating
system the number of records that the applications will be adding to the subfile.
Therefore, the scroll bar can show a better picture of the subfile.</p>
<div class="note"><span class="notetitle">Note:</span> The
value for the p-field must be greater than the subfile page value. If the
value of the p-field is not greater than the subfile page value, the size
of the subfile will be page value plus one.</div>
</div>
<div class="section"><h4 class="sectiontitle">Subfile size equals subfile page</h4><p>When you specify
the same parameter values for SFLSIZ and the SFLPAG keyword, you can specify
option indicators for fields in the subfile record format. (This is called
field selection.)</p>
<p>When the subfile is built, the records can vary in
length depending on which fields are selected, and each output operation places
records into successive positions within the subfile. When the subfile is
displayed, each record can require a different number of display lines. The
number of records that actually fit in the subfile depends on the fields selected
for each record written to the subfile.</p>
<p>If the last subfile record written
to the subfile fits exactly into the subfile, a status message (CPF5003) is
returned to your program. If the last subfile record written to the subfile
overflows the subfile, a notify message (CPF5043) is returned to your program.</p>
<p>The
specified SFLPAG value is increased to equal the maximum number of records
that fit on the display if the number of subfile records to be displayed do
not occupy a full display.</p>
<p>The SFLSIZ value is increased by the same
value. For example, if SFLPAG(13) and SFLSIZ(13) are specified, and the subfile
record format and SFLLIN value are specified such that three records can fit
on a single display line, SFLPAG and SFLSIZ are increased to 15.</p>
<p>Option
indicators are not valid for this keyword. Display size condition names are
valid and are required if the number of records within the subfile changes
depending on the display size. You cannot use display size condition names
for this keyword when a program-to-system field is used as a parameter for
it.</p>
</div>
<div class="section"><h4 class="sectiontitle">Subfile size does not equal subfile page</h4><p>When you
specify different parameter values for SFLPAG keyword and SFLSIZ, the SFLSIZ
value specifies the number of records that can be placed into the subfile.
If your program places a record with a relative record number larger than
the SFLSIZ value into the subfile, the subfile is automatically extended to
contain it (up to a maximum of 9999 records). The parameter value you specify
should be large enough to accommodate the maximum number of records you normally
have in the subfile.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the SFLSIZ keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
00020A 21 FIELD1 78 2 2
00030A 22 FIELD2 40 3 2
00040A*
00050A R SFLCTLR SFLCTL(SFLR)
00060A SFLPAG(5)
00070A SFLSIZ(5)
00080A SFLDSP
00090A SFLDSPCTL
A</pre>
<p>Your program issues the following output operations:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><thead align="left"><tr><th valign="top" width="33.33333333333333%" id="d0e68">Output operation To</th>
<th valign="top" width="33.33333333333333%" id="d0e70">Option indicators set</th>
<th valign="top" width="33.33333333333333%" id="d0e72">Result</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="33.33333333333333%" headers="d0e68 ">SFLR</td>
<td valign="top" width="33.33333333333333%" headers="d0e70 ">21 on 22 off</td>
<td valign="top" width="33.33333333333333%" headers="d0e72 ">Only FIELD1 written to subfile</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e68 ">SFLR</td>
<td valign="top" width="33.33333333333333%" headers="d0e70 ">21 on 22 on</td>
<td valign="top" width="33.33333333333333%" headers="d0e72 ">FIELD1 and FIELD2 written to subfile</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e68 ">SFLR</td>
<td valign="top" width="33.33333333333333%" headers="d0e70 ">21 off 22 on</td>
<td valign="top" width="33.33333333333333%" headers="d0e72 ">Only FIELD2 written to subfile</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e68 ">(The <span class="keyword">i5/OS</span> operating
system sends status message CPF5003 to your program.)</td>
<td valign="top" width="33.33333333333333%" headers="d0e70 ">&nbsp;</td>
<td valign="top" width="33.33333333333333%" headers="d0e72 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="33.33333333333333%" headers="d0e68 ">SFLCTLR</td>
<td valign="top" width="33.33333333333333%" headers="d0e70 ">No indicator necessary</td>
<td valign="top" width="33.33333333333333%" headers="d0e72 ">Subfile displayed</td>
</tr>
</tbody>
</table>
</div>
<p>The resulting display is as follows:</p>
<div class="fignone" id="rzakcmstdfsfsiz__sbfdsp"><a name="rzakcmstdfsfsiz__sbfdsp"><!-- --></a><span class="figcap">Figure 1. Subfile
display</span><br /><img src="rsll737.gif" alt="A figure of&#xA;the display produced by the SFLSIZ example." /><br /></div>
<p>In <a href="#rzakcmstdfsfsiz__sbfdsp">Figure 1</a>, a fourth record
cannot be written to the subfile because there is no room on the display for
it (SFLPAG(5) has been specified in the DDS).</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>
Reference in New Issue Copy Permalink