[?] Сервер РТС (rtVarSrv)#

Предупреждение

В настоящее время документация в этом разделе дорабатывается.

Если Вам необходима документация по этой теме, то просьба сообщить об этом.

Описание

Основное окно#

../../_images/1200.png

Окно утилиты состоит из следующих областей:

  1. Главное меню.

  2. Список программ.

  3. Состояние операции.

  4. Дневник состояния - выпадающий список сообщений генерируемые утилитой во время выполнения различных операций.

Главное меню#

Главное меню состоит из двух закладок

../../_images/2148.png

Программа#

Пункт меню Программа содержит основные данные: пункты управления и настройки утилиты.

../../_images/3103.png

Запустить / Остановить

Запускает/Останавливает процесс работы утилиты.

Настройка…

Открывает окно Параметры для настройки утилиты.

Сохранить настройки

Сохранение всех настроек осуществленных в окне Параметры.

О программе

Раздел с общими данными о программе.

Выход

Завершение работы программы.

Инструменты#

../../_images/468.png

Пункт меню Инструменты содержит информацию о выполняемых операциях и данные о переменных содержащихся на сервере.

Окно сообщений

Выбор данного пункта открывает стандартное окно сообщений, создаваемых при работе программы.

Окно переменных

Выбор пункта открывает окно Сервер содержащий список всех переменных конфигурации загруженной на сервер.

Список программ#

Область Списка программ содержит перечень всех утилит, которые подключены в данный момент к серверу.

../../_images/560.png

Таблица списка состоит из следующих столбцов:

Пустой столбец:

Номер ???

Адрес:

IP адрес утилиты подключенной к серверу.

Имя:

Идентификатор конкретного пользователя, под чьим именем было осуществлено подключение конкретной утилиты к серверу РТС.

Пак:

Количество загруженных пакетов данных. ???

Чт:

Количество прочитанных данных ???

Зап:

Количество записей ???

Тип:

???

Комментарий:

Дополнительные комментарии указанные в ???

Область «Операция»#

../../_images/650.png
Состояние:

Содержит информацию о текущем состоянии работы сервера.

Операция:

Отражает процесс соединения с конкретной утилитой в реальном режиме времени.

Настройки#

Диалог настроек утилиты вызывается из главного меню, с помощью пункта Программа‣Настройка.

Все настройки разделены на следующие группы:

В нижней части окна настроек располагаются кнопки управления.

../../_images/747.png

8

Закрывает окно с сохранением всех настроек установленных в окне Параметры.

9

Закрывает окно без сохранения установленных настроек.

10

Мастер настроек - кнопка с выпадающим списком ???

Максимальное логирование ???

Отключить логирование ???

Значения по умолчанию ???

Общие#

К группе общих настроек относятся различные параметры, которые влияют на работу сервера целиком.

../../_images/11100.png

Подтверждения#

../../_images/1242.png

Определяет, будет ли требоваться дополнительное подтверждение ждя выполнения действий выбранных в настройке.

  • Если настройка вкл, то для указанной операции будет показано дополнительное сообщение, требующее подтверждение пользователем.

Программа#

Группа настроек программа содержит набор настроек, которые определяют интерфейсное поведение утилиты.

../../_images/1337.png

Сворачивать при закрытии

Если вкл, то при нажатии на кнопку х окно программы будет не закрыто, а свернуто.

Запускать свернутым

Если вкл, то при запуске программы она автоматически будет свернута.

Поверх всех окон

Если вкл, окно утилиты будет всегда помещаться поверх всех остальных окон системы.

Разрешить запуск нескольких копий программы

Если вкл, то можно будет запустить несколько копий программы.

Если выкл, и утилита уже запущена, то новая копия программы активирует окно предыдущей копии программы и автоматически завершится.

Запретить основной лог файл

Если вкл, то при работе программы лог файл не создается.

Если выкл, то при работе программы все данные сохраняются в лог файл.

Сервер#

К группе настроек сервер относятся настройки запуска сервера и доступа к каталогам ???.

../../_images/1434.png

Соединение#

../../_images/1530.png

Автоматически запускать сервер при запуске программы

Если вкл, то при запуске программы сервер будет запущен автоматически и перейдет с состояние «Запущен», как если бы осуществлялось подключение через меню Программа‣Запустить.

Порт ожидания соединения

Номер порта, который будет использован для ожидания соединения с ???.

