Основная функция программы - возможность записать любые данные в лог-файл. Для этого в программе предусмотрены широкие возможности (рис. 4.1.1). Сохраненный файл данных называют лог-файлом (журналом).
Рис. 4.1.1. Режимы формирования лог-файла
Сначала, выберите тип лог-файла, который вы будете получать: для принимаемых или отправляемых данных. Если вы активируете опцию "Записывать в лог файл для полученных данных", то получаемые и отправляемые данные будут записываться в один и тот же файл.
Затем, включите опцию "Формировать файлы логов на диске". После этого, укажите путь к папке, в которой будут сохраняться файлы, с помощью диалогового окна "Обзор папок", которое откроется после нажатия на кнопку с изображением открытой папки. В диалоговом окне выберите необходимую папку и нажмите "OK". Программа может работать с сетевыми дисками из сетевого окружения, но это может повлиять на скорость работы программы, а большой поток данных или перегрузка сети могут привести к отказу.
В Advanced TCP/IP Data Logger имя лог-файла - это штамп времени, и новый лог-файл создается через определенные промежутки времени.
Методика смены имени лог-файла определяется следующими основными параметрами:
•Префикс имени файла - набор символов, который будет добавляться к началу имени;
•Штамп времени в имени файла. Формат штампа времени зависит от выбранного в списке "Новый файл" режима. Например, если префикс имени файла установлен как "sample", расширение файла как "log ", а периодичность формирования файлов задана "Ежедневно", то каждый создаваемый лог-файл будет иметь формат "sampleYYYYMMDD.log". 21-го марта 2003 года будет создан лог-файл "sample20030321.log".
•Расширение имени файла - набор символов, который будет расширением имени файла (символы после точки).
Префикс, расширение, путь к папке могут быть символьной строкой разумной длины и содержать любые символы, допустимые в имени файла.
Выпадающий список "Новый файл" позволяет задать периодичность создания нового файла:
1.Ежедневно - новый файл будет создаваться каждый день, в указанное время. При этом в имя файла будет автоматически подставляться дата создания файла в формате DDMMYYYY, где DD - это двухзначное значение дня, MM - двухзначное значение месяца и YYYY - четырехзначное значение текущего года;
2.Ежемесячно - новый файл будет создаваться каждый месяц. При этом в имя файла будет автоматически подставляться дата создания файла в формате MMYYYY;
3.Формат пользователя - в этом режиме пользователь имеет возможность задать свою маску даты и времени, например YYYYMMDD;
4.Каждый пакет данных сохранять в отдельном файле - каждая полученная порция данных будет сохранена в отдельный файл. В данном режиме имя файла будет содержать не штамп времени, а порядковый номер. Например: sample00000001.log.Данный режим удобно использовать этот режим при записи в лог-файл после обработки;
5.Не создавать новый файл - новый файл не будет создаваться;
6.Еженедельно - новый файл будет создаваться каждую неделю. При этом в имя файла будет автоматически подставляться дата создания файла в формате WWYYYY, где WW - это двухзначное значение номера недели, а YYYY - четырехзначное значение текущего года;
7.После таймаута данных - новый файл будет создаваться, если данных не было в течении указанного пользователем промежутка времени;
8.Ежечасно - новый файл будет создаваться каждый час. При этом в имя файла будет автоматически подставляться дата создания файла в формате HHDDMMYYYY;
9.Постоянное имя файла с переименованием по времени - текущий лог-файл всегда будет иметь постоянное имя. В момент создания нового файла, существующий лог-файл будет сохранен с новым именем, содержащим штамп времени.
Возможные форматы даты и времени:
d - день, не включает ноль (1 - 31);
dd - день, включает ноль (01 - 31);
ddd - день недели в текстовом формате (Пн - Вс) согласно стандарту, установленному на данном компьютере;
dddd - день недели в полном текстовом формате (Понедельник - Воскресенье) согласно стандарту, установленному на данном компьютере;
m - месяц, не включает ноль (1 - 12);
mm - месяц, включает ноль (01 - 12);
mmm - месяц в текстовом формате (Янв - Дек) согласно стандарту, установленному на данном компьютере;
mmmm - месяц в полном текстовом формате (Январь - Декабрь) согласно стандарту, установленному на данном компьютере;
yy - год в формате двух последних разрядов (00 - 99);
yyyy - год в формате четырех последних разрядов (0000 - 9999);
h - часы, не включает ноль (0 - 23);
hh - часы, включает ноль (00 - 23);
n - минуты, не включает ноль (0 - 59);
nn - минуты, включает ноль (00 - 59);
s - секунды, не включает ноль (0 - 59);
ss - секунды, включает ноль (00-59).
Пример: Вы хотите создавать лог-файл каждый час. Также для Вас необходимо, чтобы имя файла начиналось с "sample_log", и чтобы расширение файла было "txt".
Ответ: установите префикс файла = sample_log_, расширение файла = txt (без точки!). В формате имени файла задайте HHDDMMYYYY. Теперь файл будет создаваться каждый час. Естественно, вы можете установить любую комбинацию символов формата, описанных выше.
Добавить значение даты и времени в имя файла - данная опция доступна для режимов создания нового файла №4 и №7 и позволяет включить в имя файла также и дату/время создания файла.
Добавить номер источника данных к имени файла - если данная опция включена, то в начало имени файла будет добавляться имя источника данных. Например, COM1-sample20030321.log.
Записывать дату/время перед записью данных - если данная опция включена, то программа будет записывать в файл штамп времени перед каждой порцией данных.
Перезаписывать существующие файлы - данная опция доступна для режимов создания нового файла №4 и №7. Если данная опция включена, то программа будет удалять существующий файл перед созданием нового.
Вы можете ограничить размер лог-файла, установив его размер в килобайтах в поле "Ограничить размер". Если вы укажите нулевой размер, размер файла не будет ограничиваться. Можно выбрать следующие режимы ограничения размера лог-файла:
1.Очистить файл - после достижения установленного размера файла текущий файл будет обнулен. Будьте внимательны!
2.Переименовать старый - после достижения установленного размера файла текущий файл будет переименован с другим именем.
3.Сдвинуть (без порога) - наиболее старые данные в лог файле будут удалены. Новые данные будут дописаны в конец файла.
4.Сдвинуть (с порогом срабатывания). В этом режиме программа будет ожидать, когда размер файла превысит установленное ограничение на размер порога срабатывания. В этом случае наиболее старые данные в лог файле будут удалены. Новые данные будут дописаны в конец файла. Данный режим эффективен, если данные поступают часто и мелкими порциями.