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

128 lines
7.8 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="HLPCMDKEY (Help Command Key) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword to return control to your application program after a command attention (CA) or command function (CF) key is pressed on an application help record format." />
<meta name="description" content="Use this record-level keyword to return control to your application program after a command attention (CA) or command function (CF) key is pressed on an application help record format." />
<meta name="DC.subject" content="HLPCMDKEY (Help Command Key) keyword, Help Command Key (HLPCMDKEY) keyword" />
<meta name="keywords" content="HLPCMDKEY (Help Command Key) keyword, Help Command Key (HLPCMDKEY) 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="rzakcmstdfhpcmk" />
<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>HLPCMDKEY (Help Command Key) keyword for display files</title>
</head>
<body id="rzakcmstdfhpcmk"><a name="rzakcmstdfhpcmk"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">HLPCMDKEY (Help Command Key) keyword for display files</h1>
<div><p>Use this record-level keyword to return control to your application
program after a command attention (CA) or command function (CF) key is pressed
on an application help record format.</p>
<div class="section"><p>This keyword is specified on the application help record format.
For control to return, the command key must be specified on both the application
record format and the application help record format.</p>
<p>This keyword has
no parameters.</p>
<p>A CA or CF key must be specified either at the file level
or on the help record containing the HLPCMDKEY keyword. If no CAnn or CFnn
keys are specified at the file level or on the help record, a warning message
(severity 10) is issued. If all the CAnn and CFnn keys specified at the file
level and on the same help record as the HLPCMDKEY keyword have option indicators,
a warning message (severity 10) is issued. When a response indicator is specified
on a CA or CF key on the application help record format, a warning message
(severity 10) is issued and the response indicator will be ignored.</p>
<div class="p">If
you specify this keyword on the help record and the display station user presses
one of the command keys that is specified on both the application record and
the application help record, the following case happens: <ul><li>If the command key is a CAnn key, no input data from the application record
format is transmitted to the application program.</li>
<li>If the command key is a CFnn key, input data from the application record
format is transmitted to the application program.</li>
<li>The command key will be returned to the application program.</li>
</ul>
</div>
<p>The command key must be specified on both the application record
format and the application help record format. If the command key is specified
only on the application record format, the command key will not be allowed
when the application help record format is displayed. If the command key is
specified only on the application help record format, the command key will
function as the Enter key and control will not return to the application program.</p>
<p>You
cannot specify HLPCMDKEY on subfile (SFL keyword), subfile control (SFLCTL
keyword), or user-defined (USRDFN keyword) record formats.</p>
<p>You cannot
specify the HLPCMDKEY keyword in a file containing the USRDSPMGT keyword.</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 HLPCMDKEY keyword. The first record is the application record format and
the second record is the application help record format.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R APPRCD CA01
00020A CA03
00030A CF12(12)
00040A CA04
00050A HELP
00060A H HLPRCD(HELPRCD)
00070A HLPARA(1 1 24 80)
00080A 8 2'THIS IS THE APPLICATION'
00090A 9 2'RECORD FORMAT'
00100A INPUT1 10 B 12 10
00110A INPUT2 10 B 13 10
00120A INPUT3 10 B 14 20
00130A*
00140A R HELPRCD HLPCMDKEY
00150A CA01(11)
00160A CF03
00170A CF05
00180A CF12
00190A 5 8'SPECIFY COMPANY NAME'
00200A 6 9'SPECIFY STREET'
00210A 7 10'SPECIFY CITY, STATE, ZIP'
A</pre>
<p>If the user is at the
application help display, the following case occurs:</p>
<ul><li>If the CMD1 key is pressed, control is returned to the application program,
but no data from the application record format is transmitted to the application
program. Response indicator 11 is not set on since it was specified on the
help record format rather than the application record format.</li>
<li>If the CMD12 key is pressed, control is returned to the application program
and data from the application record format is transmitted to the application
program. Response indicator 12 is on.</li>
<li>If the CMD5 key is pressed, it functions as the Enter key. The same CA
or CF keys must be specified on both the application record format and the
application help record format for control to be returned to the application
program.</li>
<li>If the CMD3 key is pressed, it functions as the Enter key. The corresponding
CA or CF keys must be specified on both the application help record format
and the application record format for control to be returned to the program.</li>
<li>If the CMD4 key is pressed, it results in a message indicating that the
CMD4 key is not allowed. The same CA or CF keys must be specified on both
the application record format and the application help record format in order
for control to be returned to the application program.</li>
</ul>
</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>