IBM Developer Workbench Версия 9.1.0.2 - Замечания по выпуску

Оглавление

1.0 Об этом выпуске

Developer Workbench Версии 9.1.0.2 содержит усовершенствования и исправления выпуска версии 9.1.

Назад к оглавлению.

1.1 Новое в этом выпуске

Developer Workbench Версии 9.1.0.2 поддерживает следующие новые возможности:

• Поддержка DB2 for z/OS Версии 9:
  • В проводнике баз данных можно создать соединение JDBC с DB2 for z/OS Версии 9.
  • Эта инструментальная среда позволяет в проекте разработки данных создавать, тестировать и внедрять следующие типы подпрограмм для работы с DB2 for z/OS Версии 9:
    • Собственные хранимые процедуры SQL (в том числе собственные хранимые процедуры с несколькими версиями)
    • Внешние хранимые процедуры SQL
    • Хранимые процедуры Java (JDBC и SQLJ)
    • Скалярные пользовательские функции SQL
  • Эту инструментальную среду можно использовать для разработки хранимых процедур Java для работы с DB2 for z/OS Версии 9, зависящих от классов в других файлах JAR (не совпадающих с файлом JAR, в котором внедрена эта хранимая процедура). Можно импортировать файл JAR в проект разработки данных, чтобы для хранимой процедуры Java этого типа можно было выполнить компиляцию и создать пакет в локальной системе. В инструментальной среде можно также внедрить файл JAR на сервер баз данных, отбросить файл JAR с сервера или просмотреть свойства внедренных файлов JAR из проводника баз данных.
  • Для отладки хранимых процедур для DB2 for z/OS Версии 9 можно использовать встроенный в инструментальную среду отладчик хранимых процедур.
• Переведенный текст документации и пользовательского интерфейса для пользовательских функций OLE DB и XML. Информацию о некоторых необходимых предварительных действиях для создания пользовательских функций OLE DB и XML смотрите в разделе Исправления документации этих Замечаний по выпуску.
• Поддержка расширения .db2 для файлов, содержащих операторы SQL и сценарии. Кроме файлов с расширениями .sql и .ddl можно редактировать и импортировать файлы SQL с расширением .db2.
• Поддержка создания одного пакета для хранимых процедур SQLJ. Чтобы создать один пакет, задайте уровень изоляции в поле Опции связывания в мастере по внедрению подпрограмм.
• Поддержка для сохранения подпрограмм с ошибками. Если вы сохраняете в редакторе подпрограмм подпрограмму, содержащую ошибки, выводится сообщение о том, что в исходном коде есть ошибки, но вы можете сохранить этот исходный код с ошибками и не потерять результаты своей работы.

Назад к оглавлению.

1.2 История исправлений продукта

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

• Перед удалением проекта закройте открытые подпрограммы и редакторы SQL, относящиеся к этому проекту. Если не закрыть открытые подпрограммы и редакторы SQL, проект и его содержимое все равно будут удалены, но вы увидите сообщения об ошибках.
• При отладке хранимой процедуры Java, вызывающей вторую хранимую процедуру Java, вы не можете отлаживать эту вторую хранимую процедуру. Вы не можете войти во вложенную хранимую процедуру и все точки прерывания, заданные во вложенной процедуре, будут проигнорированы. Это ограничение для DB2 UDB для Linux, UNIX и Windows.

1.3 Известные ограничения и проблемы

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

• Общие
• Разработка подпрограмм
• Отладчик хранимых процедур

Общие

• Чтобы запустить Developer Workbench в Red Hat Enterprise Linux 3, добавьте export MOZILLA_FIVE_HOME=<положение mozilla> в /opt/IBM/DWB/V9.1/dwb_prod/shortcut_dwb.
• Если вы определили таблицу с данными XML, но не задали первичный ключ, попытка изменить в редакторе таблиц данные столбца XML завершится неудачно. Для таблицы с данными XML необходимо добавить первичный ключ или индекс уникальности.
• Разработка XQuery в построителе XQuery поддерживается только в проектах разработки данных, связанных с соединениями с DB2 для Linux, UNIX и Windows Версии 9.
• После создания в проводнике баз данных сервера объединения этот сервер не выводится автоматически в папке Определенный сервер. Чтобы увидеть новый сервер, нужно обновить данные для папки.
• Если в Linux в качестве JDK по умолчанию используется JDK 1.4.1, процессы Developer Workbench могут не закрываться при выходе из Developer Workbench. Чтобы избежать этой проблемы, используйте JDK, поставляемый с Developer Workbench: /opt/IBM/DWB/V9.1/dwb_prod/eclipse/jdk/bin.

