Данный раздел описывает конфигурационные записи для менеджера SNMP, а также конфигурационные записи для агентов pmon SNMP и «live». Кроме того, происываются внутренние точки данных «_SNMPManager«, «_SNMPAgent» и «_SNMPLive agent«.

Конфигурационные записи для менеджера SNMP

Все конфигурационные записи задаются в [SNMPDrv_<num>] или [SNMPDrv].

Запись	Тип	По умолчанию	Диапазон	Описание
«agentDPName»	string	SNMPAgent	—	Данная запись определяет среднюю часть имен точек данных агента SNMP. Каждое имя состоит из «_Номер_драйвера_Имя_точки_данных_агента_Номер_агента».Точки данных относятся к внутреннему типу «_SNMPAgent».
«agentDPTemplate»	string	«_SNMPAgent»	—	Для инициализации всех элементов точки данных, при запуске драйвера, запрашивается шаблон точки данных. Элементы этой точки данных доступны для всех точек данных. В случае отсутствия элемента шаблона точки данных, элемент недоступен для любых точек данных агента! Шаблоном точки данных, конечно же, может быть обычная точка данных (используемая). В этом случае, значение задается для всего имени точки данных, напр., «_1_SNMPAgent_5».
«ctrlDPName»	string	SNMPManager	—	Данная строка описывает строку, используемую как часть точки данных управления определенного менеджера. Посредством этой точки данных отображаются рабочие состояния драйвера. Имя точки данных также содержит номер драйвера._driverNumber_ctrlDPName
«agentAliveTimeout»	uint	40	—	С помощью данной записи задается интервал циклического контроля соединений (подключений к агентам). (в секундах)Примечание»aliveCheck» осуществляется путем запроса базового адреса MIB.
«agentConnectTimeout»	int	60	—	С помощью данной записи осуществляется контроль подключения к SNMP агенту. Эта запись применима ко всем агентам, которые опрашиваются драйвером. Если это время ожидания истекло (спецификация в секундах) без получения сообщение от агента, в точке данных агента устанавливается бит. Бит удаляется после получения следующего сообщения. Сброс таймера осуществляется после каждого полученного сообщения.
«agentConnectOID»	string	«1.3.6.1.2.1.1.1.0» (system.sysDescr)	—	Перед срабатыванием «ConnectTimeout» для агента, драйвер пытается запросить указанный здесь идентификатор объекта и, следовательно, пытается получить ответ от агента. Значение этого запроса отклоняется. В случае неуспешного запроса начинается время ожидания. Указанный здесь идентификатор объекта действителен для всех агентов драйвера.  Также можно использовать «1.3.6.1.2.1.1.3.0» (system.sysUpTime).
«enableTraps»	string	«Да»	«Yes»|»No»	В случае необходимости получения отводов менеджером SNMP, данная запись должна иметь значение ”Yes”. При отсутствии необходимости получения отводов, значением записи должно быть ”No”. Полученные отводы отображаются в точки данных менеджера.
«delayBetweenAgents»	int	0	>= 0	Задает временной интервал между запросами групп агентов в миллисекундах. Значение по умолчанию 0 означает, что запросы в пределах опрашиваемой группы сортируются и выполняются в этом порядке. В случае установки значения >=0, измененные агенты группируются согласно записи «numberOfAgentsWithDelay» и запрашиваются по истечении указанного временного интервала («delayBetweenAgents»).В случае отсутствия агента, может случиться так, что опрос других агентов не представляется возможным. Если ответ на запрос агента получен с задержкой, все запросы этого агента удаляются (если активирована опция «set to invalid» («определять как неверный»), удаленные запросы определяются как неверные). Это выполняется только при установке конфигурационной записи «delayBetweenAgents». Во время следующего цикла опроса, драйвер осуществляет повторные попытки установления подключения к нему.
«numberOfAgentsWithDelay»	uint	1	0 — 500	Если «delayBetweenAgents» имеет значение => 0, допускается одновременный обмен данными нескольких агентов. Данная конфигурационная запись определяет количество агентов.
«doGQOnStart»	string	«Да»	«Yes»|»No»	Этот параметр определяет возможность опроса всех сконфигурированных объектов SNMP при запуске драйвера. (По умолчанию) Эта опция может стать причиной избирательной перегрузки сети, так как опрашиваются все сконфигурированные объекты. В случае отсутствия необходимости выполнения общего запроса, значением записи должно быть «No». Во избежание слишком большой сетевой нагрузки при использовании «doGQOnStart = ”Yes”, также существует возможность выполнения общих запросов одиночных агентов посредством внутренней точки данных «_Driver<Nr>.GQ:_original.._value». Более подробную информацию см. в разделе Общий запрос.
«ignoreGQTrapErrors»	string	«No»	«Yes»|»No»	Эта конфигурационная запись предупреждает установку неверного бита определенному ЭТД, в случае если выполняется общий запрос идентификаторов объектов, которые существуют только в виде отводов, а не в качестве идентификаторов объектов и которые представляют собой спонтанные адреса.
«mapInvalidData»	string	«Да»	«Yes»|»No»	Если данная конфигурационная запись имеет значение ”Yes”, при потере подключения к соответствующему SNMP агенту, для элементов точки данных задается неверный бит с адресом ввода.
«maxAgents»	uint	255	>= 0	Количество доступных для конфигурирования SNMP агентов. По умолчанию, максимальное количество SNMP агентов равно 255.
«maxNumOfVbsInBulkQuery»	uint	1000	>= 0	Как правило, в последнем адресе SNMP (идентификатор объекта) массового запроса, который отменяет запрос, устройство возвращает «endOfMIBView». Если, по какой-то причине, это не выполняется, драйвер выполняет перезапуск в начале списка и «залипает» в бесконечном цикле. Во избежание этого, запрос отменяется при повторении первого, уже полученного результата. В качестве дополнительных мер безопасности, с помощью данной конфигурационной записи можно установить ограничение количества результатов. В случае достижения указанного количества, запрос отменяется.
«maxTrapsPerSecond»	uint	50	>= 0	Определяет максимальное количество отводов, которые отсылаются за секунду. Если значение равно <=0, в журнал записывается предупреждение. В случае наличия перегрузки, отводы буферизируются. Размер буфера определяется в конфигурационной записи «maxTrapsBufferSize».
«maxTrapsBufferSize»	uint	30000	>= 0	Определяет максимальный размер буфера отводов, отправка которых не представляется возможной из-за перегрузки (ограничивается с помощью «maxTrapsPerSecond»).
«onlyActivePolls»	string	«No»	«Yes»|»No»	Если «onlyActivePolls» имеет заданное значение «Yes», в резервированной системе опрос осуществляет только активный драйвер. «No» означает, что опрос агента осуществляют оба драйвера.
«reportHomelessTraps»	int	0	0|1	Определяет необходимость записи информации о сторонних отводах во внутренню точку данных (см. Trap.HomelessTrap).0 => информация записывается в средство просмотра журналов.1 => информация записывается в средство просмотра журналов и во внутреннюю точку данных.2 => информация записывается в средство просмотра журналов и во внутреннюю точку данных, но только при условии если, как минимум, один пакет идентификатора объекта не соответствует периферийному адресу.
«trapReceptionPort»	int	162	—	Можно задать порт отводов для SNMP драйвера. Порт по умолчанию — это порт 162.
«useExtendedEngineID»	string	«Нет»	«Да»|»Нет»	Определяет возможность расширения внутреннего идентификатора подсистемы агента SNMP информацией о хосте и порте.

