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

89 lines
4.9 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="EDTMSK (Edit Mask) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to define an edit mask for fields with EDTCDE or EDTWRD keywords." />
<meta name="description" content="Use this field-level keyword to define an edit mask for fields with EDTCDE or EDTWRD keywords." />
<meta name="DC.subject" content="EDTMSK (Edit mask) keyword, Edit mask (EDTMSK) keyword, edit mask, creating" />
<meta name="keywords" content="EDTMSK (Edit mask) keyword, Edit mask (EDTMSK) keyword, edit mask, creating" />
<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="rzakcmstedtmsk" />
<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>EDTMSK (Edit Mask) keyword for display files</title>
</head>
<body id="rzakcmstedtmsk"><a name="rzakcmstedtmsk"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">EDTMSK (Edit Mask) keyword for display files</h1>
<div><p>Use this field-level keyword to define an edit mask for fields
with EDTCDE or EDTWRD keywords.</p>
<div class="section"><p>When a field is displayed with this keyword, user-specified areas
of the field are protected. The EDTMSK keyword is ignored when the workstation
is not attached to a controller that supports an enhanced data stream.</p>
<div class="p">The
format of the keyword is: <pre>EDTMSK(edit mask)</pre>
</div>
<p>One
parameter must be specified.</p>
<p>The edit mask is made of two characters:
an ampersand (&amp;) and a blank ( ). The ampersand represents a protected
part of the field. A blank represents an unprotected part of the field. The
edit mask must equal the display length of the field (after editing), and
the number of unprotected positions must equal the program length of the field.
The user must be careful to protect only nonnumeric data because protected
data is not returned to the user if the field is changed.</p>
<p>The field
containing the EDTMSK keyword must be usage I or usage B. It must also contain
the EDTCDE or EDTWRD keywords.</p>
<p>The following keywords cannot be specified
on a field with the EDTMSK keyword:</p>
<ul><li>AUTO (RAB, RAZ)</li>
<li>CHECK(AB, MF, RB, RZ, RLTB)</li>
<li>CHOICE</li>
<li>CNTFLD</li>
<li>DSPATR(OID SP)</li>
</ul>
<p>Option indicators are not valid for this keyword.</p>
<p>The EDTMSK
keyword reduces the number of available input fields by total number of segments
that are used to compose that particular field. For example, EDTMSK(' &amp; &amp;
') is composed of 3 segments and thus reduces the number of available input
by 3.</p>
<p>If the ENTFLDATR keyword is specified with the EDTMSK keyword,
you might have unpredictable results.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the EDTMSK keyword:</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RECORD
A F1 11 0B 3 4EDTWRD('0( ) - ')
A EDTMSK(' &amp; &amp; &amp; ')
A F2 6 0B 4 4EDTCDE(Y)
A EDTMSK(' &amp; &amp; ')
A</pre>
<p>In this example, the dash and parentheses in field 1
are protected. Also, the data separators in field 2 are protected.</p>
</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>