Каталог данных

В поле указывается каталог на локальном компьютере, в который будут сохраняться данные для работы программ.

Клиенты#

../../_images/1630.png

Время бездействия клиентов

???

Общие настройки клиентов

Окно типовых, общих для различных клиентов настроек в едином хранилище.

Настройка осуществляется в окне Общие настройки клиентов.

Разрешить доступ ко всем каталогам

Если вкл, то ???

Запретить клиентам использовать суперпользователя

Если вкл, то ???

Суперпользователь

Имя и логин доступа суперпользователя ???

Настройки клиентов#

На сервере хранятся общие параметры клиентов.

Общие параметры – это набор именованных значений, которые могут быть использованы любыми клиентами, осуществляющими к нему доступ.

При установке связи с сервером любым клиентом список общих параметров и их значения будут автоматически переданы клиенту.

Общие параметры предназначены для хранения типовых, общих для различных клиентов настроек в едином хранилище.

Информация

При подключении к серверу РТС клиенты автоматически получают копию всех общих параметров со значениями, установленными в настройках сервера.

Диалоговое окно для редактирования общих параметров клиентов открывается нажатием на кнопку 18.

../../_images/1728.png

Блок «Настройки»

В блоке Настройки собраны типовые параметры.

../../_images/1928.png

Название

???

Name

Наименование объекта, на котором эксплуатируется РТС сервер (название шахты, разреза и т.д.)

PovLong

Длинный интервал до следующей поверки когда нужно устанавливать состояние поверки в «скоро».

PovShort

Короткий период до следующей поверки, когда нужно устанавливать состояние поверки в «предупреждение».

DataWindow

Количество переданных архивных данных между синхронизацией операции.

Protocol

Номер версии протокола обмена с клиентами.

Тип

Целое

???

Дробное

???

Строка

???

Значение

???

Справа от активной строки имеются кнопки управления 20, позволяющие перемещать строку вверх/вниз в списке или удалить её из списка.

Предупреждение

При настройке сервера необходимо указать правильные значения для этих общих параметров, для того, чтобы корректно работали соответствующие части ПО.

Если на объекте соответствующие части ПО не используются, то значения для этих параметров использоваться не будут.

Таким образом, наличие и значения этих параметров на объектах, при обновлении ПО, будет играть роль только в том случае, если планируется эксплуатация данного функционала.

Блок «Элемент»

В блоке Элемент осуществляется настройка ???

../../_images/2149.png

Конфигурации#

К группе Конфигурации относятся настройки конфигураций загружаемых на сервер.

../../_images/2226.png

Конфигурации#

../../_images/2617.png

Каталог конфигураций

Наименования каталога на локальном компьютере, в котором сохранены конфигурации.

Каталог выбирается в открывающемся окне после нажатия на кнопку ...

../../_images/2815.png

В окне отражаются каталоги и их содержимое.

Время ожидания подтверждения

Устанавливает время ожидания ???.

Автоматически применять новые конфигурации

Если вкл, то при сохранении новой конфигурации на сервер, утилита автоматически будет использовать данные этой конфигурации. ???

Сравнение конфигураций#

../../_images/2716.png

Создавать лог с различиями данных новых конфигураций

Если вкл, то в папку указанную в поле Каталог будет создаваться файл содержащий различия между прошлой и текущей конфигурациями на сервере. ???

Создавать индивидуальные файлы различий конфигураций

Если вкл, то в папку указанную в поле Каталог будет сохраняться файл для каждого различия между прошлой и текущей конфигурациями. ???

Метрология

В данном разделе выбирается из какого источника будут браться данные метрологии как верные.

Доверять только конфигурации

Метрологические данные будут соответствовать указанным в конфигурации ???

Доверять только источнику

Метрологические данные будут соответствовать указанным в библиотеке метрологии ???

Доверять только обоим вместе

Метрологические данные будут отражены только в том случае если они одинаковые в конфигурации и библиотеке метрологии ???

Данные#

К группе настроек данных относятся настройки хранения и предоставление данных сервером.

../../_images/2324.png

Драйвер БД#

Настройка драйвера базы данных

../../_images/2915.png

Файл, Название, Описание

Текущий используемый драйвер БД.

В настоящее время существуют следующие драйвера БД:

  • dbAccess_BDE.bpl - Драйвер использующий систему BDE для доступа к БД.

  • dbAccess_Null.bpl - Специальный «нулевой» драйвер, который не выполняет никаких действий с БД и предназначен для запуска сервера без сохранения данных в реальную БД.