Дополнительные конфигурационные записи SNMPv3

Конфигурационные записи указаны в сегментах [SNMPDrv_<num>] или [SNMPDrv]

Запись	Тип	По умолчанию	Диапазон	Описание
«v3entityDPName»	string	«SNMPV3Entity»	—	Данная запись определяет среднюю часть имен точек данных субъекта V3 SNMP.Каждое имя состоит из «_Номер_драйвера_Имя_точки_данных_субъекта_v3_Номер_агента». Номер субъекта, следовательно, автоматически проверяется от 0 до 255. Т.е., каждый новый субъект получает другой номер. Подробное значение субъекта можно описывать в комментариях. Указанные точки данных относятся к внутреннему типу «_SNMPV3Entity».По умолчанию: SNMPV3Entity
«v3entityDPTemplate»	string	«_SNMPV3Entity»	—	Для инициализации всех элементов точки данных, при запуске драйвера, запрашивается шаблон точки данных. После этого, его листья доступны для всех точек данных. В случае отсутствия этого элемента шаблона точки данных, элемент недоступен для любых зарегистрированных точек данных агента! В качестве шаблона точки данных можно также применять «обычную» используемую точку данных. В этом случае, значение задается для всего имени точки данных, напр., «_1_SNMPV3Entity_5».По умолчанию: «_SNMPV3Entity».
«setTimeoutOnV3USMerrors»	string	«No»	«Yes»|»No»	Если «setTimeoutOnV3USMerrors = yes» и при установленном времени ожидания состояния для агента SNMPv3, USM ошибка влияет на состояние времени ожидания.»yes» — в случае USM ошибки, ЭТД «Status.Timeout» имеет значение «ИСТИНА».»no» — ЭТД «Status.Timeout» никогда не имеет значения «ИСТИНА» при возникновении USM ошибки.
«snmpDir»	string	«/<каталог_проекта>/data»	—	Для SNMPv3, субъект SNMP требует наличия счетчика самозагрузки. Он находится в файле «snmpv3_boot_counter».По умолчанию, драйвер SNMP осуществляет запись этого файла в каталог «/data» из каталога проекта. В случае если пользователь не обладает полномочиями записи в данный каталог, с помощью этой записи можно задать другой каталог.

