Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space FUNCTDEV and version SVC2023.2

...

Table of Content Zone
maxLevel2
minLevel2
outlinetrue
indent-10px
locationtop

Copybook JAR の生成

次のコマンドを使用して com.parasoft.soavirt.messages.copybook-<version><VERSION>.jar ファイルを実行し、copybook ファイルを読み込んで UI に統合する JAR ファイルを生成します。

Code Block
languagebash
java -jar <path to executable copybook.jar> -copybookinput <path to copybook directory> -filenames <filename1, filename2, etc.> and so on> -name <name> -apijar <path to com.parasoft.api.jar>

コマンドは次の引数を使用します。

Scroll Table Layout
widths30%,70%

-jarParasoft Marketplace から取得した Copybook 拡張機能を指定します。
-copybookinput

copybook ディレクトリ、または複数の copybook ディレクトリのカンマ区切りのリストを指定します。指定されていない場合、カレント ディレクトリが使用されます。

ビルダーはサブディレクトリを再帰的に処理しません。サブディレクトリは個別のエントリとして指定します。ディレクトリ名に空白または特殊文字が含まれる場合は引用符で囲みます。

-filenamescopybooks ファイルのリストをカンマ区切りで指定します (ワイルドカードを使用可)。
-nameビルダーが生成する copybook jar ファイル拡張の名前を指定します。この名前が Virtualize/SOAtest で UI ラベルとして使用されます。–name が指定されていない場合、jar ファイルの名前は copybook.jar になります。
-apijar

com.parasoft.api.jar ファイルへの絶対パスを指定します。-name

引数を使用する場合、この引数が必須です。jar ファイルは [INSTALL]

引数を使用する場合、この引数が必須です。

バージョン 2020.1 以前の場合、jar ファイルは <INSTALL>/eclipse/plugins/com.parasoft.xtest.libs.web_

[version]

<VERSION>/root/com.parasoft.api.jar にあります。

バージョン 2020.2 以降の場合、jar ファイルは <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/com.parasoft.api.jar にあります。

-logコンソール メッセージのログ記録レベルを設定します。DEBUGINFOWARNERROR を指定できます。
-preprocess前処理が完了したら処理を中断することを指定します。
-helpヘルプを表示します。

Code Block
languagebash
java -jar parasoft_copybook_builder.jar -copybookinput "C:\My Projects\proj_a\cobol_src","C:\My Projects\proj_a\cobol_src\copy books" -filenames *.cbl,*.cpy -name Ps01CommArea -apijar com.parasoft.api.jar

この例は、以下のフォルダーを検索します。

  • C:\My Projects\prog_a\cobol_src
  • C:\My Projects\proj_a\cobol_src\copy books

ワイルドカード *.cbl または *.cpy に一致するファイルが copybook として処理されます。

Copybook ツールの実行が完了すると、ディレクトリに次の 2 つのファイルが作成されています: copybook.jar および velocity.logエラーがなかった場合、velocity.log は削除してかまいません。「Integrating the Copybook Extension」の説明に従って copybook.jar ファイルを統合します。

Copybook 拡張機能の統合

Copybook ツールは、「Generating the Copybook JAR」で JAR の実行によって作成されたシステム JAR ファイルとして SOAtest および Virtualize の UI に統合されます。

  1. [Parasoft ] メニューの > [設定] を選択します。 を選択し、[システム プロパティ] を選択します。
  2. 既存の を選択し、既存の copybook.jar があれば削除します。 があれば削除します。  
  3. [Add JARs] をクリックし、「Generating the Copybook JAR」で JAR の実行によって作成された copybook.jar を参照します。
  4. [開く] をクリックし、変更を適用します。
  5. SOAtest/Virtualize を再起動します。

ローカル設定プロパティ 設定プロパティ ファイルで system.properties.classpath プロパティに copybook.jar ファイルを追加すると、コマンド ラインから拡張機能をインストールできます。例:

system.properties.classpath=<path to jar><PATH_TO_JAR>/copybook1.jar

また、VirtualAssetsまた、VirtualAssets/system_jars フォルダー (フォルダーがまだ存在しない場合、作成します) に copybook.jar ファイルを追加します。次の API 呼び出しを実行して jar をリロードします。

Code Block
languagetext
http://<virtualize<VIRTUALIZE_serverSERVER_host>HOST>:<virtualize<VIRTUALIZE_serverSERVER_port>PORT>/soavirt/api/<version><VERSION>/preferences/systemProperties/reload

Responder での Copybook の使用

トラフィックから Copybook Responder および Copybook Client を作成したり、手動で追加できます。手動で追加する場合、[メッセージ タイプ] ドロップダウンから目的の copybook を選択します。copybook を選択すると、copybook に基づいてツリーに値が設定されます。このサンプルは、copybook から Virtualize のレスポンダーを作成する方法を示しています。

  1. Virtualize パースペクティブで [Parasoft] > [Vieビューの表示] > [仮想アセット エクスプローラー] を選択します。
  2. [VirtualAssets] フォルダーを右クリックし、[新規追加] > [仮想アセット (.pva) ファイル] を選択します。 を選択します。 
  3. ファイル名を入力し、[次へ] をクリックします。
  4. [] を選択し、 [終了] をクリックします。VirtualAssets をクリックします。VirtualAssets フォルダーに新規 .pva ファイルが作成されます。
  5. 新規 .pva の下の [レスポンダー スイート] を右クリックし、[新規追加] > [Responder] を選択します。
  6. [CopyBook Message Responder] を選択し、[終了] をクリックします。
  7. 作成したばかりの Copybook Message Responder を開きます。 
  8. [メッセージ タイプ] ドロップダウン メニューには、利用可能な copybook がすべて表示されています。copybook を選択すると、copybook のフィールドがレスポンダー フィールドとして表示されます。

...