Новые переменные#

../../_images/3013.png

Кеширование

Кеш новых переменных

Определяет число переменных в кеше.

Время жизни кеша

Определяет продолжительность существования кеша до удаления.

Сохранение в базу данных

Максимальное число сохраняемых переменных

Определяет число переменных сохраняемых в БД.

Общие

Запретить задержку значений при конфликтах метки времени

Если вкл, то ???

Максимальное число задерживаемых значений

Устанавливает максимальное число переменных ???

Сохранять данные о новых переменных в лог

Если вкл, то данные о новых переменных будут сохраняться в лог файл???

Сохранять данные о новых переменных в файл

Если вкл, то данные о новых переменных будут сохранены ???

Генерация переменных#

../../_images/3120.png

Автоматически генерировать переменные

Если вкл, то ???

Генерировать только команды

Если вкл, то ???

Генерировать авто-сохраняемые переменные

Если вкл, то ???

Разрешить генерацию для неподтвержденной конфигурации

Если вкл, то ???

Проверять авто-сохраняемые переменные

???

Разрешить генерацию значений по формулам

Если вкл, то ???

Разрешить генерацию команд

Если вкл, то ???

Клиенты#

К группе Клиента относятся настройки ???

../../_images/2421.png

Подписка#

../../_images/3218.png

Максимальное число элементов ожидающих отправки

Вести файл лога подписки

Если вкл, то ???

Файл лога подписки

Имя лог файла.

Авторизация#

../../_images/3318.png

Разрешить использовать только указанные адреса

Если вкл, то ???

Запрет использования указанных адресов

Если вкл, то ???

Разрешить ручное отключение клиентов

Если вкл, то ???

Скрипты#

К группе Скрипты относятся настройки ???

../../_images/2518.png

Выполнять скрипты

Если вкл, то ???

Стартовый файл

???

Останавливать скрипт при ошибках

Если вкл, то ???

Показывать диалоги скриптов

Если вкл, то ???

Обрабатывать команды генерируемые скриптами

Если вкл, то ???

Обрабатывать значения генерируемые скриптами

Если вкл, то ???

Не запускать сервер при ошибке в скриптах

Если вкл, то ???

Сохранять в лог данные о запуске скриптов

Если вкл, то ???

Лог выполнения скриптов

???

Формат шаблонов БД#

В тексте запросов можно использовать специальные символы, которые будут замещены полями значения или именами.

Используются следующие специальные символы:

%%

символ %

%s

Имя датчика конвертированное так, чтобы соответствовать к требованиям идентификатора БД, т.е. не содержащее запрещенных символов, таких как %, #, пробел и т.д.

%S

Имя датчика в виде текста, указанного в конфигурации.

Имя датчика является строкой, но символами «“» не ограничено.

%v

Используемая версия конфигурации.

Это поле должно быть длинным числом без знака, размерностью 32 бита.

%m

Время измерения.

Строка ограниченная символами «“» с датой с точностью до секунды в формате, установленном в настройках драйвера доступа к БД.

%l

Значение измерения, обработанное сервером. Т.к. сервер подразумевает обработку значений в виде масштабирования, формул и с использованием скриптовых языков то значение этого поля может не совпадать с измеренной датчиком величиной.

Поле должно быть числовым значением с дробной частью формата DOUBLE или decimal(10,3)

%t

Статус измерения.

Т.к. сервер подразумевает авто генерацию переменных, авто инвертирование дискретных значений и использование скриптов, то величина значения может не совпадать с тем, которое было измерено оборудованием.

Поле должно быть целым числом.

%L

Измеренное значение

Величина, которая фактически была измерена датчиком без каких-либо преобразований.

Поле должно быть числовым значением с дробной частью формата DOUBLE или decimal(10,3)

%T

Измеренный статус.

Величина, непосредственно переданная оборудованием без каких либо модификаций.

Поле должно быть целым числом.

%c

Код записи, хранящий информацию о метрологической значимости значения.

ПРИМЕР

Шаблон запроса:

INSERT INTO "VAL_%s" (measure,val,state,rawval,rawstate)
VALUES (%m,%l,%t,%L,%T)

для переменной CH4#12 с параметрами:

  • значение: 12

  • измеренное значение: 11.5

  • статус: 5

  • измеренный статус: 5

  • время измерения: 12-09-2010 12:03