Конфигурационные записи для агента «Live» SNMP

Все конфигурационные записи задаются в [snmpa].

Запись	Тип	По умолчанию	Диапазон	Описание
«commandUserByte»	uint	0	0,1-4	Определяет то, при каком условии и какой пользовательский байт задается для соответствующего результат записи. Выбранный байт информации записывается в первый байт ЭТД «Status.WriteResponse«.0 => Пользовательский байт не задан1-4 => Соответствующий пользовательский байт задан значениями результатов записи.
«enableUserTraps»	string	Да	«Yes»|»No»	В случае активации этой опции, собственные тексты можно отсылать в виде отводов посредством точки данных агента «Live». Как уже упоминалось, Pmon агент требуется в качестве прокси.
«PmonPortNr»	int	4700	1  —  65535	Определяет номер порта Pmon. Это необходимо, поскольку Pmon выполняет роль прокси для агента «Live».
«snmpDir»	string	«<каталог_проекта>/data»	—	Для SNMPv3, субъект SNMP требует наличия счетчика самозагрузки. Он находится в файле «snmpv3_boot_counter».По умолчанию, агент «Live» SNMP осуществляет запись этого файла в каталог «/data» каталога проекта. В случае если пользователь не обладает полномочиями записи в данный каталог, с помощью этой записи можно задать другой каталог.
«SNMPPortNr»	int	4701	1  —  65535	Определяет номер порта агента «Live».
«v1ReadCommunity»	string	”Общедоступно”	—	Определяет «ReadCommunity» для SNMP v1/v2. Используется только для агентов, которые подключаются к системе «КАСКАД Цифра».
«v1WriteCommunity»	string	”Администратор”	—	Определяет «WriteCommunity» для SNMP v1/v2. Используется только для агентов, которые подключаются к системе «КАСКАД Цифра».

Конфигурационные записи для Pmon

Все конфигурационные записи задаются в [pmon]:

