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

94 lines
5.4 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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="TIMSEP (Time Separator) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to specify the separator character that is used for a time field. This keyword is valid only for time fields (data type T)." />
<meta name="description" content="Use this field-level keyword to specify the separator character that is used for a time field. This keyword is valid only for time fields (data type T)." />
<meta name="DC.subject" content="TIMSEP (Time Separator) keyword, Time Separator (TIMSEP) keyword" />
<meta name="keywords" content="TIMSEP (Time Separator) keyword, Time Separator (TIMSEP) 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="rzakcmstdftimse" />
<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>TIMSEP (Time Separator) keyword for display files</title>
</head>
<body id="rzakcmstdftimse"><a name="rzakcmstdftimse"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">TIMSEP (Time Separator) keyword for display files</h1>
<div><p>Use this field-level keyword to specify the separator character
that is used for a time field. This keyword is valid only for time fields
(data type T).</p>
<div class="section"><div class="p">The format of the keyword is: <pre>TIMSEP(*JOB | 'time-separator')</pre>
</div>
<p>The
time-separator parameter specifies the separator character that appears between
the hour, minute, and second values. Valid values are a colon (:), a period
(.), a comma (,), and a blank ( ). Single quotation marks must enclose
the parameter.</p>
<p>If you specify the *ISO, *USA, *EUR, or *JIS time-format
values for the TIMFMT keyword, you should not specify the TIMSEP keyword.
These formats have fixed separators.</p>
<p>If you do not
specify the TIMSEP keyword and you specify TIMFMT as a format that does not
have a fixed date separator, TIMSEP is set to *JOB as default.</p>
<p>If you
specify *JOB or if TIMSEP is set to *JOB as default, the high-level language
and the application handle the separator as a colon (:). On output the system
converts the separator that was specified by the Time Separator Job Definition
Attribute. On input, the system converts the separator to a colon (:) before
passing control to the application.</p>
<p>The separator for DFT, DFTVAL, and
MAPVAL keyword values must match the separator that the TIMSEP keyword specifies.
If the TIMSEP keyword specifies *JOB the TIMSEP keyword is set to *JOB as
default, these values must a colon ':' format.</p>
<p>The TIMSEP keyword overrides
the job attribute for a time field. It does not change the system default.</p>
<p>It
is the responsibility of the high-level language and the application format
the time field according to the format specified for the TIMFMT keyword and
use the separators specified for the TIMSEP keyword. The system does format
fields on output. The system validates the time field on input according to
the format that the TIMFMT keyword specifies and the separator that the TIMSEP
keyword specifies.</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 TIMSEP keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A
00020A R RECORD
00030A TIMFLD1 T TIMFMT(*HMS) TIMSEP(' ')
00040A TIMFLD2 T TIMFMT(*HMS) TIMSEP('.')
00050A TIMFLD3 T TIMFMT(*HMS) TIMSEP(*JOB)</pre>
<p>If you want to display 2 o'clock p.m. and the time separator
that is defined by the Definition Attribute is :, the following
values are displayed when RECORD1 appears.</p>
<pre>TIMFLD1 14 00 00
TIMFLD2 14.00.00
TIMFLD3 14:00:00</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>
</body>
</html>