Отладка в jWB 3.2.1

Обзор

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

Следуя шаг за шагом вниз, вы также имеете возможность отладки подпрограмм, (написанных) в jWB 3.2.1 - вам доступен тотальный контроль над всем, что описано на стороне сервера. Эта публикация служит не для того, чтобы рассказать вам, как использовать отладчик - она в большей мере представляет вам jWB и jShell так, чтобы ваше нахождение в отладчике стало "модным".

Предварительные требования:

Убедитесь, что ваша общесистемная переменная окружения (environment variable) JEDIFILEPATH содержит значение "точка" - "." Сделайте нужные добавления. Например, это может выглядеть так

Проверьте это, выполнив следующие действия
  A) Правый щелчок (right click) на "My computer"
  B) Выберите "Properties"
  C) Выберите "Advanced"
  D) Выберите "Environment Variables"
  E) В окне "system variables"
Если переменная "JEDIFILEPATH" не определена,
  a. Щелкните "New"
  b. В поле "Variable Name" введите "JEDIFILEPATH"
  c. В поле "Variable Value" введите ".;jbase30"
Если переменная "JEDIFILEPATH" определена,
  a. Выберите ее и щелкните "Edit".
  b. Модифицируйте "Variable Value", чтобы включить ".".
(как вы помните, точка с запятой разделяет значения)

Пробежим по Основным Шагам - Main Steps

1) Импортируйте в вашу систему отладочную модификацию (debug patch) или служебный выпуск (service release)
2) Поместите инструкцию "DEBUG" в вашу процедуру pre page, либо в процедуру, которую вы намерены отлаживать
3) Выполните запись и компиляцию - "Update and Catalog" процедуры
4) Выполните рестарт очередей jWB
5) Запустите сеанс jShell
6) Сделайте изменение для перехода в каталог вашего бюджета (account directory)
7) Выполните "jsh.cmd" - файл настройки переменных окружения (environment settings file)
8) Выполните "sysdebug <queue name>"
9) Перейдите в окно сеанса jWB
10) Выберите страницу, которую намерены отлаживать
11) Выполните предварительный отладочный просмотр "Debug Preview" страницы, которую намерены отлаживать (обычно это страница с процедурой pre page)
12) Введите имя очереди (queue name), которую будете отлаживать (как в пункте 8)
13) Вернитесь назад к jShell, и вы увидите, что выполнение Subroutine приостановлено на том месте, где помещена ваша инструкция "DEBUG".

Главные Шаги - Main Steps

1) Убедитесь, что у вас имеется следующий файл "Import"

Patch : patch321.002
или
Service Release : sr321.001

и что он импортирован в ваш бюджет - jWB account. Для проверки выполните следующее:

  1.1) В среде разработки jwb development environment выберите
"Application Administration"
  1.2) выберите "Imports"
  1.3) Если какой-либо из двух показанных вы выше файлов виден в
окне справа, то перейдите к пункту 2.
  1.4) Если нет, то выберите кнопку "Import File".
  1.5) Введите маршрут (path) и имя файла для отладочного добавления
patch или служжеьного выпуска - service release
  1.6) Нажмите "OK"

ЗАМЕЧАНИЕ. Курсор изменится и примет вид "песочных часов" на тот период, пока файл импортируется в среду jWB. Иногда jWB может войти в "Timeout" - в этом случае достаточно лишь нажать клавишу "F5" для освежения экрана. Теперь импортированные компоненты будут видны в "Application Administration>Imports"

2) Откройте подпрограмму, которую вы желаете отлаживать в среде jWB и введите слово "DEBUG" на пустой строке (обычно бывает лучше, если это достаточно близко к началу подпрограммы)

3) В окне редактора выберите кнопку "Update and Compile"

4) Выберите "Restart Queues" в среде разработчика jWB

5) Вызовите jShell. (в окнах перейдите к "Start>Programs>jBASE 3.0>jShell")

6) Смените директорию (команда CD) на каталог вашего бюджета jWB. Если вы его не помните, сделайте следующее:

  6.1) Запустите Internet Explorer и перейдите к
http://"machine_name"/scripts/wbadmin.dll
  6.2) войдите и выберите "Account Administration"
  6.3) Найдите имя вашего бюджета jWB "Account Name"

7) В оболочке jShell после того, как сделаны изменения для каталога вашего бюджета, введите "jsh.cmd" и нажмите "return". Ваше окружение будет синхронизировано с вашим сеансом jWB.

8) Введите "sysdebug fred". (здесь fred - имя отладочной очереди debug queue. Это может быть любое имя, но оно должно совпадать с именем в шаге 12). Вы увидите следующее

9) Перейдите в окно вашего сеанса -jWB session window.

10) Откройте страницу jWB, которую собрались отлаживать, сделав следующее

  10.1) Выберите "Development objects"
  10.2) Выберите Модуль - Module для отладки
  10.3) Выберите "HTML Page" в ниспадающем меню (drop down menu)
  10.1) Щелкните на кнопке после страницы, имеющей инструкцию debug в процедуре pre page

11) Нажмите кнопку "Debug Preview" в верхней части страницы

12) Система предложит ввести имя очереди. Введите "fred" (или то имя очереди, которое вы задали в шаге 8) и нажмите "OK"

13) Когда jWB попытается выполнить вашу подпрограмму, он остановится на том месте, где обнаружит строку "DEBUG". Теперь вы можете перейти в окно jShell, где увидите следующее:

Теперь вы можете использовать команды отладчика для пошагового продвижения и просмотра вашего кода строка за строкой.

Итоги

Теперь вы владеете функциональными возможностями отладчика в jWB, так что можете детально, шаг за шагом отслеживать выполнение ваших подпрограмм BASIC/Web Builder.