148 lines
7.8 KiB
HTML
148 lines
7.8 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="PSHBTNCHC (Push Button Field Choice) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this field-level keyword to define a choice for a push button field." />
|
||
|
|
<meta name="description" content="Use this field-level keyword to define a choice for a push button field." />
|
||
|
|
<meta name="DC.subject" content="PSHBTNCHC (Push Button Field Choice) keyword, Push Button Field Choice (PSHBTNCHC) keyword" />
|
||
|
|
<meta name="keywords" content="PSHBTNCHC (Push Button Field Choice) keyword, Push Button Field Choice (PSHBTNCHC) 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="rzakcmstdfpshch" />
|
||
|
|
<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>PSHBTNCHC (Push Button Field Choice) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfpshch"><a name="rzakcmstdfpshch"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">PSHBTNCHC (Push Button Field Choice) keyword for display files</h1>
|
||
|
|
<div><p>Use this field-level keyword to define a choice for a push button
|
||
|
|
field.</p>
|
||
|
|
<div class="section"><div class="p">The format of the keyword is: <pre>PSHBTNCHC(choice-number choice-text [command-key] [*SPACEB])</pre>
|
||
|
|
</div>
|
||
|
|
<p>The
|
||
|
|
choice-number parameter defines an identification number for this choice.
|
||
|
|
This parameter is required. The choice number returns to the application to
|
||
|
|
indicate which choice in the push-button field was selected. Valid values
|
||
|
|
for the choice-number are positive integers greater than 0 and less than or
|
||
|
|
equal to 99. Duplicate choice-number values within a push-button field are
|
||
|
|
not allowed.</p>
|
||
|
|
<div class="p">The choice-text parameter defines the text that appears
|
||
|
|
in the push-button field for the choice. This parameter is required. The parameter
|
||
|
|
can be specified in one of two forms: <ul><li>As a character string: 'Choice text '</li>
|
||
|
|
<li>As a program-to-system field: &field-name</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The field specified must exist in the same record as the selection
|
||
|
|
field and must be defined as a character field with usage P.</p>
|
||
|
|
<div class="p">The choice
|
||
|
|
text must fit on one line of the display for the smallest display size specified
|
||
|
|
for the file. The maximum length for the choice text depends on the following
|
||
|
|
conditions: <ul><li>Position of the push-button field</li>
|
||
|
|
<li>Length of the choice text</li>
|
||
|
|
<li>Gutter width between choices</li>
|
||
|
|
<li>Number of columns of choices</li>
|
||
|
|
<li>Smallest display size</li>
|
||
|
|
<li>Window width, if displayed in a window</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="p">Within the choice text, you can specify a mnemonic for the choice
|
||
|
|
by using a greater than character (>) to indicate the mnemonic character.
|
||
|
|
The character to the right of the > is the mnemonic. The mnemonic is used
|
||
|
|
only on a character-based graphical display attached to a controller that
|
||
|
|
supports an enhanced interface for nonprogrammable workstations. Examples
|
||
|
|
of specifying mnemonics: <dl><dt><strong>Choice text</strong></dt>
|
||
|
|
<dd><strong>Appears as</strong></dd>
|
||
|
|
<dt class="dlterm">'F2=>File'</dt>
|
||
|
|
<dd>F2=<u>F</u>ile</dd>
|
||
|
|
<dt class="dlterm">'F3=F>inish'</dt>
|
||
|
|
<dd>F3=F<u>i</u>nish</dd>
|
||
|
|
<dt class="dlterm">'>Enter'</dt>
|
||
|
|
<dd><u>E</u>nter</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="p">In order to specify > as a character in the text,
|
||
|
|
you must specify it twice, just as you must specify the apostrophe character
|
||
|
|
twice in order to get a single apostrophe character in the text. For example:
|
||
|
|
<dl><dt><strong>Choice text</strong></dt>
|
||
|
|
<dd><strong>Appears as</strong></dd>
|
||
|
|
<dt class="dlterm">'X >>= 1'</dt>
|
||
|
|
<dd>X >= 1</dd>
|
||
|
|
<dt class="dlterm">'X >>>= 1'</dt>
|
||
|
|
<dd>X ><u>=</u> 1</dd>
|
||
|
|
</dl>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> You cannot specify the > as the mnemonic.</div>
|
||
|
|
</div>
|
||
|
|
<p>The
|
||
|
|
mnemonic character indicated must be a single-byte character and must not
|
||
|
|
be a blank. Only one mnemonic is allowed in the choice text, and the same
|
||
|
|
mnemonic character should not be specified for more than one choice. If the
|
||
|
|
same mnemonic character is used more than once than the first definition of
|
||
|
|
the mnemonic is used.</p>
|
||
|
|
<p>The command-key parameter is
|
||
|
|
optional and indicates which function key should be generated when this push-button
|
||
|
|
choice is selected. The following keys can be used as parameters: CA01 to
|
||
|
|
CA24, CF01 to CF24, PRINT, HELP, CLEAR, ENTER, HOME, ROLLUP, and ROLLDOWN.
|
||
|
|
If the command-key specified is not defined at the file level for this record,
|
||
|
|
then the key will be added to this record. If a parameter is not defined then
|
||
|
|
ENTER will be used.</p>
|
||
|
|
<p>The *SPACEB parameter is optional and indicates
|
||
|
|
that a blank spot where this choice will be located should be inserted before
|
||
|
|
this choice. This parameter is used to specify logical grouping of choices.</p>
|
||
|
|
<p>When
|
||
|
|
the PSHBTNCHC keyword is specified on a field, the PSHBTNFLD keyword must
|
||
|
|
also be specified.</p>
|
||
|
|
<p>Several PSHBTNCHC keywords can be specified for one
|
||
|
|
push-button field. The number of PSHBTNCHC keywords that can be specified
|
||
|
|
depends on the position of the push-button field and the display size. More
|
||
|
|
than one choice can occupy one line, and all choices must fit on the smallest
|
||
|
|
display size specified for the file. The maximum number of choices is 99.</p>
|
||
|
|
<p>Option
|
||
|
|
indicators are valid for this keyword. When a PSHBTNCHC keyword is off,
|
||
|
|
the list of choices is compressed.</p>
|
||
|
|
<p>Push buttons always behave as if
|
||
|
|
AUTOENT and AUTOSLT are on.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the PSHBTNCHC keyword:</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
|
||
|
|
A
|
||
|
|
A R RECORD
|
||
|
|
A :
|
||
|
|
A :
|
||
|
|
A F1 2Y 0B 24 02PSHBTNFLD
|
||
|
|
A 01 PSHBTNCHC(1 '>Help' HELP)
|
||
|
|
A PSHBTNCHC(2 &F3 CA03)
|
||
|
|
A PSHBTNCHC(3 'E>nter')
|
||
|
|
A F3 4A P
|
||
|
|
A
|
||
|
|
A</pre>
|
||
|
|
<p>In this example, three choices are defined for the push-button
|
||
|
|
field F1. The text for choice 2 is contained in field F3, and the mnemonic
|
||
|
|
for choice 2 must be contained in the text supplied by the application at
|
||
|
|
run time. If indicator 01 is off when the record is written, only choices
|
||
|
|
2 and 3 are displayed.</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>
|