ibm-information-center/dist/eclipse/plugins/i5OS.ic.dm_5.4.0.1/rbal3copydttf.htm

81 lines
5.9 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<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="concept" />
<meta name="DC.Title" content="Date, time, and timestamp fields used by the INCREL parameter" />
<meta name="abstract" content="The INCREL parameter allows date, time, and timestamp fields. The copy command compares the input field value chronologically to the value in the date, time, or timestamp field to determine if it should select the record." />
<meta name="description" content="The INCREL parameter allows date, time, and timestamp fields. The copy command compares the input field value chronologically to the value in the date, time, or timestamp field to determine if it should select the record." />
<meta name="DC.Relation" scheme="URI" content="rbal3copyreco.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3copydttf" />
<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>Date, time, and timestamp fields used by the INCREL parameter</title>
</head>
<body id="rbal3copydttf"><a name="rbal3copydttf"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Date, time, and timestamp fields used by the INCREL parameter</h1>
<div><p>The INCREL parameter allows date, time, and timestamp fields. The
copy command compares the input field value chronologically to the value in
the date, time, or timestamp field to determine if it should select the record.</p>
<div class="p">The system attempts to convert the input string and the actual field value
to an internal form that is chronologically compared. These rules apply to
the conversion: <ul><li><strong>If the from-field is a date field,</strong> the system determines if the
user-input field value is in the same format and has the same separator as
specified in the current job under which the copy command is running. The
format can be *MDY, *DMY, *YMD, or *JUL and can use a slash (/), hyphen (-),
period (.), comma (,), or blank ( ) for the separator. If the user-input field
value does not use the same format or separator form of the current job, the
system determines if it is one of the SAA<sup>®</sup> formats (*ISO, *USA, *EUR, OR *JIS)
or if it is a YYYYDDD form with no separators. If the system determines that
the user-input field value is one of these forms, it converts the input string
to an internal form. The from-field is then converted to its internal form,
and the comparison is made. If the user-input string format cannot be determined,
or the length or data value is not valid, a diagnostic message is issued and
the copy operation ends. You must left-justify the date portion of the user-input
field value; it can contain trailing blanks.</li>
<li><strong>If the from-field is a time field,</strong> the system determines if the
user-input field value is in the same format and has the same separator as
specified in the current job under which the copy command is running. The
format can be HHMMSS and have a colon (:), comma (,), period (.), or blank
( ) for the separator. If the user-input field value is not in the specified
format and separator form of the current job, the system determines if it
is in one of the SAA formats (*ISO, *USA, *EUR, or *JIS). If the system
determines that the user-input key value is in one of these forms, it converts
the input string to an internal form. The from-field is then converted to
its internal form, and the chronological comparison is made. If the user-input
string format cannot be determined or the length or data value is not valid,
a diagnostic message is issued and the copy operation ends. You must left-justify
the time portion of the user-input field value; it can contain trailing blanks.</li>
<li><strong>If the from-field is a timestamp field,</strong> the system first determines
if the user-input field value is in the SAA format or YYYYMMDDHHMMSS form (no separators).
If the system determines that the user-input field value is in one of these
forms, it converts the input string to an internal form. The from-field is
then converted to its internal form and the chronological comparison is made.
If the user input string format cannot be determined, or the length or data
value is not valid, a diagnostic message is issued and the copy operation
ends. You must left-justify the timestamp portion of the user-input field
value; it can contain trailing blanks.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3copyreco.htm" title="You use the INCREL parameter to select records for copying by testing for the value of an entire field. Unlike the INCCHAR parameter, you can use the INCREL parameter only when you are copying from a database file, and you can test for different values in different fields on one copy command.">Select records based on field value (INCREL parameter)</a></div>
</div>
</div>
</body>
</html>