Разработка подпрограмм

• Пользовательские типы не поддерживаются в качестве параметров для подпрограмм.
• Для пользовательских функций для баз данных DB2 for z/OS недоступно Наглядное объяснение. Для пользовательских функций для z/OS эта инструментальная среда поддерживает только выражения, но не операторы.
• При первом создании подпрограммы в проекте разработки данных в мастере по созданию хранимой процедуры, мастере по созданию пользовательской функции или редакторе подпрограмм могут быть недоступны опции Наглядного объяснения. Чтобы обойти эту проблему, закройте и заново откройте рабочее пространство, после этого опции Наглядного объяснения будут доступны.
• При внедрении хранимой процедуры или пользовательской функции при помощи возможности внедрения ANT может выводиться следующее сообщение, если в пути классов не найден файл tools.jar: Не удалось найти tools.jar. Ожидалось, что его путь F:\jre\1.4.2\lib\tools.jar. Игнорируйте это сообщение. tools.jar - это часть среды времени выполнения Java (JRE), но не часть возможности внедрения ANT.
• Чтобы можно было внедрять хранимые процедуры для DB2 UDB for iSeries из файловой системы с помощью внедрения ANT, файл jt400.jar должен быть в системном пути классов.
• Если вы создаете хранимую процедуру Java и изменяете имя метода, нельзя щелкнуть в редакторе правой кнопкой мыши и выбрать Сохранить. Чтобы сохранить измененную хранимую процедуру, выберите Файл > Сохранить.
• Если вы пытаетесь внедрить экспортированную хранимую процедуру, следуя инструкциям в DeployInstructions.txt, может выводиться такое сообщение об ошибке: ...[createsp] Не удалось соединиться с базой данных назначения. [createsp] com.ibm.db2.jcc.DB2Driver... Чтобы обойти эту проблему, нужно задать в системном пути классов положение файла db2jcc.jar и соответствующих файлов лицензии.
• Перед удалением проекта разработки данных закройте открытые подпрограммы и редакторы SQL, относящиеся к этому проекту. Если не закрыть открытые подпрограммы и редакторы SQL, проект и его содержимое все равно будут удалены, но вы увидите сообщения об ошибках.
• При внедрении или запуске хранимых процедур Java может выводиться сообщение об ошибке не удалось загрузить класс. Это может происходить, если на сервере DB2 и RAD v7 используются разные версии JDK, и версия JDK на RAD v7 новее. Чтобы предотвратить появление этой ошибки, нужно задать опцию "-source 1.4" в поле Опции компиляции в мастере по внедрению подпрограмм при внедрении хранимых процедур Java на серверах, где используется JDK уровня 1.4 (например, на сервере DB2 Universal Database для Linux, UNIX и Windows Версии 8.2). В общем случае используйте соответствующую опцию компиляции "-source уровень_JDK", чтобы задать уровень JDK на сервере баз данных.
• При перетаскивании хранимой процедуры или пользовательской функции между серверами разных типов (например, с сервера DB2 UDB для Linux, UNIX и Windows на сервер DB2 UDB for z/OS) во время операции перетаскивания может выводиться предупреждение о наличии несовместимостей между этими двумя серверами. Если продолжить операцию перетаскивания и затем попытаться открыть эту хранимую процедуру или пользовательскую функцию, может выводиться сообщение об ошибке.
• При генерации профиля SQL для сервера DB2 UDB для Linux, UNIX и Windows Версии 8.2 может возникать исключительная ситуация пустого указателя, если на этом сервере нет необходимой хранимой процедуры (SYSIBM.SQLCAMESSAGECCSID), которая требуется драйверу JCC для получения текста сообщений об ошибках. Чтобы обойти эту проблему, можно создать соединение с сервером без параметра retrieveMessagesFromServerOnGetMessage=true.
• При мониторинге выполнения процедур SQL для таких операторов DML в этой процедуре, как INSERT, SELECT, DELETE и UPDATE, генерируются события профилирования. Однако события не обязательно генерируются для процедурных операторов, выполняющих присваивание значений переменных, и управляющих структур, таких как WHILE или IF. Поэтому для этих процедурных операторов не будут захвачены данные настройки.

Отладчик хранимых процедур

