134 lines
8.2 KiB
HTML
134 lines
8.2 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="CFnn (Command Function) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this file- or record-level keyword to specify that the function key specified in the keyword (CF01 through CF24) is available for use." />
|
||
|
|
<meta name="description" content="Use this file- or record-level keyword to specify that the function key specified in the keyword (CF01 through CF24) is available for use." />
|
||
|
|
<meta name="DC.subject" content="CFnn (Command Function) keyword, Command Function (CFnn) keyword" />
|
||
|
|
<meta name="keywords" content="CFnn (Command Function) keyword, Command Function (CFnn) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="s36retkeyretcmd.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="rzakcmstdfcfnn" />
|
||
|
|
<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>CFnn (Command Function) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfcfnn"><a name="rzakcmstdfcfnn"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">CFnn (Command Function) keyword for display files</h1>
|
||
|
|
<div><p>Use this file- or record-level keyword to specify that the function
|
||
|
|
key specified in the keyword (CF01 through CF24) is available for use.</p>
|
||
|
|
<div class="section"><p>It is to be used as a command function (CF) key to transmit changed
|
||
|
|
data as opposed to a command attention (CA) key, which does not transmit changed
|
||
|
|
data. Response indicators 01 through 99 are valid.</p>
|
||
|
|
<p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic
|
||
|
|
for special considerations when you specify the CFnn keyword in files that
|
||
|
|
are used in the System/36™ environment.</p>
|
||
|
|
<div class="p">The
|
||
|
|
format of the keyword is: <pre>CFnn[(response-indicator ['text'])]</pre>
|
||
|
|
</div>
|
||
|
|
<div class="p">If you specify this keyword, and the display station user
|
||
|
|
presses the specified function key, the following situation happens: <ul><li>All other function key response indicators in the input buffer are set
|
||
|
|
off (hex F0).</li>
|
||
|
|
<li>The response indicator, if specified with the CFnn keyword, is set on
|
||
|
|
(hex F1).</li>
|
||
|
|
<li>The <span class="keyword">i5/OS™</span> data management
|
||
|
|
feedback area is updated.</li>
|
||
|
|
<li>Data is placed in the input buffer according to data received from the
|
||
|
|
device.</li>
|
||
|
|
<li>Control is returned to your program.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>If you specify a response indicator and the key is pressed, the
|
||
|
|
response indicator is set on and returned to your program along with the input
|
||
|
|
data. If no response indicator is specified, the input data is returned to
|
||
|
|
your program. (The text information is associated with the indicator and is
|
||
|
|
used by high-level language compilers to help in program documentation.)</p>
|
||
|
|
<p>If
|
||
|
|
the display station user presses a function key and you have not specified
|
||
|
|
it as either a CF key or a CA key, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system displays a message to the display station user indicating that the
|
||
|
|
key is not valid at that time.</p>
|
||
|
|
<p>You can use combinations of CF and CA
|
||
|
|
keywords within the same display file, but you cannot specify the same key
|
||
|
|
number as both command attention and command function. For example, CA01 and
|
||
|
|
CF01 are not valid in the same display file.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> File level CA and CF
|
||
|
|
keys are extended to the record level. This must be considered when assigning
|
||
|
|
key numbers. For example, if CA02 is specified at file level and CF02 is specified
|
||
|
|
at record level, CF02 is an error.</div>
|
||
|
|
<p>If you specify a key in the range
|
||
|
|
1 through 9, you must supply the leading zero in the keyword (for example,
|
||
|
|
CF03).</p>
|
||
|
|
<p>Option indicators are valid for this keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Function keys valid for command function keys at processing
|
||
|
|
time</h4><p>As a general rule, the last output operation
|
||
|
|
determines which function keys are valid. The following list shows exceptions
|
||
|
|
to this rule:</p>
|
||
|
|
<ul><li>When an operation sends no data to the display, the validity of the various
|
||
|
|
function keys is not changed. Such operations include: <ul><li>An output operation to a subfile record</li>
|
||
|
|
<li>An update to a subfile record</li>
|
||
|
|
<li>An output operation to a subfile control record that only clears, deletes,
|
||
|
|
or initializes a subfile without displaying the subfile or the subfile control
|
||
|
|
record</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>An output operation that displays an error message by selecting ERRMSG
|
||
|
|
or ERRMSGID can also select a CA or CF key to be valid while the error message
|
||
|
|
is displayed.</li>
|
||
|
|
<li>If SFLDROP is specified for a subfile, the validity of the CA or the CF
|
||
|
|
key specified for the SFLDROP keyword is determined by the last output operation.
|
||
|
|
However, as long as the subfile is displayed, the CA or CF key, when valid,
|
||
|
|
acts only as a Drop key.</li>
|
||
|
|
<li>If SFLFOLD is specified for a subfile, the validity of the CA or the CF
|
||
|
|
key specified for the SFLFOLD keyword is determined by the last output operation.
|
||
|
|
However, as long as the subfile is displayed, the CA or CF key, when valid,
|
||
|
|
acts only as a Fold key.</li>
|
||
|
|
<li>If two subfiles using SFLDROP or SFLFOLD are displayed at one time, the
|
||
|
|
same function key should be specified on both the SFLDROP and SFLFOLD keywords.
|
||
|
|
If they are different, only the key specified for the most recently displayed
|
||
|
|
subfile is in effect. Pressing the function key affects the subfile containing
|
||
|
|
the cursor. If the cursor is not positioned in a subfile, the function key
|
||
|
|
affects the upper subfile.</li>
|
||
|
|
<li>If two subfiles using SFLENTER are displayed at the same time, the only
|
||
|
|
CA or CF key in effect as an Enter key is the CA or CF key specified for the
|
||
|
|
SFLENTER keyword on the most recently displayed subfile. The cursor position
|
||
|
|
at the time the Enter key is pressed determines which subfile is affected.</li>
|
||
|
|
</ul>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> The ROLLUP and ROLLDOWN keywords function like CF keys.</div>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the CFnn keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A CF01(91 'End of Program')
|
||
|
|
00020A CF02(92)
|
||
|
|
00030A CF03
|
||
|
|
A</pre>
|
||
|
|
</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="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="s36retkeyretcmd.htm" title="Use these record-level keywords to indicate that function keys, command function (CFnn) keys, or command attention (CAnn) keys, which were enabled on a display, should be retained when the record you are defining is displayed.">RETKEY (Retain Function Keys) and RETCMDKEY (Retain Command Keys) keywords</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|