142 lines
8.4 KiB
HTML
142 lines
8.4 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="CHCCTL (Choice Control) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this field-level keyword on a selection field to control the availability of the choices for the field." />
|
||
|
|
<meta name="description" content="Use this field-level keyword on a selection field to control the availability of the choices for the field." />
|
||
|
|
<meta name="DC.subject" content="CHCCTL (Choice Control) keyword, Choice Control (CHCCTL) keyword, choice field, controlling" />
|
||
|
|
<meta name="keywords" content="CHCCTL (Choice Control) keyword, Choice Control (CHCCTL) keyword, choice field, controlling" />
|
||
|
|
<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="rzakcmstchcctl" />
|
||
|
|
<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>CHCCTL (Choice Control) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstchcctl"><a name="rzakcmstchcctl"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">CHCCTL (Choice Control) keyword for display files</h1>
|
||
|
|
<div><p>Use this field-level keyword on a selection field to control the
|
||
|
|
availability of the choices for the field.</p>
|
||
|
|
<div class="section"><div class="p">The format of the keyword is either <pre>CHCCTL(choice-number &control-field [msg-id [msg-lib/]msg-file])
|
||
|
|
<strong>or</strong>
|
||
|
|
CHCCTL(choice-number &control-field [&msg-id [&msg-lib/]&msg-file])</pre>
|
||
|
|
</div>
|
||
|
|
<p>The
|
||
|
|
choice-number parameter is required and it specifies the choice to which this
|
||
|
|
keyword applies. Valid values are 1 to 99.</p>
|
||
|
|
<p>The control-field parameter
|
||
|
|
is required and it specifies the name of a 1-byte numeric hidden field that,
|
||
|
|
on output, contains the control value for the choice. The field must be defined
|
||
|
|
within the same record as the field you are defining, and must be defined
|
||
|
|
as data type Y (numeric) with length 1, decimal positions 0, and usage H.
|
||
|
|
On input for multiple-choice selection fields, the selection field indicates
|
||
|
|
whether the field was selected.</p>
|
||
|
|
<p>The
|
||
|
|
following table shows the control values for the hidden field, and their meaning
|
||
|
|
on input and output:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><caption>Table 1. Control values for hidden fields</caption><thead align="left"><tr><th align="left" valign="bottom" width="23.333333333333332%" id="d0e48">Control value</th>
|
||
|
|
<th align="left" valign="bottom" width="53.58974358974359%" id="d0e50">Meaning on output</th>
|
||
|
|
<th align="left" valign="bottom" width="23.076923076923077%" id="d0e52">Meaning on input</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td align="left" valign="top" width="23.333333333333332%" headers="d0e48 ">0</td>
|
||
|
|
<td align="left" valign="top" width="53.58974358974359%" headers="d0e50 ">Available</td>
|
||
|
|
<td align="left" valign="top" width="23.076923076923077%" headers="d0e52 ">Unselected</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td align="left" valign="top" width="23.333333333333332%" headers="d0e48 ">1</td>
|
||
|
|
<td align="left" valign="top" width="53.58974358974359%" headers="d0e50 ">Selected</td>
|
||
|
|
<td align="left" valign="top" width="23.076923076923077%" headers="d0e52 ">Selected</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td align="left" valign="top" width="23.333333333333332%" headers="d0e48 ">2</td>
|
||
|
|
<td align="left" valign="top" width="53.58974358974359%" headers="d0e50 ">Unavailable
|
||
|
|
<p>(Cannot place cursor on choice unless help for choice is available.)</p>
|
||
|
|
</td>
|
||
|
|
<td align="left" valign="top" width="23.076923076923077%" headers="d0e52 "> </td>
|
||
|
|
</tr>
|
||
|
|
<tr><td align="left" valign="top" width="23.333333333333332%" headers="d0e48 ">3</td>
|
||
|
|
<td align="left" valign="top" width="53.58974358974359%" headers="d0e50 ">Unavailable
|
||
|
|
<p>(Placing cursor on choice is allowed.)</p>
|
||
|
|
</td>
|
||
|
|
<td align="left" valign="top" width="23.076923076923077%" headers="d0e52 "> </td>
|
||
|
|
</tr>
|
||
|
|
<tr><td align="left" valign="top" width="23.333333333333332%" headers="d0e48 ">4</td>
|
||
|
|
<td align="left" valign="top" width="53.58974358974359%" headers="d0e50 ">Unavailable
|
||
|
|
<p>(Cannot place cursor on choice even if help for choice is available.)</p>
|
||
|
|
</td>
|
||
|
|
<td align="left" valign="top" width="23.076923076923077%" headers="d0e52 "> </td>
|
||
|
|
</tr>
|
||
|
|
<tr><td colspan="3" align="left" valign="top" headers="d0e48 d0e50 d0e52 "><div class="note"><span class="notetitle">Note:</span> The cursor restrictions
|
||
|
|
described only apply to displays that are connected to a controller that supports
|
||
|
|
an enhanced interface for nonprogrammable workstations. If another display
|
||
|
|
is used, the cursor is not restricted.</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>The message-id and message-file parameters are optional and specify
|
||
|
|
a message to be displayed when the user selects an unavailable choice. If
|
||
|
|
these parameters are not specified, the system issues a default message, CPD919B,
|
||
|
|
when the user selects an unavailable choice. If a field is used for the message-id,
|
||
|
|
that field must exist in the record you are defining and it must be defined
|
||
|
|
as data type A, usage P, and length of 7.</p>
|
||
|
|
<p>The message-file parameter
|
||
|
|
is a required parameter when the message-id parameter is used. If you do not
|
||
|
|
specify the library parameter, *LIBL is used to search for the message file
|
||
|
|
at program run time. If a field is used for the message library or message
|
||
|
|
file, that field must exist in the record you are defining and it must be
|
||
|
|
defined as data type A, usage P, and length of 10.</p>
|
||
|
|
<p>When the CHCCTL keyword
|
||
|
|
is specified on a field, a CHOICE or PSHBTNCHC keyword with the same choice
|
||
|
|
number must also be specified for the field.</p>
|
||
|
|
<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 CHCCTL keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
A :
|
||
|
|
A :
|
||
|
|
A F1 2Y 0B 3 35SNGCHCFLD
|
||
|
|
A CHOICE(1 '>Undo ')
|
||
|
|
A CHOICE(2 '>Mark ')
|
||
|
|
A CHOICE(3 '>Copy ')
|
||
|
|
A CHCCTL(1 &CTLUNDO MSG1112 QUSER/A)
|
||
|
|
A CHCCTL(2 &CTLMARK &MSG &LIB/&MSGF);
|
||
|
|
A CHCCTL(3 &CTLCOPY);
|
||
|
|
A CTLUNDO 1Y 0H
|
||
|
|
A CTLMARK 1Y 0H
|
||
|
|
A CTLCOPY 1Y 0H
|
||
|
|
A MSG 7A P
|
||
|
|
A MSGF 10A P
|
||
|
|
A LIB 10A P
|
||
|
|
A</pre>
|
||
|
|
</div>
|
||
|
|
<div class="example"><p>When using a graphical display station attached to a controller
|
||
|
|
that supports an enhanced interface for nonprogrammable workstations, the
|
||
|
|
selection field looks like this:</p>
|
||
|
|
<br /><img src="rv2w863.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>
|