ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/rzakdmstpttimse.htm

88 lines
5.1 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="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 in printer files" />
<meta name="abstract" content="Use this field-level keyword to specify separator characters for time fields. This keyword is valid only for time fields (data type T)." />
<meta name="description" content="Use this field-level keyword to specify separator characters for time fields. 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="rzakdmstprkey.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="rzakdmstpttimse" />
<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 in printer files</title>
</head>
<body id="rzakdmstpttimse"><a name="rzakdmstpttimse"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">TIMSEP (Time Separator) keyword in printer files</h1>
<div><p>Use this field-level keyword to specify separator characters for
time fields. This keyword is valid only for time fields (data type T).</p>
<div class="section"><p>The format of the keyword is:</p>
<pre>TIMSEP(*JOB | 'time-separator')</pre>
<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
value for the TIMFMT keyword, you can 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, the TIMSEP defaults to *JOB.</p>
<p>If you specify *JOB
or if TIMSEP defaults to *JOB, 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 it passes control
to the application.</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 to 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 not 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 option indicators can
condition the field for which it is specified.</p>
</div>
<div class="section"><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
defined by the Job Definition Attribute is a colon (:), the following values
is displayed when RECORD1 is written.</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="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>