Запись	Тип	По умолчанию	Диапазон	Описание
«SNMPPortNr»	int	4700	1  —  65535	Номер порта, для которого включена «Pmon» для выполнения SNMP запросов.
«sendManagerStateChange»	string	Нет	«Yes»|»No»	В случае необходимости отправки отвода при изменении состояния менеджера, необходимо установить значение ”Yes” параметра.
«allowSNMP»	string	Нет	«Yes»|»No»	Определяет необходимость для «WCCILpmon» открытия порта SNMP и, следовательно, реакции на запросы SNMP.
«v1ReadCommunity»	string	”Общедоступно”	—	Определяет «ReadCommunity» для SNMP v1/v2. Используется только для агентов, которые подключаются к системе «КАСКАД Цифра».
«v1WriteCommunity»	string	””	—	Определяет «WriteCommunity» для SNMP v1/v2. Используется только для агентов, которые подключаются к системе «КАСКАД Цифра».
«LAProxyPortNr»	int	4701	1  —  65535	Определяет номер порта агента «Live». «Pmon» служит в качестве прокси для агента «Live».
«snmpDir»	string	«<каталог_проекта>/data»	—	Для SNMPv3, субъект SNMP требует наличия счетчика самозагрузки. Он находится в файле «snmpv3_boot_counter».По умолчанию, «Pmon» осуществляет запись этого файла в каталог «/data» каталога проекта. В случае если пользователь не обладает полномочиями записи в данный каталог, с помощью этой записи можно задать другой каталог.
«v1TrapTarget»	string	«»	—	Определяет IP-адрес/номер порта, на который направляются отводы.Напр., v1TrapTarget = «192.168.150.29/162″Эту запись можно задавать произвольное количество раз (отдельная запись для каждой «TrapTarget»). Все указанные здесь целевые объекты получают отводы.
«restartProjVA»	string	«No»	«Yes»|»No»	В случае сбоя менеджера архивирования значений осуществляется перезапуск проекта (в резервированной системе).
«allowSNMPCommands»	string	«No»	«Yes»|»No»	Определяет возможность изменения записей MIB с помощью SNMP. Также см. MIB.
«aliveSeconds»	int	30	> 0	В течении указанного в секундах времени менеджер, контролируемый «pmon», должен увеличивать значение своего счетчика активности (т.е., менеджер должен подать «признаки жизни»), в противном случае «pmon» признает этот менеджер «заблокированным» и инициирует запуск внешнего сценария («crashAction»).
«delayStartSeconds»	int	0	>= 0	Устанавливает задержку запуска «Pmon» на указанный период времени в секундах. На протяжении времени ожидания «Pmon» запуска, выполнение действий в консоли не осуществляется.
«restartDelaySeconds»	int	0	>= 0	Если перезапуск менеджера происходит слишком быстро, следующий запуск будет иметь задержку на протяжении указанного количества секунд. Значение по умолчанию 0 свидетельствует о том, что перезапуск менеджера не будет больше выполняться. Если значение конфигурационной записи > 0, сценарий «crashAction» запускается с типом «DELAYING_RESTART», вместо «NO_RESTART_ANYMORE».

Внутренние точки данных

Тип точки данных «_SNMPManager»

Data point	Описание
«_SNMPManager»	Тип точки данных управления для менеджера SNMP (= драйвер SNMP). Имя точки данных состоит из номера драйвера и имени, указанного в файле конфигурации. Как правило, это «_1_SNMPManager». Элементы этой точки данных служат для обмена данными с уровнем драйвера SNMP, а также для предоставления информации о состоянии драйвера.

Элементы «_SNMPManager»

Элемент	Тип	Описание
Команда	string	С помощью этого элемента можно осуществлять отправку команд на уровень драйвера. Данный элемет необходим для выполнения тестирования.
«Trap.EnterpriseOID»	string	Отображает детальную информацию о последнем (полученном) отводе SNMP. Идентификатор объекта содержит информацию об агенте, который отослал отвод.
«Trap.IPAddress»	string	Поле IP-адреса содержит IP-адрес агента, отправившего отвод.
«Trap.genericTrap»	string	Это поле отображает информацию о времени отправки так называемого «общего отвода». Существуют следующие варианты:»Coldstart»»Warmstart»»LinkUp»»LinkDown»»AuthenticationFailure»»EgpNeighborLoss»Для получения информации об их значениях, см. RFC 3418 (SNMP v2)
«Trap.specificTrap»	string	В случае отсутствия отправленного стандартного отвода, это поле содержит значение последнего элемента идентификатора объекта отвода.
«Trap.timestamp»	uInt	Временная метка определяет время отправки отвода (время выполнения агента согласно «system.sysUpTime»)
«Trap.PayloadOID»	dyn_string	Отвод SNMP может содержать дополнительные элементы SNMP. Элементы отображают детальную информацию об отводе. Эти элементы зависят от того или иного отвода и всегда отсылаются в виде «OIDPair <-> значение». Поле «PayloadOID» содержит идентификатор объекта.
«Trap.PayloadValue»	dyn_string	Данный элемент содержит значения элементов пакета.
«Trap.HomelessTrap»	string	Этот элемент содержит информацию относительно сторонних отводов.Сообщение сохраняется в следующем формате:<Имя агента>|<Идентификатор_агента>|<Тип точки данных SNMP в виде строки (тип данных SNMP в виде целочисленного значения)>|<Идентификатор_объекта>|<IP-адрес агента> ПримерЕсли агент, который должен отсылать отвод, не сконфигурирован, в точке данных устанавливается следующее сообщение: ?|?|INT32 (2)|1.3.6.1.4.1.8691.10.2242.11.6|192.168.152.25 A trap has been received from the divice A trap has been received from a device at IP 192.168.152.25. («?|?|INT32 (2)|1.3.6.1.4.1.8691.10.2242.11.6|192.168.152.25 Получен отвод от устройства. Отвод получен от устройства с IP-адресом 192.168.152.25. Неизвестные поля для <Имя агента> и <Идентификатор_агента> отображают «?» «).Если агент сконфигурирован, но идентификатор объекта неизвестен, в точке данных устанавливается следующее сообщение: «_1_SNMPAgent_6|6|INT32 (2)|1.3.6.1.4.1.12148.9.1.10.0|192.168.152.18 A trap has been received from agent _1_SNMPAgent_6 at IP 192.168.152.18 but the OID 1.3.6.1.4.1.12148.9.1.10.0 is not known inside the «КАСКАД Цифра» System» («_1_SNMPAgent_6|6|INT32 (2)|1.3.6.1.4.1.12148.9.1.10.0|192.168.152.18 Получен отвод от агента _1_SNMPAgent_6 по IP-адресу 192.168.152.18, но идентификатор объекта 1.3.6.1.4.1.12148.9.1.10.0 неизвестен для системы «КАСКАД Цифра»»)
«Redirector»	uInt	Устаревшая.
«TrapFilter.Address»	dyn_string	Адресат отводов может фильтровать отводы по адресам отправителей. Эта фильтрация возможна с помощью элемента «TrapFilter.Address».
«TrapFilter.OID»	dyn_string	Фильтр отводов может также анализировать «EnterpriseOID» отводов и реагировать только на определенные отводы. Таким образом, отводы можно распределять для нескольких менеджеров SNMP.