будет преобразован в следующий текст:

INSERT INTO "VAL_CH4_12" (measure,val,state,rawval,rawstate)
VALUES ('12-09-2010 12:03:00',12.0,5,11.5,5)

Работа с конфигурацией#

  • нет

  • подтверждена

  • не подтверждена

Ключи командной строки#

Использование командной строки для передачи данных программе описано в разделе «Ключи командной строки».

Утилита rtVarSrv.exe поддерживает следующие ключи командной строки:

rtVarSrv.exe [ПАРАМЕТРЫ]

-LOG=ФАЙЛ

Устанавливает имя для основного лог файла программы.

Если ключ не указан, то для файла лога будет использовано имя по умолчанию, соответствующее имени программы, с указанием даты создания и расширением log. Этот параметр используется в том случае, если необходимо указать использование лог файла с нестандартным именем или расположенном в не стандартном каталоге. Указывает имя лог файла, который будет использоваться для сохранения отладочной информации о процессе работы программы. Этот параметр может использоваться для организации многопользовательской работы утилиты из одного каталога или для изменения каталога или имени фала, принятого по умолчанию.

-NoLog

Если указан, то лог файл вестись не будет.

-CFG=ФАЙЛ

Если ключ не указан, то для файла конфигурации будет использовано имя по умолчанию, которое, как правило, совпадает с именем программы.

-NAME=ИМЯ

Устанавливает имя для программы.

Установленное имя будет отображаться в заголовке программы и в заголовке окна с сообщениями.

Это имя используется для того, чтобы различить различные копии программы.

Если ключ не указан, то используется имя по умолчанию, совпадающее с именем программы.

-CLOSE

Если указан, то при запуске программа передаст сигнал о завершении предыдущей запущенной копии программы.

После передачи команды на завершение, программа автоматически закроется.

Этот ключ использует имя, установленное с помощью ключа -NAME=ИМЯ для передачи команды определенной копии программы.

Если предыдущая копия запущена, то программа дождется ее завершения. Если предыдущей копии программы не будет обнаружено, то программа сразу же завершится.

-MINIMIZED

Указывает что после запуска программа будет минимизирована. Если программа поддерживает отображение значка в системном лотке и установлен параметр конфигурации «Убирать при минимизации», то программа будет автоматически скрыта в системный лоток.

-NoAccessLog

Не сохранять данные команд в общий файл доступа «access-X.log».

-NoRoot

Запретить учетную запись супер-пользователя.

-MINIMIZED

Указывает что после запуска программа будет минимизирована. Если программа поддерживает отображение значка в системном лотке и установлен параметр конфигурации «Убирать при минимизации», то программа будет автоматически скрыта в системный лоток.

-AUTOSTART

Автоматически запускать утилиту при старте приложения.

-IPPORT=НОМЕР

Использовать указанный номер порта для установки соединения с клиентами.

-CfgPath=ПУТЬ

Использовать указанный каталог для сохранения файлов конфигураций.

-DataPath=ПУТЬ

Использовать указанный каталог для доступа к данным при запросе клиентами файлов данных.

-DATAPUMP

Устанавливает режим работы сервера для получения данных с другого сервера РТС. Использование этого ключа имеет больший приоритет чем соответствующая настройка сервера.

-PUMPLIST=СПИСОК

Устанавливает список серверов источников данных. Использование этого ключа имеет больший приоритет чем соответствующая настройка сервера.

-MaxUnsendSubs=ЧИСЛО

Устанавливает ограничение на максимальное количество ожидающих отправки данных подписки для одного клиента. Если это значение будет превышено, следующие данные будут отброшены.

-SubLog=ФАЙЛ

Включает логирование данных передаваемых по подписке и задает имя файла лога для этих данных. По умолчанию данные лога подписки отключены.

-CHECKPWDFILE=ФАЙЛ

Программа сервера запускается в специальном режиме проверки данных файла авторизации. После проверки файла будет выдано окно с сообщением о результате и программа будет завершена.

-CloseOnStopError

Если задан, то программа сервера будет автоматически завершена, если при ее работе возникнет какая-либо ошибка, делающая невозможным дальнейшую работу. Ранее в подобной ситуации сервер останавливался, что создавало трудности с его автоматическим перезапуском сторонними утилитами, такими как Starter.