コピーブックメッセージの取り扱い

Tricentis Tosca　API Engine は、 CBL 、 COB 、 CPY 形式のメッセージをサポートしています。これにより、管理、ビジネス、財務システムでよく使用される共通ビジネス指向言語（COBOL）ファイルを扱うことができます。コピーブックファイルは、COBOLファイルのデータ構造に関する情報を含み、プログラムがそれらを解釈できるようにするインクルード・ファイルです。

まず、以下のコピーブックメッセージをインポートします： その後、 API Engine でモジュール属性を定義し、その値を確認します。

コピーブックのメッセージを読む

コピーブックのメッセージには、複数の個別フィールドとフィールド・グループで構成されるデータ・レコードが含まれます。可能なフィールドタイプは3つあります。

• A ：アルファベットフィールド（A-Z、a-z、スペース）：

• 9 ：数値フィールド（0-9）

• X ：任意の文字フィールド（バイナリを含む）

例えば、 X(20) は 20 文字の文字フィールドを表し、 9(05) は 5 桁の数値フィールドを表します。フィールドタイプには COMP-3 も含まれることがあり、これはフィールドが二進化十進数形式でデータをパックすることを示します。つまり、すべてのバイトに2桁が含まれています。

コピーブックメッセージのペイロードを簡単にテキストに翻訳することはできません。そのため API Engine では、ペイロードを表で表示しています。この表は以下のカラムで構成されています。

• レベル：どのフィールドがグループとして一緒に属するかを定義します。データレコードは、1（最高）から99（最低）までのレベルを持つ階層構造を持っています。レベル0はデータレコードの名称を指定します。

• 要素ID ：要素の名称を示します。つまり、フィールド名です。フィールド名は一意ですが、例外としてフィラーはプレースホルダとして機能します。

• 位置：データレコードにおけるフィールドの位置を示します。例えば、 90 は、フィールドが文字90で始まることを意味します。

• 長さ：フィールドが構成する文字数を表します。例えば、 20 は、フィールドが20個の文字を含むことを意味します。値が示す長さより文字数が少ない場合、数値フィールドの場合、システムは空白またはゼロを追加します。

• タイプ：フィールドタイプを示します。例えば、 9(07) COMP-3 。

• 値 ：フィールドの値、例えば名前や口座番号などの情報を表示します。

コピーブックメッセージのインポート

API Engine を使ってコピーブックメッセージを扱うには、インポートしてテーブルビューを有効にする必要があります。これを行うには、以下の手順に従ってください。

1. CICSサービスポートを構成し、コピーブックファイルからのメッセージを OSV に記録します。

2. Tosca Commander にメッセージをインポートします。

3. テーブルビューを有効にするには、 C:¥Tosca_Projects ディレクトリを開き、「 ServiceDefinitions 」という名前で新しいフォルダを作成します。

4. 「 Copybooks 」 という名前でサブフォルダを作成します。

5. メッセージを作成したコピーブックファイルをコピーし、 Copybooks フォルダに貼り付けます。必要に応じて、 Copybooks フォルダに新しいサブフォルダを作成できます。

これで、インポートしたコピーブックメッセージをテーブルビューで扱うことができます。

API TestCases を作成するには、 OSV シナリオを変換します。

モジュール属性の作成

コピーブックのメッセージ要素の値操縦するためにモジュール属性を作成できます。これを行うには、以下の手順に従ってください。

1. API モジュールを選択し、APIテストメニューにアクセスしてください。

2. API テストメニューの追加をクリックします。Attribute Assistant ウィンドウが開きます。

3. モジュール属性を追加するには、 Attribute Assistant ウィンドウでそれを選択し、「追加」をクリックします。CTRL を押しながら複数のモジュール属性を選択することができます。

または、モジュール属性をマニュアルで追加することもできます。このためにはペイロードで1つ以上の要素を選択し、 APIテストメニューの追加をクリックします。

作成されたモジュール属性は、それぞれのメッセージ要素を示し、メッセージ構造に基づいて階層的に構成されています。