Елемент <dump>

Виведення контекстів виключних ситуацій

Елемент <dump> визначає параметри дампу, що створюється під час аварійного завершення програми. Щоб вимкнути запис дампів, в елементі <dump> потрібно встановити для параметра create = "0" або create = "false". Якщо елемент <dump> відсутній, для запису дампів використовуватиметься каталог %USERPROFILE%\Local Settings\Application Data\1C\1Cv8\Dumps (для ОС Windows).

УВАГА!

В ОС Linux налаштування формування дампів виконується засобами ОС. Тому елемент <dump> ігнорується.

Атрибути елемента:

Атрибут location ОС Windows

Ім'я каталогу, у якому формуватимуться файли дампів.

Примітка

В елементах <log>, <dump> і <defaultlog> в атрибутах location слід вказувати різні каталоги.

Атрибут create ОС Windows

Визначає, чи створювати файл дампу.

• 0 (false) – не створювати;
• 1 (true) – створювати.

Атрибут type ОС Windows

Тип дампу, що є довільною комбінацією наведених нижче прапорців у десятковій або шістнадцятковій системі числення (сума значень прапорців). Подання в шістнадцятковій системі має починатися із символу 'x', наприклад, x0002.

Доступні такі значення:

• 0 (x0000) – мінімальний;
• 1 (x0001) – додатковий сегмент даних;
• 2 (x0002) – вміст усієї пам'яті процесу;
• 4 (x0004) – дані хендлів;
• 8 (x0008) – залишити в дампі лише інформацію, необхідну для відновлення стеків викликів;
• 16 (x0010) – якщо стек містить посилання на пам'ять модулів, додати прапорець 64 (0x0040);
• 32 (x0020) – включити в дамп пам'ять з-під вивантажених модулів;
• 64 (0x0040) – включити в дамп пам'ять, на яку є посилання;
• 128 (x0080) – додати в дамп докладну інформацію про файли модулів;
• 256 (0x0100) – додати в дамп локальні дані потоків;
• 512 (0x0200) – включити в дамп пам'ять з усього доступного віртуального адресного простору.

ПОРАДА

Для більшості випадків достатньо встановити для атрибута type значення 3, наприклад, type="3".

Атрибут prntscrn ОС Windows

Визначає, чи створювати файл копії екрана під час аварійного завершення клієнтської частини програми. Ім'я файлу збігається з іменем дампу, але має розширення png. Файли копій екрана створюються в тому самому каталозі, що й дампи (атрибут location).

• 0 (false) – не створювати;
• 1 (true) – створювати.

Під час аварійного завершення програми BAS система відображає діалог з інформацією про процес запису дампу, який автоматично закривається після завершення запису дампу.

Атрибут externaldump ОС Windows

Керує формуванням дампу аварійного завершення роботи, якщо система працює під керуванням ОС Windows. Атрибут може набувати таких значень:

• 0 (false) – дамп формується процесом, який аварійно завершується (значення за замовчуванням).
• 1 (true) – дамп формується зовнішньою програмою dumper.exe, яку включено до комплекту постачання системи. У разі використання зовнішньої програми виключено можливість зависання під час створення дампу.

Якщо зовнішню програму не знайдено або під час її запуску виявлено проблеми, буде використано звичайний режим створення дампів (за допомогою процесу, який аварійно завершується).

Рекомендується використовувати зовнішню програму формування дампів для серверів BAF, які працюють без щодобового обслуговування.

Виведення контекстів виключних ситуацій

Контекстом виключних ситуацій (виключення) є послідовність подій технологічного журналу типу EXCPCNTX. Кожна подія типу EXCPCNTX є однією з тривалих подій, які розпочалися, але не завершилися на момент виникнення нештатної ситуації в роботі програми. Події виводяться за спаданням рівня вкладеності. Тип події, вихідної для події EXCPCNTX, стає значенням властивості SrcName події EXCPCNTX.

Контекст виключення виводиться до технологічного журналу, якщо технологічний журнал увімкнено (у файлі logcfg.xml є хоча б один елемент log) і сталася одна з таких нештатних ситуацій:

• Під час роботи системи сталася виключна ситуація операційної системи, процес (клієнтський або серверний) аварійно завершився, побудовано дамп аварійного завершення.
• Сталася виключна ситуація у базі даних, що призвела до появи повідомлення про помилку та закриття програми BAS.

У разі виникнення будь-якої помилки бази даних до технологічного журналу записується подія типу EXCP, якщо вона відповідає умовам, записаним у конфігураційному файлі технологічного журналу (logcfg.xml).