admdate(1M)                    DG/UX R4.11MU05                   admdate(1M)


NAME
       admdate - manipulate the system date, time and time zone

SYNOPSIS
       admdate -o set [ -m month-number ] [ -d day-of-month ] [ -H hour ] [
                 -M minute ] [ -Y year ] [ -Z time-zone ]

       admdate -o get [ -qv ]

DESCRIPTION
       admdate sets or displays the current system date, time, and time
       zone.

   Operations
       set       Set the current date, time, or time zone.  Restart the cron
                 command to incorporate the new date and time.

       get       Display the current date, time, and time zone.

   Options
       The following options may be used:

       -d day-of-month
                 Use day-of-month as the new day of the month (1-31).  The
                 default is the current day of the month.

       -H hour   Use hour as the new hour (0-23).  The default is the
                 current hour.

       -M minute Use minute as the new minute (0-59).  The default is the
                 current minute.

       -m month-number
                 Use month-number as the new month of the year (1-12).  The
                 default is the current month.

       -q        Use quiet mode.  The month, day, hour, minute, year, and
                 time zone are written to standard output.

       -v        Use verbose mode.  The current date, time, and time zone
                 are written to standard output in the appropriate format
                 for the current locale.

       -Y year   Use year as the new year (including the century).  If the
                 year does not include a century, the current century will
                 be used.  The default is the current year.

       -Z time-zone
                 Set the time zone to time-zone.  time-zone is a string of
                 the form defined in timezone(4).  The default is the
                 current time zone.

       If the -Z time-zone option is given, the /etc/TIMEZONE and
       /etc/TIMEZONE.csh files are updated to reflect the new time-zone.  If
       the time-zone is the name of a file found in the /usr/lib/locale/TZ
       directory, the time zone for the system is set to :time-zone.

EXAMPLES
       In order to set the date to 8 p.m. on March 2 of 1992, use this
       command line:

           admdate -o set -m 3 -d 2 -H 20 -M 0 -Y 1992


       To change to the Pacific time zone, use this command line:

           admdate -o set -Z PST8PDT


FILES
       /etc/TIMEZONE
                 Updated to reflect the new time zone.

       /etc/TIMEZONE.csh
                 Updated to reflect the new time zone.

       /usr/lib/locale/TZ
                 Directory of compiled time zone databases.

OUTPUT
       The get operation writes the current date, time, and time zone to the
       standard output.

DIAGNOSTICS
   Warnings
        -  The new date is the same as the old date.

   Errors
        -  There is an error in the format of the new date or time.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       date(1), cron(1M), zic(1M), ctime(3C), setlocale(3C), timezone(4).
       capdefaults(5).

NOTES
       The set operation restarts the cron(1M) command to incorporate the
       new date.  Other commands may not use the new date until the commands
       are restarted or the system is rebooted.

       Although it is possible to correctly change the date and timezone at
       the same time, to avoid errors, it is better to change them with
       separate invocations of admdate.

       In order for a timezone change to have an effect, the user will have
       to logout and login again.

       You must have appropriate privilege to perform the set operation.  On
       a generic DG/UX system, appropriate privilege means that you have
       superuser privilege, or an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

       On a system with DG/UX information security, appropriate privilege is
       defined as having one one or more specific capabilities enabled in
       the effective capability set of the user.  See capdefaults(5) for
       the default capabilities for this command.



Licensed material--property of copyright holder(s)