Пакетная программа импорта (интерфейс командной строки) применяется для создания классов
связывания J2C и обращения к ним вместо мастера связывания данных
J2C. При необходимости пакетную программу импорта можно запускать из рабочей среды.
Прежде чем начать
Пакетная программа импорта позволяет создавать классы
связывания J2C для адаптеров ресурсов
CICS ECI
и IMS. Пакетная программа импорта (интерфейс командной строки)
применяется для создания классов связывания J2C и обращения к ним
вместо мастера связывания данных J2C. При необходимости пакетную программу импорта можно запускать из рабочей среды.
Об этой задаче
Для конкретной среды необходимо изменить параметры в пяти
файлах. Это файлы
<каталог-установки>/IBM/SDPShared/plugins/com.ibm.adapter.j2c.command/runtime
and
<каталог-установки>/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/sample.
- CICSECI_PlatformProperties.xml: Содержит параметры
исходного файла C или COBOL, который вызывается по умолчанию в зависимости от платформы, используемой для запуска
пакетной программы импорта (NT, AIX и MVS).
- CICSECI_cobolSample.xml: Содержит свойства службы,
применяемые пакетной программой импорта:
- EISProject
- name: Проект службы, в который будет добавлена новая служба предприятия. Если проект службы не существует, он будет создан автоматически.
Прим.: Файл, приведенный в качестве примера, содержит
элемент ImportPropertyArray в проекте EISProject. Указанные свойства импорта переопределяют значения, заданные в файле
PlatformProperties.xml. Элемент ImportPropertyArray можно удалить, если в файле
PlatformProperties.xml указаны правильные параметры службы.
- EISService: Один или несколько для каждого EISProject
- name: Служба предприятия. После импорта файлов C или COBOL создаются
три файла WSDL для каждой службы (файлы интерфейса, связывания
и
службы).
- type : Адаптер ресурса, используемый для службы. Это имя
проекта коннектора с файлом RAR.
- targetNameSpace: URL целевого пространства имен
(http://...).
На основе targetNameSpace в проекте службы
создается пакет для сохранения созданных файлов
WSDL.
- generateHelpers: Если импортируются сложные типы данных,
такие как структуры C, то для работы службы потребуются вспомогательные
классы. Если для этой опции указано значение "true", то пакетная
программа импорта автоматически создаст и откомпилирует эти классы.
- Operation: Одна или несколько для каждого EISService:
- ...Message
- importFile: Файл, содержащий определение для создания операции
службы предприятия.
- 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 (windows) или importBatch.sh (Linux): Файл
пакетной программы импорта со следующими параметрами:
- containerFile: файл, указанный на
этапе 3.
- Необязательные параметры
- generationStyle
- 0 (по умолчанию): Соответствует стилю WebSphere Studio V5.0
- 1: Соответствует опциям создания VisualAge® for Java™: direct,
no notification, no inner class, no shortened names, with primitive
type arrays.
- 2: Соответствует опциям создания VisualAge for Java™: direct, no notification,
no inner class, shortened names, with primitive type arrays.
- workspace: Полный путь к целевой
рабочей области операции импорта.
- RAD_installdir: установочный каталог Rational Application Developer.
- Исходный файл C или COBOL.: На основе этого исходного
файла COBOL (TADERC99.ccp) или C пакетная программа импорта создает файлы
связываний данных и интерфейсов.
Процедура
- Запуск пакетной программы импорта с помощью командной строки:
Для вызова пакетной программы импорта из командной строки выполните
следующие действия:
- Убедитесь, что адаптер ресурса импортирован в рабочую область.
- Создайте каталог для сохранения файлов, указанных в начале. На остальных этапах это будет каталог inputdir.
- Задайте язык и свойства соединения для системы хоста в
файле свойств платформы. Скопируйте соответствующий файл свойств
платформы (CICSECI_PlatformProperties.xml или
IMS_PlatformProperties.xml) из
<каталог-установки>/plugins/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/sample
в 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 для сохранения файлов, указанных в
начале. На остальных этапах это будет каталог inputdir.
- Выполните этап c, этап d и этап e,
запустив пакетную программу импорта из командной
строки.
- Скопируйте файл batchImport.xml из
<каталог-установки>/IBM/IBMIMShared/plugins/com.ibm.adapter.j2c.command/script
в inputdir. Замените sampleContainer.xml
именем вашего файла контейнера.
- Щелкните правой кнопкой мыши на batchImport.xml и выберите . В открывшемся окне выберите . Нажмите кнопки
Применить и
Закрыть. Этот шаг выполняется только один раз.
- Щелкните правой кнопкой мыши на batchImport.xml и выберите .
Пакетная программа импорта импортирует файлы COBOL или C и
создает файлы связываний в проекте (EISProject), а также пакет (на
основе targetNameSpace), указанный в файле XML.
Прим.: Пакетная программа импорта, запущенная с помощью командной строки, выполняется аналогично
случаю запуска из рабочей области. Для того чтобы убедиться в этом, откройте рабочую область, в которой в
начале были созданы файлы. Обратите внимание, что
проект
Temp содержит те же файлы, которые были
импортированы вручную на
этапе 1.