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

120 lines
7.1 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="MNUBARDSP (Menu-Bar Display) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword to display a menu bar. The MNUBARDSP keyword has two formats: one for records that contain the MNUBAR keyword and one for records that do not contain a MNUBAR keyword." />
<meta name="description" content="Use this record-level keyword to display a menu bar. The MNUBARDSP keyword has two formats: one for records that contain the MNUBAR keyword and one for records that do not contain a MNUBAR keyword." />
<meta name="DC.subject" content="menu bar, displaying, MNUBARDSP (Menu-Bar Display) keyword, Menu-Bar Display (MNUBARDSP) keyword" />
<meta name="keywords" content="menu bar, displaying, MNUBARDSP (Menu-Bar Display) keyword, Menu-Bar Display (MNUBARDSP) 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="rzakcmstmnubard" />
<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>MNUBARDSP (Menu-Bar Display) keyword for display files</title>
</head>
<body id="rzakcmstmnubard"><a name="rzakcmstmnubard"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">MNUBARDSP (Menu-Bar Display) keyword for display files</h1>
<div><p>Use this record-level keyword to display a menu bar. The MNUBARDSP
keyword has two formats: one for records that contain the MNUBAR keyword and
one for records that do not contain a MNUBAR keyword.</p>
<div class="section"><div class="p">The format for MNUBARDSP when specified on a record that is not
a menu bar record is: <pre>MNUBARDSP(menu-bar-record &amp;choice-field [&amp;pull-down-input])</pre>
</div>
<div class="p">The
format for MNUBARDSP when specified on a menu bar record is: <pre>MNUBARDSP[(&amp;pull-down-input)]</pre>
</div>
<p>The
menu-bar-record parameter specifies the menu-bar record that is to be displayed
when this record is written. The menu-bar record must exist in the same file
as the record you are defining.</p>
<p>The &amp;choice-field parameter specifies
the name of a hidden field, which on input contains the number of the choice
(if any) selected from the menu bar. The field must exist in the record you
are defining and it must be defined as numeric Y in position 35, usage H,
length 2, and decimal positions 0.</p>
<div class="p">The &amp;pull-down-input parameter
is optional and specifies the name of a hidden field that contains the input
from the pull-down menu when the pull-down menu contains only a single-choice
selection field. The field must exist in the record you are defining and it
must be defined as a length 2, decimal positions 0, and zoned (S in position
35) field with usage H (hidden). On input, this field contains one of the
following values: <dl><dt><strong>Value</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">0</dt>
<dd>No selection made.</dd>
<dt class="dlterm">n</dt>
<dd>Choice n in the pull-down menu was selected.</dd>
<dt class="dlterm">-1</dt>
<dd>Pull-down record contains something other than the one single-choice selection
field. You must read the pull-down record to receive its contents.</dd>
</dl>
</div>
<p>Option indicators are valid for the MNUBARDSP keyword,
and more than one MNUBARDSP keyword can be specified on the record if all
are optioned. If more than one MNUBARDSP keyword is in effect when the record
is written, the first one in effect is used.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 1</h4><p>The following example shows how to specify
the MNUBARDSP keyword on a record that is not a menu bar.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R RECORD1
A 01 MNUBARDSP(MENURCD &amp;MNUCHOICE &amp;INPUT);
A FIELD1 10A B 10 12
A FIELD2 5S 0B 14 12
A MNUCHOICE 2Y 0H
A INPUT 2S 0H
A R MENURCD MNUBAR
A F1 2Y 0B 1 2
A MNUBARCHC(1 PULLFILE 'File')
A :
A :
A</pre>
<p>In this example, if option indicator 01 is on when record
RECORD1 is written to the display, the system displays the menu bar in record
MENURCD. When the menu bar is activated and the pull-down menu is selected,
the number of the menu-bar choice is returned in field MNUCHOICE. If the pull-down
menu selected contains one single-choice selection field, the choice made
for that field is returned in field INPUT. Otherwise, field INPUT contains
-1, indicating that the application must read the pull-down record to receive
the pull-down input.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 2</h4><p>The following example shows how to specify
the MNUBARDSP keyword on a menu-bar record.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R MENURCD MNUBAR
A 01 MNUBARDSP
A F1 2Y 0B 1 2
A MNUBARCHC(1 PULLFILE 'File')
A :
A :
A</pre>
<p>If option indicator 01 is on when record MENURCD is written
to the display, the system displays the menu bar defined in MENURCD. If the
user selects a pull-down menu from the menu bar, the number of the menu-bar
choice selected is returned in F1 field.</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>