199 lines
11 KiB
HTML
199 lines
11 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="MLTCHCFLD (Multiple-Choice Selection Field) keyword for display files" />
|
|
<meta name="abstract" content="Use this field-level keyword to define a field as a multiple-choice selection field." />
|
|
<meta name="description" content="Use this field-level keyword to define a field as a multiple-choice selection field." />
|
|
<meta name="DC.subject" content="MLTCHCFLD (Multiple-Choice Selection Field) keyword, Multiple-Choice Selection Field (MLTCHCFLD) keyword, multiple-choice selection field, creating, keyword" />
|
|
<meta name="keywords" content="MLTCHCFLD (Multiple-Choice Selection Field) keyword, Multiple-Choice Selection Field (MLTCHCFLD) keyword, multiple-choice selection field, creating, 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="rzakcmstmltchcf" />
|
|
<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>MLTCHCFLD (Multiple-Choice Selection Field) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstmltchcf"><a name="rzakcmstmltchcf"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">MLTCHCFLD (Multiple-Choice Selection Field) keyword for display files</h1>
|
|
<div><p>Use this field-level keyword to define a field as a multiple-choice
|
|
selection field.</p>
|
|
<div class="section"><p>A multiple-choice selection field is a field that contains a fixed
|
|
number of choices from which a user can select multiple choices. The field
|
|
appears as a vertical or horizontal list of choices, an input field to the
|
|
left of each choice, or as a group of check boxes.</p>
|
|
<p>If you see an input
|
|
field, instead of a check box to the left of each choice, the selection character
|
|
default value is a slash (/). Message CPX5A0C contains the country-designated
|
|
selection characters. The value can be changed to allow alternate selection
|
|
characters for a multiple-choice selection field. These characters are the
|
|
allowed uppercase or lowercase country-designated selection characters. The
|
|
characters are defined when the display file is created.</p>
|
|
<div class="p">The format
|
|
of the keyword is: <pre>MLTCHCFLD[([*RSTCSR | *NORSTCSR]
|
|
[*NOSLTIND | *SLTIND]
|
|
[[(*NUMCOL nbr-of-cols) | (*NUMROW nbr-of-rows)]
|
|
[(*GUTTER gutter-width)]])]</pre>
|
|
</div>
|
|
<p>Parameters are optional. If
|
|
none are specified, the multiple-choice selection field choices will be arranged
|
|
in a single vertical column. The user will be allowed to move the selection
|
|
cursor out of this field using the arrow keys. There will be three spaces
|
|
between choices and selection indicators will be displayed.</p>
|
|
<p>The RSTCSR
|
|
parameter specifies whether the arrow keys should be allowed to move the selection
|
|
cursor outside of the selection field. <samp class="codeph">*RSTCSR</samp> specifies
|
|
that the arrow keys will not cause the selection cursor to move outside of
|
|
the selection field. <samp class="codeph">*NORSTCSR</samp> specifies that the arrow keys
|
|
will cause the selection cursor to leave the selection field. The default
|
|
is <samp class="codeph">*NORSTCSR</samp>.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> An exception to the restrictions imposed
|
|
by <samp class="codeph">*RSTCSR</samp> happens if the selection field is the only field
|
|
contained within a pull-down window. In that case, when the selection cursor
|
|
is within the leftmost or rightmost columns, the left and right arrow keys
|
|
will close the current pull-down window and open the pull-down window associated
|
|
with the menu-bar choice to the left or right of the current menu-bar choice.</div>
|
|
<p>The <samp class="codeph">*RSTCSR</samp> parameter
|
|
is ignored on displays that are not connected to a controller that supports
|
|
an enhanced interface for nonprogrammable workstations.</p>
|
|
<p>The SLTIND parameter
|
|
indicates whether selection indicators (such as check boxes) should be displayed. <samp class="codeph">*NOSLTIND</samp> specifies
|
|
that the selection indicators should not be displayed. The default is <samp class="codeph">*SLTIND</samp>.</p>
|
|
<div class="p"><samp class="codeph">*NUMCOL</samp> specifies
|
|
that this selection field should be displayed in multiple columns with the
|
|
choices spread across the columns in this manner: <pre>choice1 choice2 choice3
|
|
choice4 choice5 choice6
|
|
choice7 choice8 choice9</pre>
|
|
</div>
|
|
<p>The nbr-of-cols portion of the
|
|
parameter specifies how many columns the selection field should contain. Nbr-of-cols
|
|
must be a positive integer and the entire multiple-choice selection field
|
|
must be able to fit on the display when placed in the specified number of
|
|
columns.</p>
|
|
<div class="p"><samp class="codeph">*NUMROW</samp> specifies that this selection field
|
|
should be displayed in multiple rows with the choices spread across the columns
|
|
in this manner: <pre>choice1 choice4 choice7
|
|
choice2 choice5 choice8
|
|
choice3 choice6 choice9</pre>
|
|
</div>
|
|
<p>The nbr-of-rows portion of the
|
|
parameter specifies how many rows the selection field should contain. Nbr-of-rows
|
|
must be a positive integer and the entire multiple-choice selection field
|
|
must be able to fit on the display when placed in the specified number of
|
|
rows.</p>
|
|
<p>The *GUTTER parameter is optional and specifies the number of
|
|
spaces to be placed between each column of the multiple-choice selection field.
|
|
It can only be specified if either *NUMCOL or *NUMROW has been specified and
|
|
must immediately follow the (*NUMxxx #) parameter. The gutter-width must be
|
|
a positive integer of at least 2. If *GUTTER is not specified, the default
|
|
of gutter-width is set to three spaces.</p>
|
|
<p>A field containing
|
|
the MLTCHCFLD keyword must contain one or more CHOICE and CHCCTL keywords
|
|
defining the choices for the field.</p>
|
|
<p>The field containing the MLTCHCFLD
|
|
keyword must be defined as an input-capable field with the data type Y and
|
|
length of two. The position specified for the field is the position of the
|
|
input field displayed to the left of the first choice or of the uppermost
|
|
check box. If *NOSLTIND is used on the PULLDOWN keyword and the device is
|
|
attached to a controller that supports an enhanced interface for nonprogrammable
|
|
workstations, the position is the first character of the text for the first
|
|
choice. On input, the field contains the number of the choices selected, or
|
|
0 if no choice was selected. On output, the value of the field is ignored.</p>
|
|
<p>Provide
|
|
a minimum of two spaces between the end of the previous field and the position
|
|
specified for the multiple choice field. This allows an ending attribute for
|
|
the previous field, and a beginning attribute for the multiple choice field.
|
|
These attributes cannot overlap.</p>
|
|
<p>The following keywords can be specified
|
|
on a field with the MLTCHCFLD 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>ALIAS<br />
|
|
AUTO(RA)<br />
|
|
BLANKS<br />
|
|
CHANGE<br />
|
|
CHCAVAIL<br />
|
|
CHCUNAVAIL<br />
|
|
CHCSLT<sup>1</sup><br />
|
|
CHCCTL<br />
|
|
CHECK(ER, FE)<sup>2</sup><br />
|
|
CHOICE</p>
|
|
</td>
|
|
<td valign="top" width="50%"><p>CHGINPDFT<br />
|
|
COLOR<sup>3</sup><br />
|
|
FLDCSRPRG<br />
|
|
DSPATR(RI UL BL CS HI ND PC)<sup>3</sup><br />
|
|
ERRMSG<br />
|
|
ERRMSGID<br />
|
|
INDTXT<br />
|
|
OVRATA<br />
|
|
OVRATR<br />
|
|
PUTRETAIN<br />
|
|
TEXT</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note"><span class="notetitle">Notes:</span> <ol><li>CHCSLT functions only if the multiple-choice selection field is displayed
|
|
in a pull-down menu that does not display selection indicators, when PULLDOWN(*NOSLTIND)
|
|
is specified.</li>
|
|
<li>Check(FE) applies only to a display attached to a controller that does
|
|
not support an enhanced interface.</li>
|
|
<li>If the COLOR or DSPATR keyword is specified for a field with the MLTCHCFLD
|
|
keyword, it applies only to the input field portion of the selection field
|
|
on character-based displays.</li>
|
|
</ol>
|
|
</div>
|
|
<p>Option indicators are not valid for this keyword.</p>
|
|
</div>
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the MLTCHCFLD keyword:</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
A
|
|
A R RECORD
|
|
A F1 2Y 0B 3 35MLTCHCFLD
|
|
A 01 CHOICE(1 '>Undo ')
|
|
A CHOICE(2 &MARKTXT);
|
|
A CHOICE(3 '>Copy ')
|
|
A CHCCTL(1 &CTLONE1 MSG1111 QUSER/A)
|
|
A CHCCTL(2 &CTLTWO1 &MSG1 &LIB/&MSGF);
|
|
A CHCCTL(3 &CTLTHR1);
|
|
A CTLONE1 1Y 0H
|
|
A CTLTWO1 1Y 0H
|
|
A CTLTHR1 1Y 0H
|
|
A MSGF 10A P
|
|
A LIB 10A P
|
|
A MARKTXT 10A P
|
|
A</pre>
|
|
<p>The CHCCTL keyword is required for each CHOICE keyword
|
|
used for the MLTCHCFLD.</p>
|
|
<p>On input, the hidden field for the CHCCTL keyword
|
|
indicates whether the choice was selected. 0 indicates the choice was not
|
|
selected; 1 indicates the choice was selected. On output, the hidden field
|
|
controls the availability of the choice, and is used to set a default selection
|
|
of a choice. 0 indicates the choice should be available, 1 indicates the choice
|
|
should be selected by default, and 2 indicates the choice is unavailable.
|
|
Other values, such as 0, are truncated.</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> |