641 lines
23 KiB
HTML
641 lines
23 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Change Time Zone Description (CHGTIMZON)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CHGTIMZON.Top_Of_Page"></a>
|
|
<h2>Change Time Zone Description (CHGTIMZON)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Yes
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CHGTIMZON.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGTIMZON.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGTIMZON.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGTIMZON"></a>
|
|
<p>The Change Time Zone Description (CHGTIMZON) command changes a time zone description object that defines the properties of a time zone. These properties are used to convert time values between Coordinated Universal Time (UTC) form and local forms. These properties are also used to express time values in local forms.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have change (*CHANGE) authority to the time zone description being changed.
|
|
</li>
|
|
<li>You must have execute (*EXECUTE) authority to the QSYS library.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGTIMZON.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTIMZON.TIMZON"><b>TIMZON</b></a></td>
|
|
<td valign="top">Time zone description</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTIMZON.OFFSET"><b>OFFSET</b></a></td>
|
|
<td valign="top">Offset</td>
|
|
<td valign="top">-779-779, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGTIMZON.STDNAME"><b>STDNAME</b></a></td>
|
|
<td valign="top">Standard Time</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *GEN, *MSG<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Abbreviated name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Full name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGTIMZON.DSTNAME"><b>DSTNAME</b></a></td>
|
|
<td valign="top">Daylight Saving Time (DST)</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *GEN, *MSG<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Abbreviated name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Full name</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTIMZON.STDMSG"><b>STDMSG</b></a></td>
|
|
<td valign="top">Standard Time message</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTIMZON.DSTMSG"><b>DSTMSG</b></a></td>
|
|
<td valign="top">Daylight Saving Time message</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGTIMZON.MSGF"><b>MSGF</b></a></td>
|
|
<td valign="top">Message file</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="5"><a href="#CHGTIMZON.DSTSTR"><b>DSTSTR</b></a></td>
|
|
<td valign="top">Daylight Saving Time start</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Month</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *JAN, *FEB, *MAR, *APR, *MAY, *JUN, *JUL, *AUG, *SEP, *OCT, *NOV, *DEC</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Day</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *MON, *TUE, *WED, *THU, *FRI, *SAT, *SUN</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Relative day of month</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *LAST, 1, 2, 3, 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#CHGTIMZON.DSTEND"><b>DSTEND</b></a></td>
|
|
<td valign="top">Daylight Saving Time end</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Month</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *JAN, *FEB, *MAR, *APR, *MAY, *JUN, *JUL, *AUG, *SEP, *OCT, *NOV, *DEC</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Day</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *MON, *TUE, *WED, *THU, *FRI, *SAT, *SUN</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Relative day of month</td>
|
|
<td valign="top">
|
|
<b><u>*SAME</u></b>, *LAST, 1, 2, 3, 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGTIMZON.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGTIMZON.TIMZON"></a>
|
|
<h3>Time zone description (TIMZON)</h3>
|
|
<p>Specifies the time zone description to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the time zone description.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.OFFSET"></a>
|
|
<h3>Offset (OFFSET)</h3>
|
|
<p>Specifies the time difference, in minutes, between this time zone and Coordinated Universal Time (UTC). This value is subtracted from local time to obtain UTC time. A negative difference indicates that the time zone is west of UTC and a positive difference indicates that the time zone is east of UTC.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>-779 to 779</i></b></dt>
|
|
<dd>Specify the time difference, in minutes. Valid values range from -779 minutes to 779 minutes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.STDNAME"></a>
|
|
<h3>Standard Time (STDNAME)</h3>
|
|
<p>Specifies the abbreviated and full names of the time zone when Daylight Saving Time is not being observed.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*GEN</b></dt>
|
|
<dd>The system will generate the abbreviated and full names. The format of the abbreviated name will be the letters 'UTC' followed by the offset followed by the letter 'S'. The offset will appear as a formatted hour and minute value. The full name for the time zone description will be the same as the abbreviated name. For example, a time zone that has an offset of -360 minutes would have an abbreviated and a full name of 'UTC-06:00S'.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>The abbreviated and full names will be retrieved from the second-level message text of the message specified for the <b>Standard Time message (STDMSG)</b> parameter. When this value is specified, a Standard Time message and message file must be specified for the time zone description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Abbreviated name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the abbreviated or short name for this time zone. The abbreviated name has a maximum length of 10 characters.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Full name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the full or long name for this time zone. The full name has a maximum length of 50 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.DSTNAME"></a>
|
|
<h3>Daylight Saving Time (DST) (DSTNAME)</h3>
|
|
<p>Specifies the abbreviated and full names of the time zone when Daylight Saving Time is being observed. When this parameter is changed to a value other than *NONE, Daylight Saving Time start and end information must be specified for the time zone description.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>This time zone does not observe Daylight Saving Time.
|
|
</dd>
|
|
<dt><b>*GEN</b></dt>
|
|
<dd>The system will generate the abbreviated and full names. The format of the abbreviated name will be the letters 'UTC' followed by the offset followed by the letter 'D'. The offset will appear as a formatted hour and minute value. The full name for the time zone description will be the same as the abbreviated name. For example, a time zone that has an offset of -360 minutes would have an abbreviated and a full name of 'UTC-06:00D'.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>The abbreviated and full names will be retrieved from the second-level message text of the message specified for the <b>Daylight Saving Time message (DSTMSG)</b> parameter. When this value is specified, a Daylight Saving Time message and message file must be specified for the time zone description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Abbreviated name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the abbreviated or short name for this time zone. The abbreviated name has a maximum length of 10 characters.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Full name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the full or long name for this time zone. The full name has a maximum length of 50 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.STDMSG"></a>
|
|
<h3>Standard Time message (STDMSG)</h3>
|
|
<p>Specifies the predefined message that contains the abbreviated and full names of the time zone that are used when Daylight Saving Time is not being observed. The first 10 characters of the message contain the abbreviated name and the next 50 characters contain the full name. A message identifier can be specified for this parameter only when *MSG is specified for the Standard Time name of the time zone description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the message identifier.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.DSTMSG"></a>
|
|
<h3>Daylight Saving Time message (DSTMSG)</h3>
|
|
<p>Specifies the predefined message that contains the abbreviated and full names of the time zone that are used when Daylight Saving Time is being observed. The first 10 characters of the message contain the abbreviated name and the next 50 characters contain the full name. A message identifier can be specified for this parameter only when *MSG is specified for the Daylight Saving Time name of the time zone description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the message identifier.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.MSGF"></a>
|
|
<h3>Message file (MSGF)</h3>
|
|
<p>Specifies the message file from which the Standard Time message and the Daylight Saving Time message are to be retrieved. The specified message file name and library name are stored in the time zone description. When a message is used to specify the abbreviated and full names, the message is retrieved each time the abbreviated or full names are retrieved. If the message cannot be retrieved from the message file, the names will be returned as *N. A message file can be specified for this parameter only when *MSG is specified for the Standard Time name or the Daylight Saving Time name of the time zone description.
|
|
</p>
|
|
<p><b>Qualifier 1: Message file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the thread's library list are searched for the message file when the message is retrieved. The value *LIBL is saved in the time zone description and is not resolved to a library name by this command.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the message file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.DSTSTR"></a>
|
|
<h3>Daylight Saving Time start (DSTSTR)</h3>
|
|
<p>Specifies when Daylight Saving Time (DST) starts. This parameter contains four elements: the month in which DST starts, the day on which DST starts, the relative day of the month on which DST starts and the time at which DST starts. If this parameter is specified, all four elements must be specified. This parameter can be changed only when a value other than *NONE is specified for the Daylight Saving Time name of the time zone description. The Daylight Saving Time start information cannot be identical to the Daylight Saving Time end information.
|
|
</p>
|
|
<p><b>Element 1: Month</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*JAN</b></dt>
|
|
<dd>Daylight Saving Time starts in January.
|
|
</dd>
|
|
<dt><b>*FEB</b></dt>
|
|
<dd>Daylight Saving Time starts in February.
|
|
</dd>
|
|
<dt><b>*MAR</b></dt>
|
|
<dd>Daylight Saving Time starts in March.
|
|
</dd>
|
|
<dt><b>*APR</b></dt>
|
|
<dd>Daylight Saving Time starts in April.
|
|
</dd>
|
|
<dt><b>*MAY</b></dt>
|
|
<dd>Daylight Saving Time starts in May.
|
|
</dd>
|
|
<dt><b>*JUN</b></dt>
|
|
<dd>Daylight Saving Time starts in June.
|
|
</dd>
|
|
<dt><b>*JUL</b></dt>
|
|
<dd>Daylight Saving Time starts in July.
|
|
</dd>
|
|
<dt><b>*AUG</b></dt>
|
|
<dd>Daylight Saving Time starts in August.
|
|
</dd>
|
|
<dt><b>*SEP</b></dt>
|
|
<dd>Daylight Saving Time starts in September.
|
|
</dd>
|
|
<dt><b>*OCT</b></dt>
|
|
<dd>Daylight Saving Time starts in October.
|
|
</dd>
|
|
<dt><b>*NOV</b></dt>
|
|
<dd>Daylight Saving Time starts in November.
|
|
</dd>
|
|
<dt><b>*DEC</b></dt>
|
|
<dd>Daylight Saving Time starts in December.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Day</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*MON</b></dt>
|
|
<dd>Daylight Saving Time starts on a Monday.
|
|
</dd>
|
|
<dt><b>*TUE</b></dt>
|
|
<dd>Daylight Saving Time starts on a Tuesday.
|
|
</dd>
|
|
<dt><b>*WED</b></dt>
|
|
<dd>Daylight Saving Time starts on a Wednesday.
|
|
</dd>
|
|
<dt><b>*THU</b></dt>
|
|
<dd>Daylight Saving Time starts on a Thursday.
|
|
</dd>
|
|
<dt><b>*FRI</b></dt>
|
|
<dd>Daylight Saving Time starts on a Friday.
|
|
</dd>
|
|
<dt><b>*SAT</b></dt>
|
|
<dd>Daylight Saving Time starts on a Saturday.
|
|
</dd>
|
|
<dt><b>*SUN</b></dt>
|
|
<dd>Daylight Saving Time starts on a Sunday.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Relative day of month</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>Daylight Saving Time starts on the last occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>1</b></dt>
|
|
<dd>Daylight Saving Time starts on the first occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>Daylight Saving Time starts on the second occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>3</b></dt>
|
|
<dd>Daylight Saving Time starts on the third occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>4</b></dt>
|
|
<dd>Daylight Saving Time starts on the fourth occurrence of the specified day of the week.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time of day at which Daylight Saving Time starts. The time is specified in 24-hour format and can be specified with or without a time separator.
|
|
<ul>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 to 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 to 59.
|
|
</li>
|
|
<li>With a time separator, specify a string of 5 or 8 characters where the time separator specified for your job is used to separate the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.DSTEND"></a>
|
|
<h3>Daylight Saving Time end (DSTEND)</h3>
|
|
<p>Specifies when Daylight Saving Time (DST) ends. This parameter contains four elements: the month in which DST ends, the day on which DST ends, the relative day of the month on which DST ends and the time at which DST ends. If this parameter is specified, all four elements must be specified. This parameter can be changed only when a value other than *NONE is specified for the Daylight Saving Time name of the time zone description. The Daylight Saving Time end information cannot be identical to the Daylight Saving Time start information.
|
|
</p>
|
|
<p><b>Element 1: Month</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*JAN</b></dt>
|
|
<dd>Daylight Saving Time ends in January.
|
|
</dd>
|
|
<dt><b>*FEB</b></dt>
|
|
<dd>Daylight Saving Time ends in February.
|
|
</dd>
|
|
<dt><b>*MAR</b></dt>
|
|
<dd>Daylight Saving Time ends in March.
|
|
</dd>
|
|
<dt><b>*APR</b></dt>
|
|
<dd>Daylight Saving Time ends in April.
|
|
</dd>
|
|
<dt><b>*MAY</b></dt>
|
|
<dd>Daylight Saving Time ends in May.
|
|
</dd>
|
|
<dt><b>*JUN</b></dt>
|
|
<dd>Daylight Saving Time ends in June.
|
|
</dd>
|
|
<dt><b>*JUL</b></dt>
|
|
<dd>Daylight Saving Time ends in July.
|
|
</dd>
|
|
<dt><b>*AUG</b></dt>
|
|
<dd>Daylight Saving Time ends in August.
|
|
</dd>
|
|
<dt><b>*SEP</b></dt>
|
|
<dd>Daylight Saving Time ends in September.
|
|
</dd>
|
|
<dt><b>*OCT</b></dt>
|
|
<dd>Daylight Saving Time ends in October.
|
|
</dd>
|
|
<dt><b>*NOV</b></dt>
|
|
<dd>Daylight Saving Time ends in November.
|
|
</dd>
|
|
<dt><b>*DEC</b></dt>
|
|
<dd>Daylight Saving Time ends in December.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Day</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*MON</b></dt>
|
|
<dd>Daylight Saving Time ends on a Monday.
|
|
</dd>
|
|
<dt><b>*TUE</b></dt>
|
|
<dd>Daylight Saving Time ends on a Tuesday.
|
|
</dd>
|
|
<dt><b>*WED</b></dt>
|
|
<dd>Daylight Saving Time ends on a Wednesday.
|
|
</dd>
|
|
<dt><b>*THU</b></dt>
|
|
<dd>Daylight Saving Time ends on a Thursday.
|
|
</dd>
|
|
<dt><b>*FRI</b></dt>
|
|
<dd>Daylight Saving Time ends on a Friday.
|
|
</dd>
|
|
<dt><b>*SAT</b></dt>
|
|
<dd>Daylight Saving Time ends on a Saturday.
|
|
</dd>
|
|
<dt><b>*SUN</b></dt>
|
|
<dd>Daylight Saving Time ends on a Sunday.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Relative day of month</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>Daylight Saving Time ends on the last occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>1</b></dt>
|
|
<dd>Daylight Saving Time ends on the first occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>2</b></dt>
|
|
<dd>Daylight Saving Time ends on the second occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>3</b></dt>
|
|
<dd>Daylight Saving Time ends on the third occurrence of the specified day of the week.
|
|
</dd>
|
|
<dt><b>4</b></dt>
|
|
<dd>Daylight Saving Time ends on the fourth occurrence of the specified day of the week.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: Time</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time of day at which Daylight Saving Time ends. The time is specified in 24-hour format and can be specified with or without a time separator.
|
|
<ul>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Valid values for <b>hh</b> range from 00 to 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 to 59.
|
|
</li>
|
|
<li>With a time separator, specify a string of 5 or 8 characters where the time separator specified for your job is used to separate the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGTIMZON.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>This value does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTIMZON.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the Offset</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTIMZON TIMZON(CENTRAL) OFFSET(-360)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the offset specified in the time zone description CENTRAL to negative six hours (-360 minutes).
|
|
</p>
|
|
<p><b>Example 2: Changing the Daylight Saving Time Start and End Information</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGTIMZON TIMZON(CENTRALDST)
|
|
DSTSTR(*OCT *SUN *LAST '02:00:00')
|
|
DSTEND(*APR *SUN 1 '02:00:00')
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the Daylight Saving Time start and end information for the time zone description CENTRALDST. Daylight Saving Time will start at 2:00 am on the last Sunday in October and will end at 2:00 am on the first Sunday in April.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGTIMZON.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF09A0</b></dt>
|
|
<dd>Time zone description &1 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGTIMZON.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|