105 lines
6.4 KiB
HTML
105 lines
6.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="UNLOCK (Unlock) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this record-level keyword to specify that the i5/OS operating system is to unlock the keyboard immediately after issuing an input operation to the record format you are defining." />
|
||
|
|
<meta name="description" content="Use this record-level keyword to specify that the i5/OS operating system is to unlock the keyboard immediately after issuing an input operation to the record format you are defining." />
|
||
|
|
<meta name="DC.subject" content="UNLOCK (Unlock) keyword" />
|
||
|
|
<meta name="keywords" content="UNLOCK (Unlock) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfgetr.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="rzakcmstdfunlok" />
|
||
|
|
<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>UNLOCK (Unlock) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfunlok"><a name="rzakcmstdfunlok"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">UNLOCK (Unlock) keyword for display files</h1>
|
||
|
|
<div><p>Use this record-level keyword to specify that the <span class="keyword">i5/OS™</span> operating system
|
||
|
|
is to unlock the keyboard immediately after issuing an input operation to
|
||
|
|
the record format you are defining.</p>
|
||
|
|
<div class="section"><p>Without the UNLOCK keyword, the <span class="keyword">i5/OS</span> operating system
|
||
|
|
leaves the keyboard locked after reading the data on the display. The workstation
|
||
|
|
user cannot key data into input-capable fields while the data that has just
|
||
|
|
been read is being processed.</p>
|
||
|
|
<div class="p">The format of the keyword is: <pre>UNLOCK[(*ERASE) | (*MDTOFF)] | [(*ERASE *MDTOFF)] | [(*MDTOFF *ERASE)]</pre>
|
||
|
|
</div>
|
||
|
|
<p>The parameter values *ERASE and *MDTOFF are optional. If you do not
|
||
|
|
specify any parameter value, *ERASE is the default.</p>
|
||
|
|
<p>When your program
|
||
|
|
sends an input operation, the following sequence of operations typically occurs:</p>
|
||
|
|
<ol><li>The keyboard is unlocked (if it is not already unlocked) to allow the
|
||
|
|
workstation user to key into input-capable fields on the display.</li>
|
||
|
|
<li>The workstation user presses the Enter key (or a valid function key).</li>
|
||
|
|
<li>Modified data tags (MDTs) for input-capable fields in the record format
|
||
|
|
are set on if they have been typed into or if they were displayed with the
|
||
|
|
DSPATR(MDT) keyword in effect.</li>
|
||
|
|
<li>When the input operation is completed, the parameter values for UNLOCK
|
||
|
|
affect the input-capable fields with MDTs set on as described in the following
|
||
|
|
sections.</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">UNLOCK (without GETRETAIN) or UNLOCK(*ERASE)</h4><p>The
|
||
|
|
keyboard remains unlocked, input-capable fields on the display are erased,
|
||
|
|
and their MDTs remain on following the input operation.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">UNLOCK(*MDTOFF) or UNLOCK (with GETRETAIN)</h4><p>The keyboard
|
||
|
|
remains unlocked, input-capable fields on the display are not erased, and
|
||
|
|
their MDTs are set off following the input operation.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">UNLOCK(*ERASE *MDTOFF) or UNLOCK(*MDTOFF *ERASE)</h4><p>The
|
||
|
|
keyboard remains unlocked, input-capable fields on the display with their
|
||
|
|
MDTs set on are erased, and their MDTs are set off following the input operation.</p>
|
||
|
|
<p>The
|
||
|
|
GETRETAIN keyword is ignored and an error message results at file creation
|
||
|
|
time if the GETRETAIN keyword is specified with UNLOCK(any parameter).</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> This keyword does not prevent your program from issuing
|
||
|
|
an output operation immediately after an input operation. However, the keyboard
|
||
|
|
is unlocked and the workstation user can be typing input data
|
||
|
|
when the output operation changes the display.</div>
|
||
|
|
<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 UNLOCK keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R RECORD1 UNLOCK(*ERASE)
|
||
|
|
00020A FLD1 4 B 2 2
|
||
|
|
00030A FLD2 4 B 3 2
|
||
|
|
A
|
||
|
|
00040A R RECORD2 UNLOCK(*MDTOFF)
|
||
|
|
00050A FLD21 4 B 4 2
|
||
|
|
00060A FLD22 4 B 5 2
|
||
|
|
A
|
||
|
|
00070A R RECORD3 UNLOCK(*ERASE *MDTOFF)
|
||
|
|
00080A FLD31 4 B 6 2
|
||
|
|
00090A FLD32 4 B 7 2
|
||
|
|
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="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzakcmstdfgetr.htm" title="Use this record-level keyword with the UNLOCK keyword to specify that the i5/OS operating system is not to erase input-capable fields on input operations as described under the UNLOCK keyword.">GETRETAIN (Get Retain) keyword for display files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|