Пакетная программа импорта (интерфейс командной строки)
применяется для создания классов связывания J2C и обращения к ним
вместо мастера связывания данных J2C. При необходимости пакетную
программу импорта можно запускать из рабочей среды.
Пакетная программа импорта позволяет создавать классы
связывания J2C для адаптеров ресурсов CICS ECI
и IMS. Пакетная программа импорта (интерфейс командной строки)
применяется для создания классов связывания J2C и обращения к ним
вместо мастера связывания данных J2C. При необходимости пакетную
программу импорта можно запускать из рабочей среды.
Переход от сценариев Ant V6 к сценариям J2C Ant V7:
В продуктах разработки приложений
Rational
V7.0 предусмотрена новая функция записи сеанса, которая создает
сценарии Ant. Утилита переноса позволяет преобразовать старый
сценарий Ant V6 в новый формат J2C Ant V7. Рекомендуется использовать
новые сценарии Ant, поскольку они проще в использовании и обладают
большей гибкостью.
Запуск
утилиты переноса
- Вместо исходный файл укажите файл сценария Ant V6, который
требуется перенести.
- Выполните файл migration.xml с помощью рабочей среды
или командной строки.
<?xml version="1.0" encoding="UTF-8"?>
<project name="Migration" default="default" xmlns:j2c="http://com.ibm.adapter.j2c">
<--
Укажите полный путь к исходному файлу или путь относительно рабочей области.
Исходный файл будет сохранен с расширением .bak.
-->
<target name="default">
<j2c:migrate source="/Script/batchImport_deprecated.xml"/>
</target>
</project>
Работа со сценариями пакетной программы импорта
- В зависимости от конкретной среды измените параметры в пяти файлах, которые расположены в
каталогах <установочный-каталог>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/runtime
и <установочный-каталог>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/sample/batch_import.
Необходимы следующие файлы:
- CICSECI_PlatformProperties.xml: Содержит параметры
исходного файла C или COBOL для различных
платформ (NT, AIX и MVS).
- CICSECI_cobolSample.xml: Содержит свойства службы,
применяемые пакетной программой импорта:
- EISProject
- name: Имя проекта службы, в который будет добавлена новая
служба предприятия. Если проект службы не существует, он будет создан
автоматически.
Прим.: Файл, приведенный в качестве примера, содержит
элемент ImportPropertyArray в проекте EISProject.
Указанные свойства импорта переопределяют значения, заданные в файле
PlatformProperties.xml.
Элемент ImportPropertyArray можно удалить, если в файле
PlatformProperties.xml указаны правильные параметры службы.
- EISService (обратите внимание, что для каждого проекта
EISProject можно указать несколько элементов EISService):
- name: Имя службы предприятия. После импорта файлов C или
COBOL для каждой службы создаются три файла WSDL (интерфейс,
связывание и служба).
- type : Имя адаптера ресурса, связанного со службой. Имя
проекта коннектора с файлом RAR.
- targetNameSpace: URL целевого пространства имен
(http://...). На основе targetNameSpace в проекте службы
создается пакет для сохранения созданных файлов
wsdl.
- generateHelpers: Если импортируются сложные типы данных,
такие как структуры C, то для работы службы потребуются вспомогательные
классы. Если для этой опции указано значение "true", то пакетная
программа импорта автоматически создаст и откомпилирует эти классы.
- Operation (обратите внимание, что для каждой службы EISService
можно указать несколько элементов Operation):
- name: Имя операции.
- type: Тип операции. Допустимые значения: REQUEST_RESPONSE
и ONE_WAY.
Прим.: Операция ONE_WAY должна содержать определение
InputMessage, а операция REQUEST_RESPONSE - определение InputMessage
и определение OutputMessage. Если определения типов InputMessage и
OutputMessage совпадают, то используется одно определение
InputOutputMessage.
- ...Message
- importFile: Имя файла, в котором содержится определение,
применяемое при создании операции службы предприятия. Укажите
исходный файл C или COBOL.
- importDirectory: Каталог, в котором расположен файл
importFile. Если атрибут importDirectory не указан, то поиск
importFile выполняется в каталоге inputdir и текущем каталоге.
- nativeTypeName : Имя типа данных для импорта из
importFile. Например, в случае файла COBOL, как правило, применяется
тип данных DFHCOMMAREA.
Если после анализа importFile тип данных nativeTypeName не будет входит в число
допустимых, выдается сообщение об ошибке.
- name: Имя, присваиваемое импортированному типу. Например,
если DFHCOMMAREA описывает данные о заказчике, можно задать имя
Customer.
- generationPackage: Необязательный атрибут, позволяющий
указать другое имя пакета для созданных вспомогательных классов
(JavaBean и обработчиков формата). Для схемы, создаваемой в файле
WSDL интерфейса, задается другое пространство имен.
- sampleContainer.xml : Этот файл, передаваемый пакетной
программе импорта в качестве аргумента, содержит список файлов
(ImportDefinition), подлежащих обработке. Элемент
ImportDefinitionArray содержит следующие атрибуты:
- platform: Имя платформы системы хоста. Допустимые
значения: NT, AIX и
OS390.
- platformProperties: Задает имя файла свойств платформы.
- importBatch.bat (win) или importBatch.sh (linux):
Файл пакетной программы импорта, содержащий следующие параметры:
- containerFile: файл, указанный на
шаге c.
- Необязательные параметры
- generationStyle
- 0: значение по умолчанию, соответствующее стилю WebSphere Studio V5.0
- 1: соответствует опциям создания VisualAge® for Java™:
напрямую, без уведомления, без внутреннего класса, не
сокращать имена, с массивами простого типа.
- 2: соответствует опциям создания VisualAge for Java:
напрямую, без уведомления, без внутреннего класса, сокращать
имена, с массивами простого типа.
- workspace: полный путь к
целевой
рабочей области операции импорта.
- RAD_installdir: установочный
каталог Rational Application
Developer.
- Исходный файл C или COBOL.: На основе этого исходного
файла COBOL (TADERC99.ccp) или C пакетная программа импорта создает файлы
связываний данных и
интерфейсов.
- Запуск пакетной программы импорта с помощью командной строки:
Для вызова пакетной программы импорта из командной строки выполните
следующие действия:
- Убедитесь, что адаптер ресурса импортирован в рабочую область.
- Создайте каталог для сохранения файлов, указанных на
шаге 1. На
остальных шагах процесса это каталог inputdir.
- Задайте язык и свойства соединения для системы хоста в
файле свойств платформы. Скопируйте файл свойств платформы
(CICSECI_PlatformProperties.xml или IMS_PlatformProperties.xml)
из каталога
%PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.j2c.command_6.1.0/sample/batch_import
(где x - это каталог, в котором установлено программное
обеспечение разработки Rational)
в каталог inputdir и откройте его в текстовом
редакторе. В этом файле задаются свойства по умолчанию, описывающие
целевую среду.
Все свойства, заданные в этом файле, можно переопределить в файле
определения службы, описание которого приведено ниже. Ненужные
определения платформы удалять не обязательно.
- Скопируйте подходящий пример файла определения службы
(CICSECI_cSample.xml, CICSECI_cobolSample.xml или
IMS_cobolSample.xml) в каталог inputdir. При
необходимости измените имя файла.
- Скопируйте пример файла контейнера (sampleContainer.xml) в
каталог inputdir. При
необходимости измените имя файла. Откройте полученный файл в
текстовом редакторе и задайте подходящую платформу. Кроме того, для
каждого файла определения службы, созданного на
шаге d,
добавьте элемент ImportDefinition, указывающий на созданный файл
определения службы.
- При необходимости закройте экземпляр
Rational
Application Developer, использующий целевую рабочую область.
- Из командной строки запустите команду importBatch со
следующими опциями: importBatch -file=контейнер
[-style=стиль-создания] [-d рабочая-область] [-e
каталог-RAD]
Прим.: В параметре -file должен быть указан полный путь к файлу контейнера.
- Запуск пакетной программы импорта из рабочей среды: Для
вызова пакетной программы импорта из рабочей среды выполните
следующие действия:
- Убедитесь, что адаптер ресурса импортирован в рабочую область.
- Создайте простой проект с именем Temp для
сохранения файлов, указанных на
шаге 1. На
остальных шагах этот каталог рассматривается как inputdir.
- Выполните шаг c, шаг d и шаг e из
процедуры запуска пакетной программы импорта из командной
строки.
- Скопируйте файл batchImport.xml из каталога
%PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.command_6.0.0/script
в каталог inputdir. Укажите для файла
sampleContainer.xml имя файла контейнера.
- Щелкните на файле batchImport.xml правой кнопкой мыши и
выберите Выполнить > Вторая
компоновка Ant." В открывшемся окне выберите
JRE, затем выберите Запустить в JRE
рабочей области. Нажмите кнопки
Применить и
Закрыть.
Этот шаг выполняется только один раз.
- Щелкните на файле batchImport.xml правой кнопкой мыши и выберите
Выполнить > Первая компоновка Ant."
Пакетная программа импорта импортирует файлы COBOL или C и
создает файлы связываний в проекте (EISProject), а также пакет (на
основе targetNameSpace), указанный в файле XML.
Прим.: Пакетная программа
импорта, запущенная с помощью командной строки, выполняется аналогично
случаю запуска из рабочей области. Для подтверждения откройте
рабочую область, в которой на
шаге 1 были сохранены файлы. Обратите внимание, что
проект
Temp содержит те же файлы, что были
импортированы вручную на
шаге 3.