Тип точки данных «_SNMPAgent»

Data point

Описание

«_SNMPAgent»

Тип точки данных агента SNMP отображает конфигурацию агента. Имена точек данных состоят из номера драйвера, строки из файла конфигурации и номера агента. Номер агента — это произвольно выбираемый номер от 1 до «maxAgents«. Как правило, точка данных имеет имя, напр., «_1_SNMPAgent_5». Крмое того, должна существовать точка данных с описанием «_SNMPAgent». В случае ее отсутствия, необходимо изменить конфигурационную запись «agentDPTemplate«.

Элементы «_SNMPAgent»

Элемент	Тип	Описание
«Access.IPAddress»	string	IP-адрес субъекта. В случае отсутствия здесь заданного IP-адреса или же в случае если он был удален (пустая строка), субъект автоматически отключается, а внутренний ЭТД «Status.Timeout» имеет заданное значение «ЛОЖЬ» независимо от состояния, в котором он был до этого.
«Access.ReadCommunity»	string	Строка сообщества SNMP на считывание.
«Access.WriteCommunity»	string	Строка сообщества SNMP на запись.
«Access.Timeout»	uInt	Время ожидания сообщений SNMP в 1/100 секунд. Т.е., ответ на сообщение должен быть отослан до завершения периода ожидания. Значение по умолчанию — 1 сек. Возможно, понадобится увеличение времени ожидания, в случае наличия низкоскоростных сетей / агентов. Допустимые значения: 1 — 100 сек.
«Access.Retries»	uInt	Повторные попытки до отображения ошибки протокола SNMP. Значение по умолчанию — 1. Максимальное количество задаваемых повторных попыток — 10.
«Access.Protocol»	uInt	Протокол SNMP. 0,1 означает «v1», а 2 означает «v2c». По умолчанию — «v1».
«Access.Port»	uInt	Номер порта, который следует использовать для обмена данными с агентом. Порт SNMP по умолчанию — 161. Тем не менее, можно указать любой другой порт.
«Status.ErrorOID»	dyn_string	В случае возникновения ошибки протокола, эта точка данных отображает соответствующий идентификатор объекта. Так как элемент относится к «dynText», отображаются все текущие недоступные идентификаторы объектов. Кроме того, соответствующим образом устанавливаются неверные биты элементов «КАСКАД Цифра». Формат:»Код-ошибки#Идентификатор_объекта — ОШИБКА: Текст_ошибки» Возможные коды ошибок: // Ошибки идентификатора объекта2 //!< указанное имя VB отсутствует, см. индекс ошибок3 //!< Неверный Vb6 //!< Нет доступа к данным информационных баз управления7 //!< Запрашиваемый тип ошибочен8 //!< Запрос PDU имеет неверную длину9 //!< Запрос PDU имеет неверную кодировку10 //!< Запрос PDU имеет неверное значение11 //!< Невозможно создать указанный объект12 //!< Несовместимое значение в запросе13 //!< Ресурсы недоступны14 //!< Невозможно завершить15 //!< Возврат невозможен16 //!< Ошибка установления полномочий17 //!< Объект Mib недоступен для записи18 //!< Используется несовместимое имя // Ошибки протокола-5 //!< Истекло время ожидания ожидающего запроса-8 //!< snmp::поврежден, имеются ожидающие запросы // Ошибки транспортировки-20 //!< транспортировка не поддерживается-21 //!< выполняется транспортировка-22 //!< отказ процесса транспортировки-23 //!< отсутствуют права на транспортировку В случае установки флага отладки 29, сообщения об ошибках также отображаются в средстве просмотра журналов «КАСКАД Цифра».
«Status.QueueLength»	uInt	Этот элемент отображает текущую длину очереди запросов агента. Данное значение обновляется только при условии возникновения ошибки протокола. Значение отображается для диагностических целей и не имеет значения для выполняемой операции.
«Status.Timeout»	bool	Этот бит устанавливается в случае отсутствия обмена сообщениями с агентом на протяжении указанного периода времени (сконфигурировано с помощью конфигурационной записи «agentConnectTimeout»). В случае отсутствия заданного IP-адреса в ЭТД «Access.IPAddress» или же в случае если он был удален (пустая строка), установленное значение этого бита — «ЛОЖЬ», независимо от его текущего состояния.
«Status.ConnState»	bool	ЭТД отображает состояние подключения агента SNMPК каждому агенту, сконфигурированному для менеджера SNMP, применяется следующее:При запуске менеджера, значение «Status. ConnState» — «ЛОЖЬ».Конфигурирование первого периферийного адреса для агента инициирует запуск проверки присутствия в сети, установленное значение ЭТД истинно при наличии сконфигурированного агента. После этого, значение обновляется после каждого выполнения проверки присутствия сети.Для инициирования запуска первой проверки, необходимо установить активность адреса.ПримечаниеКонфигурирование прочих периферийных адресов не инициирует запуск проверки присутствия в сети.
«Status.WriteResponse»	string	Элемент точки данных содержит ответ на попытку записи агентом SNMP. Сохраняется следующая информация:<Код ошибки>#<Внутренний идентификатор агента>_<Идентификатор объекта> [ -ошибка <описание ошибки>],Пример успешной процедуры записи:0#1_1.3.6.1.4.1.8691.10.2242.10.1.1.4.11 Пример ошибки процедуры записи: -5#1_1.3.6.1.4.1.8691.10.2242.10.1.1.4.11 — error: SNMP++: SNMP request timed out («-5#1_1.3.6.1.4.1.8691.10.2242.10.1.1.4.11 — ошибка: SNMP++: истечение времени ожидания запроса SNMP») Соответствующие коды ошибок можно найти в описании ЭТД «Status.ErrorOID«.
«Redundancy.ReduAgent»	uInt	Менеджер SNMP может напрямую запрашивать данные у агента горячего резерва, в случае если основной агент недоступен. Здесь следует указывать номер сконфигурированного агента. Если значение равно 0 (по умолчанию), опция неактивна.»ReduAgent», на данный момент, не поддерживаются (и, следовательно, этот ЭТД)!
«Redundancy.FallBack»	uInt	Этот элемент определяет количество запросов к «ReduAgent», после которых опрашивается основной агент. Значение может находиться в диапазоне от 0 до 100. Значение по умолчанию — 0.»ReduAgent», на данный момент, не поддерживаются (и, следовательно, этот ЭТД)!
«Redundancy.DataFromRedu»	bool	Этот бит определяет необходимость выполнения запросов данных менеджером SNMP от сконфигурированного «ReduAgent», а не от основного агента.»ReduAgent», на данный момент, не поддерживаются (и, следовательно, этот ЭТД)!
Команда	uInt	С помощью этого элемента можно осуществлять отправку двух команд локальному агенту:»Clearerror» (1) удаляет точку данных «ErrorOID», а также все внутренние ошибки.»Checkerror» (2) обновляет точку данных «ErrorOID» и элемент «QueueLength».
«Browse.Start»	string	Определяет стартовый идентификатор объекта запроса всех данных агента. Они записываются в ЭТД «Browse.Result».В случае если этот ЭТД пустой, запрос начинается стартовым идентификатором объекта «1.3.6.1».
«Browse.Result»	dyn_string	Содержит результат запроса, который был запущен с помощью ЭТД «Browse.Start». Во время просмотра, значение этого ЭТД: «1 — started browsing» («1 — начат просмотр»).Непосредственно после завершения просмотра, результаты содержат данные агента. Набор данных всегда состоит из трех строк:1-я строка: Идентификатор объекта2-я строка: Значение в преобразовании по умолчанию3-я строка: Тип данных — в виде числа#тип данных — в виде текста Пример с двумя наборами данных:1.3.6.1.2.1.1.1.0Аппаратное обеспечение: x86, серия 6, модель 15, степпинг 8. СОВМЕСТИМОСТЬ С ПК ТИПА АТ4#OCTETS1.3.6.1.2.1.1.3.00:00:26.6067#TIMETICKS Возможные значения типа данных:2 — INT323 — BITS4 — OCTETS6 — OID64 — IPADDR65 — CNTR3266 — UINT3267 — TIMETICKS68 — OPAQUE70 — CNTR64В случае если результат не содержит количество записей, которое можно делить на 3, формируется сообщение о состоянии. В этом случае, первая строка отображает код состояния:1 — запуск запроса-1 — ошибкаКод ошибки и описание содержатся во второй строке.Например:-1-5#SNMP++: SNMP request timed out («-5#SNMP++: истечение времени ожидания запроса SNMP»)

