IMS Connect サービスイメージの記録

CA Service Virtualization の使用 › CA Service Virtualization でのワークステーションおよびコンソールの使用 › サービスイメージの作成 › レコーディングによるサービスイメージの作成 › トランスポートプロトコル › IMS Connect サービスイメージの記録

IMS Connect サービスイメージの記録

IMS Connect サービスイメージを記録する方法

レコーダを開始する前に、必要に応じて local.properties に以下のプロパティを追加します。
- テスト中のシステムが、応答メッセージの先頭に 4 バイトの LLLL 長フィールドを持つ応答を送信する場合は、以下のプロパティを設定します。
```
lisa.vse.protocol.ims.response.includes.llll=true
```
- テスト中のシステムが、要求メッセージの先頭に 4 バイトの LLZZ 長フィールドを持つ要求を受信する場合は、以下のプロパティを設定します。
```
lisa.vse.ims.connect.llzz.request=true
```
- テスト中のシステムが、応答メッセージの先頭に 4 バイトの LLZZ 長フィールドを持つ応答を送信する場合は、以下のプロパティを設定します。
```
lisa.vse.ims.connect.llzz.response=true
```
- テスト中のシステムがペイロードの解析に Copybook を使用する場合は、以下のプロパティを追加します。
```
lisa.vse.copybook.unknown.passthrough=true
```
これにより、確認応答メッセージ（ペイロードデータを含まない）を表すバイナリ応答では、Copybook 処理をバイパスすることができます。
仮想サービスイメージレコーダの［基本］タブで、トランスポートプロトコルとして IMS Connect を選択します。
［基本］タブのフィールドに入力し、［次へ］をクリックします。
レコーダの次の手順が開きます。
ポートおよびホストの情報を入力します。

リスン/記録ポート

クライアントが DevTest と通信するポートを定義します。

ターゲットホスト

サーバが実行されているターゲットホストの名前または IP アドレスを定義します。

ターゲットポート

サーバがリスンするターゲットポート番号を定義します。プロキシパススルースタイルを選択する場合は、このフィールドを空白のままにします。

デフォルト： 80 （HTTP）および 443 （HTTPS）
IMS 形式ファイル
以下のいずれかを定義します。
- IBM サンプルアプリケーションが使用する 160 バイトのヘッダを使用する IMS Connect 要求をサポートするファイルの名前。
- 80 バイトのヘッダ。
サポートされるこれらの 160 バイトおよび 80 バイトヘッダのフィールド定義は、LISA_HOME ディレクトリの ims.format ファイルで提供されています。

デフォルトで DevTest に含まれている IMS Connect サポートを使用するには、このフィールドを空白のままにします。
文字セット
仮想化されるアプリケーションによって、データがどのようにエンコードされるか定義します。

値
- ASCII - CP1252
- EBCDIC - CP037
［次へ］をクリックして、レコーディングウィンドウを表示します。
IMS Connect サーバと通信するアプリケーションを起動し、記録するアクティビティを実行します。
このアプリケーションのホストとポートが、レコーダのホストとポート（通常は localhost:8001）であることを確認します。
仮想サービスイメージレコーダウィンドウでトランザクションが記録されたことを確認したら、［次へ］をクリックします。
データプロトコルウィンドウが表示されます。

デフォルトでは、TransactionCode ヘッダフィールド（存在する場合）は、要求操作として設定されます。また、TransactionCode、DestinationId、および ClientId の各フィールドが形式ファイル定義に存在する場合、これらが引数として追加されます。
必要に応じて、Copybook データプロトコルなどのデータプロトコルを追加し、［次へ］をクリックします。
会話スタータウィンドウが表示されます。
［次へ］をクリックします。
VSM と VSI を表示するオプションを選択し、［終了］をクリックます。
サービスイメージエディタに IMS Connect サービスイメージが表示されます。

IMS Connect のカスタム形式ファイル

テスト中のシステムが DevTest がデフォルトでサポートするものとは異なる要求ヘッダを使用する場合は、レコーディングの前に以下の手順に従います。

DevTest プロジェクトの Data フォルダに、<custom-format>.format ファイルを作成します。

テキストエディタでファイルを編集し、以下のテキストを追加します。 RequestUserHeader 領域でフィールド定義を指定します。

#-------------------------------------------------------------------------------------
# The IMS™ request message (IRM) header contains a 28-byte fixed-format
# section that is common to all messages from all IMS Connect client applications
# that communicate with IMS TM.
#-------------------------------------------------------------------------------------
RequestHeaderCommon {
    LLLL                        int;                    #total message length IRM + user data
    IRMFixedHeader {
        LL                      short;                  #IRM_LEN, total length of the header segment including user header portion
        ZZ                      byte;                   #IRM_ARCH
        Flag0                   byte;                   #IRM_F0
        UserExitId              string(8);              #IRM_ID
        NakReasonCode           byte(2);                #IRM_NAK_RSNCDE
        Reserved1               byte(2);                #IRM_RES1
        MessageType             byte;                   #IRM_MessageType
        WaitTime                byte;                   #IRM_TIMER
        SocketConnectionType    byte;                   #IRM_SOCT
        EncodingSchema          byte;                   #IRM_ES
        ClientId                byte(8);                #IRM_CLIENTID
    }
}

#-------------------------------------------------------------------------------------
# Format of user portion of IRM some custom header
#
# Following the 4-byte length field and the 28-byte fixed portion of the
# IMS™ request message (IRM) header in IMS Connect client input messages,
# user-written client applications can include a user-defined section in the IRM.
#
#-------------------------------------------------------------------------------------
RequestUserHeader {                   
    MyFlag1                       byte;
    MyFlag2                       byte;
    MyFlag3                       byte;
    MyFlag4                       byte;
    TransactionCode             string(8);
    DestinationId               string(8);
    LogicalTerminal             string(8);
    Miscellaneous               byte(20);
}

#-------------------------------------------------------------------------------------
# Format of data segments of request message
#-------------------------------------------------------------------------------------
RequestPayloadSegment  {
        LL                      short;
        ZZ                      byte(2);
        Data                    byte(LL:inclusive);
}

#-------------------------------------------------------------------------------------
# Format of header for response message. Some responses will have it, some won't
#-------------------------------------------------------------------------------------
ResponseMessageHeader {
        LLLL                    int;                   # followed by multiple ResponsePayloadSegment
}

#-------------------------------------------------------------------------------------
# Format of data segments of request message
#-------------------------------------------------------------------------------------
ResponsePayloadSegment {
        LL                      short;
        ZZ                      byte(2);
        Data                    byte(LL:inclusive);
}

ファイルを作成して Data フォルダに保存すると、レコーダの［IMS 形式ファイル］フィールドに表示されます。デフォルト以外の要求ヘッダを使用するアプリケーションの形式ファイルを選択できます。

IMS Connect サービス イメージの記録

IMS Connect サービスイメージの記録