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

160 lines
9.6 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="CHCUNAVAIL (Choice Color/Display Attribute when Unavailable) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to specify the color or display attributes to be used when displaying the unavailable choices in a selection field or a push button field." />
<meta name="description" content="Use this field-level keyword to specify the color or display attributes to be used when displaying the unavailable choices in a selection field or a push button field." />
<meta name="DC.subject" content="CHCUNAVAIL (Choice Color/Display Attribute When Unavailable) keyword, Choice Color/Display Attribute when Unavailable (CHCUNAVAIL) keyword, color/display attribute, unavailable, specifying, color/display attribute unavailable" />
<meta name="keywords" content="CHCUNAVAIL (Choice Color/Display Attribute When Unavailable) keyword, Choice Color/Display Attribute when Unavailable (CHCUNAVAIL) keyword, color/display attribute, unavailable, specifying, color/display attribute unavailable" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsflml.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfcolor.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="rzakcmstchcuna" />
<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>CHCUNAVAIL (Choice Color/Display Attribute when Unavailable) keyword
for display files</title>
</head>
<body id="rzakcmstchcuna"><a name="rzakcmstchcuna"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CHCUNAVAIL (Choice Color/Display Attribute when Unavailable) keyword
for display files</h1>
<div><p>Use this field-level keyword to specify the color or display attributes
to be used when displaying the unavailable choices in a selection field or
a push button field.</p>
<div class="section"><p>This keyword can also be used to indicate unavailable choices
in a subfile single or multiple choice selection list.</p>
<div class="p">The format of
the keyword is: <pre>CHCUNAVAIL([color] [display-attributes])</pre>
</div>
<p>One
parameter must be specified.</p>
<p>The color parameter indicates the color
of choice text specified on the CHOICE keywords for the field on a color display
station, when the choices are unavailable. It also indicates the color of
unavailable entries in a single or multiple choice selection list displayed
on a color display.</p>
<p>The valid values for the color parameter are:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><thead align="left"><tr><th valign="top" width="NaN%" class="firstcol" id="d0e50">Value</th>
<th valign="top" width="NaN%" id="d0e52">Meaning</th>
</tr>
</thead>
<tbody><tr><th valign="top" width="NaN%" class="firstcol" id="d0e56" headers="d0e50 ">BLU</th>
<td valign="top" width="NaN%" headers="d0e56 d0e52 ">Blue</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e61" headers="d0e50 ">GRN</th>
<td valign="top" width="NaN%" headers="d0e61 d0e52 ">Green</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e66" headers="d0e50 ">PNK</th>
<td valign="top" width="NaN%" headers="d0e66 d0e52 ">Pink</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e71" headers="d0e50 ">RED</th>
<td valign="top" width="NaN%" headers="d0e71 d0e52 ">Red</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e76" headers="d0e50 ">TRQ</th>
<td valign="top" width="NaN%" headers="d0e76 d0e52 ">Turquoise</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e81" headers="d0e50 ">YLW</th>
<td valign="top" width="NaN%" headers="d0e81 d0e52 ">Yellow</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e86" headers="d0e50 ">WHT</th>
<td valign="top" width="NaN%" headers="d0e86 d0e52 ">White</td>
</tr>
</tbody>
</table>
</div>
<p>If the color parameter is not specified, the default color for
unavailable choices in a selection field is blue. This parameter is ignored
on a monochrome display.</p>
<p>The display-attribute parameter
indicates the display attributes of the choice text specified on the CHOICE
or PSHBTNCHC keyword for the field. The parameter is specified as an expression
of the form (<var class="varname">*DSPATR value1 &lt;value2 &lt;value3...&gt;&gt;</var>).</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><thead align="left"><tr><th valign="top" width="NaN%" class="firstcol" id="d0e103">Value</th>
<th valign="top" width="NaN%" id="d0e105">Meaning</th>
</tr>
</thead>
<tbody><tr><th valign="top" width="NaN%" class="firstcol" id="d0e109" headers="d0e103 ">BL</th>
<td valign="top" width="NaN%" headers="d0e109 d0e105 ">Blink</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e114" headers="d0e103 ">CS</th>
<td valign="top" width="NaN%" headers="d0e114 d0e105 ">Column separator</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e119" headers="d0e103 ">HI</th>
<td valign="top" width="NaN%" headers="d0e119 d0e105 ">High intensity</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e124" headers="d0e103 ">ND</th>
<td valign="top" width="NaN%" headers="d0e124 d0e105 ">Nondisplay</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e129" headers="d0e103 ">RI</th>
<td valign="top" width="NaN%" headers="d0e129 d0e105 ">Reverse image</td>
</tr>
<tr><th valign="top" width="NaN%" class="firstcol" id="d0e134" headers="d0e103 ">UL</th>
<td valign="top" width="NaN%" headers="d0e134 d0e105 ">Underline</td>
</tr>
</tbody>
</table>
</div>
<p>The default display attribute for unavailable choices in a selection
field on monochrome display stations is normal (or low) intensity. Also, the
first character of an unavailable choice on a monochrome display station is
overwritten with an asterisk (*).</p>
<div class="note"><span class="notetitle">Note:</span> Display attributes CS, HI, and
BL can cause fields on 5292, 3179, 3197 Models C1 and C2, 3486, 3487 Model
HC, and 3488<a name="fnsrc_1" href="#fntarg_1"><sup>1</sup></a> workstations to appear as color fields. Separator lines do not
appear when display attributes HI, RI, and UL are used.</div>
<p>When used
on a field specification, this keyword is allowed only if there are also one
or more CHOICE or PSHBTNCHC keywords. When used on a subfile control record,
this keyword is allowed only if the SFLSNGCHC or SFLMLTCHC keyword is also
used on the subfile control record.</p>
<p>Option indicators are valid for
this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the CHCUNAVAIL keyword:</p>
<pre>|....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R RECORD
A F1 2Y 0B 2 5SNGCHCFLD CHECK(ER)
A CHOICE(1 'Choice number 1')
A CHOICE(2 'Choice number 2')
A CHCCTL(1 &amp;CHCCTL1);
A CHCCTL(2 &amp;CHCCTL2);
A CHCUNAVAIL((*COLOR TRQ))
A :
A :
A</pre>
<p>In this example, the unavailable choices for the selection
field are displayed in turquoise on a color display.</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 class="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfsflml.htm" title="Use this record-level keyword to define a subfile as a multiple-choice-selection list. A multiple-choice-selection list is a scrollable group of items from which the user can select multiple items.">SFLMLTCHC (Subfile Multiple Choice Selection List) keyword for display files</a></div>
<div><a href="rzakcmstdfcolor.htm" title="Use this keyword to specify the color of a field on a color display.">COLOR (Color) keyword for display files</a></div>
</div>
</div><div class="p"><a name="fntarg_1" href="#fnsrc_1"><sup>1</sup></a> Dependent on the monitor attached to the display
device.</div>
</body>
</html>