Тип точки данных SNMPLiveAgent

Data point	Описание
«_SNMPLiveAgent»	Содержит элементы ЭТД «КАСКАД Цифра», запрос которых можно выполнять с помощью SNMP.

Элементы «_SNMPLiveAgent»

Элемент	Тип	Описание
Команда	string	Этот элемент можно задавать с помощью SNMP. Если объект MIB 1.3.6.1.4.1.13828.2.1.12 описан в тексте, этот текст отображается в ЭТД. Таким образом, сценарий CTRL может связываться с этим ЭТД и отключаться при изменении значения.
«Response»	string	Этот элемент отображается с помощью объекта MIB 1.3.6.1.4.1.13828.2.1.13. Вышеупомянутый сценарий CTRL может демонстрировать результат при помощи этого элемента. Результат доступен в SNMP.
«SpecificTrap»	string	Если занчение записывается и сохраняется в этом элементе, значение отсылается в качестве «UserTrap» из агента «Live», посредством «PmonProxyAgent», всем сконфигурированным «TrapTargets». Это выполняется если «UserTraps» активированы в файле конфигурации.
«DPTableElements»	dyn_string	Этот элемент содержит ЭТД и их индексы, которые можно запрашивать с помощью SNMP.

Тип точки данных «_SNMPV3Entity»

