friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstchcctl.htm

142 lines
8.4 KiB
HTML
Raw Permalink Blame History

<?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 &amp;control-field [msg-id [msg-lib/]msg-file])
<strong>or</strong>
CHCCTL(choice-number &amp;control-field [&amp;msg-id [&amp;msg-lib/]&amp;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 ">&nbsp;</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 ">&nbsp;</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 ">&nbsp;</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 '&gt;Undo ')
A CHOICE(2 '&gt;Mark ')
A CHOICE(3 '&gt;Copy ')
A CHCCTL(1 &amp;CTLUNDO MSG1112 QUSER/A)
A CHCCTL(2 &amp;CTLMARK &amp;MSG &amp;LIB/&amp;MSGF);
A CHCCTL(3 &amp;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&#xA;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>
Reference in New Issue View Git Blame Copy Permalink