• Если соединение установлено с сервером DB2 в UNIX, могут возникать исключительные ситуации превышения срока ожидания при добавлении точек прерывания или выполнении в режиме отладки.
• Отладчик не работает для хранимых процедур, имена которых содержат и английские, и китайские символы.
• Выражения наблюдения поддерживаются только для динамических хранимых процедур Java. Они не поддерживаются для хранимых процедур SQL и SQLJ.
• Отладчик не останавливается на точке прерывания, если она расположена не на первом элементе выполняемого оператора, таком как SET. Кроме того, он не останавливается на операторах DECLARE CONTINUE, CLOSE CURSOR или ROLLBACK.
• Если при отладке хранимой процедуры Java выбрать действие Прервать, полное завершение сеанса отладки может занять несколько минут. У запущенных в это время новых сеансов отладки может быть неустойчивое поведение.
• При отладке хранимой процедуры Java, вызванной из другой хранимой процедуры SQL или Java, кнопка Шаг возврата недоступна. Чтобы обойти эту проблему, можно добавить точку прерывания на следующей строке вызывающей хранимой процедуры и затем выбрать Возобновить, чтобы вернуться к вызывающей хранимой процедуре.
• Если хранимая процедура Java вызывает другую хранимую процедуру, и затем вы возвращаетесь в первую хранимую процедуру Java, можно остановиться на некотором промежуточном коде Java. Чтобы обойти эту проблему, используйте кнопку Шаг возврата, чтобы вернуться на уровень стека вызовов для первой хранимой процедуры Java.
• Если при отладке хранимой процедуры Java выводится сообщение об ошибке Истек срок ожидания для пакета, попробуйте увеличить срок ожидания в параметрах Java. Чтобы увеличить значение параметра строка ожидания Java, выберите Окно > Предпочтения в полосе меню инструментальной среды. Раскройте узел Java и выберите Отладка. На странице Предпочтения отладки увеличьте значение Срок ожидания отладчика (мс) в разделе Срок ожидания связи. Рекомендуется увеличить значение по умолчанию как минимум в два раза.
• Если при отладке хранимой процедуры Java используется действие Изменить значение для изменения переменной, содержащей пустое строчное значение, кнопка OK диалогового окна редактирования может быть недоступной. Чтобы сделать ее доступной, выберите радиокнопку Ввести вычисленное значение, задайте непустое значение строки (например, 'a'), затем выберите радиокнопку Ввести буквальный текст. Кнопка OK станет доступной.
• Если при отладке хранимой процедуры Java не выводятся локальные переменные, возможно, при внедрении этой хранимой процедуры не задана опция компилятора -g. При внедрении хранимых процедур Java убедитесь, что задана опция компилятора -g.
• Если в окне Переменные выводится сообщение 'недопустимый фрейм стека', перейдите в окно Отладка и выберите объект потока над фреймом стека, затем щелкните по фрейму стека. Содержимое окна Переменные будет обновлено и сообщение об ошибке исчезнет.
• При отладке хранимой процедуры SQLJ, работающей в DB2 UDB for iSeries V5 R4, текущая выполняемая строка не соответствует строке исходного кода SQLJ, показанной в окне Отладка, если не применено исправление PTF для iSeries, изменяющее отображение строк на отображение, соответствующее исходному коду SQLJ, а не Java.
• Не распознаются предпочтения отладчика для срока ожидания менеджера сеансов. Эти предпочтения задаются так: Выберите Окно > Предпочтения, раскройте узел Выполнение/Отладка и выберите Отладчик хранимых процедур DB2. Измените значение поля Срок ожидания менеджера сеансов в минутах.
• Отладчик не может обработать хранимую процедуру с большим числом переменных в DB2 для Linux, UNIX и Windows. Максимальное число переменных - 200.
• Перемещение курсора в сеансе отладки: В некоторых случаях, когда в процедуре несколько объявлений переменных, нужно несколько раз выбрать Войти или Обойти для перемещения на следующую строку. Например, нужно дважды выбрать команду для этой строки: DECLARE v_dept, v_actdept CHAR(3); и трижды для этой: DECLARE v_bonus, v_deptbonus, v_newbonus DECIMAL(9,2). Число повторов команды равно числу объявлений переменных.
• Если вы добавили сеанс отладки для хранимой процедуры Java и добавили точки прерывания, а затем отключили точки прерывания, точки прерывания все равно остаются включенными. Чтобы обойти эту проблему, при запуске нового сеанса отладки следует сначала удалить все старые точки прерывания и только затем добавлять новые точки прерывания.
• В некоторых случаях при работе с несколькими проектами разработки данных при попытке выполнять отладку хранимой процедуры может выводиться такое сообщение об ошибке: "Не удалось найти хранимую процедуру ИМЯ_ПРОЦЕДУРЫ. Возможно, она была удалена из рабочего пространства" или "Исходный код не найден".
• Если сразу после прерывания сеанса отладки хранимой процедуры Java начать отладку хранимой процедуры SQL, в отладчике может выводиться сообщение "Пользовательская функция ... прервана пользователем". Чтобы обойти эту проблему, повторите попытку отладки хранимой процедуры SQL.

