Создание объектов JavaBean J2C с помощью пакетной программы импорта

Пакетная программа импорта (интерфейс командной строки) применяется для создания классов связывания J2C и обращения к ним вместо мастера связывания данных J2C. При необходимости пакетную программу импорта можно запускать из рабочей среды.

Пакетная программа импорта позволяет создавать классы связывания J2C для адаптеров ресурсов CICS ECI и IMS. Пакетная программа импорта (интерфейс командной строки) применяется для создания классов связывания J2C и обращения к ним вместо мастера связывания данных J2C. При необходимости пакетную программу импорта можно запускать из рабочей среды.
Переход от сценариев Ant V6 к сценариям J2C Ant V7: В продуктах разработки приложений Rational V7.0 предусмотрена новая функция записи сеанса, которая создает сценарии Ant. Утилита переноса позволяет преобразовать старый сценарий Ant V6 в новый формат J2C Ant V7. Рекомендуется использовать новые сценарии Ant, поскольку они проще в использовании и обладают большей гибкостью.

Запуск утилиты переноса

  1. Вместо исходный файл укажите файл сценария Ant V6, который требуется перенести.
  2. Выполните файл 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>

Работа со сценариями пакетной программы импорта

  1. В зависимости от конкретной среды измените параметры в пяти файлах, которые расположены в каталогах <установочный-каталог>\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. Необходимы следующие файлы:
    1. CICSECI_PlatformProperties.xml: Содержит параметры исходного файла C или COBOL для различных платформ (NT, AIX и MVS).
    2. 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 интерфейса, задается другое пространство имен.
    3. sampleContainer.xml : Этот файл, передаваемый пакетной программе импорта в качестве аргумента, содержит список файлов (ImportDefinition), подлежащих обработке. Элемент ImportDefinitionArray содержит следующие атрибуты:
      • platform: Имя платформы системы хоста. Допустимые значения: NT, AIX и OS390.
      • platformProperties: Задает имя файла свойств платформы.
    4. 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.
    5. Исходный файл C или COBOL.: На основе этого исходного файла COBOL (TADERC99.ccp) или C пакетная программа импорта создает файлы связываний данных и интерфейсов.
  2. Запуск пакетной программы импорта с помощью командной строки: Для вызова пакетной программы импорта из командной строки выполните следующие действия:
    1. Убедитесь, что адаптер ресурса импортирован в рабочую область.
    2. Создайте каталог для сохранения файлов, указанных на шаге 1. На остальных шагах процесса это каталог inputdir.
    3. Задайте язык и свойства соединения для системы хоста в файле свойств платформы. Скопируйте файл свойств платформы (CICSECI_PlatformProperties.xml или IMS_PlatformProperties.xml) из каталога %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.j2c.command_6.1.0/sample/batch_import (где x - это каталог, в котором установлено программное обеспечение разработки Rational) в каталог inputdir и откройте его в текстовом редакторе. В этом файле задаются свойства по умолчанию, описывающие целевую среду. Все свойства, заданные в этом файле, можно переопределить в файле определения службы, описание которого приведено ниже. Ненужные определения платформы удалять не обязательно.
    4. Скопируйте подходящий пример файла определения службы (CICSECI_cSample.xml, CICSECI_cobolSample.xml или IMS_cobolSample.xml) в каталог inputdir. При необходимости измените имя файла.
    5. Скопируйте пример файла контейнера (sampleContainer.xml) в каталог inputdir. При необходимости измените имя файла. Откройте полученный файл в текстовом редакторе и задайте подходящую платформу. Кроме того, для каждого файла определения службы, созданного на шаге d, добавьте элемент ImportDefinition, указывающий на созданный файл определения службы.
    6. При необходимости закройте экземпляр Rational Application Developer, использующий целевую рабочую область.
    7. Из командной строки запустите команду importBatch со следующими опциями: importBatch -file=контейнер [-style=стиль-создания] [-d рабочая-область] [-e каталог-RAD]
      Прим.: В параметре -file должен быть указан полный путь к файлу контейнера.
  3. Запуск пакетной программы импорта из рабочей среды: Для вызова пакетной программы импорта из рабочей среды выполните следующие действия:
    1. Убедитесь, что адаптер ресурса импортирован в рабочую область.
    2. Создайте простой проект с именем Temp для сохранения файлов, указанных на шаге 1. На остальных шагах этот каталог рассматривается как inputdir.
    3. Выполните шаг c, шаг d и шаг e из процедуры запуска пакетной программы импорта из командной строки.
    4. Скопируйте файл batchImport.xml из каталога %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.command_6.0.0/script в каталог inputdir. Укажите для файла sampleContainer.xml имя файла контейнера.
    5. Щелкните на файле batchImport.xml правой кнопкой мыши и выберите Выполнить > Вторая компоновка Ant." В открывшемся окне выберите JRE, затем выберите Запустить в JRE рабочей области. Нажмите кнопки Применить и Закрыть. Этот шаг выполняется только один раз.
    6. Щелкните на файле batchImport.xml правой кнопкой мыши и выберите Выполнить > Первая компоновка Ant."

      Пакетная программа импорта импортирует файлы COBOL или C и создает файлы связываний в проекте (EISProject), а также пакет (на основе targetNameSpace), указанный в файле XML.

      Прим.: Пакетная программа импорта, запущенная с помощью командной строки, выполняется аналогично случаю запуска из рабочей области. Для подтверждения откройте рабочую область, в которой на шаге 1 были сохранены файлы. Обратите внимание, что проект Temp содержит те же файлы, что были импортированы вручную на шаге 3.

Комментарии