98 lines
5.8 KiB
HTML
98 lines
5.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="MAPVAL (Map Values) keyword for display files" />
|
||
|
|
<meta name="abstract" content="Use this field-level keyword to map field data to a different value during input and output operations." />
|
||
|
|
<meta name="description" content="Use this field-level keyword to map field data to a different value during input and output operations." />
|
||
|
|
<meta name="DC.subject" content="MAPVAL (Map Values) keyword" />
|
||
|
|
<meta name="keywords" content="MAPVAL (Map Values) 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="rzakcmstdfmapval" />
|
||
|
|
<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>MAPVAL (Map Values) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfmapval"><a name="rzakcmstdfmapval"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">MAPVAL (Map Values) keyword for display files</h1>
|
||
|
|
<div><p>Use this field-level keyword to map field data to a different value
|
||
|
|
during input and output operations.</p>
|
||
|
|
<div class="section"><p>This keyword is only valid with the date (L), time (T), or timestamp
|
||
|
|
(Z) data types.</p>
|
||
|
|
<div class="p">The format of the keyword is: <pre>MAPVAL((program-value-1 system-value-1)
|
||
|
|
[(program-value-2 system-value-2) ...
|
||
|
|
(program-value-100 system-value-100)])]</pre>
|
||
|
|
</div>
|
||
|
|
<p>You can specify
|
||
|
|
the program value and the system value either as explicit values or as the
|
||
|
|
*BLANK or *CUR special values.</p>
|
||
|
|
<div class="p">You must specify an
|
||
|
|
explicit value within single quotation marks that matches the format and separator
|
||
|
|
values for the corresponding field. The explicit value must also be a valid
|
||
|
|
date or time. The following list indicates how the formats and separators
|
||
|
|
are determined: <ul><li>If the explicit value is a date (L) value, you must
|
||
|
|
use the format that the DATFMT keyword specifies. If the DATFMT keyword is
|
||
|
|
not specified or if DATFMT specifies *JOB, then you must use the *ISO format.
|
||
|
|
Also, you must use the separator that the DATSEP keyword specifies. If the
|
||
|
|
DATSEP keyword is not specified, or if DATSEP specifies the *JOB separator,
|
||
|
|
a slash (/) must be used for the separator.</li>
|
||
|
|
<li>If the explicit value is a time (T) value, you must use the format that
|
||
|
|
the TIMFMT keyword specifies. If the TIMFMT keyword is not specified, you
|
||
|
|
must use the *ISO format. Also, you must use the separator that the TIMSEP
|
||
|
|
keyword specifies. If the TIMSEP keyword is not specified or if TIMSEP specifies
|
||
|
|
the *JOB separator, you must use a colon (:) for the separator.</li>
|
||
|
|
<li>If the explicit value is a timestamp (Z) value, you must use the <var class="varname">yy-mm-dd-hh.mm.ss.mmmmmm</var> format.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The *BLANK special value indicates field data that is composed
|
||
|
|
of all blanks. The *CUR special value indicates that the date, time, or timestamp
|
||
|
|
makes up the current field data, depending on the data type of the field.</p>
|
||
|
|
<p>During
|
||
|
|
an output operation, the field data is compared to each program-value on the
|
||
|
|
MAPVAL keyword in the order in which the program-values are specified. For
|
||
|
|
the first match that is found, the corresponding system-value replaces the
|
||
|
|
current field data. If a match does not exist, the field data does not change.</p>
|
||
|
|
<p>During
|
||
|
|
an input operation, the field data is compared to each system-value on the
|
||
|
|
MAPVAL keyword in the order in which the system-values are specified. For
|
||
|
|
the first match that is found, the corresponding program-value replaces the
|
||
|
|
current field data. If a match does not exist, the field data remains the
|
||
|
|
same.</p>
|
||
|
|
<p>Option indicators are not valid for this keyword, although you
|
||
|
|
can use option indicators to condition the field for which it is specified.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
|
the MAPVAL keyword.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A
|
||
|
|
00020A R RECORD
|
||
|
|
00030A DATFLD1 L DATFMT(*MDY) DATSEP('/')
|
||
|
|
00040A MAPVAL(('01/01/40' *BLANK))
|
||
|
|
</pre>
|
||
|
|
<p>On output, if the field data equals '01/01/40', the field
|
||
|
|
data is changed to all blanks. On input, if the field data is blank, the field
|
||
|
|
data is changed to '01/01/40'.</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>
|