127 lines
6.7 KiB
HTML
127 lines
6.7 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="PSHBTNFLD (Push Button Field) keyword for display files" />
|
||
<meta name="abstract" content="Use this field-level keyword to define a field as a push button field." />
|
||
<meta name="description" content="Use this field-level keyword to define a field as a push button field." />
|
||
<meta name="DC.subject" content="PSHBTNFLD (Push Button Field) keyword, Push Button Field (PSHBTNFLD) keyword" />
|
||
<meta name="keywords" content="PSHBTNFLD (Push Button Field) keyword, Push Button Field (PSHBTNFLD) 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="rzakcmstdfpshbt" />
|
||
<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>PSHBTNFLD (Push Button Field) keyword for display files</title>
|
||
</head>
|
||
<body id="rzakcmstdfpshbt"><a name="rzakcmstdfpshbt"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">PSHBTNFLD (Push Button Field) keyword for display files</h1>
|
||
<div><p>Use this field-level keyword to define a field as a push button
|
||
field.</p>
|
||
<div class="section"><p>A push button field is a field that contains a fixed number of
|
||
push buttons from which a user can select. The field appears as a list of
|
||
command keys each enclosed with '<>' or as a group of push buttons.</p>
|
||
<div class="p">The
|
||
format of the keyword is: <pre>PSHBTNFLD[([*NORSTCSR ∨ *RSTCSR]
|
||
[(*NUMCOL nbr-of-cols) ∨ (*NUMROW nbr-of-rows)]
|
||
[(*GUTTER gutter-width)])]</pre>
|
||
</div>
|
||
<p>The parameters are optional and
|
||
can be entered in any order. When no parameter is specified, the push button
|
||
field choices are arranged horizontally. *GUTTER parameter is set to 3 as
|
||
default and the field will be displayed using as many lines as it takes to
|
||
display all of the choices. There will be 3 spaces between each choice.</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 push-button
|
||
field. *NORSTCSR specifies that the arrow keys will cause the selection cursor
|
||
to leave the field. The default is *NORSTCSR.</p>
|
||
<div class="p">The *NUMCOL parameter
|
||
specifies that this field should be displayed in multiple columns with the
|
||
choices arranged across the columns in this manner: <pre>< F1 > < F2 > < F3 >
|
||
< F4 > < F5 > < F6 >
|
||
< F7 > < F8 > < F9 ></pre>
|
||
</div>
|
||
<p>Nbr-of-rows
|
||
specifies how many rows the push-button field should contain. Nbr-of-rows
|
||
must be a positive integer and the entire single-choice push-button field
|
||
must be able to fit on the display when placed in the specified number of
|
||
rows.</p>
|
||
<p>The *GUTTER parameter specifies the number of blanks to be placed
|
||
between each column of the push-button field. Unlike the SNGCHCFLD keyword,
|
||
it can be specified even if *NUMCOL or *NUMROW have not been specified. The
|
||
gutter-width must be a positive integer. If *GUTTER is not specified, the
|
||
default of gutter-width is set to three blanks. The gutter value must be a
|
||
number greater than one.</p>
|
||
<p>For more information about how to support different
|
||
device configurations, see the <a href="../books/sc415715.pdf" target="_blank">Application Display Programming book</a><img src="wbpdf.gif" alt="Link to PDF" />.</p>
|
||
<p>A field
|
||
containing the PSHBTNFLD keyword must also contain one or more PSHBTNCHC keywords
|
||
defining the choices for the field.</p>
|
||
<p>The field containing the PSHBTNFLD
|
||
keyword must be defined as an input-capable field with data type Y, length
|
||
equal to 2, and decimal positions of 0. The position specified for the field
|
||
is the position of the first push-button choice. For input, the field contains
|
||
the number of the choice selected, or 0 if no choice was selected. For output,
|
||
the value of the field is ignored.</p>
|
||
<p>The following keywords can be specified
|
||
on a field with the PSHBTNFLD 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 />
|
||
CHANGE<br />
|
||
CHCAVAIL<br />
|
||
CHCUNAVAIL<br />
|
||
CHCCTL</p>
|
||
</td>
|
||
<td valign="top" width="50%"><p>INDTXT<br />
|
||
NOCCSID<br />
|
||
PSHBTNCHC<br />
|
||
DSPATR(PC)<br />
|
||
TEXT</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</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 PSHBTNFLD keyword.</p>
|
||
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
A
|
||
A R RECORD
|
||
A :
|
||
A :
|
||
A 2 40'MENU'
|
||
A F1 2Y 0B 24 02PSHBTNFLD
|
||
A PSHBTNCHC(1 'Cmd1' CF01)
|
||
A PSHBTNCHC(2 'Enter')
|
||
A 01
|
||
A</pre>
|
||
<p>In this example, when using a graphical display station
|
||
attached to a controller that supports an enhanced interface for non-programmable
|
||
workstations, the push-button fields look like this:</p>
|
||
<br /><img src="rv3f071.gif" alt="A figure of the example specification displayed on
a graphical display station." /><br /></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> |