Элемент	Тип	Описание
«Access.IPAddress»	string	IP-адрес субъекта. В случае отсутствия здесь заданного IP-адреса или же в случае если он был удален (пустая строка), субъект автоматически отключается, а внутренний ЭТД «Status.Timeout» имеет заданное значение «ЛОЖЬ» независимо от состояния, в котором он был до этого.
«Access.Timeout»	uint	Время ожидания в 1/100 секунд. Т.е., ответ на сообщение должен быть отослан до завершения периода ожидания. Значение по умолчанию — 1 сек. Возможно, понадобится увеличение времени ожидания, в случае наличия низкоскоростных сетей / агентов. Допустимые значения: 1 — 10 сек.
«Access.Retries»	uint	Повторные попытки до отображения ошибки протокола SNMP. В случае истечения времени ожидания, телеграмма повторяется. Значение по умолчанию — 1. Максимальное количество задаваемых повторных попыток — 10.
«Access.Port»	uint	Номер порта, который используется для обмена данными с агентом. Порт SNMP по умолчанию — 161. Тем не менее, можно использовать любой произвольный порт.
«Access.SecurityName»	string	«SecurityName» описывает пользователя/программу, которая требует наличия доступа к данным.
«Access.SecurityLevel»	Беззнаковое	Уровень безопасности описывает меры безопасности, которые необходимо применять для обмена данными.noAuthNoPriv (1) Без аутентификации и шифрованияauthNoPriv (2) Аутентификация, но без шифрованияauthPriv (3) Аутентификация и шифрованиеЗначение по умолчанию — (1).
«Access.AuthProtocol»	Беззнаковое	Существуют два протокола аутентификации пользователей SNMP:Отсутствует (1) — Без протокола аутентификацииHMAC_MD5 (2) — Аутентификация MD5HMAC_SHA (3) — Аутентификация SHAЗначение по умолчанию — (1).
«Access.AuthPasswd»	string	Пароль, который используется для авторизации.
«Access.PrivProtocol» (беззнаковое)	Беззнаковое	Для повышения уровня безопасности, отправленные данные также могут шифроваться.  Для шифрования следует выбрать протокол.Отсутствует (1) — Без шифрованияDES (2) — Шифрование DES (Data Encryption Standard — стандарт шифрования данных)Значение по умолчанию — 1.
«Access.PrivPasswd»	string	Пароль, используемый для шифрования.
«Access.ContextName»	string	Обращается к контекстному имени в целевом компьютере. Контекст включает в себя специальные объекты MIB.Для одного агента можно задавать только одно контекстное имя. В случае необходимости выполнения запросов нескольких контекстных диапазонов одного агента, необходимо создать несколько точек данных.
«Access.ContextEngineID»	string	Идентификатор подсистемы целевого компьютера. В случае отсутствия заданного идентификатора, он определяется при запросе данных.
«Status.ErrorOID»	dyn_string	В случае возникновения ошибки протокола, с помощью этой точки данных отображается соответствующий идентификатор объекта. Так как данный элемент относится к «dynText», всегда отображаются все текущие и недоступные идентификаторы объектов. Кроме того, устанавливаются соответствующие неверные биты элементов «КАСКАД Цифра». В случае возникновения ошибки USM SNMPv3, она также записывается в данный ЭТД.
«Status.QueueLength»	uint	Отображает текущую длину очереди запросов агента. Данное значение обновляется при условии возникновения ошибки протокола. Значение отображается для диагностических целей и не имеет значения для выполняемой операции.
«Status.Timeout»	bool	Этот бит устанавливается в случае отсутствия обмена сообщениями с субъектов на протяжении указанного периода времени (сконфигурировано с помощью конфигурационной записи «agentConnectTimeout»). В случае отсутствия заданного IP-адреса в ЭТД «Access.IPAddress» или же в случае если он был удален (пустая строка), установленное значение этого бита — «ЛОЖЬ», независимо от его текущего состояния.
«Notify.ID»	Беззнаковое	Последнее число OID (идентификатор объекта). Этот номер прибавляется к уведомлению идентификатора объекта, указанного в MIB системы «КАСКАД Цифра». В случае изменения этого ЭТД, менеджер SNMP отсылает отвод в соответствующий субъект SNMP V3. «-dbg 26» можно использовать для получения информации об отладке при отправке отвода.
«Notify.Text»	string	Здесь указывается текст отвода. В случае если этот элемент содержит текст, этот текст отсылается в случае изменения «Notify.Id».
«Browse.Start»	string	Определяет стартовый идентификатор объекта запроса всех данных агента. Они записываются в ЭТД «Browse.Result».В случае если этот ЭТД пустой, запрос начинается стартовым идентификатором объекта «1.3.6.1».
«Browse.Result»	dyn_string	Содержит результат запроса, который был запущен с помощью ЭТД «Browse.Start». Во время просмотра, значение этого ЭТД: «1 — started browsing» («1 — начат просмотр»).Непосредственно после завершения просмотра, результаты содержат данные агента. Набор данных всегда состоит из трех строк:1-я строка: Идентификатор объекта2-я строка: Значение в преобразовании по умолчанию3-я строка: Тип данных — в виде числа#тип данных — в виде текста Пример с двумя наборами данных:1.3.6.1.2.1.1.1.0Аппаратное обеспечение: x86, серия 6, модель 15, степпинг 8. СОВМЕСТИМОСТЬ С ПК ТИПА АТ4#OCTETS1.3.6.1.2.1.1.3.00:00:26.6067#TIMETICKS Возможные значения типа данных:2 — INT323 — BITS4 — OCTETS6 — OID64 — IPADDR65 — CNTR3266 — UINT3267 — TIMETICKS68 — OPAQUE70 — CNTR64В случае если результат не содержит количество записей, которое можно делить на 3, формируется сообщение о состоянии. В этом случае, первая строка отображает код состояния:1 — запуск запроса-1 — ошибкаКод ошибки и описание содержатся во второй строке.Например:-1-5#SNMP++: SNMP request timed out («-5#SNMP++: истечение времени ожидания запроса SNMP»)