diff docs/nitros9guide/setime.refentry @ 138:d9631713b7cd

Split up the commands into individual files.
author roug
date Sun, 07 Jul 2002 08:58:56 +0000
parents
children b5ff125a1d60
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/nitros9guide/setime.refentry	Sun Jul 07 08:58:56 2002 +0000
@@ -0,0 +1,45 @@
+<refentry id="setime">
+<refnamediv>
+<refname>SETIME</refname>
+<refpurpose>Activate and set system clock</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>SETIME</command>
+<arg choice="opt">y,m,d,h,m,s</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+This command sets the system date and time, then activates the real
+time clock. The date and time can be entered as parameters, or if no
+parameters are given, SETIME will issue a prompt. Numbers are one
+or two decimal digits using space, colon, semicolon or slash
+delimiters. OS-9 system time uses the 24 hour clock, i.e., 1520 is
+3:20 PM.
+</para>
+<para>
+IMPORTANT NOTE: This command must be executed before OS-9 can
+perform multitasking operations. If the system does not have a real
+time clock this command should still be used to set the date for the
+file system.
+</para>
+<para>
+SYSTEMS WITH BATTERY BACKED UP CLOCKS: Setime should still be run to
+start time-slicing, but only the <emphasis>year</emphasis> need be given,
+the date and time will be read from the clock.
+</para>
+</refsect1>
+<refsect1><title>Examples</title>
+<screen>
+OS9: setime 82,12,22,1545 (Set to: Dec. 12, 1981, 3:45 PM)
+
+OS9: setime 821222 154500 (Same as above)
+
+OS9: setime 82            (For system with battery-backup clock)
+</screen>
+</refsect1>
+</refentry>
+