1.4 Исправления документации

В теме "Использование Наглядного объяснения для подпрограмм" есть неверная информация о том, какие серверы поддерживаются для Наглядного объяснения. Наглядное объяснение поддерживается для следующих операционных систем и серверов:

Наглядное объяснение доступно на платформах Windows(R). Поддерживаются следующие серверы:

• DB2 UDB для Linux, UNIX и Windows, Версия 8.2
• DB2 Версии 9 для Linux, UNIX и Windows
• DB2 UDB for z/OS Версии 7 и Версии 8

Чтобы в Developer Workbench можно было создавать пользовательские функции OLE DB, должны быть установлены следующие программы и выполняться следующие условия:

• DB2 UDB для Linux, UNIX и Windows Версии 8 или новее.
• OLE DB 2.0 или новее (можно получить на сайте Microsoft по адресу http://www.microsoft.com). Если попытаться вызвать табличную функцию OLE DB, не установив сначала OLE DB, DB2^(R) возвращает SQLCODE -465, SQLSTATE 58032, код причины 35. Информацию о требованиях к системе и провайдерах OLE DB для ваших источников данных смотрите в документации по источникам данных. Спецификации OLE DB смотрите в публикации Microsoft OLE DB 2.0 Programmer's Reference and Data Access SDK, Microsoft Press, 1998.
• На компьютере должен быть зарегистрирован файл db2olefn.dll. Чтобы зарегистрировать этот файл DLL, в командной строке введите regsvr32 каталог_установки_DB2\sqllib\function\db2olefn.dll, где каталог_установки_DB2 - корневой каталог установки DB2.

Чтобы в Developer Workbench можно было создавать пользовательские функции XML, должны быть установлены следующие программы и выполняться следующие условия:

• DB2 UDB для Linux, UNIX и Windows Версии 8 или новее.
• Если вы хотите перед обработкой выполнить для документа XML преобразования XSL, для базы данных назначения нужно включить модуль DB2 XML Extender. Когда включен модуль DB2 XML Extender, для базы данных назначения будут доступны поставляемые с механизмом базы данных пользовательские функции XSLTransform для выполнения преобразований XSL. Для локальных баз данных модуль DB2 XML Extender включается автоматически. Чтобы включить модуль XML Extender для удаленной базы данных, в командной строке в каталоге каталог_установки_DB2\sqllib\bin введите dxxadm enable_db база_данных, где база_данных - ваша база данных назначения, каталог_установки_DB2 - каталог установки DB2.

При работе в проводнике баз данных с автономным соединением недоступны следующие действия. Эта информация пропущена в теме "Ограничения для автономных соединений в проводнике баз данных":

• Задание операторов SQL для выполнения перед и после выполнения подпрограммы и задание входных и входных-выходных параметров при помощи действия меню Параметры запуска.
• Отладка хранимых процедур на текущем сервере.

Назад к оглавлению.

2.0 Информация об установке

• 2.1 Требования к программному и аппаратному обеспечению

• 2.2 Обзор установки

• 2.3 Предварительные требования для установки

• 2.4 Установка пакета Fix Pack

• 2.5 Скачивание пакета Fix Pack для локальных установок

• 2.6 Поддержка пользователей
  

2.1 Требования к программному и аппаратному обеспечению

Требования к аппаратному обеспечению

Дисковое пространство: 50 Мбайт

Память 512 Мбайт (рекомендуется 1 Гбайт)

Требования к программному обеспечению

• Microsoft Windows 2000 (Server и Professional), Microsoft Windows 2003 Server и Microsoft XP Professional
• Red Hat Enterprise Linux 3 и SUSE Linux Enterprise Server 9

Назад к оглавлению.

2.5 Скачивание пакета Fix Pack для локальных установок

Пакет Fix Pack можно установить прямо с сервера обновлений IBM; но можно также скачать его. Вы можете предпочесть скачать и установить пакет Fix Pack в следующих ситуациях:

• У вас медленное или нестабильное соединение с Интернетом и вы хотите использовать менеджер скачивания для возобновления прерванных операций скачивания.
• Вам сложно напрямую обращаться к серверам обновления IBM из-за брандмауэра.
• Вы предпочитаете скачать пакет Fix Pack, чтобы установить его позже.

Чтобы скачать и установить пакет Fix Pack:

1. Скачайте пакет Fix Pack с адреса ftp://ftp.software.ibm.com/software/data/db2/udb/developerworkbench/91/zips/dwb_9102.zip.
2. Распакуйте пакет Fix Pack во временный каталог, например, в C:\temp.
3. Чтобы посмотреть инструкции по установке, перейдите в каталог C:\temp\dwbfp2\ и откройте файл install_local_9102.html.

2.6 Поддержка пользователей

Новости о продукте, события, поддержку и прочую информацию можно найти на домашней странице DB2 по адресу http://www-306.ibm.com/software/data/db2/9/.

3.0 Замечания и товарные знаки

3.1 Замечания

Эта информация предназначена для продуктов и услуг, предлагаемых в США. IBM может не предлагать описанные продукты, услуги и возможности в других странах. Сведения о продуктах и услугах, доступных в настоящее время в вашей стране, можно получить в местном представительстве IBM. Любые ссылки на продукты, программы или услуги IBM не означают явным или неявным образом, что можно использовать только продукты, программы или услуги IBM. Разрешается использовать любые функционально эквивалентные продукты, программы или услуги, если при этом не нарушаются права IBM на интеллектуальную собственность. Однако ответственность за оценку и проверку работы любых продуктов, программ и услуг других фирм лежит на пользователе.

Фирма IBM может располагать патентами или рассматриваемыми заявками на патенты, относящимися к предмету данного документа. Получение этого документа не означает предоставления каких-либо лицензий на эти патенты. Запросы по поводу лицензий следует направлять в письменной форме по адресу: IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594 U.S.A.

Следующий абзац не применяется в Великобритании или в любой другой стране, где подобные заявления противоречат местным законам:

КОРПОРАЦИЯ INTERNATIONAL BUSINESS MACHINES ПРЕДСТАВЛЯЕТ ДАННУЮ ПУБЛИКАЦИЮ "КАК ЕСТЬ" БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ПРЕДПОЛАГАЕМЫЕ ГАРАНТИИ СОВМЕСТИМОСТИ, РЫНОЧНОЙ ПРИГОДНОСТИ И СООТВЕТСТВИЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ, НО НЕ ОГРАНИЧИВАЯСЬ ИМИ. В некоторых странах для определенных сделок подобные оговорки не допускаются, таким образом, это утверждение может не относиться к вам.

Данная информация может содержать технические неточности и типографские опечатки. Периодически в информацию вносятся изменения, они будут включены в новые издания этой публикации. Фирма IBM может в любое время без уведомления вносить изменения и усовершенствования в продукты и программы, описанные в этой публикации.

Любые ссылки в данной публикации на Web-сайты, не принадлежащие IBM, приводятся только для удобства и никоим образом не означают поддержки IBM этих Web-сайтов. Материалы этих Web-сайтов не являются частью данного продукта IBM, и вы можете использовать их только на собственную ответственность.

Если обладателю лицензии на данную программу понадобятся сведения о возможности: (i) обмена данными между независимо разработанными программами и другими программами (включая данную) и (ii) совместного использования таких данных, он может обратиться по адресу:

Такая информация может быть предоставлена на определенных условиях (в некоторых случаях к таким условиям может относиться оплата).

Лицензированная программа, описанная в данной информации, и все лицензированные материалы, доступные с ней, предоставляются IBM на условиях IBM Customer Agreement (Соглашения IBM с заказчиком), Международного соглашения о лицензиях на программы IBM или эквивалентного соглашения.

Информация о продуктах других фирм получена от поставщиков этих продуктов, из их опубликованных объявлений или из других общедоступных источников. Фирма IBM не проверяла эти продукты и не может подтвердить точность измерений, совместимость или прочие утверждения о продуктах других фирм. Вопросы о возможностях продуктов других фирм следует направлять поставщикам этих продуктов.

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

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

3.2 Товарные знаки

IBM, Derby, Rational, DB2 Universal Database и zSeries - товарные знаки или зарегистрированные товарные знаки корпорации IBM в США и/или других странах.

Java и все товарные знаки на основе Java - товарные знаки Sun Microsystems, Inc. в Соединенных Штатах и/или в других странах.

Linux - товарный знак Линуса Торвальдса в Соединенных Штатах и/или других странах.

Microsoft, Windows 2000, Windows 2003 и Windows XP - товарные знаки корпорации Microsoft в США и/или других странах.

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

Назад к оглавлению.