Instance Properties (General)
The general page contains the basic configuration settings for the service
instance.
- Serial port
- This is the serial port which the service will read from. The port may be
selected from the list or it may be typed in manually if it is not on the list.
When the service starts, it must have exclusive access to this port. No
other applications may be using this port.
- Speed (BPS)
- This is the port speed in bits per second, sometimes called the baud rate.
The speed may be selected from the list or it may be typed in manually if it is
not on the list.
- Byte Size
- This is the number of bits per byte. It is usually 7 (with parity) or 8 (without
parity) but can be any value between 4 and 8.
- Parity
- The parity can be none, odd, even, mark, or space.
- Stop Bits
- The number of stop bits can be 1, 1.5, or 2.
- Timestamp
- When set to Yes, each line in the log file will be prefixed with the current time in
the format "YYYY-MM-DD HH:MM:SS.sss:". Resolution up the millisecond is provided for
time-sensitive applications.
- Log File
- The log file is the full path to the file which will be written by the service.
Any data received from the specified serial port will be written to the log file.
No translation is performed on the data received from the serial port. If you
are using file security (NTFS), then you must ensure that the service account has write
access to this file. By default, the service account is the SYSTEM
built-in account. If the log file refers to a UNC path (ie. \\myserver\logs\log.txt),
then you must set the service account to a valid user with access to the specified
server. Please click here for more information
regarding service security.
- Browse button
- Click this button to open a file dialog that will allow to select a log file
path and name.
- Open button
- Click this button to view the log file. If the file type is associated with an
application, the application will be started. Otherwise, Windows Notepad will be
started. If Log Rotation is enabled, the current log file will be opened.
Note: Some application may not be able to open the file when the
service is running. If the application reports a file in use error, you may
need to pause the service before opening the log file in the application.
- Log Rotation
- When this feature is enabled (any setting other than None), the log file name
is time stamped and a new log file is created periodically. The time stamp format
depends on the selected period. For instance, if the Log File is set to
"pbx.log" and the Log Rotation setting is Daily, then each log file created
will have the format "pbxYYYYMMDD.log". On March 21st, 2002, the log file
will be "pbx20020321.log". Please note that the final extension (after the final period),
remains at the end of the file name. The following table shows the possible values
for this setting:
| Log Rotation | New Log On | File Name Suffix Format |
|---|
| None | never | none |
| Monthly | 1st of month at 00:00:00 (midnight) | yyyymm |
| Weekly | Sunday at 00:00:00 | yyyymmdd |
| Daily | 00:00:00 | yyyymmdd |
| Hourly | hh:00:00, hh = 00 to 23 | yyyymmddhh |
| Minutely | hh:mm:00 | yyyymmddhhmm |
- Event Log Settings
- The service records significant events to the Windows Event Log. Select which
(if any) events should be recorded in the Application Event Log. Use
Event Viewer to view these events.
- Start automatically when Windows starts
- Check this box to mark the service as Automatic. This causes the service to
start when Windows starts, even before the a user logs on. This should be checked
if you want to make sure that the service always runs.
- OK button
- Click this button to accept the service instance paramters. The configuration is not saved
until the Save Settings menu command is selected. Also any configuration changes
will not take effect until the service is restarted.
- Cancel button
- Click this button to cancel any changes made to the service instance parameters.
- Help button
- Opens the on-line help.