dxclock(1X)															       dxclock(1X)

Name
       dxclock - DECwindows interface to the clock

Syntax
       dxclock [ options ]

Description
       The  dxclock  command  displays a window that continuously displays the system date and time. The clock can display time values in military
       style (0 through 23 hours) or in 12-hour AM and PM format.  The dxclock window has an alarm and the following components:

       Analog region
       Digital region
       Date region

Options
       -bd color	   Specifies the color of the window's border (color displays only).  The default is specified by  means  of  the  Session
			   Manager's Customize Window dialog box.

       -bg color	   Specifies the color of the window's background (color displays only).  The default is specified by means of the Session
			   Manager's Customize Window dialog box.

       -d dispname	   Specifies the display screen on which dxclock displays its window.  If the display option  is  not  specified,  dxclock
			   uses  the  display  screen  specified  by  your  DISPLAY environment variable.  The display option has the format host-
			   name:number.  Using two colons (::) instead of one (:) indicates that DECnet is to be used for transport.  The  default
			   is :0.  For more information, see

       -display dispname   This option is the same as the -d option.

       -fg color	   Specifies the color of the text (color displays only).  The default is specified by means of the Session Manager's Cus-
			   tomize Window dialog box.

       -fn font 	   Specifies the font for all of the clock menus.  (The analog and digital fonts are automatically  scaled  to	match  the
			   clock size.) The default font is menu12. This option is overriden by the .Xdefaults file.

       -geometry	   Specifies the width, length, and location of the dxclock window.  If the geometry option is not specified, dxclock uses
			   default values.  The geometry option has the format [widthxlength][{+-}x{+-}y].  For more information about the  screen
			   coordinate system, see

       The dxclock window has one pop-up menu.	To display this pop-up menu, position the pointer anywhere within the dxclock window and click MB2
       (the middle mouse button unless you have redefined it).	This menu contains the following menu items:

       Settings...		Displays the Settings dialog box that lets you specify the clock regions to  display, turn on or turn off the  use
				of  24-hour  digital  time, set the alarm, and enter a message that appears when the alarm goes off.  You can also
				display this dialog box by placing the pointer at any position within the dxclock window and double-clicking MB1.

       Save Settings		Saves the clock's settings and its size and position, to use the next time you run the clock.

       Use System Settings	Restores the use of system default values for the clock's settings, size, and position.

       Help			Displays information about using the dxclock command.

       Exit			Closes the dxclock window.

Restrictions
       The system time cannot be changed while the clock is running.  The dxclock window must be  closed  and  reopened  if  the  system  time	is
       changed.

X Defaults
       The  dxclock  application uses the values in the .Xdefaults file when you logged in and uses the appropriate resource specification to cus-
       tomize the appearance dxclock window.  A resource specification in the .Xdefaults file has the following format:

       [name*]resource:    value

       name	 Specifies the application name or the name string that restricts the resource assignment to that application or to a component of
		 an application.  If this argument is not specified, the resource assignment is globally available to all X applications.

       resource  Specifies the resource.

       value	 Specifies the value that is to be assigned to the resource.

       Because	each  toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you can form
       the name string by adding widget class and name identifiers to the string.  For further information about adding  class	and  name  identi-
       fiers, see

       For dxclock, the available class identifiers is:

       Clock

       For dxclock, the available name identifiers are:

       Digital
       FontFamily

       In addition to the general resources listed in the resources available for dxclock are:

       AlarmOn		   Specifies  that  the alarm be turned on.  If set to zero, the alarm is not turned on.  If set to 1, the alarm is turned
			   on.	The default is zero.

       AlarmHour	   Specifies the hour the alarm is to go off (0 to 23).  The default is 12.

       AlarmMessage	   Specifies the message to be displayed when the alarm goes off.  The default is the string Alarm Message.

       AlarmMinute	   Specifies the minute the alarm is to go off (00 to 59).  The default is 00.

       AlarmPM		   Specifies that the alarm is set for PM.  If set to zero, the alarm is set for AM.  If set to 1, the alarm  is  set  for
			   PM.	The default is zero.

       AnalogOn 	   Specifies  whether  the  analog  portion of the dxclock window is displayed.  If set to zero, the analog portion is not
			   displayed.  If set to 1, the analog portion is displayed.  The default is 1.

       DateOn		   Specifies whether the date portion of the dxclock window is displayed.  If set to zero, the date portion  is  not  dis-
			   played.  If set to 1, the date portion is displayed. The default is 1.

       DigitalOn	   Specifies  whether  the digital portion of the dxclock window is displayed.	If set to zero, the digital portion is not
			   displayed.  If set to 1, the digital portion is displayed.  The default is 1.

       militaryOn	   Specifies whether the digital portion of the dxclock window	displays the date in 12-hour format or 24-hour format.	If
			   set to zero,  12-hour format is used. If set to 1,  24-hour format is used.	The default is zero.

       The  fonts  used  by  dxclock are specified by an asterisk (*).	This is done so that a font family is chosen instead of a particular font.
       The asterisk (*) is a wildcard character that matches all font sizes.

Files
       ~/.Xdefaults
       ~/.DXclock
       /usr/lib/X11/app-defaults/DXclock
       ~./DXclock

See Also
       X(1X), dxwm(1X),
       DECwindows Desktop Applications Guide

																       dxclock(1X)