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

151 lines
8.9 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="SFLSNGCHC (Subfile Single Choice Selection List) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword to define a subfile as a single-choice-selection list. A single-choice-selection list is a scrollable group of items from which the user can select one item." />
<meta name="description" content="Use this record-level keyword to define a subfile as a single-choice-selection list. A single-choice-selection list is a scrollable group of items from which the user can select one item." />
<meta name="DC.subject" content="SFLSNGCHC (Subfile Single Choice Selection List) keyword, Subfile Single Choice Selection List (SFLSNGCHC) keyword" />
<meta name="keywords" content="SFLSNGCHC (Subfile Single Choice Selection List) keyword, Subfile Single Choice Selection List (SFLSNGCHC) 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="rzakcmstdfsng" />
<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>SFLSNGCHC (Subfile Single Choice Selection List) keyword for display
files</title>
</head>
<body id="rzakcmstdfsng"><a name="rzakcmstdfsng"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLSNGCHC (Subfile Single Choice Selection List) keyword for display
files</h1>
<div><p>Use this record-level keyword to define a subfile as a single-choice-selection
list. A single-choice-selection list is a scrollable group of items from which
the user can select one item.</p>
<div class="section"><div class="p">The format of this keyword is: <pre>SFLSNGCHC[([*NORSTCSR | *RSTCSR] [*NOSLTIND | *SLTIND]
[*NOAUTOSLT | *AUTOSLT | *AUTOSLTENH])]</pre>
</div>
<p>Parameters are optional
and can be entered in any order.</p>
<p>The *RSTCSR parameter
specifies whether the arrow keys should be allowed to move the selection cursor
outside of the field. *RSTCSR specifies that the arrow keys will not cause
the selection cursor to move outside of the selection list field. *NORSTCSR
specifies that the arrow keys will cause the selection cursor to leave the
field. If the SFLSNGCHC subfile control record is defined in a pulldown, the
default is <samp class="codeph">*RSTCSR</samp>. Otherwise, the default is <samp class="codeph">*NORSTCSR</samp>.</p>
<p>The
*SLTIND parameter specifies whether selection indicators are used when this
selection list is displayed on a graphical display. *SLTIND specifies that
the radio buttons should be used on graphical color displays as selection
indicator. *NOSLTIND specifies that no selection indicator should be used
on a graphical color display and only a selection cursor can be used to make
a selection. The default is <samp class="codeph">*NOSLTIND</samp>.</p>
<p>The
*AUTOSLT parameter indicates if the ENTER key should automatically select
the choice currently being indicated by the selection cursor. *NOAUTOSLT indicates
that the user must select the choice. *AUTOSLTENH indicates that auto-select
is only in effect if the device is connected to an enhanced controller. If
the SFLSNGCHC subfile control record is defined in a pulldown, the default
is <samp class="codeph">*AUTOSLT</samp>. Otherwise, the default is <samp class="codeph">*NOAUTOSLT</samp>.</p>
<div class="p">A
subfile containing the SFLSNGCHC keyword must: <ul><li>Contain only one output field</li>
<li>Cannot contain input capable fields</li>
<li>Can contain hidden fields</li>
</ul>
</div>
<p>This optional keyword is valid only for the subfile control record
format.</p>
<p>The following subfile control record keywords cannot be specified
on a record with the SFLSNGCHC keyword:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"><p>SFLDROP<br />
SFLFOLD<br />
SFLMLTCHC</p>
</td>
<td valign="top" width="50%">&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<p>The CHCAVAIL, CHCSLT and CHCUNAVAIL keywords can be used to indicate
the color of the items within the selection list, when the list is displayed
on a color display station. The CHCAVAIL keyword indicates the color of the
items within the list which are available for selection. The CHCSLT keyword
indicates the color of the selected item. The CHCUNAVAIL keyword indicates
the items on the list which are not available for selection. These keywords
can be used in a subfile control record only if SFLSNGCHC or SFLMLTCHC keywords
are also used.</p>
<p>Option indicators are not valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 1</h4><p>The following example shows how to specify
the SFLSNGCHC keyword:</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R SFLRCD SFL
A CTLFLD 1Y 0H SFLCHCCTL
A F1 10A O 6 10
A R SFLCTLRCD SFLCTL(SFLRCD)
A SFLSNGCHC
A SFLPAG(5) SFLSIZ(&amp;SFLSIZ);
A SFLDSP SFLDSPCTL
A ROLLUP(10)
A 10 SFLEND(*SCRBAR)
A F3 5S 0H SFLSCROLL
A F2 4S 0H SFLRCDNBR(CURSOR *TOP)
A SFLSIZ 5S 0P
A 1 30'Panel Title'
A 4 5'Select One Item:'</pre>
<p>In
this example, when using a graphical display station attached to a controller
that supports an enhanced interface for nonprogrammable workstations, a single-choice
list looks like this:</p>
<br /><img src="rv3f072.gif" alt="A&#xA;figure of the example specification displayed on a graphical display station." /><br /></div>
<div class="example"><h4 class="sectiontitle">Example 2</h4><p>The following example shows how to specify
what color the items on the list should have on a color display. Available
items are displayed in red. A selected item is displayed in blue. Unavailable
items are displayed in yellow. The CHCAVAIL, CHCSLT, and CHCUNAVAIL keywords
can also be used to set the display attributes of the items on the list. See
the description of these keywords in this topic collection for
examples of setting display attributes.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R SFLRCD SFL
A CTLFLD 1Y 0H SFLCHCCTL
A F1 10A O 6 10
A R SFLCTLRCD SFLCTL(SFLRCD)
A SFLSNGCHC
A SFLPAG(5) SFLSIZ(&amp;SFLSIZ);
A SFLDSP SFLDSPCTL
A ROLLUP(10)
A CHCAVAIL((*COLOR RED))
A CHCSLT((*COLOR BLU))
A CHCUNAVAIL((*COLOR YLW))
A 10 SFLEND(*SCRBAR)
A F3 5S 0H SFLSCROLL
A F2 4S 0H SFLRCDNBR(CURSOR *TOP)
A SFLSIZ 5S 0P
A 1 30'Panel Title'
A 4 5'Select One Item:'</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>
</body>
</html>