Datimec is a client of the timesync server. This GPL application will connect and send/receive data from/to any timesync server. This application uses either TCP sockets or QNX native message passing as the IPC method. Note that any mention of QNX in this document refers to the QNX 4.x OS.
The datimec client will obtain the date and time from a timesync server and (by default) set the local machine date and time to the same values.
The application also uses the socloc APIs to interface to the socloc server. Note that the QNX version of this application does not use or require socloc.
Since datimec program uses the socloc APIs (TCP only), you first must create the socloc startup file which should contain a list of suggested socloc servers. The list may be incomplete but at least one entry must describe an active socloc server. The socloc startup file must be located in the current directory when you execute the datimec program.
When datimec is executed, it will attempt to connect to a socloc server listed in the socloc startup file. The application will then attempt to find a running timesync server. Once a proper connection has been established to both servers, the current socloc config list will be obtained from the socloc server. This list will be used to replace the socloc config list loaded from the socloc startup file.
The datimec application can be compiled on all stated platforms except DOS where there is no TCP IPC and Mac. Under the Linux/Unix/QNX operating systems, the datimec application can be compiled using the mkdatimec script.
The datimec program has the following syntax:
datimec [-n] [-q] [-l[ log_file]]
Where the option n will report but not set the date/time, the option q will suppress all console message output (quiet) and the l (el) option will output all messages to either the default log file or the supplied log file. Note that the option/switch character is based on the platform and may be not the hyphen (as above).