Hitachi System Information Capture リファレンス

3021-3-732-40

前書き

著作権

All Rights Reserved. Copyright (C) 2015, 2019, Hitachi, Ltd.

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI、Cosminexus、HiRDB、JP1、OpenTP1、およびuCosminexusは、株式会社 日立製作所の商標または登録商標です。

Linux(R) is the registered trademark of Linus Torvalds in the U.S. and other countries.

Linux(R)は、米国およびその他の国におけるLinus Torvalds氏の登録商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

MicrosoftおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Microsoft .NET は，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

Red Hat, and Red Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the United States and other countries.

Red Hat，およびRed Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

その他記載の会社名、製品名などは、それぞれの会社の商標もしくは登録商標です。

マイクロソフト製品のスクリーンショットの使用について

マイクロソフト製品のスクリーンショットは、マイクロソフトの許可を得て使用しています。

発行

2019年3月

はじめに

このマニュアルは、Hitachi System Information Captureの機能と使い方について説明したものです。

対象製品

P-9W65-3121 Hitachi System Information Capture 02-13（適用OS：Red Hat Enterprise Linux Server 6 (64-bit x86_64)、Red Hat Enterprise Linux Server 7 (64-bit x86_64)）

P-2C65-3124 Hitachi System Information Capture 02-13（適用OS：Windows Server 2008 R2 Standard (x64)、Windows Server 2012 R2 Standard (x64)、Windows 7 Professional (x64)、Windows 8.1 Pro(x64)、Windows 10 Pro(x64)）

対象読者

Hitachi System Information Captureを利用して、システムを構築するシステム開発者、そのシステムのアプリケーション開発者、およびシステムの運用者を対象としています。対象読者の前提知識として必要な知識を次に示します。

システムの機能・非機能要件

周辺環境（DB、ネットワーク、ジョブ管理など）および標準仕様に関する知識

システム開発環境・言語の知識

関連マニュアル

このマニュアルに関連するマニュアルの名称と表記を次の表に示します。

表記

正式名称

資料番号

Hitachi System Information Capture 基本ガイド

Hitachi System Information Capture 基本ガイド

3021-3-731

Hitachi System Information Capture - Visualizer 基本ガイド

Hitachi System Information Capture - Visualizer 基本ガイド

3021-3-733

Hitachi System Information Capture - Visualizer リファレンス

Hitachi System Information Capture - Visualizer リファレンス

3021-3-734

Hitachi System Information Capture システム分析支援リアルタイムモニタ

Hitachi System Information Capture システム分析支援リアルタイムモニタ

3021-3-737

OpenTP1 解説

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 解説

3000-3-D50

COBOL2002 操作ガイド

COBOL2002 操作ガイド

3021-3-601

このマニュアルでの表記

このマニュアルでは，製品名と機能名を次のように表記しています。

表記

製品名と機能名

Excel

Microsoft Office Excel

HSIC

Hitachi System Information Capture

Linux

Red Hat Enterprise Linux Server 6

Red Hat(R) Enterprise Linux(R) Server 6（64-bit x86_64）

Red Hat Enterprise Linux Server 7

Red Hat(R) Enterprise Linux(R) Server 7 (64-bit x86_64)

TP1製品

TP1/SB

TP1/Server Base

uCosminexus TP1/Server Base

TP1/EE

TP1/Server Base Enterprise Option

uCosminexus TP1/Server Base Enterprise Option

TP1/Client

TP1/Client/J

uCosminexus TP1/Client/J

TP1/Client/P

uCosminexus TP1/Client/P

TP1/Client/W

uCosminexus TP1/Client/W

Windows

Windows Server 2008 R2 Standard (x64)

Microsoft Windows Server 2008 R2 Standard (x64) 日本語版

Windows Server 2012 R2 Standard (x64)

Microsoft Windows Server 2012 R2 Standard 日本語版

Windows 7 Professional (x64)

Microsoft Windows 7 Professional 日本語版（64ビット版）

Windows 8.1 Pro(x64)

Windows 8.1 Pro 日本語版（64ビット版）

Windows 10 Pro(x64)

Windows 10 Pro 日本語版（64ビット版）

英略語

このマニュアルで使用している英略語を次に示します。

英略語

英字での表記

ACL

Access Control List

API

Application Programming Interface

ASCII

American Standard Code for Information Interchange

CORBA

Common Object Request Broker Architecture

CPU

Central Processing Unit

CR

Carriage Return

CSV

Comma Separated Value

EL

Expression Language

EUC

Extended UNIX Code

FTP

File Transfer Protocol

HTTP

Hyper Text Transfer Protocol

I/O

Input/Output

ID

Identifier

IIOP

Internet Inter-ORB Protocol

IP

Internet Protocol

JDBC

Java Database Connectivity

JDBC™

LAN

Local Area Network

LF

Line Feed

NFS

Network File System

NIC

Network Interface Card

OS

Operating System

RPC

Remote Procedure Call

SOAP

Simple Object Access Protocol

SPP

Service Providing Program

SUP

Service Using Program

TCP

Transmission Control Protocol

TPS

Transactions Per Second

UAP

User Application Program

UCS

Universal multi-octet coded Character Set

UDP

User Datagram Protocol

UOC

User Own Coding

UTC

Universal Time Coordinated

UTF-8

8-bit UCS Transformation Format

OSがWindowsの場合の説明

このマニュアルで説明する機能は、適用のOSの種類（WindowsまたはLinux）によって、異なる場合があります。OSによって機能差がある場合、OS名を明記しています。

OSがWindowsの場合には、特に断りのないかぎり、次の表のとおりに説明を読み替えてください。

OSがWindowsの場合の説明の読み替え

項目

このマニュアルでの説明

読み替え後の説明

環境変数

$環境変数名

%環境変数名%

LANG

HSIC_LANG

メッセージログの出力先

syslog

イベントビューア

ファイル拡張子

.so

.dll

インストールディレクトリ

/opt/HSIC

インストール時に指定したディレクトリ

コマンド

psコマンド

タスクマネージャー

killコマンド

コマンドの形式

コマンド名

コマンドのファイル名、またはコマンド名

テスト識別子の構成要素

1～31文字の識別子

1～31文字の英大識別子

PATH環境変数の区切り文字

:（コロン）

;（セミコロン）

パス※中の文字

/（スラッシュ）

¥（円記号）

パス※の指定先の呼び方

ディレクトリ

フォルダ

アクセス権限

スーパーユーザー

Administratorsグループに属するユーザ

※：OSがLinuxの場合、絶対パスはルートディレクトリからの指定です（例：/tmp）。OSがWindowsの場合、ルートディレクトリの先頭にドライブ名を付加した状態で絶対パスを指定する必要があります（例：C:/tmp）。

時刻の精度について

OSがWindowsの場合、ミリ秒精度のタイマ監視を実行時に、約15ミリ秒の誤差が発生することがあります。また、ミリ秒またはマイクロ秒単位での時刻表示または経過時間表示でも、約15ミリ秒の誤差が発生することがあります。なお、マイクロ秒の出力項目には、必ず0が表示されます。

ディスクリプタ数の上限

1つのHSICプロセスが使用できるディスクリプタは、最大16,384個です。最大値より多い数のディスクリプタを使用すると、HSICプロセスがプロセスダウンすることがあります。

このマニュアルで使用するKB（キロバイト）などの単位表記

1KB（キロバイト）、1MB（メガバイト）、1GB（ギガバイト）、1TB（テラバイト）はそれぞれ1,024バイト、1,024²バイト、1,024³バイト、1,024⁴バイトです。

1　システム検証支援基盤の機能

システム検証支援基盤の機能について説明します。

1.1　システムテスト支援とは

Hitachi System Information Capture（システム検証支援）のシステムテスト支援機能の概要を説明します。

システムテスト支援は本番環境の外部システム、既存システム間の電文（パケット）をネットワークスイッチからミラーポートを経由して取得（キャプチャ）し、プロトコル電文に組み立てテスト対象システムへ送信します。

また、取得した電文情報をファイルに蓄積（蓄積ファイル）することもできます。

蓄積ファイルに蓄積した情報は、システムテスト支援の入力情報として読み込みテスト対象システムへ送信することもできます。

ミラーポート経由で取得する情報は、要求電文のみではなく、応答電文情報も取得します。

取得した応答電文は、テスト対象システムからの応答電文と比較し、結果情報（エラー情報）をファイルに蓄積し、テスト実施後、結果を確認することができます。

システムテスト支援は本番環境の電文を使用して、テスト対象システムのテストを行います。

本番環境の電文を使うことで信頼性の高いテストが容易に行うことができます。

図1‒1　システムテスト支援の機能概要

1.2　パケットキャプチャによるテスト対象システムへの電文転送

パケットキャプチャとは、ネットワーク上で送受信される電文を、パケット単位でキャプチャする事です。システムテスト支援では、パケットキャプチャ技術により、外部システムと既存システム間で送受信される電文をキャプチャし、テスト対象システムへの電文転送を行います。

1.2.1　パケットキャプチャの構成

パケットキャプチャを行う場合、外部システムと既存システム間のネットワークを、ポートミラーリング機能を実装したネットワークスイッチで接続します。システム間で送受信されるパケットは、ポートミラーリング機能により、システムテスト支援の稼働するマシンにコピーされます。システムテスト支援では、コピーされたパケットを、RAWソケットを使用してキャプチャします。

ポートミラーリング機能の設定では、外部システム側に接続されており、かつ、キャプチャ対象のパケットが流れる全ポートを、ミラーポートへのコピー元として指定します。既存システム側に接続されているポートを指定すると、テスト二重実行等の不具合が発生する為、指定しないでください。

また、VLANを構成したネットワークにおいて、トランキングプロトコルとしてIEEE802.1Qを使用しているパケットがキャプチャできます。ポートミラーリング機能の設定方法については、使用するネットワークスイッチのマニュアルを参照してください。

図1‒2　パケットキャプチャの構成

1.2.2　パケットキャプチャの対象

パケットキャプチャでは、ミラーポートと接続しているネットワークインタフェース名（イーサネットの場合はeth1等）をシステム定義capture_network_interfaceの-i name、既存システム側のキャプチャ対象IPアドレス範囲（最小と最大）をシステム定義capture_definitionの-f ipaddrで指定します。パケットキャプチャでは、システム定義capture_definitionの-f ipaddrで指定されたIPアドレス範囲をキャプチャします。IPアドレス範囲内にテスト対象外のIPアドレスが含まれる場合、キャプチャ後にパケットを破棄します。キャプチャ性能の向上やCPU負荷の軽減の為、IPアドレス範囲は、既存システムのテスト対象が含まれる最低限の範囲にする事を推奨します。

システム定義の詳細は、「3.4　パケットキャプチャ関連定義」を参照してください。

以下に、パケットキャプチャ対象の選択例を示します。

外部システムのパケットは、ミラーポートを経由し、システムテスト支援稼働マシンのネットワークインタフェース名「eth1」に到達します。システムテスト支援では、「eth1」から、送信先IPアドレス、又は、送信元IPアドレスが、「172.17.2.5」〜「172.19.4.21」のパケットをキャプチャします。

「172.17.2.5」〜「172.19.4.21」以外のパケットについては、OSレベルで破棄します。

図1‒3　パケットキャプチャの対象

1.2.3　パケットロスト

外部システムと既存システム間のパケット、又は、ネットワークスイッチとシステムテスト支援間のミラーパケットが、何らかの理由により失われる事をパケットロストと呼びます。パケットロストが発生した場合、システムテスト支援の動作に不具合が発生する可能性があります。

トランスポートプロトコルがTCPの場合パケットロストの発生箇所によっては、ロストしたパケットが再送される為、パケットキャプチャでは、パケットの再送待ちを行います。しかし、再送されない、又は、再送パケットが再度ロストする場合もある為、パケットロストを極力減らす必要があります。

以下に、パケットロストが発生するポイントを示します。

図1‒4　パケットロストの発生箇所

パケットロストは、システムテスト支援終了時のKFSE84402-Iメッセージ、及びKFSE84403-Iメッセージにより知ることができます。

KFSE84402-Iメッセージ

図1-4　パケットロストの発生箇所の1.、2.、3.のいずれかでロストが発生している場合、KFSE84402-Iメッセージのロスト数が、0を超える値となる場合があります。

KFSE84403-Iメッセージ

図 1-4　パケットロストの発生箇所の3.でロストが発生している場合、KFSE84402-Iメッセージのドロップパケット数が0を超える値となります。

また、図1-4　パケットロストの発生箇所の3.でロストが発生している場合、Linuxのifconfigコマンド、またはethtoolコマンドでも知ることができます。

以下に、パケットロスト要因と対処方法を示します。

表1‒1　パケットロスト要因と対処方法

パケットロスト

ポイント

パケットロスト要因

対処方法

1.

外部システムと既存システム間のケーブルや中継継器（スイッチ等）上でパケットロスト

高負荷に耐えられる回線や中継器に切替えてください。

なお、パケットロストした場合、外部システムと既存システム間でパケット再送が行われます。

パケットロスト（＝パケット再送）が発生したか否かは、該当マシンの通信系コマンド（netstat等）で確認できます。

2.

受信パケットのミラーポートへのコピー処理でパケットロスト

ミラーリング設定を見直し、コピー元ポートを減らす、バッファサイズを増やす、高性能のネットワークスイッチに変更する等の対処を行ってください。ネットワークスイッチの設定については、使用しているネットワークスイッチのマニュアルを参照してください。

3.

受信ミラーパケットのハードウェアの受信処理でロスト、または、RAWソケット用バッファへのコピー処理でロスト

キャプチャ性能を超えてミラーパケットを受信しました。

以下の対処を行ってください。

capture_definitionの-f ipaddr定義値を見直し、不要なIPアドレスがキャプチャ対象に含まれる場合は、そのIPアドレスを範囲外にする

カーネルパラメタ「net.core.rmem_max」の値が、20971520以上の値か確認する。

1.2.4　pcap形式ファイルからのパケットキャプチャ

スイッチングハブのポートミラーリング機能が使用できない等、システムテスト支援がパケットキャプチャできない構成の場合、OS標準、又はフリーソフトとして提供されているパケットキャプチャコマンド（tcpdumpコマンド等）が作成するpcap形式ファイルからパケットをキャプチャし、システムテスト支援を実行することができます。

外部システムや既存システムのマシン上で、テスト対象パケットの通信で使用するネットワークインタフェースに対してパケットキャプチャコマンドを実行し、テスト対象のパケットが格納されたpcap形式のファイルを作成します。ここで作成したpcap形式ファイルを、ftpコマンドや電子媒体等を使用してシステムテスト支援の稼働マシン上へ転送します。

システムテスト支援は、このpcap形式ファイルからパケットをキャプチャし、テスト対象システムへの電文転送を行います。なお、OpenTP1のRPCプロトコルを使用する場合ノード間負荷バランス機能により、既存システム内のサーバ間でRPC要求用パケットが転送されます。その場合、既存システム側でpcap形式ファイルを作成すると、テスト二重実行等の不具合が発生する可能性があります。その為、ノード間負荷バランス機能を使用する構成では、外部システム側でpcap形式ファイルを作成する事を推奨します。

図1‒5　pcap 形式ファイル使用時の構成

1.3　システムテスト支援の実行方式

システムテスト支援では、以下の実行方式を行うことが出来ます。

並行実行方式

本番環境から取得した情報をプロトコル電文に組立、即時テスト対象システムへ送信する

蓄積実行方式

本番環境から取得した情報をプロトコル電文に組立、ファイルに蓄積する

リプレイ実行方式

蓄積実行でファイルに蓄積したプロトコル電文を任意のタイミングでテスト対象システムへ送信する

PCAP実行方式

本番環境の既存システム側で取得したpcap形式ファイルのパケットをプロトコル電文に組立、任意のタイミングでテスト対象システムへ送信する

同一プロセス内で同時に実行可能な実行方式の組合せを以下に示します。

表1‒2　実行方式の組合せ

—

並行実行

蓄積実行

リプレイ実行

PCAP実行

並行実行

—

○

×

×

蓄積実行

○

—

×

×

リプレイ実行

×

×

—

×

PCAP実行

×

×

×

—

凡例

○…同時実行可

×…同時実行不可

同一プロセスで2つ以上の実行形態でシステム起動をする場合、蓄積実行で開始し、後に並行実行を追加する等各形態の起動タイミングを変更することができます。

以降に各実行方式の概要について説明します。

1.3.1　並行実行

並行実行方式は本番環境から取得した情報をプロトコル電文に組立、組み立てたプロトコル電文を即時にテスト対象システムへ送信する実行方式です。

外部システムからの要求電文、および既存システムからの応答電文のパケットをキャプチャします。

キャプチャしたパケットをそれぞれ要求電文、応答電文に組立て要求電文をテスト対象システムへ送信し応答を待ち合わせます。

テスト対象システムから応答電文を受信すると既存システムからの応答電文と内容を比較し内容に相違がある場合は履歴を保存します。テスト終了後、応答電文の相違内容を確認することが出来ます。

以下に外部システムからの電文をテスト対象システムに送信し応答を受信する概要を示します。

図1‒6　並行実行を行った場合の概要

1.3.2　蓄積実行

蓄積実行は本番環境から取得した情報をプロトコル電文に組立、組み立てたプロトコル電文をファイルに蓄積する実行方式です。

並行実行と同様に外部システムからの要求電文、および既存システムからの応答電文のパケットをキャプチャします。

キャプチャしたパケットをそれぞれ要求電文、応答電文に組立て電文をファイルに蓄積する実行方式です。要求電文と応答電文は異なるファイルに蓄積します。

この電文を蓄積したファイルはリプレイ実行時の入力情報となります。

以下に外部システムからの電文を蓄積ファイルに蓄積する概要を示します。

図1‒7　蓄積実行を行った場合の概要

1.3.3　並行実行と蓄積実行の同時実行

並行実行と蓄積実行の同時実行は本番環境から取得した情報をプロトコル電文に組立、プロトコル電文をファイルに蓄積すると同時にテスト対象システムへ送信する実行方式です。

外部システムからの要求電文、および既存システムからの応答電文のパケットをキャプチャします。

キャプチャしたパケットをそれぞれ要求電文、応答電文に組立て要求電文をファイルに蓄積すると同時にテスト対象システムへ送信し応答を待ち合わせます。

テスト対象システムからの応答電文と既存システムからの応答電文と内容を比較し内容に相違がある場合は履歴を保存します。テスト終了後、応答電文の相違内容を確認することが出来ます。

以下に外部システムからの電文をテスト対象システムに送信し応答を受信する概要を示します。

図1‒8　並行実行と蓄積実行の同時実行を行った場合の概要

1.3.4　リプレイ実行

蓄積実行でファイルに蓄積したプロトコル電文を任意のタイミングでテスト対象システムへ送信する実行方式です。

蓄積ファイルから要求電文と応答電文を読み込み、要求電文をテスト対象システムへ送信します。

並行実行と同様に、テスト対象システムから応答電文受信を受信すると蓄積ファイルの応答電文と内容を比較し内容に相違がある場合は比較エラー情報ファイルに履歴を保存します。テスト終了後、応答電文の相違内容を確認することが出来ます。

図1‒9　リプレイ実行を行った場合の概要

要求電文ファイルとそれに対する応答電文蓄積ファイルの確認

リプレイ実行開始時、リプレイ実行の対象となる蓄積ファイル（要求電文ファイルとそれに対する応答電文蓄積）の確認を行います。対象となる蓄積ファイルが無いときは、KFSE60914-Eメッセージを出力してシステムテスト支援は異常終了します。

テスト対象範囲の確認

esstartコマンド、またはシステム定義（target_time –t）でテスト対象範囲の指定があったときは、テスト対象範囲の時刻内に取得した蓄積ファイルがあるか確認を行います。リプレイ実行の対象となる電文がないときは、KFSE50911-Eメッセージを出力し、システムテスト支援を終了します。

ただし、蓄積ファイルに対象の電文情報が1件も無い、または蓄積ファイルに終了情報が無い場合（※）はKFSE50911-Eメッセージは出力しません。

※：前回の蓄積実行時にファイル障害等により終了情報が無い場合

注意事項

蓄積実行時にスワップにより複数面の蓄積ファイルを取得したときは、全ての蓄積ファイルをリプレイ実行の対象としてください。一部の蓄積ファイルのみでリプレイ実行を行うとタイムアウトが多発し、システムテスト支援が終了するまでに時間がかかる場合があります。

複数回の蓄積実行により取得した同じ時刻帯の蓄積ファイルを入力とする場合、または蓄積ファイル編集ユーティリティで作成した同じ時刻帯の蓄積ファイルを入力とする場合、リプレイ実行を行うことはできません。

1.3.5　PCAP実行

PCAP実行方式は本番環境の既存システム側で取得したpcap形式ファイルのパケットをプロトコル電文に組立、任意のタイミングでテスト対象システムへ送信する実行方式です。pcap形式ファイルからパケットを読み込み、要求電文をテスト対象システムへ送信します。

並行実行と同様に、テスト対象システムから応答電文受信を受信するとpcap形式ファイルの応答電文と内容を比較し内容に相違がある場合は比較エラー情報ファイルに履歴を保存します。テスト終了後、応答電文の相違内容を確認することが出来ます。

図1‒10　PCAP 実行を行った場合の概要

システムテスト支援の定義方法

キャプチャ対象の各マシン上で作成したpcap形式ファイルを格納したディレクトリ名をcapture_network_interfaceの-i pcapdirオペランド、既存システム側のキャプチャ対象IPアドレス範囲（最小と最大）をcapture_definitionの-f ipaddrオペランドで指定します。

なお、指定したIPアドレス範囲はキャプチャしたパケットが既存システム向けか、外部システム向けかの判定にも使用します。その為、必ず既存システム側のIPアドレス範囲を指定してください。

外部システム側のIPアドレスを指定した場合は、電文転送が正常に行えません。

システムテスト支援では、pcap形式ファイルから読み出したパケットを即時に処理する為、テスト対象システムへのトラフィックが実際の業務時のトラフィックより大きくなる場合があります。

トラフィックを制御したい場合は、reply_send_modeオペランドにより電文送信方法を指定してください。以下に、pcap形式ファイル使用時の定義例を示します。

図1‒11　pcap 形式ファイル使用時の定義イメージ

複数のpcap形式ファイルのシリアライズ

システムテスト支援ではpcap形式ファイルが複数指定された場合、各pcap形式ファイルを同時に読み込み、キャプチャ時刻（マイクロ秒精度）の順にシリアライズして処理します。これにより、キャプチャコマンド実行時のパケット通信と同じ順番でシステムテスト支援でもパケットを処理できます。なお、キャプチャ時刻が完全に一致するパケットは、システムテスト支援のpcap形式ファイルの定義順にパケットを処理します。

図1‒12　パケットのシリアライズ

キャプチャ時刻は、キャプチャコマンド実行マシンのマシン時刻となります。その為、複数マシン上で取得したpcap形式ファイルを使用し、かつ、マシン間で時刻差異がある場合はキャプチャコマンド実行時のパケット通信と異なる順番でシステムテスト支援がパケットを処理する可能性があります。また、複数のpcap形式ファイル間で同一パケットが存在する場合、通常は重複パケットを破棄しますが、時刻差異が大きい場合は不当にパケットを破棄する可能性があります。したがって、マシン間の時刻差異が極力小さい状態で、pcap形式ファイルを作成する事を推奨します。

1.3.6　pcap形式ファイル

pcap形式ファイルはOS標準、又はフリーソフトとして提供されているパケットキャプチャコマンドを使用して作成してください。パケットキャプチャコマンドの詳細については、パケットキャプチャコマンドのマニュアル等を参照してください。

以下に、システムテスト支援で使用するpcap形式ファイル作成時の注意事項を示します。

サポートするpcap形式ファイル

システムテスト支援は、「バージョン2.4」のpcap形式ファイルのみサポートしています。

それ以外のpcap形式ファイルを指定した場合、KFSE44407-Wメッセージを出力して該当ファイルを対象外にします。パケットキャプチャコマンドの作成したキャプチャファイルが、pcap形式ファイルのバージョン2.4以外の場合は、変換ツール等で変換してください。

pcap形式ファイルのバージョン2.4であればシステムテスト支援稼働マシンと異なるプラットフォームで作成したpcap形式ファイルも使用可能です。

パケットキャプチャ時のデータサイズ

パケットキャプチャコマンドは、コマンド引数等で各パケットの上限サイズを指定します。上限サイズが小さい場合、システムテスト支援がパケットロストと判断する為、上限サイズは最大値を指定してください。

パケットのフィルタリング

キャプチャしたパケット数が多い場合、pcap形式ファイルへのファイル出力量が増加しファイルサイズ肥大化やファイルIO遅延によるパケットロストの可能性があります。また、pcap形式ファイル内にテスト対象外パケットが含まれている場合、システムテスト支援で無駄なファイルIOやパケット破棄が発生し性能遅延となります。その為、パケットキャプチャコマンドのフィルタリング機能を使用し、以下の条件に合致するパケットのみキャプチャする事を推奨します。

テスト対象プロトコルが必要とするトランスポートプロトコル

テスト対象プロトコルが必要とするトランスポートプロトコルを以下に示します。

必要なトランスポートプロトコルが複数の場合は、複数のトランスポートプロトコルをキャプチャ対象としてください。

テスト対象プロトコル

トランスポートプロトコル

UDPスルー

UDP

上記以外

TCP

送信元又は送信先IPアドレスが、既存システムのテスト対象のIPアドレス

送信元又は送信先ポート番号が、既存システムのテスト対象のポート番号

pcap形式ファイルの最大数

システムテスト支援が対応するpcap形式ファイル数は最大512ファイルです。その為、パケットキャプチャコマンドは作成されるpcap形式ファイル数が512以下になるように取得箇所や分割サイズ等を考慮して実行してください。

以下に、tcpdumpコマンドを使用してパケットキャプチャする場合の実行例を示します。

［条件］

パケット送受信に使用するネットワークインタフェース名：「eth1」

既存システムの対象IPアドレス：「172.17.2.5〜172.17.2.21」

既存システムの対象ポート番号：「5000、30000〜60000」

取得データサイズ：65535

出力先のpcap形式ファイル：capfile

テスト対象プロトコルが必要とするトランスポートプロトコル：TCP

［コマンド実行形式］

# tcpdump -i eth1 -s 65535 tcp and net 172.17.2 mask 255.255.255.0 and portrange
5000-60000 -w capfile

マシン時刻

pcap形式ファイルにキャプチャ中にマシン時刻を変更した場合、当該pcap形式ファイルを使用してシステムテスト支援を実行した場合、以下が発生する。そのため、マシン時刻は変更しないこと。

時刻を進めた場合

順番通りにパケットが処理されないことがあります。

また、パケットが不当にタイムアウトすることがあります。

時刻を戻した場合

順番通りにパケットが処理されないことがあります。

また、パケットのタイムアウトが遅れることがあります。

1.4　システムテスト支援の処理の詳細

1.4.1　テスト対象システムへの送信先の決定

並行実行、リプレイ実行およびPCAP実行を行う場合、テスト対象システムへの送信先を決定するためシステム定義において本番環境とテスト環境の送信先の対応付けを行う必要があります。

本番環境とテスト環境の括り付けを「送信先対応付け定義」と言います。

送信先対応付け定義では既存システムの受信IPアドレス、ポート番号とテスト対象システムの受信IPアドレス、ポート番号を指定します。システム定義の詳細は「3.5　サーバ関連定義」を参照してください。

以下に既存システムのIPアドレス（172.17.2.5）ポート番号（20001）向けの電文を、テスト対象システムのIPアドレス（173.27.12.5）ポート番号（30001）に送信する並行実行イメージを以下に示します。

図1‒13　送信先対応付け定義概要

リプレイ実行およびPCAP実行の場合も同様です。

蓄積ファイルやpcap形式ファイルには、プロトコル電文と共に本番環境での送信先IPアドレス、ポート番号が格納されています。リプレイ実行時・PCAP実行時も、本番環境でのIPアドレス、ポート番号を送信先対応付け定義に設定する必要があります。

キャプチャ対象のIPアドレスをシステムテスト支援のシステム定義で指定してあっても、送信先対応付けが未定義の要求電文を取得した場合は、送信先不明電文として該当電文を破棄します。

図1‒14　送信先対応付け未定義の場合

システム定義とキャプチャ範囲

システムテスト支援のシステム定義とキャプチャする範囲の関係を以下に示します。

キャプチャする範囲を定義するパラメタは

パケットキャプチャに関する定義：capture_definition

送信先対応付け定義：address_destination

です。

パケットキャプチャに関する定義については、「3.4.1　パケットキャプチャに関する定義（capture_definition）」を、送信先対応付け定義については、通信プロトコル種別に合わせて次のどれかを参照してください。

「3.5.1　送信先対応付け定義（address_destination／RPC・RAPの場合）」

「3.5.2　送信先対応付け定義（address_destination／TCPスルーのクライアントの場合）」

「3.5.3　送信先対応付け定義（address_destination／TCPスルーのサーバの場合）」

「3.5.4　送信先対応付け定義（address_destination／UDPスルーの場合）」

「3.5.5　送信先対応付け定義（address_destination／HTTPの場合）」

「3.5.6　送信先対応付け定義（address_destination／IIOPの場合）」

各パラメタの設定方法を以下に示します。

図1‒15　パケットキャプチャの設定方法

図1-15に示すようなシステム定義を行った場合のパケットキャプチャ範囲のイメージを以下に示します。

図1‒16　パケットキャプチャ範囲（1）

address_destination定義は、capture_definition定義で指定した範囲内のIPアドレスを定義してください。capture_definition定義範囲以外の場合、キャプチャ対象とはなりません。

以下にaddress_destination定義がキャプチャ対象外となる例を示します。

図1‒17　パケットキャプチャ範囲（2）

1.4.2　起動時のコネクション確立待ち合わせ（リプレイ実行・PCAP実行時）

システムテスト支援をTCPスルーでサーバ型コネクションを定義（address_destination定義の-kオプションcnmodeフラグメンバに"server"を指定）し、リプレイ実行またはPCAP実行で起動した場合、起動時に全てのサーバ型コネクションが確立されるまでテスト開始を待ち合わせます。

定義に指定された全サーバ型コネクションのIP／ポート番号に対して、それぞれコネクションが確立されている状態になるとテストが開始されます。システムテスト支援起動から10分経過してもコネクション確立が確認できない場合、システムテスト支援を終了します。

全てのコネクションが確立されるまで、未確立コネクションがある旨のメッセージ（KFSE83403-I）を約30秒間隔で出力します。

図1‒18　送信先対応付け定義概要

1.4.3　テスト対象システムからの応答電文待ち合わせ（RPC・RAP）

RPC・RAPにおいて同期応答要求電文送信時、テスト対象システムからの応答電文待ち合わせを行います。

外部システムからの要求電文を取得、テスト対象システムへ送信しテスト対象システムからの応答電文を受信する前に、既存システムからの応答電文、および外部システムからの次の要求電文を取得した場合でも、テスト対象システムからの応答電文を受信するまで、次の要求電文はシステムテスト支援内で保留します。

テスト対象システムからの応答電文を受信後、保留してあった次の要求電文をテスト対象システムへ送信します。

図1‒19　応答電文受信待ち合わせ概要

1.4.4　電文のシリアライズ処理

クライアント単位でのシリアライズ処理

システムテスト支援はマルチスレッドでパラレルに処理します。

クライアント毎にシリアライズ処理し、クライアントが別の場合はパラレルに処理します。

よって送受信日時が遅い電文であっても別クライアントであれば先に送信されることがあります。

但し、同一クライアントからの要求はシリアライズ処理します。

図1‒20　クライアント単位でのシリアライズ処理概要

全クライアントのシリアライズ処理

システムテスト支援には、送信元のクライアント、プロトコルに関係なく、テスト対象システム（サーバ）への要求をシリアライズして送信することも出来ます。

全電文を受信順にシリアライズしてテスト対象システムへ送信したい場合、シリアル実行してください。シリアル実行したい場合、システム定義（クライアント関連定義（client_definition））で実行処理タイプ（-q schedule_type）をシリアル実行としてください。

図1‒21　全クライアントでのシリアライズ処理概要

1.4.5　電文のフィルタリング

パケットキャプチャ時、リプレイ時にどの電文を入力対象とするかを指定することが出来ます。

それをフィルタリングと言います。

本番環境では電文全てがネットワークスイッチを経由して送受信されていますが、特定のクライアントまたはサーバとの送受信のみを入力情報としてシステムテスト支援に入力し、テスト対象システムへの送信や、ファイルへの蓄積を行うことが出来ます。

フィルタリングには入力時刻指定、サービスグループ／サービス名、ノード識別子、クライアント側IPアドレス、サーバ側IPアドレスなどで行うことが出来ます。

フィルタリングの設定はシステム定義を行う事で行われます。システム定義の詳細は「3.10　フィルタ関連定義」を参照してください。

また、UOCを作成することで入力電文をユーザ任意にフィルタリングすることも出来ます。

入力時刻指定のフィルタリングと特定のサービス入力するフィルタリング例を以下に示します。

図1‒22　パケット入力時刻指定によるフィルタリング

図1‒23　入力対象サービス指定によるフィルタリング

フィルタリングを行う電文の各実行形態による違いについて、以下に図で示します。

蓄積実行の場合

図1‒24　蓄積実行時のフィルタリングの流れ

並行実行の場合

図1‒25　並行実行時のフィルタリングの流れ

リプレイ実行の場合

図1‒26　リプレイ実行時のフィルタリングの流れ

1.4.6　クライアントの増幅

概要

電文一括増幅機能では、既存環境のRPC要求電文を複製してテスト対象システムに送信します。本機能は、プロトコル種別がRPCで、実行形態がリプレイ実行またはPCAP実行の場合だけ使用できます。RAP電文は対象外です。

表1‒3　電文一括増幅機能の概要

#

機能

概要

1

クライアント増幅

要求電文を複製し、複製元の電文と別のクライアントからの電文として追加する。

クライアント増幅

クライアント増幅は、rpc_definition定義-tオプションのexecution_countフラグメンバでクライアント増幅数を指定することで行います。

クライアント増幅で複製した電文は、それぞれが複製元の電文と異なるクライアントからの電文として扱われます。クライアント増幅の遅延時間がexecution_delay_timeフラグメンバで指定されている場合は、複製した各電文の送信間隔は、指定時間ずつずれます。

クライアント増幅の例を下図に示します。

図1‒27　クライアント増幅

複製した電文の応答

電文増幅機能の使用時は、複製した本番環境の要求電文に対応する本番環境の応答電文が存在しません。そのため、応答電文の比較機能による比較処理は行いません。

1.4.7　システムテスト支援の正常終了時の動作

以下の終了ケースで終了した場合、正常終了となります。

テスト終了コマンドを受け付けた場合

リプレイ実行時に、蓄積電文を全て送信し、テストが完了した場合

時刻フィルタ指定時、入力電文の受信時刻が終了時刻を過ぎた場合

PCAP実行時に、pcap形式ファイル内の電文を全て送信し、テストが完了した場合

システムテスト支援の正常終了時は本番環境からのパケット受信、蓄積電文の読み出し、pcap形式ファイル内の電文読み出しを終了し、受信済みの電文を処理後、システムテスト支援を終了します。

リプレイ実行時は蓄積ファイル内の全てのテスト対象電文を読み出すと終了処理を開始します。PCAP実行時はpcap形式ファイル内の全てのテスト対象電文を読み出すと終了処理を開始します（どちらも終了開始時はKFSE80021-Iメッセージで通知します）。終了処理開始後はesstopコマンドによるシステムの正常終了を受け付けません（強制終了は可能です）。

終了処理開始時に電文が滞留していた場合、滞留している電文の処理が完了するまでプロセスは終了しません。KFSE80801-Iメッセージで残り滞留電文数を通知します。

プロセスが終了するまで約30秒おきに同メッセージを出力します。

1.5　フレームワーク機能（ユーザ独自のシステムテストの支援）

1.5.1　フレームワーク機能とは

システムテスト支援では、テスト時の一連の流れ、及びテストで共通する部分をフレームワークとして提供します。ユーザは、最低限必要となる通信プロトコル固有処理（電文組立て等）のみ開発しプラグインとして登録することで、ユーザ独自プロトコルのテストを容易に行うことができます。

本機能によるテストは、以下の3フェーズから構成されます。

電文作成フェーズ

テスト準備を行うフェーズです。本番環境の電文を使用してテストする場合、本フェーズにより電文を収集します。電文を直接作成する場合は本フェーズを省略できます。

本番環境の電文をキャプチャし電文ファイルに格納します。電文ファイルはテスト実行フェーズで使用します。

図1‒28　電文作成フェーズの概要

本番環境からキャプチャしたパケットを組立て、要求電文／応答電文を作成する。

電文をテスト用に編集し、電文ファイルに格納する。

テスト実行フェーズ

実際にテストを行うフェーズです。

電文ファイル内の要求／応答電文を使用してテスト対象システムのテストを実行します。テスト方法としては、電文ファイル内の電文を格納順に順次テストする逐次実行モードと、電文ファイル内の電文をユーザが任意に選択／増幅してテストするシナリオモードがあります。

図1‒29　テスト実行フェーズの概要

電文ファイルから要求電文と応答電文（既存）を取得しテスト用電文を選択する。

取得した要求電文をテスト対象システムへ送信する。非応答型又は送信失敗時は4.を実行する。

テスト対象システムから受信したパケットを組立て、応答電文（テスト）を作成する。

要求電文と応答電文を基にテスト結果を判定し、テスト結果を結果ファイルに格納する。結果ファイルが蓄積ファイル、かつ、テスト結果が異常だった場合、エラー情報をエラー情報ファイルに出力する。

バッチ実行フェーズ

バッチ処理によるテストを行うフェーズです。

電文ファイル等は使用せず、ユーザが任意の内容でテストを実行します。

図1‒30　バッチ実行フェーズの概要

バッチ実行に必要なプラグインの初期化処理をする。

テストを実行する。

テスト終了時のプラグインの後処理をする。

1.5.2　フレームワーク機能を適用できる環境

フレームワークを適用できる環境は以下の通りです。

通信方向

要求電文はHSICからテスト対象システムに送信し、応答電文はテスト対象システムからHSICに返信します。テスト対象システムがHSICに要求電文を送信した場合、その要求電文は破棄します。また、HSICがテスト対象システムに応答電文を送信する機能はありません。

通信形態

フレームワークでは、以下の通信形態をサポートします。

同期応答型

テスト対象システムへの要求電文を送信後、その要求電文に対する応答電文を受信した後に、次の要求電文を送信する形態です。要求送信と応答受信が交互に行われます。

非同期応答型

テスト対象システムへの要求電文を送信後、その要求電文に対する応答電文を待たないで、次の要求電文を送信する形態です。要求送信と応答受信は交互に行われません。

通信プロトコルがRPCの場合だけ、この通信形態を適用できます。

非応答型

応答電文の無い通信形態です。テスト対象システムへの要求電文を送信後、即時、次の要求電文を送信します。

コネクション確立方法

HSICとテスト対象システム間のコネクションの確立方法は、通信プロトコルの種別によって異なります。

通信プロトコルごとのコネクション確立方法を次に示します。

通信プロトコル種別

コネクションの確立方法

TCP

HSICとテスト対象システム間のコネクションは、必ずHSIC側から確立します。

HTTP

IIOP

RAP

RPC（RAPを含む）

要求電文を送信するコネクションは、テスト対象システムに対してHSIC側から確立します。応答電文を受信するコネクションは、HSICに対して対象システム側から確立します。

RPCおよびRAPのサポート電文

フレームワークが対応するRPCおよびRAPの電文種別を次に示します。

表1‒4　フレームワークが対応する電文種別

電文種別

送信相手

プロトコル種別

内容

RPC電文

同期型RPC

キュー受信サーバ

RPCプロトコル

サーバからの応答を待ち合わせる、同期応答型のRPC電文。

非同期型RPC

キュー受信サーバ

サーバからの応答を待ち合わせない、非同期応答型のRPC電文。

非応答型RPC

キュー受信サーバ

サーバが応答を返さない、非応答型のRPC電文。

tact制御電文

コネクション接続先

一時クローズ電文（要求、応答、または失敗）、またはクローズ要求電文。

リモートAPI電文

コネクション制御電文

rapリスナー

rapサーバ

RAPプロトコル

rapクライアントから発行されるコネクション制御（コネクション確立、コネクション開放など）を行う電文。

API代理実行電文（同期型RPC）

rapサーバ

rpc系（同期型RPC）のAPIの代理実行電文。

API代理実行電文（非応答型RPC）

rapサーバ

rpc系（非応答型RPC）のAPIの代理実行電文。

API代理実行電文（トランザクショナルRPC）

rapサーバ

rpc系（トランザクショナルRPC）のAPIの代理実行電文。（※）

注※

トランザクションに含まれない通常のRPCとして処理されます。

1.5.3　電文ペアリング

電文形態が同期応答型電文の場合、要求電文と、それに対応する応答電文を対応付けるため、フレームワークでは電文をペアリングします。

ペアリングは次のタイミングで行います。

電文作成フェーズでの本番環境の要求／応答ペアリング

ただし、framework_definition定義の-uオプションのproduction_pairingフラグメンバの値がNの場合は、電文をペアリングしません。

テスト実行フェーズでの本番環境の要求／応答ペアリング

ただし、次のどちらかの場合は、電文をペアリングしません。

電文ファイルが蓄積ファイル、かつ、応答電文用の蓄積ファイルが指定されていない場合

framework_definition定義の-uオプションのproduction_pairingフラグメンバの値がNの場合

テスト実行フェーズでのテスト環境の要求／応答ペアリング

要求電文と応答電文で同じ値となるペアリングキーを使用してペアリングします。ペアリング処理時、同一ペアリングキー、かつ、その時点でペアリングされていない要求電文と応答電文をペアリングします。

TCPプロトコル以外の場合は、自動的にペアリングキーを作成します。

TCPプロトコルの場合は、フレームワークがデフォルトのペアリングキーを作成します。デフォルトのペアリングキーでペアリングできない場合（要求電文と応答電文が別コネクションなど）は、ユーザが電文情報プラグインでペアリングキーを編集します。

フレームワークでは、コネクションごとにユニークになるキーを生成してデフォルトのペアリングキーとします。また、テスト実行フェーズで要求電文が蓄積ファイルの場合、蓄積ファイル内の電文キーをペアリングキーとします。

ただし、次のような場合、コネクションごとにユニークなペアリングキーではペアリングができません。

要求電文と応答が別コネクション

例：1業務が複数コネクションを使用して業務を行う

要求電文と応答電文が同一コネクションだが、要求と応答が相互に送受信されていない

例：複数業務が同一コネクションを使用しており、要求と応答が混在している

このような場合、プラグインは、電文と応答で一意となる情報（メッセージ通番、タイムスタンプ、クライアントIPアドレスなど）を電文やアドレス情報から取得してペアリングキーを作成してください。

本番環境は電文情報プラグイン、テスト環境では送信電文編集プラグインおよび電文情報プラグインで作成します。

1.5.4　シリアライズ機能

テスト実行フェーズでは、テスト実行単位をクライアント識別子で指定します。このテスト実行単位で要求電文の送信、及び、テスト結果判定等のテストを行います。同一のクライアント識別子の電文はシリアライズして処理しますが、異なるクライアント識別子間の電文はパラレルに処理します。

クライアント識別子の設定方法は、実行モードによって異なります。

逐次実行モード

クライアント識別子は、プロトコル種別に応じてデフォルト値を自動的に設定します。

なお、framework_definition定義の-uオプションのipaddr_serializeフラグメンバの値にYを指定した場合、デフォルトのクライアント識別子は外部システムのIPアドレスになります。

各プロトコルのデフォルトのクライアント識別子を次に示します。

プロトコル

デフォルトのクライアント識別子

TCP

コネクション単位（外部システムのIPアドレス＋外部システムのポート番号＋既存システムのIPアドレス＋既存システムのポート番号）

HTTP

IIOP

RAP

RPC

外部システム側のIPアドレス＋ポート番号＋送信元スレッドID

デフォルトのクライアント識別子では業務の処理順序が再現できない場合は、電文情報プラグインによって、ユーザ任意のクライアント識別子を設定します。

クライアント識別子によるシリアライズの例を次に示します。

（例1）本番環境のコネクション単位でテスト実行（framework_definition定義の-uオプションのipaddr_serializeフラグメンバの値がN（デフォルト値）の場合）

本番環境のコネクションごとにユニーク値となるクライアント識別子をフレームワークが作成します。この場合、本番環境のコネクション単位にテストを実行します。本番環境のコネクション内の電文はシリアルに処理しますが、他コネクションの電文とはパラレルで処理します。

外部システムの業務が1つのコネクションで処理されていて、かつ、各業務をパラレル処理したい場合、このクライアント識別子を使用できます。

業務が複数のコネクションで処理されている場合は、このクライアント識別子では処理の実行順序が不正となり、テスト失敗と判断されるおそれがあります。

（例2）本番環境の外部システムのIPアドレス単位でテスト実行（framework_definition定義の-tオプションのipaddr_serializeフラグメンバの値がYの場合）

外部システムのIPアドレスごとにユニーク値となるクライアント識別子をフレームワークが作成します。この場合、外部システム単位にテストが実行されます。外部システムの電文はシリアルに処理されますが、他外部システムの電文とはパラレルで処理されます。

本番環境の業務が複数のコネクションで処理されている、または本番環境の複数業務をシリアルに実行したい場合、このクライアント識別子を使用できます。

（例3）ユーザ任意の単位でテスト実行（電文情報プラグインで設定する場合）

テスト単位を変更したい場合は、電文情報プラグインでクライアント識別子を設定します。

本番環境で1業務が複数コネクションを使用している場合で、テスト環境でも同様に複数コネクション間の処理順序を再現したいとき

各コネクションに共通する情報（クライアント側IPアドレス、電文内のクライアントを識別可能な情報など）をクライアント識別子に設定してください。

framework_definition定義の-tオプションのipaddr_serializeフラグメンバ値が「Y」の場合と異なり、任意のコネクション間でシリアライズできます。

本番環境で複数業務が1コネクションを共有して使用している場合で、テスト時は業務単位にシリアルに実行し、業務間ではパラレルに実行したい（他業務の影響を受けないようにしたい）とき

各業務に共通する情報（電文内の業務を識別可能な情報など）をクライアント識別子に設定してください。

シナリオ実行モード

電文選択プラグインでユーザが設定するシナリオ単位にユニークなクライアント識別子を作成し、シナリオ単位にテストを実行します。シナリオ内の電文はシリアルに実行しますが、シナリオ間の電文はパラレルに実行します。

1.5.5　プラグイン

プラグインとは、フレームワーク機能を使用したテストにおいて、ユーザ固有の処理が必要な場合に呼び出す処理のことです。各プラグインは、フレームワークから渡された情報（パケット、電文、引継ぎ情報等）を基に固有処理を行い、結果をフレームワークに返却します。フレームワークは、返却された内容をもとに処理を行います。

プラグインは省略可能で、省略した場合は各プラグインのデフォルト動作を行います。

プラグイン一覧

プラグインの一覧を下表に示します。

表1‒5　電文作成フェーズで動作するプラグイン

プラグイン種別

説明

省略時の処理

初期化終了

HSIC起動直後および終了直前に必要な処理を行います。

処理を行いません。

電文組立て※1

TCPレベルで分割されているパケットを組立て電文を復元します。

1パケット1電文として処理を行います。

電文情報

電文の要否や電文情報（ペアリングキー等）を決定します。

全電文を格納します。また、電文情報は自動生成します。

電文編集

電文ファイルに格納する電文を編集します。

電文を編集しません。

電文受信

組立済みの電文に対して前処理を行います。

前処理を行いません。

注※1：

プロトコル種別にTCPを指定した場合

表1‒6　テスト実行フェーズで動作するプラグイン

プラグイン種別

説明

省略時の処理

初期化終了

プロセス起動直後、および終了直前に必要な処理を行います。

処理を行いません。

電文組立て※1

TCPレベルで分割されているパケットを組立て電文を復元します。

1パケット1電文として処理を行います。

電文情報

電文の要否や電文情報（ペアリングキー等）を決定します。

全電文をテストします。また、電文情報は自動生成します。

電文編集

ファイルに入出力する電文を編集します。

電文を編集しません。

電文選択※2

シナリオ実行モードで使用する電文を選択します。

HSICを終了します。

電文送信

テスト対象システムへ送信する電文を編集します。

電文を編集しません。

結果判定

テスト実行結果が成功か否かを判定します。

正常と判定します。

バッチ用

バッチ処理を行います。

処理実施後は、繰り返し実行を継続するか否かを決定します。

省略できません。

注※1：

プロトコル種別にTCPを指定した場合

注※2：

シナリオ実行モードを選択した場合

引継ぎ領域

プラグイン間で情報引継ぎ用の領域として引継ぎ領域を提供します。プラグイン引数として引継ぎ領域を渡すので、各プラグインは、次プラグインへの情報引継ぎや自プラグインの次回呼び出し時への情報引継ぎ等の目的で引継ぎ領域を使用してください。

引継ぎ領域は用途毎に種類があります。各引継ぎ領域のサイズはframework_definition定義の-bオプションのtelegram_area_size、connection_area_size、client_area_sizeフラグメンバで指定し、サイズが0の場合は引継ぎ領域は使用できません。引継ぎ領域の初期状態はnull文字で初期化します。

引継ぎ領域の作成単位を下表に示します。

表1‒7　引継ぎ領域の作成単位

引継ぎ領域種別

説明

アクセス可能プラグイン

電文単位

電文毎に作成する引継ぎ領域です。

使用例：電文の解析結果等を保持

電文組立て

電文情報

電文編集

電文送信

電文受信

結果判定

コネクション単位

本番環境／テスト環境のコネクション毎に作成する引継ぎ領域です。

使用例：直前の電文内容を保持

電文組立て

電文情報

クライアント識別子単位

クライアント識別子毎に作成する引継ぎ領域です。

使用例：電文間で引き継ぐ情報（セッションID等）を保持

電文編集

電文情報※1

電文送信

電文受信

結果判定

バッチ用

注※1：

テスト対象システムからの応答電文受信時のみ

プラグイン呼び出しの流れ

各フェーズでのプラグイン呼び出しの流れを示します。

図1‒31　電文作成フェーズのプラグイン呼び出しの流れ

図1‒32　テスト実行フェーズ（逐次実行モード ）のプラグイン呼び出しの流れ

図1‒33　テスト実行フェーズ（シナリオ実行モード ）のプラグイン呼び出しの流れ

1.5.6　電文キー

電文作成フェーズでは、電文組立て完了後にフレームワークが電文キーを自動生成します。

テスト実行フェーズでは、電文ファイルがcsvファイルの場合、電文組立て完了後にフレームワークが電文キーを自動生成します。電文ファイルが蓄積ファイルの場合、蓄積ファイルに設定されている電文キーを使用します。

1.5.7　タイマ

後続パケット待ちタイマ

HTTP又はTCPの電文組立て処理において、電文を構成するパケットが不足している場合、後続パケット待ちを行います。この時、framework_definition定義の-tオプションのbuild_message_watchtimeフラグメンバが0以外の場合、指定した時間で後続パケット待ちのタイマ監視を行います。

タイマ監視中に後続パケットを受信した場合は、タイマを解除し電文組立て処理を行います。まだパケットが不足している場合は、再度、指定した時間でタイマ監視を行います。この処理を繰り返します。

タイマ監視中に後続パケットを受信しなかった場合は、当該電文の組立てを断念し、組立て中のパケットを破棄します。テスト対象システムからの電文組立て中に組立て断念した場合は、当該コネクションを解放します。

同期応答電文待ちタイマ（RPCプロトコル以外の場合）

同期応答型の要求電文をテスト対象システムへ送信後、framework_definition定義の-tオプションのreply_watchtimeフラグメンバが0以外の場合、指定した時間で同期応答電文の受信完了までのタイマ監視を行います。

タイマ監視中に応答電文の受信が完了、または、応答電文の受信待ちが解除された場合は、タイマを解除します。

タイマ監視中に応答電文の受信が完了しなかった場合は、応答電文の受信待ちを解除し、応答電文受信失敗として後続処理（テスト結果判定等）を行います。

同期応答電文待ちタイマ（RPCプロトコルの場合）

同期応答型のRPCは、電文内の制御情報としてクライアント側に設定されている応答待ち時間でタイマ監視を行います。

応答待ち時間は、rpc_watchtime定義で変更できます。

rpc_watchtime定義で指定できる応答待ち時間を次に示します。

指定値

内容

電文指定値（デフォルト）

電文に設定されている指定値を利用します。

待ち時間の範囲は0～65535（単位：秒）です。

電文中に値が設定されていない場合は、180秒と仮定します。

定義指定値（一律固定）

定義で指定した値を利用します。

設定できる範囲は0～65535（単位：秒）です。

指定する値をすべての電文で設定値として採用します。

定義指定値（閾値）

定義に指定した値を利用します。定義に指定できる値は閾値です。

指定できる範囲は、1～65535（単位：秒）です。

電文中に値が設定されていない場合は、閾値を180秒と仮定します。この場合、閾値が180より小さい場合は、その値に丸められます。

閾値以上の待ち時間が設定されている電文は、待ち時間が閾値まで丸められます。

（例）閾値に200を指定した場合

200以上の待ち時間については、201でも65535でも、すべて200に丸められます。

200以下の待ち時間については、値は丸められません。

同期応答型の要求電文をテスト対象システムへ送信後、rpc_watchtime定義に従い同期応答電文の受信完了までのタイマ監視を行います。

タイマ監視中に応答電文の受信が完了、または応答電文の受信待ちが解除（対象コネクション解放など）された場合は、タイマ監視を解除します。

タイマ監視中に応答電文の受信が完了しなかった場合は、応答電文の受信待ちを解除し、応答電文受信失敗として後続処理（テスト結果判定など）を行います。

非同期応答電文待ちタイマ（RPCプロトコルだけ）

非同期応答型の要求電文をテスト対象システムへ送信後、rpc_watchtime定義の-tオプションのwatchtimeフラグメンバが0以外の場合、指定した時間で非同期応答電文の受信完了までのタイマ監視を行います。

同期応答型と異なり、応答電文待ち中も次要求電文を処理します。ただし、該当クライアントの非同期応答電文の応答電文待ち数が1000に達した場合は、応答電文を受信するまで次の要求電文を処理しません。

タイマ監視中に応答電文の受信が完了した場合は、タイマ監視を解除します。

タイマ監視中に応答電文の受信が完了しなかった場合は、応答電文の受信待ちを解除し、応答電文受信失敗として後続処理（テスト結果判定など）を行います。

要求電文待ちタイマ

本番システムのパケットキャプチャで、要求電文と応答電文と別コネクションで送受信する場合、ミラースイッチの遅延などによって、要求電文より先に応答電文をキャプチャするおそれがあります。これを回避するため、応答電文のキャプチャから要求電文のキャプチャまで、最大5秒の待ち合わせを行います。この待ち合わせ時間内に要求電文をキャプチャできなかった場合は、応答電文を破棄します。

1.5.8　フィルタリング

RPCプロトコルの場合は、rpc_telegram_filter定義によってフィルタリングができます。

RPC以外の通信プロトコルの場合は、フレームワーク機能では時刻指定などのプロトコル共通のフィルタリング機能以外のフィルタリング機能は提供していません。

1.5.9　送信電文間隔制御

逐次実行モードでは、電文をテスト対象システムへ送信する時間間隔を、reply_send_mode定義によって指定することができます。シナリオ実行モードでは、電文選択プラグインにより送信間隔を指定する事ができます。

1.5.10　フレームワーク機能を使用した場合のHTTP要求電文の識別子書き換え

概要

Webサーバ上で割当てた識別子（HTTPクッキー）をHTTP応答電文のヘッダで通知し、以降のHTTP要求電文のヘッダに設定することがあります。この識別子はユニーク値であり、既存システムのWebサーバと、テスト対象システムのWebサーバでは、識別子の値が異なります。そのため、既存システム宛てのHTTP要求電文をキャプチャし、そのままテスト対象システムへ転送すると、テスト対象システムで識別子不正となります。

フレームワーク機能では、既存システムとテスト対象システムのHTTP応答電文のヘッダを解析し、システム間の識別子のマッピング情報を作成します。HTTP要求電文の転送時は、このマッピング情報を使用し、HTTP要求電文のヘッダに設定されている既存システムの識別子を、テスト対象システムの識別子へ書き換え、テスト対象システムへ転送します。マッピング情報が存在しない場合は、書き換え無しでテスト対象システムへ転送します。

システム検証支援基盤の正常終了時、識別子の数や書き換え回数などの統計情報を、KFSE84004-Iメッセージとして出力します。

図1‒34　HTTP要求電文の識別子書き換え

書き換え対象

書き換え対象の識別子、および書き換えに使用するHTTP電文ヘッダを以下に示します。

表1‒8　書き換え対象の識別子一覧

書き換え対象の識別子

書き換え先ヘッダ

（HTTP要求電文）

書き換え元ヘッダ

（HTTP応答電文）

HTTPクッキー

Cookie

Set-Cookie

Cookie2

Set-Cookie2

HTTPクッキー

HTTPクッキーは、WebクライアントとWebサーバ間において、セッション等の状態管理を行うメカニズムです。Webサーバは、任意の値をHTTP応答電文のset-cookieヘッダに設定して送信します。Webクライアントは、HTTP応答電文のset-cookieヘッダに設定されている値を、以降のHTTP要求電文のcookieヘッダに設定して送信します。

HTTPクッキーは、「名前=値」の形式で記述されます。「名前=値」が複数ある場合は、セミコロン（;）で区切られます。

（例）

cookie: "aaa=111 ; bbb=222 "

フレームワーク機能では、「名前=値」を識別子としてマッピング情報を管理します。名前または値が異なる場合は、別識別子としてマッピング情報を管理します。HTTP応答電文受信時、set-cookieヘッダを基に「既存システム識別子=テスト対象識別子」でマッピング情報を作成します。HTTP要求電文受信時、cookieヘッダに既存システム識別子があれば、テスト対象識別子に書き換えます。次に、書き換えイメージを示します。

図1‒35　HTTPクッキー書き換え

マッピング情報管理

マッピング情報は、既存システムのWebサーバ単位に作成します。マッピング情報増加によるメモリリソース枯渇を回避するため、Webサーバ単位に、マッピング情報の上限数管理、および有効期限管理を行います。

マッピング情報の上限数

マッピング情報の登録数を、マッピング種別（HTTPクッキー）ごとに上限管理します。登録数がframework_definition定義の-mオプションのmaxcntフラグメンバ値（デフォルト:10000）で指定した上限を超過した場合、KFSE44002-Wメッセージ出力後、書き換えに使用してから最も時間が経過したマッピング情報を削除します。なお、KFSE44002-Wメッセージを出力するのは、初回の上限超過時だけです。

マッピング情報の有効期限

最後に使用してから、framework_definition定義の-mオプションのexpiredateフラグメンバ値（デフォルト:3600秒）で指定した時間を経過したマッピング情報を削除します。

テスト開始タイミングについて

マッピング情報は、HTTP電文を基に作成します。外部システムと既存システム間のWebシステムで業務開始したあとに電文取得を開始すると、マッピング情報の基となるHTTP電文が取得できないために識別子変換が行われず、テスト対象システムで識別子不正となる可能性があります。そのため、業務開始前に、電文取得を開始することを推奨します。

1.5.11　電文増幅

電文増幅プラグインまたは定義に従って、電文ファイル内の要求電文を増幅してテストを実施します。

電文増幅の方法として、次の2つがあります。

電文追加（電文増幅プラグイン）

クライアント増幅（電文増幅プラグインまたは定義）

また、電文追加とクライアント増幅は、組み合わせて使用することもできます。

電文追加（電文増幅プラグイン）

増幅した電文を、増幅元電文と同一クライアント識別子でテストする場合は、電文を追加します。

電文増幅プラグインで電文追加が指示された場合、電文を増幅します。

増幅元の要求電文にペアとなる応答電文が存在する場合、応答電文も増幅します。

電文追加の例を次に示します。

クライアント増幅（電文増幅プラグインまたは定義）

増幅した電文を、増幅元電文と異なるクライアント識別子でテストする場合は、クライアント増幅で増幅します。

次のどちらかの場合に、クライアント増幅で電文を増幅します。

電文増幅プラグインでクライアント増幅が設定された場合

framework_definition定義の-uオプションのtest_execution_countフラグメンバに、2以上が指定された場合

増幅元の要求電文にペアとなる応答電文が存在する場合、応答電文も増幅します。

クライアントの例を次に示します。

電文追加とクライアント増幅の組み合わせ

同一クライアントで増幅した電文を、さらに増幅して別クライアントとしてテストしたい場合は、電文追加とクライアント増幅の両方を使用します。

電文追加とクライアント増幅の両方を使用する例を次に示します。

1.5.12　コネクションの管理

HSICとテスト対象システムとのコネクションの確立および解放は、フレームワークが行います。

コネクションはクライアント識別子単位に管理します。ほかのクライアント識別子のコネクションは使用しません。

複数のクライアント識別子で同一のテスト対象システムと通信をする場合、クライアント識別子分のコネクションを確立します。

管理するコネクションの種類を次に示します。

コネクションの種類

プロトコル種別

電文送受信で使用する「送受信用コネクション」

（address_destination定義の-tオプション）

すべて

電文受信でだけ使用する「受信用コネクション」

（address_destination定義の-tオプションのrcv_portnoフラグメンバ）

TCP

RPC電文受信でだけ使用する「RPC受信用コネクション」

RPCプロトコルが自動的に確立します。

RPC

負荷分散装置を使用するなどで要求電文と応答電文が別コネクションとなる場合、受信用のコネクションを定義します。この場合、送受信用コネクションで要求電文を送信し、受信用コネクションで応答電文を受信します。定義例として、要求電文をサーバ1（負荷分散装置）が受信してサーバ2またはサーバ3に振り分け、サーバ2またはサーバ3から応答電文を受信する構成を次に示します。

コネクション確立（送受信用コネクション）

次のタイミングでコネクションを確立します。

パケット送信時

テスト対象システムへの要求電文送信時にコネクションが未確立の場合、コネクションを確立します。

コネクションの確立に失敗した場合、その電文を破棄し、次の電文を処理します。

コネクション確立（受信用コネクション）

次のタイミングでコネクションを確立します。

パケット送信時

テスト対象システムへの要求電文送信時、address_destination定義の-tオプションのrcv_portnoフラグメンバが指定されていて、かつ、受信用のコネクションが未確立の場合、コネクションを確立します。

コネクション確立が失敗した場合、その電文を破棄し、次の電文を処理します。

コネクション確立（RPC受信用コネクション）

次のタイミングでコネクションを確立します。

テスト対象システムからのコネクションの確立要求受付時

テスト対象システムは、HSICに対して応答電文送信時にコネクションが未確立の場合、HSICに対してコネクションを確立します。

コネクション確立に失敗した場合、応答電文待ちタイムアウトになります。

コネクション解放

次のタイミングでコネクションを解放します。

解放後、再度コネクションの確立タイミングが発生した場合は、コネクションを再確立します。

システム効率化支援終了時

テスト対象システムとの電文送受信時で異常（システムコールエラーなど）発生

テスト対象システムからの電文受信時で後続メッセージ待ちタイムアウト発生時

コネクション解放コマンド（esipcsockcls）実行時

テスト対象システムからの一時クローズ要求電文受信時（RPCプロトコルだけ）

要求電文と応答電文を同一コネクションで送受信するプロトコルや、TCPプロトコルでペアリングキーがデフォルトの場合、同一コネクションで要求電文と応答電文を送受信します。そのため、要求電文の送信後、応答待ち中にコネクションが解放されると、応答電文を受信することができなくなります。これを回避するため、コネクションが解放された場合、応答待ち状態を解除し、応答受信失敗として後処理を行います。

1.5.13　テスト対象システムの選択

負荷分散構成などで複数のテスト対象システムを指定（address_destination定義の-tオプションを複数指定、または1つの-tオプションのportnoフラグメンバで複数ポート番号を指定）した場合、framework_definition定義の-uオプションのtestaddr_selectフラグメンバ値に従い、要求電文の送信先のテスト対象システムを選択します。

なお、testaddr_selectフラグメンバに「telegram」を指定できるのはRPCプロトコルだけです。

RPC以外のプロトコルは、testaddr_selectフラグメンバの指定値に関係なく、「client」の動作となります。

テスト対象システムを選択してコネクションを確立するタイミングを、次に示します。

クライアント識別子単位にテスト対象システムを選択（testaddr_selectフラグメンバ値が「client(デフォルト)」）

クライアント識別子単位にテスト対象システムを選択します。

クライアント識別子の初回の要求電文送信時にテスト対象システムをラウンドロビンで選択してコネクションを確立します。

コネクション確立以降は、当該クライアント識別子は、同じテスト対象システムへ要求電文を送信します。

テスト対象システム（サーバ）が3つある場合の選択例を次に示します。

受信用コネクション使用時

受信用コネクションを指定している場合、テスト対象システムを選択して送受信用コネクションを確立したときに、同時に受信用コネクションを確立します。

テスト対象システム（サーバ）が3つある場合の選択例を次に示します。

要求電文を送信するたびにテスト対象システムを選択（testaddr_selectフラグメンバ値が「telegram」）

要求電文を送信するたびに、テスト対象システムをラウンドロビンで選択します。

なお、この方式の場合、HSICとテスト対象システム間のコネクション数が増加します。

テスト対象システム（サーバ）が3つある場合の選択例を次に示します。

1.6　蓄積ファイル編集ユーティリティ（蓄積ファイルの編集）

蓄積ファイル編集ユーティリティは、蓄積実行により取得した蓄積ファイルの電文情報を読み込み、ユーザデータ部をユーザ任意の情報に編集して蓄積ファイルに出力できる機能と、蓄積ファイルを新規に生成する機能を提供します。

本機能により生成した蓄積ファイルは、リプレイ実行時の入力対象となる蓄積ファイルとして使用できます。

1.6.1　蓄積ファイル編集ユーティリティの実行単位

蓄積ファイル編集ユーティリティは、INIT要求からTERM要求までを一つの実行単位とします。実行例を下図に示します。

図1‒36　蓄積ファイル編集ユーティリティの実行の例

1.6.2　対象の蓄積ファイルおよびプロトコル

入力対象の蓄積ファイル

入力対象の蓄積ファイルは、以下の通りです。

本番用の要求電文蓄積ファイル

本番用の応答電文蓄積ファイル

テスト用の要求電文蓄積ファイル

テスト用の応答電文蓄積ファイル

入力対象のプロトコル

入力対象のプロトコルは、以下の通りです。

TCPプロトコル

UDPプロトコル

HTTPプロトコル

出力対象の蓄積ファイル

出力対象の蓄積ファイルは、以下の通りです。

本番用の要求電文蓄積ファイル

出力対象のプロトコル

出力対象のプロトコルは、以下の通りです。ただし、PUT要求については、入力対象のプロトコルと同じプロトコル電文のみ出力できます。

TCPプロトコル

UDPプロトコル

HTTPプロトコル

1.7　テスト支援GUIによるシステムテスト支援の実行

システムテスト支援は、次に示す方法で実行（起動・停止）できます。

テスト支援GUIを使用する。

コマンドを使用する。

コマンドを使用してシステムテスト支援を起動する場合は、「4.3.10　esstart（システムテスト支援の起動）」、および「4.3.11　esstop（システムテスト支援の終了）」を参照してください。

ここでは、テスト支援GUIを使用して、システムテスト支援を起動・停止する場合の操作について説明します。

テスト支援GUIの操作の流れ

テスト支援GUIの操作の流れを次に示します。

テスト支援GUIの起動

定義の読込・編集

環境変数の設定

開始・終了情報の設定

テストの開始

プロセス情報の確認

TPS情報の確認

テストの終了

以降の項で、各手順の操作について説明します。

1.7.1　テスト支援GUIの起動

テスト支援GUIの起動コマンド（eshsic_gui.exe）を実行します。

/opt/HSIC/eshsic_gui.exe

Administrator以外のユーザの場合は、起動コマンドを右クリックして［管理者として実行］で実行してください。

コマンドの実行が成功すると、テスト支援GUIが起動します。

1.7.2　定義の読込・編集

［定義読込・編集］で、システムテスト支援を起動するための定義ファイルの読み込み、および編集を実施します。

定義の設定方法を次に示します。

定義を新規作成する場合

定義情報設定エリアで定義を作成し、［名前をつけて保存］ボタンで定義を保存します。ファイル名は、テスト識別子に合わせてください。

保存した定義ファイル名（テスト識別子）が［テスト識別子］に表示されます。

既存の定義をそのまま使用する場合

［読込］ボタンをクリックして、使用する定義ファイルを指定します。

定義ファイルを指定すると、読み込んだ定義ファイルの内容が［定義情報設定］エリアに表示されます。また、読み込んだ定義ファイル名（テスト識別子）が［テスト識別子］に表示されます。

既存の定義を編集する場合

［読込］ボタンをクリックして、編集する定義ファイルを指定します。

読み込んだ定義ファイルの内容が［定義情報設定］エリアに表示されます。［定義情報設定］エリアで定義を編集し、［上書き保存］ボタンまたは［名前をつけて保存］ボタンで定義を保存します。ファイル名は、テスト識別子に合わせてください。

保存した定義ファイル名（テスト識別子）が［テスト識別子］に表示されます。

1.7.3　環境変数の設定

［環境変数］で、環境変数を設定します。

［環境変数］を設定します。

このエリアに入力した値は、HISCの開始ボタンをクリックしたときに反映されます。

環境変数を設定する場合は、エリア内に次の形式で記述してください。

設定したい環境変数名=環境変数値

複数記述する場合は、一つの環境変数ごとに改行してください。

設定した環境変数を無効にする場合、エリア内から対象の環境変数が記述された行を削除してください。

1.7.4　開始・終了情報の設定

システムテスト支援の場合

［開始情報設定］で、システムテスト支援の起動オプションを設定します。

［フレームワーク機能］を設定します。

フレームワーク機能を使用する場合、使用する機能を選択します。

フレームワーク機能の種類を次に示します。

IIOPテスト機能

TCPパケット蓄積機能

テスト比較支援機能

シナリオ実行機能

SOAPテスト機能

フレームワーク機能を使用しない場合は、［未使用］を選択して、手順4.に進んでください。

［フェーズ］を設定します。

フレームワーク機能を使用する場合に、実行するフェーズを選択します。フェーズの種類を次に示します。

電文作成フェーズ

テスト実行フェーズ

バッチ実行フェーズ

［バッチ実行フェーズ］を選択した場合は、手順4.に進んでください。

［実行形態］を設定します。

［フェーズ］で、［電文作成フェーズ］、または［テスト実行フェーズ］を選択した場合は、HSICの実行形態を選択します。実行形態の種類を次に示します。

並行実行

蓄積実行

並行＋蓄積実行

リプレイ実行

PCAP実行

［開始時刻］および［終了時刻］を設定します。

テスト対象範囲を指定したい場合、チェックボックスにチェックを入れて日時を設定します。

なお、指定時刻はTZ環境変数に従います。

［TPS表示］を設定します。

HSICプロセスのTPS情報をグラフ表示する場合に、チェックを入れます。

［port番号］を設定します。

手順5.を設定した場合に、テスト支援GUI機能内部で使用するポート番号を入力します。

デフォルト値は29112です。

1.7.5　テストの開始

［開始・終了］で、［開始］ボタンをクリックして、テストを開始します。

［コンソール出力］にエラーメッセージが出ていないか確認してください。

［開始］ボタンは、HSICのプロセスが終了するまで再クリックできません。テストを再開始する場合は、プロセスの自動終了を待つか、または［終了］ボタンもしくは［強制終了］ボタンをクリックしてプロセスを終了してください。

1.7.6　プロセス情報の確認

［プロセス一覧］ボタンをクリックすると、実行中または停止中のHSICのプロセス情報を一覧で確認できます。

実行中のプロセスの行は白、停止中のプロセスは灰色で表示されます。「状態」や「実行形態」など、一覧に表示されるプロセス情報の詳細については、「4.3.5　esjobls（システム検証支援の状態表示）」を参照してください。

プロセス情報を更新したい場合は、［更新］ボタンをクリックします。

HSICのプロセス情報の一覧画面を閉じる場合は、［閉じる］ボタンをクリックします。

1.7.7　TPS情報の確認

［TPS表示］にチェックを入れて［TPS表示］ボタンをクリックすると、TPS情報をグラフで確認できます。TPS情報をグラフ表示する画面は、1画面だけ表示してください。

［平均TPS］には、グラフに表示されているTPS情報の平均件数が表示されます。

［TPSレンジ］で、グラフに表示するTPS情報の件数の範囲（25件～3000件）を指定できます。また、［時間レンジ］で、グラフに表示するTPS情報の時間の間隔（10秒～3600秒）を指定できます。

TPS情報をグラフ表示する画面を閉じる場合は、［閉じる］ボタンをクリックします。

1.7.8　テストの終了

［開始・終了］で、［終了］ボタンをクリックしてテストを終了します。

［コンソール出力］にエラーメッセージが出ていないか確認してください。

［閉じる］ボタンをクリックして、テスト支援GUIを終了します。

1.8　COBOL2002と連携したテストのカバレージ情報の表示

システム検証支援基盤では、COBOL連携機能を使用することで、COBOL2002で開発したプログラムに対するテストを実行し、テストの網羅性をGUI上で確認できます。なお、この機能はWindowsの場合だけで使用できます。

1.8.1　COBOL連携機能とは

COBOL連携機能は、システム検証支援基盤を使用してCOBOLのテストプログラムを実施した際に、実施したテストのカバレージ情報（ソフトウェアテストで実行された命令の割合）をテスト支援GUIに表示する機能です。これによって、システム検証支援基盤を使用して実施したシステムテストの網羅性を判断できます。COBOL連携機能で確認できるソースコードに対するカバレージ情報を次に示します。

カバレージ統計情報

ソースファイル単位およびプログラム全体の次の情報を表示します。

C0メジャー

カバレージ情報の1つです。実行した文の割合を表します。

C1メジャー

カバレージ情報の1つです。実行した分岐する文の数の割合を表します。

S1メジャー

カバレージ情報の1つです。実行した呼び出し文の数の割合を表します。

ソースカバレージ情報

ソースの全行に対してC0/C1が実行済みかどうかを表示します。

COBOL連携機能でカバレージ情報を確認するまでの全体の流れを次に示します。

ユーザは、テスト支援GUIを使用してテスト対象システムに電文を送信し、テストを実行します。※

テスト完了後、ユーザはテスト支援GUIからリモートでテスト対象プログラムのプロセスを停止します。

システム検証支援基盤によって、カバレージ情報表示コマンドで出力したカバレージ情報ファイルがテスト対象システムから収集されます。

システム検証支援基盤によって、カバレージ情報ファイル内の情報がテスト支援GUIの画面に表示されます。

ユーザは、GUI画面でカバレージ情報を確認します。

注※

カバレージ情報を表示するためには、テストを実行する前に次の2点を行う必要があります。

カバレージ情報表示対象のCOBOLプログラムを、-CVInfコンパイラオプションを指定してコンパイルする

テスト対象システムで環境変数CBLTDEXECに「CV」を指定する

詳細は、マニュアルCOBOL2002 操作ガイドを参照してください。

図1‒37　COBOL連携機能でカバレージ情報を確認するまでの全体の流れ

COBOL連携機能でカバレージ情報を確認するまでの全体の流れの詳細を次の表に示します。

表1‒9　COBOL連携機能でカバレージ情報を確認するまでの全体の流れの詳細

項目

内容

テスト実行

－

テスト支援GUIでテストを実行します。

プロセス停止

COBOLプロセスの停止

ネットワーク経由でカバレージ情報表示対象プログラムに対してプロセス停止命令を送信することで、カバレージ情報表示対象プログラムのプロセスを停止します。これによって、COBOL2002側がカバレージ情報を表示するために必要とする入力ファイル（プログラム情報ファイル）が出力されます。

カバレージ情報取得

カバレージ情報表示コマンドの実行

リモートコマンド実行によって、テスト対象システムでCOBOL2002のカバレージ情報表示コマンドを実行します。

カバレージ情報ファイルの取得

COBOL2002のカバレージ情報表示コマンドによって出力されたカバレージ情報ファイル（カバレージ統計情報CSVファイルおよびソースカバレージ情報CSVファイル）をテスト対象システムから取得します。

カバレージ情報表示

カバレージ統計情報の表示

カバレージ統計情報（対象テストでの全ソースのC0/C1カバレージ率一覧）を表示します。

ソースカバレージ情報の表示

ソースカバレージ情報を表示します。

（凡例）－：該当しません。

1.8.2　COBOL連携機能を使用する場合の前提プログラム

COBOL連携機能を使用する場合の前提プログラムとその設定について説明します。COBOL連携機能を使用する場合、テスト対象システムを実行するマシンと、システム検証支援基盤のテスト支援GUIを実行するマシンでそれぞれ前提プログラムのインストールと設定が必要です。COBOL連携機能では、SSHプロトコルを使用して、テスト対象システム実行マシン上でのリモート処理を実現します。SSHプロトコルを使用したリモート実行をするために、前提プログラムとしてOSSのOpen-SSHとPuTTYを使用します。

テスト対象システム実行マシン（COBOL2002）の前提プログラムと設定

前提条件

テスト対象システム実行マシン上には、次のどれかのプログラムが必要です。

P-2636-2344 COBOL2002 Net Developer 04-10以降

P-2636-7344 COBOL2002 Developer Professional 04-10以降

P-2436-6344 COBOL2002 Net Server Suite 04-10以降

P-2636-4344 COBOL2002 Net Client Suite 04-10以降

P-2936-2344 COBOL2002 Net Developer(64) 04-10以降

P-2936-7344 COBOL2002 Developer Professional(64) 04-10以降

P-2936-6344 COBOL2002 Net Server Suite(64) 04-10以降

また、Open-SSH（バージョン5.3p1以降）もインストールしてください。Open-SSHは、SSHサーバーとして使用します。

テスト対象システム実行マシン（COBOL2002）の設定手順を次に示します。

Open-SSHをインストールします。インストール済みの場合はインストール不要です。

次のファイルのSSHサーバーの定義を設定します。設定済みの場合は設定不要です。

C:¥ProgramData¥ssh¥sshd_config

設定する指定値について、次の表に示します。

表1‒10　SSHサーバーの定義を設定する指定値

設定項目

指定値

デフォルト値

port

任意のポート番号※

22

PasswordAuthentication

yes

yes

PermitRootLogin

yes

yes

注※

指定値と同じポート番号をテスト支援GUI画面で指定してください。

ファイアウォールの設定で、portに指定したポート番号を解放します。

テスト実行時、SSHサーバーを起動します。SSHDが自動で起動しない場合、手動で起動します。

テスト支援GUI実行マシンのの前提プログラムと設定

前提条件

テスト支援GUI実行マシン上には、次のプログラムが必要です。

Microsoft .NET Framework 4.5以降 再頒布可能パッケージ

PuTTY（バージョン0.7.0以降）

テスト支援GUI実行マシンで次の設定をしてください。

PuTTYをインストールします。

PuTTYをインストールしたディレクトリを環境変数PATHに設定します。

テスト支援GUI画面で指定するユーザには、任意コマンドおよびCOBOLコマンドの実行権限のあるテスト対象システム実行マシン側のユーザを指定します。

1.8.3　COBOL連携機能を使用する場合のシステム構成

COBOL連携機能を使用する場合のシステム構成について説明します。

最小機器構成

システム検証支援基盤をインストールしたマシン1台とテスト対象システム1台のマシンが、最小機器構成です。テスト対象システムにはCOBOL2002およびCOBOL2002でコンパイルしたテスト対象プログラムを配置する必要があります。最小機器構成を次の図に示します。

図1‒38　最小機器構成

テスト対象システムが2台以上ある場合の機器構成

テスト対象システムが2台以上ある場合も、1台のマシンにインストールしたシステム検証支援基盤でテストの実施およびカバレージ情報の確認ができます。テスト対象システムが2台の場合の機器構成を次の図に示します。

図1‒39　テスト対象システムが2台の場合の機器構成

1.8.4　カバレージ情報の表示の流れ

COBOLプログラムのカバレージ情報を表示する流れを次に示します。カバレージ情報の表示には、テスト支援GUIを使用します。

接続先の設定

カバレージ情報表示対象のプログラムの停止（コマンドの実行）

COBOLカバレージ情報の表示

テスト支援GUI上でカバレージ情報の表示をしたことがある場合、次にテスト支援GUIを起動したときには、接続先が設定された状態でテスト支援GUIが起動します。

接続先の設定

接続先の設定について説明します。

接続先定義の［設定］

COBOLカバレージ情報表示対象のマシンへ接続するための定義を設定します。

図1‒40　接続先定義の［設定］

表1‒11　接続先定義の［設定］

図中の番号

名称

説明

（1）

接続先選択ドロップダウンリスト

編集済みの接続先情報の中から、使用する接続先情報を選択します。

接続先未選択時の初期値は、""（空白）です。

前回GUI起動時に接続先を選択した場合の初期値は、前回選択した値です。

接続先情報未選択の場合は、接続先編集ボタンを押下して、接続先情報を編集する必要があります。

（2）

接続先編集ボタン

このボタンを押下すると、接続先編集ダイアログが表示されます。

新しく接続先情報を作成する場合や、既存の接続先情報を変更する場合に使用します。

［接続先編集］ダイアログ

このダイアログでは、新しい接続先情報の編集、または既存の接続先情報の編集を行います。「図1‒40　接続先定義の［設定］」の（1）の接続先選択ドロップダウンリストで接続先を選択している場合、その接続先の情報を初期値として表示します。

図1‒41　［接続先編集］ダイアログ

表1‒12　［接続先編集］ダイアログ

図中の番号

名称

説明

（1）

接続先サイト名入力コンボボックス

接続先の情報を保存するための名称を入力または選択します。最大32文字まで入力できます。入力した文字の前後の空白は取り除かれます。

なお、次の文字は、接続先サイト名には使用できません。

“, <, >, |, :, *, ?, /, ¥

最新10件の接続先情報の履歴を選択できます。コンボボックスで履歴を選択した場合、次のフォームの現在の値は選択した履歴の値で上書きされます。

ホスト名入力テキストボックス

ユーザ名入力テキストボックス

パスワード入力テキストボックス

接続先サイトの文字コード選択ドロップダウンリスト

接続先未選択時の初期値は、「新しい接続先」です。

接続先選択時の初期値は、その接続先の名称です。

「新しい接続先」（初期値）と""（空白）は接続先の名称としては使用できません。

（2）

ホスト名入力テキストボックス

接続先のホスト名とポート番号を入力します。

ポート番号はホスト名の後ろに、「:ポート番号」と入力します。

ポート番号は省略できます。省略した場合は、ポート番号22を使用します。

最大255文字まで入力できます（コロンとポート番号含む）。

マルチバイト文字は入力できません。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先情報が持つホスト名が初期値となります。

（3）

ユーザ名入力テキストボックス

接続先にログインするためのユーザー名を入力します。

最大127文字まで入力できます。

マルチバイト文字は入力できません。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先情報が持つユーザ名です。

（4）

パスワード入力テキストボックス

接続先にログインするためのパスワードを入力します。入力値した値は、アスタリスク（*）で表示されます。

最大127文字まで入力できます。

マルチバイト文字は入力できません

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先情報が持つパスワードの文字数と同じ数の「*」が表示されます。

（5）

接続先サイトの文字コード選択ドロップダウンリスト

接続したホストの文字コードを選択します。SJISとUTF-8から選択できます。

接続先未選択時の初期値は、SJISです。

接続先選択時の初期値は、その接続先情報が持つ文字コードです。

（6）

保存ボタン

入力・変更した接続先情報を保存して、画面を閉じます。

画面を閉じたあと、接続先選択ドロップダウンリストには、更新した接続先情報が適用されます。

接続情報は、最新10件の履歴を記録できます。

履歴が10件を超えた場合は、最後に使用した日時が古い履歴から順に削除されます。

（7）

クローズボタン

入力・変更した値を反映しないで、この画面を閉じます。

カバレージ表示対象のプログラムの停止（コマンドの実行）

カバレージ表示対象のプログラムの停止（コマンドの実行）について説明します。

［接続サーバでコマンド実行］

接続先サーバでコマンドを実行するときに使用します。

図1‒42　［接続サーバでコマンド実行］

表1‒13　［接続サーバでコマンド実行］

図中の番号

名称

説明

（1）

接続先選択ドロップダウンリスト

定義済みの接続先情報の中から、使用する接続先情報を選択します。

詳細は、「表1‒11　接続先定義の［設定］」を参照してください。

（2）

コマンドパス入力コンボボックス

次のどちらかの方法で、実行コマンドを設定します。

接続先で実行するコマンドのフルパスおよびオプションを入力する

過去の入力履歴から実行コマンドを選択する

複数のコマンドを同時に実行する場合は、コマンド間を「;」（セミコロン）で区切ってください。

最大1,024文字まで入力できます。

実行するコマンドのフルパスおよびオプションがこのコンボボックスに収まらず、入力が困難な場合、コマンドパス入力ダイアログ表示ボタンを押下して、コマンドパス入力ダイアログを表示させてください。

最新10件の入力履歴から、実行コマンドを選択できます。履歴は、接続先ごとに記録されます。

半角スペースが入ったコマンドのフルパスを入力する場合、フルパス全体を""（ダブルクォーテーション）で囲みます。

オプション値に半角スペースが入る場合も""（ダブルクォーテーション）で囲みます。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先に対して最後に実行したコマンドです。

（3）

コマンドパス入力ダイアログ表示ボタン

コマンドパスを入力するためのダイアログを表示します。

詳細は、「表1‒14　［コマンドパス入力］ダイアログ」を参照してください。

（4）

コマンド実行ボタン

コマンドパス入力コンボボックスに入力したコマンドを実行します。

コマンドパス入力コンボボックスの値は、履歴として記録されます。

履歴が10件を超えた場合は、最後に使用した日時が古い履歴から順に削除されます。

（5）

コンソール出力エリアクリアボタン

コンソール出力エリアに表示された出力をクリアします。

（6）

コンソール出力エリア

コマンドの実行結果が出力されます。コマンドの実行結果によって、次のメッセージが表示されます。

なお、コマンド失敗時は、失敗時（1）のメッセージのどちらかが表示されたあとに、失敗時（2）のメッセージが表示されます。

成功時

「コマンドの実行に成功しました。コマンド＝aa…aa」

aa…aa：入力したコマンド

失敗時（1）

「接続先サーバでのコマンドの実行に失敗しました。理由コード＝aa…aa,ホスト名＝bb…bb,コマンド＝(cc…cc),詳細コード＝dd…dd」

aa…aa：失敗要因

bb…bb：ホスト名

cc…cc：入力したコマンド

dd…dd：トラブルシュートで使用する情報

「一時ファイルへのアクセスに失敗しました。理由コード＝aa…aa,ホスト名＝bb…bb,コマンド＝(cc…cc),詳細コード＝dd…dd」

aa…aa：失敗要因

bb…bb：ホスト名

cc…cc：入力したコマンド

dd…dd：トラブルシュートで使用する情報

失敗時（2）

実行したコマンドが標準エラー出力に出力したエラーメッセージ

［コマンドパス入力］ダイアログ

図1‒43　［コマンドパス入力］ダイアログ

表1‒14　［コマンドパス入力］ダイアログ

図中の番号

名称

説明

（1）

コマンドパス入力テキストボックス

コマンドのフルパス、およびオプションを入力します。

最大1,024文字まで入力できます。

（2）

OKボタン

コマンドパス入力テキストボックスの値を反映します。

（3）

キャンセルボタン

コマンドパス入力テキストボックスに入力した値を反映しないで、ダイアログを閉じます。

COBOLカバレージ情報の表示

COBOLカバレージ情報の表示について説明します。

［COBOLカバレージ表示］

接続先ホストで実行したCOBOLプログラムのカバレージ情報を表示します。

図1‒44　［COBOLカバレージ表示］

表1‒15　［COBOLカバレージ表示］

図中の番号

名称

説明

（1）

接続先選択ドロップダウンリスト

定義済みの接続先情報の中から、使用する接続先情報を選択します。

詳細は、「表1‒11　接続先定義の［設定］」を参照してください。

（2）

COBOLカバレージ表示コマンドパス入力コンボボックス

接続先のCOBOLカバレージ表示コマンド格納ディレクトリのフルパスを入力、または過去の入力履歴からディレクトリのフルパスを選択します。

COBOLカバレージ表示コマンドが格納されているディレクトリのフルパスは「COBOL2002インストールフォルダ¥BIN」です。例えば、COBOL2002が、デフォルトのインストール先である「C:¥Program Files¥Hitachi¥COBOL2002 64bit」にインストールされている場合、COBOLカバレージ表示コマンドが格納されているディレクトリのフルパスは「C:¥Program Files¥Hitachi¥COBOL2002 64bit¥BIN」です。

最大1,024文字まで入力できます。

ディレクトリのフルパスがこのコンボボックスに収まらず、入力が困難な場合、COBOLカバレージ表示コマンドパス入力ダイアログ表示ボタンを押下して、コマンドパス入力ダイアログを表示させてください。

最新10件の入力履歴から、ディレクトリのフルパスを選択できます。履歴は、接続先ごとに記録されます。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先に対して最後に入力したディレクトリのフルパスです。

（3）

COBOLカバレージ表示コマンドパス入力ダイアログ表示ボタン

接続先のCOBOLカバレージ表示コマンド格納ディレクトリのフルパスを入力するためのダイアログを表示します。

詳細は、「表1‒16　COBOLカバレージ表示［コマンドパス入力］ダイアログ」を参照してください。

（4）

入力ディレクトリパス入力コンボボックス

接続先のプログラム情報ファイル格納ディレクトリのフルパスを入力、または過去に入力した履歴から選択します。

最大1,024文字まで入力できます。

ディレクトリのフルパスがこのコンボボックスに収まらず、入力が困難な場合、入力ディレクトリ入力ダイアログ表示ボタンを押下して、入力ディレクトリ入力ダイアログを表示させてください。

最新10件の入力履歴から、ディレクトリのフルパスを選択できます。履歴は、接続先ごとに記録されます。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先に対して最後に入力したディレクトリのフルパスです。

（5）

入力ディレクトリ入力ダイアログ表示ボタン

接続先のプログラム情報ファイル格納ディレクトリのフルパスを入力するためのダイアログを表示します。

詳細は、「表1‒17　［入力ディレクトリ入力］ダイアログ」を参照してください。

（6）

出力ディレクトリパス入力コンボボックス

接続先のカバレージ情報出力ディレクトリのフルパスを入力、または過去に入力した履歴から選択します。

最大1,024文字まで入力できます。

ディレクトリのフルパスがこのコンボボックスに収まらず、入力が困難な場合、出力ディレクトリ入力ダイアログ表示ボタンを押下して、出力ディレクトリ入力ダイアログを表示させてください。

最新10件の入力履歴から、ディレクトリのフルパスを選択できます。履歴は、接続先ごとに記録されます。

接続先未選択時の初期値は、""（空白）です。

接続先選択時の初期値は、その接続先に対して最後に入力したディレクトリのフルパスです。

（7）

出力ディレクトリ入力ダイアログ表示ボタン

接続先のカバレージ情報出力ディレクトリのフルパスを入力するためのダイアログを表示します。

詳細は、「表1‒18　［出力ディレクトリ入力］ダイアログ」を参照してください。

（8）

コマンド実行ボタン

カバレージ情報を表示するために、カバレージ統計情報画面が表示されます。

カバレージ統計情報画面については、「1.8.5　カバレージ情報の表示（カバレージ統計情報）」を参照してください。

次のフォームの値を履歴として記録します。10件を超えた履歴は、最後に使用した日時が古い履歴から順に削除されます。

COBOLカバレージ表示コマンドパス入力コンボボックス

入力ディレクトリパス入力コンボボックス

出力ディレクトリパス入力コンボボックス

（9）

コンソール出力クリアボタン

コンソール出力エリアに表示された出力をクリアします。

（10）

コンソール出力エリア

コマンド失敗時に、失敗時（1）のメッセージのどれかが表示されたあと、失敗時（2）のメッセージが表示されます。

失敗時（1）

「接続先サーバでのコマンドの実行に失敗しました。理由コード＝aa…aa,ホスト名＝bb…bb,コマンド＝(cc…cc),詳細コード＝dd…dd」

aa…aa：失敗要因

bb…bb：ホスト名

cc…cc：入力したコマンド

dd…dd：トラブルシュートで使用する情報

「接続先サーバからのファイルのダウンロードに失敗しました。理由コード＝aa…aa,ホスト名＝bb…bb,ファイル名＝(cc…cc),詳細コード＝dd…dd」

aa…aa：失敗要因

bb…bb：ホスト名

cc…cc：ダウンロード対象のファイル名

dd…dd：トラブルシュートで使用する情報

「一時ファイルへのアクセスに失敗しました。理由コード＝aa…aa,ホスト名＝bb…bb,コマンド＝(cc…cc),詳細コード＝dd…dd」

aa…aa：失敗要因

bb…bb：ホスト名

cc…cc：入力したコマンド

dd…dd：トラブルシュートで使用する情報

失敗時（2）

カバレージ表示コマンドが標準エラー出力に出力したエラーメッセージ

COBOLカバレージ表示［コマンドパス入力］ダイアログ

図1‒45　COBOLカバレージ表示［コマンドパス入力］ダイアログ

表1‒16　COBOLカバレージ表示［コマンドパス入力］ダイアログ

図中の番号

名称

説明

（1）

コマンドパス入力テキストボックス

接続先のCOBOLカバレージ表示コマンド格納ディレクトリのフルパスを入力します。

COBOLカバレージ表示コマンドが格納されているディレクトリのフルパスは「COBOL2002インストールフォルダ¥BIN」です。例えば、COBOL2002が、デフォルトのインストール先である「C:¥Program Files¥Hitachi¥COBOL2002 64bit」にインストールされている場合、COBOLカバレージ表示コマンドが格納されているディレクトリのフルパスは「C:¥Program Files¥Hitachi¥COBOL2002 64bit¥BIN」です。

最大1,024文字まで入力できます。

（2）

OKボタン

コマンドパス入力テキストボックスの値を反映します。

（3）

キャンセルボタン

コマンドパス入力テキストボックスに入力した値を反映しないで、ダイアログを閉じます。

［入力ディレクトリ入力］ダイアログ

図1‒46　［入力ディレクトリ入力］ダイアログ

表1‒17　［入力ディレクトリ入力］ダイアログ

図中の番号

名称

説明

（1）

入力ディレクトリパス入力テキストボックス

接続先のプログラム情報ファイル格納ディレクトリのフルパスを入力します。

最大1,024文字まで入力できます。

（2）

OKボタン

入力ディレクトリパス入力テキストボックスの値を反映します。

（3）

キャンセルボタン

入力ディレクトリパス入力テキストボックスに入力した値を反映しないで、ダイアログを閉じます。

入力ディレクトリおよびそのサブディレクトリに、同名のプログラム情報ファイルを格納しないでください。

［出力ディレクトリ入力］ダイアログ

図1‒47　［出力ディレクトリ入力］ダイアログ

表1‒18　［出力ディレクトリ入力］ダイアログ

図中の番号

名称

説明

（1）

出力ディレクトリパス入力テキストボックス

接続先のカバレージ情報出力ディレクトリのフルパスを入力します。

最大1,024文字まで入力できます。

（2）

OKボタン

出力ディレクトリパス入力テキストボックスの値を反映します。

（3）

キャンセルボタン

出力ディレクトリパス入力テキストボックスに入力した値を反映しないで、ダイアログを閉じます。

1.8.5　カバレージ情報の表示（カバレージ統計情報）

カバレージ統計情報画面は、「図1‒44　［COBOLカバレージ表示］」の［コマンド実行］ボタンをクリックすると表示されます。

カバレージ統計情報画面に表示される項目について、次に示します。マニュアルCOBOL2002 操作ガイドもあわせて参照してください。

図1‒48　カバレージ統計情報画面（詳細情報なし）

図1‒49　カバレージ統計情報画面（詳細情報あり）

ヘッダエリア

カバレージ統計情報画面のヘッダエリアで表示される項目について、次の表に示します。

表1‒19　カバレージ統計情報画面のヘッダエリア

名称

内容

バージョン

COBOL2002のバージョン情報

出力日時

カバレージ情報を出力した日時

一覧表示エリア

カバレージ統計情報画面の一覧表示エリアで表示される項目について、次の表に示します。

表1‒20　カバレージ統計情報画面の一覧表示エリア

項目

名称

内容

ソース単位

ソースファイル名

ソースファイル名

拡張子は「.cbl」です。

ヘッダ列をクリックするとソースファイル名でソートできます。

翻訳単位

名称

翻訳単位の名称

コンパイル日時

翻訳単位を含む原始プログラムをコンパイルした日時

詳細情報切替ボタンの［詳細表示 ON］ボタンをクリックすると、コンパイル日時が表示されます。

テスト日時

翻訳単位を含む原始プログラムのカバレージ情報を最後に蓄積した日時

カバレージ情報を蓄積していない場合は、「-」が表示されます。

詳細情報切替ボタンの［詳細表示 ON］ボタンをクリックすると、テスト日時が表示されます。

変更回数

翻訳単位を含む原始プログラムを変更した回数

32,767を超えた場合は、「*」が表示されます。

詳細情報切替ボタンの［詳細表示 ON］ボタンをクリックすると、変更回数が表示されます。

テスト回数

翻訳単位を含む原始プログラムを実行した回数

32,766を超えた場合は、「*」が表示されます。

詳細情報切替ボタンの［詳細表示 ON］ボタンをクリックすると、テスト回数が表示されます。

種別

翻訳単位の種別

P：プログラム

C：クラス

T：利用者定義関数

詳細情報切替ボタンの［詳細表示 ON］ボタンをクリックすると、種別が表示されます。

ソース単位

詳細カバレージ情報

［表示］をクリックすると、ソースカバレージ情報画面が表示されます。

ソースカバレージ情報がない場合は、「-」が表示されます。

翻訳単位

C0

対象総数

翻訳単位

実行文の数

実行済数

実行が済んだ実行文の数

C0

C0メジャー※

差分C0

対象総数

差分

実行文の数

実行済数

実行が済んだ実行文の数

差分C0

差分C0メジャー※

C1

対象総数

翻訳単位

実行できる分岐先の数

実行済数

実行が済んだ分岐先の数

C1

C1メジャー※

差分C1

対象総数

差分

実行できる分岐先の数

実行済数

実行が済んだ分岐先の数

差分C1

差分C1メジャー※

S1

対象総数

翻訳単位

実行できる呼び出し文の数

実行済数

実行が済んだ呼び出し文の数

S1

S1メジャー※

差分S1

対象総数

差分

実行できる呼び出し文の数

実行済数

実行が済んだ呼び出し文の数

差分S1

差分S1メジャー※

合計

C0

対象総数

一覧の全翻訳単位

実行文の数の合計

実行済数

実行が済んだ実行文の数の合計

C0

C0メジャー※

差分C0

対象総数

一覧の全翻訳単位の差分

実行文の数の合計

実行済数

実行が済んだ実行文の数の合計

差分C0

差分C0メジャー※

C1

対象総数

一覧の全翻訳単位

実行できる分岐先の数の合計

実行済数

実行が済んだ分岐先の数の合計

C1

C1メジャー※

差分C1

対象総数

一覧の全翻訳単位の差分

実行できる分岐先の数の合計

実行済数

実行が済んだ分岐先の数の合計

差分C1

差分C1メジャー※

S1

対象総数

一覧の全翻訳単位

実行できる呼び出し文の数の合計

実行済数

実行が済んだ呼び出し文の数の合計

S1

S1メジャー※

差分S1

対象総数

一覧の全翻訳単位の差分

実行できる呼び出し文の数の合計

実行済数

実行が済んだ呼び出し文の数の合計

差分S1

差分S1メジャー※

注※

小数点第2位以下は切り捨てます。

注意事項

C0メジャー、差分C0メジャー、C1メジャー、、差分C1メジャー、S1メジャー、および差分S1メジャーのそれぞれの対象総数、実行済数が99,999,999を超えた場合、「*」が表示されます。また、対象総数が0の場合は、「-」が表示されます。

集計する対象総数、または実行済数に「*」があった場合、合計には「*」が表示されます。

詳細情報切替ボタン

一覧表示エリアの詳細情報（［コンパイル日時］、［テスト日時］、［変更回数］、［テスト回数］、および［種別］）の項目を表示するかどうかを切り替えます。初期値は、非表示です。

［詳細表示 ON］：ボタンをクリックすると詳細情報を表示します。

［詳細表示 OFF］：ボタンをクリックすると詳細情報を非表示にします。

閉じるボタン

カバレージ統計情報画面を閉じます。

1.8.6　カバレージ情報の表示（ソースカバレージ情報）

ソースカバレージ情報画面は、カバレージ統計情報画面の詳細カバレージ情報の［表示］をクリックすると表示されます。カバレージ統計情報画面については、「1.8.5　カバレージ情報の表示（カバレージ統計情報）」を参照してください。

ソースカバレージ情報画面に表示される項目について、次に示します。マニュアルCOBOL2002 操作ガイドもあわせて参照してください。

図1‒50　ソースカバレージ情報画面

ヘッダエリア

ソースカバレージ情報画面のヘッダエリアで表示される項目について、次の表に示します。

表1‒21　ソースカバレージ情報画面のヘッダエリア

名称

内容

バージョン

COBOL2002のバージョン情報

出力日時

カバレージ情報を出力した日時

ソース表示エリア

ソース表示エリアには、［全ソース表示］タブ、［差分ソース表示］タブ、［未実行ソース表示］タブ、［差分未実行ソース表示］タブ、および［呼び出し文ソース表示］タブが表示されます。

［全ソース表示］タブ

原始プログラム、原始プログラムの変更による差分、C0実行済み、およびC1実行済みの状態が表示されます。

図1‒51　［全ソース表示］タブ

［全ソース表示］タブに表示される項目について、次の表に示します。

表1‒22　［全ソース表示］タブ

名称

内容

ソース要素名

ソース要素の種別に応じた名称

最外プログラムの場合

プログラム名：翻訳単位の名称またはソース要素名称

入れ子プログラムの場合

プログラム名：翻訳単位の名称またはソース要素名称

ファクトリメソッド・オブジェクトメソッドの場合

クラス名：翻訳単位の名称

メソッド名：ソース要素名称

利用者定義関数名の場合

利用者定義関数名：翻訳単位の名称またはソース要素名称

変更

Y：原始プログラムの変更された行

#：原始プログラムの変更によって影響がある行

C0

*：実行が済んだ実行文

.：実行していない実行文

C1

@：実行が済んだ分岐

.：実行していない分岐

行番号

コンパイラが振り直した行番号

ソーステキスト

原始プログラムの行の内容

［差分ソース表示］タブ

原始プログラムの修正によって生じた差分のソースに対して、変更行、変更影響行、C0実行済み、およびC1実行済みが明示されます。差分のソースがないときは「出力対象データはありません」と表示されます。［差分ソース表示］タブに表示される項目については、「表1‒22　［全ソース表示］タブ」を参照してください。

図1‒52　［差分ソース表示］タブ

［未実行ソース表示］タブ

原始プログラムの実行していないソースが表示されます。実行していないソースがないときは「出力対象データはありません」と表示されます。［未実行ソース表示］タブに表示される項目については、「表1‒22　［全ソース表示］タブ」を参照してください。

図1‒53　［未実行ソース表示］タブ

［差分未実行ソース表示］タブ

原始プログラムの差分未実行ソースが表示されます。差分未実行ソースがないときは「出力対象データはありません」と表示されます。［差分未実行ソース表示］タブに表示される項目については、「表1‒22　［全ソース表示］タブ」を参照してください。

図1‒54　差分未実行ソース表示タブ

［呼び出し文ソース表示］タブ

原始プログラムのS1カバレージ対象の呼び出し文が表示されます。S1カバレージ対象の呼び出し文がないときは「出力対象データはありません」と表示されます。［呼び出し文ソース表示］タブのに表示される項目については、「表1‒22　［全ソース表示］タブ」を参照してください。

図1‒55　［呼び出し文ソース表示］タブ

まとめ情報エリア

ソース単位のC0メジャー、差分C0メジャー、C1メジャー、差分C1メジャー、S1メジャー、および差分S1メジャーを表示します。

表1‒23　カバレージ統計情報画面のまとめ情報エリアの説明

名称

内容

C0

対象総数

ソース単位

実行文の数

実行済数

実行が済んだ実行文の数

未実行数

実行していない実行文の数

カバレージ率

C0メジャー※

差分C0

対象総数

差分

実行文の数

実行済数

実行が済んだ実行文の数

未実行数

実行していない実行文の数

カバレージ率

差分C0メジャー※

C1

対象総数

ソース単位

実行できる分岐先の数

実行済数

実行が済んだ分岐先の数

未実行数

実行していない分岐の数

カバレージ率

C1メジャー※

差分C1

対象総数

差分

実行できる分岐先の数

実行済数

実行が済んだ分岐先の数

未実行数

実行していない分岐の数

カバレージ率

差分C1メジャー※

S1

対象総数

ソース単位

実行できる呼び出し文の数

実行済数

実行が済んだ呼び出し文の数

未実行数

実行していない呼び出し文の数

カバレージ率

S1メジャー※

差分S1

対象総数

差分

実行できる呼び出し文の数

実行済数

実行が済んだ呼び出し文の数

未実行数

実行していない呼び出し文の数

カバレージ率

差分S1メジャー※

注※

小数点第2位以下は切り捨てます。

注意事項

C0メジャー、差分C0メジャー、C1メジャー、差分C1メジャー、S1メジャー、および差分S1メジャーのそれぞれの対象総数、実行済数が99,999,999を超えた場合、「*」が表示されます。また、対象総数が0の場合は、「-」が表示されます。

対象総数および実行済数が「*」の場合、未実行数には「*」が表示されます。

閉じるボタン

ソースカバレージ情報画面を閉じます。

2　システムテスト支援で使用できる電文プロトコル

システムテスト支援で使用できる電文プロトコルについて説明します。

2.1　使用できる電文プロトコルと実行方式の対応

システムテスト支援では電文のプロトコルに応じて実行可能な実行形態が異なります。

以下に、システムテスト支援で使用可能な電文プロトコルおよび各プロトコルで指定可能な実行形態を示します。

各対象プロトコルの詳細は、次項以降を参照してください。

表2‒1　各プロトコルで指定可能な実行形態

実行形態

並行実行

蓄積実行

リプレイ実行

PCAP実行

入力対象

ネットワークスイッチ

蓄積ファイル

pcap形式ファイル

対象プロトコル

RPC・RAP

○

○

○

○

TCPスルー

○

○

○

○

UDPスルー

○

○

○

○

HTTP

○

○

○

○

IIOP

×

○

○

○

（凡例）　○：実行可能、×：実行不可

電文種別の扱いを以下に示します。

表2‒2　電文種別の扱い

プロトコル

要求電文

（外部システムから既存システムへの電文）

本番応答電文

（既存システムから外部システムへの電文）

テスト応答電文

（テスト対象システムからシステム検証支援基盤への電文）

RPC・RAP

送信＋蓄積

蓄積

蓄積＋応答比較

TCPスルー

送信＋蓄積

破棄

破棄

UDPスルー

送信＋蓄積

破棄

破棄

HTTP

送信＋蓄積

蓄積

破棄

IIOP

送信＋蓄積

蓄積

蓄積

（凡例）

送信：テスト対象システムへ電文を送信します（並行実行、リプレイ実行、PCAP実行）

蓄積：蓄積ファイルに電文を蓄積します（蓄積実行時）

破棄：テスト対象外の電文のため、破棄します

応答比較：本番応答電文とテスト応答電文を比較します（並行実行、リプレイ実行、PCAP実行時）

2.2　RPC・RAP

2.2.1　RPC・RAPの対応電文

以下にRPC・RAPの対応電文一覧を示します。

表2‒3　対応電文一覧

電文種別

送信相手

プロトコル種別

概要

対応可否

RPC

電文

同期型RPC

キュー受信サーバ

RPCプロトコル

サーバからの応答を待ち合わせる、同期応答型のRPC電文。

○

ソケット受信サーバ

×

非同期型RPC

キュー受信サーバ

サーバからの応答を待ち合わせない、非同期応答型のRPC電文。

○

ソケット受信サーバ

×

非応答型RPC

キュー受信サーバ

サーバが応答を返さない、非応答型のRPC電文。

○

ソケット受信サーバ

×

トランザクショナル

RPC

キュー受信サーバ

一連のRPCをトランザクションとするRPC電文。

×

ソケット受信サーバ

×

連鎖RPC

キュー受信サーバ

連鎖RPC使用時に送受信される電文。

×

ソケット受信サーバ

×

CUPへの一方通知電文

CUP

CUPにサーバプロセスの起動を通知する電文

×

サービス検索電文

namd

namdによるサービスの検索電文。

×

cltd、cltcond、clttrndとの電文

cltd

cltcond

clttrnd

クライアントから、cltd・cltcond・clttrnd経由でやり取りされる電文

×

同期点電文

サーバUAP

クライアント、サーバ間で送受信されるトランザクション制御電文。

×

tact制御電文

コネクション接続先

一時クローズ電文（要求・応答・失敗）、クローズ要求電文。

○

リモート

API

電文

コネクション制御電文

rapリスナー

rapサーバ

RAPプロトコル

rapクライアントから発行される、コネクション確立・コネクション開放など、コネクション制御を行う電文

○

API代理実行電文

（同期型RPC）

rapサーバ

rpc系（同期型RPC）のAPIの代理実行電文。

○

API代理実行電文

（非応答型RPC）

rapサーバ

rpc系（非応答型RPC）のAPIの代理実行電文。

○

API代理実行電文（トランザクショナルRPC）

rapサーバ

rpc系（トランザクショナルRPC）のAPIの代理実行電文。

○

（※1）

API代理実行電文（連鎖RPC）

rapサーバ

rpc系（連鎖RPC）のAPIの代理実行電文。

×

API代理実行

電文（trn）

rapサーバ

trn系のAPIの代理実行電文。

×

API代理実行

電文（xar）

rapサーバ

xar系のAPIの代理実行電文。

×

（凡例）

○：対応可電文

×：対応否電文

×の電文がパケットから入力される、またテスト対象システムから送信されてくるなどした場合は、該当の電文は破棄します。

（※1）トランザクションに含まれない通常のRPCとして処理されます。

2.2.2　RPC・RAP使用時の注意事項

以下にRPC・RAPプロトコルにおける、ユーザに対しての注意事項について示します。

全般

システムテスト支援では、以下の要求電文に対応する応答電文が受信できたかどうかの監視を行います。

外部システムからの要求電文に対応する応答電文

テスト対象システムへ送信した要求電文に対応する応答電文

タイミングによっては、応答待ち時間より長くなる場合があります。誤差は、最大5秒です。

よって、外部システム、既存システム間でタイムアウトとなった電文でもシステムテスト支援、テスト対象システム間ではタイムアウトとならない場合があります。

パケットキャプチャ関連

CUPからrapサーバへのトランザクショナルRPC電文（API代理実行電文）は、非トランザクショナルRPC電文（API代理実行電文）としてキャプチャされます。

外部システムから既存システムへのサービス要求時に相手サーバが起動していない場合、サービス要求のリトライを行う場合があるため、要求電文が重複してキャプチャリングされることがあります。この場合、重複した要求電文はそれぞれ別の電文として扱われます。

並行／リプレイ／PCAP実行関連

テスト対象システムとして稼働しているOpenTP1システムのシステムサービス定義のオペランド（all_nodeなど）にシステムテスト支援が稼働しているノードアドレス及びポート番号を指定しないでください。

テスト対象システムのサービス関数でdc_rpc_get_callers_address関数又は、dc_rpc_get_gateway_address関数を発行した場合、システムテスト支援が稼働しているノードアドレスを返します。

システムテスト支援からの性能検証用の識別情報は、TP1/SBの性能検証用トレースに出力されます。性能検証用の識別情報として取得する情報について次に示します。

ノードID：aa[bb]（4バイトの英数字）

aa：_H

bb：ランダムな2文字の英数字（0〜9、A〜Z、a〜z）

ルート通信通番：[cccccccc]（4バイトの16進表示のデータ）

cccccccc：IPアドレス

RPC通信通番：[dddddddd]（ （4バイトの16進表示のデータ）

dddddddd：通信通番

（電文をテスト対象システムに送信するごとにインクリメントされます）

TP1/SBの性能検証用トレースの出力例を次に示します。出力例は、ノードID「_HOX」、ルート通信通番「f784d10a」、RPC通信通番「00000001」の場合です。

PRF: Rec Node: smpl Run-ID: 0x4743dfcc Process: 12345        Trace: 4
Event: 0x1003 Time: 2014/01/23 01:23:45 123.456.000 Server-name: svgrp
Rc: 0 Client: _HOX - 0x00000001     Server: **** Root: _HOX - 0xf784d10a  Svc-Grp:
******************************** Svc: ****************************** Trn: *

テスト対象システムにTP1/EEを使用する場合メモリ関連定義のrecv_message_buf_sizeオペランドにデフォルト値以外の値を指定することはできません。recv_message_buf_sizeオペランドにデフォルト値以外の値を指定したTP1/EEのサーバをテスト対象システムとした場合、TP1/EEでKFSB50310-Eメッセージを出力し、電文受信に失敗する場合があります。

既存システムがTP1/SB、テスト対象システムがTP1/EEという構成で、外部システムの要求電文がTP1/EEで未サポートの電文（例えば圧縮された電文）の場合、TP1/EEはその電文を破棄するため、TP1/EEをテスト対象システムとすることはできません。例えば圧縮された電文（TP1/SB:rpc_datacomp=Y、 TP1/Client:dccltdatacomp=Y）をテスト対象システムのTP1/EEのサーバに送信した場合、TP1/EEでKFSB40313-Wメッセージを出力し、受信した電文が破棄されます。

2.2.3　応答電文の比較

システムテスト支援では既存システムからの応答電文とテスト対象システムからの応答電文の比較を行います。比較内容はプロトコルレベルの比較とユーザレベルの比較を行う事が出来ます。

プロトコルレベルの比較はRPC・RAPのリターン値の比較です。

ユーザレベルの比較は、UOCを作成することでユーザ電文内容の比較が行えます。

応答電文の比較結果、内容に不一致（リターン値の相違）等があった場合、その応答電文情報を「比較エラー情報ファイル」に出力します。

リターン値が双方とも正常の場合のみUOCに応答データを渡し、ユーザデータの比較を行います。

UOC内でユーザデータの不一致を検出した場合、応答電文情報を「比較エラー情報ファイル」に出力します。

2.2.4　システムテスト支援と各TP1製品のリターンコード

システムテスト支援で表示・設定するRPC・RAPプロトコルのリターンコードと、各TP1製品のリターンコードの対応を下表に示します。以下の目的で使用してください。

システムテスト支援が表示するリターンコードの値がTP1製品のどのリターンコードに対応するかを調査する

システムテスト支援がUOCにて設定するリターンコードの値がTP1製品のどのリターンコードに対応するかを調査する。

表2‒4　TP1/SB 製品で対応するリターンコード

システムテスト支援にて表示・設定するリターンコード

TP1/SB製品で対応するリターンコード

コード

値

コード

値

ESRPCER_INVALID_ARGS

-301

DCRPCER_INVALID_ARGS

-301

ESRPCER_PROTO

-302

DCRPCER_PROTO

-302

ESRPCER_NO_BUFS

-304

DCRPCER_NO_BUFS

-304

ESRPCER_NET_DOWN

-306

DCRPCER_NET_DOWN

-306

ESRPCER_TIMED_OUT （※1）

-307

DCRPCER_TIMED_OUT

-307

ESRPCER_MESSAGE_TOO_BIG

-308

DCRPCER_MESSAGE_TOO_BIG

-308

ESRPCER_REPLY_TOO_BIG

-309

DCRPCER_REPLY_TOO_BIG

-309

ESRPCER_NO_SUCH_SERVICE_GROUP

-310

DCRPCER_NO_SUCH_SERVICE_GROUP

-310

ESRPCER_NO_SUCH_SERVICE

-311

DCRPCER_NO_SUCH_SERVICE

-311

ESRPCER_SERVICE_CLOSED

-312

DCRPCER_SERVICE_CLOSED

-312

ESRPCER_SERVICE_TERMINATING

-313

DCRPCER_SERVICE_TERMINATING

-313

ESRPCER_SERVICE_NOT_UP

-314

DCRPCER_SERVICE_NOT_UP

-314

ESRPCER_OLTF_NOT_UP

-315

DCRPCER_OLTF_NOT_UP

-315

ESRPCER_SYSERR_AT_SERVER

-316

DCRPCER_SYSERR_AT_SERVER

-316

ESRPCER_NO_BUFS_AT_SERVER

-317

DCRPCER_NO_BUFS_AT_SERVER

-317

ESRPCER_SYSERR

-318

DCRPCER_SYSERR

-318

ESRPCER_INVALID_REPLY

-319

DCRPCER_INVALID_REPLY

-319

ESRPCER_OLTF_INITIALIZING

-320

DCRPCER_OLTF_INITIALIZING

-320

ESRPCER_TRNCHK

-327

DCRPCER_TRNCHK

-327

ESRPCER_NO_SUCH_DOMAIN

-328

DCRPCER_NO_SUCH_DOMAIN

-328

ESRPCER_NO_PORT

-329

DCRPCER_NO_PORT

-329

ESRPCER_SERVER_BUSY

-356

DCRPCER_SERVER_BUSY

-356

ESRPCER_TESTMODE

-366

DCRPCER_TESTMODE

-366

ESRPCER_NOT_TRN_EXTEND

-367

DCRPCER_NOT_TRN_EXTEND

-367

ESRPCER_SECCHK

-370

DCRPCER_SECCHK

-370

ESRPCER_TRNCHK_EXTEND

-372

DCRPCER_TRNCHK_EXTEND

-372

ESRPCER_UOCERR

-380

DCRPCER_UOCERR

-380

（※1）：システムテスト支援ではESRPCER_TIMED_OUTとしている場合でも、ユーザサービスの定義「rpc_extend_function」や「watch_time」の指定により、クライアントではDCRPCER_SERVICE_TERMINATEDまたはDCRPCER_SERVICE_NOT_UPとなる場合があります。

表2‒5　TP1/Client 製品で対応するリターンコード

システムテスト支援にて表示・設定するリターンコード

TP1/Client製品で対応するリターンコード

コード

値

コード

値

ESRPCER_INVALID_ARGS

-301

DCRPCER_INVALID_ARGS

-2401

ESRPCER_PROTO

-302

DCRPCER_PROTO

-2402

ESRPCER_NO_BUFS （※1）

-304

DCRPCER_NO_BUFS

-2404

ESRPCER_NET_DOWN

-306

DCRPCER_NET_DOWN

-2406

ESRPCER_TIMED_OUT

-307

DCRPCER_TIMED_OUT

-2407

ESRPCER_MESSAGE_TOO_BIG

-308

DCRPCER_MESSAGE_TOO_BIG

-2408

ESRPCER_REPLY_TOO_BIG

-309

DCRPCER_REPLY_TOO_BIG

-2409

ESRPCER_NO_SUCH_SERVICE_GROUP

-310

DCRPCER_NO_SUCH_SERVICE_GROUP

-2410

ESRPCER_NO_SUCH_SERVICE

-311

DCRPCER_NO_SUCH_SERVICE

-2411

ESRPCER_SERVICE_CLOSED

-312

DCRPCER_SERVICE_CLOSED

-2412

ESRPCER_SERVICE_TERMINATING

-313

DCRPCER_SERVICE_TERMINATING

-2413

ESRPCER_SERVICE_NOT_UP

-314

DCRPCER_SERVICE_NOT_UP

-2414

ESRPCER_OLTF_NOT_UP

-315

DCRPCER_OLTF_NOT_UP

-2415

ESRPCER_SYSERR_AT_SERVER

-316

DCRPCER_SYSERR_AT_SERVER

-2416

ESRPCER_NO_BUFS_AT_SERVER

-317

DCRPCER_NO_BUFS_AT_SERVER

-2417

ESRPCER_SYSERR

-318

DCRPCER_SYSERR

-2418

ESRPCER_INVALID_REPLY

-319

DCRPCER_INVALID_REPLY

-2419

ESRPCER_OLTF_INITIALIZING

-320

DCRPCER_OLTF_INITIALIZING

-2420

ESRPCER_TRNCHK

-327

DCRPCER_TRNCHK

-2427

ESRPCER_NO_SUCH_DOMAIN

-328

—

—

ESRPCER_NO_PORT

-329

—

—

ESRPCER_SERVER_BUSY

-356

DCRPCER_SERVER_BUSY

-2456

ESRPCER_TESTMODE

-366

DCRPCER_TESTMODE

-2466

ESRPCER_NOT_TRN_EXTEND

-367

DCRPCER_NOT_TRN_EXTEND

-2467

ESRPCER_SECCHK

-370

DCRPCER_SECCHK

-2470

ESRPCER_TRNCHK_EXTEND

-372

DCRPCER_TRNCHK_EXTEND

-2472

ESRPCER_UOCERR

-380

DCRPCER_UOCERR

-2480

（※1）：システムテスト支援ではESRPCER_NO_BUFSとしている場合でも、TP1/Client製品ではDCRPCER_NO_BUFS_AT_SERVERとなる場合があります。

表2‒6　TP1/EE 製品で対応するリターンコード

システムテスト支援にて表示・設定するリターンコード

TP1/EE製品で対応するリターンコード

コード

値

コード

値

ESRPCER_INVALID_ARGS

-301

EERPCER_ARGUMENT

-301

ESRPCER_PROTO

-302

EERPCER_PROTO

-302

ESRPCER_NO_BUFS

-304

EERPCER_MEMORY_SHORT

-304

ESRPCER_NET_DOWN

-306

EERPCER_NET_DOWN

-306

ESRPCER_TIMED_OUT

-307

EERPCER_TIMED_OUT

-307

ESRPCER_MESSAGE_TOO_BIG

-308

EERPCER_MESSAGE_TOO_BIG

-308

ESRPCER_REPLY_TOO_BIG

-309

EERPCER_REPLY_TOO_BIG

-309

ESRPCER_NO_SUCH_SERVICE_GROUP

-310

EERPCER_NO_SUCH_SERVICE_GROUP

-310

ESRPCER_NO_SUCH_SERVICE

-311

EERPCER_NO_SUCH_SERVICE

-311

ESRPCER_SERVICE_CLOSED

-312

EERPCER_SERVICE_CLOSED

-312

ESRPCER_SERVICE_TERMINATING

-313

EERPCER_SERVICE_TERMINATING

-313

ESRPCER_SERVICE_NOT_UP

-314

EERPCER_SERVICE_NOT_UP

-314

ESRPCER_OLTF_NOT_UP

-315

EERPCER_OLTF_NOT_UP

-315

ESRPCER_SYSERR_AT_SERVER

-316

EERPCER_SYSERR_AT_SERVER

-316

ESRPCER_NO_BUFS_AT_SERVER

-317

EERPCER_NO_BUFS_AT_SERVER

-317

ESRPCER_SYSERR

-318

EERPCER_SYSERR

-318

ESRPCER_INVALID_REPLY

-319

EERPCER_INVALID_REPLY

-319

ESRPCER_OLTF_INITIALIZING

-320

EERPCER_OLTF_INITIALIZING

-320

ESRPCER_TRNCHK

-327

EERPCER_TRNCHK

-327

ESRPCER_NO_SUCH_DOMAIN

-328

—

—

ESRPCER_NO_PORT

-329

—

—

ESRPCER_SERVER_BUSY

-356

EERPCER_SERVER_BUSY

-356

ESRPCER_TESTMODE

-366

EERPCER_TESTMODE

-366

ESRPCER_NOT_TRN_EXTEND

-367

—

—

ESRPCER_SECCHK

-370

EERPCER_SECCHK

-370

ESRPCER_TRNCHK_EXTEND

-372

EERPCER_TRNCHK_EXTEND

-372

ESRPCER_UOCERR

-380

—

—

2.2.5　応答電文のデータの比較

データの比較の契機

システムテスト支援では既存システムからの応答電文とテスト対象システムからの応答電文のデータの比較を行います。

並行実行時のデータの比較

並行実行を使用する場合、既存システムからの応答電文とテスト対象システムからの応答電文がそろった時点で、データの比較を行います。

図2‒1　並行実行時のデータの比較

リプレイ実行時のデータの比較

リプレイ実行を使用する場合、蓄積ファイルから応答電文の読み込みとテスト対象システムからの応答電文がそろった時点で、データの比較を行います。

図2‒2　リプレイ実行時のデータの比較

PCAP実行時のデータの比較

PCAP実行を使用する場合、pcap形式ファイルからの応答電文とテスト対象システムからの応答電文がそろった時点で、データの比較を行います。

図2‒3　PCAP 実行時のデータ比較

製品によるデータの比較項目

製品で行うプロトコルレベルでの比較項目を以下に示します。

RPCプロトコル電文

応答電文のリターン値

RAPプロトコル電文

応答電文のリターン値

UOCによるデータの比較

既存システムからの応答電文とテスト対象システムからの応答電文をユーザレベルで比較できるようデータ比較UOCを提供します。

データ比較UOCは、応答電文にユーザデータがあり、かつプロトコルレベルで一致していたときのみ呼び出します。

本UOCでは、ユーザデータ部分を比較した結果を比較エラー情報ファイルに出力することができます。

UOCのインタフェースについては「6.4.5　データ比較UOC」を参照してください。

比較結果の出力

比較エラー情報ファイル

比較エラー情報ファイルにエラーとなった情報を出力する契機を以下に示します。

既存システムからの応答電文とテスト対象システムからの応答電文が不一致

応答電文の受信待ちタイムアウト発生

既存システムからの応答電文、またはテスト対象システムからの応答電文がエラー応答

比較エラー情報ファイルの形式については「5.3.1　比較エラー情報ファイルの形式」を参照してください。

メッセージ情報

システムテスト支援の正常終了時、応答電文の比較を行った件数やデータの比較でエラーを検出した件数等の情報をKFSE80952-Iメッセージで出力します。

2.3　TCPスルー

TCPスルーでは、外部システムが送信したパケットを1電文（TCP電文）として扱います。

既存システム向けの電文をそのままテスト対象システムへ送信します。

既存システムから外部システムへの送信電文および、テスト対象システムからシステムテスト支援へ送信された電文は全て破棄します。

2.3.1　TCPスルーの概要

システムテスト支援におけるTCPスルーの概要を以下に示します。

並行実行

図2‒4　並行実行を行った場合の概要

蓄積実行

蓄積実行が指定された場合、外部システムが送信したTCPパケットを蓄積対象とし、TCPパケットをそのまま蓄積ファイルに蓄積します。

既存システムから送信されたTCPパケットは蓄積せず破棄します。

図2‒5　蓄積実行を行った場合の概要

リプレイ・PCAP実行

リプレイ実行・PCAP実行が指定された場合、蓄積ファイル・PCAPファイルの電文を読み出し送信します。

図2‒6　リプレイ・PCAP実行を行った場合の概要

2.3.2　UOCインタフェース

TCPスルーではUOCをサポートしていません。

2.3.3　TCP電文の送信（コネクションの確立・解放）

システムテスト支援ではTCPパケットを送信時、テスト対象システムとコネクションを確立後、TCP電文を送信します。

クライアント型コネクション

address_destination定義-kオプションcnmodeフラグメンバに"client"を指定すると、TCPスルーはクライアント型コネクションとなります。クライアント型コネクションを指定した場合は、システム検証支援基盤からコネクションの確立を要求します。

コネクション確立

以下のタイミングでコネクションを確立します。

パケット送信時

TCPパケット送信時にコネクションが未確立の場合、コネクション確立を行います。

コネクション確立に失敗した場合、当該パケット破棄し、システム検証支援基盤は続行します。

コネクション解放

以下のタイミングでコネクションを解放します。

システム検証支援基盤終了時

外部システム/既存システム間のコネクション断検出時（※）

パケットロスト時

クライアントの無通信時間タイムアウト時

※：address_destinationの-k cnrlssyncにNを指定した場合は、テスト対象システムとのコネクションを解放しません。

サーバ型コネクション

address_destination定義-kオプションcnmodeフラグメンバに"server"を指定すると、TCPスルーはサーバ型コネクションとなります。サーバ型コネクションを指定した場合は、テスト対象システムからのコネクション確立要求を待ち合わせます。

コネクション確立

サーバ型コネクションを指定した場合、システム検証支援基盤は起動時にテスト対象システムからのコネクション確立要求を待ちます。

サーバ型コネクションでは、address_destination定義の-hオプションで指定したポート番号に対して同時に確立可能なコネクション数は1つです。2つ目以降のコネクションはシステム検証支援基盤が解放します。

リプレイ実行およびPCAP実行の場合は、全サーバ型コネクションがテスト対象システムからのコネクションを確立後テストを開始します。

テスト開始前にシステム検証支援基盤を終了させたい場合は「esstop –f」を実行してください。

コネクション解放

コネクション解放契機は、クライアント型コネクションの「コネクション解放」を参照してください。

コネクションを解放した場合もしくはテスト対象システムから解放された場合、そのまま次のコネクションの確立要求を待ちます。

2.3.4　フィルタリング

TCPスルーでは時刻指定などのプロトコル共通のフィルタリング機能以外のフィルタリング機能は提供していません。

2.3.5　エージェント機能

HSIC-RTM機能を使用するとき、HSIC-RTMは、ネットワークスイッチのミラーポート経由でクライアントとサーバ間の電文をキャプチャします。しかし、同一マシン内の通信や、同一筐体内の仮想マシン間の通信など、ネットワークスイッチを経由しない電文はキャプチャできません。エージェント機能によって、これらのネットワークスイッチを経由しない電文をキャプチャできます。以降、エージェント機能を使用するHSICをエージェントと呼びます。

エージェントは、クライアント、またはサーバが稼働するマシン上で常駐します。HSIC-RTMは、起動時にエージェントに対してコネクションを確立します。以降、エージェントがキャプチャしたクライアントとサーバ間の電文が、HSIC-RTMにTCP/IP通信で転送され、分析および稼働監視が行われます。

なお、エージェント稼働によるマシン負荷を軽減したい場合は、エージェント側でリソース削減モードを指定（lightmode_definition定義の-uオプションのuseフラグメンバに「Y」指定）してください。

エージェント機能でAPサーバとDBサーバ間のSQL電文をキャプチャしてHSIC-RTMで分析する場合のイメージを次に示します。

図2‒7　エージェント機能でAPサーバとDBサーバ間のSQL電文をキャプチャしてHSIC-RTMで分析する場合のイメージ図

エージェントとHSIC-RTMの定義について

エージェント機能を使用する場合、エージェント側ではTCPスルーのサーバモードの定義が必要です。エージェントとHSIC-RTMの定義例を次に示します。定義の詳細については、マニュアルHitachi System Information Capture システム分析支援 リアルタイムモニタを参照してください。なお、強調して表示しているHSIC定義のフラグメンバを必ず指定してください。

エージェント側のHSIC定義ファイル

この定義例では、エージェント機能に関連する定義を抜粋しています。なお、キャプチャするプロトコル種別に関係なく、-pオプションには「tcp」を指定してください。

lightmode_definition -u "use=Y"
address_destination -p tcp ¥
	-s "ipaddr=DBサーバのIPアドレス△portno=DBサーバのポート番号"
	-c "ipaddr=APサーバのIPアドレス△portno=APサーバのポート番号"
	-k "cnmode=server△agent=Y"
	-h "ipaddr=エージェントのIPアドレス△portno=エージェントのポート番号"

HSIC-RTM側のアダプタ連携関連定義

この定義例では、エージェント機能に関連する定義を抜粋しています。なお、プロトコル種別は、エージェント側でキャプチャする電文のプロトコル種別を指定してください。この例の場合は、HiRDBプロトコルです。

agent_server=hirdb:エージェントのIPアドレス:エージェントのポート番号:10

エージェントの起動について

キャプチャが必要となる前にesstartコマンドを-pオプション指定で実行してエージェントを起動します。マシン起動と同時にキャプチャしたい場合、マシン起動時にesstartコマンドを自動実行するようにOS設定（Windowsのスタートアップに登録など）する必要があります。

エージェントとHSIC-RTM間のコネクションについて

HSIC-RTM起動時にエージェントに対してコネクションを確立します。起動時の確立に失敗した場合はアダプタ連携関連定義で指定した間隔でリトライします。コネクション確立後、何らかの理由でコネクションが切断された場合は5秒以内にリトライします。切断されてからの5秒以内の確立に失敗した場合はアダプタ連携関連定義で指定した間隔でリトライします。なお、リトライ間隔は、最大で5秒遅延する場合があります。エージェントとHSIC-RTM間のコネクションが切断された場合、HSIC-RTM上で組み立て中だった電文はすべて破棄されます。

2.4　UDPスルー

UDPスルーでは、外部システムが送信したパケットを1電文(UDP電文)として扱います。

既存システム向けの電文をそのままテスト対象システムへ送信します。

既存システムから外部システムへの送信電文および、テスト対象システムからシステムテスト支援へ送信された電文は全て破棄します。

2.4.1　UDPスルーの概要

システムテスト支援におけるUDPスルーの概要を以下に示します。

並行実行

図2‒8　並行実行を行った場合の概要

蓄積実行

蓄積実行が指定された場合、外部システムが送信したUDPパケットを蓄積対象とし、UDPパケットをそのまま蓄積ファイルに蓄積します。既存システムから送信されたUDPパケットは蓄積せず破棄します。

図2‒9　蓄積実行を行った場合の概要

リプレイ・PCAP実行

リプレイ実行・PCAP実行が指定された場合、蓄積ファイル・PCAPファイルの電文を読み出し送信します。

図2‒10　並行実行を行った場合の概要

2.4.2　UOCインタフェース

UDPスルーではUOCをサポートしていません。

2.4.3　フィルタリング

UDPスルーでは時刻指定などのプロトコル共通のフィルタリング機能以外のフィルタリング機能は提供していません。

2.5　HTTP

HTTP（Hyper Text Transfer Protocol）を使用するWebシステムにおいて、テスト対象システム上で新規構築したWebサーバ電文を送信する機能です。

また、HTTPを通信基盤とする各種プロトコル（SOAP、REST等）のテストも行う事ができます。

HTTPを使用する上での前提条件を示します。

2.5.1　HTTPで電文を送信するための前提条件

通信構成

外部システムが既存システムに対して、コネクション確立要求、及びHTTP要求電文送信を行う構成に対応します。SOAPの非同期応答型RPC等、既存システムが外部システムにコネクション確立要求、又はHTTP要求電文する構成は、動作を保障しません。

暗号化未対応（本番環境）

HTTPS（HyperText Transfer Protocol Secure）による暗号化通信には対応しません。HTTPSをHTTP対象として指定した場合、不正電文としてHTTP電文を破棄します。

テスト対象システムのホスト名又はIPアドレス

WebクライアントはWebサーバにアクセスする時、Webサーバのホスト名又はIPアドレスを指定します（例：「http:/ホスト名/index.html」「http:/IPアドレス/index.html」）。

指定したホスト名、又はIPアドレスはHTTP電文に設定されてWebサーバへ通知され、さまざまな用途（IPベース又は名前ベースの仮想ホスト等）で使用されます。その為、IPアドレス指定時は既存システムとテスト対象システム間でIPアドレスが一致、ホスト名指定時は既存システムとテスト対象システム間でホスト名が一致していない場合は、テストで不具合が発生する可能性があります。

2.5.2　HTTP要求電文の識別子書き換え

HTTP制御では、既存システムとテスト対象システムのHTTP応答電文のヘッダを解析し、システム間の識別子のマッピング情報を作成します。HTTP要求電文の転送時は、このマッピング情報を使用しHTTP要求電文のヘッダに設定されている既存システムの識別子をテスト対象システムの識別子へ書き換えてテスト対象システムへ転送します。

識別子の書き換え例を以下に示します。

図2‒11　HTTP 要求電文の識別子書き換え

書き換え対象識別子一覧を以下に示します。

表2‒7　書き換え対象の識別子一覧

書き換え対象の識別子

書き換え先ヘッダ

（HTTP要求電文）

書き換え元ヘッダ

（HTTP応答電文）

HTTPクッキー

Cookie

Set-Cookie

Cookie2

Set-Cookie2

リソースのエンティティタグ

If-Match

ETag

If-None-Match

同上

If-Range

同上

リソースの更新時刻

If-Modified-Since

Last-Modified

If-Unmodified-Since

同上

If-Range

同上

システム検証支援基盤の正常終了時、識別子の数や書き換え回数等の統計情報をKFSE83302-Iメッセージとして出力します。

HTTPの独自ヘッダについて

HTTPの仕様上、ユーザやWeb製品が独自ヘッダをHTTP電文に追加する事ができます。

この独自ヘッダを使用してWebサーバがWebクライアントへ識別子を通知するWebシステムの場合、システムテスト支援のHTTP制御では識別子の書き換えが行えない為、テスト対象システムで識別子不正等のエラーが発生する可能性があります。

2.5.3　HTTP応答電文待ち合わせ

識別子のマッピング情報を作成、及び既存システムとテスト対象システム間のサービス実行順序維持の為HTTP応答電文の待ち合わせを行います。

既存システム又はテスト対象システムからのHTTP応答電文をキャプチャ又は受信した場合、もう片方のHTTP応答電文のキャプチャ又は受信待ちを行います。

テスト対象システムからの応答待ち中に、HTTP要求電文をキャプチャした場合はHTTP要求電文の転送を抑止し応答待ちが終了した時点でHTTP要求電文を転送します。

HTTP応答電文待ちタイマ

パケットのロスト、またはHTTP応答電文送信元マシンのスローダウン等によりHTTP応答電文が完成しない、または完成に長時間要する場合があります。

システムテスト支援ではHTTP要求電文送信からHTTP応答電文（既存システムとテスト対象システム）受信までをタイマ監視します。タイムアウトした場合は、応答待ち状態を中止してメモリリソースを解放します。

タイマ監視時間は、http_definition定義の-tオプションのreply_watchtimeで指定します。

address_destination定義の-iオプションのwatchtimeに「0」以外を指定した場合、HTTP応答電文待ちタイマの監視中も無通信監視が行われます。

その為、「watchtimeフラグメンバ値＞reply_watchtime値」となるよう設定してください。

正しく設定しなかった場合はHTTP応答電文待ち中に無通信時間監視のタイムアウトが発生し、HTTP応答電文が受信できない可能性があります。

既存システムのWebクライアントでもHTTP応答電文待ちを行っています。

応答待ち時間が「Webクライアントの応答待ち時間＞システムテスト支援の応答待ち時間」の場合、WebクライアントはHTTP応答電文を正常受信、システムテスト支援は応答待ちタイムアウトとなる可能性があります。この場合、次のHTTP要求電文用の識別子マッピング情報が作成できていない為、テスト対象システムで識別子不正が発生する可能性があります。その為、「Webクライアントの応答待ち時間＜システムテスト支援の応答待ち時間」となるようにタイマ値を設定してください。

2.5.4　HTTPの概要

システムテスト支援におけるHTTPの概要を以下に示します。

並行実行

図2‒12　並行実行を行った場合の概要

蓄積実行

蓄積実行が指定された場合、外部システムが送信したHTTPパケットと既存システムから送信されたHTTPパケット（応答）を蓄積対象とし、HTTPパケットを組み立て蓄積ファイルに蓄積します。

図2‒13　蓄積実行を行った場合の概要

リプレイ・PCAP実行

リプレイ実行・PCAP実行が指定された場合、蓄積ファイル・PCAPファイルの電文を読み出し送信します。

図2‒14　PCAP 実行を行った場合の概要

2.5.5　テスト対象システム（Webサーバ）とのHTTPS通信

概要

HSICとテスト対象システム（Webサーバ）間において、SSLで暗号化したHTTPS（Hypertext Transfer Protocol Secure）通信を行います。これにより、HTTPS対応のテスト対象システムをテストできます。

HSICは、本番環境のHTTPS通信には対応していません。テスト実行時は、本番環境のHTTP通信をパケットキャプチャし、テスト対象システムとHTTPS通信でテストを行います。

電文の暗号化／復号化は、テスト対象システムとの送受信時HSICが自動的に行うため、フレームワーク機能（「1.5　フレームワーク機能（ユーザ独自のシステムテストの支援）」を参照）のプラグイン及びUOCに渡される電文は、暗号化されていない平文となります。

図2‒15　テスト対象システム（Webサーバ）とのHTTPS通信

HTTPS通信を行う場合、address_destination定義の-tオプションのssl_useフラグメンバにY（デフォルトはN）を指定します。テスト対象システムが複数存在する場合、テスト対象システム毎に、HTTPS通信有無を指定します。

前提条件

OpenSSL

本機能は、OpenSSLのバージョン1.0.1、または1.0.2以降を使用して暗号処理を行います。HSIC実行マシン上にOpenSSLバージョン1.0.1、または1.0.2以降がインストールされていない場合は、テスト実行前にOpenSSLをインストールしてください。OpenSSLの入手方法やインストール方法等については、OpenSSL公式サイト、またはインストーラ配布サイトで確認してください。

Windows版の場合

OpenSSLインストール後、PATH環境変数にOpenSSLインストールディレクトリ¥binを指定してください。

Linux版の場合

OpenSSLインストール後、LD_LIBRARY_PATH環境変数にOpenSSLライブラリが格納されているパス指定してください。

テスト実行時、前提となるOpenSSLバージョンがインストールされていない、または必要な環境設定が行われていない場合は、KFSE61834-Eメッセージを出力し、HSICがプロセスダウンします。

クライアント認証未対応

クライアント認証機能に対応していません。テスト対象システム側が、クライアント認証未使用時にエラーとする設定の場合、テスト時にKFSE43301-Wメッセージを出力し、該当テスト対象システムのテストが失敗します。そのため、テスト対象システム側のクライアント認証設定を、認証不要、または省略可能に設定してください。設定方法については、テスト対象システムの該当Webサーバのマニュアルを参照してください。

暗号プロトコル

HTTPS通信で使用する暗号プロトコルは、HSIC（OpenSSL）とテスト対象システム間のSSLハンドシェイクにより、TLS V1.0以降の暗号プロトコルが自動的に決定されます。

テスト対象システムがTLS V1.0以降に対応していない、または、セキュリティ上の問題等により任意の暗号プロトコルを使用したい場合は、address_destination定義の-tオプションのssl_protocolフラグメンバで、使用したい暗号プロトコルを指定（複数指定可）します。SSLハンドシェイクでは、指定された暗号プロトコルの中から、使用する暗号プロトコルが決定されます。指定した全ての暗号プロトコルがテスト対象システムで使用できない場合は、KFSE43301-Wメッセージが出力され、該当テスト対象システムのテストが失敗します。

以下に、指定可能な暗号プロトコルを示します。

SSL V2.0※

SSL V3.0※

TLS V1.0

TLS V1.1

TLS V1.2

注※

定義で明示的に指定した場合のみ、SSL V2.0及びSSL V3.0が使用できます。

2.5.6　UOCインタフェース

HTTPではUOCをサポートしていません。

2.5.7　HTTP電文の送信（コネクションの確立・解放）

システムテスト支援ではHTTP電文を送信時、テスト対象システムとコネクションを確立後、HTTP電文を送信します。

HTTP電文送信時にコネクション確立に失敗した場合、当該HTTP電文を破棄し、システムテスト支援を続行します。

システムテスト支援は以下のタイミングでテスト対象システムとのコネクションを解放します。

システムテスト支援終了時

外部システム、既存システム間のコネクション断検出時

クライアントの無通信時間タイムアウト時

2.5.8　フィルタリング

HTTPでは時刻指定などのプロトコル共通のフィルタリング機能以外のフィルタリング機能は提供していません。

2.5.9　gzip形式で圧縮されたHTTP電文の解凍および再圧縮

概要

パケットキャプチャ、またはpcapファイル内のHTTP電文がgzip形式で圧縮されていた場合、解凍します。解凍されたHTTP電文は、送信するときに再圧縮してテストを実行します。

gzip形式で圧縮されていないHTTP電文は、そのまま処理します。この機能を利用することで、電文ファイルおよび結果ファイルに解凍されたデータが格納されます。

本番環境を再現するテスト

本番環境の電文の圧縮、および非圧縮をテスト実行フェーズで再現してテストを行う場合の処理の流れを次に示します。

図中の番号は、次の説明の番号と対応しています。

キャプチャしたパケットを電文に組立てる際、またはpcapファイルから電文を取得する際に、HTTP電文がgzip形式で圧縮されていた場合は解凍します。HTTP電文が非圧縮の電文はそのまま処理します。

1.で解凍した電文をテスト対象システムに送信するときに再圧縮します。

非圧縮の電文はそのまま処理します。

応答電文を取得した際、電文がgzip形式で圧縮されていた場合は解凍します。

非圧縮の電文はそのまま処理します。

本番環境の再現以外のテスト

webサーバの負荷や、ネットワークの負荷を変更したい場合は、この機能を使用し、HTTP電文の圧縮および非圧縮を変更します。

この機能を使用するには、framework_definition定義の-uオプションの次に示すフラグメンバを使用します。

request_force_encoding

response_force_encoding

応答電文を圧縮して返す要求をした処理の例を次に示します。

前提条件

zlibライブラリ

gzip形式で圧縮されているHTTP電文の解凍、および圧縮処理は、zlibライブラリのバージョン1.2.3以降を使用して処理をします。HSIC実行マシン上にzlibライブラリのバージョン1.2.3以降がインストールされていない場合、テスト実行前にzlibライブラリをインストールしてください。zlibライブラリの入手方法については、zlib公式サイト、またはインストーラ配布サイトなどで確認してください。

Windowsの場合

インストール後、PATH環境変数にzlibライブラリインストールディレクトリを指定してください。

Linux版の場合

インストール後、LD_LIBRARY_PATH環境変数にzlibライブラリが格納されているディレクトリのパスを指定してください。

本機能未対応のバージョンで作成した蓄積ファイルについて

本機能未対応のバージョンのシステムテスト支援で作成した蓄積ファイルをテスト実行フェーズで使用する場合、本機能は使用できません。

フラグメンバcompression_encodingの指定値について

フラグメンバcompression_encodingは、電文作成フェーズとテスト実行フェーズで同じ指定値にしてください。

gzip以外の圧縮形式について

本機能は、gzip以外の圧縮形式には対応していません。gzip以外の圧縮形式のHTTP電文を使用する場合、本機能は使用できません。

定義

compression_encoding

フラグメンバcompression_encodingの指定値がgzipで、電文ファイルや結果ファイルに格納する前のHTTP電文がgzip形式で圧縮されていた場合、HTTP電文を解凍します。解凍したHTTP電文は再圧縮してテスト対象システムに送信します。

フラグメンバcompression_encodingの指定値がnoneの場合、HTTP電文の解凍、および圧縮処理は行いません。

request_force_encoding

フラグメンバrequest_force_encodingの指定値がgzipの場合、テスト対象システムに対する要求を強制的に変更し、テスト対象システムにHTTP要求電文を送信する際、強制的にすべてgzip形式で圧縮して送信します。

指定値がidentityの場合、強制的にすべて非圧縮のままHTTP要求電文を送信します。

指定値がnoneの場合、HTTP要求電文は本番環境と同じ形式になります。

response_force_encoding

フラグメンバresponse_force_encodingの指定値がgzipの場合、テスト対象システムに対する要求を強制的に変更し、テスト対象システムからの応答電文を、すべてgzip形式で圧縮するように要求します。

指定値がidentityの場合、テスト対象システムに対する要求を強制的に変更し、応答電文をすべて非圧縮で送るように要求します。

指定値がnoneの場合、応答電文は本番環境と同じ形式になります。

フラグメンバの指定値と電文の形式との関係を次に示します。

表2‒8　フラグメンバの指定値と要求電文の形式との関係

本番環境の要求電文

フラグメンバの指定値

電文ファイル、および結果ファイルの要求電文

テスト環境の要求電文

compression_encoding

request_force_encoding

圧縮

gzip

gzip

非圧縮

圧縮

identity

非圧縮

none

圧縮

none

－

圧縮

圧縮

非圧縮

gzip

gzip

非圧縮

圧縮

identity

非圧縮

none

none

－

（凡例）－：該当しません。

表2‒9　フラグメンバの指定値と応答電文の形式との関係

本番環境の応答電文

フラグメンバの指定値

電文ファイル、および結果ファイルの応答電文

テスト環境の応答電文

compression_encoding

response_force_encoding

圧縮

gzip

gzip

非圧縮

圧縮

identity

非圧縮

none

圧縮

none

－

圧縮

圧縮

非圧縮

gzip

gzip

非圧縮

圧縮

identity

非圧縮

none

none

－

（凡例）－：該当しません。

注意事項

最大メッセージサイズについて

framework_definition定義の-bオプションのフラグメンバmax_message_sizeの指定値は、テストに使用する電文の非圧縮時のデータの中で、最もメッセージサイズの大きい電文のメッセージサイズを上回る値を設定してください。

2.6　IIOP

IIOPテスト機能について説明します。

2.6.1　IIOPテスト機能の概要

HSICのIIOPテスト機能の概要を説明します。

IIOPテスト機能では、CORBAクライアント/サーバ間のIIOPプロトコル電文を使用して、実際の業務に近い形でテスト対象システムの高負荷テストやリグレッションテストなどを実施できます。

テスト対象外の不要電文の破棄やテスト電文の増幅、クライアント追加による多重実行などをカスタマイズできます。また、UOCインタフェースを提供しており、ユーザ独自の電文変換などを実施できます。

テスト完了後は、テスト内容を結果ファイルや比較エラー情報ファイルへ出力します。このファイルによって、テスト結果（成功 or 失敗）判定や性能評価を実施できます。

次に、IIOPテスト機能を使用したテストイメージを示します。

IIOPテスト機能は、HSICのフレームワーク機能を使用します。一部の用語については、「1.5　フレームワーク機能（ユーザ独自のシステムテストの支援）」を参照してください。

図2‒16　IIOPテスト機能によるテストイメージ

2.6.2　IIOPテスト機能の実行形態

IIOPテスト機能では、次のテスト実行形態を提供します。

本番環境の電文を使用した2フェーズ（電文作成フェーズとテスト実行フェーズ）でのテスト実行

pcap形式ファイルを使用したテスト実行（PCAP実行）

2フェーズでのテスト実行

電文作成フェーズ

テスト準備を行うフェーズでシステムテスト支援の蓄積実行に相当します。本番環境の電文をキャプチャし、電文ファイル（蓄積ファイル）に格納します。電文ファイルはテスト実行フェーズで使用します。

電文収集

本番環境からキャプチャしたパケットを組立て、要求電文／応答電文を作成します。

電文蓄積

UOC指示により電文をテスト用に編集し、電文ファイルに格納します。

テスト実行フェーズ

実際にテストを行うフェーズで、システムテスト支援のリプレイ実行に相当します。電文ファイル内の要求／応答電文を使用してテストを実行します。

電文取得

電文ファイルから要求電文と応答電文（既存）を取得します。

要求電文送信

要求電文をテスト対象システムへ送信します。送信失敗時は4.を実行します。

応答電文作成

テスト対象システムから受信したパケットを組立て、応答電文（テスト）を作成します。

結果判定

応答電文（テスト）を基にテスト結果を判定し、比較エラー情報ファイルにエラー情報を格納します。また、電文情報を結果ファイルへ格納します。

pcap形式ファイルを使用したテスト実行

pcap形式ファイル内の要求／応答電文を使用したテスト実行で、システムテスト支援のPCAP実行に相当します。

パケットキャプチャツール（tcpdump等）を使用し、本番環境のIIOPプロトコル電文が格納されたpcap形式ファイルを作成しておく必要があります。

電文取得

pcap形式ファイルから要求電文と応答電文（既存）を取得します。

要求電文送信

要求電文をテスト対象システムへ送信します。送信失敗時は4.を実行します。

応答電文作成

テスト対象システムから受信したパケットを組立て、応答電文（テスト）を作成します。

結果判定

応答電文（テスト）を基にテスト結果を判定し、比較エラー情報ファイルにエラー情報を格納します。また、電文情報を結果ファイルへ格納します。

2.6.3　IIOPテスト機能の前提条件

IIOPテスト機能の前提条件を次に示します。

IIOPに関する制限

GIOPプロトコルのバージョンは1.2のみ対応しています。その他のバージョンについては、UOCを呼び出さずにテスト対象システムに送信します。ただし、GIOPプロトコルのバージョンが1.1のフラグメント電文は破棄します。

ネーミングサービスには対応していません。ネーミングサービス使用時は、サーバ関連定義address_destinationの指定に従ってテスト対象システムへ送信します。

双方向IIOPには対応していません。サーバからのRequest電文は破棄します。

次の制御電文については、テスト対象外として破棄します。

・CancelRequest（クライアントから送信時）

・CloseConnection

・MessageError

・LocateRequest

・LocateReply

フラグメントによりRequestおよびReply電文の分割を行う場合、初回に送信する分割電文に含まれるRequestおよびReplyヘッダにサービスコンテキストが完全に含まれている必要があります。

テスト対象システムからのReply電文のうち、以下のreply_statusには対応していません。サーバ関連定義address_destinationの指定に従ってテスト対象システムへ送信します。

・LOCATION_FORWARD

・LOCATION_FORWARD_PERM

・NEED_ADDRESSING_MODE

Request電文のTargetAddressのうち、ProfileAddrとReferenceAddrには対応していません。該当の電文を受信したときは、電文を破棄するか、UOCを呼び出さずにテスト対象システムに送信します。

IIOP電文のサイズは、プロトコルヘッダを含めてframework_definition定義の-b max_message_size指定値以下でなければなりません。超過したときは電文を破棄します。また、蓄積ファイルを使用するときは、accumulate_file定義の-b size指定値以下でなければなりません。超過したときはプロセスダウンします。

その他

複数のRequest電文の送信を同じコネクションで共用している場合、テスト対象システムへの送信はシリアライズされます。

2.6.4　IIOPテスト機能のシリアライズ機能

IIOPテスト機能のシリアライズ機能について説明します。

テスト対象システムへの要求電文の送信からテスト結果判定までの一連の処理をシリアライズしてテストを実行します。シリアライズできる単位は次に示す2つあり、IIOPテスト関連定義iiop_definitionの-cオプションのserial_typeフラグメンバで指定します。

コネクション単位

クライアントIPアドレス単位

コネクション単位

コネクション単位は、本番環境でのクライアントとサーバ間のコネクションごとに、シリアライズしてテストを実行します。

クライアントIPアドレス単位

クライアントIPアドレス単位は、本番環境でのクライアントのIPアドレスごとに、シリアライズしてテストを実行します。

2.6.5　IIOPテスト機能の電文増幅機能

本番環境の要求電文を複製してテスト対象システムに送信できます。本機能は、実行形態がリプレイ実行またはPCAP実行の場合だけ使用できます。

複製して増幅した電文は、複製元となった電文と同じ内容で送信します。電文を増幅しても、キャプチャ電文の送信順序は維持されます。増幅電文が、複製元となった電文よりあとに送信されることはありません。

電文増幅の形態は次に示す3つあります。

電文追加UOCによる電文追加

電文追加UOCによるクライアント増幅

pcap形式ファイルの再読込み

pcap形式ファイルの再読み込みについては、「5.5.1　pcap形式ファイルの再読込み」を参照してください。ここでは、電文追加、およびクライアント増幅について説明します。

電文追加

要求電文を複製し、複製元の電文と同じクライアントからの電文として追加します。テストは、クライアントごとにシリアライズして実行します。

図2‒17　電文追加の概要

電文追加は、電文追加UOCが電文追加のリターンコードでリターンする度に行います。再呼び出しされたUOCは、元の要求電文と同じ電文が引数に設定されており、電文を複製して新しい要求電文として追加することができます。

電文追加の例を次の図に示します。

図2‒18　電文追加UOCの呼び出し（電文追加）

図2‒19　電文追加の間隔（電文追加）

電文追加で複製した電文のあとに後続の電文を送信するため、増幅前の電文同士の送信間隔を超過することがあります（図中の電文Bのケース）。その場合は、後続の電文は即座に送信します。

クライアント増幅

要求電文を複製し、複製元の電文と別のクライアントからの電文として追加します。テストは、パラレルに実行します。

図2‒20　クライアント増幅の概要

クライアント増幅は、電文追加UOCのインタフェースでクライアント増幅数を指定することで行います。クライアント増幅で複製した電文は、それぞれが複製元の電文と異なるクライアントからの電文として扱います。クライアント増幅の遅延時間が指定されている場合は、複製した各電文を指定時間ずらして送信します。

クライアント増幅の例を次の図に示します。

図2‒21　クライアント増幅（クライアント一律で遅延させる場合）

図2‒22　クライアント増幅（クライアント単位で遅延させる場合）

電文追加とクライアント増幅の併用

電文追加によって同一クライアントの増幅した電文を、さらに増幅して別クライアントとしてテストしたい場合は、電文追加UOCの指定によって、電文追加とクライアント増幅を併用して実行することができます。

電文追加の送信間隔

電文追加UOCで指定する電文追加の送信間隔は、reply_send_mode定義で指定した値の影響を受けます。倍速送信実行を指定している場合は、指定した倍速値分短縮した間隔となります。等間隔送信実行、または連続送信実行を指定している場合は、UOCで設定した値を無視します。

2.6.6　IIOPテスト機能の結果判定機能

結果判定機能は、テスト実行状態とテスト対象システムからの応答電文を基に、プロトコルレベルでテスト結果を自動判定後、ユーザデータ部分について結果判定UOCを呼び出して結果判定を行います。

プロトコルレベルでテスト結果が正常の場合だけ結果判定UOCを呼び出します。

判定結果が異常のときは、比較エラー情報ファイルにエラー情報を出力します。また、テスト電文（要求／応答）を定義、および編集UOC（蓄積）の指示に従って結果ファイル（テスト用の要求電文蓄積ファイル、テスト用の応答電文蓄積ファイル）へ出力します。

次に、1つの要求電文のテスト結果判定の流れを示します。

図2‒23　テスト結果判定の流れ

次に示すどれかのエラー条件を満たした場合は、テスト失敗（判定結果が異常）と判断します。それ以外の場合は、テスト成功と判断します。結果判定は項番の昇順に行い、条件を満たした時点で、そのエラー条件に対応する「テスト結果」文字列を、比較エラー情報ファイルのユーザ情報文字列に出力します。

表2‒10　エラー条件一覧

項番

分類

エラー条件

「テスト結果」文字列

1

テスト実行状態

テスト対象システムとのコネクション確立が失敗した

SEND_CONNECTION

2

テスト対象システムへの要求電文の送信に失敗した

SEND_ERROR

3

テスト対象システムからの応答電文受信前に、テスト対象システムとのコネクションが切断された

RECV_CONNECTION

4

テスト対象システムからの応答電文待ちがタイムアウトした

RECV_TIMEOUT

5

プロトコルレベル※

テスト対象システムから受信した応答電文がユーザ例外

STATUS_CODE-USER

6

テスト対象システムから受信した応答電文がシステム例外

STATUS_CODE-SYSTEM

7

テスト対象システムから受信した応答電文がCancelRequest

STATUS_CODE-CANCEL

注※

KFSE80952-Iメッセージでは、「ユーザエラー／不一致件数」にカウントされます。

比較エラー情報ファイルのエラー要因は、「USER」として出力されます。

2.6.7　IIOPテスト機能のテスト実行の流れ

電文作成フェーズ（蓄積実行）

電文作成フェーズは、テスト準備を行うフェーズです。

図2‒24　電文作成フェーズ（蓄積実行）の概要

IIOP電文キャプチャ

キャプチャしたIIOP電文を組み立てます。

編集UOC（蓄積）

編集UOCが指定されている場合、IIOP電文を引数にUOCを呼び出します。UOCは必要に応じて電文を編集し、結果を返却してください。

テスト実行フェーズ（リプレイ実行）

テスト実行フェーズは、実際のテストを行うフェーズです。

図2‒25　テスト実行フェーズ（リプレイ実行）の概要

編集UOC（復元）

編集UOCが指定されている場合、要求電文（本番）または応答電文（本番）を引数にUOCを呼び出します。ユーザは、電文の編集を行うことができます。また、本UOCにて、当該電文を破棄することもできます。

電文追加UOC

電文追加UOCが指定されている場合、要求電文（本番）を引数にUOCを呼び出します。ユーザは、電文追加、およびクライアント追加の指示を行うことができます。詳細は、「2.6.5　IIOPテスト機能の電文増幅機能」を参照してください。

編集UOC（送信）

編集UOCが定義されている場合、要求電文（テスト）を引数にUOCを呼び出します。ユーザは、電文に対して、独自の電文編集処理を行う事ができます。また、本UOCにて、当該電文を破棄することもできます。

IIOP電文送信

要求電文（テスト）をテスト対象システムへ送信します。

要求電文（テスト）の送信後、応答電文（テスト）の受信待ちを行います。応答電文受信時は、5.以降の処理を行います。

framework_definition定義の-tオプションのreply_watchtimeフラグメンバが0以外の場合、応答電文の受信完了までをタイマ監視します。

送信障害や応答待ちタイムアウト等の障害が発生した場合は、9.以降の処理を行います。

IIOP電文組み立て

テスト対象システムから受信したパケットを組み立て、電文を復元します。

編集UOC（受信）

編集UOCが定義されている場合、応答電文（テスト）を引数にUOCを呼び出します。ユーザは、電文に対して、独自の電文編集処理を行うことができます。また、本UOCにて、当該電文を破棄することもできます。

プロトコルレベル判定

プロトコルレベルでのテスト結果を判定します。判定の詳細は「2.6.6　IIOPテスト機能の結果判定機能」を参照してください。

結果判定UOC

結果判定UOCが指定されている場合、IIOP電文等を引数にUOCを呼び出します。UOCはデータ内容等を基にテスト結果を判定し、結果を返却してください。

編集UOC（蓄積）

編集UOCが指定されている場合、IIOP電文を引数にUOCを呼び出します。UOCは必要に応じて電文を編集し、結果を返却してください。本UOCにて、当該電文を破棄することもできます。

ファイル出力

要求電文（テスト）、応答電文（テスト）、およびテスト結果を、結果ファイルと比較エラー情報ファイルに出力します。

PCAP実行

pcap形式ファイルを使用したテストです。

図2‒26　PCAP実行の概要

IIOP電文組み立て

pcap形式ファイル内のIIOP電文を組み立てます。

電文追加UOC

電文追加UOCが指定されている場合、要求電文（本番）を引数にUOCを呼び出します。ユーザは、電文追加、およびクライアント追加の指示を行うことができます。詳細は、「2.6.5　IIOPテスト機能の電文増幅機能」を参照してください。

編集UOC（送信）

編集UOCが定義されている場合、要求電文（テスト）を引数にUOCを呼び出します。ユーザは、電文に対して、独自の電文編集処理を行う事ができます。また、本UOCにて、当該電文を破棄する事もできます。

IIOP電文送信

要求電文（テスト）をテスト対象へ送信します。

要求電文（テスト）の送信後、応答電文（テスト）の受信待ちを行います。応答電文受信時は、5.以降の処理を行います。

framework_definition定義の-tオプションのreply_watchtimeフラグメンバが0以外の場合、応答電文の受信完了までをタイマ監視します。

送信障害や応答待ちタイムアウト等の障害が発生した場合は、9.以降の処理を行います。

IIOP電文組み立て

テスト対象システムから受信したパケットを組み立て、電文を復元します。

編集UOC（受信）

編集UOCが定義されている場合、応答電文（テスト）を引数にUOCを呼び出します。ユーザは、電文に対して、独自の電文編集処理を行う事ができます。また、本UOCにて、当該電文を破棄する事もできます。

プロトコルレベル判定

プロトコルレベルでのテスト結果を判定します。判定の詳細は「2.6.6　IIOPテスト機能の結果判定機能」を参照してください。

結果判定UOC

結果判定UOCが指定されている場合、IIOP電文等を引数にUOCを呼び出します。UOCはデータ内容等を基にテスト結果を判定し、結果を返却してください。

編集UOC（蓄積）

編集UOCが指定されている場合、IIOP電文を引数にUOCを呼び出します。UOCは必要に応じて電文を編集し、結果を返却してください。本UOCにて、当該電文を破棄する事もできます。

ファイル出力

要求電文（テスト）、応答電文（テスト）、およびテスト結果を、結果ファイルと比較エラー情報ファイルに出力します。

2.6.8　IIOPテスト機能のテスト手順

本番環境の電文を使用した2フェーズでのテスト手順

本番環境の電文を使用した2フェーズでのテスト手順について説明します。

図2‒27　本番環境の電文を使用した2フェーズでのテスト手順

UOC作成

テスト内容に応じてUOC用ライブラリを作成します。UOC用ライブラリの作成方法は「6.3　ユーザオウンコーディング（UOC）の作成」を参照してください。作成したUOCはHSIC定義ファイルで指定します。また、UOCインタフェースについては、「7.2　プラグイン機能のUOCインタフェース」を参照してください。

HSIC定義ファイル作成

IIOPテスト機能用のHSIC定義ファイルを作成します。定義については、「3.　システムテスト支援のシステム定義」を参照してください。

電文作成フェーズ実行

esstartコマンドを-m CREATE -aで実行し、HSICを電文作成フェーズで起動します。電文作成フェーズを終了するときは、esstopコマンドを実行してください。

テスト実行フェーズ実行

esstartコマンドを-m TEST -rで実行し、HSICをテスト実行フェーズで起動します。電文ファイルの読み込みが全て終了した時点で、HSICが終了します。テスト実行途中で終了するときは、esstopコマンドを実行してください。

pcap形式ファイルを使用したテスト手順

pcap形式ファイルを使用したテスト手順について説明します。

図2‒28　pcap形式ファイルを使用したテスト手順

UOC作成

テスト内容に応じてUOC用ライブラリを作成します。UOC用ライブラリの作成方法は「6.3　ユーザオウンコーディング（UOC）の作成」を参照してください。作成したUOCはHSIC定義ファイルで指定します。

HSIC定義ファイル作成

IIOPテスト機能用のHSIC定義ファイルを作成します。定義については、「3.　システムテスト支援のシステム定義」を参照してください。

PCAP実行

esstartコマンドを-m TEST -cで実行し、HSICを起動します。pcap形式ファイルの読み取りが終了した時点で、自動的にはHSICは終了します。テスト実行途中で終了するときは、esstopコマンドを実行してください。

2.6.9　IIOPテスト機能のシステム定義

IIOPテスト機能で必須の定義、および関連性の高い定義を次に示します。定義の詳細については、「3.　システムテスト支援のシステム定義」を参照してください。

表2‒11　必須及び関連性の高い定義一覧

定義名称

オプション

フラグメンバ

指定値

設定要否

framework_definition

-u

use

Y

◎

serialize

シリアライズ有無

○

-p

name

IIOP

◎

library_file_name

Linuxの場合：

/opt/HSIC/lib/libsic_iiop.so

Windowsの場合：

インストールディレクトリ¥bin¥libsic_iiop.dll

（プラグインのライブラリファイル名）

◎

startend_entry_point

es_plg_iiop_startend（開始終了プラグインのエントリポインタ名）

◎

information_entry_point

es_plg_iiop_information（電文情報プラグイン）

◎

edit_entry_point

es_plg_iiop_edit（電文編集プラグイン）

◎

send_entry_point

es_plg_iiop_send（電文送信プラグイン）

◎

receive_entry_point

es_plg_iiop_receive（電文受信プラグイン）

○

judge_entry_point

es_plg_iiop_judge（結果判定プラグイン）

◎

amplify_entry_point

es_plg_iiop_amplify（電文増幅プラグイン）

◎

-t

reply_watchtime

応答待ち時間

○

build_message_watchtime

後続パケット待ち時間

○

-b

max_message_size

最大メッセージサイズ

○

telegram_area_size

connection_area_size

client_area_size

1

◎

-f

telegram_file_type

afl

◎

result_file_type

afl

◎

iiop_definition

-c

serial_type

シリアライズ単位

○

address_destination

-p

-

iiop

◎

-s

ipaddr

既存システムのIPアドレス

◎

portno

既存システムのポート番号

○

-t

ipaddr

テスト対象システムのIPアドレス

◎

portno

テスト対象システムのポート番号

◎

plugin_definition

-u

library_file_name

IIOP用UOCのライブラリ名

○

uoc_send

送信電文編集UOCのエントリポインタ

○

uoc_receive

受信電文編集UOCのエントリポインタ

○

uoc_accumulate

蓄積編集UOCのエントリポインタ

○

uoc_restore

復元UOCのエントリポインタ

○

uoc_judgement

結果判定UOCのエントリポインタ

○

uoc_amplify

電文追加UOCのエントリポインタ

○

process_definition

-s

uoc_stack_size

32+ユーザスタックサイズ

◎

accumulate_file

-b

size

蓄積バッファサイズ

○

（凡例）

◎：必須

○：省略可

3　システムテスト支援のシステム定義

システムテスト支援のシステム定義について説明します。

3.1　システム定義の作成

システムテスト支援のシステム定義の構成、定義の作成手順について説明します。

システムテスト支援に関する情報を定義します。システムテスト支援で動作する構成や、実行環境の定義です。

3.2　定義の規則

3.2.1　記述形式

システムテスト支援定義の記述形式について以下に示します。

なお、スペース、空白（文中の'△'）は一つ以上の空白文字（半角スペース、水平タブ）を示します。

コマンド形式

コマンド形式では次の形式に従ってオプション、および引数を設定します。

形式
コマンド名　オプション

用語の定義を次に示します。

コマンド名

定義コマンド名称です。

オプション

マイナス記号で始まる文字列です。

引数を取らない形式1と引数を必要とする形式2、形式3の3つがあります。

形式1　−オプションフラグ

形式2　−オプションフラグ△フラグ引数

形式3　−オプションフラグ△"フラグメンバ=指定値[△フラグメンバ=指定値…]"

（凡例）

オプションフラグ

マイナス記号に続く1文字の英数字である。

英大文字と英小文字は区別する。

フラグ引数

オプションフラグに対する文字列である。

フラグメンバ

オプションフラグに対する設定項目を示す文字列である。

フラグメンバに対する文字列を=に続けて指定する。

複数のフラグメンバを指定する場合は、指定値の後ろにスペース区切りで指定する。

コメント

コメントを記入する場合は、コメントの先頭に'#'を記述してください。

行の先頭に'#'を記述すると1行全体がコメント扱いになります。

形式1　定義の記述　　　#コメント・・・・・・
形式2　#コメント・・・・・・・

形式1の場合、コメント文字「#」の前にスペースを入力してください。

コメント文字「#」がある行は、「#」以降の文字列がすべてコメントとして認識されます。そのため、継続させたい行（「¥」をつける行）には、コメントを記入できません。

ただし、引用符で囲んだ文字列の中に「#」がある場合は、「#」および「#」以降の文字列は、文字として認識されます。

行の継続

定義の1行の長さはコメントを含めて最大4096バイトです。

1024バイトを超える指定の場合は、複数行に分けて記述してください。

行を継続させるには、行の末尾に継続文字「¥」を記述し、その直後で改行してください。

・行の継続は、継続文字「¥」と改行文字（「¥n」）が連続して初めて継続と見なします。

・継続行の先頭にスペースがある場合は、スペースも含めて継続されます。

（例）

1行目：ABC¥「¥n」

2行目：△¥¥n¥「¥n」

3行目：D

→ABC△Dと解釈します。

ABCDと解釈させたい場合は、2行目の△を削除してください。

連続した「¥」の次が改行文字（「¥n」）の場合は、連続した「¥」の最後の「¥」が継続文字として認識されます。それ以前の「¥」はすべて文字として認識されます。

文字列の最後の「¥」を文字として認識させたい場合は、「¥」の後ろにスペースを入力してください。

（例）

AB¥¥△「¥n」

↑文字として「¥」を認識する。

継続している複数の行の途中にコメントを挿入することはできません。

（例）AA BBと認識されない場合

1行目：AA¥「¥n」

2行目：#コメント ¥「¥n」

3行目：BB

→コメント行に記述した継続文字「¥」は認識されないため、

AA

BB

と別の行として認識される。

注意事項

コマンド形式

フラグ引数を持たないオプションフラグ「−英数字1」「−英数字2」は、「−英数字1英数字2」のように指定できません。

（例）

-a、-bオプションフラグは「-ab」と指定できません。

オプションフラグの指定順序は任意です。

定義にはコマンド名、オプションフラグ、フラグ引数の区切りは、スペースで記述してください。

フラグ引数で指定値をコロン「:」またはカンマ「,」で区切る場合は、「:」、「,」の前後にスペースを入力しなでください。

利用可能な文字

改行文字「¥n」はLFのみを指定可能とする。CR+LFやCRは不可とします。

ASCII文字のみ記述可能とする。非ASCII文字は記述不可とします。

3.2.2　記号の説明

文法記述記号

オプションおよびコマンド引数を説明する記号を示します。各記号の意味を以下に示します。

表3‒1　文法記述記号一覧

文法記述記号

意味

[　　]

この記号で囲まれている項目は省略してもよいことを示す。

・・・

この記号で示す直前の項目を繰り返し指定できることを示す。

（例）[［,ポート番号:自ホスト名称］・・・］

これは、ポート番号:自ホスト名称を繰り返し指定出来ることを示す。

{{ }}

この記号で囲まれた複数の項目が一つの繰り返し項目の単位であることを示す。

{ }

この記号で囲まれている複数の項目のうちから一つを選択することを示す。項目の区切りは｜で示す。

｜

この記号で区切られた項目は選択できることを示す。

＿

（下線）

この記号で示す項目は、該当オペランド、オプションまたはコマンド引数を省略した場合の省略時解釈値を示す。

属性表示記号

ユーザ指定値の範囲などを説明する記号です。各記号の意味を以下に示します。

表3‒2　属性表示記号一覧

属性表示記号

意味

〜

この記号のあとにユーザ指定値の属性を示します。

《 》

ユーザが指定を省略したときの値を示します。

〈 〉

ユーザ指定値の構文要素を示します。

(( ))

ユーザ指定値の範囲を示します。

構文要素記号

ユーザ指定値の内容を説明する記号です。各記号の意味を以下に示します。

表3‒3　構文要素記号一覧

構文要素記号

意味

英字

アルファベット（A〜Z、a〜z）と_（アンダスコア）

大文字英字

アルファベット（A〜Z）と_（アンダスコア）

英字記号

アルファベット（A〜Z、a〜z）と#、@、¥、$、%

英数字

英字と数字（0〜9）

大文字英数字

大文字英字と数字（0〜9）

英数字記号

英字記号と数字（0〜9）

符号なし整数

数字列（0〜9）

16進数字

数字（0〜9）と（A〜F、a〜f）

識別子

先頭がアルファベットの英数字列

英大識別子

先頭がアルファベットの大文字英数字列

記号名称

先頭が英字記号の英数字記号列

文字列

「“（ダブルクォーテーション）」を除く任意の文字の配列 ※1 ※2

パス名

システムテスト支援の定義の場合

使用するOSに依存する ※2

パス中に空白文字を含む場合は、パスを「'（シングルクォーテーション）」で囲ってください。

（例1）フラグの指定値に指定

aaa -b 'C:¥tmp Files¥libuoc.lib'

（例2）フラグメンバの指定値に指定

ddd -e "fff = 'E:¥tmp¥lib uoc.lib'"

ホスト名

英数字と！、＃、＄、％、＆、（、）、＊、＋、，、−、．、／、；、＜、＝、＞、？、＠、［、￥、］、＾、『＿（アンダスコア）』、｀、｛、｜、｝、~

ただし、プラットフォーム毎に使用可能な文字はOSのマニュアルを参照して下さい。 ※2

使用上の注意

すべて半角文字を使用してください。

※1：指定値として文字列を指定する場合、指定値全体を必ずダブルクォーテーションで囲まなければなりません。この時全体を囲むダブルクォーテーションは指定値には含まれません。又、指定値の中で文字としてのダブルクォーテーションを使用することはできません。オペランド指定値として文字列を指定する場合、指定値をダブルクォーテーションで囲んではなりません。

※2：'（シングルクォーテーション）は指定できません。

3.3　コマンド形式定義一覧

コマンド形式定義の一覧を示します。

システムテスト支援の定義はプロトコル毎に必要な定義が異なります。

プロトコル毎で必要な定義は下表の「対象プロトコル」欄を参照してください。

必須定義を◎、省略可能の定義を○、定義不可の定義を×で示しています。

また、プロトコルを組み合わせた場合、各プロトコルで必要となる定義を全て指定してください。

表3‒4　コマンド形式定義一覧

分類

定義名称

機能

対象プロトコル

RPC・RAP

TCPスルー

UDPスルー

HTTP

IIOP

パケットキャプチャ関連定義

capture_definition

パケットキャプチャ全般に関する定義

本定義は並行実行、蓄積実行、PCAP実行で稼働している場合に有効です。

○

○

○

○

○

capture_network_interface

キャプチャ対象のネットワークインタフェースに関する定義

○

○

○

○

○

サーバ関連定義

address_destination

送信先対応付け定義

◎

◎

◎

◎

◎

クライアント関連定義

client_definition

クライアントに関する定義

○

○

○

○

○

蓄積ファイル関連定義

accumulate_file

蓄積ファイル作成に関する定義

○

○

○

○

○

accumulate_reply_file

リプレイ実行時の蓄積ファイルに関する定義

○

○

○

○

○

比較エラー情報ファイル関連定義

compare_error_file

比較エラー情報ファイルに関する定義

○

×

×

×

○

実行形態関連定義

reply_send_mode

リプレイ実行の電文送信形態に関する定義

本定義はリプレイ実行、PCAP実行で稼働している場合に有効です。

○

○

○

○

○

フィルタ関連定義

target_time

時刻フィルタに関する定義

○

○

○

○

○

rpc_telegram_filter

RPC固有のフィルタに関する定義

○

×

×

×

×

RPC関連定義

rpc_watchtime

RPCの応答待ちに関する定義

本定義は並行実行、リプレイ実行、PCAP実行で稼働している場合に有効です。

○

×

×

×

×

rpc_build_message_watchtime

RPC電文の組立処理の監視時間を設定する定義

本定義は並行実行、蓄積実行、PCAP実行で稼働している場合に有効です。

○

×

×

×

×

rpc_socket

RPCのコネクションに関する定義

本定義は並行実行、リプレイ実行、PCAP実行で稼働している場合に有効です。

○

×

×

×

×

rpc_definition

クライアントの増幅に関する定義

○

×

×

×

×

UOC関連定義

uoc_func_com

開始終了UOCに関する定義

○

○

○

○

○

uoc_func_rpc

RPC用UOCに関する定義

○

×

×

×

×

uoc_hungup_time

UOC監視時間に関する定義

○

○

○

○

○

module

UOC共用ライブラリに関する定義

○

○

○

○

○

メッセージログ関連定義

message_log

メッセージログに関する定義

○

○

○

○

○

トラブルシュート関連定義

module_trace

モジュールトレースに関する定義

○

○

○

○

○

tasktm_information

TASKTMに関する定義

○

○

○

○

○

statistical_information

システム統計情報に関する定義

○

○

○

○

○

file_out_control

ファイル出力用スレッドに関する定義

○

○

○

○

○

プロセス関連定義

process_definition

プロセス制御全般に関する定義

○

○

○

○

○

HTTP電文関連定義

http_definition

HTTP電文に関する定義

×

×

×

○

×

製品提供プラグイン関連定義

plugin_definition

製品提供プラグインに関する定義

×

○

×

○

○

CSVファイル関連定義

csvfile_definition

CSVファイルに関する定義

×

○

×

○

×

フレームワーク関連定義

framework_definition

フレームワーク機能に関する定義

×

○

×

○

◎

IIOPテスト関連定義

iiop_definition

IIOPテスト機能に関する定義

×

×

×

×

○

システム関連定義

lightmode_definition

リソース削減モードを使用するかどうかを指定する定義

○

○

○

○

○

3.4　パケットキャプチャ関連定義

3.4.1　パケットキャプチャに関する定義（capture_definition）

形式

[capture_definition [-t "retrans_watchtime=再送パケットの待ち時間"]
                    [-f "ipaddr=キャプチャ対象のIPアドレス"]
                    [-r "[max_readsz=先読み最大サイズ]
                         [read_count=pcap形式ファイル読み込み回数]
                         [read_interval=再読み込み間隔]"]]

機能

パケットキャプチャ全般に関する定義です。

指定数

0〜1

オプション：-t

retrans_watchtime

設定値と省略値

〈符号なし整数〉（0〜60000）《600》（単位：ミリ秒）

説明

パケットロスト検知時におけるロストパケットの再送待ち時間をミリ秒単位で指定します。0を指定した場合は再送待ちを行いません。

利点

メモリリークの防止ができます。

注意事項

0を指定した場合、正常ケースでもキャプチャしたパケットがシーケンス番号通りでないとパケットロストと判断し破棄される可能性があります。このため、必要がない場合は、この定義を変更しないようにしてください。

オプション：-r

max_readsz

設定値と省略値

〈符号なし整数〉((10〜1000))《100》（単位：メガバイト）

説明

PCAP実行時、pcap形式ファイルから先読みを行うパケットの最大サイズを指定します。

先読みしたパケットの合計サイズが指定値を超えたとき、先読みを中断します。

先読み最大サイズは、パケットをテスト対象システムへ送信することで減少し、設定値の半分以下となったときに、先読みを再開します。

read_count

設定値と省略値

〈符号なし整数〉(0〜2147483647)《1》

説明

PCAP実行時、pcap形式ファイルからパケットを読み込む回数を指定します。

1以外の値を指定した場合、すべてのpcap形式ファイルの読み込みが完了したあと、ファイル先頭から再度パケットが読み込まれます。

0を指定した場合は、esstopコマンドを発行するまで無制限に再読み込みが繰り返されます。

前提条件

本フラグメンバに1以外を指定している場合、framework_definition定義を指定すると構文エラーとなります。

指定値の目安

複数クライアントから同時に電文を送信するテストを実施したい場合に、2以上の値を指定してください。

read_interval

設定値と省略値

〈符号なし整数〉((0～86400000))《0》（単位：ミリ秒）

説明

pcapファイルの再読み込みを行う際に、指定された時間が経過してから再読み込みを行います。

pcapファイル内のテスト用電文が一巡したあと、次のテストを開始する前に間隔を空けます。

0を指定した場合は間隔を空けずに読み込みます。

テストを複数回実行する際に、pcapファイルの再読み込み時間間隔を1000ミリ秒に設定した例を次に示します。

ほかのオペランドとの関連

capture_definition定義-rオプションでread_countに1以外を指定すると有効になります。

オプション：-f

ipaddr

設定値と省略値

既存システムのサーバIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255)) 《1.0.0.1-223.255.255.254》

説明

既存システム側のIPアドレス（IPv4形式）を、「．」（ドット）付き10進表記で指定します。

システムテスト支援では、送信元又は送信先のIPアドレスが、既存システムのIPアドレス範囲であるパケットのみキャプチャし、それ以外のパケットは破棄します。

IPアドレスは範囲指定で指定することができます。

範囲指定

xxx.xxx.xxx.xxx-yyy.yyy.yyy.yyy

「xxx」および「yyy」には、0〜255の値を指定できます。

xxx.xxx.xxx.xxxとyyy.yyy.yyy.yyyの値は、xxx.xxx.xxx.xxxがyyy.yyy.yyy.yyy以下の値となるように値を指定してください。

IPアドレスがxxx.xxx.xxx.xxxからyyy.yyy.yyy.yyyまでの範囲が、既存システムのIPアドレス範囲となります。それ以外のIPアドレスは、外部システムのIPアドレスとなります。

Windows版では「1.0.0.1-223.255.255.254」固定となります。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、address_destination定義-sオプションipaddrオペランドで指定したIPアドレスを包含する範囲で指定してください。本オペランドで指定したIPアドレスの範囲外でaddress_destination定義を定義した場合、パケットをキャプチャしません。

詳細は「1.4.1　テスト対象システムへの送信先の決定」の「システム定義とキャプチャ範囲」を参照してください。

指定値の目安

システムテスト支援の対象となるIPアドレスを内包する、最小範囲のIPアドレスを指定してください。

IPアドレス範囲内にシステムテスト支援の対象外のIPアドレスが含まれると、不要パケットのキャプチャ処理及び破棄処理が多発し、必要パケットのロストや、CPU使用率高騰等の可能性があります。

[例]

既存システム側のIPアドレスが以下で、システムテスト支援の対象IPアドレスが下記(2)と(4)の場合、IPアドレス範囲が「195.200.55.6-200.100.50.5」となるよう指定します。

(1)195.100.40.2

(2)195.200.55.6〜195.200.55.8

(3)199.100.100.1〜199.100.100.5

(4)200.100.50.2〜200.100.50.5

(5)200.100.55.5

3.4.2　キャプチャ対象のネットワークインタフェースに関する定義（capture_network_interface）

形式

{{[capture_network_interface [-i "[name=ネットワークインタフェース名]
                                  [pcapdir=pcap形式ファイルを格納したディレクトリ名]"]]}}

機能

キャプチャ対象のネットワークインタフェースに関する定義です。

指定数

0〜8

オプション：-i

name

設定値と省略値

Linux版の場合：〜〈1〜15文字の文字列〉《eth0》

Windows版の場合：ネットワークインタフェースのIPアドレス〜（nnn.nnn.nnn.nnn）〈符号なし整数〉((0〜255))《自動選択》

説明

Linux版の場合、ネットワークスイッチのミラーポートと接続している、Ethernetのネットワークインタフェース名（eth1等）を指定します。システムテスト支援では、指定されたネットワークインタフェースからパケットをキャプチャします。

Ethernet以外のインタフェースや、エイリアスIPアドレス用のコロン付きインタフェースを指定する事はできません。また、複数のcapture_network_interfaceオペランドで、同一のネットワークインタフェース名を指定しないでください。タグ方式VLANをパケットキャプチャする場合、タグIDの異なるネットワークインタフェースを使用すると、パケットキャプチャできないことがあります。その場合、タグIDと合わせたネットワークインタフェース名を定義してください。

Windows版の場合、スイッチングハブのミラーポートと接続している、EthernetのネットワークインタフェースのIPアドレスを指定します。システム検証支援基盤では、指定されたネットワークインタフェースからパケットをキャプチャします。複数のcapture_network_interfaceオペランドで、同一のIPアドレスを指定しないで下さい。

IPアドレスを省略した場合は、自動的にネットワークインタフェースを選択します。その為、ネットワークインタフェースが1つの場合はIPアドレスを省略できます。しかし、ネットワークインタフェースが複数存在する場合は、スイッチングハブのミラーポートと接続しているネットワークインタフェースのIPアドレスを明示的に指定してください。省略すると、スイッチングハブのミラーポートと接続されていないネットワークインタフェースを選択し、ミラーパケットがキャプチャされない場合があります。

前提条件

蓄積実行、又は、並行実行を行う場合、本オペランドは必ず指定してください。

ほかのオペランドとの関連

pcap形式ファイルからキャプチャする場合、本オペランド値は無視します。

pcapdir

設定値と省略値

Linux版の場合：〜〈1021バイト文字以内のパス名〉

Windows版の場合：〜〈247バイト文字以内のパス名〉

《/opt/HSIC/job/XX・・・XX/pcapfile》

XX・・・XX：テスト識別子

説明

テスト対象のパケットが格納されている、pcap形式ファイルを格納したディレクトリ名を絶対パス名で指定します。

システムテスト支援では、指定されたディレクトリ下にあるpcap形式ファイルからパケットをキャプチャします。

以下の場合は該当ファイルを無視します。

・本オペランドで指定したディレクトリ名とpcap形式ファイル名の合計長がLinux版では1024バイト以上、Windows版では259バイト以上のファイル

・全capture_network_interfaceオプションで指定したディレクトリ下のpcap形式ファイル数の累計が512を超過している場合の超過分

また、複数のcapture_network_interfaceオプション間で、同一のディレクトリ名を-i capdirオプションで指定している場合は、システムテスト支援の起動に失敗します。

前提条件

PCAP実行を行う前に、本オペランドで指定したディレクトリを作成してください。

ほかのオペランドとの関連

ネットワークインタフェースからキャプチャする場合、本オペランド値は無視します。

3.5　サーバ関連定義

3.5.1　送信先対応付け定義（address_destination／RPC・RAPの場合）

形式

{{address_destination -p  rpc
                    {{-s "ipaddr=既存システムのサーバIPアドレス
                          [portno=既存システムのサーバポート番号]"}}
                   [{{-t "ipaddr=テスト対象システムのサーバIPアドレス
                          portno=テスト対象システムのサーバポート番号
                                [,テスト対象システムのサーバポート番号…]"}}]
                    [{{-c "ipaddr=外部システムのクライアントIPアドレス
                         [portno=外部システムのクライアントポート番号]"}}]
                    [-i "[connect_stopmsg={Y｜N}]"]
                        }}

機能

送信先対応付け定義

既存システムサーバの要求電文送信先と、テスト対象システムのサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000、定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

-sで指定したIPアドレスへの要求電文、および-sで指定したIPアドレスからの応答電文をキャプチャします。また、-sオプションは定義一つに対して100個まで指定することができます。

-tで指定したIPアドレス、ポートにキャプチャした要求電文を送信します。

-sと-tで対応付けられた既存システムとテスト対象システムのIPアドレス、ポートからの応答電文を比較することができます（蓄積実行以外）。

-s portnoを指定する場合

既存システム側の特定のポート番号を使用する要求電文をキャプチャすることができます。

-c ipaddr、portnoを指定する場合

特定の外部システムのIPアドレス、ポート番号からの要求電文のみキャプチャすることができます。

指定数

0〜99999

オプション：-p

なし

設定値と省略値

rpc

説明

電文の通信プロトコルを指定します。

rpc：RPC・RAPプロトコル

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、全てのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

本オペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))《1024〜65535》

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

ポート番号は範囲指定での選択が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポートを使用する電文がテスト対象となります。xxxxはyyyy以下の値を指定してください。

指定値の目安

既存システムがTP1/EEの場合は以下の値を指定してください。

RPC電文：mysvgdefオペランドの-hオプションで指定したポート番号

RAP電文：rap_listen_portオペランドで指定したポート番号。

ただし、ネットワークスイッチと既存システムの間にファイアウォールがある場合、ファイアウォールの受付口となるポート番号を指定します。

既存システムがTP1/SBの場合は以下の値を指定してください。

RPC電文：スケジュールサービスのポート番号

RAP電文：rap_listen_portオペランドで指定したポート番号。

ただし、ネットワークスイッチと既存システムの間にファイアウォールがある場合、ファイアウォールの受付口となるポート番号を指定します。

オプション：-t

蓄積実行以外で実行する場合は、-tを指定したRPC指定のaddress_destination定義が1つ以上必要です。応答送信だけを行う既存システムからの電文をキャプチャする場合は当該定義の-tを省略してください。ただし、蓄積実行だけを行う場合はすべてのaddress_destination定義の-tフラグを省略できます。-tをすべて省略した場合、蓄積実行以外の実行形態で起動できません。また、他の実行形態をesmodaddコマンドで追加することもできません。

-tオプションは最大100個指定できます。

ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))

説明

外部システムからの電文を送信する送信先のテスト対象システムのポート番号を指定します。

ポート番号はカンマ区切りで複数指定するか、範囲指定で指定できます。1つの-tオプションに対して最大10個のポート番号を指定できます。

ポート番号の範囲指定：xxxx-yyyy

xxxxからyyyyまでのポート番号をテスト対象システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。ポート番号の範囲指定をした場合は、ポート番号をカンマ区切りで複数指定することはできません。

指定値の目安

テスト対象システムがTP1/EEの場合は以下の値を指定してください。ただし、ネットワークスイッチと既存システムの間にファイアウォールがある場合、ファイアウォールの受付口となるポート番号を指定します。

RPC電文：mysvgdefオペランドの-hオプションで指定したポート番号

RAP電文：rap_listen_portオペランドで指定したポート番号

テスト対象システムがTP1/SBの場合は以下の値を指定してください。ただし、ネットワークスイッチと既存システムの間にファイアウォールがある場合、ファイアウォールの受付口となるポート番号を指定します。

RPC電文：スケジュールサービスのポート番号

RAP電文：rap_listen_portオペランドで指定したポート番号

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0〜65535))《0》

説明

外部システムのポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

外部システムのポート番号を指定することで、特定のコネクションのパケットのみをテスト対象システムへ送信することができます。

オプション：-i

connect_stopmsg

設定値と省略値

Y｜N《Y》

説明

テスト対象システムのコネクションを相手プロセス側が切断（RST検知）した場合に、KFSE43310-Wメッセージを出力するかどうかを指定します。

Y：メッセージを出力します。

N：メッセージを出力しません。

利点

メッセージが大量に出力されることを抑止できます。

3.5.2　送信先対応付け定義（address_destination／TCPスルーのクライアントの場合）

形式

{{address_destination -p  tcp
                    {{-s  "ipaddr=既存システムのサーバIPアドレス
                           [portno=既存システムのサーバポート番号]"}}
                    [{{-t  "ipaddr=テスト対象システムのサーバIPアドレス
                            portno=テスト対象システムのサーバポート番号
                                  [,テスト対象システムのサーバポート番号…]
                            [rcv_ipaddr=テスト対象システムのIPアドレス
                                  [,テスト対象システムのIPアドレス…]]
                            [rcv_portno=テスト対象システムのサーバポート番号
                                  [,テスト対象システムのサーバポート番号…]]"}}]
                    [{{-c  "ipaddr=外部システムのクライアントIPアドレス
                         [portno= 外部システムのクライアントポート番号]"}}]
                    [{{-h  "[ipaddr=HSICのクライアントIPアドレス]
                          [portno= HSICのクライアントポート番号]"}}]
                    [-b  "[syssndsize=システムメッセージ送信バッファ長]"]
                    [-k  "[nodelay={Y｜N}]
                          [cnrelease={fin｜rst}]
                          [cnmode=client]
                          [cnrlssync ={Y｜N}]"]
                    [-i  "[watchtime=無通信時間]
                          [connect_stopmsg={Y｜N}]"]
                   }}

機能

送信先対応付け定義

HSICがクライアントの場合の既存システムサーバの要求電文送信先と、テスト対象システムのサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000、

定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

複数のaddress_destination定義の-tオプションかつ、-hオプションで同一のIPアドレス、ポート番号の組み合わせを指定する事はできません。同一のIPアドレス、ポート番号の組み合わせを指定した場合、システムテスト支援はプロセスダウンします。

同一のaddress_destination定義で-tを複数指定した場合、-tで指定したIPアドレス、ポート番号の組み合わせが重複した場合、システムテスト支援はプロセスダウンします。

-sで指定したIPアドレスへの要求電文、および-sで指定したIPアドレスからの応答電文をキャプチャします。また、-sオプションは定義一つに対して100個まで指定することができます。

-tで指定したIPアドレス、ポートにキャプチャした要求電文を送信します。

-hで指定したIPアドレス／ポート番号でHSICはパケットを送信します。

-hオプションは複数指定できます。-hオプションを複数指定することで、パケットを送信するHSICのクライアント単位に、電文送信元のIPアドレス／ポート番号を割り当てることができます。-hオプションは最大1000個まで指定できます。

-hオプションを複数指定する場合、ipaddrは省略できません。また、-hオプションのipaddr、およびportnoに指定する値の組み合わせは、全address_destination定義で一意になるように指定してください。

-sまたは、-cを指定する場合、以下のようになります。

-s portnoを指定する場合

既存システム側の特定のポート番号を使用する要求電文をキャプチャすることができます。

-c ipaddr、portnoを指定する場合

特定の外部システムのIPアドレス、ポート番号からの要求電文のみキャプチャすることができます。

指定数

0〜99999

オプション：-p

なし

設定値と省略値

tcp

説明

電文の通信プロトコルを指定します。

tcp：TCPスルー

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、全てのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

本オペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))

省略すると、すべてのポート番号を対象にします。

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

オプション：-t

（注）TCPスルーでは-tフラグは指定必須です。ただし、蓄積実行のときだけ、-tは省略できます。また他の実行形態をesmodaddコマンドで追加することもできません。

ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

portno

設定値と省略値

テスト対象システムのポート番号〈符号なし整数〉((1〜65535))

説明

外部システムからの電文を送信する送信先のテスト対象システムのポート番号を指定します。

rcv_ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0～255))《ipaddrで指定したIPアドレス》

説明

受信専用のコネクションを使用する場合、外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形で指定します。nnnは0以上255以下の数を指定してください。ただし、0.0.0.0および255.255.255.255は指定できません。

テスト対象システムと複数のコネクションを接続したいときは、カンマ区切りで複数のIPアドレスを指定します。なお、複数指定する場合は、指定する順番をrcv_portnoフラグメンバと合わてください。

テスト対象システム1(IPアドレス=11.11.11.11、ポート番号=11111)、テスト対象システム2(IPアドレス=22.22.22.22、ポート番号=22222)、テスト対象システム3(IPアドレス=33.33.33.33、ポート番号=33333)を定義する場合の定義例を示します。

前提条件

本フラグメンバは、次の条件をすべて満たす場合だけ有効です。それ以外の場合、フラグメンバの指定値は無視されます。

framework_definition定義の-uオプションのuseフラグメンバにYを指定

address_destination定義の-pオプションにtcpを指定

address_destination定義の-tオプションのrcv_portnoを指定

rcv_portno

設定値と省略値

テスト対象システムのサーバポート番号

〈符号なし整数〉((1～65535))

説明

受信専用のコネクションを使用する場合、テスト対象システムのポート番号を指定します。

テスト対象システムと複数のコネクションを接続したい場合は、カンマ区切りで複数のポート番号を指定します。

複数指定する場合は、最大で10個のポート番号を指定できます。

前提条件

本フラグメンバは、次の条件をすべて満たす場合だけ有効です。それ以外の場合、フラグメンバの指定値は無視されます。

framework_definition定義の-uオプションのuseフラグメンバにYを指定

address_destination定義の-pオプションにtcpを指定

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0〜65535))《0》

説明

外部システムのポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

テスト対象システムが特定のIPアドレスからのパケットしか受信しないような場合に、本フラグメンバを指定することで、IPアドレスを特定することができます。

オプション：-h

ipaddr

設定値と省略値

システムテスト支援のIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合、IPアドレスはOSが自動割当します。

portno

設定値と省略値

システムテスト支援のポート番号〈符号なし整数〉((0〜65535))《0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、ポート番号はOSが自動割当します。

-hオプションでportnoのみを指定する場合は、-kオプションcnmodeフラグメンバでserverを指定した定義と重複する値を使用しないでください。

利点

テスト対象システムが特定のポート番号からのパケットしか受信しないような場合に、本フラグメンバを指定することで、ポート番号を特定することができます。

オプション：-b

syssndsize

設定値と省略値

〈符号なし整数〉((1〜2147483647))《OSのデフォルト値》

（単位：バイト）

説明

TCPスルーで使用するソケットのソケット送信バッファのサイズをバイト単位で指定します。

本フラグメンバの指定を省略するとOSのデフォルト値が仮定されます。

備考

Linux版では、カーネルの仕様によりソケット送信バッファは本フラグメンバ指定値の2倍のサイズが確保されます。また、ソケット送信バッファサイズの最大値はカーネルパラメタにより制限されており、最大値より大きいサイズを確保しようとした場合、確保サイズは最大値となります。その為、以下の条件が成立するよう本フラグメンバ及び、カーネルパラメタを調整してください。

「（本フラグメンバ指定値×2） ＜＝ net.ipv4.tcp_wmemのmax値」

Windows版では設定値の上限はありません。

オプション：-k

nodelay

設定値と省略値

Y｜N《N》

説明

TCP/IPが提供するソケットオプション「TCP_NODELAY」を使用するかどうかを指定します。

Y：「TCP_NODELAY」を使用する

N：「TCP_NODELAY」を使用しない

利点

「TCP_NODELAY」を使用することで送信済みデータの応答待ちの状態でも遅延させることなくデータ送信ができるようになります。

注意事項

「TCP_NODELAY」を使用することでネットワークの負荷は大きくなります。

cnrelease

設定値と省略値

fin｜rst《fin》

説明

コネクションの解放形態を指定します。

fin：FINパケットを送信してコネクションを解放します

rst：RSTパケットを送信してコネクションを解放します

注意事項

本フラグメンバにfinを設定したとしても、ネットワーク上のデータのすれ違い等により指示とは関係なくRSTパケットを送信する場合があります。

cnmode

設定値と省略値

client

説明

コネクションの確立方式を指定します。

client：コネクション確立を要求します。

cnrlssync

設定値と省略値

Y｜N《Y》

説明

システム検証支援基盤が本番環境のコネクション障害を検知した場合に、テスト対象システムとのコネクションを解放するかを指定します。

Y：テスト対象システムとのコネクションを解放します

N：テスト対象システムとのコネクションを解放しません

指定値の目安

既存システムと外部システム間のコネクション解放が発生している状態で取得した蓄積ファイル、pcap形式ファイルを使用したテストを実施する際に、コネクションを維持したい場合は指定してください。

オプション：-i

watchtime

設定値と省略値

〈符号なし整数〉((0〜65535))《300》（単位：秒）

説明

外部システムと既存システム間のコネクションの無通信時間を指定します。

対象のコネクションにおいて、最後に電文を処理した時刻から本定義時間以上経過後も電文登録がない場合、テスト対象システムとの間のコネクションを解放します。

本フラグメンバに0を指定した場合は、コネクションを解放しません。

利点

外部システムと既存システム間のコネクションが解放されたときに、FINやRSTをキャプチャ出来なかった場合でも、コネクションを解放することができます。

connect_stopmsg

設定値と省略値

Y｜N《Y》

説明

テスト対象システムのコネクションを相手プロセス側が切断（RST検知）した場合に、KFSE43310-Wメッセージを出力するかどうかを指定します。

Y：メッセージを出力します。

N：メッセージを出力しません。

利点

メッセージが大量に出力されることを抑止できます。

3.5.3　送信先対応付け定義（address_destination／TCPスルーのサーバの場合）

形式

{{address_destination -p tcp
                    {{-s  "ipaddr=既存システムのサーバIPアドレス
                          [portno=既存システムのサーバポート番号]"}}
                    [{{-c  "ipaddr=外部システムのクライアントIPアドレス
                         [portno=外部システムのクライアントポート番号]"}}]
                     -h  "[ipaddr=HSICのクライアントIPアドレス]
                           portno=HSICのクライアントポート番号"
                    [-b  "[syssndsize=システムメッセージ送信バッファ長]"]
                    [-k  "[nodelay={Y|N}]
                          [cnrelease={fin|rst}]
                           cnmode=server
                          [cnrlssync={Y|N}]
                          [agent={Y|N}]"]
                    [-i  "[watchtime=無通信時間]
                          [connect_stopmsg={Y|N}]"]
                   }}

機能

送信先対応付け定義

HSICがサーバの場合の既存システムサーバの要求電文送信先と、システムテスト支援のサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000、

定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

複数のaddress_destination定義の-sオプションかつ、-hオプションで同一のIPアドレス、ポート番号の組み合わせを指定する事はできません。同一のIPアドレス、ポート番号の組み合わせを指定した場合、システムテスト支援はプロセスダウンします。

同一のaddress_destination定義で-tを複数指定した場合、-tで指定したIPアドレス、ポート番号の組み合わせが重複した場合、システムテスト支援はプロセスダウンします。

-sで指定したIPアドレスへの要求電文、および-sで指定したIPアドレスからの応答電文をキャプチャします。また、-sオプションは定義一つに対して100個まで指定することができます。

-hで指定したIPアドレス、ポートにキャプチャした要求電文を送信します。

-sまたは、-cを指定する場合、以下のようになります。

-s portnoを指定する場合

既存システム側の特定のポート番号を使用する要求電文をキャプチャすることができます。また、指定したポート番号のパケットを-hのportnoへ送信する事ができます。

-c ipaddr、portnoを指定する場合

特定の外部システムのIPアドレス、ポート番号からの要求電文のみキャプチャすることができます。

指定数

0〜99999

オプション：-p

なし

設定値と省略値

tcp

説明

電文の通信プロトコルを指定します。

tcp：TCPスルー

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、全てのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

このオペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

このオペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))

省略すると、すべてのポート番号を対象にします。

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

このフラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0〜65535))《0》

説明

外部システムのポート番号を指定します。

このフラグメンバを省略した場合、または0を指定した場合は、外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

テスト対象システムが特定のIPアドレスからのパケットしか受信しないような場合に、このフラグメンバを指定することで、IPアドレスを特定することができます。

オプション：-h

ipaddr

設定値と省略値

システムテスト支援のIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

このフラグメンバを省略した場合、または、0.0.0.0を指定した場合、IPアドレスはOSが自動割当します。

-hで指定したIPアドレスとポート番号の組み合わせは、他のaddress_destination定義の-hオプションで使用しないで下さい。

portno

設定値と省略値

システムテスト支援のポート番号〈符号なし整数〉((1〜65535))《0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のポート番号を指定します。

このフラグメンバを省略した場合、または0を指定した場合は、ポート番号はOSが自動割当します。

-kオプションcnmodeフラグメンバでserverを指定する場合、このフラグメンバを省略、または0を指定出来ません。

-kオプションcnmodeフラグメンバでserverを指定する場合、このフラグメンバには以下の条件を満たす値を指定してください。

・-hで指定したIPアドレスとポート番号の組み合わせが一意になるように指定してください。（後述の例の定義1＋定義3のケースは不可）

・-hでipaddrに0.0.0.0、もしくはipaddrを省略した場合、-hのポート番号が一意になるように指定してください。

（後述の例の定義2＋定義3、定義2＋定義4のケースは不可）

・-hでIPアドレスを指定する場合、以下のいずれかのケースに当てはまる他のaddress_destination定義の-hのポート番号と、重複しないように指定してください。

-hでipaddrに0.0.0.0、もしくはipaddrを省略したaddress_destination定義

（後述の例の定義1＋2、定義1＋定義4のケースは不可）

[例] 以下のような定義の組み合わせの指定可否を表に記述します。

定義1：address_destination -k "cnmode=server"

-h "ipaddr=1.1.1.1 portno=10000"

：

定義2：address_destination -k "cnmode=server"

-h "portno=10000"

：

定義3：address_destination -k "cnmode=client"

-h "ipaddr=1.1.1.1 portno=10000"

：

定義4：address_destination -k "cnmode=client"

-h "portno=10000"

：

-

定義1

定義2

定義3

定義4

定義1

-

×

×

×

定義2

×

-

×

×

定義3

×

×

-

○

定義4

×

×

○

-

（凡例）

○：同時指定可能

×：同時指定不可

オプション：-b

syssndsize

設定値と省略値

〈符号なし整数〉((1〜2147483647))《OSのデフォルト値》

（単位：バイト）

説明

TCPスルーで使用するソケットのソケット送信バッファのサイズをバイト単位で指定します。

このフラグメンバの指定を省略するとOSのデフォルト値が仮定されます。

備考

Linux版では、カーネルの仕様によりソケット送信バッファはこのフラグメンバ指定値の2倍のサイズが確保されます。また、ソケット送信バッファサイズの最大値はカーネルパラメタにより制限されており、最大値より大きいサイズを確保しようとした場合、確保サイズは最大値となります。その為、以下の条件が成立するようこのフラグメンバ及び、カーネルパラメタを調整してください。

「（このフラグメンバ指定値×2） ＜＝ net.ipv4.tcp_wmemのmax値」

Windows版では設定値の上限はありません。

オプション：-k

nodelay

設定値と省略値

Y|N《N》

説明

TCP/IPが提供するソケットオプション「TCP_NODELAY」を使用するかどうかを指定します。

Y：「TCP_NODELAY」を使用する。

N：「TCP_NODELAY」を使用しない。

利点

「TCP_NODELAY」を使用することで送信済みデータの応答待ちの状態でも遅延させることなくデータ送信ができるようになります。

注意事項

「TCP_NODELAY」を使用することでネットワークの負荷は大きくなります。

cnrelease

設定値と省略値

fin|rst《fin》

説明

コネクションの解放形態を指定します。

fin：FINパケットを送信してコネクションを解放します。

rst：RSTパケットを送信してコネクションを解放します。

注意事項

このフラグメンバにfinを設定したとしても、ネットワーク上のデータのすれ違い等により指示とは関係なくRSTパケットを送信する場合があります。

cnmode

設定値と省略値

server

説明

コネクションの確立方式を指定します。

server：コネクション確立を待ちます。

cnrlssync

設定値と省略値

Y|N《Y》

説明

システム検証支援基盤が本番環境のコネクション障害を検知した場合に、テスト対象システムとのコネクションを解放するかを指定します。

Y：テスト対象システムとのコネクションを解放します。

N：テスト対象システムとのコネクションを解放しません。

指定値の目安

既存システムと外部システム間のコネクション解放が発生している状態で取得した蓄積ファイル、pcap形式ファイルを使用したテストを実施する際に、コネクションを維持したい場合は指定してください。

agent

設定値と省略値

Y|N《N》

説明

エージェント機能を使用するかどうかを指定します。

Y：エージェント機能を使用します。

N：エージェント機能を使用しません。

前提条件

エージェント機能はTCPスルーのサーバモードを使用します。そのため、次のどちらかの条件を満たす場合、システムテスト支援の起動に失敗します。

-pオプションに「tcp」以外を指定

-kオプションのcnmodeフラグメンバに「server」以外を指定

オプション：-i

watchtime

設定値と省略値

〈符号なし整数〉((0〜65535))《300》（単位：秒）

説明

外部システムと既存システム間のコネクションの無通信時間を指定します。

対象のコネクションにおいて、最後に電文を処理した時刻からこの定義時間以上経過後も電文登録がない場合、テスト対象システムとの間のコネクションを解放します。

このフラグメンバに0を指定した場合は、コネクションを解放しません。

利点

外部システムと既存システム間のコネクションが解放されたときに、FINやRSTをキャプチャ出来なかった場合でも、コネクションを解放することができます。

connect_stopmsg

設定値と省略値

Y|N《Y》

説明

テスト対象システムのコネクションを相手プロセス側が切断（RST検知）した場合に、KFSE43310-Wメッセージを出力するかどうかを指定します。

Y：メッセージを出力します。

N：メッセージを出力しません。

利点

メッセージが大量に出力されることを抑止できます。

3.5.4　送信先対応付け定義（address_destination／UDPスルーの場合）

形式

{{address_destination -p  udp
                    {{-s  "ipaddr=既存システムのサーバIPアドレス
                          [portno=既存システムのサーバポート番号]"}}
                    [{{-t  "ipaddr=テスト対象システムのサーバIPアドレス
                           portno=テスト対象システムのサーバポート番号
                                [,テスト対象システムのサーバポート番号…]"}}]
                    [{{-c  "ipaddr=外部システムのクライアントIPアドレス
                          [portno=外部システムのクライアントポート番号]"}}]
                    [-h  "[ipaddr=HSICのクライアントIPアドレス]
                          [portno=HSICのクライアントポート番号]
                          [rcv_portno=テスト対象システムからの電文受信ポート番号]
                          [multicast_ttl=送信するマルチキャストの生存期間（TTL）]"]
                    [-b  "[syssndsize=システムメッセージ送信バッファ長]" ]
                  }}

機能

既存システムサーバの要求電文送信先と、テスト対象システムのサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000、

定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

複数のaddress_destination定義の-tオプションかつ、-hオプションで同一のIPアドレス、ポート番号の組み合わせを指定する事はできません。同一のIPアドレス、ポート番号の組み合わせを指定した場合、システムテスト支援はプロセスダウンします。

同一のaddress_destination定義で-tを複数指定した場合、-tで指定したIPアドレス、ポート番号の組み合わせが重複した場合、システムテスト支援はプロセスダウンします。

-sで指定したIPアドレスへの要求電文、および-sで指定したIPアドレスからの応答電文をキャプチャします。また、-sオプションは定義一つに対して100個まで指定することができます。

-tで指定したIPアドレス、ポートにキャプチャした要求電文を送信します。

-sまたは、-cを指定する場合、以下のようになります。

-s portnoを指定する場合

既存システム側の特定のポート番号を使用する要求電文をキャプチャすることができます。

-c ipaddr、portnoを指定する場合

特定の外部システムのIPアドレス、ポート番号からの要求電文のみキャプチャすることができます。

指定数

0〜99999

オプション：-p

なし

設定値と省略値

udp

説明

電文の通信プロトコルを指定します。

udp：udpスルー

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、全てのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

本オペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))

省略すると、すべてのポート番号を対象にします。

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

オプション：-t

（注）UDPスルーでは-tフラグは指定必須です。ただし、蓄積実行のときだけ、-tは省略できます。また他の実行形態をesmodaddコマンドで追加することもできません。

ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

portno

設定値と省略値

テスト対象システムのポート番号〈符号なし整数〉((1〜65535))

説明

外部システムからの電文を送信する送信先のテスト対象システムのポート番号を指定します。

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0〜65535))《0》

説明

外部システムのポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

テスト対象システムが特定のIPアドレスからのパケットしか受信しないような場合に、本フラグメンバを指定することで、IPアドレスを特定することができます。

オプション：-h

ipaddr

設定値と省略値

システムテスト支援のIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合、IPアドレスはOSが自動割当します。

UDPスルーでマルチキャストを使用する場合、-h ipaddrに指定するIPアドレスはマルチキャストを送信するLANアダプタのIPアドレスとなります。

portno

設定値と省略値

システムテスト支援のポート番号〈符号なし整数〉((0〜65535))《0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、ポート番号はOSが自動割当します。

rcv_portnoを指定した場合、portnoに指定したポートはテスト対象システムに対する電文の送信用ポートとなります。

利点

テスト対象システムが特定のポート番号からのパケットしか受信しないような場合に、本フラグメンバを指定することで、ポート番号を特定することができます。

rcv_portno

設定値と省略値

システム検証支援基盤の受信ポート番号〈符号なし整数〉((1〜65535))

説明

システム検証支援基盤がテスト対象システムから電文を受信するポート番号を指定します。テスト対象システムに送信するポートと受信するポートが異なる場合に本フラグメンバを指定してください。

テスト対象システムに対して送受信するポートが同一の場合、本フラグメンバは指定しないでください。

利点

rcv_portnoを指定することで、テスト対象システムからの電文を他プロセスで使用中のポートで誤って受信することを防ぐことができます。また、rcv_portnoに指定したポートをオープンにすることで、未オープンのポートへ電文を送信した際に返却するICMP等のパケット送信を抑止することができます。

multicast_ttl

設定値と省略値

送信するマルチキャストの生存期間（TTL）

〈符号なし整数〉((0〜255)) 《OSのデフォルト値》

説明

マルチキャストメッセージ送信時のマルチキャストパケットの生存期間（TTL）を指定します。本フラグメンバの指定を省略すると、OSのデフォルト値が仮定されます。

本フラグメンバはテスト対象システムにクラスD（224.0.0.0〜239.255.255.255）のIPアドレスを指定した場合に指定してください。

指定値の目安

ネットワークの構成にしたがって本フラグメンバを指定してください。

オプション：-b

syssndsize

設定値と省略値

〈符号なし整数〉((1〜2147483647))《OSのデフォルト値》

（単位：バイト）

説明

UDPスルーで使用するソケットのソケット送信バッファのサイズをバイト単位で指定します。

本フラグメンバの指定を省略するとOSのデフォルト値が仮定されます。

備考

Linux版では、カーネルの仕様によりソケット送信バッファは本フラグメンバ指定値の2倍のサイズが確保されます。また、ソケット送信バッファサイズの最大値はカーネルパラメタにより制限されており、最大値より大きいサイズを確保しようとした場合、確保サイズは最大値となります。その為、以下の条件が成立するよう本フラグメンバ及び、カーネルパラメタを調整してください。

「（本フラグメンバ指定値×2） ＜＝ net.core.wmem_max値」

Windows版では設定値の上限はありません。

3.5.5　送信先対応付け定義（address_destination／HTTPの場合）

形式

{{address_destination -p  http
                    {{-s  "ipaddr=既存システムのサーバIPアドレス
                          [portno=既存システムのサーバポート番号]"}}
                    [{{-t  "ipaddr=テスト対象システムのサーバIPアドレス
                            portno=テスト対象システムのサーバポート番号
                                 [,テスト対象システムのサーバポート番号…]
                           [ssl_use={Y｜N}]
                           [ssl_protocol=暗号プロトコル] "}}]
                    [{{-c  "ipaddr=外部システムのクライアントIPアドレス
                           [portno= 外部システムのクライアントポート番号]"}}]
                    [-h  "[ipaddr=HSICのクライアントIPアドレス]
                          [portno= HSICのクライアントポート番号]"]
                    [-b  "[syssndsize=システムメッセージ送信バッファ長]"]
                    [-k  "[nodelay={Y｜N}]
                          [cnrelease={fin｜rst}]"]
                    [-i  "[watchtime=無通信時間]
                          [connect_stopmsg={Y | N}]"]
                   }}
}}

機能

送信先対応付け定義

既存システムサーバの要求電文送信先と、テスト対象システムのサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000、

定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

複数のaddress_destination定義の-tオプションかつ、-hオプションで同一のIPアドレス、ポート番号の組み合わせを指定する事はできません。同一のIPアドレス、ポート番号の組み合わせを指定した場合、システムテスト支援はプロセスダウンします。

同一のaddress_destination定義で-tを複数指定した場合、-tで指定したIPアドレス、ポート番号の組み合わせが重複した場合、システムテスト支援はプロセスダウンします。

-sで指定したIPアドレスへの要求電文、および-sで指定したIPアドレスからの応答電文をキャプチャします。また、-sオプションは定義一つに対して100個まで指定することができます。

-tで指定したIPアドレス、ポートにキャプチャした要求電文を送信します。

-sまたは、-cを指定する場合、以下のようになります。

-s portnoを指定する場合

既存システム側の特定のポート番号を使用する要求電文をキャプチャすることができます。

-c ipaddr、portnoを指定する場合

特定の外部システムのIPアドレス、ポート番号からの要求電文のみキャプチャすることができます。

指定数

0〜99999

オプション：-p

なし

設定値と省略値

http

説明

電文の通信プロトコルを指定します。

http：http

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、全てのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

本オペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1〜65535))

省略すると、すべてのポート番号を対象にします。

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

オプション：-t

（注）HTTPでは-tフラグは指定必須です。ただし、蓄積実行のときだけ、-tは省略できます。また他の実行形態をesmodaddコマンドで追加することもできません。

ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))

説明

外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

portno

設定値と省略値

テスト対象システムのポート番号〈符号なし整数〉((1〜65535))

説明

外部システムからの電文を送信する送信先のテスト対象システムのポート番号を指定します。

ssl_use

設定値と省略値

Y｜N《N》

説明

HSICとテスト対象システム間において、SSLで暗号化したHTTPS通信を行うか否かを指定します。

Y：HTTPS通信を行います

N：HTTPS通信を行いません。この場合、平文のHTTP通信となります。

前提条件

HSIC実行マシン上にOpenSSLバージョン1.0.1以降がインストールされている必要があります。

Windowsの場合は、環境変数PATHに「OpenSSLインストールディレクトリ¥bin」が指定されている必要があります。

Linuxの場合は、環境変数LD_LIBRARY_PATHにOpenSSLライブラリを格納しているパスが指定されている必要があります。

ほかのオペランドとの関連

-pオプションに「http」を指定した場合のみ、本フラグメンバにYを指定できます。「http」以外で本フラグメンバを指定した場合は、HSICの起動が失敗します。

利点

HTTPSに対応しているテスト対象システムのテストが行えます。

ssl_protocol

設定値と省略値

SSL2｜SSL3｜TLS1.0｜TLS1.1｜TLS1.2｜DEFAULT｜ALL《DEFAULT》

説明

HTTPS通信で使用する暗号プロトコルを指定します。ALL、DEFAULT以外の場合は、コロン（:）区切りで複数プロトコルを指定できます

例：SSL V3.0とTLS V1.0を使用する場合、「ssl_protocol=SSL3:TLS1.0」と指定する。

SSL2 ：SSL V2.0を使用する

SSL3 ：SSL V3.0を使用する

TLS1.0 ：TLS V1.0を使用する

TLS1.1 ：TLS V1.1を使用する

TLS1.2 ：TLS V1.2を使用する

ALL ：上記すべての暗号プロトコルを使用する

DEFAULT ：SSL V2.0とSSL V3.0以外の暗号プロトコルを使用する

HTTPS通信で使用する暗号アルゴリズムは、指定した暗号プロトコルの中から、テスト対象システムとのSSLハンドシェイクにより決定されます。指定した全ての暗号プロトコルがテスト対象システムで使用できない（未サポート又は使用禁止）場合、SSLハンドシェイクがエラーとなり、テストが失敗します。

ほかのオペランドとの関連

ssl_useフラグメンバに「Y」以外の場合、本フラグメンバは無視します。

利点

任意の暗号プロトコルを指定する事により、次のような問題を回避できます。

デフォルトで使用する暗号プロトコルが、テスト対象システムで使用できない

脆弱性等の問題により、特定の暗号プロトコルを使用したくない

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0〜65535))《0》

説明

外部システムのポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

テスト対象システムが特定のIPアドレスからのパケットしか受信しないような場合に、本フラグメンバを指定することで、IPアドレスを特定することができます。

オプション：-h

ipaddr

設定値と省略値

システムテスト支援のIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0〜255))《0.0.0.0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合、IPアドレスはOSが自動割当します。

portno

設定値と省略値

システムテスト支援のポート番号〈符号なし整数〉((0〜65535))《0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、ポート番号はOSが自動割当します。

portnoのみを指定する場合は、-kオプションcnmodeフラグメンバでserverを指定した定義と重複する値を使用しないでください。

利点

テスト対象システムが特定のポート番号からのパケットしか受信しないような場合に、本フラグメンバを指定することで、ポート番号を特定することができます。

オプション：-b

syssndsize

設定値と省略値

〈符号なし整数〉((1〜2147483647))《OSのデフォルト値》

（単位：バイト）

説明

HTTPで使用するソケットのソケット送信バッファのサイズをバイト単位で指定します。

本フラグメンバの指定を省略するとOSのデフォルト値が仮定されます。

備考

Linux版では、カーネルの仕様によりソケット送信バッファは本フラグメンバ指定値の2倍のサイズが確保されます。また、ソケット送信バッファサイズの最大値はカーネルパラメタにより制限されており、最大値より大きいサイズを確保しようとした場合、確保サイズは最大値となります。その為、以下の条件が成立するよう本フラグメンバ及び、カーネルパラメタを調整してください。

「（本フラグメンバ指定値×2） ＜＝ net.ipv4.tcp_wmemのmax値」

Windows版では設定値の上限はありません。

オプション：-k

nodelay

設定値と省略値

Y｜N《N》

説明

TCP/IPが提供するソケットオプション「TCP_NODELAY」を使用するかどうかを指定します。

Y：「TCP_NODELAY」を使用する

N：「TCP_NODELAY」を使用しない

利点

「TCP_NODELAY」を使用することで送信済みデータの応答待ちの状態でも遅延させることなくデータ送信ができるようになります。

注意事項

「TCP_NODELAY」を使用することでネットワークの負荷は大きくなります。

cnrelease

設定値と省略値

fin｜rst《fin》

説明

コネクションの解放形態を指定します。

fin：FINパケットを送信してコネクションを解放します

rst：RSTパケットを送信してコネクションを解放します

注意事項

本フラグメンバにfinを設定したとしても、ネットワーク上のデータのすれ違い等により指示とは関係なくRSTパケットを送信する場合があります。

オプション：-i

watchtime

設定値と省略値

〈符号なし整数〉((0〜65535))《3600》（単位：秒）

説明

外部システムと既存システム間のコネクションの無通信時間を指定します。

対象のコネクションにおいて、最後に電文を処理した時刻から本定義時間以上経過後も電文登録がない場合、テスト対象システムとの間のコネクションを解放します。

本フラグメンバに0を指定した場合は、コネクションを解放しません。

利点

外部システムと既存システム間のコネクションが解放されたときに、FINやRSTをキャプチャ出来なかった場合でも、コネクションを解放することができます。

指定値の目安

HTTPでは、「watchtime≧外部システムのHTTP応答待ち時間」となるようwatchtimeを設定してください。「watchtime＜外部システムのHTTP応答待ち時間」となると、外部システムではHTTP応答電文を受信するが、HSICでは応答電文を受信することなく応答待ち状態を中止する可能性があります。

connect_stopmsg

設定値と省略値

Y｜N《Y》

説明

テスト対象システムのコネクションを相手プロセス側が切断（RST検知）した場合に、KFSE43310-Wメッセージを出力するかどうかを指定します。

Y：メッセージを出力します。

N：メッセージを出力しません。

利点

メッセージが大量に出力されることを抑止できます。

3.5.6　送信先対応付け定義（address_destination／IIOPの場合）

形式

{{address_destination
                    -p  iiop
                    {{-s  "ipaddr=既存システムのサーバIPアドレス
                          [portno=既存システムのサーバポート番号]"}}
                    [{{-t  "ipaddr=テスト対象システムのサーバIPアドレス
                           portno=テスト対象システムのサーバポート番号
                                [,テスト対象システムのサーバポート番号…]"}}]
                    [{{-c  "ipaddr=外部システムのクライアントIPアドレス
                           [portno=外部システムのクライアントポート番号]"}}]
                    [-h  "[ipaddr=HSICのクライアントIPアドレス]
                          [portno=HSICのクライアントポート番号]"]
                    [-b  "[syssndsize=システムメッセージ送信バッファ長]"]
                    [-k  "[nodelay={Y｜N}]"]
                    [-i  "[watchtime=無通信時間]
                          [connect_stopmsg={Y｜N}]"]
}}

機能

送信先対応付け定義

既存システムサーバの要求電文送信先と、テスト対象システムのサーバの送信先IPアドレス、ポート番号を対応付ける定義です。

複数のaddress_destination定義の-sオプションで同一のIPアドレス、ポート番号の組み合わせを指定した場合、先に定義した定義が有効となります。ただし、-sオプションが同一のaddress_destination定義でも-cオプションのIPアドレス／ポート番号が異なる場合は、そのaddress_destination定義は有効となります。しかし、電文が複数のaddress_destination定義に該当した場合は先に定義した定義が有効となります。

例1）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.4 portno=20000”

定義Aと定義Bの-sオプションは同一ですが、-cオプションが異なるので、定義A、B共に有効となります。

例2）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義B

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文も、定義Aが有効となります。

例3）

定義A

-s“ipaddr=192.168.172.2 portno=30000”

-c“ipaddr=192.168.172.3 portno=10000”

定義B

-s“ipaddr=192.168.172.2 portno=30000”

（-c 省略）

定義Aにも定義Bにも該当する電文は定義Aが有効となります。それ以外の電文は、定義Bが有効となります。

また、IPアドレスが同一でポート番号が範囲指定で重複した場合は先に記述した定義のポート番号の範囲をその定義で有効とし、重複していない範囲を後に記述した定義で有効とします。

例）

定義A -s“ipaddr=192.168.172.2 portno=10000-30000”

定義B -s“ipaddr=192.168.172.2 portno=20000-40000”

上記の場合、定義AはIPアドレス192.168.172.2、ポート番号10000-30000。定義BはIPアドレス192.168.172.2、ポート番号30001-40000が有効となります。

複数のaddress_destination定義の-tオプションかつ、-hオプションで同一のIPアドレス、ポート番号の組み合わせを指定する事はできません。同一のIPアドレス、ポート番号の組み合わせを指定した場合、システムテスト支援はプロセスダウンします。

同一のaddress_destination定義で-tを複数指定した場合、-tで指定したIPアドレス、ポート番号の組み合わせが重複した場合、システムテスト支援はプロセスダウンします。

指定数

0～99999

オプション：-p

なし

設定値と省略値

iiop

説明

電文の通信プロトコルを指定します。

iiop：IIOPプロトコルを示します。

オプション：-s

（注）-sは一つのaddress_destination定義に対して最大100個定義することができます。また、すべてのaddress_destination定義の-sは合計で最大99999個定義できます。

ipaddr

設定値と省略値

既存システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0～255))

説明

外部システムから電文を送信する送信先の既存システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのオペランドとの関連

本オペランドで指定するIPアドレスは、capture_definition定義の-fオプションipaddrオペランドで指定した範囲内のIPアドレスを指定してください。

本オペランドで指定したIPアドレスがcapture_definition定義-fオプションipaddrオペランドの指定範囲外の場合、パケットをキャプチャされません。

詳細は「3.4.1　パケットキャプチャに関する定義（capture_definition）」を参照してください。

portno

設定値と省略値

既存システムのポート番号〈符号なし整数〉((1～65535))

省略すると、すべてのポート番号を対象にします。

説明

外部システムから電文を送信する送信先の既存システムのポート番号を指定します。

オプション：-t

（注）IIOPでは-tフラグは指定必須です。ただし、蓄積実行のときだけ、-tは省略できます。また他の実行形態をesmodaddコマンドで追加することもできません。

ipaddr

設定値と省略値

テスト対象システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0～255))

説明

外部システムからの電文を送信する送信先のテスト対象システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

ただし、0.0.0.0および255.255.255.255は指定できません。

portno

設定値と省略値

テスト対象システムのポート番号〈符号なし整数〉((1～65535))

説明

外部システムからの電文を送信する送信先のテスト対象システムのポート番号を指定します。

オプション：-c

（注）-cは1つのaddress_destination定義に対して最大64個定義することができます。65個以上定義した場合、HSICの起動に失敗します。

ipaddr

設定値と省略値

外部システムのIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0～255))《0.0.0.0》

説明

既存システムへ電文を送信する外部システムのIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合は、外部システムのIPアドレスは任意となります。

portno

設定値と省略値

外部システムのポート番号〈符号なし整数〉((0～65535))《0》

説明

外部システムのポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、外部システムのポート番号は任意となります。

ポート番号は範囲指定での指定が可能です。

ポート番号の範囲指定

xxxx-yyyy

xxxxからyyyyまでのポート番号を外部システムのポート番号とします。xxxxはyyyy以下の値を指定してください。また、xxxxに0は指定できません。

利点

テスト対象システムが特定のIPアドレスからのパケットしか受信しないような場合に、本フラグメンバを指定することで、IPアドレスを特定することができます。

オプション：-h

ipaddr

設定値と省略値

システムテスト支援のIPアドレス（nnn.nnn.nnn.nnn）

〈符号なし整数〉((0～255))《0.0.0.0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のIPアドレスをnnn.nnn.nnn.nnnの形式で指定します。

nnnは0以上255以下の数を指定してください。

本フラグメンバを省略した場合、または、0.0.0.0を指定した場合、IPアドレスはOSが自動割当します。

portno

設定値と省略値

システムテスト支援のポート番号〈符号なし整数〉((0～65535))《0》

説明

テスト対象システムへ電文を送信するシステムテスト支援のポート番号を指定します。

本フラグメンバを省略した場合、または0を指定した場合は、ポート番号はOSが自動割当します。

portnoのみを指定する場合は、-kオプションcnmodeフラグメンバでserverを指定した定義と重複する値を使用しないでください。

利点

テスト対象システムが特定のポート番号からのパケットしか受信しないような場合に、本フラグメンバを指定することで、ポート番号を特定することができます。

オプション：-b

syssndsize

設定値と省略値

〈符号なし整数〉((1〜2147483647))《OSのデフォルト値》（単位：バイト）

説明

IIOPで使用するソケットのソケット送信バッファのサイズをバイト単位で指定します。

本フラグメンバの指定を省略するとOSのデフォルト値が仮定されます。

備考

Linux版では、カーネルの仕様によりソケット送信バッファは本フラグメンバ指定値の2倍のサイズが確保されます。また、ソケット送信バッファサイズの最大値はカーネルパラメタにより制限されており、最大値より大きいサイズを確保しようとした場合、確保サイズは最大値となります。そのため、以下の条件が成立するよう本フラグメンバ、およびカーネルパラメタを調整してください。

「（本フラグメンバ指定値×2）＜＝ net.ipv4.tcp_wmemのmax値」

Windows版では設定値の上限はありません。

オプション：-k

nodelay

設定値と省略値

Y｜N《N》

説明

TCP/IPが提供するソケットオプション「TCP_NODELAY」を使用するかどうかを指定します。

Y：「TCP_NODELAY」を使用する

N：「TCP_NODELAY」を使用しない

利点

「TCP_NODELAY」を使用することで送信済みデータの応答待ちの状態でも遅延させることなくデータ送信ができるようになります。

注意事項

「TCP_NODELAY」を使用することでネットワークの負荷は大きくなります。

オプション：-i

watchtime

設定値と省略値

〈符号なし整数〉((0〜65535))《300》（単位：秒）

説明

外部システムと既存システム間のコネクションの無通信時間を指定します。

対象のコネクションにおいて、最後に電文を処理した時刻から本定義時間以上経過後も電文登録がない場合、テスト対象システムとの間のコネクションを解放します。

本フラグメンバに0を指定した場合は、コネクションを解放しません。

利点

外部システムと既存システム間のコネクションが解放されたときに、FINやRSTをキャプチャ出来なかった場合でも、コネクションを解放することができます。

connect_stopmsg

設定値と省略値

Y｜N《Y》

説明

テスト対象システムのコネクションを相手プロセス側が切断（RST検知）した場合に、KFSE43310-Wメッセージを出力するかどうかを指定します。

Y：メッセージを出力します。

N：メッセージを出力しません。

3.5.7　既存システムとテスト対象システムに対する定義例

各プロトコルに対する、既存システムとテスト対象システムの指定数の組み合わせを以下に示します。

表3‒5　プロトコル毎の既存システムとテスト対象システムの対応表

既存システムのIPアドレス数と

テスト対象システムのIPアドレス数

RPC

TCPスルー

（クライアント型）

TCPスルー

（サーバ型）

UDP

スルー

HTTP

IIOP

1：1

○

○

○

○

○

○

M：1

○

○

○

○

○

○

1：N

○

○

×

○

○

○

M：N

○

○

×

○

○

○

（凡例）

M、N：2以上の数

○：指定可能

×：指定不可

単一の既存システムと単一のテスト対象システムを指定するケース（1：1）

図3‒1　既存システムとテスト対象システムが1：1の定義例

複数の既存システムと単一のテスト対象システムを指定するケース（M：1）

図3‒2　既存システムとテスト対象システムがM：1の定義例

単一の既存システムと複数のテスト対象システムを指定するケース（1：N）

図3‒3　既存システムとテスト対象システムが1：Nの定義例

複数の既存システムと複数のテスト対象システムを指定するケース

図3‒4　既存システムとテスト対象システムがM：Nの定義例

応答送信のみ送信するサーバを指定するケース

rpcプロトコルによる送受信には要求電文をスケジュールサービスが受信し、異なるサーバに要求電文を転送するシステム構成があります。この場合、スケジューラから電文を受信したサーバが外部システムに応答電文を送信します。

下図のように応答送信のみを行うサーバが存在するケースでは以下のように-sに応答送信用サーバを指定し-tフラグを省略して定義してください。

図3‒5　応答送信のみ送信するサーバを指定する定義例

3.6　クライアント関連定義（client_definition）

形式

[client_definition [-p "[thread_create_rate=クライアント毎処理スレッド作成数]
                        [max_thread=最大スレッド数]
                        [thread_max_telegram=スレッド当たり電文先読み数]"]
                   [-q "schedule_type=実行処理タイプ"]]

機能

電文を処理するスレッド数に関する定義です。

クライアント数に対して作成するスレッド数や、システムテスト支援内で作成する最大スレッド数を指定します。

指定数

0〜1

オプション：-p

thread_create_rate

設定値と省略値

〈符号なし整数〉((1〜100))《5》（単位：クライアント数）

説明

電文を処理するスレッドを生成するクライアントの数を指定します。クライアント数が本定義値を超過する度に、スレッドを1つ作成します。

（定義値が5の場合、クライアント数が6になった時（定義値5を超過した時）にスレッドを作成します）。

ほかのオペランドとの関連

スレッド数がmax_thread定義値に達した場合は、以後スレッドを作成しません。

schedule_typeがserialの場合、本定義値に関わらず、スレッドを作成しません。

指定値の目安

各クライアントで平均的に電文を受信し、かつその電文数が多い場合は、1クライアントあたりに割り当たるスレッドの頻度を増やすため、本定義値に小さい値を指定してください。

利点

指定値の目安に従って本定義を指定した場合、製品全体のスループットが上がることがあります。

見積もり式への影響

メモリ使用量の見積もりに影響します。本定義に小さい値を指定した場合はメモリ使用量が増加します。

max_thread

設定値と省略値

〈符号なし整数〉((1〜1000))《10》（単位：スレッド数）

説明

システムテスト支援で電文処理に使用するスレッドの最大数を指定します。

スレッド数が本定義値に達した場合、以後スレッドを生成しません。

ほかのオペランドとの関連

クライアント数がthread_create_rate定義で指定した値を超過するたびに電文を処理するスレッドを生成しますが、本指定値に達した場合は以降スレッドの生成は行われません。

利点

生成するスレッドの最大数を制限することが出来ます。

指定値の目安

接続クライアント数とthread_create_rate定義値を考慮して指定してください。

備考

システムテスト支援の稼働マシンのCPUコア数が少ない場合、本定義値に大きい値を指定してもスループットは上がりません。

thread_max_telegram

設定値と省略値

〈符号なし整数〉((5～1000))《5》（単位：スレッド当たり電文先読み数）

説明

システム検証支援基盤は、リプレイ実行時およびpcap実行時に、蓄積ファイル内またはpcapファイル内の複数の電文を先読みした上で送信します。

その際に先読みする電文数の上限を指定します。

先読みする電文数は、max_threadオペランド指定値×本オペランド指定値となります。

ほかのオペランドとの関連

メモリ上に同時に展開される電文数の上限は、max_threadオペランド指定値×本オペランド指定値となります。

利点

蓄積実行時またはpcap実行時に、システム検証支援基盤のスループットが要求する値に達しない場合、この定義に元の指定値の2倍以上の値を指定することで、スループットが改善する可能性があります。

指定値の目安

リプレイ実行時またはpcap実行時に、システム検証支援基盤のスループットが要求する値に達しない場合は、この定義に元の指定値の2倍以上の値を指定してください。その際、使用できるメモリ容量を考慮して指定してください。

備考

大きな値を設定すると、蓄積ファイルまたはpcapファイル内の電文のサイズによってはメモリ所要量が大幅に増大します。必要なとき以外は、この定義を変更しないようにしてください。

オプション：-q

schedule_type

設定値と省略値

parallel｜serial 《parallel》

説明

システムテスト支援で電文をパラレルに実行するか、シリアルに実行するかを指定します。

特に、全電文を受信順にシリアライズしてテスト対象システムへ送信したい場合、本定義でserialを指定してださい。なお、RAP電文を受信する場合、本定義を使用しないでください。使用した場合、システムテスト支援の動作は保証できません。

ほかのオペランドとの関連

本定義でserialを指定した場合、クライアント数が増えてもthread_create_rateの定義値でスレッドを作成しません。

注意事項

本定義でserialを指定した場合、シリアルの処理となるため、システムテスト支援でのスループットが低下します。そのため、全電文を受信順にシリアライズする目的以外で本定義を使用しないでください。

3.7　蓄積ファイル関連定義

3.7.1　蓄積ファイル作成に関する定義（accumulate_file）

形式

[accumulate_file -t {REQ|RPY|REQTS|RPYTS}
                [-f "[testuse={Y|N}]
                     [dirpath=蓄積ファイル格納ディレクトリパス]
                     [fileno=蓄積ファイル最大ファイル数]
                     [filesz=蓄積ファイル最大サイズ]"]
                [-b "[size=蓄積バッファサイズ]"] ]

機能

蓄積ファイル種別に関する定義です。

蓄積ファイルの格納場所やファイルサイズ等を指定します。

指定数

0〜4

オプション：-t

なし

設定値と省略値

REQ｜RPY｜REQTS｜RPYTS

説明

定義設定する蓄積ファイルの種別を指定します。

REQ：本番環境の要求電文蓄積ファイル

RPY：本番環境の応答電文蓄積ファイル

REQTS：テスト環境の要求電文蓄積ファイル

RPYTS：テスト環境の応答電文蓄積ファイル

オプション：-f

testuse

設定値と省略値

Y｜N《N》

説明

テスト環境の電文情報の蓄積を行うか否かを指定します。本オペランドを省略した場合、または、本オペランドにNを指定した場合は、テスト用の蓄積ファイルは作成されません。

Y：テスト用の電文情報を蓄積する

N：テスト用の電文情報を蓄積しない

前提条件

本オペランドは、-tオプションで指定した蓄積ファイル種別がREQTSまたはRPYTSの場合に有効となります。

見積もり式への影響

メモリ使用量の見積もりに影響します。本定義にYを指定した場合はメモリ使用量が増加します。

dirpath

設定値と省略値

Linux版の場合：〜〈980文字以内のパス名〉

Windows版の場合：〜〈217文字以内のパス名〉

《/opt/HSIC/job/x…x/afile/a…a》

a…aは蓄積ファイル種別により決定されます。

req：本番用の要求電文蓄積ファイル

rpy：本番用の応答電文蓄積ファイル

reqts：テスト用の要求電文蓄積ファイル

rpyts：テスト用の応答電文蓄積ファイル

x…x：テスト識別子

説明

蓄積ファイルを作成するディレクトリを絶対パス名で指定します。

指定した絶対パス名は事前に作成しておいてください。

任意のディレクトリに蓄積ファイルを作成したい場合のみdirpathを指定してください。

/opt/HSIC/job/XX・・・XX/afile/aaa（省略値）を指定した場合は起動に失敗する場合があります。

前提条件

蓄積ファイル種別は-tオプションで指定します。

利点

ユーザ任意のディレクトリに蓄積ファイルを作成することができます。

fileno

設定値と省略値

〈符号なし整数〉((1〜10000))《10000》（単位：ファイル数）

説明

蓄積ファイルの最大ファイル数を指定します。

前提条件

蓄積ファイル種別は-tオプションで指定します。

ほかのオペランドとの関連

本オペランドとfileszオペランドで指定する最大サイズの積が、システムテスト支援で格納できる電文の総量となります。

利点

使用するファイル数を制限できます。

指定値の目安

格納する電文総量、および、ディスクの空き容量を考慮して設定してください。

見積もり式への影響

蓄積ファイルの容量見積もりおよびメモリ使用量の見積もりに影響します。

注意事項

最大ファイル数の蓄積ファイルが満杯になった後に電文蓄積要求があった場合、以下の処理をします。

本番用の要求電文蓄積ファイル、または、本番用の応答電文蓄積ファイルの場合、システムテスト支援は異常終了します。

テスト用の要求電文蓄積ファイル、または、テスト用の応答電文蓄積ファイルの場合、格納済みの電文蓄積ファイルを上書きで再使用します。

filesz

設定値と省略値

〈符号なし整数〉((100〜1000000))《1000》（単位：メガバイト）

説明

蓄積ファイルの最大サイズをメガバイト単位で指定します。

前提条件

蓄積ファイル種別は-tオプションで指定します。

ほかのオペランドとの関連

本オペランドとfilenoオペランドで指定する最大ファイル数の積が、システムテスト支援で格納できる電文の総量となります。

利点

最大サイズを大きくすると最大ファイル数を少なく抑えることができ、ファイル管理が容易になります。

指定値の目安

格納する電文総量、および、ファイルスワップ運用の有無を考慮して設定してください。

見積もり式への影響

蓄積ファイルの容量見積もりに影響します。

注意事項

システムテスト支援の起動時、又は実行形態追加時には、前回起動時に使用した蓄積ファイルを削除します。このとき、サイズの大きい蓄積ファイルがdirpathオペランドで指定したディレクトリに残っていると起動に時間を要します。

オプション：-b

size

設定値と省略値

〈符号なし整数〉((1〜100))《10》（単位：メガバイト）

説明

蓄積バッファの最大サイズをメガバイト単位で指定します。

前提条件

蓄積バッファ種別は-tオプションで指定します。

利点

ユーザ環境に依存する電文サイズに合わせたバッファサイズに最適化でき、メモリを効率良く使用できます。

指定値の目安

通常は、このオペランドを指定する必要はありません。メモリ使用量を削減するために本指定値を小さくしたいときは、以下の計算式を目安に設定してください。

指定値 ≧ ↑（500 + （a＋1000） ×b） / （1024 × 1024）↑

a：プロトコルヘッダを含んだ電文のサイズ（バイト）

b：蓄積バッファに一時退避（スタック）する電文数（10以上を推奨）

見積もり式への影響

メモリ使用量の見積もりに影響します。

3.7.2　リプレイ実行時の蓄積ファイルに関する定義（accumulate_reply_file）

形式

[accumulate_reply_file -t {REQ|RPY}
                      [-f "[dirpath=蓄積ファイル格納ディレクトリパス]
                           [input={Y|N}]"]
                      [-r "[max_readsz=先読み最大サイズ]
                           [read_count=読込み回数]
                           [read_interval=再読込み間隔時間]"]]

機能

リプレイ実行時に、入力対象となる要求電文蓄積ファイルと本番用の応答電文蓄積ファイルに関する定義です。

蓄積ファイル格納場所等を指定します。

指定数

0〜2

オプション：-t

なし

設定値と省略値

REQ｜RPY

説明

リプレイ実行時に入力対象となる蓄積ファイルの種別を指定します。

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

オプション：-f

dirpath

設定値と省略値

Linux版の場合：〜〈980文字以内のパス名〉

Windows版の場合：〜〈217文字以内のパス名〉

《/opt/HSIC/job/x…x/afile/a…a》

a…aは蓄積ファイル種別により決定されます。

req：本番用の要求電文蓄積ファイル

rpy：本番用の応答電文蓄積ファイル

x…x：テスト識別子

説明

リプレイ実行時に入力対象となる蓄積ファイルが格納されたディレクトリを絶対パス名で指定します。1階層下のディレクトリ下にある蓄積ファイルまでが入力対象となります。

ディレクトリ下にある蓄積ファイル名を含めた絶対パス名が、Linux版では1024文字を超過、Windows版では259文字を超過する場合は入力対象外となります。

任意のディレクトリに蓄積ファイルを作成した場合のみdirpathを指定してください。

/opt/HSIC/job/XX・・・XX/afile/aaa（省略値）を指定した場合は起動に失敗する場合があります。

利点

ユーザ任意のディレクトリ下にある蓄積ファイルをリプレイ実行時の入力とすることができます。

input

設定値と省略値

Y｜N《Y》

説明

リプレイ実行時に応答電文蓄積ファイルを入力対象とするか否かを指定します。-tオプションに「RPY」を指定したときのみ有効です。

Y：蓄積ファイルを入力対象とします。

N：蓄積ファイルを入力対象外とします。

以下のケースに当てはまるときはNを指定してください。

・蓄積ファイル編集ユーティリティの拡張PUT要求により作成した本番用の要求電文蓄積ファイルを使用する場合。

・本番用の要求電文蓄積ファイルのみでリプレイ実行を行う場合。

利点

応答電文がない場合にNを指定することで、メモリ所要量を削減できます。

見積もり式への影響

Nを指定した場合、メモリ使用量の見積もりに影響します。

注意事項

本オペランドにNを指定したときに、応答電文が必要な要求電文があった場合、タイムアウトとなります。

オプション：-r

max_readsz

設定値と省略値

〈符号なし整数〉((10〜1000))《100》（単位：メガバイト）

説明

リプレイ実行時、要求電文/応答電文それぞれについて蓄積ファイルから先読みを行う最大サイズをメガバイト単位で指定します。

先読みした要求電文/応答電文のそれぞれの合計サイズが設定値を超えたとき、先読みを中断します。それぞれの電文種別について、先読みした電文サイズの半分以上を処理したときに、先読みを再開します。

見積もり式への影響

メモリ使用量の見積もりに影響します。

・（max_readsz値＋accumulate_file -b size値）×2

read_count

設定値と省略値

〈符号なし整数〉((0～2147483647))《1》

説明

リプレイ実行時、蓄積ファイルから要求電文/応答電文を読み込む回数を指定します。

1以外の値を指定した場合、すべての蓄積ファイルの読込みが完了したあと、ファイル先頭から再度要求電文/応答電文が読み込まれます。

0を指定した場合、esstopコマンドを発行するまで無制限に再読込みが繰り返されます。

-tオプションに「REQ」を指定したときだけ有効です。

利点

負荷テストを容易化できます。

read_interval

設定値と省略値

〈符号なし整数〉((0～86400000))《0》（単位：ミリ秒）

説明

蓄積ファイルを再読込みする際に、指定した時間が経過してから再読込みします。

蓄積ファイル内のテスト用電文が一巡したあと、次のテストを開始する前に間隔を空けます。

0を指定した場合は、間隔を空けずに読込みます。

-tオプションに「REQ」を指定したときだけ有効です。

テストを複数回実行する際に、蓄積ファイルの再読込み時間間隔を1000ミリ秒に設定した例を次に示します。

3.8　比較エラー情報ファイルに関する定義（compare_error_file）

形式

[compare_error_file [-f "[fileno=比較エラー情報ファイルの最大ファイル数]
                         [filesz=比較エラー情報ファイルの最大サイズ]"] ]

機能

並行実行、リプレイ実行、及びPCAP実行時に既存システムからの応答電文とテスト対象システムからの応答電文が異なる場合の比較エラー情報を取得するファイルに関する定義です。

比較エラー情報ファイルのファイル数やサイズを指定します。

指定数

0〜1

オプション：-f

fileno

設定値と省略値

〈符号なし整数〉((1〜100))《3》（単位：ファイル数）

説明

比較エラー情報を出力する最大ファイル数を指定します。

指定値の目安

データの比較エラーが大量に発生し、システムテスト支援実行中に上書きされる場合は、ファイル数を大きくしてください。

見積もり式への影響

比較エラー情報ファイルの容量見積もりおよびメモリ使用量の見積もりに影響します。

filesz

設定値と省略値

〈符号なし整数〉((1〜40))《40》（単位：メガバイト）

説明

比較エラー情報を取得するファイルの最大サイズをメガバイト単位で指定します。比較エラー情報ファイルへの出力容量がこのオペランド値を超えると、出力先のファイルを切り替えます。

指定値の目安

比較エラー情報1件あたり最大で約0.6キロバイトであることを目安に設定してください。

見積もり式への影響

比較エラー情報ファイルの容量見積もりに影響します。

3.9　実行形態関連定義（reply_send_mode）

形式

[reply_send_mode [-m  {wait {-s 倍速指定 | -t 送信間隔指定 |
                  -a "telegram_no=単位時間当たりの送信電文数
                    { test_second=秒単位の送信間隔 |
                      test_minute=分単位の送信隔 |
                      test_hour=時間単位の送信間隔 }" } | nowait}]]

機能

リプレイ実行の電文送信形態に関する定義です。

電文の送信間隔等を指定します。

本定義はリプレイ実行、PCAP実行で稼働している場合に有効です。

指定数

0〜1

オプション：-m

なし

設定値と省略値

wait｜nowait《nowait》

説明

リプレイ実行形態またはPCAP実行形態時の電文送信形態を指定します。

電文送信形態を連続送信実行とする場合は、nowaitを指定してください。

電文送信形態を倍速送信実行、または等間隔送信実行とする場合はwaitを指定してください。

wait：-sまたは-tに指定した間隔で要求電文を送信します。

nowait：間隔を置かず要求電文を送信します。

ほかのオペランドとの関連

waitを指定した場合は、「-s 倍速」または「-t 送信間隔」を指定してください。

nowaitを指定した場合は、「-s 倍速」または「-t 送信間隔」を指定しないでください。

指定した場合、システムテスト支援は異常終了します。

注意事項

リプレイ実行、又はPCAP実行でテスト対象システムに電文を連続送信すると「テスト対象システム側の受信処理間隔＞システム検証支援基盤の送信間隔」となり、テスト対象システム側ではパケットロストやコネクション断が多発する場合があります。

この場合は本オプションを指定し倍速指定・送信間隔指定を行うことを推奨します。

また、UDPスルー方式では上位のプロトコルで通番管理等を行っていない場合、パケットロストを検知できません。この場合も本オプションを指定し倍速指定・送信間隔指定を行うことを推奨します。

オプション：-s

なし

設定値と省略値

倍速〈符号なし整数〉((1〜3)) （単位：倍速値）

説明

リプレイ実行形態またはPCAP実行形態時の倍速送信実行の倍速値を指定します。

電文送信形態を倍速送信実行とする場合はこのオプションを指定してください。

・1を指定した場合

蓄積した時間間隔と同じ間隔で送信します。ただし、間隔が5ms未満の場合は間隔を置かずに送信します。

蓄積した時間と同じ間隔で送信しますが、本番環境で送信されている間隔と同じとならない場合があります。

本番環境で送信されている間隔を再現するものではありません。

・2を指定した場合

蓄積した時間間隔の1/2の間隔で送信します。ただし、1/2が5ms未満となった場合は間隔を置かずに送信します。

・3を指定した場合

蓄積した時間間隔の1/3の間隔で送信します。ただし、1/3が5ms未満となった場合は間隔を置かずに送信します。

応答要の電文送信時、テスト対象システムからの応答電文を受信してから次の要求電文を送信します。よって実際に送信される間隔はテスト対象システムからの応答を受信するタイミングに影響されますので指定した時間で送信されない場合があります。

また、「1.4.4　電文のシリアライズ処理」で示すとおり、送信元クライアント単位でシリアライズされるため、送信元クライアントが異なる場合は送信順番の逆転（追い越し）が発生する事があります。

前提条件

-mがwaitの場合に指定してください。

注意事項

マシン負荷等の影響により指定間隔で送信されない場合があります。

オプション：-t

なし

設定値と省略値

送信間隔〈符号なし整数〉((5〜86400000)) （単位：ミリ秒）

説明

リプレイ実行形態またはPCAP実行形態時の送信間隔をミリ秒単位で指定します。

電文送信を等間隔とする場合はこのオプションを指定してください。

応答要の電文送信時、テスト対象システムからの応答電文を受信してから次の要求電文を送信します。実際に送信される間隔はテスト対象システムからの応答を受信するタイミングに影響されるため、指定した間隔で送信されない場合があります。

前提条件

-mがwaitの場合に指定してください。

注意事項

マシン負荷等の影響によって指定間隔で送信されない場合があります。

オプション：-a

telegram_no

設定値と省略値

単位時間当たりの送信電文数〈符号なし整数〉((1〜2147483647))

説明

test_second、test_minute、test_hourのどれかのフラグメンバで指定された時間当たりに送信する電文数を指定します。以下の送信間隔で電文を送信します。

「(test_second、test_minute、test_hourのどれかのフラグメンバの指定値)／telegram_noフラグメンバの指定値」

telegram_noフラグメンバはテストする電文数を指定するものではなく、電文の送信間隔を算出するためだけに使用するパラメタです。

利点

telegram_noフラグメンバの指定値から電文の送信間隔を自動算出できます。

test_second

設定値と省略値

秒単位の送信間隔〈符号なし整数〉((1〜86400))（単位：秒）

説明

telegram_noフラグメンバで指定された数の電文を送信する時間を秒単位で指定します。

以下の送信間隔で電文を送信します。

「test_secondフラグメンバの指定値／telegram_noフラグメンバの指定値」（秒）

test_secondフラグメンバはテストする時間を指定するものではなく、電文の送信間隔を算出するためだけに使用するパラメタです。

test_secondフラグメンバを指定する場合、test_minute、test_hourフラグメンバは指定できません。

test_minute

設定値と省略値

分単位の送信間隔〈符号なし整数〉((1〜1440))（単位：分）

説明

telegram_noフラグメンバで指定された数の電文を送信する時間を分単位で指定します。

以下の送信間隔で電文を送信します。

「test_minuteフラグメンバの指定値／telegram_noフラグメンバの指定値」（分）

test_minuteフラグメンバはテストする時間を指定するものではなく、電文の送信間隔を算出するためだけに使用するパラメタです。

test_minuteフラグメンバを指定する場合、test_second、test_hourフラグメンバは指定できません。

test_hour

設定値と省略値

時間単位の送信間隔〈符号なし整数〉((1〜24))（単位：時間）

説明

test_hourフラグメンバで指定された数の電文を送信する時間を時間単位で指定します。

以下の送信間隔で電文を送信します。

「test_hourフラグメンバの指定値／telegram_noフラグメンバの指定値」（時間）

test_hourフラグメンバはテストする時間を指定するものではなく、電文の送信間隔を算出するためだけに使用するパラメタです。

test_hourフラグメンバを指定する場合、test_second、test_minuteフラグメンバは指定できません。

3.10　フィルタ関連定義

3.10.1　時刻フィルタに関する定義（target_time）

形式

[target_time [–t "[begin=開始時刻]
                  [end=終了時刻]"] ]

機能

時刻のフィルタリングに関する定義です。

指定した時刻の範囲内の電文を入力対象とします。

指定数

0〜1

オプション：-t

begin

設定値と省略値

開始時刻（YYYYMMDDhhmmss）〈符号なし整数〉

((1971〜9999、01〜12、01〜31、00〜23、00〜59、00〜61))

説明

入力電文のテスト対象範囲の開始時刻を指定します。

esstartコマンドで-tオプションを指定した場合は、本定義値を無視してesstartコマンド-tオプション指定値に従って動作します。esstartコマンド-tオプションで終了時刻のみ指定された場合は、開始時刻は省略扱いとなります。

開始時刻を指定した場合は、開始時刻以降の入力電文を対象としてテストを開始します。開始時刻より前の入力電文はテスト対象外として破棄します。

また、開始時刻／終了時刻には+1秒程度の誤差が発生する場合があります。

（例）

begin値が20130531120000の場合、2013年5月31日 12:00:00以降の電文をテスト対象としてテストを開始します。2013年5月31日 11:59:59.999受信の電文はテスト対象外なので破棄し、2013年5月31日 12:00:00.000受信の電文はテスト対象となります。

開始時刻を省略した場合は、システムテスト支援起動時点（リプレイ実行形態では蓄積ファイルの先頭、PCAP実行形態ではpcap形式ファイルの先頭）以降の入力電文をテスト対象とします。

指定形式はYYYYMMDDhhmmssです。YYYYMMDDは開始日付指定を、hhmmssは開始時刻指定を示します。秒指定（ss）は最大2秒の閏秒を考慮した61秒までの指定が可能です。

指定時刻はTZ環境変数に合わせて取り扱います。指定時刻がUNIX時間最大値（TZ環境変数がUTCの場合、2038年1月19日（火） 3時14分7秒）を超過した場合は、指定時刻をUNIX時間最大値として扱います。

ほかのオペランドとの関連

begin指定値 < end指定値となる値を指定してください。

begin指定値 ≧ end指定値となる指定された場合、システムテスト支援を異常終了します。

利点

入力電文のテスト対象範囲を開始時刻で指定することができます。

end

設定値と省略値

終了時刻（YYYYMMDDhhmmss）〈符号なし整数〉

((1971〜9999、01〜12、01〜31、00〜23、00〜59、00〜61))

説明

入力電文のテスト対象範囲の終了時刻を指定します。

esstartコマンドで-tオプションを指定した場合は、本定義値を無視してesstartコマンド-tオプション指定値に従って動作します。esstartコマンド-tオプションで開始時刻のみ指定された場合は、終了時刻は省略扱いとなります。

終了時刻を指定した場合は、終了時刻より前の入力電文を対象としてテストを実行します。終了時刻以降の入力電文はテスト対象外として破棄し、テスト対象電文の全てのテストを実行した後に、システムテスト支援プロセスを正常終了します。

また、終了時刻は+1秒程度の誤差が発生する場合があります。

（例）

end値が20130531120000の場合、2013年5月31日 12:00:00未満の電文をテスト対象としてテストを実行します。2013年5月31日 11:59:59.999受信の電文はテスト対象としてテストを実行しますが、2013年5月31日 12:00:00.000受信の電文はテスト対象外となりテストを実施しません。2013年5月31日 12:00:00.000を経過し、テスト対象の電文を全てテスト実行した後、システムテスト支援は自動的にテストを終了します。

終了時刻を省略した場合は、プロセス終了コマンド受付時点（リプレイ実行形態では蓄積ファイルの末尾、PCAP実行形態ではpcap形式ファイルの末尾）までの入力電文をテスト対象とします。

指定形式はYYYYMMDDhhmmssです。YYYYMMDDは終了日付指定を、hhmmssは終了時刻指定を示します。

指定時刻はTZ環境変数に合わせて取り扱います。指定時刻がUNIX時間最大値（TZ環境変数がUTCの場合、2038年1月19日（火） 3時14分7秒）を超過した場合は、指定時刻をUNIX時間最大値として扱います。

ほかのオペランドとの関連

begin指定値 < end指定値となる値を指定してください。

begin指定値 ≧ end指定値となる値が指定された場合、システムテスト支援を異常終了します。

利点

入力電文のテスト対象範囲を終了時刻で指定することができます。

3.10.2　RPCフィルタに関する定義（rpc_telegram_filter）

形式

[rpc_telegram_filter [-g "server_svg=要求先サービスグループ名"]
                     [-s "server_sv=要求先サービス名"]
                     [-n "
                          [client_nid=要求元ノード識別子]"]
                     [-p {rpc|rap}]
                     [-i "[server_ip=サーバIPアドレス]
                          [client_ip=クライアントIPアドレス]"]]

機能

RPC・RAP電文のフィルタリングに関する定義です。

本定義に指定した情報を含む電文を入力対象とします。

複数記述した場合、rpc_telegram_filter定義間の指定はOR条件、rpc_telegram_filter内の指定はAND条件として判定します。

記述が省略されたフラグメンバに関しては、判定を行わず全ての電文を入力対象として扱います。

以下に定義の指定方法のユースケースを示します。

例1：一部のクライアントから特定のサーバの特定サービスへの要求電文のみを取得したい場合

サービスAに送信される要求電文とクライアント x.x.x.1からサーバ y.y.y.1のサービスBに送信される要求電文を取得する。

例2：特定のクライアントノードからの要求電文のみを取得したい場合

クライアント x.x.x.1のnid2から送信される要求電文を取得する。

指定数

0〜99999

オプション：-g

server_svg

設定値と省略値

〈1〜31文字の識別子〉

説明

入力対象とする要求送信先（サーバ側）のサービスグループ名を指定します。

任意の文字列の後ろを「*」を用いてワイルドカードで表すことができます。

ただし、文字列の先頭で「*」を利用することはできません。

利点

入力対象とする電文を制限することができます。

指定値の目安

要求送信先で使用しているTP1製品に応じて以下の値を指定してください。

TP1/SBの場合：ユーザサービス定義のservice_group指定値

TP1/EEの場合：TP1/EEサービス定義（プロセス関連定義）のservice_group指定値

見積もり式への影響

メモリ所要量に影響します。

オプション：-s

server_sv

設定値と省略値

〈1〜31文字の識別子〉

説明

入力対象とする要求送信先（サーバ側）のサービス名を指定します。

任意の文字列の後ろを「*」を用いてワイルドカードで表すことができます。

ただし、文字列の先頭で「*」を利用することはできません。

利点

入力対象とする電文を制限することができます。

指定値の目安

要求送信先で使用しているTP1製品に応じて以下の値を指定してください。

TP1/SBの場合：ユーザサービス定義のservice指定値

TP1/EEの場合：TP1/EEサービス定義（ユーザサービス関連定義）のservice指定値

見積もり式への影響

メモリ所要量に影響します。

オプション：-n

client_nid

設定値と省略値

〈4文字の識別子〉

説明

入力対象とする要求送信元（クライアント側）のノード識別子を指定します。

任意の文字列の後ろを「*」を用いてワイルドカードで表すことができます。

ただし、文字列の先頭で「*」を利用することはできません。

利点

入力対象とする電文を制限することができます。

指定値の目安

要求送信元で使用しているTP1製品に応じて以下の値を指定してください。

TP1/SBの場合：システム共通定義のnode_id指定値

TP1/EEの場合：TP1/EEサービス定義（RPC関連定義）のnode_id指定値

なお、TP1/Clientを使用する場合は、本フラグメンバを定義しても、定義されていない場合と同様の動作となります。

見積もり式への影響

メモリ所要量に影響します。

オプション：-p

なし

設定値と省略値

rpc|rap

説明

入力対象とする電文のプロトコル種別を指定します。

rpc：rpcプロトコル電文のみを入力します。

rap：rapプロトコル電文のみを入力します。

なお、省略した場合はrpc・rap両プロトコル電文を入力します。

利点

入力対象とする電文を制限することができます。

見積もり式への影響

メモリ所要量に影響します。

注意事項

本フラグメンバの設定値のrpcはリモートAPI電文は含みません。

オプション：-i

server_ip

設定値と省略値

IPアドレス（nnn.nnn.nnn.nnn）〈符号なし整数〉((0〜255))

説明

入力対象とする要求送信先（サーバ側）のIPアドレスを指定します。

IPアドレスは範囲指定で指定することができます。

範囲指定：xxx.xxx.xxx.xxx-yyy.yyy.yyy.yyy

IPアドレスがxxx.xxx.xxx.xxxからyyy.yyy.yyy.yyyまでのIPアドレスを要求送信先とする電文が取得対象となります。xxx.xxx.xxx.xxxとyyy.yyy.yyy.yyyの値は、xxx.xxx.xxx.xxxがyyy.yyy.yyy.yyy以下の値となるように値を指定してください。

利点

入力対象とする電文を制限することができます。

見積もり式への影響

メモリ所要量に影響します。

client_ip

設定値と省略値

IPアドレス（nnn.nnn.nnn.nnn）〈符号なし整数〉((0〜255))

説明

入力対象とする要求送信元（クライアント側）のIPアドレスを指定します。

IPアドレスは範囲指定で指定することができます。

範囲指定：xxx.xxx.xxx.xxx-yyy.yyy.yyy.yyy

IPアドレスがxxx.xxx.xxx.xxxからyyy.yyy.yyy.yyyまでのIPアドレスを要求送信元とする電文が取得対象となります。xxx.xxx.xxx.xxxとyyy.yyy.yyy.yyyの値は、xxx.xxx.xxx.xxxがyyy.yyy.yyy.yyy以下の値となるように値を指定してください。

利点

入力対象とする電文を制限することができます。

見積もり式への影響

メモリ所要量に影響します。

3.11　RPC関連定義

3.11.1　RPC応答受信待ち時間に関する定義（rpc_watchtime）

形式

[rpc_watchtime [-s {msg|def}]
               [-k {threshold|fixed}]
               [-t "[thresholdtime=タイムアウト時間設定の閾値]
                    [watchtime=タイムアウト時間]"]]

機能

RPC・RAP電文の要求に対するテスト対象システムからの応答の到着待ち時間を決定する定義。省略した場合は、要求電文中に設定されている待ち時間を利用します。

（既存システムからの応答電文の到着待ち時間は、要求電文中に設定されている待ち時間を利用します。）

また、要求電文中に待ち時間の情報がない場合（※）は180秒を仮定します。

（※）例えば以下の場合があります。

SUP、SPPで応答待ち時間（watch_time定義）に0を指定した場合

CUPで、DCWATCHTIMRPCINHERIT定義がデフォルト（N）の場合、または同定義にYを指定し、かつ応答待ち時間（DCWATCHTIM定義）に0を指定した場合

RAPコネクション解放依頼電文

なお、待ち時間監視には以下の誤差が発生する場合があります。

t≦T≦t+5

t：watchtime指定値または電文中に指定された応答待ち時間

T：システムテスト支援が実際に待ち合わせた時間

指定数

0〜1

オプション：-s

なし

設定値と省略値

msg|def 《msg》

説明

電文に設定されている値を応答到着待ち時間とするか、-tに設定した値を応答到着待ち時間とするかを指定します。

msg：電文に設定されている値を応答待ち時間とします。

def：-tに定義されている値を応答待ち時間とします。

オプション：-k

なし

設定値と省略値

fixed|threshold 《fixed》

説明

定義による応答到着待ち時間を設定する場合に、全ての電文に対して一律同じ値を設定するか、閾値を設定し、それを超える待ち時間を電文中に持っているものに対してのみ定義値を適用するかを決定します。

fixedの場合は全ての電文に対して一律に、thresholdの場合は閾値を超えている電文に対してのみ定義値を設定します。

前提条件

本フラグ引数は、rpc_watchtimeの-sにdefが指定されているときのみ有効です。

それ以外の場合は指定があると構文エラーとなります。

ほかのオペランドとの関連

fixedを指定した場合は、rpc_watchtimeの-t watchtimeに、待ち時間の数値を指定してください。

thresholdを指定した場合は、rpc_watchtimeの-t thresholdtimeに待ち時間の数値を指定してください。

オプション：-t

thresholdtime

設定値と省略値

〈符号なし整数〉（1〜65535） 《180》 （単位：秒）

説明

応答到着待ち時間を適応する際の閾値を設定します。

電文に元々設定されていた待ち時間が、この設定値より大きい場合（0による無限待ちを含む）、設定値を待ち時間として採用します。

電文に元々設定されていた待ち時間がない場合は、元の待ち時間を180秒と仮定して動作します。

前提条件

本フラグメンバはrpc_watchtimeの-sにdef、rpc_watchtimeの-kにthresholdの両方が指定されているときのみ有効です。

それ以外の場合は指定があると構文エラーとなります。

利点

閾値を利用することで、閾値よりも待ち時間が小さいものはそのまま変更せず、大きいものだけを閾値まで丸めることができます。

これにより、本番では余裕を持って応答待ち時間を設定していた電文と、余裕のない待ち時間を設定していた2種類の電文があり、これをシステムテスト支援でテスト対象システムへ送信するときに、全ての電文の待ち時間を一律で変更してしまうのではなく、余裕のあった電文だけを閾値により待ち時間を変更させることができます。

例

外部システムから既存システムへの要求電文として、

・応答待ち時間180秒の電文

・応答待ち時間10秒の電文

の2種類が存在し、これを並行実行・リプレイ実行・PCAP実行でテスト対象システムへ送信する際に、rpc_watchtime -s def -k threshold -t "thresholdtime=60"を設定しておくことで、

・応答待ち時間180秒の電文は応答待ち時間を60秒に変更してテスト対象システムへ送信

・応答待ち時間10秒の電文はそのままテスト対象システムへ送信

となります。

watchtime

設定値と省略値

〈符号なし整数〉 （0〜65535） 《180》（単位：秒）

説明

応答到着待ち時間を秒単位で設定します。

0を指定した場合は無限待ちになります。

前提条件

本フラグメンバはrpc_watchtimeの-sにdef、rpc_watchtimeの-kにfixedの両方が指定されているときのみ有効です。

それ以外の場合は指定があると構文エラーとなります。

ほかのオペランドとの関連

rpc_watchtime -sオプション

rpc_watchtime -kオプション

利点

定義で設定した数値でテスト対象システムからの電文応答を待つことができます。

全ての電文に対して一律で設定できるため、細かな待ち時間の調整が必要ない場合に、設定が容易になります。

注意事項

0を指定した場合は応答が来るまで無限に待ち続けるため、ネットワーク障害などにより電文が受信できなかった場合、処理が止まってしまう場合があります。

このような事態を避けるために、必要な場合以外は有限待ちになる数値を指定することをお勧めします。

3.11.2　RPC電文組立監視に関する定義（rpc_build_message_watchtime）

形式

[rpc_build_message_watchtime [-t "watchtime=組立監視時間"] ]

機能

RPC電文の組立処理の監視時間に関する定義です。

電文組立てに要する最大許容時間を指定します。

指定数

0〜1

オプション：-t

watchtime

設定値と省略値

〈符号なし整数〉（10〜100000） 《700》（単位：ミリ秒）

説明

電文組立処理が一定時間進まないデータについて、破棄を行う時間を設定します。

ネットワーク障害などにより組立に必要なデータが取得できなかった場合に、メモリ上の組立途中の電文が残留してしまわないように、指定された時間組立処理が行われなかった電文を破棄します。

ほかのオペランドとの関連

capture_definition -tオプションのretrans_watchtimeフラグメンバより小さな値を指定しないでください。小さな値を指定すると、再送パケットをキャプチャした時点で、メモリ上の組立途中の電文がすでに破棄されていることがあります。

利点

メモリリークの防止することができます。

指定値の目安

capture_definition -tオプションのretrans_watchtimeフラグメンバより大きな値を指定してください。

注意事項

小さすぎる値を設定すると、正常に組立が行われている電文についても破棄してしまうおそれがあります。必要がない場合は、この定義を変更しないようにしてください。

3.11.3　RPCコネクション管理に関する定義（rpc_socket）

形式

[rpc_socket [-m "max_socket=最大ソケット数 "]
            [-w "[sockctl_highwater=ソケットの一時クローズ処理開始数パーセンテージ]
                 [sockctl_lowwater=ソケットの一時クローズ処理非対象数パーセンテージ]"]
            [-t "[sockctl_watchtime=一時クローズ応答待ち時間]"]]

機能

RPC・RAPプロトコルのコネクションに関する定義です。

RPC・RAPプロトコルで利用するコネクションの本数や、一時クローズ処理を開始するソケット数のパーセンテージ、一時クローズ処理非対称とするソケット数のパーセンテージを指定します。

一時クローズ処理については、マニュアルOpenTP1 解説の「ポート数の制限方法」の説明を参照してください。

指定数

0〜1

オプション：-m

max_socket

設定値と省略値

〈符号なし整数〉 （32〜32768） 《512》（単位：ソケット数）

説明

RPC・RAPプロトコルで利用するソケットの上限を指定します。

注意事項

・OSで1プロセスで利用できるソケット（ファイルディスクリプタ）数が制限されています。

その制限値以上の値を利用する場合は、OSの上限を変更してください。

スーパーユーザーで、「ulimit -n」と実行して出力された値よりも大きな値nnnnを指定して、「ulimit -n nnnn」を実行すると実行したシェルに対して一時的にオープンファイル数がnnnnに変更されます。

・RAP通信で利用するコネクション本数も、本フラグメンバに含まれます。

・本フラグメンバに適切な値を設定していない場合、一時クローズの待ち合わせ処理が多発し処理速度の低下を引き起こす場合があります。

オプション：-w

sockctl_highwater

設定値と省略値

〈符号なし整数〉（0〜100） 《100》（単位：パーセンテージ）

説明

rpc_socket -m max_socketに対して、ソケットの一時クローズ処理開始数パーセンテージを指定します。

ほかのオペランドとの関連

プロセス内のソケット用に使用しているファイル記述子の数が、次の値を超えた時点で、一時クローズ処理を開始します。

rpc_socket -m max_socketの指定値×（本フラグメンバ値／100）

注意事項

本フラグメンバ値に0を指定した場合、コネクションを確立するたびに一時クローズ処理が実行されます。

sockctl_lowwater

設定値と省略値

〈符号なし整数〉（0〜100）《0》（単位：パーセンテージ）

説明

rpc_socket -m max_socketに対して、ソケットの一時クローズ処理対象外とするパーセンテージを指定します。

対象外となるソケットは、利用時刻が新しい順に選定されます。

ほかのオペランドとの関連

一時クローズ処理が実行された際に、次の値の数だけソケットを残します。

rpc_socket -m max_socketの指定値×（本フラグメンバ値／100）

本フラグメンバ値に、rpc_socket -w sockctl_highwaterの指定値よりも大きい値を設定した場合は、本フラグメンバ値に0が指定されたものとして動作します。

注意事項

本フラグメンバ値に0を指定した場合、一時クローズ処理が実行された際に利用している全てのソケットに対し、一時クローズ処理が実行されます。

オプション：-t

sockctl_watchtime

設定値と省略値

〈符号なし整数〉（0〜65535）《180》（単位：秒）

説明

使用中のソケット数がrpc_socket -m max_socket設定値と同じになった時点から、一時クローズ処理によってソケットが再利用できるようになるまでの時間を秒単位で指定します。

rpc_socket -m max_socket設定値までソケットを使った際の一時クローズ処理では、一時クローズ要求を送信した後、このフラグメンバの設定値だけ応答を待ち合わせます。この待ち時間の間にどのプロセスからも一時クローズの応答が帰ってこなかった場合、システムテスト支援は異常終了となります。

応答待ちは、応答が届き、使用中ソケット数がrpc_socket -m max_socket指定値より小さくなった時点で解除されます。

ほかのオペランドとの関連

使用中のソケット数がrpc_socket -m max_socketを下回るまで、一時クローズ処理応答を指定時間待ち合わせます。

指定値の目安

テスト対象システムのOpenTP1でpolling_control_dataオペランドにYが設定されている場合は、本フラグメンバの指定値を、テスト対象システムのOpenTP1のthread_yield_intervalオペランドの指定値よりも大きな値にしてください。

注意事項

・0を指定した場合は応答が来るまで無限に待ち続けるため、ネットワーク障害などにより電文が受信できなかった場合、処理が止まってしまう可能性があります。このような事態を避けるために、必要な場合以外は有限待ちになる数値を指定することをお勧めします。

・テスト対象システムにサービス要求が長時間発生しない常駐UAPが存在する場合は、テスト対象のTP1でpolling_control_dataオペランドにYを設定してください。常駐UAPの数や、システムテスト支援とUAPの通信が行われない時間の長さによっては、システムテスト支援とテスト対象システムとの一時クローズ機能が十分な効果を発揮できず、システムテスト支援がKFSE60303-Eメッセージを出力し、システムダウンする場合があります。

3.11.4　クライアントの増幅に関する定義（rpc_definition）

形式

[rpc_definition [-t "[execution_count=RPC電文の実行数]
                     [execution_delay_time=クライアント増幅時の遅延時間]
                     [testaddr_select={client | telegram }]"]]

機能

RPC電文に関する定義です。

指定数

0〜1

オプション：-t

execution_count

設定値と省略値

〈符号なし整数〉(1〜20000)《1》

説明

本番環境のRPC電文の実行数（増幅回数）を指定します。

2以上を指定した場合、キャプチャしたRPC電文を複製し、別クライアントのRPC電文として処理します。

前提条件

本フラグメンバに1以外を指定している場合、framework_definition定義を指定すると構文エラーとなります。

本フラグメンバに1以外を指定している場合、uoc_func_rpc定義の-tオプションを指定すると構文エラーとなります。

指定値の目安

複数クライアントから同時に電文を送信するテストを実施したい場合に、2以上の値を指定してください。

execution_delay_time

設定値と省略値

〈符号なし整数〉(0〜3600000)《0》（単位：ミリ秒）

説明

クライアント増幅による送信開始を遅延させる時間を設定します。

前提条件

execution_countフラグメンバに1以外を指定していること。

指定値の目安

複数クライアントから一定の時間差で電文を送信するテストを実施したい場合に使用します。

testaddr_select

設定値と省略値

client｜telegram 《client》

説明

RPC要求電文送信先の選択方法を指定します。

client：クライアント単位にテスト対象システムを選択

telegram：RPC要求電文を送信するたびにテスト対象システムを選択

このフラグメンバにclientを指定した場合は、クライアントの初回のRPC要求電文送信時にテスト対象システムを選択できます。同じクライアントに対する2回目以降のRPC要求電文送信時には、初回送信時に選択したテスト対象システムに送信されます。

前提条件

address_destination定義の-tオプションで、複数のテスト対象システムを指定していること。

3.12　UOC関連定義

3.12.1　プロトコル共通UOCに関する定義（uoc_func_com）

形式

[uoc_func_com [-s "開始終了UOCエントリポインタ名"]

機能

プロトコル共通UOCのエントリポインタ名に関する定義です。

指定数

0〜1

オプション：-s

設定値と省略値

開始終了UOCエントリポインタ名 〈1〜31字以内の識別子〉

説明

開始終了UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定してください。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

3.12.2　RPCのUOCに関する定義（uoc_func_rpc）

形式

[uoc_func_rpc [-i "入力判定UOCエントリポインタ名"]
              [-a "蓄積編集UOCエントリポインタ名"]
              [-s "送信編集UOCエントリポインタ名"]
              [-c "データ比較UOCエントリポインタ名"]
              [-r "受信電文UOCエントリポインタ名"]
              [-u "client_area_size=クライアント単位ユーザ領域サイズ"]]

機能

RPC・RAPプロトコルで使用するUOCのエントリポインタ名に関する定義です。

指定数

0〜1

オプション：-i

設定値と省略値

入力判定UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

入力判定UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定します。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

オプション：-a

設定値と省略値

蓄積編集UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

蓄積編集UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定します。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

オプション：-s

設定値と省略値

送信編集UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

送信編集UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定します。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

オプション：-c

設定値と省略値

データ比較UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

データ比較UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定します。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

オプション：-r

設定値と省略値

受信電文UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

受信電文UOCエントリポインタ名を指定します。

ほかのオペランドとの関連

本オプションにはmodule定義で指定するライブラリ中に存在するエントリポインタ名を指定します。本オプションで指定したエントリポインタ名がmodule定義で指定したライブラリ内に複数存在した場合、module定義で先に定義されたエントリポインタ名が有効となります。

オプション：-u

client_area_size

設定値と省略値

〈符号なし整数〉((0〜65535))《0》（単位：キロバイト）

説明

クライアント単位ユーザ領域サイズを指定します。

0を指定した場合、クライアント単位ユーザ領域は使用できません。

利点

UOC間で情報を引き継ぐことができます。

3.12.3　UOCのタイマに関する定義（uoc_hungup_time）

形式

[uoc_hungup_time [-t "UOC監視時間"]]

機能

UOCの監視時間に関する定義です。

指定数

0〜1

オプション：-t

設定値と省略値

〈符号なし整数〉((0〜65535))《60》（単位：秒）

説明

UOC実行処理のハングアップ監視時間を秒単位で指定します。UOC内部の無限待ちや無限ループによるハングアップを検知できます。

監視の対象となる処理の時間が、このフラグメンバに指定した時間を越えるとシステムテスト支援は異常終了します。

0を指定した場合、UOC実行処理のハングアップ監視を行いません。

3.12.4　UOCの共用ライブラリに関する定義（module）

形式

{{[module -p "UOC共用ライブラリ名"] }}

機能

UOC処理を含んだUOC共用ライブラリ名称に関する定義です。

指定数

0〜64

オプション：-p

設定値と省略値

Linux版の場合：UOC共用ライブラリ名〈510字以内のパス名〉：

Windows版の場合：UOC共用ライブラリ名 ～〈259字以内のパス名〉

説明

UOC処理を含んだUOC共用ライブラリ名称を絶対パス名で指定します。

ほかのオペランドとの関連

uoc_func_com定義、uoc_func_rpc定義においてUOCエントリポインタ名を指定している場合、本定義を必ず指定してください。

3.13　メッセージログ関連定義（message_log）

形式

[message_log [-f "[filesz=メッセージログファイルの最大容量]"]
             [-s "[syslog_out=syslogへのメッセージ出力レベル]"]]

機能

メッセージログ関連情報に関する定義です。

メッセージログファイルのファイルサイズやsyslogへ出力するメッセージレベルを指定します。

指定数

0〜1

オプション：-f

filesz

設定値と省略値

〈符号なし整数〉 ((1〜1024))《1》（単位：メガバイト）

説明

メッセージログファイルの最大サイズをメガバイト単位で指定します。

指定値の目安

保存したいメッセージログ量にあわせて設定してください。

見積もり式への影響

メッセージログファイルの容量見積もりに影響します。

オプション：-s

syslog_out

設定値と省略値

〈符号なし整数〉 ((0〜6))《0》（単位：syslog出力レベル）

説明

ログファイルへ出力されるメッセージについて、syslogへ出力するレベルを指定します。

0：すべてのメッセージを出力しません。

1：レベル1のメッセージを出力します。

2：レベル2以下のメッセージを出力します。

3：レベル3以下のメッセージを出力します。

4：レベル4以下のメッセージを出力します。

5：レベル5以下のメッセージを出力します。

6：すべてのメッセージを出力します。

利点

このオペランドで設定した出力レベルより優先度が低いメッセージに対して、メッセージ出力を抑止することができます。

3.14　トラブルシュート関連定義

3.14.1　モジュールトレースに関する定義（module_trace）

形式

[module_trace [-e "entry=最小エントリ数"]]

機能

トラブルシュート情報のモジュールトレースに関する定義です。

指定数

0〜1

オプション：-e

entry

設定値と省略値

〈符号なし整数〉((256〜65535))《256》（単位：エントリ数）

説明

モジュールトレースで取得したい最小エントリ数を指定します。

指定値の目安

通常は、このフラグメンバを指定する必要はありません。

障害調査などで、保守員がこのフラグメンバの指定を依頼した場合は、保守員の指示に従ってください。

見積もり式への影響

モジュールトレースファイルの容量設定およびメモリ使用量の見積もりに影響します。

3.14.2　TASKTMに関する定義（tasktm_information）

形式

[tasktm_information [-f "[fileno=TASKTM最大ファイル数]
                         [filesz=TASKTMファイルサイズ]"]
                    [-b "[blockno=TASKTMブロック数]
                         [blocksz=TASKTMブロックサイズ]"]]

機能

トラブルシュート情報のTASKTMに関する定義です。

TASKTMのファイル数やファイルサイズ、メモリマップサイズ等を指定します。

指定数

0〜1

オプション：-f

fileno

設定値と省略値

〈符号なし整数〉((3〜100))《3》（単位：ファイル数）

説明

TASKTM情報を出力する最大ファイル数を指定します。

ほかのオペランドとの関連

tasktm_information定義の-bオプションのフラグメンバblocknoを参照してください。

指定値の目安

fileszフラグメンバとの組み合わせで、保存したいTASKTM情報量にあわせて設定してください。

見積もり式への影響

TASKTMファイルの容量およびメモリ使用量の見積もりに影響します。

filesz

設定値と省略値

〈符号なし整数〉((4000〜1000000))《40000》（単位：キロバイト）

説明

TASKTM情報を出力するファイルのサイズをキロバイト単位で指定します。

Windows版の場合、ファイルサイズは、ブロックサイズやOS情報等を基に最適値を自動計算するため、指定値より若干小さくなる場合があります。

ほかのオペランドとの関連

tasktm_information定義の-bオプションのフラグメンバblocknoを参照してください。

指定値の目安

filenoフラグメンバとの組み合わせで、保存したいTASKTM情報量にあわせて設定してください。

見積もり式への影響

TASKTMファイルの容量見積もりに影響します。

オプション：-b

blockno

設定値と省略値

〈符号なし整数〉((3〜200))《3》

説明

TASKTMファイルをメモリにマッピングするブロック数を指定します。

ほかのオペランドとの関連

tasktm_information定義の-bオプションに省略値以外を設定する場合は、-bオプションと-fオプションの指定値が以下の計算式を満たすように設定してください。

Linux版の場合

↑filesz設定値÷（↓blocksz設定値÷OSのページサイズ↓×OSのページサイズ）↑

×fileno設定値 ≧blockno設定値

Windows版の場合

↑filesz設定値÷(↓blocksz設定値÷OSのメモリ割り当て単位↓×OSのメモリ割り当て単位)↑

×fileno設定値 ≧blockno設定値

利点

TASKTMファイルを編集した結果、ファイルに出力されず破棄されたTASKTMが多い場合に、このフラグメンバの指定値を増やすと破棄されるTASKTMの数が減ることがあります。

指定値の目安

通常は、このフラグメンバを指定する必要はありません。

TASKTMファイルを編集した結果、破棄されたTASKTMが多い場合にこのオペランドの指定値を以下の計算式を目安に指定値を増やしてください。

このフラグメンバ指定値を増やす数

＝↑TASKTM破棄数 ×256 / （blockszオペランド指定値 × 1024）↑

見積もり式への影響

メモリ使用量の見積もりに影響します。

blocksz

設定値と省略値

〈符号なし整数〉((50〜20000))《200》（単位：キロバイト）

説明

TASKTMファイルをメモリにマッピングする1ブロックのサイズをキロバイト単位で指定します。

ほかのオペランドとの関連

tasktm_information定義の-bオプションのフラグメンバblocknoを参照してください。

利点

ファイルに出力されず破棄されたTASKTMが多い場合に、このフラグメンバの指定値を増やすと破棄されるTASKTMの数が減ることがあります。

指定値の目安

通常は、このフラグメンバを指定する必要はありません。

保守員がこのフラグメンバの指定を依頼した場合は、保守員の指示に従ってください。

見積もり式への影響

メモリ使用量の見積もりに影響します。

3.14.3　システム統計情報に関する定義（statistical_information）

形式

[statistical_information [-u "[use={Y|N}]
                              [interval_time=システム統計情報取得間隔]"]
                         [-f "[fileno=システム統計情報最大ファイル数]
                              [filesz=システム統計情報ファイルサイズ]"]
                         [-b "[blockno=システム統計情報ブロック数]
                              [blocksz=システム統計情報ブロックサイズ]"] ]

機能

トラブルシュート情報のシステム統計情報に関する定義です。

システム統計情報ファイル数やファイルサイズ、メモリマップサイズ等を指定します。

指定数

0〜1

オプション：-u

use

設定値と省略値

Y｜N《Y》

説明

システム統計情報機能を使用するかどうかを指定します。

Y：システム統計情報機能を使用します。

N：システム統計情報機能を使用しません。

interval_time

設定値と省略値

〈符号なし整数〉((1〜3600))《60》（単位：秒）

説明

システム統計情報を取得する時間間隔を秒単位で指定します。

見積もり式への影響

システム統計情報ファイルの容量見積もりに影響します。

オプション：-f

fileno

設定値と省略値

〈符号なし整数〉((3〜100))《3》（単位：ファイル数）

説明

システム統計情報を出力する最大ファイル数を指定します。

ほかのオペランドとの関連

statistical_information定義の-bオプションのフラグメンバblocknoを参照してください。

指定値の目安

fileszフラグメンバとの組み合わせで、保存したいシステム統計情報量にあわせて設定してください。

見積もり式への影響

システム統計情報ファイルの容量およびメモリ使用量の見積もりに影響します。

filesz

設定値と省略値

〈符号なし整数〉((4000〜1000000))《40000》（単位：キロバイト）

説明

システム統計情報を出力するファイルの容量をキロバイト単位で指定します。

Windows版の場合、ファイルサイズは、ブロックサイズやOS情報等を基に最適値を自動計算するため、指定値より若干小さくなる場合があります。

ほかのオペランドとの関連

statistical_information定義の-bオプション、フラグメンバblocknoを参照してください。

指定値の目安

filenoフラグメンバとの組み合わせで、保存したいシステム統計情報量にあわせて設定してください。

見積もり式への影響

システム統計情報ファイルの容量見積もりに影響します。

オプション：-b

blockno

設定値と省略値

〈符号なし整数〉((3〜200))《3》（単位：ブロック数）

説明

システム統計情報ファイルをメモリにマッピングするブロック数を指定します。

ほかのオペランドとの関連

Linux版の場合

↑filesz設定値÷（↓blocksz設定値÷OSのページサイズ↓×OSのページサイズ）↑

×fileno設定値 ≧blockno設定値

Windows版の場合

↑filesz設定値÷（↓blocksz設定値÷OSのメモリ割り当て単位↓×OSのメモリ割り当て単位）↑

×fileno設定値 ≧blockno設定値

利点

statistical_information定義の-bオプションに省略値以外を設定する場合は、-bオプションと-fオプションの指定値が以下の計算式を満たすように設定してください。

↑filesz設定値÷（↓blocksz設定値÷OSのページサイズ↓×OSのページサイズ）↑

×fileno設定値 ≧blockno設定値

指定値の目安

通常は、このフラグメンバを指定する必要はありません。

システム統計情報ファイルを編集した結果、破棄されたシステム統計情報が多い場合にこのオペランドの指定値を以下の計算式を目安に指定値を増やしてください。

このオペランド指定値を増やす数

＝↑システム統計情報破棄数 ×1312÷（blockszオペランド指定値 × 1024）↑

見積もり式への影響

メモリ使用量の見積もりに影響します。

blocksz

設定値と省略値

〈符号なし整数〉((50〜20000))《200》（単位：キロバイト）

説明

システム統計情報ファイルをメモリにマッピングする1ブロックのサイズをキロバイト単位で指定します。

ほかのオペランドとの関連

statistical_information定義の-bオプションのフラグメンバblocknoを参照してください。

利点

ファイルに出力されず破棄されたシステム統計情報が多い場合に、このオペランドの指定値を増やすと破棄されるシステム統計情報の数が減ることがあります。

指定値の目安

通常は、このフラグメンバを指定する必要はありません。

保守員がこのフラグメンバの指定を依頼した場合は、保守員の指示に従ってください。

見積もり式への影響

メモリ使用量の見積もりに影響します。

3.14.4　ファイル出力に関する定義（file_out_control）

形式

[file_out_control [-t "[output_time=ファイル出力ハングアップ監視時間]
                       [open_time=ファイルopenハングアップ監視時間]"]
                  [-q "{type=func|class}"]]

機能

ファイル出力に関する定義です。

ファイル出力時の監視時間等を指定します。

指定数

0〜1

オプション：-t

output_time

設定値と省略値

〈符号なし整数〉((0〜65535))《60》（単位：秒）

説明

ファイル出力する処理のハングアップ監視時間を秒単位で指定します。監視の対象となる処理の時間が、このフラグメンバに指定した時間を越えるとシステムテスト支援は異常終了します。0を指定した場合は、監視しません。

このオペランドによる監視の対象となるのは、以下の処理です。

・TASKTMファイル出力

・システム統計情報ファイル出力

・蓄積ファイル出力

・モジュールトレースファイル出力

指定値の目安

カーネルやドライバがディスクの障害を検出する時間よりも大きい時間を指定することを推奨します。

小さい時間を指定するとドライバが一部のディスクパスの障害を検出してフェールオーバーしている場合などにハングアップを検知してしまい、カーネルやドライバの機能を有効に使えない場合があります。

open_time

設定値と省略値

〈符号なし整数〉((0〜65535))《3000》（単位：秒）

説明

ファイルを作成したり削除する処理のハングアップ監視時間を秒単位指定します。監視の対象となる処理の時間が、このフラグメンバに指定した時間を越えるとシステムテスト支援は異常終了します。0を指定した場合は、監視しません。

このオペランドによる監視の対象となるのは、以下の処理です。

・TASKTMファイル作成／削除

・システム統計情報ファイル作成／削除

・蓄積ファイル作成／削除

・モジュールトレースファイル作成／削除

指定値の目安

通常は、このオペランドを指定する必要はありません。

ディスク障害が発生していない場合にKFSE55313-Eが頻繁に出力される場合は、この定義値を大きくしてください。ファイルを作成したり削除する時間は、ディスクの性能、ファイルサイズ、ファイルのエクステント数、使用しているファイルシステムなどにより大きく異なります。

オプション：-q

type

設定値と省略値

func|class《func》

説明

以下の機能がファイル出力処理を行うスレッド構成を指定します。

1.トラブルシュート機能

・TASKTM

・システム統計情報

2.蓄積機能

・本番用の要求電文蓄積ファイル

・本番用の応答電文蓄積ファイル

・テスト用の要求電文蓄積ファイル

・テスト用の応答電文蓄積ファイル

func：上記1.のファイル出力処理を1スレッド、上記2.のファイル出力処理を1スレッドで行います。

class：上記1.のファイル出力処理を1スレッド、上記2.のファイル出力をファイルの種類毎に1スレッド（計4スレッド）で行います。

利点

複数のディスク装置を用意できる場合は、以下のファイルの出力先をそれぞれ別々のディスク装置とし、本オペランドにclassを指定することでファイル出力処理の実行時間を短縮できる場合があります。

・本番用の要求電文蓄積ファイル

・本番用の応答電文蓄積ファイル

・テスト用の要求電文蓄積ファイル

・テスト用の応答電文蓄積ファイル

ただし、Linux標準のソフトウェアRAID（md）の機能などを使用してRAID0を構築したほうが、ファイル出力処理の実行時間の短縮に効果的な場合があります。

指定値の目安

通常は、このオペランドを指定する必要はありません。

3.15　プロセス関連定義（process_definition）

形式

[process_definition [-s "uoc_stack_size=UOCで使用するスタックサイズ"]]

機能

プロセス制御全般に関する定義です。

指定数

0〜1

オプション：-s

uoc_stack_size

設定値と省略値

<符号無し整数> （0〜65535） 《0》（単位：キロバイト）

説明

UOCを使用する場合に、UOCが必要とするスタックサイズを指定します。

UOCを実行するスレッドのスタックサイズは、製品が必要とするスタックサイズ＋本オペランドの指定値となります。

スタックサイズが不足した場合は、スタックオーバーフローが発生してプロセスダウンします。

以下の条件が全て当てはまる場合はスタックサイズ不足の可能性がある為、本オペランドの指定値を増やしてください。

・esstopコマンドやkillコマンドを実行していないにも関わらず、プロセスダウンしている

・障害検知メッセージ（KFSE65380-E、KFSE65385-E、KFSE65387-E）が出力されていない

3.16　HTTP電文関連定義（http_definition）

形式

[http_definition [-t "[reply_watchtime=タイムアウト時間]
                      [build_message_watchtime= HTTP電文組立待ち時間]"]
                 [-m "[maxcnt =マッピング情報の上限数]
                      [expiredate=マッピング情報の有効期限]"] ]

機能

HTTP電文に関する定義です。

指定数

0〜1

オプション：-t

reply_watchtime

設定値と省略値

〈符号なし整数〉（10〜65535） 《3600》（単位：秒）

説明

HTTP要求電文送信から、HTTP応答電文（既存システムとテスト対象システム）受信までのタイマ監視時間を設定します。

パケットのロスト、又は、HTTP応答電文送信元マシンのスローダウン等により、不要なメモリリソースを消費し、次のHTTP要求電文を転送できなくなることがあります。

指定したタイマ監視時間HTTP応答電文を受信しなかった場合、応答待ち状態を中止しメモリリソースを解放します。

ほかのオペランドとの関連

address_destination定義の-iオプションのwatchtime指定値＞reply_watchtimeとなるように設定してください。address_destination定義の-iオプションのwatchtime指定値≦reply_watchtimeとなるとHTTP応答電文待ち中に無通信時間監視のタイムアウトが発生し、HTTP応答電文が受信できない可能性があります。

利点

メモリリークの防止

指定値の目安

外部システムのWebクライアントでもHTTP応答電文待ちを行っているので、reply_watchtimeは、Webクライアントの応答待ち時間≦reply_watchtimeとなるように設定してください。Webクライアントの応答待ち時間＞reply_watchtimeとなっているとWebクライアントでは正常に応答電文を受信し、HTTPでは応答待ちタイムアウトとなる可能性があります。

build_message_watchtime

設定値と省略値

〈符号なし整数〉（10〜100000） 《3000》（単位：ミリ秒）

説明

HTTP電文組立処理が一定時間進まないデータについて、破棄を行う時間を設定します。

パケットのロスト又は、HTTP電文送信元マシンのスローダウン等により組立に必要なデータが取得できなかった場合に、メモリ上の組立途中の電文が残留してしまわないように指定された時間組立処理が行われなかった電文を破棄します。

ほかのオペランドとの関連

capture_definition -tオプションのretrans_watchtimeフラグメンバより小さな値を指定しないでください。小さな値を指定すると再送パケットをキャプチャした時点で、メモリ上の組立途中の電文がすでに破棄されていることがあります。

利点

メモリリークの防止

指定値の目安

capture_definition -tオプションのretrans_watchtimeフラグメンバの指定値より1000ミリ秒以上加算した値を指定してください。

注意事項

小さすぎる値を設定すると、正常に組立が行われている電文についても破棄してしまうおそれがあります。必要がない場合は、この定義を変更しないようにしてください。

オプション：-m

maxcnt

設定値と省略値

〈符号なし整数〉（0〜2147483647） 《10000》

説明

既存システムとテスト対象システムに対する識別子（セッションID等）のマッピング情報の上限数を指定します。

上限数を指定することでマッピング情報の上限数管理及び、有効期限管理を行うことができます。

上限数を超過した場合、KFSE43321-Wメッセージ出力後、書き換えに使用してから最も時間が経過したマッピング情報を削除します。

なおKFSE43321-Wメッセージを出力するのは初回の上限超過時のみです。

利点

メモリリソースの枯渇を回避できます。

指定値の目安

KFSE43321-Wメッセージが出力された際に、現在の設定値の2倍の値を設定してください。

expiredate

設定値と省略値

〈符号なし整数〉（10〜65535） 《3600》（単位：秒）

説明

マッピング情報の有効期限を指定します。

最後に使用してからexpiredateに指定した時間経過したマッピング情報を削除します。

利点

メモリリソースの枯渇を回避できます。

3.17　製品提供プラグイン関連定義（plugin_definition）

形式

[plugin_definition
 [-u "[library_file_name=プラグイン用UOC共用ライブラリ名]
      [uoc_build=電文組立UOCのエントリポインタ名]
      [uoc_information=電文情報設定UOCのエントリポインタ名]
      [uoc_send= 送信電文編集UOCのエントリポインタ名]
      [uoc_receive= 受信電文編集UOCのエントリポインタ名]
      [uoc_accumulate=蓄積編集UOCのエントリポインタ名]
      [uoc_restore=復元UOCのエントリポインタ名]
      [uoc_judgement=結果判定UOCのエントリポインタ名]
      [uoc_operation=オペレーション名判定UOCのエントリポインタ名]"]
      [uoc_amplify=電文追加UOCのエントリポインタ名]
]

機能

製品提供プラグインに関する定義です。

指定数

0〜1

オプション：-u

library_file_name

設定値と省略値

Linux版の場合：プラグイン用UOC共用ライブラリ名～〈510字以内のパス名〉

Windows版の場合：プラグイン用UOC共用ライブラリ名～〈259字以内のパス名〉

説明

プラグイン用UOC処理を含んだ共用ライブラリ名称を絶対パスで指定します。

ほかのオペランドとの関連

プラグイン用UOCエントリポインタを指定している場合、本定義を必ず指定してください。

uoc_build

設定値と省略値

電文組立UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

電文組立UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_information

設定値と省略値

電文情報設定UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

電文情報設定UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_send

設定値と省略値

送信電文編集UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

送信電文編集UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_receive

設定値と省略値

受信電文編集UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

受信電文編集UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_accumulate

設定値と省略値

蓄積編集UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

蓄積編集UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_restore

設定値と省略値

復元UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

復元UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_judgement

設定値と省略値

結果判定UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

結果判定UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_operation

設定値と省略値

オペレーション名判定UOCエントリポインタ名〈1〜31字以内の識別子〉

説明

オペレーション名判定UOCエントリポインタ名を指定します。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_amplify

設定値と省略値

電文追加UOCエントリポインタ名〈1～31字以内の識別子〉

説明

電文追加UOCエントリポインタ名を指定します。

本UOCはIIOPテスト機能使用時のみ有効です。

前提条件

本オプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

3.18　CSVファイル関連定義（csvfile_definition）

形式

[csvfile_definition
  -t {telegram|result}
　-f "dirpath=CSVファイル格納ディレクトリパス
      [fileno=CSVファイル数]
      [lineno=最大行数]
      [linesz=最大サイズ]"
　[-c "[csv_to_mem=16進数変換対象データ]
     [mem_to_csv=文字変換対象データ]
      "]
  [-r "[read_count=読込み回数]
     [read_interval=再読み込み間隔時間]
      "]
  [-g "[test_id=テスト識別子]
      "]
]

機能

CSVファイルに関する定義です。

指定数

0〜256

オプション：-t

なし

設定値と省略値

telegram|result

説明

フレームワーク用CSVファイルの種別を指定します。

telegram：電文ファイル

result：結果ファイル

前提条件

telegramの指定は、蓄積実行とリプレイ実行時に有効となります。

csvfile_definition（-t telegram）の指定数の最大は255です。蓄積実行の場合、test_idを省略、または起動するシステム効率化支援のテスト識別子を指定したcsvfile_definition（-t telegram）が最低1つ必要です。

蓄積実行の場合、複数のcsvfile_definition（-t telegram）を指定したときは、test_idを省略、または起動するシステム効率化支援のテスト識別子を指定した最初のcsvfile_definitionだけ有効となります。csvfile_definitionのtest_idを省略した場合、起動するシステム効率化支援のテスト識別子を指定したものと判断し、蓄積する電文ファイルとして使用します。

resultの指定は、リプレイ実行時に有効となります。

csvfile_definition（-t result）の指定数の最大は1です。

オプション：-f

dirpath

設定値と省略値

Linux版の場合：～〈980文字以内のパス名〉

Windows版の場合：～〈217文字以内のパス名〉

説明

CSVファイルを作成、または格納されたディレクトリを絶対パスで指定します。

・-tにtelegramを指定した場合

蓄積実行の場合、電文ファイルを作成するディレクトリを指定します。

リプレイ実行の場合、電文ファイルが格納されたディレクトリを指定します。

・-tにresultを指定した場合

リプレイ実行の場合、結果ファイルを作成するディレクトリを指定します。

fileno

設定値と省略値

〈符号なし整数〉((1〜10000))《10000》（単位：ファイル数）

説明

CSVファイルの最大ファイル数を指定します。

見積もり式への影響

CSVファイルの容量見積もりに影響します。

メモリ所要量の見積もりに影響します。

注意事項

出力可能なファイルがなくなったときは、プロセスダウンします。

lineno

設定値と省略値

〈符号なし整数〉((10000〜1000000))《100000》（単位：行数）

説明

CSVファイルに出力する最大行数を指定します。

見積もり式への影響

CSVファイルの容量見積もりに影響します。

linesz

設定値と省略値

〈符号なし整数〉((1〜1048576))《64》（単位：キロバイト）

説明

CSVファイル（電文ファイル）の1行あたりの最大サイズを指定します。本指定値をもとにCSVファイルからデータの読み込みを行います。

指定値の目安

蓄積実行時にCSVファイル（電文ファイル）に出力したデータの最大サイズを指定してください。製品が付加する区切り文字や「"」（ダブルクォーテーション）は考慮する必要はありません。

見積もり式への影響

メモリ所要量の見積もりに影響します。

オプション：-c

csv_to_mem

設定値と省略値

"16進数変換対象データ[-16進数変換対象データ・・・]" 〈1024字以内の文字列〉《0d0a-0a-2c-22》

説明

CSVファイルとの入出力時に、変換対象とする16進数データを指定します。mem_to_csvと組み合わせて定義する必要があります。

CSVファイルから入力する場合、mem_to_csvで指定した文字データをcsv_to_memで指定した16進数のデータに変換してメモリ上に読み込みます。

CSVファイルへ出力する場合、csv_to_memで指定した16進数のデータをmem_to_csvで指定した文字データに変換してファイルに出力します。

*を指定した場合、データの変換は行いません。

変換例を以下に示します。

定義

csv_to_mem=0d0a-0a-2c

mem_to_csv=${N}-${n}-${co}

CSVファイルから入力時、文字データを以下のように変換します。

${N}→0x0d0a

${n}→0x0a

${co}→0x2c

CSVファイルへ出力時、16進数データを以下のように変換します。

0x0d0a→${N}

0x0a→${n}

0x2c→${co}

前提条件

mem_to_csvフラグメントとデータの指定順序を対で指定する必要があります。

注意事項

同じ変換対象データを指定した場合、先に指定したデータを優先して変換します。

mem_to_csv

設定値と省略値

"文字変換対象データ[-文字変換対象データ・・・]" 〈1024字以内の文字列〉《${N}-${n}-${co}-${dq}》

説明

CSVファイルとの入出力時に、変換対象とする文字データを指定します。csv_to_memと組み合わせて定義する必要があります。

変換列については、csv_to_memフラグメントの説明を参照してください。

*を指定した場合、データの変換は行いません。

前提条件

csv_to_memフラグメントとデータの指定順序を対で指定する必要があります。

注意事項

同じ変換対象データを指定した場合、先に指定したデータを優先して変換します。

オプション：-r

read_count

設定値と省略値

〈符号なし整数〉((0～2147483647))《1》

説明

リプレイ実行時、CSVファイルから要求電文/応答電文を読み込む回数を指定します。

1以外の値を指定した場合、すべてのCSVファイルの読み込みが完了したあと、ファイル先頭から再度要求電文/応答電文が読み込まれます。

0を指定した場合、esstopコマンドを発行するまで無制限に再読み込みが繰り返されます。

-tオプションに「telegram」を指定したcsvfile_definitionが1つで、リプレイ実行したときだけ有効です。

利点

負荷テストを容易化できます。

read_interval

設定値と省略値

〈符号なし整数〉((0～86400000))《0》（単位：ミリ秒）

説明

CSVファイルを再読み込みする際に、指定した時間が経過してから再読み込みします。

CSVファイル内のテスト用電文が一巡したあと、次のテストを開始する前に間隔を空けます。

0を指定した場合は間隔を空けずに読み込みます。

-tオプションに「telegram」を指定したcsvfile_definitionが1つで、リプレイ実行したときだけ有効です。

テストを複数回実行する際に、CSVファイルの再読み込み時間の間隔を1000ミリ秒に設定した例を次に示します。

オプション：-g

test_id

設定値と省略値

〈1～31文字の識別子〉《起動するシステム効率化支援のテスト識別子》

説明

入力するCSVファイルのテスト識別子を指定します。

-tオプションに「telegram」を指定したときだけ有効です。

利点

指定したテスト識別子のCSVファイルをリプレイ実行時に入力できます。

3.19　フレームワーク関連定義（framework_definition）

形式

[framework_definition
[-u "[use={Y|N}]
     [serialize={Y|N}]
     [response_chunk_decode={Y|N}]
     [takeover_area_refresh={Y|N}]
     [ipaddr_serialize={Y|N}]
     [production_pairing={Y|N}]
     [testaddr_select={client|telegram}]
     [compression_encoding={gzip|none}]
     [request_force_encoding={gzip|identity|none}]
     [response_force_encoding={gzip|identity|none}]
"]
[-p "[name=プラグイン名]
[library_file_name =プラグイン共用ライブラリ名]
     [startend_entry_point=開始終了プラグインのエントリポインタ名]
     [build_entry_point=電文組立てプラグインのエントリポインタ名]
     [information_entry_point =電文情報プラグインのエントリポインタ名]
     [edit_entry_point=電文編集プラグインのエントリポインタ名]
     [send_entry_point=電文送信プラグインのエントリポインタ名]
     [receive_entry_point=電文受信プラグインのエントリポインタ名]
     [judge_entry_point=結果判定プラグインのエントリポインタ名]
     [select_entry_point=電文選択プラグインのエントリポインタ名]
     [amplify_entry_point=電文増幅プラグインのエントリポインタ名]
     [batch_entry_point=バッチ用プラグインのエントリポインタ名]
"]
[-t "[reply_watchtime=応答待ち時間]
     [build_message_watchtime=後続パケット待ち時間]
     [plugin_hungup_time=プラグインのハングアップ監視時間]
     [request_watchtime=応答待ち時間]
"]
[-b "[max_message_size=最大メッセージサイズ]
     [telegram_area_size=電文単位の引継ぎ領域サイズ]
     [connection_area_size =コネクション単位の引継ぎ領域サイズ]
     [client_area_size =クライアント識別子単位の引継ぎ領域サイズ]
"]
[-f "[telegram_file_type={afl|csv}]
     [result_file_type={afl|csv}]
     [user_file=シナリオファイル]
     [result_output={0|1|2}]
"]
[-a "[execution_count=シナリオ実行回数]
     [parallel_count=シナリオ同時実行数]
     [test_execution_count=電文の実行数]
     [test_execution_delay_time=クライアント増幅時の遅延時間]
"]
[-m "[maxcnt=マッピング情報の上限数]
     [expiredate=マッピング情報の有効期限]
     [client={Y|N}]
     [url_rewriting=応答電文のボディ部内のパラメタ名][,応答電文のボディ部内のパラメタ名…]
     [hidden_form=応答電文のボディ部内のhiddenフォーム名称][,応答電文のボディ部内のhiddenフォーム名称…]
     [session_position={url|body|head}][-{url|body|head}[-{url|body|head}]]]
     [sessionid_name=応答電文の引き継ぎ元パラメタ名:応答電文のセッションIDのパラメタ名][,応答電文の引き継ぎ元パラメタ名：要求電文の引き継ぎ先パラメタ名…]
"]
]

機能

フレームワーク機能に関する定義です。

指定数

0〜1

オプション：-u

use

設定値と省略値

Y｜N《N》

説明

フレームワーク機能を使用するかどうかを指定します。

Y：フレームワーク機能を使用します。

N：フレームワーク機能を使用しません。

serialize

設定値と省略値

Y｜N《Y》

説明

本番環境の要求電文と応答電文のペアリングを行う場合（電文判定プラグイン指示）に、複数コネクションの要求電文をキャプチャ時刻順にシリアライズして処理するかどうかを指定します。

Y：シリアライズします。キャプチャ順に処理します。

N：シリアライズしません。ペアリング成立順に処理します。

指定値の目安

複数コネクションを使用して業務を行っている場合、コネクション間で要求電文が逆転すると、シーケンス不正等でテストが失敗する可能性があります。このような場合はこのフラグメンバにYを指定してください。コネクション間で因果関係が無い場合は、Nを指定してください。

response_chunk_decode

設定値と省略値

Y｜N《N》

説明

チャンク形式のHTTP応答電文を自動的にデコードします。

［デコード前（チャンク形式）］

0a（チャンクサイズ10バイト）

aaaaaaaaaa

14（チャンクサイズ20バイト）

bbbbbbbbbbcccccccccc

0（チャンクサイズ0バイト）

［デコード後］

aaaaaaaaaabbbbbbbbbbcccccccccc

利点

HTTP応答電文の解析の際にチャンクデコード処理が不要となるため、解析が容易となります。

注意事項

チャンクデコード処理によって、応答電文サイズに応じてスループットが若干低下します。チャンクデコード処理が不要な場合はNを指定してください。

takeover_area_refresh

設定値と省略値

Y｜N《N》

説明

引継ぎ領域の再利用時に、HSICが自動的に引継ぎ領域を初期化するかどうかを指定します。

Y：初期化する。

再利用時は引継ぎ領域全体をNULLクリアします。引継ぎ領域のステータスはESFRW_CONTST_NEW（新規割当て）となります。

N：初期化しない。

再利用時は引継ぎ領域に以前の内容が残ります。引継ぎ領域のステータスはESFRW_CONTST_RENEW（再割当て）となります。

ほかのオペランドとの関連

telegram_area_size、connection_area_size、およびclient_area_sizeフラグメンバに0を指定している場合、このフラグメンバの指定値は無視します。

利点

プラグイン内での引継ぎ領域の管理が容易になります。

指定値の目安

引継ぎ領域上で確保メモリのポインタ等を管理している場合、このフラグメンバにYを指定して引継ぎ領域をNULLクリアすると、メモリが解放できなくなる可能性があります。このような場合は、このフラグメンバにNを指定し、ステータスがESFRW_CONTST_RENEW時にプラグイン内でメモリ解放等を行ってください。ポインタ等を管理しておらず、引継ぎ領域をNULLクリアされて問題無い場合は、このフラグメンバにYを指定することにより、引継ぎ領域の管理が容易になります。

ipaddr_serialize

設定値と省略値

Y｜N《N》

説明

クライアント識別子（電文のシリアライズ単位）のデフォルトを、外部システムのIPアドレス単位にするかどうかを指定します。

Y：クライアント識別子を外部システムのIPアドレス単位にする。

N：クライアント識別子を各プロトコル固有の単位（コネクション単位等）にする。

利点

外部システムのクライアントが、複数コネクションにわたって業務をするような場合に、外部システムのIPアドレス単位でシリアライズすることで、実際の業務と同じ順番で電文を処理することができます。

production_pairing

設定値と省略値

Y｜N《N》

説明

既存システムからの応答電文を必要とするかどうかを設定します。

Y：既存システムからの応答電文を必要とします。次の場合はYを指定してください。

応答電文の比較を行いたいとき

本番環境の応答電文を蓄積したいとき

N：本番環境の応答電文を必要としません。次の場合はNを指定してください。

PCAP実行時、入力pcapファイルに応答電文が存在しないとき

応答電文の比較が必要ないとき

testaddr_select

設定値と省略値

client|telegram《client》

説明

要求電文送信先の選択方法を指定します。

client：クライアント識別子単位にテスト対象システムを選択する。

telegram：要求電文を送信するたびにテスト対象システムを選択する。

このフラグメンバにclientを指定した場合は、クライアント識別子の初回の要求電文送信時にテスト対象システムをラウンドロビン選択し、それ以降の同じクライアント識別子の要求電文は同じテスト対象システムへ送信します。

このフラグメンバにtelegramを指定した場合は、要求電文を送信するたびに、テスト対象システムをラウンドロビンで選択します。なお、この方式の場合、HSICとテスト対象システム間のコネクション数が増加します。プロトコルがRPCの場合だけtelegramを指定できます。RPC以外のプロトコルでtelegramを指定した場合は、clientの動作となります。

前提条件

address_destination定義の-tオプションで、複数のテスト対象システムを指定している場合に、このオペランドを指定します。

利点

テスト対象システム側が負荷分散構成等で複数存在する場合に、同一クライアント識別子の要求電文を各テスト対象システムへ分散できます。

compression_encoding

設定値と省略値

gzip|none《none》

説明

圧縮されたHTTP電文の解凍、およびテスト対象システムへの送信時に再圧縮する機能を使用するかどうかを指定します。

gzip：機能を使用します。

none：機能を使用しません。

前提条件

HTTP電文の解凍、およびgzip形式での圧縮にはzlibライブラリを使用します。HSIC実行マシン上にzlibライブラリ　バージョン1.2.3以降がインストールされている必要があります。

Windowsの場合：環境変数PATHに、zlibライブラリインストールディレクトリを指定してください。

Linuxの場合：環境変数LD_LIBRARY_PATHに、zlibライブラリを格納しているパスを指定してください。

インストールされていない場合、HSICの起動が失敗します。

ほかのオペランドとの関連

framework_definition定義の-bオプションのフラグメンバmax_message_sizeの指定値は、テストに使用する電文の非圧縮時のデータの中で、最もメッセージサイズの大きい電文のメッセージサイズを上回る値を設定してください。

利点

電文ファイルおよび結果ファイルに解凍されたデータが格納されます。

注意事項

圧縮されたHTTP電文の解凍、および圧縮処理によって、スループットが若干低下します。不要な場合はnoneを指定してください。

request_force_encoding

設定値と省略値

gzip|identity|none《none》

説明

テスト対象システムに送信するHTTP要求電文を強制的にすべて指定した形式で圧縮するか、強制的にすべて非圧縮にするか、本番環境と同じ形式にするかを指定します。

gzip：要求電文を強制的にgzip形式で圧縮します。

identity：要求電文を強制的に非圧縮にします。

none：本番環境と同じ形式で送信します。

前提条件

このフラグメンバにnone以外を指定する場合は、compression_encodingフラグメンバにnone以外を指定する必要があります。compression_encodingフラグメンバにnoneを指定した場合は、このフラグメンバの指定値は無視されます。

利点

ネットワークの負荷や、webサーバの負荷を変更できます。

注意事項

指定した圧縮形式に対応していないサーバに対してこの機能を使用すると、サーバはエラー応答します。

response_force_encoding

設定値と省略値

gzip|identity|none《none》

説明

テスト対象システムから受信する応答電文を、強制的にすべて指定した形式で圧縮するように要求するか、強制的にすべて非圧縮で送るように要求するか、本番環境と同じ形式にするかを指定します。

gzip：応答電文をgzip形式で圧縮するようテスト対象システムに要求します。

identity：応答電文を非圧縮にするようテスト対象システムに要求します。

none：本番環境と同じ形式で要求します。

前提条件

このフラグメンバにnone以外を指定する場合は、compression_encodingフラグメンバにnone以外を指定する必要があります。compression_encodingフラグメンバにnoneを指定した場合は、このフラグメンバの指定値は無視されます。

利点

ネットワークの負荷や、webサーバの負荷を変更できます。

注意事項

指定した圧縮形式に対応していないサーバに対してこの機能を使用すると、サーバはエラー応答します。

オプション：-p

name

設定値と省略値

プラグイン名〈1〜31字以内の識別子〉《*》

説明

プラグイン名を指定します。プラグイン名は、KFSE84001-Iメッセージのプラグイン名称として表示します。

利点

使用したプラグインの特定が容易となります。

library_file_name

設定値と省略値

Linux版の場合：プラグイン共用ライブラリ名 ～〈510字以内のパス名〉

Windows版の場合：プラグイン共用ライブラリ名 ～〈259字以内のパス名〉

説明

プラグイン処理を含んだ共用ライブラリ名称を絶対パスで指定します。

ほかのオペランドとの関連

プラグイン用エントリポインタを指定している場合、この定義を必ず指定してください。

startend_entry_point

設定値と省略値

開始終了プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

開始終了プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

build_entry_point

設定値と省略値

電文組立てプラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文組立てプラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

ほかのオペランドとの関連

address_destinationの-pオプションでTCPを指定した場合、このプラグインによる電文組立てが必要です。このプラグインを指定しない場合、1パケットを1電文として処理します。-pでTCP以外を指定した場合、このプラグインは実行されません。

information_entry_point

設定値と省略値

電文情報プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文情報プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

edit_entry_point

設定値と省略値

電文編集プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文編集プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

send_entry_point

設定値と省略値

電文送信プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文送信プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

receive_entry_point

設定値と省略値

電文受信プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文受信プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

judge_entry_point

設定値と省略値

結果判定プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

結果判定プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

select_entry_point

設定値と省略値

電文選択プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文選択プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

amplify_entry_point

設定値と省略値

電文増幅プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

電文増幅プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

batch_entry_point

設定値と省略値

バッチ用プラグインエントリポインタ名〈1〜31字以内の識別子〉

説明

バッチ用プラグインエントリポインタ名を指定します。

前提条件

このオプションにはlibrary_file_nameフラグメンバで指定するライブラリ中に存在するエントリポインタ名を指定します。

ほかのオペランドとの関連

バッチ実行フェーズで実行する場合、次の定義が固定値となります。

client_definitionオペランド

-p thread_create_rate=1

-p max_thread=1000

-q schedule_type=parallel

また、次の定義が省略可能となります。

address_destinationオペランド

オプション：-t

reply_watchtime

設定値と省略値

〈符号なし整数〉（0〜65535）《3600》（単位：秒）

説明

本番環境の電文の場合は、同期応答型の要求電文のキャプチャから、応答電文のキャプチャまでのタイマ監視時間を指定します。

テスト環境の電文の場合は、テスト対象システムへの同期応答型の要求電文の送信から、応答電文受信までのタイマ監視時間を指定します。

0を指定した場合は無限待ちとなります。

ほかのオペランドとの関連

同一コネクションで要求電文と応答電文を送受信する場合、address_destination定義の-iオプションのwatchtime指定値＞reply_watchtimeとなるように設定してください。address_destination定義の-iオプションのwatchtime指定値≦reply_watchtimeとなると、応答電文待ち中に無通信時間監視のタイムアウトが発生し、応答電文が受信できない可能性があります。

利点

タイマ監視時間を設定することでメモリ使用量を抑えることができます。

指定値の目安

外部システム（Webクライアント等）で応答電文待ちを時間監視している場合、reply_watchtimeは、外部システムの応答待ち時間≦reply_watchtimeとなるように設定してください。外部システムの応答待ち時間＞reply_watchtimeとなっていると、外部システムでは正常に応答電文を受信しても、フレームワークでは応答待ちタイムアウトとなる可能性があります。

build_message_watchtime

設定値と省略値

〈符号なし整数〉（10〜100000） 《3000》（単位：ミリ秒）

説明

電文組立て時の、後続パケットをキャプチャ又は受信するまでのタイマ監視時間を指定します。

ほかのオペランドとの関連

capture_definition -tオプションのretrans_watchtimeフラグメンバより小さな値を指定しないでください。小さな値を指定すると、再送パケットをキャプチャした時点で、メモリ上の組立途中の電文がすでに破棄されていることがあります。

利点

タイマ監視時間を設定することでメモリ使用量を抑えることができます。

指定値の目安

capture_definition -tオプションのretrans_watchtimeフラグメンバの指定値より1000ミリ秒以上加算した値を指定してください。

注意事項

小さすぎる値を設定すると、正常に組立が行われている電文についても破棄してしまうおそれがあります。必要がない場合は、この定義を変更しないようにしてください。

plugin_hungup_time

設定値と省略値

〈符号なし整数〉（0〜65535） 《60》（単位：秒）

説明

プラグイン実行処理のハングアップ監視時間を指定します。プラグイン内部の無限待ちや無限ループによるハングアップを検知できます。

0を指定した場合、プラグイン実行処理のハングアップ監視を行いません。

request_watchtime

設定値と省略値

〈符号なし整数〉（0～65535） 《自動計算》（単位：秒）

説明

アウトバウンドの本番環境の要求電文のキャプチャから、テスト環境の要求電文を受信するまでのタイマ監視時間を指定します。指定した時間が待ち時間となります。

省略した場合、本番環境の要求電文と、その直前の要求／応答電文との経過秒数＋5秒が、要求電文の待ち時間となります。

65535秒を超過する場合、待ち時間は65535秒となります。

0を指定した場合、無限待ちとなります。

オプション：-b

max_message_size

設定値と省略値

〈符号なし整数〉((1〜1048576))《64》（単位：キロバイト）

説明

最大メッセージサイズを指定します。

このサイズを超過するメッセージをキャプチャ又は受信した場合、メッセージを破棄します。また、電文編集プラグイン及び電文送信プラグインに渡す編集領域は、このサイズとなります。

ほかのオペランドとの関連

telegram_file_typeフラグメンバにcsvを指定したときにこの指定値を変更する場合、csvfile_definition -tオプションでtelegramを指定したときの-fオプションのlineszフラグメンバの指定値もあわせて変更してください。

見積もり式への影響

CSVファイルの容量見積もりに影響します。

メモリ使用量の見積もりに影響します。

telegram_area_size

設定値と省略値

〈符号なし整数〉((0〜65535))《8》（単位：キロバイト）

説明

電文単位の引継ぎ領域サイズを指定します。

0を指定した場合、引継ぎ領域は使用できません。

見積もり式への影響

メモリ使用量の見積もりに影響します。

connection_area_size

設定値と省略値

〈符号なし整数〉((0〜65535))《8》（単位：キロバイト）

説明

コネクション単位の引継ぎ領域サイズを指定します。

0を指定した場合、引継ぎ領域は使用できません。

見積もり式への影響

メモリ使用量の見積もりに影響します。

client_area_size

設定値と省略値

〈符号なし整数〉((0〜65535))《8》（単位：キロバイト）

説明

クライアント識別子単位の引継ぎ領域サイズを指定します。

0を指定した場合、引継ぎ領域は使用できません。

見積もり式への影響

メモリ使用量の見積もりに影響します。

オプション：-f

telegram_file_type

設定値と省略値

afl|csv《afl》

説明

電文ファイルの種別を指定します。

afl：蓄積ファイル

csv：csvファイル

前提条件

address_destination定義の-pオプションが「http」の場合のみ、このフラグメンバに「csv」を指定できます。address_destination定義の-pオプションが「http」以外の場合に「csv」を指定すると、起動時にエラーとなります。

result_file_type

設定値と省略値

afl|csv《afl》

説明

結果ファイルの種別を指定します。

afl：蓄積ファイル

csv：csvファイル

前提条件

address_destination定義の-pオプションが「http」の場合のみ、このフラグメンバに「csv」を指定できます。address_destination定義の-pオプションが「http」以外の場合に「csv」を指定すると、起動時にエラーとなります。

user_file

設定値と省略値

シナリオファイル名 ～〈1024字以内のパス名〉

説明

プラグインで使用するシナリオファイルを絶対パスで指定します。

プロセス開始時の開始終了プラグインで、このフラグメンバに指定されたパス名を取得できます。

次のプラグインでは、対応するシナリオファイルをこのフラグメンバに指定してください。

東証テストプラグイン

東証テスト機能用シナリオファイルを指定します。

result_output

設定値と省略値

0|1|2《0》

説明

結果ファイルに出力するHTTP電文の内容を指定します。

0：HTTP電文のHTTPヘッダ、HTTPボディを結果ファイルに出力します。

1：HTTP電文のHTTPヘッダだけを結果ファイルに出力します。HTTPボディは出力しません。

2：HTTP電文のHTTPヘッダ、HTTPボディをどちらも結果ファイルに出力しません。

利点

結果ファイルに出力したい電文の内容に応じてこのフラグメンバの値を指定することで、使用するディスク容量を削減できます。

指定値の目安

結果ファイルに出力したい電文の内容に応じて指定してください。

オプション：-a

execution_count

設定値と省略値

～〈符号なし整数〉((0～2147483647))《1》

説明

バッチ実行フェーズでのクライアント識別子単位のテストシナリオ実行回数を指定します。

このフラグメンバに0を指定した場合は、無限に繰り返し実行します。

プロセス開始時の開始終了プラグインで、このフラグメンバに指定された値を取得できます。

前提条件

バッチ実行フェーズの場合のみ参照します。

parallel_count

設定値と省略値

～〈符号なし整数〉((1～1000))《1》

説明

バッチ実行フェーズでのテスト同時実行クライアント識別子シナリオ同時実行数を指定します。

バッチ用プラグインの呼出は、このフラグメンバに指定した数だけ並行して実行します。

プロセス開始時の開始終了プラグインで、このフラグメンバに指定された値を取得できます。

前提条件

バッチ実行フェーズの場合のみ参照します。

test_execution_count

設定値と省略値

～〈符号なし整数〉((1～20000))《1》

説明

テスト実行フェーズにおいて、本番環境の要求電文の実行数（増幅回数）を指定します。

2以上を指定した場合、キャプチャした要求電文をクライアント増幅し、別クライアントの要求電文として処理します。

前提条件

テスト実行フェーズ以外、および電文増幅プラグインが指定されている場合は、このフラグメンバを無視します。

利点

負荷テストを容易化できます。

指定値の目安

複数クライアントから同時に実行するテストを実施したい場合に、2以上の値を指定してください。

test_execution_delay_time

設定値と省略値

～〈符号なし整数〉((1～3600000))《0》（単位：ミリ秒）

説明

クライアント増幅による送信開始を遅延させる時間を設定します。

前提条件

test_execution_countフラグメンバに1以外を指定していること。

利点

負荷テストを容易化できます。

指定値の目安

複数クライアントから一定の時間差で実行するテストを実施したい場合に使用します。

オプション：-m

maxcnt

設定値と省略値

～〈符号なし整数〉(0～2147483647) 《10000》

説明

既存システムとテスト対象システムに対する識別子（HTTPクッキー）のマッピング情報の上限数を指定します。上限数を指定することでマッピング情報の上限数管理、及び、有効期限管理を行うことができます。上限数を超過した場合、KFSE44002-Wメッセージ出力後、書き換えに使用してから最も時間が経過したマッピング情報を削除します。なおKFSE44002-Wメッセージを出力するのは、初回の上限超過時のみです。

0を指定した場合は、識別子の書き換えは行いません。

利点

メモリリソースの枯渇を回避できます。

指定値の目安

KFSE43321-Wメッセージが出力された際に、現在の設定値の2倍の値を設定してください。

expiredate

設定値と省略値

～〈符号なし整数〉(10～65535) 《3600》（単位:秒）

説明

マッピング情報の有効期限を指定します。

最後に使用してからexpiredateに指定した時間経過したマッピング情報を削除します。

前提条件

バッチ実行フェーズの場合のみ参照します。

利点

メモリリソースの枯渇を回避できます。

client

設定値と省略値

Y｜N《Y》

説明

クライアント単位にセッション管理を行うかを指定します。

Y：セッション管理をクライアント単位に行います。

N：セッション管理をクライアント単位に行いません。この場合、サーバ単位にセッション管理が行われます。

url_rewriting

設定値と省略値

応答電文のボディ部内のパラメタ名[,応答電文のボディ部内のパラメタ名…]～〈パラメタ名は英数字または、-、.、_、~から成る文字列、かつ、設定値全体で10000バイト以内〉

説明

応答電文ボディ部のセッションIDを、以降の要求電文に引き継ぐかを指定します。引き継ぐ場合、このフラグメンバでパラメタ名を指定します。複数のパラメタ名を指定する場合は、カンマ区切りで指定します。引き継ぎ先は、フラグメンバsession_positionで指定します。要求電文に引き継ぐセッションIDを変更する場合、フラグメンバsessionid_nameで要求電文の引き継ぎ先パラメタ名を指定します。

「url_rewriting=jsessionid」を指定した場合を次に示します。

応答電文（ボディ部）：action "/AAA;jsessionid=22222"

「session_position=url」のとき

要求電文（ヘッダ部）：POST /AAA;jsessionid=22222

「session_position=body」のとき

要求電文（ボディ部）：aaa=111&bbb=222&jsessionid =22222

「session_position=head」のとき

要求電文（ヘッダ部）：Referer: http://aaa.co.jp/bbb.jsp?aaa=111&jsessionid=22222

ほかのオペランドとの関連

セッションIDの引き継ぎ位置の選択は、フラグメンバsession_positionを使用します。

要求電文に引き継ぐセッションIDを変更する場合、フラグメンバsessionid_nameで要求電文の引き継ぎ先パラメタ名を指定します。

hidden_form

設定値と省略値

応答電文のボディ部内のhiddenフォーム名称[,応答電文のボディ部内のhiddenフォーム名称…]～〈hiddenフォーム名称は英数字または、-、.、_、~から成る文字列、かつ、設定値全体で10000バイト以内〉

説明

応答電文のボディ部内のhiddenフォーム名称を、以降の要求電文に引き継ぐかを指定します。引き継ぐ場合、このフラグメンバでhiddenフォーム名称を指定します。複数のhiddenフォーム名称を指定する場合は、カンマ区切りで指定します。引き継ぎ先は、フラグメンバsession_positionで指定します。要求電文に引き継ぐセッションIDのパラメタ名を変更する場合、フラグメンバsessionid_nameで要求電文の引き継ぎ先パラメタ名を設定します。

「hidden_form=p」を指定した場合を次に示します。

応答電文（ボディ部）：<INPUT type="hidden" name="p" value="444"></INPUT>

「session_position=url」のとき

要求電文（ヘッダ部）：POST /AAA;p=444

「session_position=body」のとき

要求電文（ボディ部）：aaa=111&bbb=222&p=444

「session_position=head」のとき

要求電文（ヘッダ部）：Referer: http://aaa.co.jp/bbb.jsp?ccc=111&p=444

ほかのオペランドとの関連

セッションIDの引き継ぎ位置の選択は、フラグメンバsession_positionを使用します。

要求電文に引き継ぐセッションIDのパラメタ名を変更する場合、フラグメンバsessionid_nameで要求電文の引き継ぎ先パラメタ名を指定します。

session_position

設定値と省略値

{url|body|head}[-{url|body|head}[-{url|body|head}]] 《url》

説明

セッションIDを付与する位置を指定します。付与する位置を複数指定する場合は、ハイフン(“-”)区切りで指定します。指定しない場合、URL部分にセッションIDを付与します。

url：URL部分にセッションIDを付与します。

body：ボディ部にセッションIDを付与します。

head：ヘッダ部にセッションIDを付与します。

ほかのオペランドとの関連

このオプションを使用する場合、フラグメンバurl_rewriting またはhidden_formでセッションIDを引き継ぐかを指定します。また、要求電文に引き継ぐセッションIDのパラメタ名を変更する場合、フラグメンバsessionid_nameで要求電文に引き継ぐ応答電文のセッションIDのパラメタ名を指定します。

sessionid_name

設定値と省略値

応答電文の引き継ぎ元パラメタ名：要求電文の引き継ぎ先パラメタ名[,応答電文の引き継ぎ元パラメタ名：要求電文の引き継ぎ先パラメタ名…]〈パラメタ名は英数字または、-、.、_、~から成る文字列、かつ、設定値全体で20000バイト以内〉《同名のパラメタに値を引き継ぐ》

説明

url_rewritingやhidden_formで引き継ぐパラメタ名が、応答電文と要求電文で異なる場合に使用します。応答電文の引き継ぎ元となるセッションIDのパラメタ名と、要求電文に引き継ぐ情報として使用する、応答電文のセッションIDのパラメタ名の組み合わせを指定します。引き継ぎ元のパラメタ名には、url_rewritingまたはhidden_formで指定したパラメタ名を指定します。省略した場合、応答電文のセッションIDのパラメタ名がそのまま引き継がれます。

（例）

応答電文hiddenフォームのパラメタ「xxx」を、要求電文のパラメタ「yyy」へ引き継ぐ場合。

応答電文（ボディ部）：<INPUT type="hidden" name="xxx" value="333"></INPUT>

要求電文（ボディ部）：aaa=111&bbb=222&yyy=333

定義設定値：hidden_form=xxx、sessionid_name=xxx:yyy

次のように、応答電文と要求電文で引き継ぐパラメタ名が同じ「xxx」の場合は、このフラグメンバは設定不要です。

応答電文（ボディ部）：<INPUT type="hidden" name="xxx" value="333"></INPUT>

要求電文（ボディ部）：aaa=111&bbb=222&xxx=333

定義設定値：hidden_form=xxx

ほかのオペランドとの関連

このオプションを使用する場合、フラグメンバurl_rewriting またはhidden_formでセッションIDを引き継ぐかを指定します。また、フラグメンバsession_positionでセッションIDの引き継ぎ先を指定します。

3.20　IIOPテスト関連定義（iiop_definition）

形式

[iiop_definition
  [-c "[serial_type={connection|client}]
"]]

機能

IIOPテスト機能に関する定義です。

指定数

0～1

オプション：-c

serial_type

設定値と省略値

connection | client 《connection》

説明

シリアライズ機能によりテスト対象システムへの要求電文の送信からテスト結果判定までの一連の処理について、シリアライズする単位を指定します。

connection ：本番環境におけるクライアントとサーバ間のコネクション単位にシリアライズします。

client ：本番環境におけるクライアントのIPアドレス単位にシリアライズします。

利点

テスト内容をカスタマイズすることが出来ます。

3.21　システム関連定義（lightmode_definition）

形式

[lightmode_definition
-u "use={Y|N}"
]

機能

リソース削減モードを使用するかどうかを指定する定義です。

リソース削減モードを使用すると、HSIC稼働マシンへの負荷を低減できます。

指定数

0～1

オプション：-u

use

設定値と省略値

Y | N 《N》

説明

リソース削減モードを使用するかどうかを指定します。

Y ：リソース削減モードを使用します。

N ：リソース削減モードを使用しません。

ほかのオペランドとの関連

-u “use=Y”の場合、次の定義が固定値となります。

statistical_informationオペランド

-u use=N

利点

HSICで消費するリソースを削減し、HSIC稼働マシンへの負荷を低減できます。

見積もり式への影響

メモリ使用量の見積もりに影響します。この定義にYを指定した場合はメモリ使用量が減少します。

注意事項

エージェント機能を使用するHSICでだけ、リソース削減モードを使用してください。リソース削減モードを使用する場合はトラブルシュート情報を取得しません。そのため、HSICで障害が発生した際のトラブルシュートが困難になります。

3.22　定義生成Excelの項目の説明

3.22.1　基本情報シートの表示項目

基本情報シートに表示される項目について説明します。

操作一覧パネル

ボタン操作により、ファイル操作や、定義項目を追加するためのパネルです。

図3‒6　操作一覧パネル

表3‒6　操作一覧パネル説明

図中番号

ボタン名称

ボタン説明

1.

定義ファイル入力

既にある定義ファイルの情報を定義生成Excelで編集したい場合に操作します。

ボタンを押下すると、ファイル選択画面が表示されるので、入力したいファイルを選択します。

ファイルは以下のファイルを選択してください。

定義生成Excelで出力した定義ファイル

テキストエディタを使用して作成した定義ファイル

選択したファイルの定義情報を、定義生成Excelの基本情報シート、カスタム情報シートに展開します。

<注意事項>

定義生成Excelに入力途中であった情報は破棄します。

2.

定義ファイル出力

定義生成Excel上の定義情報を定義ファイルに出力したい場合に操作します。

ボタンを押下すると、ファイル選択画面が表示されます。出力したいフォルダに遷移し、出力するファイル名を入力します。

入力したファイルへ定義生成Excelの基本情報シート、カスタム情報シートの情報を、定義形式に変換し出力します。

<注意事項>

出力するファイル名は、テストで使用するテスト識別子と同じ名称にしてください。

3.

定義項目追加

定義生成Excel上にプロトコルを追加したい場合に操作します。

追加したいプロトコルを押下すると、プロトコルに応じて必須の定義入力欄を追加します。

4.

対象No削除

特定の定義Noの行を一括して削除したい場合に削除します。

既存システム上の削除したいNoのセルを選択した状態で、本ボタンを押下してください。選択したNoと同Noの全定義を、外部システム、既存システム、テスト対象システム、システム検証支援基盤から削除します。

定義エリア

定義情報を入力するエリアです。

「既存システム」の定義エリア

ボタン操作及び、セル入力により既存システムの定義情報を設定するエリアです。

本エリアでは、以下の場合に別途定義欄を追加してください。

・既存システムのIPアドレスを追加したい場合

図3‒7　既存システム

「外部システム」の定義エリア

ボタン操作及び、セル入力により外部システムの定義情報を設定するエリアです。

本エリアは、特定クライアントからの電文のみキャプチャしたい場合に設定します（それ以外の場合、本エリアを操作する必要はありません）。

図3‒8　外部システム

「テスト対象システム」の定義エリア

ボタン操作及び、セル入力によりテスト対象システムの定義情報を設定するエリアです。

本エリアでは、以下の場合に別途定義欄を追加してください。

・キャプチャした電文の送信先（テスト対象システム）を複数指定したい場合

図3‒9　テスト対象システム

「システム検証支援基盤」の定義エリア

ボタン操作及び、セル入力によりシステム検証支援基盤の定義情報を設定するエリアです。

本エリアでは、以下の場合に別途定義欄を追加してください。

・定義No単位にシステム検証支援基盤の情報を設定したい場合

図3‒10　システム検証基盤

ボタン／入力欄説明

各定義エリアのボタン／入力欄の説明を以下に示します。

表3‒7　ボタン／入力欄説明

図中番号

ボタン/入力欄名称

説明

1.

追加

「既存システムエリア」に表示されている定義Noに対応する定義の行を増やしたい場合に操作します。

操作一覧パネルの定義項目追加ボタンでプロトコルを追加後に、本ボタンを押下してください。末尾に新たな定義用の行を追加します。

2.

削除

「1.追加」で追加した定義を削除したい場合に操作します（それ以外の場合、本ボタンを操作する必要はありません）。

当該システム上の削除したいNoを選択した状態で、本ボタンを押下してください。選択した行を削除します。

<注意事項>

既存システムで同No残り1つの定義の場合、削除できません。

3.

No

外部システム、既存システム、テスト対象システム、システム検証支援基盤の定義を対応付けるためのNo（定義No）です。「操作一覧パネル」の「3.定義項目追加」により行を追加した場合、自動的に割り当てられます。

「1.追加」で行を追加した場合は、ドロップダウンリストより任意のNoを選択してください。

4.

プロトコル

Noに応じたプロトコルが設定されます（「操作一覧パネル」の「3.定義項目追加」で選択したプロトコル）。本項目はNo変更時に自動で設定されます。

本入力欄は操作しません。

5.

定義値入力欄

定義値を入力します。

<注意事項>

セルの斜め罫線が表示された定義は選択したプロトコルでは入力できないので、入力しないで下さい。

3.22.2　カスタム情報シートの表示項目

カスタム情報シートに表示される項目について説明します。

図3‒11　カスタム情報シートに表示される項目

表3‒8　カスタム情報シートのボタン／入力欄説明

図中番号

ボタン/入力欄名称

ボタン/入力欄説明

1.

指定値

定義の指定値を設定します。

説明欄の内容を参照しながら入力します。

2.

追加

複数指定可能な定義の指定欄を追加したい場合に操作します。

本ボタンを押下すると、ブロック末尾に指定欄が追加されます（上図で本ボタンを押下すると、定義Noが3の欄が追加されます）。

<注意事項>

指定欄は最大指定数の数値まで追加できます。

3.

削除

複数指定可能な定義の指定欄を削除したい場合に操作します。

当該定義の削除したい定義Noを選択した状態で、本ボタンを押下してください。選択した定義Noの欄が削除されます。ただし定義Noが1の欄は削除できません。

3.22.3　定義生成Excelの操作時の注意事項

Excel画面上で、上記まで説明した操作以外を行わないで下さい。行った場合の定義生成Excelの動作は保証しません。

例

行または列の追加、削除

セルへ名前をつける、または名前のついているセルの名前変更

セルのプロパティ変更

シート名の変更

4　システムテスト支援の運用コマンド

システムテスト支援の運用コマンドについて説明します。

4.1　コマンドの記述形式

運用コマンドの記述形式を以下に示します。

コマンド名　オプション　コマンド引数

コマンド名

コマンド名は、実行する運用コマンドのファイル名です。

オプション

コマンドオプションの指定方法を以下に示します。なお、以下の説明分中の「$」はシェルプロンプトを、「cmd」はコマンド名称をそれぞれ示します。

オプションの指定方法

オプションは「-」（半角のマイナス記号）で始まる文字列です。オプションは、コマンド引数より前に指定する必要があります。なお、オプションの指定順序は問いません。

2つのマイナス記号「--」はオプションの終わりを示します。なお、マイナス記号だけのオプションは入力不可能です。

オプションの記述形式を以下に示します。

$cmd -オプションフラグ

（凡例）オプションフラグ：1文字の英数字（英字の大文字小文字は区別する）。

オプションの記述例を以下に示します。

（記述例1）

$cmd -a -b –c

（記述例2）

以下の入力では、「-b」をコマンド引数と見なします。

$cmd -a -- -b

（記述例3）

以下の入力では、「-」をオプションではなくコマンド引数と見なします。

$cmd -

フラグ引数

オプションには、1つのフラグ引数を持つものと、フラグ引数を持たないものが存在します。

フラグ引数を持たないオプションの指定方法

フラグ引数を持たないオプションは、一つのマイナス記号の後に纏めて指定可能です。

また、フラグ引数を持たないオプションフラグにフラグ引数を記述した場合、当該オプション以降の指定値をコマンド引数と見なします。

フラグ引数を持たないオプションの記述例を以下に示します。

記述例1

以下の入力は同じ意味です。

$cmd -a -b -c
$cmd -abc
（a、b、cはフラグ引数を持たないオプション）

記述例2

以下の入力では‘b’および「-c」をコマンド引数と見なしますが、コマンド引数とみなすかどうかはOSに依存します。

$cmd -a b -c
（aはフラグ引数を持たないオプション）

フラグ引数を持つオプションの指定方法

フラグ引数中に空白を含める場合、フラグ引数の前後を引用符（“）で囲む必要があります。フラグ引数を持つオプションを2回以上指定した場合、最後に指定したものを有効と判断します。フラグ引数を必要とするオプションのフラグ引数は省略不可です。

フラグ引数を持つオプションの記述例を以下に示します。

（記述例1）

$cmd -a b
（aはフラグ引数を持つオプション、bはフラグ引数）

（記述例2）

以下の入力は、“b c”（ダブルクォーテーションを除く）をフラグ引数と見なします。

$cmd -a "b c"
（aはフラグ引数を持つオプション）

（記述例3）

以下の入力は、「-a」のフラグ引数として2を有効とします。

$cmd -a 1 -a 2
（aはフラグ引数を持つオプション、1、2はフラグ引数）

（記述例4）

以下の入力はエラーとします。

$cmd -a
（aはフラグ引数を持つオプション）

コマンド引数

コマンド引数は、コマンド操作の対象となるものを指定します。

コマンド引数の指定方法を以下に示します。なお、以下の説明分中の「$」はシェルプロンプトを、「cmd」はコマンド名称をそれぞれ示します。また、「-a」はフラグ引数を持たないオプション、「-b」はフラグ引数を持つオプション、Pはコマンド引数をそれぞれ示します。

（記述例1）

コマンド引数を指定する場合の入力

$cmd P
$cmd -a P
$cmd –b 1 -a P

（記述例2）

コマンド引数を指定しない場合の入力

$cmd
$cmd -a
$cmd -b 1 -a

利用可能な文字

利用可能な文字はASCII文字のみ記述することができます。非ASCII文字は記述はできません。

4.2　コマンド実行結果の出力

コマンド入力側

コマンド入力画面には、以下のようにコマンド実行結果を出力します。

表4‒1　コマンド実行結果の出力場所と出力内容

コマンド実行結果

コマンド入力画面の表示

正常

コマンド実行結果出力

コマンド解析エラー

コマンド解析エラーメッセージ出力（KFSEyyyyy-E）

コマンドエラー

コマンドエラーメッセージ出力（KFSEzzzzz-E）

ヘルプメッセージ

ヘルプメッセージ出力（KFSExxxxx-I）

システムテスト支援側

システムテスト支援プロセス側では、メッセージログファイルにコマンドライン情報を出力します。

コマンドライン情報の出力形式の例を以下に示します。

コマンドライン情報

KFSE85001-I コマンドを受け付けました。コマンド＝esaflfput -g HSIC00 -m all

表4‒2　コマンドライン情報

項目

出力情報

詳細

KFSE85001-I

メッセージID

全コマンド共通。

esaflfput -g HSIC00 -m all

コマンドライン情報

入力したコマンド及び引数情報を出力

（最大1024バイト）

なお、コマンド実行結果はメッセージログに出力しません。

コマンドのexitコード

運用コマンドでは、コマンド動作の結果をexitコードにて通知します。運用コマンドで返却するexitコードを以下に示します。

表4‒3　コマンドのexitコード

動作結果

exitコード

正常終了

0

エラー終了

0以外

4.3　コマンド一覧

提供するコマンドの一覧を以下に示します。

メモ

Windows版のHSICのコマンドを実行する場合にコマンドプロンプトを起動するときは、「管理者として実行」を選択してください。通常のコマンドプロンプトからコマンドを実行した場合、HSICのコマンドが正常に動作しないことがあります。

表4‒4　蓄積ファイル関連コマンド

コマンド名

機能

実行できるユーザ

プロセス制御関連

esstart

システムテスト支援起動コマンド

◎

esstop

システムテスト支援終了コマンド

◎

esjobls

システムテスト支援状態一覧表示コマンド

○

esjobrm

システムテスト支援実行環境削除コマンド

◎

実行形態管理関連

esmodadd

システムテスト支援実行形態追加コマンド

◎

esmoddel

システムテスト支援実行形態削除コマンド

◎

通信制御関連

esipclscn

コネクション状態の表示コマンド

○

esipcsockcls

コネクションの切断コマンド

◎

蓄積ファイル関連

esaflfills

蓄積ファイル内容表示コマンド

◎

esaflfput

蓄積ファイル情報強制出力コマンド

◎

トラブルシュート

関連

estrbtaskfput

TASKTM情報強制ファイル出力コマンド

◎

estrbstcfput

システム統計情報強制出力コマンド

◎

estrbstced

システム統計情報編集コマンド

○

estrbreport

システム統計情報リアルタイム編集コマンド

○

esrasget

保守資料取得コマンド

◎

凡例

◎：Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できる

○：Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウント、および一般ユーザで実行できる

4.3.1　esaflfills（蓄積ファイルの内容表示）

目的

蓄積ファイル情報を編集して出力します。

形式

esaflfills  [-e { f | r }]
            [-k 電文キー]
            [-s 蓄積ファイル種別[,蓄積ファイル種別...] ]
            [-r]
            [-d 電文長]
            [-L ライブラリ名]
            [-u [蓄積ファイル内容表示コマンド起動UOC名],
                [蓄積ファイル内容表示コマンドデータ編集UOC],
                [蓄積ファイル内容表示コマンド終了UOC] ]
            [-c csv出力ファイル名 [-l ファイル出力行]]
            [-g テスト識別子]
            -p {rpc | tcp | http | iiop}
            { 蓄積ファイル名 [蓄積ファイル名...] |
                  蓄積ファイル格納ディレクトリ [蓄積ファイル格納ディレクトリ...] }

機能

指定した蓄積ファイル、もしくは指定したディレクトリ中に格納された蓄積ファイル情報を編集し、標準出力、またはcsv形式でファイル出力します。

ユーザデータを出力対象とするときのオプションの組み合わせについては、「蓄積ファイル表示コマンドのL/u/dオプションの組み合わせによる動作」を参照してください。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-e {f | r} ～《r》

編集種別を指定する。

f

ファイル情報一覧を出力します。

r

電文単位に編集出力を行います。

-k 電文キー ～〈64文字の英数字〉

比較エラー情報ファイルに出力された電文キーを指定します。

省略すると、指定した蓄積ファイル中の全ての電文を処理対象とします。

-s 蓄積ファイル種別[、蓄積ファイル種別...]

出力したい蓄積ファイルの種別をカンマ区切りで指定します。省略すると、指定した蓄積ファイル全てが処理対象となります。指定可能な蓄積ファイル種別は以下の通りです。

req

本番用要求電文蓄積ファイルを処理対象とします。

rpy

本番用応答電文蓄積ファイルを処理対象とします。

reqts

テスト用要求電文蓄積ファイルを処理対象とします。

rpyts

テスト用応答電文蓄積ファイルを処理対象とします。

-r

同じ電文キーをもつ要求電文、及び応答電文を続けて表示します。

-d 電文長 ～〈1～8388608の10進数〉

先頭から指定した長さまでの電文内容を、16進形式とASCII形式で表示します。ASCII形式で非表示文字はピリオドを表示します。「-c」オプションを同時に指定した場合、257以上を指定しても256が指定されたものとして動作します。

本オプションを指定しないときは、ユーザデータは表示されません。

HTTPプロトコル、及びIIOPプロトコルのときは、プロトコルヘッダ情報から表示します。

他オプションとの組み合わせについては「蓄積ファイル表示コマンドのL/u/dオプションの組み合わせによる動作」を参照してください。

-L ライブラリ名 ～〈1024文字以内のパス名〉

Windows版では〈259文字以内のパス名〉で指定します。

UOCを含んだUAP共用ライブラリの名称を絶対パス名で指定します。UOCについては「6.　システムテスト支援のUOC」を参照してください。

他オプションとの組み合わせについては「蓄積ファイル表示コマンドのL/u/dオプションの組み合わせによる動作」を参照してください。

-u蓄積ファイル内容表示コマンド起動UOC名、蓄積ファイル内容表示コマンドデータ編集UOC名、蓄積ファイル内容表示コマンド終了UOC名

～〈カンマ区切り三つの1〜31文字の識別子〉

蓄積ファイル内容表示コマンド起動UOC名と蓄積ファイル内容表示コマンドデータ編集UOC、蓄積ファイル内容表示コマンド終了UOC名をカンマ区切りで指定します。「-u」オプションを指定した場合、UOC名称は一つ以上指定する必要があります。蓄積ファイル内容表示コマンドデータ編集UOCを作成しない場合、ユーザデータは表示されません。

UOCについては「6.　システムテスト支援のUOC」を参照してください。

指定例を以下に示します。

起動UOCと停止UOCだけの場合

-u aa…aa,,bb…bb

編集UOCだけの場合

-u ,aa…aa,

「-L」オプションを指定するか、「-L」オプションを省略して/opt/HSIC/uoclib/libesuocafl.soが存在するときに本オプションを省略すると、各UOC名はデフォルトの名称を仮定します。

他オプションとの組み合わせについては「蓄積ファイル表示コマンドのL/u/dオプションの組み合わせによる動作」を参照してください。

-c csv出力ファイル名 ～〈1024文字以内のパス名〉

Windows版では〈259文字以内のパス名〉で指定します。

編集結果をcsv形式で出力ファイル名を絶対パス名で指定します。

ファイルが既に存在するときは、KFSE95095-Qメッセージを出力し、ユーザからの応答待ちとなります。ユーザは、当該ファイルを上書き、中断、以降のファイル全て上書きを選択することができます。

出力するcsvの仕様は以下の通りです。

区切り文字はカンマ（,）とする。

全ての行の各要素はダブルクォーテーション（"）で囲む。要素内のダブルクォーテーションは、ダブルクォーテーションを二つ並べてエスケープする。

「-l」オプションを指定した場合は、パス名中のファイル名は、245文字以下としてください。「-l」オプション指定時にファイル名が246文字以上の場合はオプションエラーで、このコマンドが異常終了します。

-l ファイル出力行 ～〈10000～100000〉

「-c」オプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて「-l」オプションに指定した行数を出力したときに、出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。「-r」オプションと同時に指定した場合、同一の電文キーをもつ電文を続けて出力するために、この行数を最大3行超えてしまう場合があります。

分割したファイルには、10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4桁の文字列とします。10000ファイルを超えた場合はを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は、最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

-cにxxxxxxと指定した場合

xxxxxx0001

xxxxxx0002

：

-cにxxxxxx.csvと指定した場合

xxxxxx0001.csv

xxxxxx0002.csv

：

このオプションを省略した場合は、ファイルを分割せずに1ファイルに出力します。

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

処理対象のテスト識別子を指定します。

-p { rpc | tcp | http | iiop}

rpc

RPCプロトコルの蓄積ファイルを表示します。

tcp

TCPプロトコルの蓄積ファイルを表示します。

http

HTTPプロトコルの蓄積ファイルを表示します。

iiop

IIOPプロトコルの蓄積ファイルを表示します。

オプションの組み合わせ

指定できるオプションの組み合わせを次の表に示します。ただしL/u/dの組み合わせに関しては、オプション引数の指定の仕方によって組み合わせ可否が変わりますので別の表に示します。

表4‒5　蓄積ファイル表示コマンドで指定可能なオプションの組み合わせ

-

-e f

-e r

-k

-s

-r

-d

-L

-u

-c

-l

-g

-p

-e f

-

×

×

○

×

×

×

×

○

○

○

○

-e r

×

-

○

○

○

○

○

○

○

○

○

○

-k

×

○

-

○

○

○

○

○

○

○

○

○

-s

○

○

○

-

○

○

○

○

○

○

○

○

-r

×

○

○

○

-

○

○

○

○

○

○

○

-d

×

○

○

○

○

-

○

○

○

○

○

○

-L

×

○

○

○

○

○

-

○

○

○

○

○

-u

×

○

○

○

○

○

○

-

○

○

○

○

-c

○

○

○

○

○

○

○

○

-

○

○

○

-l

○

○

○

○

○

○

○

○

○

-

○

○

-g

○

○

○

○

○

○

○

○

○

○

-

○

-p

○

○

○

○

○

○

○

○

○

○

○

-

（凡例）

○：指定可能

×：指定不可

L/u/dオプションの組み合わせ可否

表4‒6　蓄積ファイル表示コマンドのL/u/dオプションの組み合わせによる動作

-L

-u

-d

動作

指定あり

ライブラリが存在する

指定あり

編集UOC指定あり

指定あり

1.

指定なし

3.

編集UOC指定なし

指定あり

×

指定なし

3.

指定なし

−

指定あり

2.

指定なし

3.

ライブラリが存在しない

−

−

−

×

指定なし

デフォルトにライブラリが存在する

指定あり

編集UOC指定あり

指定あり

1.

指定なし

3.

編集UOC指定なし

指定あり

×

指定なし

3.

指定なし

−

指定あり

2.

指定なし

3.

デフォルトにライブラリが存在しない

指定あり

−

−

×

指定なし

−

指定あり

×

指定なし

3.

（凡例）

1.：指定された名称の編集UOCを実行してユーザデータを表示する。

2.：デフォルト名称の編集UOCを実行してユーザデータを表示する。

デフォルト名称の編集UOCが存在しないときはエラーとなります。

3.：ユーザデータを表示しない。

×：エラーとなる

コマンド引数

蓄積ファイル、または蓄積ファイルを格納したディレクトリを最大16個まで指定します。「p/s/g」オプションと不一致の蓄積ファイルは無視します。ファイルとディレクトリは同時に指定できません。「-r」オプションを指定したときに同じ内容のファイルを複数指定した場合、二つ目以降は無視します。

蓄積ファイル [蓄積ファイル...] ～〈1024文字以内のパス名〉

Windows版では〈259文字以内のパス名〉で指定します。

処理対象とする蓄積ファイルを絶対パス名で指定します。

ディレクトリ [ディレクトリ...] ～〈1024文字以内のパス名〉

Windows版では〈217文字以内のパス名〉で指定します。

処理対象とする蓄積ファイルが格納されているディレクトリを絶対パス名で指定します。処理対象となるのは指定したディレクトリ直下にある蓄積ファイルのみです。

出力形式

オプションの組み合わせ毎に、以下の表のように形式が変わります。

表4‒7　オプションによる蓄積ファイル表示コマンドの出力形式

-

-c

なし

あり

-e

f

（i）

（ii）

r

-p

rpc

（iii）

（iv）

tcp

http

（v）

（vi）

iiop

（vii）

（vi）

（i）-e fを指定して-cを指定しない場合

標準出力に以下のように出力します。

 *******    esaflfills Version (AA-AA-AA)  *******
 Specify output:BB…BB
 FILE   VERSION  TYPE   START TIME                  END TIME                    ※1
 RUN ID                                                       DIRECTORY         ※1
 aa…aa bb-bb-bb cc…cc dddd/dd/dd dd:dd:dd ddd.ddd eeee/ee/ee ee:ee:ee eee.eee ※2
 ff…ff                                                      gg…gg             ※2

※1：

ヘッダ行。改行を含まず1行で表示する。

※2：

処理対象のファイル数だけ出力する。改行を含まず1行で表示する。出力は以下に示すキーでソートする。

・第一ソートキー

ファイル種別。本番用要求電文蓄積ファイル→本番用応答電文蓄積ファイル→テスト用要求電文蓄積ファイル→テスト用応答電文蓄積ファイル

・第二ソートキー

ファイル内の先頭に格納された電文の日付と時刻。古い日時から昇順にソートする。

・第三ソートキー

ファイル名。辞書順で昇順にソートする。

AA-AA-AA

当該コマンドを実行したシステム検証支援基盤のバージョン

BB…BB

本コマンドの引数（オプション）

aa…aa

ディレクトリ部分を除いたファイル名。

bb-bb-bb

ファイルを作成したシステム検証支援基盤のバージョン

cc…cc

蓄積ファイル種別。

REQUEST ：本番用要求電文蓄積ファイル

REPLY ：本番用応答電文蓄積ファイル

REQUEST（TEST） ：テスト用要求電文蓄積ファイル

REPLY（TEST） ：テスト用応答電文蓄積ファイル

dddd/dd/dd dd:dd:dd ddd.ddd

ファイル内の最古の電文の日付と時刻、時刻のミリ秒。

電文が存在しない場合、システムテスト支援が使用中、又は障害等により蓄積ファイルに終了情報が書き込まれていない場合は****/**/** **：**：** ***.***を表示します。

eeee/ee/ee ee:ee:ee eee.eee

ファイル内の最新の電文の日付と時刻、時刻のミリ秒。

電文が存在しない場合、システムテスト支援が使用中、又は障害等により蓄積ファイルに終了情報が書き込まれていない場合は****/**/** **：**：** ***.***を表示します。

ff…ff

蓄積ファイル取得時のランID [蓄積実行時のランID ・・・]

テスト用要求電文蓄積ファイルとテスト用応答電文蓄積ファイルのときのみ、「蓄積実行時のランID」（本番用の蓄積ファイル取得時のランID）を最大16個まで表示します。

gg…gg

ファイル名を除いたディレクトリ部分。

（ii）-e fと-cを指定した場合

指定したファイルに以下の形式で出力します。csv形式である他は（i）と出力内容が同じであるため、詳細の説明は省略します。

"*******    esaflfills Version (AA-AA-AA)  *******"
"Specify output:BB…BB"
"FILE","VERSION","TYPE","START TIME","END TIME","RUN ID","DIRECTORY"
"aa…aa","bb-bb-bb","cc…cc","dddd/dd/dd dd:dd:dd ddd.ddd","eeee/ee/ee ee:ee:ee eee.eee",
"ff…ff","gg…gg"

（iii）-e rと-p rpcを指定し、-cを指定しない場合

標準出力に以下のように出力します。

 *******    esaflfills Version (AA-AA-AA)  *******
 Specify output:BB…BB
 ENV:aa…aa  TYPE:bb…bb  PROTOCOL:cc…cc  DETAIL:dd…dd  KEY:ee…ee             ※1※5
 DATE:ffff/ff/ff ff:ff:ff fff.fff  CLT-ADDR:ggg.ggg.ggg.ggg  CLT-PORT:hh…hh tt  ※1※5
 SRV-ADDR:iii.iii.iii.iii  SRV-PORT:jj…jj  SRV-GROUP:kk…kk  SRV-SERVICE:ll…ll ※1※5
 LENGTH:mm…mm  MODE: nn…nn  RC:oo…oo  RES-TIME:pp…pp                         ※1※5
         OFFSET N     +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f   0123456789abcdef     ※2※5
         qqqqqqqq     rrrrrrrr rrrrrrrr rrrrrrrr rrrrrrrr   ssssssssssssssss     ※3※5
         qqqqqqqq     TO NEXT LINE LOCATION SAME AS ABOVE                        ※4※5

※1：

改行を含まず1行で表示する。

※2：

「-d」オプションを指定し、かつユーザ電文長が1以上のときのみ表示する。

ユーザデータのダンプ出力のヘッダ行。

※3：

「-d」オプションを指定し、かつユーザ電文長が1以上のときのみ表示する。

以下の中で、最小の値の分だけ16進形式と文字形式で出力する。

・ユーザデータ長

・-dオプションに指定した値

・編集UOCが設定したユーザデータ長

※4：

1行前に出力した行と同一の場合、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示する。複数行同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示する。最終行の2行が同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しない。

※5：

出力対象となる電文の数だけ出力する。

「-r」オプションを指定しない場合、蓄積ファイルへの書き込み順に出力する。

「-r」オプションを指定した場合、sオプションで指定した要求電文/応答電文が揃った順に出力する。

AA-AA-AA

当該コマンドを実行したシステム検証支援基盤のバージョン

BB…BB

本コマンドの引数（オプション）

aa…aa

取得対象

Production ：本番環境の通信電文

Test ：テスト環境の通信電文

bb…bb

電文種別

Send ：要求電文

Recv ：応答電文

Err-Recv ：エラー応答電文

cc…cc

プロトコル種別

RPC ：RPCプロトコル

RAP ：RAPプロトコル

dd…dd

電文種別詳細

RPC ：RPC電文

RAP ：RAP代理実行電文

RAP-CON ：RAPコネクション確立電文

RAP-REL ：RAPコネクション解放電文

- ：上記以外の電文

ee…ee

電文キー

ffff/ff/ff ff:ff:ff fff.fff

電文を取得した日付、時刻、時刻のミリ秒。

ggg.ggg.ggg.ggg

要求元のIPアドレス（15桁以内の10進数）（左揃え）

hh…hh

要求元のポート番号。（5桁以内の10進数）

tt

通信方向

=> ：RPC要求元からRPC要求先への通信

<= ：RPC要求先からRPC要求元への通信

iii.iii.iii.iii

要求先のIPアドレス（15桁以内の10進数）（左揃え）

jj…jj

要求先のポート番号（5桁以内の10進数）

kk…kk

要求先のサービスグループ名（31文字以内） ※1

ll…ll

要求先のサービス名（31文字以内） ※1

mm…mm

ユーザ電文長（11桁以内の10進数）

nn…nn

RPCの形態 ※1

Reply ：同期応答型

Noreply ：非応答型

Nowait ：非同期応答型

oo…oo

リターン値（11桁以内の10進数） ※2

pp…pp

応答時間（10桁以内の10進数）（ミリ秒） ※2 ※3

qqqqqqqq

この行の先頭データについてのユーザデータ先頭からのオフセット。16進表記。

rrrrrrrr

ユーザデータの16進形式のダンプ出力。4バイトごとにスペースで区切る。

ssssssssssssssss

ユーザデータの文字形式のダンプ出力です。ASCIIコードでない場合や、制御文字の場合は、ピリオド（.）を表示します。

※1：

電文種別詳細がRPC、又はRAPのときに表示する。

それ以外は「-」を表示する。

※2：

電文種別がRecv及びErr-Recvのときに表示する。それ以外は「-」を表示する。

※3：

RPC応答時間が9999999999ミリ秒以上のときは9999999999と表示する。

（iv）-e rと-p rpcと-cを指定した場合

指定したファイルに以下の形式で出力します。「（iii）-e rと-p rpcを指定し、-cを指定しない場合」と出力内容が異なる部分のみ説明します。

 "*******    esaflfills Version (AA-AA-AA)  *******"
 "Specify output:BB…BB"
 "ENV","TYPE","PROTOCOL","DETAIL","KEY","DATE",
 "CLT-ADDR","CLT-PORT"," DIRECTION","SRV-ADDR","SRV-PORT","SRV-GROUP",      ※1
 "SRV-SERVICE","LENGTH","MODE","RC","RES-TIME",                             ※1
 "DATA(ASCII)","DATA(HEXADECIMAL)"                                          ※1
 "aa…aa","bb…bb","cc…cc","dd…dd","ee…ee","ffff/ff/ff ff:ff:ff fff.fff", ※2
 "ggg.ggg.ggg.ggg","hh…hh","tt","iii.iii.iii.iii","jj…jj","kk…kk",        ※2
 "ll…ll","mm…mm","nn…nn","oo…oo","pp…pp",                               ※2
 "ss…ss","rr…rr"                                                           ※2※3

※1：

csvのヘッダ行。1行で出力する。

※2：

csvのデータ行。1行で出力する。

※3：

以下の中で、最小の値分だけ16進形式と文字形式でダンプ出力する。

・256

・ユーザデータ長

・-dオプションで指定した値

・編集UOCが設定したユーザデータ長

ss…ss

ユーザデータの文字形式のダンプ出力です。ASCIIコードでない場合や、制御文字の場合はピリオド（.）を表示します。ダンプ未出力時は"-"を表示します。1〜256桁です。

rr…rr

ユーザデータの16進形式のダンプ出力。スペースで区切りません。ダンプ未出力時は"-"を表示します。2〜512桁です。

（v）-e rと-p {tcp|http}を指定し、-cを指定しない場合

標準出力に以下のように出力します。

 *******    esaflfills Version (AA-AA-AA)  *******
 Specify output:BB…BB
 ENV:aa…aa  TYPE:bb…bb  PROTOCOL:cc…cc  DETAIL:dd…dd  KEY:ee…ee            ※1
 DATE:ffff/ff/ff ff:ff:ff fff.fff  CLT-ADDR:ggg.ggg.ggg.ggg  CLT-PORT:hh…hh tt ※1※5
 SRV-ADDR:iii.iii.iii.iii  SRV-PORT:jj…jj                                      ※1※5
 LENGTH:mm…mm  RES-TIME:pp…pp                                                 ※1※5
         OFFSET N     +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f   0123456789abcdef    ※2※5
         qqqqqqqq     rrrrrrrr rrrrrrrr rrrrrrrr rrrrrrrr   ssssssssssssssss    ※3※5
         qqqqqqqq     TO NEXT LINE LOCATION SAME AS ABOVE                       ※4※5

※1：

改行を含まず1行で表示する。

※2：

「-d」オプションを指定し、かつユーザ電文長が1以上のときのみ表示する。

ユーザデータのダンプ出力のヘッダ行。

※3：

「-d」オプションを指定し、かつユーザ電文長が1以上のときのみ表示する。

以下の中で、最小の値の分だけ16進形式と文字形式で出力する。

・ユーザデータ長

・-dオプションに指定した値

・編集UOCが設定したユーザデータ長

※4：

1行前に出力した行と同一の場合、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示する。複数行同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示する。最終行の2行が同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しない。

※5：

出力対象となる電文の数だけ出力する。

「-r」オプションを指定しない場合、蓄積ファイルへの書き込み順に出力する。

「-r」オプションを指定した場合、sオプションで指定した要求電文/応答電文が揃った順に出力する。

AA-AA-AA

当該コマンドを実行したシステム検証支援基盤のバージョン

BB…BB

本コマンドの引数（オプション）

aa…aa

取得対象

Production ：本番環境の通信電文

Test ：テスト環境の通信電文

bb…bb

電文種別

Send ：要求電文

Recv ：応答電文

cc…cc

プロトコル種別

TCP ：TCPプロトコル

HTTP ：HTTPプロトコル

dd…dd

電文種別詳細

- ：詳細情報なし

ee…ee

電文キー

ffff/ff/ff ff:ff:ff fff.fff

電文を取得した日付、時刻、時刻のミリ秒。

ggg.ggg.ggg.ggg

要求元のIPアドレス（15桁以内の10進数）（左揃え）

hh…hh

要求元のポート番号。（5桁以内の10進数）

tt

通信方向

=> ：要求元から要求先への通信

<= ：要求先から要求元への通信

iii.iii.iii.iii

要求先のIPアドレス（15桁以内の10進数）（左揃え）

jj…jj

要求先のポート番号（5桁以内の10進数）

mm…mm

ユーザ電文長（11桁以内の10進数）

pp…pp

応答時間（10桁以内の10進数） （ミリ秒） ※1 ※2

qqqqqqqq

この行の先頭データについてのユーザデータ先頭からのオフセット。16進表記。

rrrrrrrr

ユーザデータの16進形式のダンプ出力。4バイトごとにスペースで区切る。

ssssssssssssssss

ユーザデータの文字形式のダンプ出力です。ASCIIコードでない場合や、制御文字の場合は、ピリオド（.）を表示します。

※1：

電文種別がRecvのときに表示する。それ以外は「-」を表示する。

※2：

応答時間が9999999999ミリ秒以上のときは9999999999と表示する。

（vi）-e rと-p {tcp|http|iiop}と-cを指定した場合

指定したファイルに以下の形式で出力します。「（v）-e rと-p {tcp|http}を指定し、-cを指定しない場合」と出力内容が異なる部分のみ説明します。

"*******    esaflfills Version (AA-AA-AA)  *******"
 "Specify output:BB…BB"
 "ENV","TYPE","PROTOCOL","DETAIL","KEY","DATE",                             ※1
 "CLT-ADDR","CLT-PORT"," DIRECTION","SRV-ADDR","SRV-PORT",                  ※1
 "LENGTH","RES-TIME","DATA(ASCII)","DATA(HEXADECIMAL)"                      ※1
  "aa…aa","bb…bb","cc…cc","dd…dd","ee…ee","ffff/ff/ff ff:ff:ff fff.fff",※2
 "ggg.ggg.ggg.ggg","hh…hh","tt","iii.iii.iii.iii","jj…jj","kk…kk",        ※2
 "ll…ll","mm…mm","nn…nn","oo…oo","pp…pp",                               ※2※3
 "ss…ss","rr…rr"                                                           ※2

※1：

csvのヘッダ行。1行で出力する。

※2：

csvのデータ行。1行で出力する。

※3：

以下の中で、最小の値分だけ16進形式と文字形式でダンプ出力する。

・256

・ユーザデータ長

・-dオプションで指定した値

・編集UOCが設定したユーザデータ長

ss…ss

ユーザデータの文字形式のダンプ出力です。ASCIIコードでない場合や、制御文字の場合はピリオド（.）を表示します。ダンプ未出力時は"-"を表示します。1〜256桁です。

rr…rr

ユーザデータの16進形式のダンプ出力。スペースで区切りません。ダンプ未出力時は"-"を表示します。2〜512桁です。

（vii）-e rと-p iiopを指定し、-cを指定しない場合

標準出力に以下のように出力します。

******* esaflfills Version (AA-AA-AA) *******
 Specify output:BB…BB
 ENV:aa…aa TYPE:bb…bb PROTOCOL:cc…cc DETAIL:dd…dd KEY:ee…ee                 ※1※5
 DATE:ffff/ff/ff ff:ff:ff fff.fff CLT-ADDR:ggg.ggg.ggg.ggg CLT-PORT:hh…hh tt    ※1※5
 SRV-ADDR:iii.iii.iii.iii SRV-PORT:jj…jj OPERATION:kk…kk                       ※1※5
 REPLY-STATUS:llllllll LENGTH:mm…mm PROT-LENGTH:nn…nn USER-LENGTH:oo…oo       ※1※5
 RES-TIME:pp…pp SYSTEM:zz…zz                                                   ※1※5
 OFFSET +0+1+2+3 +4+5+6+7 +8+9+a+b +c+d+e+f 0123456789abcdef                     ※2※5
 qqqqqqqq rrrrrrrr rrrrrrrr rrrrrrrr rrrrrrrr ssssssssssssssss                   ※3※5
 qqqqqqqq TO NEXT LINE LOCATION SAME AS ABOVE                                    ※4※5

※1：

改行を含まず1行で表示する。

※2：

-dオプションを指定し、かつ電文長が1以上のときのみ表示する。データのダンプ出力のヘッダ行。

※3：

-dオプションを指定し、かつ電文長が1以上のときのみ表示する。以下の中で、最小の値の分だけ16進形式と文字形式で出力する。

・プロトコル電文長

・-dオプションに指定した値

・編集UOCが設定したプロトコル電文長

※4：

1行前に出力した行と同一の場合、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示する。複数行同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示する。最終行の2行が同一の場合は、「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しない。

※5：

出力対象となる電文の数だけ出力する。

rオプションを指定しない場合、蓄積ファイルへの書き込み順に出力する。rオプションを指定した場合、sオプションで指定した要求電文/応答電文が揃った順に出力する。

AA-AA-AA

当該コマンドを実行したシステム検証支援基盤のバージョン

BB…BB

本コマンドの引数（オプション）

aa…aa

取得対象

Production：本番環境の通信電文

Test：テスト環境の通信電文

bb…bb

電文種別

Send：要求電文

Recv：応答電文

cc…cc

プロトコル種別

IIOP：IIOPプロトコル

dd…dd

電文種別詳細：詳細情報なし

ee…ee

電文キー

ffff/ff/ff ff:ff:ff fff.fff

電文を取得した日付、時刻、時刻のミリ秒。

ggg.ggg.ggg.ggg

要求元のIPアドレス（15桁以内の10進数）（左揃え）

hh…hh

要求元のポート番号。（5桁以内の10進数）

tt

通信方向

=> ：要求元から要求先への通信

<= ：要求先から要求元への通信

iii.iii.iii.iii

要求先のIPアドレス（15桁以内の10進数）（左揃え）

jj…jj

要求先のポート番号（5桁以内の10進数）

kk…kk

オペレーション名（31文字以内）※1※2

llllllll

リプライステータス（8桁の16進数）※1※3

mm…mm

プロトコル電文長（11桁以内の10進数）

nn…nn

プロトコルヘッダ長（11桁以内の10進数）※1

oo…oo

ユーザ電文長（11桁以内の10進数）※1

pp…pp

応答時間（10桁以内の10進数）（ミリ秒）※3※4

zz…zz

システム情報

qqqqqqqq

この行の先頭データについてのユーザデータ先頭からのオフセット。16進表記。

rrrrrrrr

ユーザデータの16進形式のダンプ出力。4バイトごとにスペースで区切る。

ssssssssssssssss

ユーザデータの文字形式のダンプ出力。ASCIIコードでない場合や、制御文字の場合は、ピリオド（.）を表示する。

※1：

サポート対象外の電文のときは"-"を表示する。

※2：

電文種別がSendのときに表示する。それ以外は"-"を表示する。

※3：

電文種別がRecvのときに表示する。それ以外は"-"を表示する。

※4：

応答時間が9999999999ミリ秒以上のときは9999999999と表示する。

出力メッセージ

メッセージID

内容

出力先

KFSE90915-I

ヘルプメッセージ

標準出力

KFSE95088-E

コマンド引数が不正です

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE90916-E

ファイルアクセスエラー

標準エラー出力

KFSE90917-E

コマンド引数が不正です

標準エラー出力

KFSE90918-E

UOCエラーが発生しました

標準エラー出力

KFSE90919-E

UOC用ライブラリのローディングに失敗しました

標準エラー出力

KFSE95095-Q

上書き確認

標準出力

KFSE95095-Q にn（上書きしない）を応答した場合、exitコードは1になります。

注意事項

「-r」オプションを指定したときに、蓄積ファイルの指定漏れ等によりそろわない電文が10000件となったときは、蓄積ファイル種別ごとに10000件を一括して表示し、コマンド実行を継続します。

「-r」オプションを指定したときに、一部の電文が消失等によりそろわないときは、コマンド終了時に一括して表示します。

「-r」オプションを指定し、かつ「-s」オプションに本番用とテスト用の蓄積ファイル種別を指定、または「-s」オプションを省略して本番用とテスト用の蓄積ファイルを指定するときは、事前に「-e f」指定でファイル情報一覧を表示し、以下の項目を確認してください。

テスト用の蓄積ファイルで表示された「蓄積実行時のランID」に対応する本番用の蓄積ファイルが全て存在するか。

本番用の蓄積ファイルで表示された「蓄積ファイル取得時のランID」に対応するテスト用の蓄積ファイルが存在するか。

同じ蓄積ファイル種別のテスト用の蓄積ファイルにおいて、「蓄積ファイル取得時のランID」が不一致で、「蓄積実行時のランID」が一部、または全て一致している蓄積ファイルが他にないか。

次に示す条件を全て満たす場合、-rオプションは使用できません。

「-s」オプションに本番用とテスト用の蓄積ファイル種別を指定、または「-s」オプションを省略して本番用とテスト用の蓄積ファイルを指定

システムテスト支援を17回以上実行して取得した本番用要求電文蓄積ファイルの全てを入力とし、リプレイ実行により取得した蓄積ファイル、またはその蓄積ファイルを格納したディレクトリを指定

「-r」オプションを指定し、かつ要求電文蓄積ファイルと応答電文蓄積ファイルを対で指定しなかった場合に非応答型RPCがあると、蓄積ファイルに出力した順に表示されない場合があります。

出力対象の情報がないときは、何も出力しません。

4.3.2　esaflfput（蓄積ファイルの情報強制出力）

目的

バッファにスタックしている電文情報をファイルに強制的に出力します。

形式

esaflfput [-g テスト識別子]
          [-m { all ｜ req ｜ rpy ｜ reqts ｜ rpyts } ]
          [-s]

機能

バッファにスタックしている電文情報を使用中の蓄積ファイルに強制的に出力します。

-sオプション指定時は、強制出力後にファイルを切り替えます。

強制出力したときに、蓄積ファイルのサイズがaccumulate_fileオペランドの-fオプションのfilesz指定値を超えていたときは、-sオプション指定有無にかかわらずファイルを切り替えます。ファイルの切り替え先がないときは、KFSE90914-Eメッセージを出力します。

蓄積ファイル機能が開始したときに出力するKFSE80910-Iメッセージ出力以降に、本コマンドは実行できます。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-m { all｜req｜rpy｜reqts｜rpyts }《all》

強制出力する蓄積ファイルの種別を指定します。

all

全ての蓄積ファイルに対して強制出力をします

req

本番用の要求電文蓄積ファイルに対して強制出力をします

rpy

本番用の応答電文蓄積ファイルに対して強制出力をします

reqts

テスト用の要求電文蓄積ファイルに対して強制出力をします

rpyts

テスト用の応答電文蓄積ファイルに対して強制出力をします

-s

バッファにある蓄積ファイル情報をファイルに出力後、出力先の蓄積ファイルを切り替えます。バッファに電文情報がないときは、出力先の蓄積ファイルの切り替えのみ行います。

出力メッセージ

メッセージID

内容

出力先

KFSE90910-I

コマンドが正常終了しました

標準出力

KFSE90911-I

コマンドが正常終了しました

標準出力

KFSE90912-I

ヘルプメッセージ

標準出力

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました。

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE90913-E

コマンドが失敗しました

標準エラー出力

KFSE90914-E ※1

コマンドが失敗しました

標準エラー出力

※1：-mオプション省略または-mオプションにallを指定し、かつKFSE90910-IまたはKFSE90911-Iメッセージ出力済の場合、exitコードは0になります。

注意事項

以下に示すケースでは、「-s」オプションを指定して本コマンドを投入しても、蓄積ファイルの切り替えはしません。

切り替え先の蓄積ファイルを作成できなかったとき

システムテスト支援を起動した直後、または、このコマンドを投入した直後、かつ、蓄積ファイルおよびバッファ内に電文情報がないとき

システム定義で最大ファイル数に1を指定している場合に、本コマンドを投入すると、最大10,000ファイル（最初に使用したファイルを含む）まで新たに蓄積ファイルを作成します。

本コマンドを投入した場合に、蓄積ファイルで強制出力エラー、または、切り替えエラーが発生しても、システムテスト支援は処理を続行します。

「-m」オプションに「all」を指定、又は「-m」オプションを省略して本コマンドを投入した場合に、一部の蓄積ファイルで強制出力エラー、または、切り替えエラーが発生しても、エラーの発生していない蓄積ファイルの処理は続行して行います。

「-m」オプションに「all」を指定、又は「-m」オプションを省略して本コマンドを投入した場合、以下のメッセージは蓄積ファイル種別毎に出力します。

KFSE90910-I、KFSE90911-I、KFSE90914-E

バッファにスタックしている電文情報は、使用中の蓄積ファイルに出力するため、本コマンドを実行した場合の最大ファイルサイズはaccumulate_fileの-fオプションのfilesz指定値にaccumulate_fileの-bオプションのsize指定値を加算した値となります。

4.3.3　esipclscn（コネクションの表示）

目的

コネクションを表示します。

形式

esipclscn [-g テスト識別子]

機能

システムテスト支援が使用しているテスト対象システムとのコネクションを表示します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウント、または一般ユーザで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

出力形式

日本語の場合

テスト識別子＝aa・・・aa
自IPアドレス  自ポート番号  相手IPアドレス  相手ポート番号  プロトコル種別  作成時刻            最終使用時刻
bbb.bbb.bbb.bbb        ccccc  ddd.ddd.ddd.ddd            eeeee             fff   y1/m1/d1 h1:m1:s1  y2/m2/d2 h2:m2:s2

英語の場合

test ID = aa・・・aa
My IP address    My port number  Target IP address   Target port number   Protocol type  Alloc time          Use time
bbb.bbb.bbb.bbb          ccccc   ddd.ddd.ddd.ddd                  eeeee             fff  y1/m1/d1 h1:m1:s1   y2/m2/d2 h2:m2:s2

bbb.bbb.bbb.bbb

自IPアドレス

ccccc

自ポート番号

ddd.ddd.ddd.ddd

相手IPアドレス

eeeee

相手ポート番号

fff

プロトコル種別

RPC：RPC・RAPプロトコル

TCP：TCPスルー

HTP：HTTP

IOP：IIOPプロトコル

y1/m1/d1 h1:m1:s1

作成時刻（『年/月/日 時:分:秒』、年は下2桁で表示）

y2/m2/d2 h2:m2:s2

最終使用時刻（『年/月/日 時:分:秒』、年は下2桁で表示）

コネクションを使用して一度も送受信を行っていない場合は、「-」を出力します。

表示対象がない場合は、以下のメッセージを出力します。

日本語の場合

表示対象のコネクションがありません。

英語の場合

There is no connection to be displayed.

出力メッセージ

メッセージID

内容

出力先

KFSE93301-I

ヘルプメッセージ

標準出力

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

注意事項

本コマンドと通信制御の処理が競合すると、一時的にシステムテスト支援の性能が低下することがあります。

4.3.4　esipcsockcls（コネクションの切断）

目的

コネクションを切断します。

形式

esipcsockcls [-g テスト識別子]
             {[-i 自IPアドレス] [-m 自ポート番号] [-t 相手IPアドレス]
              [-o 相手ポート番号] | -a}
             [-p { all | rpc | tcp | htp | iop}]

機能

システムテスト支援が使用しているテスト対象システムとのコネクションを切断します。

切断対象のコネクションが送信中の場合は、送信完了後にコネクションを切断します。

切断するコネクションは、esipclscnコマンドで確認してください。

また、コネクション切断が成功したか否かもesipclscnコマンドで確認してください

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-i 自IPアドレス ～〈7～15文字の数字〉

自IPアドレスを指定します。

IPアドレスを指定する場合は、xxx.xxx.xxx.xxxの形式で指定します。

xxxは、0～255（10進数）で指定します。

-m 自ポート番号 ～〈1～65535〉

自ポート番号を指定します。

-t 相手IPアドレス ～〈7～15文字の数字〉

相手IPアドレスを指定します。

IPアドレスを指定する場合は、xxx.xxx.xxx.xxxの形式で指定します。

xxxは、0～255（10進数）で指定します。

-o 相手ポート番号 ～〈1～65535〉

相手ポート番号を指定します。

-p {all | rpc | tcp | htp | iop}　《all》

指定されたプロトコル種別のコネクションを切断します。

all：プロトコル種別に関係なくコネクションを切断

rpc：プロトコル種別がRPC・RAPのコネクションを切断

tcp：プロトコル種別がTCPスルーのコネクションを切断

htp：プロトコル種別がHTTPのコネクションを切断

iop：プロトコル種別がIIOPのコネクションを切断

-a

-pオプションで指定したプロトコル種別のコネクションをすべて切断します。

本オプションを指定した場合は、-iオプション、-mオプション、-tオプション、-oオプションの指定は無視します。

-iオプション、-mオプション、-tオプション、-oオプションのすべてを省略した場合は、コネクションの切断は行いません。すべてのコネクションを切断したい場合は、-aオプションを指定してください。

-iオプションのみを指定した場合（他オプションも同様）は、指定した値が一致するコネクションはすべて切断します。（他の値についてはチェックしません。）

出力形式

日本語の場合

KFSE93306-I コネクション切断を受け付けました。テスト識別子＝aa…aa,プロトコル種別＝bb…bb,自IPアドレス＝cc…cc,自ポート番号＝dd…dd,相手IPアドレス番号＝ee…ee,相手ポート番号＝ff…ff

英語の場合

KFSE93306-I The connection close has been accepted. test ID = aa…aa, protocol type = bb…bb, my IP address = cc…cc, my port number = dd…dd, target IP address = ee…ee, target port number = ff…ff

aa…aa

コネクションを切断するテスト識別子

bb…bb

プロトコル種別

all：すべてのプロトコル

rpc：RPC・RAPプロトコル

tcp：TCPスルー

htp：HTTP

cc…cc

自IPアドレス。

-iオプション省略、または、-aオプション指定時は「*」を出力

dd…dd

自ポート番号。

-mオプション省略、または、-aオプション指定時は「*」を出力

ee…ee

相手IPアドレス。

-tオプション省略、または、-aオプション指定時は「*」を出力

ff…ff

相手ポート番号。

-oオプション省略、または、-aオプション指定時は「*」を出力

出力メッセージ

メッセージID

内容

出力先

KFSE93302-I

ヘルプメッセージ

標準出力

KFSE93306-I

コネクション切断を受け付けました

標準出力

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

注意事項

コネクション接続先のマシンがダウンした場合などに、作成時刻（※1）が、マシンダウンした時刻よりも前だった場合に、本コマンドを使用して、コネクション切断を行ってください。

※1：コネクション確立時刻は、esipclscnコマンドで確認してください。

4.3.5　esjobls（システム検証支援の状態表示）

目的

システム検証支援基盤の状態を一覧表示します。

形式

esjobls

機能

システム検証支援基盤の状態を一覧表示します。

1回以上起動したことがあるシステムテスト支援のプロセスが表示対象となります。

但し、1回以上起動した場合でもシステムテスト支援の実行環境を削除したものに対しては表示されません。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウント、または一般ユーザで実行できます。

オプション

なし。

出力形式

システムテスト支援の識別子ごとに、以下の情報を標準出力に表示します。

テスト識別子

状態・終了要因

実行形態

プロセスID

システムテスト支援プロセス起動時刻

システムテスト支援プロセス終了時刻

システムテスト支援テスト開始時刻

システムテスト支援テスト終了時刻

システム分析支援プロトコル種別

表示形式を下記に示します。

日本語の場合

テスト識別子                     状態       実行形態               PID  プロセス起動時刻     プロセス終了時刻     テスト開始時刻       テスト終了時刻       種別  プロトコル
aa…aa                           bbb(eeee)  cccc                   dd…dd  YYY1/M1/D1 h1:m1:s1  YYY2/M2/D2 h2:m2:s2  YYY3/M3/D3 h3:m3:s3  YYY4/M4/D4 h4:m4:s4  fff   gg…gg
aa…aa                           bbb(eeee)  cccc                   dd…dd  YYY1/M1/D1 h1:m1:s1  YYY2/M2/D2 h2:m2:s2  YYY3/M3/D3 h3:m3:s3  YYY4/M4/D4 h4:m4:s4  fff   gg…gg

英語の場合

Test ID                          Status     Execution format          PID  Process start time   Process stop time    Test begin time      Test end time        Classification  Protocol
aa…aa                           bbb(eeee)  cccc                   dd…dd  YYY1/M1/D1 h1:m1:s1  YYY2/M2/D2 h2:m2:s2  YYY3/M3/D3 h3:m3:s3  YYY4/M4/D4 h4:m4:s4  fff             gg…gg
aa…aa                           bbb(eeee)  cccc                   dd…dd  YYY1/M1/D1 h1:m1:s1  YYY2/M2/D2 h2:m2:s2  YYY3/M3/D3 h3:m3:s3  YYY4/M4/D4 h4:m4:s4  fff             gg…gg

aa…aa

テスト識別子

bbb

状態

ACT：稼働中

STP：停止中

eeee

終了要因

----：稼働中

****：異常終了

NORM：正常終了

TERM：強制終了

c₁c₂c₃c₄

実行形態。

状態が「STP」の場合は最後に稼働していた時の実行形態を表示します。

c₁：p（並行実行）

c₂：a（蓄積実行）

c₃：r（リプレイ実行）

c₄：c（PCAP実行）

未実行の実行形態の箇所には「-」を表示します。

dd…dd

プロセスID。状態が「STP」の場合は最後に稼働していた時のプロセスIDを表示します。

fff

システム検証支援基盤種別

"TST"：システムテスト支援

"ADP"：システム分析支援アダプタ

"---"：種別未確定（システム検証支援基盤プロセス開始時に異常終了等）

gg…gg

プロトコル種別。

複数のプロトコルが稼働している場合は"："区切りで表示します。

状態が「STP」の場合は最後に稼働していた時のプロトコル種別を表示します。

RPC ：RPC・RAPプロトコル

TCP ：TCPスルー

UDP ：UDPスルー

HTTP：HTTPスルー

IIOP：IIOPプロトコル

--- ：プロトコル未確定（システム分析支援プロセス開始時に異常終了している）

YYY1/M1/D1 h1:m1:s1

システムテスト支援プロセス起動時刻

YYY2/M2/D2 h2:m2:s2

システムテスト支援プロセス終了時刻

状態が「STP（NORM）」以外の場合は、「----/--/-- --:--:--」を表示します。

YYY3/M3/D3 h3:m3:s3

システムテスト支援テスト開始時刻

指定時刻が2038年1月19日3時14分7秒を超過している場合は、"2038/01/19 03:14:07"を表示します。

テスト開始時刻の指定が無い場合は、"----/--/-- --:--:--"を表示します。

YYY4/M4/D4 h4:m4:s4

システムテスト支援テスト終了時刻

指定時刻が2038年1月19日3時14分7秒を超過している場合は、"2038/01/19 03:14:07"を表示します。

テスト終了時刻の指定が無い場合は、"----/--/-- --:--:--"を表示します。

各表示時刻はTZ環境変数に合わせて取り扱います。

出力メッセージ

メッセージID

内容

出力先

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95503-E

コマンド処理でエラーが発生しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95504-E

KFSE95552-I

コマンド引数ヘルプ

標準出力

注意事項

なし。

4.3.6　esjobrm（システムテスト支援の実行環境の削除）

目的

不要となったテスト識別子のシステムテスト支援実行環境を削除します。

形式

esjobrm -g テスト識別子
        [-f]

機能

システムテスト支援の環境から、指定したテスト識別子の実行に必要なファイルおよびディレクトリ（「/opt/HSIC/job/テスト識別子」ディレクトリ内の全て）を削除します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉

システムテスト支援プロセスを識別するための識別子を指定します。

システムテスト支援プロセスの状態が停止中となっているテスト識別子を指定してください。

-f

システムテスト支援実行環境不正等の理由により、"esjobrm -g テスト識別子"で実行環境を削除できない場合に、強制的に実行環境を削除します。通常の実行環境削除では、本オプションを指定しないでください。

本オプション指定のesjobrmコマンドを実行する前に、必ず、-gオプションに指定するテスト識別子のシステムテスト支援プロセスが停止している事を以下の手順で確認してください。

esjoblsコマンドで、削除対象のテスト識別子の状態が"ACT（----）"（稼働中）でない事を確認してください。

削除対象のテスト識別子のesjoblsコマンド確認結果が"ACT（----）"の場合、esstopコマンドで削除対象のテスト識別子のシステムテスト支援プロセスを終了してください。

esstopコマンドで終了できない場合は、psコマンド（例：ps -ef）で、削除対象のテスト識別子が指定されたesstartコマンドのプロセスIDが稼働中か否かを確認してください。

psコマンドの結果で該当するesstartコマンドが稼働中の場合、killコマンドで当該プロセスを強制停止（例：kill -9 プロセスID）してください。

出力メッセージ

メッセージID

内容

出力先

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95503-E

コマンド処理でエラーが発生しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95504-E

KFSE95553-I

コマンド引数ヘルプ

標準出力

注意事項

削除対象のシステムテスト支援プロセスの稼働中に-fオプションを省略して本コマンドを実行した場合は、削除処理を行わずに本コマンドはエラーとなります。

削除対象となるディレクトリ（/opt/HSIC/job/テスト識別子）内にあるファイル等は、必要に応じてあらかじめ退避してから本コマンドを実行してください。

削除対象のシステムテスト支援プロセスの稼働中に-fオプションを指定して本コマンドを実行した場合は、実行環境は削除されますが、当該プロセスは稼働し続けて、esstopコマンドによる終了ができなくなります。また、削除後に同じテスト識別子を指定したシステムテスト支援を起動した場合、テスト対象システムへのRPCが複数回実行されたり、トラブルシュートファイルが重複して更新される等の不整合が生じます。本コマンドで-fオプションを指定する場合は、必ず対象となるシステムテスト支援プロセスが停止した状態で実行してください。

4.3.7　esmodadd（システムテスト支援の実行形態の追加）

目的

システムテスト支援実行中に実行形態を追加します。

形式

esmodadd  [-g テスト識別子]
          { -p ｜ -a }

機能

実行中のシステムテスト支援に実行形態を追加します。

既に起動している実行形態を指定すると実行形態の追加に失敗します。複数の実行形態の追加を実行し、一部の実行形態の追加が失敗した場合、コマンドで指定された全ての実行形態の追加に失敗します。

システムテスト支援実行中に実行形態を追加する場合は、事前（システムテスト支援起動時）に追加形態に必要なシステム定義を行っておく必要があります。

追加形態のシステム定義が無かった場合はコマンドがエラーとなります。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子～（1～31文字の識別子） 《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-p

並行実行を実行形態に追加します。

-a

蓄積実行を実行形態に追加します。

出力メッセージ

メッセージID

内容

出力先

KFSE93401-I

コマンド引数ヘルプ

標準出力

KFSE93403-E

実行形態の追加に失敗しました

標準エラー出力

KFSE93405-I

実行形態の追加に成功しました

標準出力

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

4.3.8　esmoddel（システムテスト支援の実行形態の削除）

目的

システムテスト支援実行中に実行形態を削除します。

形式

esmoddel  [-g テスト識別子]
          { -p ｜ -a }

機能

実行中のシステムテスト支援から実行形態を削除します。実行中の全実行形態を指定すると実行形態の削除に失敗します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子～（1～31文字の識別子） 《HSIC00》

テスト識別子を指定します。テスト識別子は実行中のシステムテスト支援のテスト識別子を指定してください。

-p

並行実行を実行形態から削除します。

注

並行実行を削除する場合、接続中のコネクションが解放される場合があります。

TCPスルーの場合、並行実行の削除によってコネクションが解放されるとテスト対象システム側で電文の途中までしか受信できない場合があります。

コネクションの解放を防ぎたい場合はaddress_destination定義-kオプションcnrlssyncフラグメンバに'N'を指定する必要があります。

-a

蓄積実行を実行形態から削除します。

出力メッセージ

メッセージID

内容

出力先

KFSE93402-I

コマンド引数ヘルプ

標準出力

KFSE93404-E

実行形態の削除に失敗しました

標準エラー出力

KFSE93406-I

実行形態の削除に成功しました

標準出力

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

4.3.9　esrasget（保守資料の取得）

目的

システムテスト支援のトラブルシュートに必要な保守資料を指定されたファイルまたはディレクトリに取得します。

形式

Linux版の場合

esrasget  [-c]
          取得先ファイル名

Windows版の場合

esrasget 取得先ディレクトリ名

機能

トラブルシュートに必要なファイルの取得、OSコマンドの実行と結果の取得、およびシステムテスト支援のコマンドの実行と結果の取得を行います。

取得先ファイルを取得するディレクトリには、資料を取得するための十分な空き領域が必要になります。取得先ファイルを出力するディスクには、システムテスト支援実行ディレクトリ下のディスク容量を以上の空きがあることを確認してから実行してください。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

–c

（Linux版のみ）

保守資料取得先ファイルを資料取得後に圧縮します。

取得先ファイル名

（Linux版のみ）

保守資料取得先ファイル名をフルパスで指定します。

「-c」オプションを指定して取得先ファイル名の末尾に「.gz」以外を指定すると、取得先ファイル名の末尾に「.gz」を付加します。

取得先ディレクトリ名 ～〈127文字以内のパス名〉

（Windows版のみ）

保守資料取得先ディレクトリ名をフルパスで指定します。

出力メッセージ

メッセージID

内容

出力先

KFSE95429-E

コマンドエラー

標準エラー出力

KFSE95436-I

ヘルプ表示（Linux版）

標準出力

KFSE95455-I

ヘルプ表示（Windows版）

標準出力

注意事項

システムテスト支援稼働中にesrasgetコマンドを実行した際、KFSE95429-Eメッセージ（理由コード＝OS COMMAND FAILED）を出力する場合がありますが、トラブルシュート情報の取得に問題はありません。

4.3.10　esstart（システムテスト支援の起動）

目的

システムテスト支援を起動します。

形式

esstart [-g テスト識別子]
        [-d 定義ファイル格納ディレクトリ名]
        [{ [-p] [-a] | -r | -c}]
        [-t [開始時刻][,終了時刻] ]
        [-m {CREATE|TEST|BATCH}]

機能

システムテスト支援を起動します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

システムテスト支援プロセスを識別するための識別子を指定します。

システムテスト支援が使用する定義ファイルの名称は、テスト識別子となります。

-d 定義ファイル格納ディレクトリ名 ～〈1021文字以内のパス名〉《/opt/HSIC/conf》

Windows版の場合は〈247文字以内のパス名〉で指定します。

システムテスト支援の定義ファイルを格納しているディレクトリ名を絶対パスで指定します。

「/opt/HSIC/conf」下以外に定義ファイルを格納する場合に指定してください。

「定義ファイル格納ディレクトリ名/テスト識別子」のパス名が、Linux版では1023文字を超過、Windows版では259文字を超過する場合はエラーとなります。

-p

並行実行を行います。

-a

蓄積実行を行います。

-r

リプレイ実行を行います。

-c

PCAP実行を行います。

-t 開始時刻,終了時刻

開始時刻と終了時刻で指定します。

本オプションを省略した場合は、フィルタ関連定義target_time -tの設定値に従って動作します。

開始時刻を指定した場合は、開始時刻以降の電文を入力対象として開始します。開始時刻より前の電文は対象外として破棄します。開始時刻を省略した場合は、システムテスト支援起動時点（リプレイ実行形態では蓄積ファイルの先頭、PCAP実行形態ではpcap形式ファイルの先頭）以降の入力電文を対象とします。

終了時刻を指定した場合は、終了時刻より前の入力電文を対象として実行します。終了時刻以降の入力電文は対象外として破棄し、対象電文の全てを実行した後に、システムテスト支援プロセスを正常終了します。終了時刻を省略した場合は、システムテスト支援プロセス終了コマンド受付時点までを対象とします。

本オプションを指定する場合は、開始時刻または終了時刻のどちらか一方は必ず指定してください。

開始時刻および終了時刻は、YYYYMMDDhhmmssの形式で指定します。

YYYY：年（西暦）（1971≦YYYY≦9999）

MM ：月（01≦MM≦12）

DD ：日（01≦DD≦31）

hh ：時（00≦hh≦23）

mm ：分（00≦mm≦59）

ss ：秒（00≦ss≦61）

指定時刻はTZ環境変数に合わせて取り扱います。指定時刻がUNIX時間最大値（TZ環境変数がUTCの場合、2038年1月19日 3時14分7秒）を超過した場合は、指定時刻をUNIX時間最大値として扱います。

また、開始時刻／終了時刻には+1秒程度の誤差が発生する場合があります。

-m {CREATE | TEST | BATCH}

ユーザテスト支援フレームワーク機能の実行フェーズを指定します。

CREATE：電文作成フェーズ

TEST：テスト実行フェーズ

BATCH：バッチ実行フェーズ

ユーザテスト支援フレームワーク機能を使用する場合は、下表に示すオプションの組合せで、電文の入力方法を指定します。

フェーズ

-p

-a

-r

-c

CREATE

×

パケットキャプチャ

×

pcapファイル

TEST

×

×

蓄積ファイル

電文ファイル

pcapファイル

BATCH

×

×

×

×

（凡例）

×：指定できません。

-mオプションを省略、または-mオプションにBATCH以外を指定した場合は、起動時の実行形態を指定するオプション（-pオプション、-aオプション、-rオプション、-cオプション）を、必ず1つ以上指定してください。全て省略した場合は、エラーとなります。

出力メッセージ

メッセージID

内容

出力先

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95503-E

コマンド処理でエラーが発生しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95504-E

KFSE95550-I

コマンド引数ヘルプ

標準出力

注意事項

本コマンドは、システムテスト支援プロセスのテスト開始時点（KFSE80003-Iメッセージ出力後） でリターンします。

システムテスト支援プロセスの異常終了時または強制終了時に出力されるcoreファイルのサイズは、本コマンドを実行した環境のcoreファイルサイズ上限によります。coreファイルサイズ上限に0が設定されている場合は、coreファイルを出力しません。

4.3.11　esstop（システムテスト支援の終了）

目的

システムテスト支援を終了します。

形式

esstop  [-g テスト識別子]
        [-f [-d]]

機能

システムテスト支援を終了します。

但し、以下の場合は終了待ち合わせを行います。

キャプチャ済みまたは蓄積ファイルから読み出し済みの未処理電文が滞留している場合は、未処理電文が全て処理済みとなるまで待ち合わせます。

（滞留している未処理電文数はKFSE80801-Iで確認できます）

RPC・RAPプロトコル、または、HTTPで応答待ちの場合は、応答受信または応答待ち時間が満了するまで待ち合わせます。

未処理電文を破棄、応答待ち合わせをぜずに終了したい場合は-f指定で終了コマンドを実行してください。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～〈1～31文字の識別子〉《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-f

システムテスト支援を強制終了します。

本オプションを省略した場合は、システムテスト支援を正常終了します。

-d

システムテスト支援を強制終了する際に、coreファイルを出力します。

Linux版のcoreファイルのサイズは、esstartコマンドを実行した環境のcoreファイルサイズ上限によります。coreファイルサイズ上限に0が設定されている場合は、このオプションフラグを指定してもcoreファイルを出力しません。

Windows版のcoreファイルのサイズは、システム検証支援基盤プロセスが使用しているメモリ使用量によります。

出力メッセージ

メッセージID

内容

出力先

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95503-E

コマンド処理でエラーが発生しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95504-E

KFSE95551-I

コマンド引数ヘルプ

標準出力

注意事項

本コマンドは、システムテスト支援が終了した時点でリターンします。

4.3.12　estrbreport（システム統計情報のリアルタイム編集）

目的

システムテスト支援プロセスの稼働状況を調査するためのシステム統計情報をリアルタイムに編集します。

形式

estrbreport [-g テスト識別子] [-c]
            [-s [開始編集ID][,終了編集ID]]

機能

メモリ上に取得したシステム統計情報を、標準出力へリアルタイムに編集出力します。

本コマンドはシステム定義の以下のどちらかの場合に使用できます。

statistical_information -u “use=Y”を指定

statistical_information -u “use”を省略

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウント、または一般ユーザで実行できます。

オプション

-g テスト識別子 ～＜1～31文字の識別子＞《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-c

標準出力へのシステム統計情報の出力をcsv形式で行います。

-s [開始編集ID][,終了編集ID]

編集出力するシステム統計情報の編集IDを指定します。編集IDについては、「9.4　システム統計情報機能の概要」を参照してください。

「-s」オプションを指定する場合は、開始編集IDまたは終了編集IDのどちらか一方を必ず指定してください。

開始編集IDだけ指定すると、開始編集ID以上のシステム統計情報を出力します。

終了編集IDだけ指定すると、終了編集ID以下のシステム統計情報を出力します。

開始編集ID、終了編集IDともに指定する場合は、開始編集ID以上、終了編集ID以下のシステム統計情報を出力します。「開始編集ID≦終了編集ID」となるように指定してください。-sオプションの指定を省略すると、すべてのシステム統計情報を編集出力します。

出力形式

標準出力への出力形式

-cを省略した場合

日本語の場合

___________________________________________________________________________
ID        件数              平均              最大              最小
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa  bbbbbbbbbbbbbbbb  cccccccccccccccc  dddddddddddddddd  eeeeeeeeeeeeeeee
 ：          ：                ：                ：                ：      ※1

※1：指定された範囲の編集対象IDを全て出力するまで繰り返します。

英語の場合

___________________________________________________________________________
ID        Number            Average           Maximum           Minimum
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aaa  bbbbbbbbbbbbbbbb  cccccccccccccccc  dddddddddddddddd  eeeeeeeeeeeeeeee
 ：          ：                ：                ：                ：      ※1

※1：指定された範囲の編集対象IDを全て出力するまで繰り返します。

-cを指定した場合

aaa,bb....bb,cc....cc,dd....dd,ee....ee
 ：                                     ※1

※1：指定された範囲の編集対象IDを全て出力するまで繰り返します。

aaa

編集ID（10進数3けた以内）

bb…bb

件数（10進数16けた以内。-cを省略した場合は16けた固定）

cc…cc

平均（10進数16けた以内。-cを省略した場合は16けた固定）

dd…dd

最大値（10進数16けた以内。-cを省略した場合は16けた固定）

ee....ee

最小値（10進数16けた以内。-cを省略した場合は16けた固定）

出力メッセージ

メッセージID

内容

出力先

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95440-I

ヘルプ表示

標準出力

KFSE95451-E

コマンド失敗

標準エラー出力

注意事項

平均値は小数点以下を切り捨てて出力します。

4.3.13　estrbstced（システム統計情報のファイル編集）

目的

システムテスト支援の稼働状況を調査するために、指定されたシステム統計情報ファイルを編集し、標準出力、またはcsvファイルに出力します。

形式

estrbstced  [-e 編集種別]
            [-t [開始時刻][,終了時刻]]
            [-i　時間間隔]
            [-s [開始編集ID][,終了編集ID]]
            [-c　csv出力ファイル名]
            システム統計情報ファイル名[システム統計情報ファイル名…]

機能

指定されたファイルのシステム統計情報を編集し、標準出力に出力します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウント、または一般ユーザで実行できます。

オプション

-e　編集種別　≪sys≫

編集種別を指定します。

sys：システム統計情報を編集出力します。

f ：ファイル情報一覧を出力します。

「f」を指定した場合は、システム統計情報ファイル名だけ指定できます。

他のオプションを指定できません。

-t　[開始時刻][,終了時刻]

編集する出力範囲を指定します。開始時刻、および終了時刻は、1971年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

「-t」オプションを指定する場合は、開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると、システム統計情報ファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると、指定した開始時刻からシステム統計情報ファイルの最後までが、出力範囲になります。

システム統計情報開始時刻、および終了時刻は、[[YYYY]MMDD]hhmmssの形式で指定します。

-

意味

指定値範囲

省略可否

YYYY

年（西暦）

1971〜9999

省略可（※）

MM

月

01〜12

省略可（※）

DD

日

01〜31

省略可（※）

hh

時

00〜23

省略不可

mm

分

00〜59

省略不可

ss

秒

00〜61

省略不可

※：開始時刻、または終了時刻の省略時は以下の様に扱います。

「年」の指定を省略した場合

当年の指定月日時刻とみなします。

「年、月、日」の指定を省略した場合

当年当月当日の指定時刻とみなされます。

「月、日」、「月」、または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は、「年」、「月」、「日」のすべてを省略してください。

-tオプションの指定を省略すると、指定したファイル内のすべての情報を編集、出力します。

-i　時間間隔 ≪h01≫

システム統計情報を編集出力する間隔を、時間間隔、分間隔、または秒間隔で指定します。

h[HH]

時間間隔（01≦HH≦24）で出力します。

HHの指定を省略すると、1時間間隔で出力します。

m[MM]

分間隔（01≦MM≦30）で出力します。MMの指定を省略すると、10分間隔で出力されます。

s[SS]

秒間隔（01≦SS≦30）で出力します。

秒間隔のSSの指定を省略すると、10秒間隔で出力されます。

時間、分、秒間隔を複数指定すると、エラーとなります。

「-i」オプションの指定を省略すると、1時間間隔で出力されます。

システムテスト支援定義statistical_information -u interval_time定義に設定するシステム統計情報出力間隔より大きい値を指定することをお奨めします。システム統計情報出力間隔間隔以下の値を設定すると、該当データなしと出力される時間帯が多くなります。

-s [開始編集ID][,終了編集ID]

編集出力するシステム統計情報の編集IDを指定します。編集IDについては、「9.4　システム統計情報機能の概要」を参照してください。

-sオプションを指定する場合は、開始編集IDまたは終了編集IDのどちらか一方を必ず指定してください。

開始編集IDだけ指定すると、開始編集ID以上のシステム統計情報を出力します。

終了編集IDだけ指定すると、終了編集ID以下のシステム統計情報を出力します。

開始編集ID、終了編集IDともに指定する場合は、開始編集ID以上、終了編集ID以下のシステム統計情報を出力します。「開始編集ID≦終了編集ID」となるように指定してください。

-sオプションの指定を省略すると、すべてのシステム統計情報を編集出力します。

-c csv出力ファイル名～＜1024文字以内のパス名＞

Windows版では〈259文字以内のパス名〉で指定します。

システム統計情報の編集結果をcsv形式で出力します。

システム統計情報ファイル名 [システム統計情報ファイル名…]～＜1024文字以内のパス名＞

Windows版では〈259文字以内のパス名〉で指定します。

編集するファイル名を指定します。-eオプションにfを指定した場合は、最大1024個ファイル名を指定できます。

指定できるオプションの組み合わせを以下に示します。

表4‒8　オプションの組み合わせ

オプション

-e

-t

-i

-s

-c

ファイル指定

sys

f

単一

複数

-e

sys

−

×

○

○

○

○

○

×

f

×

−

×

×

×

×

○

○

-t

○

×

−

○

○

○

○

×

-i

○

×

○

−

○

○

○

×

-s

○

×

○

○

−

○

○

×

-c

○

×

○

○

○

−

○

×

ファイル指定

単一

○

○

○

○

○

○

−

−

複数

×

○

×

×

×

×

−

−

凡例

○：指定できる

×：指定できない

−：該当しない

出力形式

-eにsysを指定した場合

-cを指定しない場合

日本語の場合

*******    統計情報    バージョン(aa-aa-aa)  *******
出力指定：bb…bb
ファイル名：cc…cc
ファイル作成日付：dddd/dd/dd dd:dd:dd ddd.ddd
ファイル作成バージョン：e1-e1-e1
ファイルタイプ：a1
テスト識別子：ff…ff
ランＩＤ：0xgggggggg

*****  システム統計情報  *****
*****  編集対象時間 hhhh/hh/hh hh:hh:hh ～ iiii/ii/ii ii:ii:ii *****
 id  イベント(取得値)     イベント数(回)   平均値    最大値    最小値 (単位)  ※1
     ＜jj…jj＞                                  　 　　　　　                ※1
 kkk  ll…ll　　　　　         　 mm…mm   nn…nn   oo…oo    pp…pp (qq…qq) ※1
  ： 　：                           ：      ：        ：        ：      ：    ※1
 システム統計情報破棄数        ：rr…rr（件）

※1 ：

出力範囲の編集対象時間の全システム統計情報を出力するまで繰り返します。

英語の場合

*******    Statistical information    Version (aa-aa-aa )  *******
Specify output:bb…bb
File name:cc…cc
File creation date:dddd/dd/dd dd:dd:dd ddd.ddd
File creation version:e1-e1-e1
File type: TYPE:a1
Test ID:ff…ff
Run ID:0xgggggggg

*****  Statistical system information  *****
*****  Modification target time:hhhh/hh/hh hh:hh:hh to iiii/ii/ii ii:ii:ii *****
 ID  Event (acquisition value)  Event count(times)   Avr     Max     Min  (units)  ※1
      <jj…jj>                                                                     ※1
 kkk  ll…ll                               mm…mm  nn…nn  oo…oo  pp…pp  (qq…qq)※1
  ：    ：                                   ：      ：      ：      ：       ：   ※1
Statistical system information destruction count        :rr…rr（items）

※1：

出力範囲の編集対象時間の全システム統計情報を出力するまで繰り返します。

-cを指定した場合

日本語の場合

“*******    統計情報    バージョン(aa-aa-aa)  *******”
“出力指定：bb…bb”
“ファイル名：cc…cc”
“ファイル作成日付：dddd/dd/dd dd:dd:dd ddd.ddd
“ファイル作成バージョン：e1-e1-e1“
“ファイルタイプ：a1“
“テスト識別子：ff…ff“
“ランＩＤ：0xgggggggg”

“*****  システム統計情報  *****”
“編集対象時間”,”id”,”イベント(取得値)”,                      ※1
 ”イベント数(回)”,”平均値,”最大値”,”最小値”,”(単位)”      ※1
“hhhh/hh/hh hh:hh:hh ～ iiii/ii/ii ii:ii:ii”                     ※1※2
 ,,”＜jj…jj＞”                                                  ※1
  ,kkk,ll…ll,mm…mm,nn…nn,oo…oo,pp…pp,”(qq…qq)”             ※1
  ：
 システム統計情報破棄数        ：rr…rr

※1：

出力範囲の編集対象時間の全システム統計情報を出力するまで繰り返します。

※2：

該当する編集対象時間の先頭行にだけ出力します。

英語の場合

“*******    Statistical information    Version (aa-aa-aa)  *******“
“Specify output:bb…bb“
“File name:cc…cc“
“File creation date:dddd/dd/dd dd:dd:dd ddd.ddd“
“File creation version:e1-e1-e1“
“File type: TYPE:a1“
“Test ID:ff…ff“
“Run ID:0xgggggggg“

“*****  Statistical system information  *****“
“Modification target time“,“ID“,“Event (acquisition value) “,  ※1
“ Event count (times) “, “Avr“,“Max“,“Min“,“(units) “      ※1
“hhhh/hh/hh hh:hh:hh ～ iiii/ii/ii ii:ii:ii”                       ※1※2
 ,,”<jj…jj>”                                                      ※1
 ,kkk,ll…ll,mm…mm,nn…nn,oo…oo,pp…pp,”(qq…qq)”      　　　　  ※1

“Statistical system information destruction count”,“rr…rr”

※1：

出力範囲の編集対象時間の全システム統計情報を出力するまで繰り返します。

※2：

該当する編集対象時間の先頭行にだけ出力します。

aa-aa-aa

当該コマンドを実行したシステム検証支援基盤のバージョン

bb…bb

本コマンドの引数

cc…cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

当該ファイルに出力を開始した日付　年号/月/日 時間:分:秒 ミリ秒．マイクロ秒

システム統計情報を1件も出力していない場合は、「****/**/** **:**:** ***.***」を出力します。

e1-e1-e1

ファイルを作成したシステム検証支援基盤のバージョン

a1

システム統計情報取得タイプ

ff…ff

テスト識別子（31文字以内）

gggggggg

ランID（16進数8桁）

hhhh/hh/hh　hh:hh:hh

編集対象時間帯の先頭日付　年号/月/日　時間:分:秒

iiii/ii/ii　ii:ii:ii

編集対象時間帯の最終日付　年号/月/日　時間:分:秒

jj…jj

システム統計情報種別

kkk

編集ID（10進数3桁以内）

ll…ll

イベント

出力される内容は、「9.4　システム統計情報機能の概要」を参照してください。

mm…mm

イベント数（10進数16桁以内）

出力対象でない場合は−を表示します。オーバーフローした場合は「*」を表示します。

nn…nn

平均値（10進数16桁以内）

出力対象でない場合は−を表示します。オーバーフローした場合は「*」を表示します

oo…oo

最大値（10進数16桁以内）

出力対象でない場合は「−」を表示します

pp…pp

最小値（10進数16桁以内）

出力対象でない場合は「−」を表示します

qq…qq

平均値、最大値、最小値の単位

rr…rr

全ての出力バッファが使用中となり、その間にシステム統計情報出力要求が発生し、破棄したシステム統計情報数。破棄したシステム統計情報がない場合は出力しません。

-eにfを指定した場合

日本語の場合

*******    統計情報    バージョン(aa-aa-aa)  *******
出力指定：bb…bb
ファイル名：cc…cc                             ※1
ファイル作成日付：dddd/dd/dd dd:dd:dd ddd.ddd  ※1
ファイル作成バージョン：e1-e1-e1               ※1
ファイルタイプ：a1                             ※1
テスト識別子：ff…ff                           ※1
ランＩＤ：0xgggggggg                           ※1

※1：

指定したファイルの数の分だけ繰り返します。統計情報ファイル以外のファイルが指定された場合は、次の形式で出力されます。

ファイル名：cc…cc

統計情報ファイルではありません。

英語の場合

*******    Statistical information     Version (aa-aa-aa)  *******
Specify output:bb…bb
File name:cc…cc                                ※1
File creation date:dddd/dd/dd dd:dd:dd ddd.ddd  ※1
File creation version:e1-e1-e1                  ※1
File type: TYPE:a1                              ※1
Test ID:ff…ff                                  ※1
Run ID:0xgggggggg                               ※1

※1：

指定したファイルの数の分だけ繰り返します。統計情報ファイル以外のファイルが指定された場合は、次の形式で出力されます。なお、この場合もコマンドの終了コードは0です。

File name:cc…cc

This is not a statistical information file.

出力内容は「-e」オプションに「sys」を指定した場合と同です。

出力メッセージ

メッセージID

内容

出力先

KFSE95088-E

コマンド引数が不正です

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95092-E

オプションの組み合わせが不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95405-E ※1

ヘッダ情報不正

標準エラー出力

KFSE95406-E ※1

ブロック不正

標準エラー出力

KFSE95409-E ※1

バージョン不正

標準エラー出力

KFSE95410-E ※1

OPENエラー

標準エラー出力

KFSE95411-E ※1

READエラー

標準エラー出力

KFSE95412-E

WRITEエラー

標準エラー出力

KFSE95413-E ※2

CLOSEエラー

標準エラー出力

KFSE95095-Q

上書き確認

標準出力

KFSE95439-I

ヘルプ表示

標準出力

※1：「-e」オプションに「f」を指定した場合は、このメッセージを出力してもコマンドのexitコードは0になります。

※2：このメッセージを出力してもコマンドのexitコードは0になります。

注意事項

出力するシステム統計情報がない時間帯には、「***** 該当データなし *****」と出力します。

平均値は小数点以下を切り捨てて出力します。

4.3.14　estrbstcfput（システム統計情報の強制出力）

目的

マッピング領域のシステム統計情報をファイルに強制出力します。

障害調査等で至急システム統計情報を編集したい場合などに本コマンドを実行することでマッピング領域の情報がファイル出力されて編集が可能となります。

また、システム統計情報ファイルのバックアップを計画的に行いたい場合などに、本コマンドを実行することでファイルが満杯になる前に出力先ファイルを強制的に切り替えることができます。

形式

estrbstcfput  [-g テスト識別子]
              [-s]

機能

システム統計情報マッピング領域にスタックしているシステム統計情報をファイルに強制出力します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～＜1～31文字の識別子＞《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-s

システム統計情報を出力するファイルを切り替えます。

出力メッセージ

メッセージID

内容

出力先

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95425-I

強制出力コマンドが成功しました

標準出力

KFSE95426-E

強制出力コマンドが失敗しました

標準エラー出力

KFSE95438-I

ヘルプ表示

標準出力

4.3.15　estrbtaskfput（TASKTMの情報強制出力）

目的

マッピング領域のTASKTM情報をファイルに強制出力します。

障害調査等で至急TASKTM情報を編集したい場合などに本コマンドを実行することでマッピング領域の情報がファイル出力されて編集が可能となります。

また、TASKTMファイルのバックアップを計画的に行いたい場合などに、本コマンドを実行することでファイルが満杯になる前に出力先ファイルを強制的に切り替えることができます。

形式

estrbtaskfput [-g テスト識別子]
              [-s]

機能

TASKTMマッピング領域にスタックしているTASKTM情報をファイルに強制出力します。

本コマンドは、Linuxの場合はスーパーユーザー、Windowsの場合はAdministratorsグループに属するユーザアカウントで実行できます。

オプション

-g テスト識別子 ～＜1～31文字の識別子＞《HSIC00》

テスト識別子を指定します。テスト識別子は実行中システムテスト支援のテスト識別子を指定してください。

-s

TASKTM情報を出力するファイルを切り替えます。

出力メッセージ

メッセージID

内容

出力先

KFSE95001-E

現在コマンドを受け付けることができません

標準エラー出力

KFSE95002-E

メモリが確保できません

標準エラー出力

KFSE95003-E

コマンド処理で障害が発生しました

標準エラー出力

KFSE95089-E

コマンドが失敗しました

標準エラー出力

KFSE95090-E

コマンドの形式が不正です

標準エラー出力

KFSE95091-E

フラグ引数が不正です

標準エラー出力

KFSE95093-E

領域の確保に失敗しました

標準エラー出力

KFSE95094-E

内部矛盾が発生しました

標準エラー出力

KFSE95425-I

強制出力コマンドが成功しました

標準出力

KFSE95426-E

強制出力コマンドが失敗しました

標準エラー出力

KFSE95434-I

ヘルプ表示

標準出力

5　システムテスト支援の蓄積ファイル

システムテスト支援の蓄積ファイルについて説明します。

5.1　蓄積ファイル種別

システムテスト支援の蓄積ファイルには以下に示すファイルがあり、それぞれが複数面のファイルで構成されます。蓄積ファイルの概要を以下に示します。

本番用の要求電文蓄積ファイル（以降、要求電文（本番）ファイル）

外部システムから既存システムへの要求電文を蓄積するファイルです。

本番用の応答電文蓄積ファイル（以降、応答電文（本番）ファイル）

既存システムから外部システムへの応答電文を蓄積するファイルです。

テスト用の要求電文蓄積ファイル（以降、要求電文（テスト）ファイル）

システムテスト支援からテスト対象システムへの要求電文を蓄積するファイルです。

テスト用の応答電文蓄積ファイル（以降、応答電文（テスト）ファイル）

テスト対象システムから、システムテスト支援への応答電文を蓄積するファイルです。

図5‒1　蓄積ファイルの概要

5.1.1　蓄積ファイルの使用目的

各蓄積ファイルの使用目的を以下に示します。

表5‒1　各蓄積ファイルの使用目的

蓄積ファイル

使用目的

使用者

要求電文（本番）ファイル

リプレイ実行時、テスト対象システムへの要求電文を作成する際の元データとして使用

システムテスト支援

応答電文（本番）ファイル

リプレイ実行時、テスト対象システムからの応答電文との比較に使用

システムテスト支援

比較エラー時等、電文内容を確認するために使用

ユーザ

要求電文（テスト）ファイル

比較エラー時等、電文内容を確認するために使用

ユーザ

応答電文（テスト）ファイル

比較エラー時等、電文内容を確認するために使用

ユーザ

5.1.2　電文に対応する蓄積ファイル

各蓄積ファイルに格納する電文、実行形態、ラップ属性を以下に示します。

表5‒2　各蓄積ファイルに格納する電文、実行形態、ラップ属性

電文（※1）

格納する蓄積ファイル

（−は格納しない）

実行形態

ラップ

属性

（※2）

蓄積

並行

リプレイ

PCAP

要求電文

外部→既存

要求電文（本番）ファイル

○

−

−

−

なし

既存→外部

−

−

−

−

−

−

HSIC→テスト対象

要求電文（テスト）ファイル

−

△

△

△

あり

テスト対象→HSIC

−

−

−

−

−

−

応答電文

既存→外部

応答電文（本番）ファイル

○

−

−

−

なし

外部→既存

−

−

−

−

−

−

テスト対象→HSIC

応答電文（テスト）ファイル

−

△

△

△

あり

（凡例）

○：電文情報を格納する

△：蓄積ファイル関連定義accumulate_fileコマンド-fオプションのtestuseにYを指定した場合に電文情報を格納する

※1：

外部：外部システム

既存：既存システム

テスト対象：テスト対象システム

HSIC：システムテスト支援

※2：

あり…最大ファイル数を超えて電文が発生した場合、使用済みファイルを上書きする

なし…最大ファイル数を超えて電文が発生した場合、当該システムテスト支援が異常終了する。

蓄積ファイルの作成

蓄積ファイルは、以下のタイミングで作成します。

システムテスト支援の開始時および実行形態追加時

電文情報の出力時にファイルの最大サイズを超えて満杯スワップが発生した場合

蓄積ファイル強制出力コマンド（esaflfput）を実行しコマンドスワップが発生した場合

システムテスト支援の開始

蓄積ファイルが存在しない場合

システムテスト支援を開始または実行形態追加したときに、前回以前のシステムテスト支援で使用した蓄積ファイルが残存しない場合は、ファイル種別毎に1つの蓄積ファイルを作成し使用します。ファイル作成時にはKFSE80910-Iメッセージを出力し、使用する蓄積ファイル情報をユーザに通知します。蓄積ファイルなし時のシステムテスト支援開始／実行形態追加の概要を以下に示します。

図5‒2　蓄積ファイルなし時のシステムテスト支援開始／実行形態追加

蓄積ファイルが存在する場合

システムテスト支援を開始または実行形態追加したときに、前回以前のシステムテスト支援で使用した蓄積ファイルが残存する場合は、ファイル途中からの継続書込みはせず、全ての蓄積ファイルを削除した後に、新たにファイル種別毎に1つの蓄積ファイルを作成し使用します。ファイル作成時にはKFSE80910-Iメッセージを出力し、使用する蓄積ファイル情報をユーザに通知します。

蓄積ファイルが定義指定数ある時のシステムテスト支援開始／実行形態追加の概要を以下に示します。

図5‒3　蓄積ファイルあり時のシステムテスト支援開始／実行形態追加

蓄積ファイルの満杯スワップ

システムテスト支援で電文情報を蓄積ファイルに出力しようとしたときに、各ファイルの最大サイズ（蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfileszで指定した蓄積ファイル最大サイズ）を超える場合、新たに蓄積ファイルを作成し使用します。このように使用するファイルを切り替える動作を満杯スワップと呼びます。満杯スワップ時にはKFSE80911-Iメッセージを出力し、使用する蓄積ファイル情報をユーザに通知します。

応答電文（本番）ファイルが最大サイズを超えた場合の例を以下に示す。

図5‒4　応答電文（本番）ファイルが最大サイズを超えた場合

コマンドスワップ

蓄積ファイル強制出力コマンド（esaflfput）に-sオプションを指定して実行すると、新たに蓄積ファイルを作成し使用します。このように使用するファイルを切り替える動作をコマンドスワップと呼びます。コマンドスワップ時にはKFSE80911-Iメッセージを出力し、使用する蓄積ファイル情報をユーザに通知します。

要求電文（本番）ファイルがコマンドスワップする場合の例を以下に示す。

図5‒5　要求電文（本番）ファイルがコマンドスワップする場合

蓄積ファイルの再使用

テスト用の蓄積ファイルで、既に最大面数（蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfileno指定値）の蓄積ファイルがある状態でファイルスワップが発生すると、世代の若い使用済みの蓄積ファイルを再使用します。

なお、本番用の蓄積ファイルで、既に最大面数（蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfileno指定値）の蓄積ファイルがある状態でファイルスワップが発生すると、システムテスト支援は異常終了します。

要求電文（テスト）ファイルを上書き運用する例を以下に示します。

図5‒6　要求電文（テスト）ファイルを上書き運用

蓄積ファイルの障害

ファイル障害

ファイル作成時に障害を検知した場合、当該システムテスト支援は異常終了します。

ファイル書込み時に障害を検知した場合は、ファイルスワップ（「蓄積ファイルの満杯スワップ」参照）と同様に新規ファイルを作成し使用する、若しくは、ファイルの再使用（「蓄積ファイルの再使用」を参照）をします。

システムテスト支援異常終了

システムテスト支援が異常終了すると、異常終了直前にシステムテスト支援が管理するメモリ（蓄積バッファ）上に一時退避（スタック）された各種電文が、蓄積ファイルに格納させずロストする場合があります。

5.2　蓄積ファイルの運用

5.2.1　蓄積ファイルの構成

蓄積ファイル種別と命名規則

システムテスト支援では、以下に示す蓄積ファイルを使用します。

表5‒3　蓄積ファイルの種別とファイル名

ファイル種別

ファイル名

本番用の要求電文蓄積ファイル

“テスト識別子”＋“req”＋nnnnn（※1）

本番用の応答電文蓄積ファイル

“テスト識別子”＋“rpy”＋nnnnn（※1）

テスト用の要求電文蓄積ファイル

“テスト識別子”＋“reqts”＋nnnnn（※1）

テスト用の応答電文蓄積ファイル

“テスト識別子”＋“rpyts”＋nnnnn（※1）

（※1）nnnnn：00001〜10000

蓄積ファイル格納ディレクトリ

蓄積ファイル関連定義accumulate_fileコマンド-fオプションのdirpath指定を省略し、蓄積ファイル格納ディレクトリを指定しない場合は以下に示すディレクトリに作成されます。

表5‒4　システム定義なし時の蓄積ファイル格納ディレクトリ

ファイル種別

ディレクトリ

本番用の要求電文蓄積ファイル

/opt/HSIC/job/テスト識別子/afile/req/

本番用の応答電文蓄積ファイル

/opt/HSIC/job/テスト識別子/afile/rpy/

テスト用の要求電文蓄積ファイル

/opt/HSIC/job/テスト識別子/afile/reqts/

テスト用の応答電文蓄積ファイル

/opt/HSIC/job/テスト識別子/afile/rpyts/

また、蓄積ファイルを任意のディレクトリに格納することもできます。

任意のディレクトリに格納したい場合は蓄積ファイル関連定義accumulate_fileコマンド-fオプションのdirpathにて格納するディレクトリを指定してください。

なお、dirpathに指定したディレクトリは事前に作成しておいてください。

ディスク分割

外部システム、既存システム、テスト対象システムから発生する単位時間当たりの電文量が非常に多く、蓄積ファイルへの出力が追いつかないと想定される場合は、蓄積ファイルの格納ディレクトリに任意の格納ディレクトリを指定し、各蓄積ファイルを異なるディスクに配置する必要があります。

ディスク分割は電文種別毎に行ってください。システムテスト支援が蓄積実行のみ、並行実行のみ、またはリプレイ実行しているときはディスクを2分割、蓄積実行と並行実行を同時にしているときはディスクを4分割することを推奨します。

蓄積実行のみ実行しディスクを2分割する例、および蓄積実行と並行実行を同時に実行しディスクを4分割する例を次の図に示します。

図5‒7　蓄積実行のみ実行しディスクを2分割

図5‒8　蓄積実行と並行実行を同時に実行しディスクを4分割

5.2.2　蓄積ファイルへの出力タイミング

蓄積ファイルに格納する電文は、システムテスト支援が管理するメモリ（蓄積バッファ）上にスタックします。蓄積バッファのサイズは、蓄積ファイル関連定義accumulate_file -bオプションのsizeで指定したサイズです。

蓄積バッファが満杯になった時点で、蓄積ファイルへ一括出力します。

図5‒9　蓄積ファイルへの出力タイミング

5.2.3　テスト用電文の蓄積ファイルが最大ファイル数に達した場合

テスト用の要求電文蓄積ファイルおよびテスト用の応答電文蓄積ファイルで、使用可能な蓄積ファイルが残り1ファイルとなったときは警告メッセージ（KFSE40911-W）を出力します。その後、当該蓄積ファイルを全て使用した後に格納要求があった場合は、使用済みのファイルを上書き再使用します。テスト用蓄積ファイルの上書き再使用の概要を以下に示します。

図5‒10　テスト用蓄積ファイルの上書き再使用の概要

このため、使用済みのテスト用蓄積ファイルの内容を保持したい場合は、別ファイルにコピーしてください。

5.2.4　本番用電文の蓄積ファイルが最大ファイル数に達した場合

本番用の要求電文蓄積ファイルおよび本番用の応答電文蓄積ファイルで、使用可能な蓄積ファイルを全て使用した後に格納要求があった場合、当該システムテスト支援は異常終了します。

本番用蓄積ファイルの使用概要を以下に示します。

図5‒11　本番用蓄積ファイルの使用概要

5.2.5　蓄積ファイルの状態表示

次のような場合、esaflfillsコマンドで蓄積ファイル一覧、または蓄積ファイルの内容を表示することができます。

蓄積ファイルに格納した電文情報を参照したいとき

蓄積ファイルに格納した電文の内容を参照したいとき

詳細は「4.3.1　esaflfills（蓄積ファイルの内容表示）」を参照してください。

5.2.6　蓄積ファイル強制出力

次のような場合は、esaflfputコマンドでバッファにスタックしている蓄積ファイル情報をファイルに強制的に出力し、出力先のファイルを切り替えることができます。

直前に取得した電文情報を即時に蓄積ファイルに出力したい

ユーザ任意の条件（テスト内容、時刻等）により、蓄積ファイルを変更したい

詳細は「4.3.2　esaflfput（蓄積ファイルの情報強制出力）」を参照してください。

5.2.7　蓄積ファイルの総容量の目安について

蓄積ファイルの種別ごとに総容量を算出するには、次に示す見積もり式を使用してください。

256×10000（指定最大ファイル数）＋（p＋s）×t×h×1.2（安全値）

p

レコードヘッダのサイズ（単位：バイト）

RPCプロトコル：520

上記以外のプロトコル：256

s

1電文（プロトコルヘッダ含む）の平均サイズ（単位：バイト）

t

平均トラフィック

h

システム稼働時間

例えば、RPCとTCPスルーを蓄積し、RPCの1電文の平均サイズが50キロバイトで、平均トラフィックが400TPS、TCPスルーの1電文の平均サイズが1キロバイトで平均トラフィックが1000TPS、システム稼働時間が12時間の場合の総容量を以下に示します。

RPCプロトコルの総容量

（256×10000）＋（520＋50キロバイト）×400×12×60×60×1.2 ≒ 999ギガバイト

TCPスルーの総容量

（256×10000）+（256+1キロバイト）×1000×12×60×60×1.2 ≒ 62ギガバイト

システム全体の総容量

999ギガバイト+62ギガバイト = 1061ギガバイト

5.2.8　テスト開始時の蓄積ファイルの運用

並行実行、蓄積実行、PCAP実行時の蓄積ファイルの運用

並行実行、蓄積実行、またはPCAP実行により蓄積ファイルを使用するときの運用の流れを以下に示します。

図5‒12　並行実行、蓄積実行、PCAP実行時の蓄積ファイルの運用

（A）蓄積ファイルの削除

システムテスト支援の開始または実行形態追加前に前回実行時に取得した蓄積ファイルを削除してください。

残っていたときは、必要に応じて削除しますが、削除に時間がかかる場合があります。

そのため、システムテスト支援の開始が遅れる場合があります。

（B）蓄積ファイルの保存

蓄積ファイルをリプレイ実行や蓄積ファイル内容表示コマンドで使用するために保存したいときは、mvコマンド等でファイル名を変更せずにファイル移動してください。

リプレイ実行時の蓄積ファイルの運用

リプレイ実行により蓄積ファイルを使用するときの運用の流れを以下に示します。

図5‒13　リプレイ実行時の蓄積ファイルの運用

（A）蓄積ファイルの準備

リプレイ実行時の入力となる蓄積ファイル（本番用の要求電文蓄積ファイルと本番用の応答電文蓄積ファイル）を準備してください。

システムテスト支援の開始・終了を繰り返し、複数回分の蓄積ファイルを入力としてリプレイ実行を行うときのディレクトリ構成と定義を以下に示します。

定義で指定されたディレクトリの1階層下のディレクトリ下にある蓄積ファイルまでがリプレイ実行の入力対象となります。

蓄積ファイルのディレクトリ構成

/XXXXXXXX/AA…AA/aa…aa/	本番用の要求電文ファイル格納ディレクトリ1
/XXXXXXXX/AA…AA/bb…bb/	本番用の要求電文ファイル格納ディレクトリ2
　　　　　：
/XXXXXXXX/BB…BB/cc…cc/	本番用の応答電文ファイル格納ディレクトリ1
/XXXXXXXX/BB…BB/dd…dd/	本番用の応答電文ファイル格納ディレクトリ2
　　　　　：

システム定義

accumulate_reply_file -t REQ -f "dirpath=/XXXXXXXX/AA…AA"
accumulate_reply_file -t RPY -f "dirpath=/XXXXXXXX/BB…BB"

本番用の要求電文ファイルのディレクトリ構成の例

2014/01/01に取得した本番用の要求電文ファイル

/XXXXXXXX/req/20140101/テスト識別子req00001
                          ：
/XXXXXXXX/req/20140101/テスト識別子reqnnnnn

2014/01/02に取得した本番用の要求電文ファイル

/XXXXXXXX/req/20140102/テスト識別子req00001
                          ：
/XXXXXXXX/req/20140102/テスト識別子reqnnnnn

本番用の応答電文ファイルのディレクトリ構成の例

2014/01/01に取得した本番用の応答電文ファイル

/XXXXXXXX/rpy/20140101/テスト識別子rpy00001
                          ：
/XXXXXXXX/rpy/20140101/テスト識別子rpynnnnn

2014/01/02に取得した本番用の応答電文ファイル

/XXXXXXXX/rpy/20140102/テスト識別子rpy00001
                          ：
/XXXXXXXX/rpy/20140102/テスト識別子rpynnnnn

システム定義の例

accumulate_reply_file -t REQ -f "dirpath=/XXXXXXXX/req"
accumulate_reply_file -t RPY -f "dirpath=/XXXXXXXX/rpy"

（B）蓄積ファイルの削除

システム定義の蓄積ファイル関連定義accumulate_fileコマンドの-fオプションのtestuseにYを指定してテスト用の電文情報を蓄積ファイルに取得する場合は、システムテスト支援の開始前に前回実行時に取得したテスト用の蓄積ファイルを削除してください。前回の実行時に取得したテスト用蓄積ファイルが残っていた場合は、必要に応じて削除しますが、削除に時間がかかる場合があります。

（C）蓄積ファイルの保存

蓄積ファイルを蓄積ファイル内容表示コマンドで使用するために保存したいときは、mvコマンド等でファイル名を変更せずにファイル移動してください。

別のテスト識別子で取得した蓄積ファイルを使用したリプレイ実行の運用

別のテスト識別子で蓄積実行により取得した蓄積ファイルを使用してリプレイ実行を行うときの運用の流れを以下に示します。

図5‒14　蓄積ファイル名を変更してリプレイ実行するときの運用

（A）蓄積ファイルの準備

リプレイ実行の入力となる蓄積ファイル（本番用の要求電文蓄積ファイルと本番用の応答電文蓄積ファイル）のファイル名を変更します。蓄積ファイル名の命名規則については、「5.2.1　蓄積ファイルの構成」の「蓄積ファイル種別と命名規則」を参照してください。蓄積ファイル名を変更するときは、テスト識別子以外は変更しないでください。

蓄積ファイル名の変更例を以下に示します。

図5‒15　蓄積ファイル名の変更

（B）蓄積ファイルの削除

蓄積ファイルの削除については「リプレイ実行時の蓄積ファイルの運用」を参照してください。

（C）蓄積ファイルの保存

蓄積ファイルの保存については「リプレイ実行時の蓄積ファイルの運用」を参照してください。

5.3　比較エラー情報ファイルの運用

比較エラー情報ファイルは、既存システム、テスト対象システムからの応答電文をプロトコルレベルで比較した結果が不一致となったときや応答電文がエラー応答のとき、およびデータ比較UOC／結果判定UOCにおいてユーザレベルで比較した結果が不一致となったときの情報をエラー情報として取得します。

蓄積ファイルを取得しているときは、エラー情報を元に、蓄積ファイル内容表示コマンド（esaflfills）を実行することで、不一致となった応答電文や対応する要求電文の内容を確認することができます。

5.3.1　比較エラー情報ファイルの形式

比較エラー情報ファイルは、csvファイルです。比較エラー情報ファイル内のエラー情報は、テキストエディタなどで参照できます。

比較エラー情報ファイルの形式を以下に示します。

"aa…aa bb…bb cccc/cc/cc cc:cc:cc ccc.ccc dd…dd"                                  ※1
"TIME","PROTOCOL TYPE","KEY","REQUEST RECEIVE TIME",                                ※2
"REPLY RECEIVE TIME","REQUEST SEND TIME(TEST)","REPLY RECEIVE TIME(TEST)",          ※2
"ERROR TYPE","SRV-GROUP","SRV-SERVICE","RETURN CODE","RETURN CODE(TEST)",           ※2
"RETURN CODE(UOC)","DETAIL INFORMATION"                                             ※2
"AAAA/AA/AA AA:AA:AA AAA.AAA","PPP","BB…BB","CCCC/CC/CC CC:CC:CC CCC.CCC",         ※3
"DDDD/DD/DD DD:DD:DD DDD.DDD","EEEE/EE/EE EE:EE:EE EEE.EEE",                        ※3
"FFFF/FF/FF FF:FF:FF FFF.FFF","GG…GG"," HH…HH","II…II",                          ※3
"JJ…JJ","KK…KK","LL…LL","MM…MM"                                                 ※3
：

※1、※2：

ヘッダ行

※3：

エラー情報の数

aa…aa

システム検証支援基盤の製品形名

bb…bb

システム検証支援基盤のバージョン

cccc/cc/cc cc:cc:cc ccc.ccc

ファイル作成日時

年/月/日△時:分:秒△ミリ秒.マイクロ秒の形式で出力します。

dd…dd

テスト識別子名

AAAA/AA/AA AA:AA:AA AAA.AAA

エラー情報を出力した時刻

年/月/日 時/分/秒△ミリ秒.マイクロ秒の形式で出力します。

PPP

プロトコル種別

RPC …… RPC・RAPプロトコル

TCP …… TCPプロトコル

HTTP…… HTTPプロトコル

IIOP …… IIOPプロトコル

BB…BB

電文キー（64文字）

外部システムから要求電文を受信したときに採番するシステムテスト支援内で一意となる電文のキー

CCCC/CC/CC CC:CC:CC CCC.CCC

外部システムから要求電文を受信した時刻

年/月/日△時:分:秒△ミリ秒.マイクロ秒の形式で出力します。

DDDD/DD/DD DD:DD:DD DDD.DDD

既存システムから応答電文を受信した時刻※4

年/月/日△時:分:秒△ミリ秒.マイクロ秒の形式で出力します。

プロトコル種別がRPCで応答電文が存在しないときは、タイムアウト等エラーを検知した時刻を出力します。

EEEE/EE/EE EE:EE:EE EEE.EEE

テスト対象システムへ要求電文を送信した時刻※4

年/月/日△時:分:秒△ミリ秒.マイクロ秒の形式で出力します。

FFFF/FF/FF FF:FF:FF FFF.FFF

テスト対象システムから応答電文を受信した時刻※4

年/月/日△時:分:秒△ミリ秒.マイクロ秒の形式で出力します。

プロトコル種別がRPCで応答電文が存在しないときは、タイムアウト等エラーを検知した時刻を出力します。

GG…GG

エラー要因

PROTOCOL ……… プロトコルレベルで不一致（正常応答の場合のみ）

USER …………… データ比較UOC／結果判定UOCで不一致

PROD-REPLY …… 既存システムからの応答電文だけ存在

TEST-REPLY …… テスト対象システムからの応答電文だけ存在

NO-REPLY ……… 既存システム、及びテスト対象システムからの応答電文が存在しない

ERROR…………… 既存システム、またはテスト対象システムからの応答電文がエラー応答

HH…HH

要求先のサービスグループ名（31文字以内）　※1 ※3

II…II

要求先のサービス名（31文字以内）　※1 ※3

JJ…JJ

既存システムからの応答電文のリターン値（10進数）　※2 ※5

KK…KK

テスト対象システムからの応答電文のリターン値（10進数）　※2 ※5

LL…LL

データ比較UOC／結果判定UOCのユーザ情報コード（10進数）

エラー要因がPROTOCOLのときは、製品情報を出力します。エラー要因がUSER/PROTOCOL以外のときは、「-」を出力します。

MM…MM

データ比較UOC／結果判定UOCのユーザ情報文字列（最大255バイト）

データ比較UOC／結果判定UOCで設定したユーザ情報文字列をnull文字の前まで表示します。

エラー要因がPROTOCOLのときは、製品情報を出力します。エラー要因がUSER/PROTOCOL以外、又はユーザ情報文字列の設定がないときは、「-」を出力します。

※1

テスト対象システムへの送信に失敗した場合、および送信編集UOCの処理の結果送信しなかった場合には「-」を出力します。

※2

対象となる電文が存在しない場合には「-」を出力します。

※3

プロトコル種別がRPC以外のときは「-」を出力します。

※4

対象となる電文が存在しない場合には「----/--/-- --:--:-- ---.---」を出力します。

※5

プロトコル種別がTCPのときは「-」を出力します。

5.3.2　比較エラー情報ファイルの容量設定

比較エラー情報ファイルは、データ比較に関する定義のfileszに指定したサイズで、システムテスト支援のプロセス毎にUNIXファイルとして作成します。

プロセスごとに、データ比較に関する定義のfilenoで指定した数の比較エラー情報ファイルが作成され、ラウンドロビン方式で使用します。

比較エラー情報ファイルのサイズ及びファイル数は、応答電文が不一致となる回数および頻度に依存することを考慮して、必要に応じて指定してください。

データ比較に関する定義、filenoの詳細は「3.8　比較エラー情報ファイルに関する定義（compare_error_file）」を参照してください。

5.3.3　比較エラー情報ファイルの作成

比較エラー情報ファイルは、システムテスト支援の起動時に作成します。

したがって、管理者は、比較エラー情報ファイルを作成する必要はありません。

格納ディレクトリ

/opt/HSIC/job/ XX…XX /spool/dceeinf/cmp/XX…XXerrnnn

XX…XX ：テスト識別子名

比較エラー情報ファイル名

XX…XXerrnnn

XX…XX ：テスト識別子名

err：比較エラー情報ファイルを示す固定文字列

nnn：比較エラー情報ファイルのID 〜((001〜100))

5.3.4　比較エラー情報ファイルの削除

システムテスト支援の起動時に、前回のシステムテスト支援稼働時の比較エラー情報ファイルが存在する場合、最も古い比較エラー情報ファイルの内容を初期化したあとに上書きして再利用します。

したがって、管理者は比較エラー情報ファイルを削除する必要はありません。

5.3.5　比較エラー情報ファイルの保存

出力中の比較エラー情報ファイルのサイズが、データ比較に関する定義のfileszの指定値を超えた場合、出力先が新しい比較エラー情報ファイルに切り替わります。

このとき、出力先が新しい比較エラー情報ファイルに切り替わったことをKFSE80951-Iメッセージで通知します。このメッセージが出力されるタイミングで、比較エラー情報ファイルのバックアップを取得することを推奨します。

比較エラー情報ファイル数が、データ比較に関する定義のfilenoの指定値を超えた場合、最も古い比較エラー情報ファイルにエラー情報を上書きます。古い比較エラー情報ファイルのエラー情報を保存したい場合は、システムテスト支援が上書きする前に管理者がバックアップしてください。

使用中の比較エラー情報ファイルは、移動または削除しないでください。

データ比較に関する定義、filenoの詳細は「3.8　比較エラー情報ファイルに関する定義（compare_error_file）」を参照してください。

5.4　フレームワーク用CSVファイルの運用

システムテスト支援が出力するフレームワーク用のCSVファイルについて説明します。

5.4.1　CSVファイルの構成

ファイル種別と命名規則

システムテスト支援では、以下に示すCSV形式ファイルを作成します。

表5‒5　CSVファイルの種別とファイル名

ファイル種別

ファイル名

電文ファイル

テスト識別子＋tel＋nnnnn※.csv

結果ファイル

テスト識別子＋res＋nnnnn※.csv

注※

nnnnn：00001〜10000

ファイル格納ディレクトリ

CSVファイル関連定義csvfile_definitionコマンド-fオプションのフラグメンバdirpathにてCSVファイルを格納するディレクトリを指定してください。その際、システムの開始前に指定ディレクトリを作成してください。存在しないディレクトリを指定してシステムを開始できません。

最大行数の決定

CSVファイルに電文情報を格納するとき、CSVファイル関連定義csvfile_definitionコマンド-fオプションのフラグメンバlinenoで指定した1ファイルの最大行数を超えてしまう場合は、ファイルスワップして新しく作成したファイルに電文情報を格納します。新しく作成できるCSVファイルの最大面数は、CSVファイル関連定義csvfile_definitionコマンド-fオプションのフラグメンバfileno指定数となります。

CSVファイルの概要を以下に示します。CSVファイルに出力できる情報の最大量は最大行数×最大面数となります。

図5‒16　CSVファイルの概要

5.4.2　CSVファイルの作成

CSVファイルは、以下のタイミングで作成されます。

システムテスト支援の開始時

電文情報の出力時にファイルの最大行数を超えたことによる満杯スワップの発生時

5.4.3　CSVファイルの総容量の目安

システムテスト支援で必要な総容量は、「最大サイズ×最大面数」で定義します。総容量の算出には以下の見積もり式を使用してください。

a × b × c × 1.2（安全値）

a：最大面数

b：1行の平均サイズ（単位：バイト）

c：最大行数

例えば、最大面数1000面、実際に出力される1行（http部、データ部合計）の平均1024バイト、最大50000行とした場合の最大ディスク使用量は以下になります。

1024 × 50000 × 1000 × 1.2 ＝ 61440000000

＝ 57ギガバイト

5.4.4　CSVファイルの運用

蓄積／PCAP実行時のCSVファイルの運用

蓄積/PCAP実行によりCSVファイルを作成するときの運用の流れを以下に示します。

図5‒17　蓄積／PCAP実行時のCSVファイルの運用

（A）CSVファイルの削除

システムテスト支援の開始前に前回実行時に取得したCSVファイルを削除または別ディレクトリに移動してください。電文ファイルが残っていたときは削除しますが、削除に時間がかかる場合があります。

（B）CSVファイルの保存

CSVファイル（電文ファイル）をリプレイ実行で使用するために保存したいときは、mvコマンド等でファイル名を変更せずに別ディレクトリに移動してください。ファイルを移動せずに、前回の蓄積/PCAP実行時と同じテスト識別子、定義でシステムテスト支援の別プロセスを蓄積/ PCAP実行モードで起動した場合、電文ファイルは削除されます。

リプレイ実行時のCSVファイルの運用

リプレイ実行によりCSVファイルを使用するときの運用の流れを以下に示します。

図5‒18　リプレイ実行時のCSVファイルの運用

（A）CSVファイルの準備

-tオプションにtelegramを指定したCSVファイル関連定義csvfile_definitionコマンドのdirpathで指定したディレクトリ下に、リプレイ実行対象とするCSVファイルを格納してください。対象のCSVファイルは、蓄積/PCAP実行で作成したCSVファイルおよび作成したCSVファイルの任意要素を書き換えまたは変数化したファイルです。

（B）CSVファイルの削除

CSVファイル関連定義csvfile_definitionコマンドの-tオプションにresultを指定しCSVファイルの蓄積を行う場合、システムテスト支援の開始前に前回実行時に取得した結果ファイルを削除してください。結果ファイルが残っていたときは削除しますが、削除に時間がかかる場合があります。

（C）CSVファイルの保存

CSVファイル（結果ファイル）を保存したいときは、mvコマンド等でファイル名を変更せずに別ディレクトリに移動してください。ファイルを移動せずに、前回のリプレイ実行時と同じテスト識別子、定義でシステムテスト支援の別プロセスをリプレイ実行形態で起動した場合、結果ファイルは削除されます。

5.4.5　CSVファイルの内容

電文ファイル

本番環境から取得した電文を格納するファイルです。電文作成フェーズで電文を格納し、テスト実行フェーズで電文を取得します。ファイルの種類として、蓄積ファイルとCSVファイルの2種類があり、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で選択します。CSVファイルは、テスト対象プロトコルがHTTP単体の場合のみ選択できます。それ以外のプロトコルが含まれる場合はHSICの起動が失敗します。

CSVファイル形式の電文ファイルは1HTTP電文が1行となります。HTTP電文に含まれる文字によっては、エディタでファイルが正しく表示されない場合があります。そのような場合は、csvfile_definitionの-cオプションのcsv_to_mem及びmem_to_csvフラグメンバにより、表示可能な別文字へ置換してください。

電文ファイルの項目は以下の通りです。

#Time

Client

Server

Type

EXT1

EXT2

HeadData

BodyData

表5‒6　電文ファイルの項目

項目

説明

#Time

電文をキャプチャした時刻。

テスト実行フェーズで逐次事項モードの場合、この時刻が送信間隔制御で使用されます。時刻未設定時は即時に電文送信します。

yyyy/MM/dd hh:mm:ss tttttt

yyyy：年

MM：月

dd：日

hh：時刻

mm：分

ss：秒

tttttt：マイクロ秒

Client

本番環境の外部システムのIPアドレスとポート番号。以下の形式となります。

IPアドレス△ポート番号

Server

本番環境の既存システムのIPアドレスとポート番号。形式は「Client」と同様です。

Type

HTTP電文種別。以下の何れかになります。

REQ：クライアントがサーバに送信した要求電文

RSP：サーバがクライアントに送信した応答電文

EXT1 ※

プラグインが任意で使用できる拡張情報1。電文作成フェーズの電文編集プラグインで値を設定します。値を設定した場合、テスト実行フェーズの電文情報内の拡張情報1として、設定値が参照できます。

EXT2 ※

プラグインが任意で使用できる拡張情報2。電文作成フェーズの電文編集プラグインで値を設定します。値を設定した場合、テスト実行フェーズの電文情報内の拡張情報2として、設定値が参照できます。

HeadData

HTTPヘッダ部の内容。

BodyData

HTTPデータ部の内容。

注※

開始終了プラグインによりタイトル名を変更可能です。

結果ファイル

テスト実行結果を格納するファイルです。テスト実行フェーズで電文毎に結果を格納します。ファイルの種類として、蓄積ファイルとCSVファイルの2種類があり、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で選択します。CSVファイルは、テスト対象プロトコルがHTTP単体の場合のみ選択できます。それ以外のプロトコルが含まれる場合はHSICの起動が失敗します。

CSVファイル形式の結果ファイルは1HTTP電文が1行となります。HTTP電文に含まれる文字によっては、エディタでファイルが正しく表示されない場合があります。そのような場合は、csvfile_definitionの-c csv_to_mem及びmem_to_csvにより、表示可能な別文字へ置換してください。

結果ファイルの項目は以下の通りです。

#Time

Client

Server

Type

EXT1

EXT2

Test

Time

Client

ID

Error

Type

Return

Code

Detail

Information

Head

Data

Body

Data

表5‒7　結果ファイルの項目

項目

説明

#Time

電文の送受信時刻。

yyyy/MM/dd hh:mm:ss tttttt

yyyy：年

MM：月

dd：日

hh：時刻

mm：分

ss：秒

tttttt：マイクロ秒

Client

HSICのIPアドレスとポート番号。以下の形式となります。

IPアドレス△ポート番号

Server

テスト環境のサーバのIPアドレスとポート番号。形式は「Client」と同様です。

Type

HTTP電文種別。以下の何れかとなります。

REQ：HSICがテスト環境のサーバに送信した要求電文

RSP：テスト環境のサーバがHSICに送信した応答電文

EXT1 ※

プラグインが任意で使用できる拡張情報1。テスト実行フェーズの電文編集プラグインで値を設定します。

EXT2 ※

プラグインが任意で使用できる拡張情報2。テスト実行フェーズの電文編集プラグインで値を設定します。

TestTime

応答電文の場合は、要求電文送信から応答電文受信までの経過時間（マイクロ秒精度）。要求電文の場合は0固定。経過時間が4294967295マイクロ秒を超過する場合は4294967295を表示します。

ClientID

クライアント識別子（16バイト）を16進数で表示します。

ErrorType

テスト結果。以下のいずれかとなります。

OK：テスト成功

NG-FRAMEWORK：テスト失敗（フレームワークで失敗検知）

NG-PLUGIN：テスト失敗（プラグインで失敗検知）

ReturnCode

[テスト結果がOK、又は、NG-FRAMEWORKの場合]

“0”固定

[テスト結果がNG-PLUGINの場合]

結果判定プラグインが設定したuser_code値

DetailInformation

[テスト結果がOKの場合]

“-”固定

[テスト結果がNG-FRAMEWORKの場合]

SEND_CONNECTION：テスト対象システムへのコネクション確立失敗により要求電文が送信できなかった

SEND_CANCEL：電文送信プラグインにより要求電文の送信がキャンセルされた

SEND_ERROR：テスト対象システムへの要求電文の送信中に通信障害が発生した

RECV_CONNECTION：テスト対象システムとのコネクションが切断されて応答電文が受信できなかった

RECV_TIMEOUT：応答電文の受信待ちタイムアウトが発生した

PLUGIN-ERROR：結果判定プラグインが不正な値を返却

LISTEN_PORT：LISTENオープン失敗（RPCだけ）

SEND_NOTCONNECTION：常設コネクション確立失敗（RPCだけ）

[テスト結果がNG-PLUGINの場合]

結果判定プラグインが設定したuser_info値

HeadData

HTTPヘッダ部の内容。

BodyData

HTTPデータ部の内容。

注※

開始終了プラグインによりタイトル名を変更可能です。

5.4.6　注意事項

電文作成フェーズ実行中にCSVファイル（電文ファイル）が最大面数に達し、使用可能なCSVファイルを全て使用した後に格納要求があった場合、システムテスト支援はダウンします。

テスト実行フェーズ実行中にCSVファイル（結果ファイル）が最大面数に達し、使用可能なCSVファイルを全て使用した後に格納要求があった場合、使用済みのCSVファイルを上書き再使用します。このため、使用済みのCSVファイルの内容を保持したい場合は、CSVファイルを全て使用する前に別ファイルにコピーしてください。

5.5　電文ファイルの再読み込み

5.5.1　pcap形式ファイルの再読込み

負荷テストなどでテスト対象システムへ送信する電文データを増加させたい場合は、pcap形式ファイルの読込み完了後にファイルの先頭から再読込みを行うことで電文データの追加が可能です。

pcap形式ファイルの再読込み回数は、capture_definitionの-r read_countオペランドで指定します。指定値が1の場合は再読込みを行いません。

キャプチャ対象のpcap形式ファイルが複数存在する場合は、すべてのファイルの読込みが完了したあとに再読込みを行います。テスト対象範囲の時間が指定されている場合は、指定範囲内のパケットの読込みが完了した時点で再読込みを行います。

システム検証支援基盤は、再読込み分のキャプチャ時刻に、最後に処理したパケットのキャプチャ時刻よりあとの時刻を割り振ります。また、再読込み開始時には、既存システム側の組み立て中のパケットをすべて破棄します。

図5‒19　pcap形式ファイルの再読込み

図5‒20　pcap形式ファイルの再読込み（テスト対象範囲指定あり）

5.5.2　蓄積ファイルの再読込み

負荷テストなどでテスト対象システムへ送信する電文データを増加させたい場合は、蓄積ファイルの読込み完了後にファイルの先頭から再読込みをすることで、電文データを追加できます。

蓄積ファイルの再読込み回数は、accumulate_reply_fileの-r read_countオペランドで指定します。指定値が1の場合は再読込みを行いません。

リプレイ実行対象の蓄積ファイルが複数存在する場合は、すべてのファイルの読込みが完了したあとに再読込みを行います。

テスト対象範囲の時間が指定されている場合は、指定範囲内の要求電文/応答電文の読込みが完了した時点で再読込みを行います。

システム検証支援基盤は、再読込み分の時刻に、処理した要求電文/応答電文の最大時刻よりあとの時刻を割り振ります。また、再読込み開始時には、既存システム側の組み立て中の要求電文/応答電文をすべて破棄します。

図5‒21　蓄積ファイルの再読込み（テスト対象範囲指定なし）

図5‒22　蓄積ファイルの再読込み（テスト対象範囲指定あり）

5.5.3　CSVファイルの再読込み

負荷テストなどでテスト対象システムへ送信する電文データを増加させたい場合は、CSVファイルの読込み完了後にファイルの先頭から再読込みをすることで、電文データを追加できます。

CSVファイルの再読込み回数は、csvfile_definitionの-r read_countオペランドで指定します。指定値が1の場合は再読込みを行いません。

テスト実行フェーズで、CSVファイルが複数存在する場合は、すべてのファイルの読込みが完了したあとに再読込みを行います。

テスト対象範囲の時間が指定されている場合は、指定範囲内の要求電文/応答電文の読込みが完了した時点で再読込みを行います。

システム検証支援基盤は、再読込み分の時刻に、処理した要求電文/応答電文の最大時刻よりあとの時刻を割り振ります。また、再読込み開始時には、既存システム側の組み立て中の要求電文/応答電文をすべて破棄します。

図5‒23　CSVファイルの再読込み（テスト対象範囲指定なし）

図5‒24　CSVファイルの再読込み（テスト対象範囲指定あり）

6　システムテスト支援のUOC

システムテスト支援のUOCについて説明します。

6.1　UOCの位置づけ

以下にシステムテスト支援のUOCの位置付けを示します。

図6‒1　システムテスト支援のUOCの位置付け

図6‒2　蓄積ファイル内容表示コマンドのUOCの位置付け

6.2　各プロトコルで使用可能なUOCインタフェース

プロトコル毎に使用可能なUOCインタフェースは異なります。

以下に、プロトコル別のUOC使用可否を示します。

表6‒1　各プロトコルで使用可能なUOCインタフェース

UOC種別

プロトコル

RPC・RAP

TCPスルー

UDPスルー

HTTP

IIOP

開始終了

○

○

○

○

○

入力判定

○

×

×

×

×

蓄積編集

○

×

×

×

×

送信編集

○

×

×

×

×

データ比較

○

×

×

×

×

受信電文

○

×

×

×

×

蓄積ファイル内容表示コマンド起動

○

×

×

×

×

蓄積ファイル内容表示コマンドデータ編集

○

×

×

×

×

蓄積ファイル内容表示コマンド終了

○

×

×

×

×

（凡例）

○：使用可

×：使用不可

6.3　ユーザオウンコーディング（UOC）の作成

システムテスト支援で使用するUOCの作成手順を以下に示します。

図6‒3　UOCの作成手順

図6‒4　UOCの作成手順（媒体）

6.3.1　ユーザオウンコーディング（UOC）のコーディング

ユーザオウンコーディング（UOC）のコーディングにはC言語を使用し、ANSI C形式に従ってコーディングしてください。

ユーザオウンコーディング（UOC）をコーディングしてソースファイルを作成するとき、OSの標準機能を使うことができます。

また、コーディング時は以下のコーディング規約に従ってください。

UOCでメイン関数を作成しないでください。

"ee"または"es"で始まる名称を使用しないでください。

どのシグナルに対しても操作をしないでください。

（Cライブラリ関数などでも、シグナルを操作する関数は発行しないでください）

マルチスレッドで動作するよう作成してください。

6.3.2　翻訳と結合

ソースファイルをコンパイルして、UOCオブジェクトファイルを作成します。

コンパイルして作成した各UOCオブジェクトファイルをリンケージして、UOCライブラリを作成します。

コンパイルオプション、及びリンケージオプションについては、システムテストのサンプル（makefile）を参照してください。

6.3.3　システムテスト支援でのUOCの実行

環境設定

作成したUOCライブラリをシステムテスト支援で使えるように、次のとおり環境設定します。

格納ディレクトリ

任意のディレクトリに格納します。

システムテスト支援への登録

ユーザオウンコーディングのUOCライブラリ名およびUOCエントリポインタ名を以下のシステム定義（UOC関連定義）に設定してください。

UOCライブラリ名

定義名：module

（「3.12.4　UOCの共用ライブラリに関する定義（module）」を参照）

UOCのエントリポインタ名

定義名：uoc_func_com、またはuoc_func_rpc

（「3.12.1　プロトコル共通UOCに関する定義（uoc_func_com）」および「3.12.2　RPCのUOCに関する定義（uoc_func_rpc）」を参照）

システムテスト支援の実行

esstartコマンドを実行します。定義で指定したUOCが実行されます。

6.3.4　運用コマンド（esaflfills）でのUOCの実行

ユーザオウンコーディングのUOCライブラリ名、及びUOCのエントリポインタ名をesaflfillsコマンド引数に指定して下さい。

コマンド引数で指定したUOCが実行されます。

6.4　UOCの詳細

6.4.1　開始終了UOC

機能

システムテスト支援の開始・終了時、およびコマンドによる実行形態の追加・削除時にUOCを実行します。

形式

ANSI C、C++の形式

#include <escom.h>
ESLONG uoc_func(ESSTENINTERFACE *parm)

説明

システムテスト支援を開始・終了、または実行形態を追加・削除する時に呼び出されるUOCです。システムテスト支援は、各情報を格納したパラメタの領域アドレスを引数としてUOCに渡します。

システムテスト支援は、uoc_func（開始終了UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

パラメタの内容

ESSTENINTERFACEのパラメタ内容

typedef struct es_sten_interface {
  char     testid[32];  ……… テスト識別子
  ESULONG  call_timing; ……… 呼び出しタイミング
  ESULONG  run_mode;    ………実行形態
  ESULONG abort_code; ………強制停止理由コード
  char     reserve1[20];……… 予備領域
  } ESSTENINTERFACE;

システムテスト支援が設定するパラメタ項目

testid

システムテスト支援開始時に指定したテスト識別子を設定します。

call_timing

呼び出しタイミングを設定します。

ES_PROC_ST：プロセス開始時

ES_PROC_EN：プロセス終了時

ES_MODE_AD：実行形態追加時

ES_MODE_DL：実行形態削除時

run_mode

実行形態を設定します。実行形態が複数の場合は論理和で設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

呼び出しタイミングがプロセス開始、実行形態追加、実行形態削除の場合、esstart、esmodadd、

esmoddelコマンドで指定された実行形態を設定します。

呼び出しタイミングがプロセス終了の場合は実行中の実行形態を設定します。

ユーザが設定するパラメタ項目

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定できます。

このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

リターン値

次のコードでリターン値を設定してください。

ES_UOC_OK

正常リターン。処理を続行します。

ES_UOC_NG

異常リターン。呼び出しタイミングに応じて異常処理を行います。

プロセス開始時

異常終了します。

プロセス終了時

処理を続行します。（ES_UOC_OKとして扱います）

実行形態追加／実行形態削除時

実行形態の追加、または削除を中止します。

ES_UOC_ABORT

異常リターン。KFSE64109-Eメッセージを出力し、プロセスダウンします。

上記以外

異常リターン。ES_UOC_NGと同じ動作をします。

6.4.2　入力判定UOC

機能

電文入力時にUOCを実行します。入力電文の入力、破棄を選択することができます。

形式

ANSI C、C++の形式

#include <esrpc.h>
ESLONG uoc_func(ESRPC_UOC_FILTER_TBL *parm)

説明

電文入力時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します。

表6‒2　入力判定UOC実行比較

-

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

並行実行

○

×

×

×

蓄積実行

○

×

×

×

並行＋蓄積実行

○

×

×

×

リプレイ実行

○

×

×

×

PCAP実行

○

×

×

×

凡例

○：UOCが実行される

×：UOCは実行されない

ユーザオウンコーディング（UOC）が起動される入力電文は、RPC電文とRAPのAPI代理実行電文です。

システムテスト支援は、各情報を格納したパラメタの領域アドレスを引数としてUOCに渡します。

システムテスト支援は、uoc_func（入力判定UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

パラメタの内容

ESRPC_UOC_FILTER_TBLのパラメタ内容

typedef struct es_rpc_uoc_filter {
  ESULONG        running_mode;        ……………… 実行形態
  ESLONG         protocol_type;       ……………… プロトコル種別（rpc|rap）
  ESLONG         telegram_type;       ……………… 電文種別
  ESLONG         rpc_model;           ……………… RPC形態
  char           srv_group [32];      ……………… 要求先のサービスグループ名
  char           srv_service [32];    ……………… 要求先のサービス名
  char           srv_nid[5];          ……………… 要求先のノード識別子
  char           reserve1[3];         ……………… 予備領域
  char           clt_nid[5];          ……………… 要求元のノード識別子
  char           reserve2[3];         ……………… 予備領域
  unsigned char  srv_ipaddr[4];       ……………… 要求先のIPアドレス
  unsigned char  clt_ipaddr[4];       ……………… 要求元のIPアドレス
  unsigned short srv_portno;          ……………… 要求先のポート番号
  unsigned short clt_portno;          ……………… 要求元のポート番号
  ESULONG        usr_data_len;        ……………… ユーザデータ長
  char           *usr_data;           ……………… ユーザデータ
}ESRPC_UOC_FILTER_TBL;

受信データアドレスと受信データ長の関係

システムテスト支援が設定するパラメタ項目

running_mode

実行形態を設定します。実行形態が複数の場合は論理和で設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

protocol_type

プロトコル種別を設定します。

ESRPC_TYPE_RPC：rpc

ESRPC_TYPE_RAP：rap

telegram_type

電文種別を設定します。

ESRPC_TELEGRAM_REQUEST：要求電文

rpc_model

RPC形態を設定します。

ESRPC_MODEL_NOFLAGS：同期応答型

ESRPC_MODEL_NOWAIT：非同期応答型

ESRPC_MODEL_NOREPLY：非応答型

srv_group

サーバ側のサービスグループ名（※1）を設定します。

srv_service

サーバ側のサービス名（※1）を設定します。

srv_nid

サーバ側のノードID（※1）を設定します。

clt_nid

クライアント側のノードID（※1）を設定します。

srv_ipaddr

サーバ側のIPアドレス（※2）を設定します。

clt_ipaddr

クライアント側のIPアドレス（※2）を設定します。

srv_portno

サーバ側の受信ポート番号を設定します。

clt_portno

クライアント側の送信ポート番号を設定します。

usr_data_len

電文に設定されているユーザデータ長を設定します。

usr_data

ユーザデータ先頭アドレスを設定します。

※1：

電文中に設定されておらず、取得できない場合は空文字列、または0が設定されています。

※2：

IPアドレスは、次に示す形式で設定します。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0xA5

0x70

0x14

ユーザが設定するパラメタ項目

なし。

リターン値

次のコードでリターン値を設定してください。

ESRPC_UOC_OK

正常リターンとして、対象メッセージを入力電文として処理をします。

ESRPC_UOC_NG

対象メッセージを破棄します。

上記以外

指定リターン値以外でリターンした場合、対象メッセージを破棄します。

注意事項

ユーザデータの内容変更した場合、該当電文の内容、およびその後の処理の保証はしません。

時間の掛かる処理は避けてください。時間の掛かる処理を行った場合はシステムテスト支援の性能が低下し、パケットロストを起こす可能性があります。

6.4.3　蓄積編集UOC

機能

入力電文蓄積時にUOCを実行します。入力電文の編集を行うことができます。

形式

ANSI C、C++の形式

#include <esrpc.h>
ESLONG uoc_func(ESRPC_UOC_STORE_TBL *parm)

説明

電文入力の蓄積時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します。

表6‒3　蓄積編集UOC実行比較

-

本番環境

テスト環境

要求電文

応答電文

要求電文※1

応答電文※2

並行実行

×

×

○

○

蓄積実行

○

○

×

×

並行＋蓄積実行

○

○

○

○

リプレイ実行

×

×

○

○

PCAP実行

×

×

○

○

凡例

○：UOCが実行される

×：UOCは実行されない

※1：

accumulate_file -t REQTS -f “testuse=Y”が指定されていない場合は、UOCが呼び出されても、電文は蓄積されません

※2：

accumulate_file -t RPYTS -f “testuse=Y”が指定されていない場合は、UOCが呼び出されても、電文は蓄積されません

それぞれの電文がUOCを呼ぶタイミングは以下の通りです。

電文種別

タイミング

本番環境 要求電文

本番環境から要求電文をキャプチャした後

本番環境 応答電文

本番環境から応答電文をキャプチャした後

テスト環境 要求電文

テスト環境へ要求電文を送信した後

テスト環境 応答電文

テスト環境から応答電文を受信した後

ユーザオウンコーディング（UOC）が起動される入力電文は、RPC電文とRAPのAPI代理実行電文です。

システムテスト支援は、uoc_func（蓄積編集UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

対象メッセージのテキスト部のデータは、編集前データアドレスに格納されています。編集が必要な場合、編集結果は設定される編集後データアドレス以降のエリアに格納してください。なお、バッファとして8MBを用意しています。8MBを超えて格納しないでください。

表6‒4　call_systemとtelegram_typeの設定内容

-

call_system

telegram_type

本番環境要求電文

ESRPC_CALL_PRODUCTION_SYSTEM

ESRPC_TELEGRAM_REQUEST

本番環境応答電文

ESRPC_CALL_PRODUCTION_SYSTEM

ESRPC_TELEGRAM_REPLY

テスト環境要求電文

ESRPC_CALL_TEST_SYSTEM

ESRPC_TELEGRAM_REQUEST

テスト環境応答電文

ESRPC_CALL_TEST_SYSTEM

ESRPC_TELEGRAM_REPLY

上記のパラメタの値を使うことで、どの電文でUOCが実行されたのかを判別することができます。

パラメタの内容

ESRPC_UOC_STORE_TBLのパラメタ内容

typedef struct es_rpc_uoc_store{
  ESULONG        running_mode;        ……………… 実行形態
  ESLONG         call_system;         ……………… 電文送信元の環境
  ESLONG         protocol_type;       ……………… プロトコル種別（rpc|rap）
  ESLONG         telegram_type;       ……………… 電文種別
  ESLONG         rpc_model;           ……………… RPC形態
  char           reserve1[4];         ……………… 予備
  char           srv_group [32];      ……………… 要求先のサービスグループ名
  char           srv_service [32];    ……………… 要求先のサービス名
  char           srv_nid[5];          ……………… 要求先のノード識別子
  char           reserve2[3];         ……………… 予備領域
  char           clt_nid[5];          ……………… 要求元のノード識別子
  char           reserve3[3];         ……………… 予備領域
  unsigned char  srv_ipaddr[4];       ……………… 要求先のIPアドレス
  unsigned char  clt_ipaddr[4];       ……………… 要求元のIPアドレス
  unsigned short srv_portno;          ……………… 要求先のポート番号
  unsigned short clt_portno;          ……………… 要求元のポート番号
  ESLONG         retcode;             ……………… リターンコード
  ESULONG        usr_data_len;        ……………… 編集前後ユーザデータ長
  char           reserve4[4];         ……………… 予備領域
  char           *usr_data;           ……………… ユーザデータ
  char           *edt_data;           ……………… 編集後のユーザデータ
}ESRPC_UOC_STORE_TBL;

編集前データアドレスと編集前データ長の関係

編集後データアドレスと編集後データ長の関係

システムテスト支援が設定するパラメタ項目

running_mode

実行形態を設定します。実行形態が複数の場合は論理和で設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

call_system

電文送信元の環境を設定します。

ESRPC_CALL_PRODUCTION_SYSTEM：本番環境

ESRPC_CALL_TEST_SYSTEM：テスト環境

protocol_type

プロトコル種別を設定します。

ESRPC_TYPE_RPC：rpc

ESRPC_TYPE_RAP：rap

telegram_type

電文種別を設定します。

ESRPC_TELEGRAM_REQUEST：要求電文

ESRPC_TELEGRAM_REPLY：応答電文

rpc_model

RPC形態を設定します。

ESRPC_MODEL_NOFLAGS：同期応答型

ESRPC_MODEL_NOWAIT：非同期応答型

ESRPC_MODEL_NOREPLY：非応答型

srv_group

サーバ側のサービスグループ名（※1）を設定します。

srv_service

サーバ側のサービス名（※1）を設定します。

srv_nid

サーバ側のノードID（※1）を設定します。

clt_nid

クライアント側のノードID（※1）を設定します。

srv_ipaddr

サーバ側のIPアドレス（※2）を設定します。

clt_ipaddr

クライアント側のIPアドレス（※2）を設定します。

srv_portno

サーバ側の受信ポート番号を設定します。

clt_portno

クライアント側の送信ポート番号を設定します。

retcode

応答電文の場合に設定されているRPC・RAPのリターンコード（※1）を設定します。

usr_data_len

電文に設定されているユーザデータ長を設定します。

usr_data

ユーザデータ先頭アドレスを設定します。

※1：

電文中に設定されておらず、取得できない場合は空文字列、または0が設定されています。

※2：

IPアドレスは、次に示す形式で設定します。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0xA5

0x70

0x14

ユーザが設定するパラメタ項目

usr_data_len

編集後のユーザデータ長を設定してください。

0以下、または8MBを超える値が設定されている場合はエラーとして、対象のメッセージを破棄します。ただし、ES_UOC_MSG_OK_INのリターンコードを返却した場合は、編集前のユーザデータ長で蓄積します。

edt_data

編集後のユーザデータを設定してください。

リターン値

次のコードでリターン値を設定してください。

ESRPC_UOC_OK

ユーザが編集したユーザデータおよびユーザデータ長を使って、蓄積します。

ESRPC_UOC_OK_IN

編集後のユーザデータ長が0以下もしくは8MBを超える場合

編集する前のユーザデータおよびユーザデータ長を使って、蓄積します。

編集後のユーザデータ長が編集前のユーザデータ長以下の場合

編集する前のユーザデータと編集後のユーザデータ長を使って、蓄積します。

編集後のユーザデータ長が編集前のユーザデータ長より大きい場合

編集する前のユーザデータおよびユーザデータ長を使って、蓄積します。

ESRPC_UOC_NG

対象メッセージを蓄積しません。

上記以外

指定リターン値以外でリターンした場合、対象メッセージを蓄積しません。

編集時の注意

編集前ユーザデータを変更した場合、要求電文およびその後の処理の保証はしません。

編集前データアドレスで編集を行った場合、対象メッセージの後の処理は保証しません。

テキスト部に8MB以上格納した場合、対象メッセージを含め、後の処理は保証しません。

変更前ユーザデータ長が0byteの電文はユーザデータおよび、ユーザデータ長は変更できません。

6.4.4　送信編集UOC

機能

テスト対象システムへ電文送信時にUOCを実行します。テスト対象システムへ送信する要求電文の編集を行うことが出来ます。

形式

ANSI C、C++の形式

#include <esrpc.h>
ESLONG uoc_func(ESRPC_UOC_REQUEST_TBL *parm)

説明

テスト対象システムへ電文送信時に呼び出されるUOCです。テスト対象システムへ電文送信時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します。

表6‒5　送信編集UOC実行比較

-

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

並行実行

○

×

×

×

蓄積実行

×

×

×

×

並行＋蓄積実行

○

×

×

×

リプレイ実行

○

×

×

×

PCAP実行

○

×

×

×

凡例

○：UOCが実行される

×：UOCは実行されない

ユーザオウンコーディング（UOC）が起動される入力電文は、RPC電文とRAPのAPI代理実行電文です。

システムテスト支援は、uoc_func（送信編集UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

パラメタの内容

ESRPC_UOC_REQUEST_TBLのパラメタ内容

typedef struct es_rpc_uoc_request {
  ESULONG running_mode;  ………… 実行形態
  ESLONG  protocol_type; ………… プロトコル種別
  ESLONG  telegram_type; ………… 電文種別
  ESLONG  rpc_model;     ………… RPC形態
  char    group[32];     ………… サービスグループ名
  char    service[32];   ………… サービス名
  char    *in;           ………… 要求データアドレス
  ESULONG in_len;        ………… 要求データ長
  ESULONG out_len;       ………… 応答データ長
  char    *edit_in;      ………… 編集要求データアドレス
  ESCOM_AREA usr_clt_area; ……… クライアント単位ユーザ領域
} ESRPC_UOC_REQUEST_TBL;

ESCOM_AREAのパラメタ内容

typedef struct es_com_area {
  ESULONG   size;        ………………… 領域サイズ
  char      reserve[4];  ………………… 予備領域
  char      *data;       ………………… 領域先頭アドレス
} ESCOM_AREA;

システムテスト支援が設定するパラメタ項目

running_mode

実行形態を設定します。実行形態が複数の場合は論理和で設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

protocol_type

プロトコル種別を設定します。

ESRPC_TYPE_RPC：rpc

ESRPC_TYPE_RAP：rap

telegram_type

電文種別を設定します。

ESRPC_TELEGRAM_REQUEST：要求電文

rpc_model

RPC形態を設定します。

ESRPC_MODEL_NOFLAGS：同期応答型

ESRPC_MODEL_NOWAIT：非同期応答型

ESRPC_MODEL_NOREPLY：非応答型

group

既存システムのRPCの引数に指定したサービスグループ名称を設定します。

service

既存システムのRPCの引数に指定したサービス名称を設定します。

in

既存システムのRPCの引数に指定した要求データの先頭アドレスを設定します。

in_len

既存システムのRPCの引数に指定した要求データの長さを設定します。

out_len

既存システムのRPCの引数に指定した応答データの長さを設定します。

edit_in

テスト対象システムへ送信するデータの先頭アドレスを設定します。

usr_clt_area

クライアント識別子単位で共有するユーザ領域を設定します。

各メンバには以下の値を設定します。

領域サイズ

クライアント単位ユーザ領域のサイズを設定します。

ユーザ領域先頭アドレス

クライアント単位ユーザ領域の先頭アドレスを設定します。

対象の領域が当該クライアントで新規に割り当てられた場合、クライアント単位ユーザ領域はすべて0で初期化されています。

ユーザが設定するパラメタ項目

group

テスト対象システムのサービスグループ名称を設定してください。

service

テスト対象システムサービス名称を設定してください。

in_len

テスト対象システムへ送信するデータの長さを設定してください。

out_len

テスト対象システムから受け取る応答データの長さを設定してください。

edit_in

編集後のユーザデータを設定してください。

リターン値

次のコードでリターン値を設定してください。

ESRPC_UOC_OK

ユーザが編集した内容を使って、送信します。

ESRPC_UOC_OK_IN

編集する前の内容を使って、送信します。

ESRPC_UOC_NG

対象メッセージを送信しません。

上記以外

指定リターン値以外でリターンした場合、対象メッセージを送信しません。

注意事項

編集前要求データアドレスで編集を行った場合、要求電文およびその後の処理の保証はしません。

編集後要求データアドレスに8Mbyteを超えるデータを格納した場合、要求電文その後の処理は保証しません。

編集前後要求データ長、または編集前後応答データ長に0以下、または8MBを超える値が設定されている場合はエラーと見なし、要求電文を送信しません。

6.4.5　データ比較UOC

機能

既存システムからの応答電文と、テスト対象システムからの応答電文の受信時にUOCを実行します。

応答電文の比較を行うことができます。

形式

ANSI C、C++の形式

#include <esrpc.h>
ESLONG uoc_func(ESRPC_UOC_COMPARE_TBL *parm)

説明

既存システムからの応答電文と、テスト対象システムからの応答電文の受信時に呼び出されるUOCです。ただし、どちらかの応答電文がエラー応答電文の場合は呼び出されません。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します。

表6‒6　データ比較UOC実行比較

-

既存システムからの応答電文と

テスト対象システムからの応答電文受信

並行実行

○

蓄積実行

×

並行＋蓄積実行

○

リプレイ実行

○

PCAP実行

○

凡例

○：UOCが実行される

×：UOCは実行されない

ユーザオウンコーディング（UOC）が起動される入力電文は、RPC電文とRAPのAPI代理実行電文です。

システムテスト支援は、uoc_func（データ比較UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

パラメタの内容

ESRPC_UOC_COMPARE_TBLのパラメタ内容

typedef struct es_rpc_uoc_compare {
  ESULONG running_mode;         ………… 実行形態
  ESLONG  protocol_type;        ………… プロトコル種別
  ESLONG  telegram_type;        ………… 電文種別
  char    reserve1[4];          ………… 予備
  char    ext_group[32];        ………… 既存システムのサービスグループ名
  char    ext_service[32];      ………… 既存システムのサービス名
  char    *ext_data;            ………… 既存システムの応答データアドレス
  ESULONG ext_data_len;         ………… 既存システムの応答データ長
  char    reserve2[4];          ………… 予備
  char    new_group[32];        ………… テスト対象システムのサービスグループ名
  char    new_service[32];      ………… テスト対象システムのサービス名
  char    *new_data;            ………… テスト対象システムの応答データアドレス
  ESULONG new_data_len;         ………… テスト対象システムの応答データ長
  ESLONG  user_code;            ………… ユーザ情報コード
  char    user_info[256];       ………… ユーザ情報文字列
} ESRPC_UOC_COMPARE_TBL;

システムテスト支援が設定するパラメタ項目

running_mode

実行形態を設定します。実行形態が複数の場合は論理和で設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

protocol_type

プロトコル種別を設定します。

ESRPC_TYPE_RPC：rpc

ESRPC_TYPE_RAP：rap

telegram_type

電文種別を設定します。

ESRPC_TELEGRAM_REPLY：応答電文

ext_group

既存システムのサービスグループ名を設定します。

ext_service

既存システムのサービス名を設定します。

ext_data

既存システムの応答データアドレスを設定します。

ext_data_len

既存システムの応答データ長を設定します。

new_group

テスト対象システムのサービスグループ名を設定します。

new_service

テスト対象システムのサービス名を設定します。

new_data

テスト対象システムの応答データアドレスを設定します。

new_data_len

テスト対象システムの応答データ長を設定します。

ユーザが設定するパラメタ項目

user_code

ESRPC_UOC_NOMATCHを返すとき、比較エラー情報ファイルに出力したいユーザ任意のコードを設定してください。

user_info

ESRPC_UOC_NOMATCHを返すとき、比較エラー情報ファイルに出力したいユーザ任意の文字列を設定してください。文字列の最後にはnull文字を設定してください。

リターン値

次のコードでリターン値を設定してください。

ESRPC_UOC_MATCH

データ比較が一致

ESRPC_UOC_NOMATCH

データ比較が不一致

上記以外

ESRPC_UOC_NOMATCHを返したと見なします。

注意事項

応答データを編集した場合、応答電文およびその後の処理の保証はしません。

6.4.6　受信電文UOC

機能

テスト対象システムから受信した応答電文を参照することができます。

応答電文の情報を次に送信する要求電文に引き継ぎたい場合に使用します。

本UOCは応答待ちタイムアウト等の要因で、応答電文を受信できなかった場合も呼び出されます。その場合、応答データアドレスにNULL、応答データ長に0が設定されます。

形式

#include <esrpc.h>
void uoc_func(ESRPC_UOC_RECEIVE_TBL *parm)

説明

テスト対象システムからの電文受信時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します

表6‒7　受信電文UOC実行比較

実行方式

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

並行実行

×

×

×

○

蓄積実行

×

×

×

×

並行＋蓄積実行

×

×

×

○

リプレイ実行

×

×

×

○

PCAP実行

×

×

×

○

（凡例）

○：UOCが実行される

×：UOCは実行されない

UOCが起動される入力電文は、RPC電文とRAPのAPI代理実行電文です。

システム検証支援基盤は、uoc_func（受信電文UOC）を呼び出すとき、次に示す所定のパラメタをparmに設定します。「uoc_func」部分には、システム内で一意の名称を指定してください。

パラメタの内容

ESRPC_UOC_RECEIVE_TBLのパラメタ内容

typedef struct es_rpc_uoc_receive {
  ESULONG running_mode;  …… 実行形態
  ESLONG protocol_type;  …… プロトコル種別
  ESLONG telegram_type;  …… 電文種別
  ESLONG rpc_model;      …… RPC形態
  char group[32];        …… サービスグループ名
  char service[32];      …… サービス名
  char *in;              …… 応答データアドレス
  ESULONG in_len;        …… 応答データ長
  ESULONG request_len;   …… 要求データ長
  char *request;         …… 要求データアドレス
  ESCOM_AREA usr_clt_area; … クライアント単位ユーザ領域
} ESRPC_UOC_RECEIVE_TBL;

ESCOM_AREAのパラメタ内容

typedef struct es_com_area {
  ESULONG   size;        ………………… 領域サイズ
  char      reserve[4];  ………………… 予備領域
  char      *data;       ………………… 領域先頭アドレス
} ESCOM_AREA;

システムテスト支援が設定するパラメタ項目

running_mode

システム検証支援基盤の実行形態を設定します。以下の値の論理和を設定します。

ESCLT_RUNMODE_P：並行実行

ESCLT_RUNMODE_A：蓄積実行

ESCLT_RUNMODE_R：リプレイ実行

ESCLT_RUNMODE_C：PCAP実行

protocol_type

プロトコル種別を設定します。

ESRPC_TYPE_RPC：rpc

ESRPC_TYPE_RAP：rap

telegram_type

電文種別を設定します。

ESRPC_TELEGRAM_REPLY：応答

rpc_model

RPC形態（RAPの場合はdc_rpc_callの代理実行形態）を設定します。

ESRPC_MODEL_NOFLAGS：同期応答型

ESRPC_MODEL_NOWAIT：非同期応答型

group

テスト対象システムのRPCの引数に指定したサービスグループ名称を設定します。

service

テスト対象システムのRPCの引数に指定したサービス名称を設定します。

in

テスト対象システムから受信した応答データの先頭アドレスを設定します。

応答待ちタイムアウト等の要因で、応答電文を受信できなかった場合、NULLを設定します。

in_len

テスト対象システムから受信した応答データの長さを設定します。

応答待ちタイムアウト等の要因で、応答電文を受信できなかった場合、0を設定します。

request

テスト対象システムへ送信した要求データの先頭アドレスを設定します。

request_len

テスト対象システムへ送信した要求データの長さを設定します。

usr_clt_area

クライアント識別子単位で共有するユーザ領域を設定します。

各メンバには以下の値を設定します。

領域サイズ

クライアント単位ユーザ領域のサイズを設定します。

ユーザ領域先頭アドレス

クライアント単位ユーザ領域の先頭アドレスを設定します。

対象の領域が当該クライアントで新規に割り当てられた場合、

クライアント単位ユーザ領域はすべて0で初期化されています。

ユーザが設定するパラメタ項目

ありません。

リターン値

リターン値はありません。

注意事項

応答データアドレス、要求データアドレスで電文編集を行った場合、その後の処理の保障はしません。

6.4.7　蓄積ファイル内容表示コマンド起動UOC

機能

蓄積ファイル内容表示コマンド開始時にUOCを実行します。

形式

ANSI C、C++の形式

#include <esafl.h>
ESLONG es_afl_data_mask_start(char **userobj, ESLONG flags);

説明

蓄積ファイル表示コマンドに指定した関数名で、コマンド開始時に一度だけ実行します。

蓄積ファイル表示コマンドの編集UOCや停止UOCに引継ぎたい情報がある場合はuserobjに確保した領域のアドレスを設定してください。そのアドレスを蓄積ファイル表示コマンド編集UOCや停止UOCに引き継ぎます。コマンドに蓄積ファイル表示コマンド起動UOC名を指定しなかった場合（デフォルト名で関数を作成した場合を除く）は実行しません。実行しなかった場合は、後続の編集UOCや停止UOCのuserobjにはNULLを渡します。

関数名（es_afl_data_mask_start）はデフォルト名であり、任意の関数名で作成可能です。その場合はコマンドのオプションに指定してください。

システムテスト支援が設定するパラメタ項目

flags

ESNOFLAGSを設定します。

ユーザが設定するパラメタ項目

userobj

蓄積ファイル表示コマンドの編集UOCや停止UOCに引継ぎたい情報領域のアドレスを設定してください。

リターン値

次のコードでリターン値を設定してください。

ES_UOC_OK

コマンドは処理続行します。

ES_UOC_NG

コマンドを中断します。

上記以外

コマンドを中断します。

6.4.8　蓄積ファイル内容表示コマンドデータ編集UOC

機能

蓄積ファイル内容表示コマンド編集時にUOCを実行します。

形式

ANSI C、C++の形式

#include <esafl.h>
ESLONG es_afl_data_mask( char *userobj, ESLONG protocol, void *parm, ESLONG flags);

説明

蓄積ファイル表示コマンドに指定した関数名で、表示すべき電文を蓄積ファイルから読み込むごとに実行します。編集UOCは必要であれば引数に指定したユーザデータを更新することができます。更新した内容で蓄積ファイル表示コマンドは、ユーザデータを出力します。コマンドに編集UOC名を指定しなかった場合（デフォルト名で関数を作成した場合を除く）やesaflfillsコマンドに「-d」オプションを指定しなかった場合、又はユーザデータが存在しない電文の場合は編集UOCを実行しません。

関数名（es_afl_data_mask）はデフォルト名であり、任意の関数名で作成可能です。その場合はコマンドのオプションに指定してください。

パラメタの内容

ESAFLUOCRPCのパラメタ内容

typedef struct es_afl_uoc_rpc {
  char    key[32];        ………… 電文キー
  char    group[32];      ………… サービスグループ名
  char    service[32];    ………… サービス名
  char    *data;          ………… ユーザデータ
  ESULONG datalen;        ………… ユーザデータ長
  ESLONG  telegram_type;  ………… 電文種別
} ESAFLUOCRPC;

ESAFLUOCCOMのパラメタ内容

typedef struct es_afl_uoc_com {
    char    key[32];       ………… 電文キー
    char    *data;         ………… ユーザデータ
    ESULONG datalen;       ………… ユーザデータ長
    ESLONG  telegram_type; ………… 電文種別
    char    yobi[48];      ………… 予備領域
} ESAFLUOCCOM;

ESAFLUOCIIOPのパラメタ内容

typedef struct es_afl_uoc_iiop {
    char    key[32];       ………… 電文キー
    char    byte_order;      ……… バイトオーダー
    char    yobi1[7];        ……… 予備
    char    *objectkey;      ……… オブジェクトキー
    ESULONG objectkey_size;  ……… オブジェクトキー長
    char    yobi2[4];        ……… 予備
    char    *operation;      ……… オペレーション名
    ESULONG operation_size;  ……… オペレーション名長
    char    yobi3[4];        ……… 予備
    void    *context;        ……… サービスコンテキスト
    ESULONG context_size;    ……… サービスコンテキスト長
    char    yobi4[4];        ……… 予備
    char    *data;           ……… プロトコル電文
    ESULONG datalen;         ……… プロトコル電文長
    ESULONG proto_datalen;   ……… プロトコルヘッダ長
    ESULONG user_datalen;    ……… ユーザデータ長
    ESLONG  telegram_type;    ……… 電文種別
} ESAFLUOCIIOP;

システムテスト支援が設定するパラメタ項目

userobj

起動UOCで指定されたアドレスを設定します。

起動UOCがない場合はNULLを設定します。

protocol

電文のプロトコルを設定します。

RPC/RAPプロトコルの場合：ESAFL_PROTOCOL_RPC

TCPプロトコルの場合：ESAFL_PROTOCOL_TCP

HTTPプロトコルの場合：ESAFL_PROTOCOL_HTTP

IIOPプロトコルの場合：ESAFL_PROTOCOL_IIOP

parm

RPC/RAPプロトコルの場合

構造体ESAFLUOCRPCのアドレスを設定します。構造体の各メンバ変数には以下の値を設定します。

key

電文キーを設定します。

group

サービスグループ名を設定します。要求電文の場合は、要求時に指定したサービスグループ名となります。応答電文の場合は、受け付けたサービスグループ名となります。

service

サービス名を設定します。要求電文の場合は、要求時に指定したサービス名となります。応答電文の場合は、受け付けたサービス名となります。

data

ユーザデータの先頭アドレスを設定します。

datalen

電文キーが示す電文のユーザデータ長を設定します。

telegram_type

電文種別を設定します。

要求電文のとき …… ESAFL_TYPE_REQUEST

応答電文のとき …… ESAFL_TYPE_RESPONSE

TCP/HTTPプロトコルの場合

構造体ESAFLUOCCOMのアドレスを設定します。構造体の各メンバ変数には以下の値を設定します。

key

電文キーを設定します。

data

ユーザデータの先頭アドレスを設定します。

datalen

電文キーが示す電文のユーザデータ長を設定します。

telegram_type

電文種別を設定します。

要求電文のとき …… ESAFL_TYPE_REQUEST

応答電文のとき …… ESAFL_TYPE_RESPONSE

IIOPプロトコルの場合

構造体ESAFLUOCIIOPのアドレスを設定します。応答電文のときは、リプライステータスがNO_EXCEPTION（正常応答）の場合のみ編集UOCを実行します。構造体の各メンバ変数には以下の値を設定します。

key

電文キーを設定します。

byte_order

プロトコル電文のバイトオーダーを設定します。

ビッグエンディアンの場合 …… ESAFL_BIG_ENDIAN

リトルエンディアンの場合 …… ESAFL_LITTLE_ENDIAN

objectkey

オブジェクトキーの格納領域アドレスを設定します。

objectkey_size

オブジェクトキー長を設定します。オブジェクトキーがないときは0を設定します。

operation

オペレーション名の格納領域アドレスを設定します。

operation_size

オペレーション名長を設定します。オペレーション名がないときは0を設定します。

context

サービスコンテキストの格納領域アドレスを設定します。バイトオーダーを考慮して参照してください。

context_size

サービスコンテキスト長を設定します。サービスコンテキストがないときは0を設定します。

data

プロトコル電文の先頭アドレスを設定します。バイトオーダーを考慮して参照してください。

datalen

プロトコルヘッダを含んたプロトコル電文長を設定します。

proto_datalen

プロトコルヘッダ長を設定します。

user_datalen

ユーザデータ長を設定します。

telegram_type

電文種別を設定します。

要求電文のとき…… ESAFL_TYPE_REQUEST

応答電文のとき……ESAFL_TYPE_RESPONSE

注意事項

IIOPプロトコルの未サポート電文については、蓄積ファイル内容表示コマンドデータ編集UOCを実行しません。

flags

ESNOFLAGSを設定します。

ユーザが設定するパラメタ項目

data

必要に応じてデータ更新してください。その更新内容にしたがってダンプ出力します。

なお、入力情報のユーザデータ長以降の領域は参照・更新しないでください。

datalen

コマンドの「-d」オプションで指定した電文長と本設定値のうち、小さいサイズでダンプ出力します。

入力情報のユーザデータ長より大きい値を設定しても無視します。

リターン値

次のコードでリターン値を設定してください。

ES_UOC_OK

コマンドは処理続行します。

ES_UOC_NG

コマンドを中断します。

上記以外

コマンドを中断します。

6.4.9　蓄積ファイル内容表示コマンド終了UOC

機能

蓄積ファイル内容表示コマンド終了時にUOCを実行します。

形式

ANSI C、C++の形式

#include <esafl.h>
ESLONG es_afl_data_mask_stop(char *userobj, ESLONG flags);

説明

蓄積ファイル表示コマンドに指定した関数名で、コマンド終了時に一度だけ実行します。起動UOCから引き継いだuserobjを引数に設定しますので、必要であれば領域を解放してください。

コマンドに停止UOC名を指定しなかった場合（デフォルト名で関数を作成した場合を除く）は実行しません。

関数名（es_afl_data_mask_stop）はデフォルト名であり、任意の関数名で作成可能です。その場合はコマンドのオプションに指定してください。

システムテスト支援が設定するパラメタ項目

userobj

起動UOC設定した情報領域アドレスを設定します。起動UOCを省略した場合はNULLを設定します。

flags

ESNOFLAGSを設定します。

ユーザが設定するパラメタ項目

なし

リターン値

次のコードでリターン値を設定してください。

ES_UOC_OK

コマンドは処理続行します。

ES_UOC_NG

コマンドを中断します。

上記以外

コマンドを中断します。

7　システムテスト支援のUOC（フレームワーク機能）

システムテスト支援のUOC（フレームワーク機能）について説明します。

7.1　フレームワーク機能のテスト手順

フレームワーク機能を使用したテスト手順を以下に示します。

図7‒1　フレームワーク機能を使用したテスト手順

プラグイン作成

電文フォーマットやテスト内容に応じてプラグイン用ライブラリを作成します。プラグイン用ライブラリの作成方法は「7.2　プラグイン機能のUOCインタフェース」および「7.3　プラグインインタフェース」を参照してください。作成したプラグインはHSIC定義ファイルで指定してください。

HSIC定義ファイル作成

フレームワーク機能用のHSIC定義ファイルを作成します。各定義の詳細については「3.　システムテスト支援のシステム定義」を参照してください。

表7‒1　フレームワーク機能で使用する定義

定義名

説明

framework_definition

フレームワーク機能の使用有無、電文ファイル/結果ファイルの種別（csvファイル or 蓄積ファイル）、プラグイン情報（プラグイン名、ファイル名、エントリポインタ名等）、各種タイマ値等を記載します。

csvfile_definition

電文ファイル/結果ファイルの種別がcsvファイルの場合に出力先／入力元ファイル情報、最大行数、csv変換ルール等を記載します。

accumulate_file

電文ファイル種別が蓄積ファイルの場合に出力先電文ファイル情報を記載します。

accumulate_reply_file

電文ファイル種別が蓄積ファイルの場合に入力元電文ファイル情報を記載します。

address_destination

テスト対象となるアドレス情報やプロトコル種別等を記載します。

reply_send_mode

テスト実行フェーズ、かつ、逐次実行モードの場合、送信間隔を指定します。

capture_definition

capture_network_interface

電文作成フェーズの場合、パケットキャプチャ用情報を指定します。

capture_definition

RPCプロトコル用の応答電文待ち時間を指定します。※

rpc_telegram_filter

RPCプロトコル用のフィルタリング内容を指定します。※

rpc_socket

RPCプロトコルで使用するコネクション数や一時クローズのしきい値などを指定します。※

注※

RPCプロトコルでだけ有効になります。RPCプロトコル以外では、指定値は無視されます。

電文作成フェーズ

次のどちらかの方法で、HSICを電文作成フェーズで起動します。

-aオプション、および-mオプションにCREATEを指定して、esstartコマンドを実行する

-cオプション、および-mオプションにCREATEを指定して、esstartコマンドを実行する

起動後、本番環境の要求電文／応答電文を収集し、電文ファイルへ格納します。

esstartコマンドを-aオプションで実行した場合、NICからパケットをキャプチャします。-cオプションで起動した場合は、pcapファイルからパケットをキャプチャします。

以下のどちらかのタイミングで終了処理を開始します。その時点で完成していた全電文の電文ファイル格納処理が終了した時点でHSICが終了します。

esstopコマンド実行

PCAP実行の場合は、pcapファイルから全パケットの読込みが終了

電文ファイル編集

以下のような場合、電文ファイルを編集します。電文ファイルが蓄積ファイルの場合は、蓄積ファイル編集ユーティリティを使用して編集してください。電文ファイルがcsvファイルの場合は、viやExcel等のエディタで編集してください。

電文作成フェーズで作成した電文ファイルを編集したい

電文作成フェーズを使用せず、電文ファイルを新規に作成したい

テスト実行フェーズ

次のどちらかの方法で、HSICをテスト実行フェーズで起動します。

-rオプション、および-mオプションにTESTを指定して、esstartコマンドを実行する

-cオプション、および-mオプションにTESTを指定して、esstartコマンドを実行する

起動後、電文ファイルやプラグインに従いテストを実行します。

以下のどれかのタイミングで終了処理を開始します。逐次実行モード時はその時点で完成していた全電文、シナリオ実行時はその時点で登録していた全電文のテストが終了した時点でHSICが終了します。

esstopコマンド実行

逐次実行モードの場合は、電文ファイルから全電文の読込みが終了

シナリオ実行モードの場合は、電文選択プラグインが終了指示

バッチ実行フェーズ

esstartコマンドを-mオプションにBATCHを指定して実行し、HSICをバッチ実行フェーズで起動します。

起動後、プラグインに従いテストを実行します。

以下のどれかのタイミングで終了処理を開始します。その時点で処理キュー登録していたテストが終了した時点でHSICが終了します。

esstopコマンド実行

同時実行数×実行回数分のテスト実施が完了

バッチ用プラグインが終了指示

7.2　プラグイン機能のUOCインタフェース

ユーザテスト支援フレームワーク機能のプラグインで使用するUOCインタフェースについて説明します。

7.2.1　概要

各プラグインで起動するUOC

各プラグインで起動するUOCについて、以下に示します。

表7‒2　各プラグインで使用可能なUOC

UOC名

プラグイン名

テスト比較支援機能

シナリオ実行機能

IIOP機能

開始終了UOC

○

○

○

電文組立UOC（TCPのみ）

○

×

×

電文情報設定UOC

○

○

×

オペレーション名判定UOC

×

○

×

編集UOC

（蓄積編集UOC、送信編集UOC、受信編集UOC、蓄積復元UOC）

○

○

○

結果判定UOC

○

○

○

電文増幅UOC

（電文追加UOC）

○

×

○

（凡例）

○：使用可能

×：使用不可

各UOCの呼び出しの流れ

電文作成フェーズ

電文作成フェーズで呼び出すUOCについて以下に示します。

図7‒2　電文作成フェーズで使用するUOC

テスト実行フェーズ

電文作成フェーズで呼び出すUOCについて以下に示します。

図7‒3　テスト実行フェーズで使用するUOC

7.2.2　電文組立UOC

機能

本番環境からパケットをキャプチャしたとき、もしくはテスト対象からパケットを受信したときにUOCを実行します。パケットをプロトコル電文に組み立てます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(struct es_plg_uoc_build *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文組立UOCは、本番環境からパケットをキャプチャしたとき、もしくはテスト対象システムからパケットを受信した時に、プロトコル電文が完成しているかどうかを判定し、プロトコル電文に組み立てます。

入力パケットの組立

システム検証支援はパケット受信毎に電文組立UOCにパケットが格納されている受信バッファを引き渡します。電文組立UOCでは、受信バッファを基に電文が完成しているかどうかを判定し、電文が完成したかどうかをリターン値で指定します。電文が未完成の場合、前回までのパケットと、今回受信したパケットを連結して通知します。

なお、電文を組立中のコネクションでパケットロストやコネクション断が検知した場合、システム検証支援は組立中の電文を破棄します。

図7‒4　電文組立UOCによるパケットの組み立て

組み立て中の電文の破棄

組立て中のパケットが不要となった場合は、ESPLG_UOC_MSG_DESTRUCTでリターンすると不要な電文を破棄することができます。

パラメタの内容

es_plg_uoc_buildのパラメタ内容

typedef struct es_plg_uoc_build {
  ESULONG         run_mode;        ……………実行形態
  ESULONG         protocol;        ……………プロトコル種別
  unsigned char   msgtype;         ……………電文種別
  char            reserve[7];      ……………予備領域
  ESCOM_IPADDR         src_ip;     ……………送信元IPアドレス
  ESCOM_IPADDR         dst_ip;     ……………送信先IPアドレス
  unsigned short  src_port;        ……………送信元ポート番号
  unsigned short  dst_port;        ……………送信先ポート番号
  char            reserve2[4];     ……………予備領域
  ESCOM_AREA      rcv_telegram;    ……………受信電文情報
  ESULONG         now_data_size;   ……………当該メッセージの有効長
  ESLONG              rtn_detail;  ……………詳細エラーコード
  ESCOM_AREA   usr_tel_area;       ……………電文単位ユーザ領域
  char       usr_tel_area_state;     …………電文単位ユーザ領域の状態
  char            reserve3[7];  ……………… 予備領域
  ESCOM_AREA   usr_con_area;       ……………コネクション単位ユーザ領域
  char       usr_con_area_state;       ………コネクション単位ユーザ領域の状態
  char            reserve4[3];   ………………予備領域
  ESULONG         abort_code;    ………………強制停止理由コード
} ESPLG_UOC_BUILD;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;            ……………… IPアドレス（IPv4）
  char reserve[16];           ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];           ……………… 予備領域
  char ip[4];                 ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;             ……………… 領域サイズ
  char      reserve[4];       ……………… 予備領域
  char      *data;            ……………… 領域先頭アドレス
} ESCOM_AREA;

システム検証支援が値を設定するパラメタ項目

run_mode

システム検証支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ（電文ファイル）

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

src_ip

パケットの送信元のIPアドレスを設定します。（※1）

dst_ip

パケットの送信先のIPアドレスを設定します。（※1）

src_port

パケットの送信元のポート番号をホストバイトオーダーで設定します。

dst_port

パケットの送信先のポート番号をホストバイトオーダーで設定します。

rcv_telegram

組立て中の電文のサイズと先頭アドレスを設定します。

now_data_size

ユーザが設定する値です。

システム検証支援はデフォルト値として、現時点の電文サイズを設定します。

usr_tel_area

電文単位に共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

usr_tel_area_state

電文単位ユーザ領域の状態を設定します。電文単位ユーザ領域の状態は電文単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_con_area

コネクション単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

コネクション単位ユーザ領域のサイズを設定します。

data

コネクション単位ユーザ領域の先頭アドレスを設定します。

usr_con_area_state

コネクション単位ユーザ領域の状態を設定します。コネクション単位ユーザ領域の状態はコネクション単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

切断されたコネクションのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在のコネクションとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該コネクションのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

注※1：

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例） 送信元IPが172.165.112.20の場合

ユーザが設定するパラメタ項目

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定できます。

このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

now_data_size

当該メッセージのサイズを設定します。

rtn_detail

詳細エラーコードを-2147483648〜2147483647の範囲で設定できます。このコードはUOCがES_UOC_NGをリターンしたときにシステム検証支援に返されます。システム検証支援は詳細エラーコードをメッセージログファイルに出力します。

ユーザが設定する項目とリターン値の関係を次に示します。

項目

リターン値

ESPLG_UOC_OK_NSEG

ESPLG_UOC_OK_LAST

ESPLG_UOC_MSG_DESTRUCT

ES_UOC_NG

ESPLG_UOC_ABORT

当該メッセージの有効長

○

○

×

×

×

詳細エラーコード

×

×

×

○

×

強制停止理由コード

×

×

×

×

○

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK_NSEG

電文未完成です。後続パケットを待ちます。

ESPLG_UOC_OK_LAST

電文が完成しました。

ESPLG_UOC_MSG_DESTRUCT

組立て中の電文を破棄します。

ESPLG_UOC_NG

パケット判定でエラーが発生しました。組立て中の電文を破棄します。

ES_UOC_ABORT

異常リターン。KFSE64109-Eメッセージを出力し、プロセスダウンします。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、対象の電文を破棄します。

now_data_sizeにframework_definition定義の–b max_message_sizeオペランドで指定したサイズを超える値が設定されていた場合、該当するメッセージを破棄します。

7.2.3　オペレーション名判定UOC

機能

入力のHTTP電文のオペレーション名を判定することができます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func（ESPLG_UOC_OPERATION *parm）

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文入力時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下に示します。

-

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

電文作成フェーズ（PCAP）

○

○

-

-

電文作成フェーズ（キャプチャ）

○

○

-

-

電文実行モード

×

×

×

×

（凡例）

○：UOCが実行される

×：UOCは実行されない

パラメタの内容

ESPLG_UOC_OPERATIONのパラメタ内容

typedef struct es_plg_uoc_operation {
  ESULONG             run_mode;  ………………… 実行形態
  ESULONG             protocol;  ………………… プロトコル種別
  unsigned char       msgtype;   ………………… 電文種別
  char                reserve[7];  ……………… 予備領域
  ESCOM_IPADDR         src_ip;         ………… 送信元IPアドレス
  ESCOM_IPADDR         dst_ip;         ………… 送信先IPアドレス
  unsigned short      src_port;  ………………… 送信元ポート番号
  unsigned short      dst_port;  ………………… 送信先ポート番号
  char                reserve2[4];   …………… 予備領域
  ESCOM_AREA          rcv_telegram     ………… 電文情報
  ESPLG_UOC_TELSIZE  rcv_telegram_size;………… 電文サイズ
  ESCOM_AREA      usr_tel_area;        ………… 電文単位ユーザ領域
  char       usr_tel_area_state;       ………… 電文単位ユーザ領域の状態
  char            reserve3[7];     ……………… 予備領域
  ESCOM_AREA      usr_con_area;          ……… コネクション単位ユーザ領域
  char       usr_con_area_state;         ……… コネクション単位ユーザ領域の状態
  char            reserve4[7];     ……………… 予備領域
  char               operation_name[256];    … オペレーション名
} ESPLG_UOC_OPERATION;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;                ……………… IPアドレス（IPv4）
  char reserve[16];               ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];               ……………… 予備領域
  char ip[4];                     ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;                 ……………… 領域サイズ
  char      reserve[4];           ……………… 予備領域
  char      *data;                ……………… 領域先頭アドレス
} ESCOM_AREA;

ESPLG_UOC_TELSIZEのパラメタ内容

typedef union {
  ESPLG_UOC_HTTPSIZE http_size;   …………HTTPプロトコルのサイズ格納領域
  ESPLG_UOC_TCPSIZE tcp_size;     …………TCPプロトコルのサイズ格納領域
  ESPLG_UOC_RPCSIZE rpc_size;     …………RPCプロトコルのサイズ形式
} ESPLG_UOC_TELSIZE;

ESPLG_UOC_HTTPSIZEのパラメタ内容

HTTPの場合

typedef struct es_plg_uoc_httpsize{
  ESULONG header_size;            …………HTTPヘッダ部サイズ
  ESULONG body_size;              …………HTTPボディ部サイズ
} ESPLG_UOC_HTTPSIZE;

ESPLG_UOC_TCPSIZEのパラメタ内容

TCPの場合

typedef struct es_plg_uoc_tcpsize{
  ESULONG size;                   …………電文サイズ
  char reserve[4];
} ESPLG_UOC_TCPSIZE;

RPCの場合

typedef struct es_plg_uoc_rpcsize{
  ESULONG header_size;            …………ヘッダ部サイズ
  ESULONG user_data_size;         …………ユーザデータ部サイズ
} ESPLG_UOC_RPCSIZE;

システム検証支援が値を設定するパラメタ項目

run_mode

システム検証支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

protocol

プロトコル種別を設定します。

ESFRW_PROT_HTTP：HTTP

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

src_ip

電文の送信元のIPアドレスを設定します。（※1）

dst_ip

電文の送信先のIPアドレスを設定します。（※1）

src_port

電文の送信元のポート番号をホストバイトオーダーで設定します。

dst_port

電文の送信先のポート番号をホストバイトオーダーで設定します。

rcv_telegram

入力電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

入力電文のサイズを設定します。

data

入力電文の先頭アドレスを設定します。

rcv_telegram_size

プロトコルに応じて入力電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

usr_tel_area

電文単位に共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

usr_tel_area_state

電文単位ユーザ領域の状態を設定します。電文単位ユーザ領域の状態は電文単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_con_area

コネクション単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

コネクション単位ユーザ領域のサイズを設定します。

data

コネクション単位ユーザ領域の先頭アドレスを設定します。

usr_con_area_state

コネクション単位ユーザ領域の状態を設定します。コネクション単位ユーザ領域の状態はコネクション単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

切断されたコネクションのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在のコネクションとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該コネクションのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

※1：

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例） 送信元IPが172.165.112.20の場合

ユーザが設定するパラメタ項目

operation_name

入力電文のオペレーション名を指定できます。

文字列の最後にはnull文字を設定してください。null文字がない場合、256バイト目をnull文字に置換します。

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK

UOC指定のオペレーション名で処理を続行します。

上記以外

指定リターン値以外でリターンした場合、UOC指定のオペレーション名で処理を続行します。

注意事項

UOCで設定した値に不正があった場合、システム検証支援はデフォルトのオペレーション名を設定します。

入力電文を編集した場合、その後の処理の保証はできません。

7.2.4　電文情報設定UOC

機能

電文情報設定UOCは、電文のテスト要否、およびシステム検証支援の処理に必要な電文情報を指定するUOCです。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func（struct es_plg_uoc_info *parm）

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文入力時に呼び出されるUOCです。

テスト比較支援機能のプラグイン使用時は、電文のキャプチャまたは受信に失敗した場合にも、本UOCが呼び出されます。この場合、電文の情報（ペアリングキー、クライアント識別子、要求電文種別）を設定する必要はありません。必要に応じて後処理（独自確保したリソースの解放等）のみを行ってください。

各実行形態と入力電文によるUOC実行の有無を以下に示します。

-

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

電文作成フェーズ（PCAP）

○

○

-

-

電文作成フェーズ（キャプチャ）

○

○

-

-

電文実行モード

○

○

×

○

（凡例）

○：UOCが実行される

×：UOCは実行されない

電文情報設定UOCでは、電文について以下の情報を設定する必要があります。

ペアリングキー（プロトコルがTCPの場合）

クライアント識別子

要求電文種別（外部システムから既存システムへの電文の場合）

ペアリングキーの判定

プロトコルがTCPの場合、UOCでは、要求電文と応答電文を関連付けるためのペアリングキーを指定する必要があります。同じペアリングキーを持つ要求電文と応答電文が揃うと、システム検証支援は電文比較UOCを呼び出して電文を比較します。

また、要求電文を電文組立UOCで組立後、framework_definition定義-t reply_watchtimeオペランドに指定した時間経過すると応答待ちタイムアウトとなり、要求電文を破棄します。タイムアウト後に応答電文を受信した場合、応答電文を破棄します。

クライアント識別子の判定

UOCでは、電文のクライアント識別子を指定する必要があります。システム検証支援ではクライアント識別子単位にシリアライズして電文を送信します。依存関係がある電文には同じクライアント識別子を指定してください。プロトコルがTCPまたはHTTPの場合、デフォルト値としてパケットを送信したTCPコネクション（外部システム側のIPアドレス＋ポート番号と、既存システムのIPアドレス＋ポート番号の組み合わせ）を指定しています。プロトコルがRPCの場合、デフォルト値として外部システムのIPアドレス、外部システムの受信ポート番号、送信元スレッドIDを連結した値を指定しています。

要求電文種別の判定

プロトコルがTCPの場合、UOCでは、外部システムから既存システムへの電文に対して、要求電文種別を指定する必要があります。応答を待ち合わせる必要のある要求電文（同期要求電文）か、待ち合わせる必要がない要求電文（非応答要求電文）かを指定します。

パラメタの内容

es_plg_uoc_infoのパラメタ内容

typedef struct es_plg_uoc_info {
  ESULONG        run_mode; ………………… 実行形態
  ESULONG        protocol; ………………… プロトコル種別
  unsigned char  msgtype;  ………………… 電文種別
  unsigned char  reqtype;  ………………… 要求電文種別
  char           reserve[2]; ……………… 予備領域
  ESULONG        error_flg;  ……………… エラー情報
  ESCOM_IPADDR   src_ip;     ……………… 送信元IPアドレス
  ESCOM_IPADDR   dst_ip;     ……………… 送信先IPアドレス
  unsigned short src_port; ………………… 送信元ポート番号
  unsigned short dst_port; ………………… 送信先ポート番号
  char           reserve2[4];  …………… 予備領域
  ESCOM_AREA  usr_tel_area;      ………… 電文単位ユーザ領域
  char       usr_tel_area_state; ………… 電文単位ユーザ領域の状態
  char            reserve3[7]; …………… 予備領域
  ESCOM_AREA  usr_con_area;        ……… コネクション単位ユーザ領域
  char       usr_con_area_state;   ……… コネクション単位ユーザ領域の状態
  char            reserve4[7]; …………… 予備領域
  ESCOM_AREA           telegram;     …… 電文情報
  ESPLG_UOC_TELSIZE   telegram_size;   … 電文サイズ
  char           client_id[16];  ………… クライアント識別子
  ESLONG            rtn_detail;  ………… 詳細エラーコード
  char           reserve 5[4]; …………… 予備領域
  char           key[64];    ……………… ペアリングキー
  void           *protoinf;  ……………… プロトコル情報(参照出来ません)
  ESULONG         abort_code;  …………… 強制停止理由コード
  char            reserve6[4]; …………… 予備領域
  void            *protocol_telinf ……… プロトコル固有情報
} ESPLG_UOC_INFO;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;             ……………… IPアドレス（IPv4）
  char reserve[16];            ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;              ……………… 領域サイズ
  char      reserve[4];        ……………… 予備領域
  char      *data;             ……………… 領域先頭アドレス
} ESCOM_AREA;

es_frw_telegram_rpc（ESFRW_TELEGRAM_RPC）のパラメタ内容

typedef struct es_frw_telegram_rpc {
  char      protocol_type;     ………… プロトコル詳細種別
  char      clt_nid[5];        ………… クライアント側ノードID
  char      srv_nid[5];        ………… サーバ側ノードID
  char      reserve1[5];       ………… 予備領域
  char      group[32];   　    ………… サービスグループ名
  char      service[32];       ………… サービス名
  ESLONG    rtncode;           ………… RPCリターンコード
  ESULONG   out_len;           ………… 応答データ長
} ESFRW_TELEGRAM_RPC;

ESPLG_UOC_TELSIZEのパラメタ内容

typedef union {
  ESPLG_UOC_HTTPSIZE http_size;   …………HTTPプロトコルのサイズ格納領域
  ESPLG_UOC_TCPSIZE tcp_size;     …………TCPプロトコルのサイズ格納領域
} ESPLG_UOC_TELSIZE;

ESPLG_UOC_HTTPSIZEのパラメタ内容

typedef struct es_plg_uoc_httpsize{
  ESULONG header_size;             …………HTTPヘッダ部サイズ
  ESULONG body_size;               …………HTTPボディ部サイズ
} ESPLG_UOC_HTTPSIZE;

ESPLG_UOC_TCPSIZEのパラメタ内容

typedef struct es_plg_uoc_tcpsize{
  ESULONG size;                    …………電文サイズ
  char reserve[4];
} ESPLG_UOC_TCPSIZE;

システム検証支援が値を設定するパラメタ項目

run_mode

システム検証支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

reqtype

プロトコル種別がESFRW_PROT_TCPの場合、ユーザが設定する値です。

システム検証支援はデフォルト値 ESFRW_MSGFORM_SYNC_ANSWER（同期応答型）を設定します。

プロトコル種別がESFRW_PROT_HTTPの場合、次のように設定します。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

プロトコル種別がESFRW_PROT_RPCの場合、次のどれかを設定します。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

ESFRW_MSGFORM_NOSYNC_ANSWER：非同期応答型

error_flg

システム検証支援が検知したエラー有無、およびエラー内容を設定します。以下のいずれかとなります。

ESFRW_ERROR_NONE：エラー無し

ESFRW_ERROR_RECV_CON：コネクション切断による受信・不可

ESFRW_ERROR_RECV_LOST：パケットロスト発生

ESFRW_ERROR_BUILD_TIMEOUT：電文組立中の後続パケット待ちタイムアウト

ESFRW_ERROR_RECV_TIMEOUT：応答待ちタイムアウトによる受信不可

設定値がESFRW_ERROR_NONE以外の場合、以下に示すパラメタだけ参照・設定可能です。

参照可能なパラメタ

run_mode

protocol

msgtype

reqtype

src_ip

dst_ip

src_port

dst_port

設定可能なパラメタ

abort_code

上記以外のパラメタは参照・設定しないでください。

src_ip

電文の送信元のIPアドレスを設定します。（※1）

dst_ip

電文の送信先のIPアドレスを設定します。（※1）

src_port

電文の送信元のポート番号をホストバイトオーダーで設定します。

dst_port

電文の送信先のポート番号をホストバイトオーダーで設定します。

usr_tel_area

電文単位に共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

usr_tel_area_state

電文単位ユーザ領域の状態を設定します。電文単位ユーザ領域の状態は電文単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_con_area

コネクション単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

コネクション単位ユーザ領域のサイズを設定します。

data

コネクション単位ユーザ領域の先頭アドレスを設定します。

usr_con_area_state

コネクション単位ユーザ領域の状態を設定します。コネクション単位ユーザ領域の状態はコネクション単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

切断されたコネクションのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在のコネクションとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該コネクションのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

telegram

入力電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

入力電文のサイズを設定します。

data

入力電文の先頭アドレスを設定します。

telegram_size

プロトコルに応じて入力電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

client_id

ユーザが設定する値です。

システム検証支援はプロトコル種別に応じてデフォルト値を設定します。

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合、コネクションごとにユニークとなる値を設定します。

プロトコル種別がESFRW_PROT_RPCの場合、外部システムのIPアドレス、外部システムの受信ポート番号、送信元スレッドIDを連結した値を設定します。

なお、framework_definition定義で、-uオプションのipaddr_serializeフラグメンバ値にYを指定した場合は、デフォルト値として外部システムのIPアドレスごとにユニークとなる値を設定します。

key

プロトコル種別がESFRW_PROT_TCPの場合、ユーザが設定する値です。

以下の条件を全て満たす場合、システム検証支援では、デフォルト値として、蓄積ファイル内の電文情報の電文キー値を設定します。

テスト実行フェーズ

電文ファイルの種別が蓄積ファイル（framework_definition定義の-fオプションのtelegram_file_typeフラグメンバに"afl"を指定）

蓄積ファイル内の電文情報に電文キーが設定されている

上記の条件を満たさない場合は、デフォルト値として、コネクション毎にユニークとなる値を設定します。このデフォルト値を使用した場合、同一コネクションの要求電文と応答電文がペアリングされます。

protocol_telinf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

プロトコル種別がESFRW_PROT_RPCの場合： ESFRW_TELEGRAM_RPC

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合：NULL

注※1：

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例）送信元IPが172.165.112.20の場合

protocol_type

RPCのプロトコル詳細種別を設定します。

ESFRW_PROT_RPC_RPC：RPC

ESFRW_PROT_RPC_RAP：RAP

clt_nid

要求電文（本番環境）の場合：クライアント側のノードIDを設定します。

要求電文（本番環境）以外、または電文内にノードIDが格納されていない場合：NULLを設定します。

srv_nid

応答電文の場合：サーバ側のノードIDを設定します。

応答電文以外の場合：NULLを設定します。

group

要求電文の場合：サービスグループ名を設定します。

それ以外の場合：NULLを設定します。

service

要求電文の場合：サービス名を設定します。

要求電文以外の場合：NULLを設定します。

rtncode

応答電文の場合：サーバ側が設定したRPCリターンコード（dc_rpc_call()等のリターン値）を設定します。

応答電文以外の場合：0を設定します。

out_len

応答型の要求電文の場合：応答データ長（dc_rpc_call()等で指定したout_len値）を設定します。

応答型の要求電文以外の場合：0を設定します。

ユーザが設定するパラメタ項目

reqtype

要求電文の種別を指定できます。指定できる電文種別は以下の通りです。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

テスト対象システムからの応答電文を待ち合わせる必要がない場合はESFRW_MSGFORM_NOANSWERを指定してください。

要求電文種別は以下の条件を全て満たす場合に設定してください。

プロトコル種別がTCP

要求電文（本番環境）

条件を満たさない場合、設定する必要はありません。システムテスト支援は設定値を無視します。

client_id

電文のクライアント識別子を指定できます。以下の条件を全て満たす場合に設定してください。

テスト実行フェーズ（逐次実行モード）

要求電文（本番環境）

条件を満たさない場合、設定する必要はありません。システムテスト支援は設定値を無視します。

rtn_detail

詳細エラーコードを-2147483648 〜 2147483647の範囲で設定できます。このコードはUOCがES_UOC_NGをリターンしたときにシステム検証支援に返されます。システム検証支援は詳細エラーコードをメッセージログファイルに出力します。

key

ペアリングキーを指定できます。プロトコル種別がTCPの場合だけ設定してください。プロトコル種別がTCP以外のときは、設定する必要はありません。システムテスト支援は設定値を無視します。

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定できます。

このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

ユーザが設定する項目と電文のプロトコルとリターン値の関係

電文のプロトコルがTCPの場合

電文のプロトコルがTCPの場合に、ユーザが設定する項目とリターン値の関係を次に示します。

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_NG

ESPLG_UOC_ABORT

要求電文種別

○※

×

×

×

クライアント識別子

○

×

×

×

詳細エラーコード

×

×

○

×

ペアリングキー

○

×

×

×

強制停止理由コード

×

×

×

○

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

注※

パケットの電文種別がESFRW_MSGTYPE_REQUEST_PROの場合に有効となります。

電文のプロトコルがHTTPの場合

電文のプロトコルがHTTPの場合に、ユーザが設定する項目とリターン値の関係を次に示します。

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_NG

ESPLG_UOC_ABORT

要求電文種別

×

×

×

×

クライアント識別子

○

×

×

×

詳細エラーコード

×

×

○

×

ペアリングキー

×

×

×

×

強制停止理由コード

×

×

×

○

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

電文のプロトコルがRPCの場合

電文のプロトコルがRPCの場合に、ユーザが設定する項目とリターン値の関係を次に示します。

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_NG

ESPLG_UOC_ABORT

要求電文種別

×

×

×

×

クライアント識別子

○

×

×

×

詳細エラーコード

×

×

○

×

ペアリングキー

×

×

×

×

強制停止理由コード

×

×

×

○

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK

正常に電文情報を設定しました。

ESPLG_UOC_MSG_DESTRUCT

電文を破棄します。

ESPLG_UOC_ABORT

電文を強制停止します。

ESPLG_UOC_NG

電文情報設定時にでエラーが発生しました。電文を破棄します。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、システム検証支援はメッセージログを出力し、対象の電文を破棄します。

パラメタerror_flgの値によってUOCリターン時の動作が異なります。

error_flgの値

動作

ESFRW_ERROR_NONE

リターン値ESPLG_UOC_NGでリターンした場合

UOCからESPLG_UOC_NGでリターンした場合、システム検証支援はメッセージログを出力し、対象のメッセージを破棄します。

リターン値ESPLG_UOC_ABORTでリターンした場合

システム検証支援はKFSE64109-Eメッセージを出力し、システム検証支援プロセスを強制停止します。

UOCパラメタ不正の場合

UOCで設定した値に不正があった場合、システム検証支援はメッセージログを出力し、対象の電文を破棄します。

ESFRW_ERROR_NONE以外

リターン値ESPLG_UOC_OKでリターンした場合

システム検証支援は処理を続行します。

リターン値ESPLG_UOC_ABORTでリターンした場合

システム検証支援はKFSE64109-Eメッセージを出力し、システム検証支援プロセスを強制停止します。

上記以外の場合

システム検証支援は処理を続行します。

7.2.5　編集UOC（復元UOC、蓄積編集UOC、送信電文編集UOC、受信電文編集UOC）

機能

編集UOCは、ユーザ任意の電文の送信時、受信時、蓄積時、復元時の電文の編集が行うことができます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(ESPLG_UOC_EDIT *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文の送信時、受信時、蓄積時、復元時に呼び出されるUOCです。

各実行形態と入力電文によるUOC実行の有無を以下に示します。

IIOP以外の場合

フェーズ

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

蓄積実行モード（PCAP）

蓄積

蓄積

×

×

蓄積実行モード（キャプチャ）

蓄積

蓄積

×

×

テスト実行モード

復元

復元

送信＋蓄積（※1）

受信＋蓄積（※2）

（凡例）

送信：電文送信時、編集UOCを実行します。

受信：電文受信時、編集UOCを実行します。

蓄積：電文蓄積時、編集UOCを実行します。

復元：電文復元時（蓄積電文を読み出し時）、編集UOCを実行します。

×：編集UOCを実行しません。

注※1

accumulate_file -t REQTS -f “testuse=Y”が指定されていない場合は、UOCが呼び出されても、電文は蓄積されません

注※2

accumulate_file -t RPYTS -f “testuse=Y”が指定されていない場合は、UOCが呼び出されても、電文は蓄積されません

IIOPの場合

フェーズ

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

PCAP実行

×

×

送信＋蓄積（※1）

受信＋蓄積（※2）

蓄積実行

（電文作成フェーズ）

蓄積

蓄積

×

×

リプレイ実行

（テスト実行フェーズ）

復元

復元

送信＋蓄積（※1）

受信＋蓄積（※2）

（凡例）

送信：電文送信時、編集UOCを実行します。

受信：電文受信時、編集UOCを実行します。

蓄積：電文蓄積時、編集UOCを実行します。

復元：電文復元時（蓄積電文を読み出し時）、編集UOCを実行します。

×：編集UOCを実行しません。

注※1

accumulate_file -t REQTS -f “testuse=Y”が指定されていない場合は、本UOCを呼び出しません。

注※2

accumulate_file -t RPYTS -f “testuse=Y”が指定されていない場合は、本UOCを呼び出しません。

それぞれの電文が編集UOCを呼ぶタイミングは以下の通りです。

蓄積実行モード

要求電文

（本番環境）

本番環境から要求電文をキャプチャ

システム検証支援またはUOCが電文を組み立てる

蓄積時の編集UOCを実行

応答電文

（本番環境）

本番環境から応答電文をキャプチャ

システム検証支援またはUOCが電文を組み立てる

蓄積時の編集UOCを実行

テスト実行モード

要求電文

（本番環境）

復元時の編集UOCを実行

（要求電文（テスト環境）へ続く）

応答電文

（本番環境）

復元時の編集UOCを実行

電文比較UOCを実行

要求電文

（テスト環境）

送信時の編集UOCを実行

テスト環境へ要求電文を送信する

蓄積時の編集UOCを実行

応答電文

（テスト環境）

テスト環境から応答電文を受信する

システム検証支援またはUOCが電文を組み立てる

受信時の編集UOCを実行

システム検証支援がプロトコルレベルの判定を実施

電文比較UOCを実行

（3.で応答電文がプロトコルエラー判定となった場合は

プラグインによりUOC呼び出し有無が異なります。）

蓄積時の編集UOCを実行

対象メッセージのテキスト部のデータは、編集前の電文先頭アドレスに格納されています。編集が必要な場合、編集結果は設定される編集後の電文先頭アドレス以降のエリアに格納してください。プロトコルがTCPまたはHTTPの場合、編集後の電文先頭アドレスのバッファはframework_definition定義の–b max_message_sizeオペランド指定値分を用意しています。プロトコルヘッダを含めてこのバッファサイズを超えて格納しないでください。プロトコルがRPCの場合、framework_definition定義の-bオプションのmax_message_size、および8MBのうち小さい値が電文先頭アドレスのバッファサイズとなります。framework_definition定義の-bオプションのmax_message_size、および8MBのどちらも超えない値を設定してください。

パラメタの内容

ESPLG_UOC_EDITのパラメタ内容

typedef struct es_plg_uoc_edit {
  ESULONG        run_mode;    ………………… 実行形態
  ESULONG        protocol;    ………………… プロトコル種別
  unsigned char  msgtype;     ………………… 電文種別
  unsigned char  reqtype;     ………………… 要求電文種別
  unsigned char  call_timing;    ……………  呼び出し契機
  char           reserve[5];        ………… 予備領域
  ESCOM_IPADDR         src_ip;      ………… 送信元IPアドレス
  ESCOM_IPADDR         dst_ip;      ………… 送信先IPアドレス
  unsigned short src_port;    ………………… 送信元ポート番号
  unsigned short dst_port;    ………………… 送信先ポート番号
  char           reserve2[4];       ………… 予備領域
  ESCOM_AREA usr_tel_area;          ………… 電文単位ユーザ領域（IIOPでは未使用）
  char       usr_tel_area_state;    ………… 電文単位ユーザ領域の状態（IIOPでは未使用）
  char            reserve3[7];  ……………… 予備領域
  ESCOM_AREA usr_clt_area;            ……… クライアント単位ユーザ領域（IIOPでは未使用）
  char       usr_clt_area_state;      ……… クライアント単位ユーザ領域の状態（IIOPでは未使用）
  char            reserve4[7];  ……………… 予備領域
  ESCOM_AREA     rcv_telegram;      ………… 編集前の電文情報
  ESPLG_UOC_TELSIZE rcv_telegram_size;  …… 編集前の電文サイズ
  ESCOM_AREA     edt_telegram       ………… 編集後の電文情報
  ESPLG_UOC_TELSIZE edt_telegram_size;  …… 編集後の電文サイズ
  char           key[64];       ……………… ペアリングキー（IIOPでは未使用）
  void           *protoinf;     ……………… プロトコル情報（IIOP以外は参照出来ません）
  ESULONG        abort_code;      …………… 強制停止理由コード
  char           reserve5[4];   ……………… 予備領域
  void           *protocol_inf;   …………… プロトコル固有の情報（IIOPでは未使用）
  void           *protocol_editinf;   ……… プロトコル固有の編集情報（IIOPでは未使用）
} ESPLG_UOC_EDIT;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;              ……………… IPアドレス（IPv4）
  char reserve[16];             ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];             ……………… 予備領域
  char ip[4];                   ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;               ……………… 領域サイズ
  char      reserve[4];         ……………… 予備領域
  char      *data;              ……………… 領域先頭アドレス
} ESCOM_AREA;

es_frw_telegram_rpc（ESFRW_TELEGRAM_RPC）の内容

typedef struct es_frw_telegram_rpc {
  char      protocol_type;     …………… プロトコル詳細種別
  char      clt_nid[5];        …………… クライアント側ノードID
  char      srv_nid[5];        …………… サーバ側ノードID
  char      reserve1[5];       …………… 予備領域
  char      group[32];   　    …………… サービスグループ名
  char      service[32];       …………… サービス名
  ESLONG    rtncode;           …………… RPCリターンコード
  ESULONG   out_len;           …………… 応答データ長
} ESFRW_TELEGRAM_RPC;

es_frw_send_interface_rpc（ESFRW_SEND_IF_RPC）の内容

typedef struct es_frw_send_interface_rpc {
  char      group[32];       ……………… サービスグループ名
  char      service[32];   ………………… サービス名
  ESULONG   out_len;       ………………… 応答データ長
} ESFRW_SEND_IF_RPC;

ESPLG_UOC_TELSIZEのパラメタ内容

typedef union {
  ESPLG_UOC_HTTPSIZE http_size;   ………… HTTPプロトコルのサイズ格納領域
  ESPLG_UOC_TCPSIZE tcp_size;     ………… TCPプロトコルのサイズ格納領域
} ESPLG_UOC_TELSIZE;

ESPLG_UOC_HTTPSIZEのパラメタ内容

typedef struct es_plg_uoc_httpsize{
  ESULONG header_size;             ………… HTTPヘッダ部サイズ
  ESULONG body_size;               ………… HTTPボディ部サイズ
} ESPLG_UOC_HTTPSIZE;

ESPLG_UOC_TCPSIZEのパラメタ内容

typedef struct es_plg_uoc_tcpsize{
  ESULONG size;                    ………… 電文サイズ
  char reserve[4];
} ESPLG_UOC_TCPSIZE;

es_plg_proto_iiop（ESPLG_PROTO_IIOP）のパラメタ内容

typedef struct es_plg_proto_iiop {
  char protoinf_type;       …………… プロトコル情報種別
  char req_byte_order;      …………… 要求電文バイトオーダー
  char rpy_byte_order;      …………… 応答電文バイトオーダー
  char reserve1[5];         …………… 予備領域
  char *object_key;         …………… オブジェクトキー
  ESULONG object_key_size;  …………… オブジェクトキーサイズ
  char reserve2[4];         …………… 予備領域
  char *operation;          …………… オペレーション名
  ESULONG operation_size;   …………… オペレーション名サイズ
  char reserve3[4];         …………… 予備領域
  void *req_service_context;    ……… 要求電文サービスコンテキスト
  ESULONG req_service_context_size; … 要求電文サービスコンテキストサイズ
  char reserve4[4];         …………… 予備領域
  void *rpy_service_context;    ……… 応答電文サービスコンテキスト
  ESULONG rpy_service_context_size; … 応答電文サービスコンテキストサイズ
  char reserve5[4];          …………… 予備領域
  ESULONG reply_status;      …………… リターン値
  char system1;          ………………… 製品情報1
  char system2;          ………………… 製品情報2
  char system3;          ………………… 製品情報3
  char reserve6[49];          ………… 予備領域
} ESPLG_PROTO_IIOP;

編集前後の電文アドレスと電文長の関係を以下に示します。

TCPの場合

HTTPの場合

IIOPの場合

RPCの場合

システム検証支援が値を設定するESPLG_UOC_EDITパラメタ項目

run_mode

システム検証支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_CREATE_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_IIOP：IIOP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_REQUEST_TST：要求電文（テスト環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

reqtype

要求電文の種別を設定します。

要求電文種別は以下の条件を満たす場合に設定します。

電文種別がESFRW_MSGTYPE_REQUEST_PROまたはESFRW_MSGTYPE_REQUEST_TST

プロトコル種別がESFRW_PROT_TCPの場合、電文増幅UOCで指定された要求電文の種別を設定します。電文増幅UOCを省略した場合、電文情報設定UOCで指定された要求電文の種別を設定します。以下のどちらかとなります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

なお、電文情報設定UOC、電文増幅UOCをともに省略した場合、ESFRW_MSGFORM_SYNC_ANSWERとなります。

プロトコル種別がESFRW_PROT_HTTPの場合、以下となります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

プロトコル種別がESFRW_PROT_IIOPの場合、以下のどちらかとなります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型（プロトコルヘッダ部のみの応答電文含む）

ESFRW_MSGFORM_NOANSWER：非応答型

プロトコル種別がESFRW_PROT_RPCの場合、以下のどれかとなります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

ESFRW_MSGFORM_NOSYNC_ANSWER：非同期応答型

call_timing

編集UOCの呼び出し契機を設定します。

ESPLG_UOC_CALL_SEND：電文送信時の編集UOC呼び出し

ESPLG_UOC_CALL_RECEIVE：電文受信時の編集UOC呼び出し

ESPLG_UOC_CALL_ACCUMULATE：電文蓄積時の編集UOC呼び出し

ESPLG_UOC_CALL_RESTORE：電文復元時の編集UOC呼び出し

src_ip

電文の送信元のIPアドレス※を設定します。

dst_ip

電文の送信先のIPアドレス※を設定します。

src_port

電文の送信元のポート番号をホストバイトオーダーで設定します。

dst_port

電文の送信先のポート番号をホストバイトオーダーで設定します。

usr_tel_area

電文単位に共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

usr_tel_area_state

電文単位ユーザ領域の状態を設定します。電文単位ユーザ領域の状態は電文単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_clt_area

クライアント識別子単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

クライアント識別子単位ユーザ領域のサイズを設定します。

data

クライアント識別子単位ユーザ領域の先頭アドレスを設定します。

usr_clt_area_state

クライアント単位ユーザ領域の状態を設定します。クライアント単位ユーザ領域の状態はクライアント単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

不要となったクライアントのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には処理中の電文のクライアントとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該クライアントのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

rcv_telegram

編集前の電文に関する情報を設定します。

IIOPの場合、ユーザデータ部は、符号化（marshaling）されたCDR形式です。

各メンバには以下の値が設定されています。

size

編集前電文のサイズを設定します。

data

編集前電文の先頭アドレスを設定します。

rcv_telegram_size

プロトコルに応じて編集前電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

IIOPの場合は、電文のサイズをESPLG_UOC_TELSIZE形式（HTTP電文サイズ形式）に設定します。

edt_telegram

編集後の電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

編集後電文の格納領域の最大サイズを設定します。

data

編集後電文の格納領域の先頭アドレスを設定します。

IIOPの場合は、ユーザが設定します。

edt_telegram_size

プロトコル種別ごとの編集後電文のヘッダ領域を設定します。

プロトコルに応じて編集後電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

IIOPの場合は、ESPLG_UOC_TELSIZE形式（HTTP電文サイズ形式）で設定します。

ESPLG_UOC_TELSIZE形式の各パラメタの値はデフォルト値として0を設定します。

key

ユーザが設定する項目です。

システム検証支援では、次の条件をすべて満たす場合だけデフォルト値を設定します。

プロトコル種別がTCP

呼び出し契機がESPLG_UOC_CALL_SEND

要求電文種別がESFRW_MSGFORM_SYNC_ANSWER

蓄積ファイル読み出し時に電文情報設定UOCで設定した要求電文（本番環境）のペアリングキー値を基に、デフォルト値を設定します。要求電文（本番環境）のペアリングキーが、コネクション（本番環境）毎にユニークとなる値（デフォルト値をそのまま使用）の場合、デフォルト値として、コネクション（テスト環境）毎にユニークとなる値を設定します。このデフォルト値を使用したとき、同一コネクションの要求電文と応答電文がペアリングされます。

上記以外の場合、デフォルト値として、要求電文（本番環境）と同じペアリングキーを設定します。

protoinf

プロトコル情報ESPLG_PROTO_IIOPの領域アドレスを設定します。

protocol_inf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

プロトコル種別がESFRW_PROT_RPCの場合：ESFRW_TELEGRAM_RPCを設定します。

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合：NULLを設定します。

protocol_editinf

呼び出し契機がESPLG_UOC_CALL_SENDの場合、プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

プロトコル種別がESFRW_PROT_RPCの場合：ESFRW_SEND_IF_RPCを設定します。

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合：NULLを設定します。

呼び出し契機がESPLG_UOC_CALL_SEND以外の場合：参照できません。

注※

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例）送信元IPが172.165.112.20の場合

group

ユーザが設定する項目です。

システム検証支援では、本番環境のサービスグループ名をデフォルト値として設定します。

service

ユーザが設定する項目です。

システム検証支援では、本番環境のサービス名をデフォルト値として設定します。

out_len

ユーザが設定する項目です。

システム検証支援では、応答型の要求電文の場合は本番環境の応答データ長（dc_rpc_call()等で指定したout_len値）を設定します。それ以外の場合は0を設定します。

システム検証支援が値を設定するes_plg_proto_iiop（ESPLG_PROTO_IIOP）パラメタ項目

protoinf_type

ESPLG_PROTO_IIOPに設定するプロトコル情報の種別を論理和で設定します。

ESPLG_IIOP_MSG_REQUEST：Request電文情報あり

ESPLG_IIOP_MSG_REPLY：Reply電文情報あり

req_byte_order

要求電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

rpy_byte_order

応答電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

object_key※1

オブジェクトキーの格納領域アドレスを設定します。

object_key_size※1

オブジェクトキーのサイズを設定します。

operation※1

オペレーション名の格納領域アドレスを設定します。

operation_size※1

オペレーション名のサイズを設定します。

req_service_context※1 ※2

要求電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

req_service_context_size※1

要求電文のサービスコンテキストサイズを設定します。

サイズが0の場合、要求電文サービスコンテキストは参照できません。

rpy_service_context※2 ※3

応答電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

rpy_service_context_size※3

応答電文のサービスコンテキストサイズを設定します。

サイズが0の場合、応答電文サービスコンテキストは参照できません。

reply_status※3

応答電文のリプライステータス（reply_status）を設定します。

ESPLG_IIOP_NO_EXCEPTION：NO_EXCEPTION

注※1

プロトコル情報種別にESPLG_IIOP_MSG_REQUESTが設定されているときのみ参照可能です。

注※2

各電文のバイトオーダーを考慮して参照してください。

注※3

プロトコル情報種別にESPLG_IIOP_MSG_REPLYが設定されているときのみ参照可能です。

ユーザが設定するパラメタ項目

edt_telegram

IIOPの場合に必要な設定です。

編集後の電文の先頭アドレスおよび編集後の電文長を指定してください。RPCの場合は、編集後電文の格納領域に編集前のプロトコルヘッダ部を含めて編集後の電文を設定してください。

ユーザデータ部は、符号化（marshaling）されたCDR形式で設定してください。

edt_telegram_size

IIOP以外の場合

プロトコルに応じて編集後電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

edt_telegram.data領域に編集後の電文を格納した場合に、各パラメタに正しいサイズを設定してください。

IIOPの場合

編集後電文のヘッダ領域サイズを設定します。プロトコルヘッダ部のサイズは、編集前のプロトコルヘッダ部のサイズをそのまま設定してください。

key

次の条件をすべて満たす場合、ペアとなる要求電文と応答電文で同じ値となるペアリングキーを設定してください。ペアとなる応答電文（テスト環境）の受信時は、電文情報設定UOCにおいて、このペアリングキーと同じ値を設定してください。

プロトコル種別がTCP

呼び出し契機がESPLG_UOC_CALL_SEND

要求電文種別がESFRW_MSGFORM_SYNC_ANSWER

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定してください。

このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

group

本番環境とテスト環境でサービスグループ名が異なる場合、テスト環境のサービスグループ名を設定してください。

service

本番環境とテスト環境でサービス名が異なる場合、テスト環境のサービス名を設定してください。

out_len

本番環境とテスト環境で応答データ長が異なる場合、テスト環境の応答データ長を設定してください。非応答型の場合、設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK

ユーザが編集した電文、および電文長を使用してテストを続行します。

ESPLG_UOC_OK_IN

ユーザが編集する前の電文、および編集する前の電文長を使用してテストを続行します。

ESPLG_UOC_NG

電文を破棄します。破棄した電文はテスト対象システムへの送信、蓄積ファイルへの蓄積、電文ン比較の対象になりません。

ES_UOC_ABORT

異常リターン。KFSE64109-Eメッセージを出力し、プロセスダウンします。

ESPLG_UOC_MSG_DESTRUCT

電文を破棄します。破棄した電文はテスト対象システムへの送信、蓄積ファイルへの蓄積、結果判定の対象になりません。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

注意事項

TCP、HTTP、RPC場合

UOCで設定した値に不正があった場合、対象の電文を破棄します。

編集前の電文先頭アドレスにある電文を編集しないでください。電文を編集した場合、その後の処理の保証はできません。

TCP、HTTPの場合

テキスト部に、framework_definition定義における-bオプションのmax_message_sizeオペランド指定値以上を格納した場合、対象メッセージを含め、その後の処理の保障はできません。

IIOPの場合

編集前の電文情報、及びプロトコルヘッダ部を編集しないでください。編集した場合、その後の処理の保障はできません。

編集後の電文情報格納領域サイズは編集しないでください。

編集後の電文サイズは、プロトコルヘッダを含めてframework_definition定義の-bオプションのmax_message_sizeフラグメンバ指定値以下となるようにしてください。

7.2.6　結果判定UOC

機能

結果判定UOCは、比較対象の応答電文と、テスト対象システムからの応答電文の比較や、要求電文から応答電文の妥当性の判定を行うことができます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(ESPLG_UOC_JUDGE *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

比較対象の応答電文と、テスト対象システムからの応答電文の両方を受信時に呼び出されるUOCです。

テスト比較支援機能のプラグイン使用時は、システム検証支援がエラーを検知した場合（要求電文の送信失敗等）も、本UOCを呼び出します。この場合、システム検証支援が自動的にエラーと判定するため、UOCでは結果判定は不要です。必要に応じて後処理（独自確保したリソースの解放等）のみを行ってください。

各実行形態と入力電文によるUOC実行の有無を以下に示します。

IIOP以外の場合

フェーズ

比較対象の応答電文と

テスト対象システムからの応答電文を受信

電文作成フェーズ（PCAP）

×

電文作成フェーズ（キャプチャ）

×

テスト実行フェーズ

○

（凡例）

○：UOCが実行される

×：UOCは実行されない

IIOPの場合

フェーズ

テスト対象システムから応答電文を受信

PCAP実行

○

蓄積実行

（電文作成フェーズ）

×

リプレイ実行

（テスト実行フェーズ）

○

（凡例）

○：UOCが実行される

×：UOCは実行されない

パラメタの内容

ESPLG_UOC_JUDGEのパラメタ内容

typedef struct es_plg_uoc_judge {
  ESULONG        run_mode;         ……………… 実行形態
  ESULONG       protocol;          ……………… プロトコル種別
  ESULONG       error_level;         …………… エラーレベル
  ESULONG       error_flg;       ………………… エラー情報（IIOPでは未使用）
  ESCOM_AREA ext_request_tel_area;         …… 電文単位ユーザ領域（本番要求）（IIOPでは未使用）
  char      ext_request_tel_area_state;    …… 電文単位ユーザ領域（本番要求）の状態（IIOPでは未使用）
  char           reserve2[7];      ……………… 予備領域
  ESCOM_AREA ext_reply_tel_area;         ……… 電文単位ユーザ領域（本番応答）（IIOPでは未使用）
  char      ext_reply_tel_area_state;    ……… 電文単位ユーザ領域（本番応答）の状態（IIOPでは未使用）
  char           reserve3[7];      ……………… 予備領域
  ESCOM_AREA test_request_tel_area;      ……… 電文単位ユーザ領域（テスト要求）（IIOPでは未使用）
  char   test_request_tel_area_state;      …… 電文単位ユーザ領域（テスト要求）の状態（IIOPでは未使用）
  char           reserve4[7];      ……………… 予備領域
  ESCOM_AREA test_reply_tel_area;        ……… 電文単位ユーザ領域（テスト応答）（IIOPでは未使用）
  char   test reply_tel_area_state;      ……… 電文単位ユーザ領域（テスト応答）の状態（IIOPでは未使用）
  char           reserve5[7];      ……………… 予備領域
  ESCOM_AREA usr_clt_area;               ……… クライアント単位ユーザ領域（IIOPでは未使用）
  char       usr_clt_area_state;         ……… クライアント単位ユーザ領域の状態（IIOPでは未使用）
  char            reserve6[7];     ……………… 予備領域
  ESCOM_AREA     ext_request           ………… 要求電文（本番環境）の情報（IIOPでは未使用）
  ESPLG_UOC_TELSIZE ext_request_size;  ………… 要求電文（本番環境）のサイズ（IIOPでは未使用）
  ESCOM_AREA     ext_reply;            ………… 応答電文（本番環境）の情報（IIOPでは未使用）
  ESPLG_UOC_TELSIZE ext_reply_size;    ………… 応答電文（本番環境）の電文長（IIOPでは未使用）
  ESCOM_AREA     test_request;       …………… 要求電文（テスト環境）の先頭アドレス（IIOPでは「要求電文（テスト環境）の情報」）
  ESPLG_UOC_TELSIZE test_request_size; ………… 要求電文（テスト環境）の電文長
  ESCOM_AREA     test_reply;         …………… 応答電文（テスト環境）の先頭アドレス（IIOPでは「応答電文（テスト環境）の情報」）
  ESPLG_UOC_TELSIZE test_reply_size;   ………… 応答電文（テスト環境）の電文長
  ESLONG         user_code;            ………… ユーザ情報コード
  char           user_info[256];         ……… ユーザ情報文字列
  void           *protoinf;        ……………… プロトコル情報（IIOP以外は参照出来ません）
  ESULONG        abort_code;         …………… 強制停止理由コード
  char           reserve7[4];      ……………… 予備領域
  void           *ext_request_protocol_inf; … プロトコル固有の情報（本番要求）（IIOPでは未使用）
  void           *ext_reply_protocol_inf; …… プロトコル固有の情報（本番応答）（IIOPでは未使用）
  void           *test_request_protocol_inf;… プロトコル固有の情報（テスト要求）（IIOPでは未使用）
  void           *test reply_protocol_inf;  … プロトコル固有の情報（テスト応答）（IIOPでは未使用）
} ESPLG_UOC_JUDGE;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;                       ……………… 領域サイズ
  char      reserve[4];                 ……………… 予備領域
  char      *data;                      ……………… ユーザ領域先頭アドレス
} ESCOM_AREA;

es_frw_telegram_rpc（ESFRW_TELEGRAM_RPC）のパラメタ内容

typedef struct es_frw_telegram_rpc {
  char      protocol_type;     ………… プロトコル詳細種別
  char      clt_nid[5];        ………… クライアント側ノードID
  char      srv_nid[5];        ………… サーバ側ノードID
  char      reserve1[5];       ………… 予備領域
  char      group[32];   　    ………… サービスグループ名
  char      service[32];       ………… サービス名
  ESLONG    rtncode;           ………… RPCリターンコード
  ESULONG   out_len;           ………… 応答データ長
} ESFRW_TELEGRAM_RPC;

ESPLG_UOC_TELSIZEのパラメタ内容

typedef union {
  ESPLG_UOC_HTTPSIZE http_size;   …………HTTPプロトコルのサイズ格納領域
  ESPLG_UOC_TCPSIZE tcp_size;     …………TCPプロトコルのサイズ格納領域
} ESPLG_UOC_TELSIZE;

ESPLG_UOC_HTTPSIZEのパラメタ内容

typedef struct es_plg_uoc_httpsize{
  ESULONG header_size;             …………HTTPヘッダ部サイズ
  ESULONG body_size;               …………HTTPボディ部サイズ
} ESPLG_UOC_HTTPSIZE;

ESPLG_UOC_TCPSIZEのパラメタ内容

typedef struct es_plg_uoc_tcpsize{
  ESULONG size;                    …………電文サイズ
  char reserve[4];
} ESPLG_UOC_TCPSIZE;

es_plg_proto_iiop（ESPLG_PROTO_IIOP）のパラメタ内容

typedef struct es_plg_proto_iiop {
  char protoinf_type;       …………… プロトコル情報種別
  char req_byte_order;      …………… 要求電文バイトオーダー
  char rpy_byte_order;      …………… 応答電文バイトオーダー
  char reserve1[5];         …………… 予備領域
  char *object_key;         …………… オブジェクトキー
  ESULONG object_key_size;  …………… オブジェクトキーサイズ
  char reserve2[4];         …………… 予備領域
  char *operation;          …………… オペレーション名
  ESULONG operation_size;   …………… オペレーション名サイズ
  char reserve3[4];         …………… 予備領域
  void *req_service_context;    ……… 要求電文サービスコンテキスト
  ESULONG req_service_context_size; … 要求電文サービスコンテキストサイズ
  char reserve4[4];          …………… 予備領域
  void *rpy_service_context;     ……… 応答電文サービスコンテキスト
  ESULONG rpy_service_context_size;  … 応答電文サービスコンテキストサイズ
  char reserve5[4];          …………… 予備領域
  ESULONG reply_status;      …………… リターン値
  char system1;          ………………… 製品情報1
  char system2;          ………………… 製品情報2
  char system3;          ………………… 製品情報3
  char reserve6[49];           ………… 予備領域
} ESPLG_PROTO_IIOP;

システム検証支援が値を設定するESPLG_UOC_JUDGEパラメタ項目

run_mode

システム検証支援の実行形態を設定します。

IIOP以外の場合

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

IIOPの場合

ESFRW_RUNMODE_CREATE_C：PCAP実行

ESFRW_RUNMODE_TEST_R：リプレイ実行（テスト実行フェーズ）

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_IIOP：IIOP

ESFRW_PROT_RPC：RPC

error_level

ユーザが設定する項目です。システムテスト支援ではデフォルト値として2を設定します。

error_flg

システム検証支援が検知したエラー有無、およびエラー内容を設定します。以下のいずれかとなります。

ESFRW_ERROR_NONE：エラー無し

ESFRW_ERROR_SEND_CON：コネクション確立失敗による送信不可

ESFRW_ERROR_SEND_CANCEL：送信編集UOCの電文破棄指示により送信取消し

ESFRW_ERROR_SEND：送信失敗

ESFRW_ERROR_RECV_CON：コネクション切断による受信不可

ESFRW_ERROR_RECV_TIMEOUT：応答待ちタイムアウトによる受信不可

ESFRW_ERROR_LISTEN_PORT：Listenポートオープン失敗による応答受信不可（プロトコル種別がESFRW_PROT_RPCの場合だけ設定される）

ESFRW_ERROR_SEND_RAPCON：常設コネクション確立失敗による送信不可

設定値がESFRW_ERROR_NONE以外の場合、以下に示すパラメタのみ参照・設定可能です。

参照可能なパラメタ

run_mode

protocol

設定可能なパラメタ

abort_code

上記以外のパラメタは参照・設定しないでください。

ext_request_tel_area

本番要求電文の電文単位ユーザ領域を設定します。※1

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

ext_request_tel_area_state

電文単位ユーザ領域（本番要求）の状態を設定します。電文単位ユーザ領域（本番要求）の状態は電文単位ユーザ領域（本番要求）の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

ext_reply_tel_area

本番応答電文の電文単位ユーザ領域を設定します。※1

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

ext_reply_tel_area_state

電文単位ユーザ領域（本番応答）の状態を設定します。電文単位ユーザ領域（本番応答）の状態は電文単位ユーザ領域（本番応答）の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

test_request_tel_area

テスト要求電文の電文単位ユーザ領域を設定します。※1

各メンバには以下の値が設定されています。

size

電文単位ユーザ領域のサイズを設定します。

data

電文単位ユーザ領域の先頭アドレスを設定します。

test_request_tel_area_state

電文単位ユーザ領域（テスト要求）の状態を設定します。電文単位ユーザ領域（テスト要求）の状態は電文単位ユーザ領域（テスト要求）の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

test_reply_tel_area_state

電文単位ユーザ領域（テスト応答）の状態を設定します。電文単位ユーザ領域（テスト応答）の状態は電文単位ユーザ領域（テスト応答）の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_clt_area

クライアント識別子単位で共有するユーザ領域を設定します。※1

各メンバには以下の値が設定されています。

size

クライアント識別子単位ユーザ領域のサイズを設定します。

data

クライアント識別子単位ユーザ領域の先頭アドレスを設定します。

usr_clt_area_state

クライアント単位ユーザ領域の状態を設定します。クライアント単位ユーザ領域の状態はクライアント単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

不要となったクライアントのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には処理中の電文のクライアントとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該クライアントのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

ext_request

本番要求の電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

電文のサイズを設定します。

data

電文の先頭アドレスを設定します。

ext_request_size

プロトコルに応じて本番要求電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

ext_reply

本番応答の電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

電文のサイズを設定します。

data

電文の先頭アドレスを設定します。

ext_reply_size

プロトコルに応じて本番応答電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

test_request

テスト要求の電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

電文のサイズを設定します。

data

電文の先頭アドレスを設定します。

test_request_size

プロトコルに応じてテスト要求電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

test_reply

テスト応答の電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

電文のサイズを設定します。

data

電文の先頭アドレスを設定します。

test_reply_size

プロトコルに応じてテスト応答電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

protoinf

プロトコル情報ESPLG_PROTO_IIOPの領域アドレスを設定します。

注※1

各ユーザ領域には排他処理を実施していないため、更新時に競合しないように注意してください。

ext_request_protocol_inf

プロトコル固有の情報を格納した構造体のアドレスを設定します。

プロトコル種別がESFRW_PROT_RPCの場合

ESFRW_TELEGRAM_RPC

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合

NULL

各プロトコル用の構造体にキャストして使用してください。

ext_reply_protocol_inf

プロトコル固有の情報を格納した構造体のアドレスを設定します。

プロトコル種別がESFRW_PROT_RPCの場合

ESFRW_TELEGRAM_RPC

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合

NULL

各プロトコル用の構造体にキャストして使用してください。

test_request_protocol_inf

プロトコル固有の情報を格納した構造体のアドレスを設定します。

プロトコル種別がESFRW_PROT_RPCの場合

ESFRW_TELEGRAM_RPC

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合

NULL

各プロトコル用の構造体にキャストして使用してください。

test reply_protocol_inf

プロトコル固有の情報を格納した構造体のアドレスを設定します。

プロトコル種別がESFRW_PROT_RPCの場合

ESFRW_TELEGRAM_RPC

プロトコル種別がESFRW_PROT_TCPまたはESFRW_PROT_HTTPの場合

NULL

各プロトコル用の構造体にキャストして使用してください。

システム検証支援が値を設定するes_plg_proto_iiop（ESPLG_PROTO_IIOP）パラメタ項目

protoinf_type

ESPLG_PROTO_IIOPに設定するプロトコル情報の種別を論理和で設定します。

ESPLG_IIOP_MSG_REQUEST：Request電文情報あり

ESPLG_IIOP_MSG_REPLY：Reply電文情報あり

req_byte_order

要求電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

rpy_byte_order

応答電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

object_key※1

オブジェクトキーの格納領域アドレスを設定します。

object_key_size※1

オブジェクトキーのサイズを設定します。

operation※1

オペレーション名の格納領域アドレスを設定します。

operation_size※1

オペレーション名のサイズを設定します。

req_service_context※1 ※2

要求電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

req_service_context_size※1

要求電文のサービスコンテキストサイズを設定します。

サイズが0の場合、要求電文サービスコンテキストは参照できません。

rpy_service_context※2 ※3

応答電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

rpy_service_context_size※3

応答電文のサービスコンテキストサイズを設定します。

サイズが0の場合、応答電文サービスコンテキストは参照できません。

reply_status※3

応答電文のリプライステータス(reply_status)を設定します。

ESPLG_IIOP_NO_EXCEPTION：NO_EXCEPTION

注※1

プロトコル情報種別にESPLG_IIOP_MSG_REQUESTが設定されているときのみ参照可能です。

注※2

各電文のバイトオーダーを考慮して参照してください。

注※3

プロトコル情報種別にESPLG_IIOP_MSG_REPLYが設定されているときのみ参照可能です。

ユーザが設定するパラメタ項目

error_level

UOCでテスト失敗と判断（ESPLG_UOC_NOMATCH）した場合、KFSE84003-Iメッセージで出力するエラーレベルを2〜3の範囲で設定します。範囲外を指定した場合、システムテスト支援はKFSE54101-E メッセージを表示し、結果ファイルのユーザ情報コードに「0」、ユーザ情報文字列に「PLUGIN-ERROR」を出力します。

user_code

ESPLG_UOC_NOMATCHを返すとき、情報として結果ファイルに出力したいユーザ任意のコードを-2147483648 〜 2147483647の範囲で設定してください。

user_info

ESPLG_UOC_NOMATCHを返すとき、情報として結果ファイルに出力したいユーザ任意の文字列を設定してください。文字列の最後にはnull文字を設定してください。

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定してください。このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

リターン値

次のコードでリターン値を設定してください。

error_flgの値がESFRW_ERROR_NONEのとき

ESPLG_UOC_OK

データ比較が一致しました。

ESPLG_UOC_ABORT

強制停止しました。

ESPLG_UOC_NOMATCH、および上記以外

データ比較が不一致でした。

error_flgの値がESFRW_ERROR_NONE以外のとき

ESPLG_UOC_OK

システム検証支援プロセスを続行しました。

ESPLG_UOC_ABORT

強制停止しました。

上記以外

システム検証支援プロセスを続行しました。

注意事項

電文を編集した場合、その後の処理の保証はできません。

7.2.7　電文増幅UOC（電文追加UOC）

機能

電文ファイルから読み出した電文の増幅または破棄が行えます。

IIOPの場合、要求電文を複製して、電文数およびクライアント数の追加を行うことが出来ます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(ESPLG_UOC_AMPLIFY *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文の増幅または破棄時に呼び出されるUOCです。

IIOPの場合、送信電文編集UOC前に呼び出されるUOCです。本UOCのリターン値によっては、同じ要求電文に対して本UOCが再度呼び出されます。

各実行形態と入力電文によるUOC実行の有無を以下の表に示します。

IIOP以外の場合

フェーズ

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

電文作成フェーズ（PCAP）

×

×

×

×

電文作成フェーズ（キャプチャ）

×

×

×

×

テスト実行フェーズ

○

×

×

×

（凡例）

○：UOCが実行される

×：UOCは実行されない

IIOPの場合

フェーズ

本番環境

テスト環境

要求電文

応答電文

要求電文

応答電文

PCAP実行

○

×

×

×

蓄積実行

（電文作成フェーズ）

×

×

×

×

リプレイ実行

（テスト実行フェーズ）

○

×

×

×

（凡例）

○：UOCが実行される

×：UOCは実行されない

パラメタの内容

ESPLG_UOC_AMPLIFYのパラメタ内容

typedef struct es_plg_uoc_amplify {
  ESULONG run_mode; …………………     実行形態
  ESULONG protocol; …………………     プロトコル種別
  unsigned char msgtype; ………………… 電文種別
  unsigned char reqtype; ………………… 要求電文種別
  char reserve[6]; ………………         予備領域
  ESCOM_IPADDR src_ip; …………………… 送信元IPアドレス
  ESCOM_IPADDR dst_ip; …………………… 送信先IPアドレス
  unsigned short src_port; ……………… 送信元ポート番号
  unsigned short dst_port; ……………… 送信先ポート番号
  char reserve2[4]; ……………          予備領域
  ESCOM_AREA usr_tel_area; ……………   電文単位ユーザ領域（IIOPでは未使用）
  char usr_tel_area_state; ……         電文単位ユーザ領域の状態（IIOPでは未使用）
  char reserve3[7]; ……………          予備領域
  ESCOM_AREA usr_con_area; ……………   コネクション単位ユーザ領域（IIOPでは未使用）
  char usr_con_area_state; ……         コネクション単位ユーザ領域の状態（IIOPでは未使用）
  char reserve4[7]; ……………           予備領域
  ESCOM_AREA telegram; …………………    電文情報
  ESPLG_UOC_TELSIZE telegram_size; ……  電文サイズ
  ESULONG amp_telegram_interval; ……    電文送信間隔（IIOPでは「電文追加の送信間隔」）
  ESULONG amp_client_cnt; …………       クライアント増幅数
  ESULONG amp_client_delay; ………       クライアント増幅の遅延時間
  ESLONG         rtn_detail; ……………… 詳細エラーコード（IIOPでは未使用）
  void *protoinf; ………………            プロトコル情報（IIOP以外は参照出来ません）
  ESULONG         abort_code;……………   強制停止理由コード（IIOPでは未使用）
  char           amp_client_interval; … クライアント増幅間隔有無
  char           reserve5[3]; ……………  予備領域
  void           *protocol_telinf; ……  プロトコル固有情報（IIOPでは未使用）
} ESPLG_UOC_AMPLIFY;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4; ………………  IPアドレス（IPv4）
  char reserve[16]; ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12]; ……………… 予備領域
  char ip[4]; ………………       IPアドレス（IPv4）
} ESCOM_IPV4;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG size; ………………    領域サイズ
  char reserve[4]; ……………… 予備領域
  char *data; ………………      領域先頭アドレス
} ESCOM_AREA;

ESPLG_UOC_TELSIZEのパラメタ内容

typedef union {
  ESPLG_UOC_HTTPSIZE http_size; ………… HTTPプロトコルのサイズ格納領域
  ESPLG_UOC_TCPSIZE tcp_size; …………   TCPプロトコルのサイズ格納領域
  ESPLG_UOC_RPCSIZE rpc_size; …………   RPCプロトコルのサイズ格納領域
} ESPLG_UOC_TELSIZE;

ESPLG_UOC_HTTPSIZEのパラメタ内容

typedef struct es_plg_uoc_httpsize{
ESULONG header_size; …………HTTPヘッダ部サイズ
ESULONG body_size; …………HTTPボディ部サイズ
} ESPLG_UOC_HTTPSIZE;

ESPLG_UOC_TCPSIZEのパラメタ内容

typedef struct es_plg_uoc_tcpsize{
ESULONG size; …………電文サイズ
char reserve[4];
} ESPLG_UOC_TCPSIZE;

es_plg_proto_iiop（ESPLG_PROTO_IIOP）のパラメタ内容

typedef struct es_plg_proto_iiop {
char protoinf_type; …………… プロトコル情報種別
char req_byte_order; …………… 要求電文バイトオーダー
char rpy_byte_order; …………… 応答電文バイトオーダー
char reserve1[5]; …………… 予備領域
char *object_key; …………… オブジェクトキー
ESULONG object_key_size; …………… オブジェクトキーサイズ
char reserve2[4]; …………… 予備領域
char *operation; …………… オペレーション名
ESULONG operation_size; …………… オペレーション名サイズ
char reserve3[4]; …………… 予備領域
void *req_service_context;……… 要求電文サービスコンテキスト
ESULONG req_service_context_size; … 要求電文サービスコンテキストサイズ
char reserve4[4]; …………… 予備領域
void *rpy_service_context;……… 応答電文サービスコンテキスト
ESULONG rpy_service_context_size; … 応答電文サービスコンテキストサイズ
char reserve5[4]; …………… 予備領域
ESULONG reply_status; …………… リターン値
char system1; ………………… 製品情報1
char system2; ………………… 製品情報2
char system3; ………………… 製品情報3
char reserve6[49]; ………… 予備領域
} ESPLG_PROTO_IIOP;

es_frw_telegram_rpc（ESFRW_TELEGRAM_RPC）の内容

typedef struct es_frw_telegram_rpc {
char protocol_type; …………… プロトコル詳細種別
char clt_nid[5]; ………………  クライアント側ノードID
char srv_nid[5]; ………………  サーバ側ノードID
char reserve1[5]; ……………… 予備領域
char group[32]; ………………… サービスグループ名
char service[32]; ……………… サービス名
ESLONG rtncode; ………………… RPCリターンコード
ESULONG out_len; ………………  応答データ長
} ESFRW_TELEGRAM_RPC;

電文アドレスと電文長の関係を以下に示します。

システム検証支援が値を設定するパラメタ項目

ESPLG_UOC_AMPLIFYのパラメタ内容

run_mode

システム検証支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_C：PCAP実行

ESFRW_RUNMODE_TEST_R：リプレイ実行（テスト実行フェーズ）

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_IIOP：IIOP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

reqtype

プロトコル種別がESFRW_PROT_TCPの場合、ユーザが設定する値です。

システム検証支援基盤は、電文情報設定UOCで設定された、次のどちらかの要求電文種別を設定します。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型（プロトコルヘッダ部だけの応答電文含む）

ESFRW_MSGFORM_NOANSWER：非応答型

なお、電文情報設定UOCを省略した場合、システム検証支援はデフォルト値（ESFRW_MSGFORM_SYNC_ANSWER（同期応答型））を設定します。

プロトコル種別がESFRW_PROT_HTTPの場合、システム検証支援は次の値を設定します。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

プロトコル種別がESFRW_PROT_RPCの場合、システム検証支援は次のどれかを設定します。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

ESFRW_MSGFORM_NOSYNC_ANSWER：非同期応答型

src_ip

パケット（電文）の送信元のIPアドレスを設定します。※1

dst_ip

パケット（電文）の送信先のIPアドレスを設定します。※1

src_port

パケット（電文）の送信元のポート番号をホストバイトオーダーで設定します。

dst_port

パケット（電文）の送信先のポート番号をホストバイトオーダーで設定します。

usr_tel_area

電文単位に共有するユーザ領域をESCOM_AREA構造体で設定します。各メンバには以下の値が設定されています。

領域サイズ

電文単位ユーザ領域のサイズを設定します。

ユーザ領域先頭アドレス

電文単位ユーザ領域の先頭アドレスを設定します。

usr_tel_area_state

電文単位ユーザ領域の状態を設定します。電文単位ユーザ領域の状態は電文単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

処理済みとなった電文のユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在処理している電文とは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該電文のユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

usr_con_area

コネクション単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

領域サイズ

コネクション単位ユーザ領域のサイズを設定します。

ユーザ領域先頭アドレス

コネクション単位ユーザ領域の先頭アドレスを設定します。

usr_con_area_state

コネクション単位ユーザ領域の状態を設定します。コネクション単位ユーザ領域の状態はコネクション単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割当てられた領域であることを示します。

ESFRW_CONTST_RENEW

切断されたコネクションのユーザ領域が再割当てされて、通知されたことを示します。ユーザ領域内には現在のコネクションとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化等を実施して使用してください。

ESFRW_CONTST_CONTINUE

当該コネクションのユーザ領域として、UOCに通知済の領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

telegram

入力電文に関する情報を設定します。

IIOPの場合、電文に関する情報を設定します。ユーザデータ部は、符号化（marshaling）されたCDR形式です。

各メンバには以下の値が設定されています。

size

電文のサイズを設定します。

data

電文の先頭アドレスを設定します。

telegram_size

HTTPまたはTCPの場合、入力電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

protoinf

IIOPの場合、プロトコル情報ESPLG_PROTO_IIOPの領域アドレスを設定します。

注※1

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例）送信元IPが172.165.112.20の場合

es_plg_proto_iiop（ESPLG_PROTO_IIOP）のパラメタ内容

protoinf_type

ESPLG_PROTO_IIOPに設定するプロトコル情報の種別を論理和で設定します。

ESPLG_IIOP_MSG_REQUEST：Request電文情報あり

ESPLG_IIOP_MSG_REPLY：Reply電文情報あり

req_byte_order

要求電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

rpy_byte_order

応答電文のバイトオーダーを設定します。

ESPLG_IIOP_BIG_ENDIAN：ビッグエンディアン

ESPLG_IIOP_LITTLE_ENDIAN：リトルエンディアン

object_key※1

オブジェクトキーの格納領域アドレスを設定します。

object_key_size※1

オブジェクトキーのサイズを設定します。

operation※1

オペレーション名の格納領域アドレスを設定します。

operation_size※1

オペレーション名のサイズを設定します。

req_service_context※1 ※2

要求電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

req_service_context_size※1

要求電文のサービスコンテキストサイズを設定します。

サイズが0の場合、要求電文サービスコンテキストは参照できません。

rpy_service_context※2 ※3

応答電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

rpy_service_context_size※3

応答電文のサービスコンテキストサイズを設定します。

サイズが0の場合、応答電文サービスコンテキストは参照できません。

reply_status※3

応答電文のリプライステータス（reply_status）を設定します。

ESPLG_IIOP_NO_EXCEPTION：NO_EXCEPTION

注※1

プロトコル情報種別にESPLG_IIOP_MSG_REQUESTが設定されているときのみ参照可能です。

注※2

各電文のバイトオーダーを考慮して参照してください。

注※3

プロトコル情報種別にESPLG_IIOP_MSG_REPLYが設定されているときのみ参照可能です。

ユーザが設定するパラメタ項目

amp_telegram_interval

「電文増幅（電文追加）」を行う場合（ESFRW_OK_RECALLでリターン）、増幅した電文の送信間隔（当該電文と増幅電文の送信時間差異）を設定します。0～3600000（単位：ミリ秒）

0（デフォルト値）を指定した場合は、即時に送信します。

本設定値は実行形態関連定義reply_send_modeの影響を受けます。

倍速送信実行時は、同定義で指定された倍速値で短縮した送信間隔となります。等間隔送信実行時、および連続送信実行時は、本設定値を無視します。

reply_send_modeを省略した場合、システム検証支援は連続送信実行を行うため、設定を倍速送信実行にする必要があります。以下に例を示します。

例）

reply_send_mode ¥
  -m wait -s 1

amp_client_cnt

「クライアント増幅」を行う場合、電文を複製するクライアント数を設定します。0～20000

0を設定した場合は、クライアント増幅による複製を行いません。

amp_client_delay

クライアント増幅による送信開始を遅延させる時間を設定します。0～3600000（単位：ミリ秒）。

amp_client_delayを1000ミリ秒に設定する例）

parm-> amp_client_delay=1000;

amp_client_interval

クライアント増幅間隔の有無を設定します。

クライアント増幅数が2以上のときに有効となります。

ESCOM_YES（デフォルト値）

送信間隔を空けてクライアント増幅します。

ESCOM_NO

送信間隔を空けないでクライアント増幅します。

rtn_detail

詳細エラーコードを設定します。-2147483648 ～ 2147483647

このコードはUOCがESPLG_UOC_NGをリターンしたときだけ有効です。システム検証支援は詳細エラーコードをKFSE54101-Eに出力します。

reqtype

要求電文の種別を指定できます。リターン値ESPLG_UOC_OK_RECALLを返した（電文を増幅してUOC関数を再度呼び出した）場合、電文情報プラグイン設定UOCが呼び出されないため、この項目を設定してください。

指定できる電文種別は次のとおりです。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

テスト対象システムからの応答電文を待ちます。

ESFRW_MSGFORM_NOANSWER：非応答型

テスト対象システムからの応答電文を待たずに、次の要求電文を送信します。

要求電文種別は次の条件をすべて満たす場合に設定してください。

プロトコル種別がTCP

要求電文（本番環境）

条件を満たさない場合、設定する必要はありません。システム検証支援基盤は設定値を無視します。

ユーザが設定する項目とリターン値の関係を次に示します。

電文のプロトコルがTCPの場合

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_OK_RECALL

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_ABORT

ESPLG_UOC_NG（※）

amp_telegram_interval

（電文送信間隔）

×

○

×

×

×

amp_client_cnt

（クライアント増幅数）

○

○

×

×

×

amp_client_delay

（クライアント増幅の遅延時間）

○

○

×

×

×

rtn_detail

（詳細エラーコード）

×

×

×

×

○

abort_code

（強制停止理由コード）

×

×

×

○

×

reqtype

要求電文種別

○

○

×

×

×

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

注※

表のリターン値以外の場合を含みます。

電文のプロトコルがHTTPの場合

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_OK_RECALL

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_ABORT

ESPLG_UOC_NG（※）

amp_telegram_interval

（電文送信間隔）

×

○

×

×

×

amp_client_cnt

（クライアント増幅数）

○

○

×

×

×

amp_client_delay

（クライアント増幅の遅延時間）

○

○

×

×

×

rtn_detail

（詳細エラーコード）

×

×

×

×

○

abort_code

（強制停止理由コード）

×

×

×

○

×

reqtype

要求電文種別

×

×

×

×

×

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

注※

表のリターン値以外の場合を含みます。

電文のプロトコルがRPCの場合

項目

リターン値

ESPLG_UOC_OK

ESPLG_UOC_OK_RECALL

ESPLG_UOC_MSG_DESTRUCT

ESPLG_UOC_ABORT

ESPLG_UOC_NG（※）

amp_telegram_interval

（電文送信間隔）

×

○

×

×

×

amp_client_cnt

（クライアント増幅数）

○

○

×

×

×

amp_client_delay

（クライアント増幅の遅延時間）

○

○

×

×

×

rtn_detail

（詳細エラーコード）

×

×

×

×

○

abort_code

（強制停止理由コード）

×

×

×

○

×

reqtype

要求電文種別

×

×

×

×

×

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

注※

表のリターン値以外の場合を含みます。

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK

電文を増幅・破棄せず、次の処理に移ります。

クライアント増幅の設定に従い、クライアント増幅による電文の複製を行います。

ESPLG_UOC_OK_RECALL

クライアント増幅数の設定に従い、クライアント増幅による電文の複製を行います。

その後、電文追加を行うため、本UOCの再度呼び出しを行います。

ESPLG_UOC_MSG_DESTRUCT

電文を破棄して、次の処理に移ります。

ESPLG_UOC_ABORT

KFSE64109-Eメッセージを出力し、システム検証支援プロセスを強制停止します。

ESPLG_UOC_NG、および上記以外

KFSE54101-Eメッセージを出力します。そして、電文を増幅・破棄せず、次の処理に移ります。

要求電文の複製を行いません。

IIOPの場合、次のリターン値以外は、ESPLG_UOC_NGとして処理を行います。

ESPLG_UOC_OK

ESPLG_UOC_OK_RECALL

注意事項

電文の内容を変更した場合、該当電文の内容、およびその後の処理の保障はできません。

7.3　プラグインインタフェース

ユーザテスト支援フレームワーク機能で使用するプラグインについて説明します。

7.3.1　概要

各フェーズで起動するプラグイン

各フェーズで起動するプラグインについて、以下に示します。

表7‒3　各フェーズで使用可能なプラグイン

プラグイン名

フェーズ

電文作成フェーズ

テスト実行フェーズ

バッチ実行フェーズ

開始終了プラグイン

○

○

○

電文組立プラグイン※1

○

○

×

電文情報プラグイン

○

○

×

電文編集プラグイン

○

○

×

電文送信プラグイン

×

○

×

電文受信プラグイン

×

○

×

結果判定プラグイン

×

○

×

電文選択プラグイン

×

○※2

×

電文増幅プラグイン

×

○※3 ※4

×

バッチ用プラグイン

×

×

○

（凡例）

○：使用可能

×：使用不可

注※1

プロトコルがTCPの場合のみ

注※2

シナリオ実行モードのみ

注※3

逐次実行モードのみ

注※4

プロトコルがHTTPの場合のみ

各フェーズのプラグイン実行順序

プラグインの実行順序を以下に示します。なお、図中のESFRW_TIMING_xxxxxは、プラグイン呼出時の引数です。

電文作成フェーズ

図7‒5　電文作成フェーズのプラグイン実行順序

テスト実行フェーズ（逐次実行モード）

図7‒6　テスト実行フェーズ（逐次実行モード）のプラグイン実行順序

テスト実行フェーズ（シナリオ実行モード）

図7‒7　テスト実行フェーズ（シナリオ実行モード）のプラグイン実行順序

バッチ実行フェーズ

図7‒8　バッチ実行フェーズのプラグイン実行順序

7.3.2　開始終了プラグイン

機能

プラグインの開始終了処理を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_STEN_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

システムテスト支援プロセスの開始／終了時に1回だけ呼び出されるプラグインです。

プラグインでは、プラグイン用の初期化処理や後処理等を行います。

パラメタの内容

ESFRW_STEN_IFのパラメタ内容

typedef struct es_frw_sten_interface {
  ESULONG         call_timing; ……………… 呼び出し契機
  char            reserve1[4]; ……………… 予備
  ESFRW_COMMON    *cominf; …………………… プラグイン共通項目
  ESULONG         sel_mode; …………………… 実行モード
  ESFRW_EXT_INF   extinf;   …………………… CSVファイル拡張情報
} ESFRW_STEN_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
  char            user_file[512]; ………… シナリオファイル名
  ESULONG         execution_count;………… シナリオ実行回数
  ESULONG         parallel_count; ………… シナリオ同時実行数
  char            *esstop_execution; ……  esstopコマンド実行有無
} ESFRW_COMMON;

ESFRW_EXT_INFのパラメタ内容

typedef struct es_frw_cominfo {
  char            info1[256]; ……………… 拡張情報1
  char            info2[256]; ……………… 拡張情報2
} ESFRW_EXT_INF;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_STEN_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下のどちらかとなります。

ESFRW_TIMING_ST：プロセス開始時

ESFRW_TIMING_EN：プロセス終了時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

sel_mode

ユーザが設定する項目です。

システム検証支援はデフォルト値として、ESFRW_MODE_SEQ（逐次実行モード）を設定します。

extinf

ユーザが設定する項目です。

システムテスト支援では、NULLクリアしてプラグインを読み出します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下のどれかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

テスト実行フェーズのプロセス終了時は、プロセス開始時に設定した実行モードを設定します。それ以外では、ESFRW_SELMODE_NONEを設定します。

user_file

framework_definition定義の-pオプションのuser_fileフラグメンバで指定したファイル名称を設定します。

execution_count

framework_definition定義の-pオプションのexecution_countフラグメンバで指定した値を設定します。

parallel_count

framework_definition定義の-pオプションのparallel_countフラグメンバで指定した値を設定します。

esstop_execution

esstopコマンドが実行されたか否かを設定します。以下のどちらかとなります。

ESCOM_NO：esstopコマンド未実行

ESCOM_YES：esstopコマンド実行済み

ユーザが設定するパラメタ項目

ESFRW_STEN_IFのパラメタ項目

sel_mode

以下の条件を全て満たす場合、実行モードを設定してください。

テスト実行フェーズ

呼び出し契機がESFRW_TIMING_ST（プロセス開始時）

設定値は以下のどちらかとなります。

ESFRW_SELMODE_SEQ：逐次実行モード（デフォルト値）

ESFRW_SELMODE_SCE：シナリオ実行モード

条件を満たさない場合は設定する必要はありません。条件を満たさない場合の設定値は、テスト実行時に無視されます。

extinf

電文出力先ファイル（電文ファイル又は結果ファイル）がCSVファイルの場合、CSVファイル拡張情報として、プラグインが任意の情報を最大で2列まで出力する事ができます。以下の条件を全て満たす場合、ファイル拡張情報の1つ目（拡張情報1）と2つ目（拡張情報2）のヘッダ名称を設定してください。設定した名称は、各ファイルの先頭のヘッダ列として出力されます。

呼び出し契機がESFRW_TIMING_ST（プロセス開始時）

電文ファイル又は結果ファイルの種別がCSVファイル

CSVファイル内に拡張情報を追加する

ESFRW_COMMONのパラメタ項目

execution_count

以下の条件を全て満たす場合、シナリオの実行回数を設定してください。

バッチ実行実行フェーズ

呼び出し契機がESFRW_TIMING_ST（プロセス開始時）

本項目で設定した値が、framework_definition定義の-pオプションのexecution_countフラグメンバで設定したものとして扱われます。

条件を満たさない場合は設定する必要はありません。システム検証支援基盤は設定値を無視します。

parallel_count

以下の条件を全て満たす場合、シナリオの同時実行数を設定してください。

バッチ実行実行フェーズ

呼び出し契機がESFRW_TIMING_ST（プロセス開始時）

本項目で設定した値が、framework_definition定義の-pオプションのparallel_countフラグメンバで設定したものとして扱われます。

条件を満たさない場合は設定する必要はありません。システム検証支援基盤は設定値を無視します。

ESFRW_EXT_INFのパラメタ項目

info1

CSVファイルの拡張情報1を設定してください。

info2

CSVファイルの拡張情報2を設定してください。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

正常にリターンしました。処理を続行します。

ESFRW_NG

エラーが発生しました。システム検証支援プロセスは終了します。

上記以外

指定リターン値以外でリターンした場合、システム検証支援プロセスは終了します。

注意事項

UOCで設定した値に不正があった場合、システム検証支援プロセスは終了します。

7.3.3　電文組立てプラグイン

機能

TCPレベルで分割されているパケットを組み立てます。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func（ESFRW_BUILD_IF *parm）

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文組立プラグインは、本番環境からパケットをキャプチャしたとき、もしくはテスト対象システムからパケットを受信した時に、そのパケットで電文が完成しているかどうかを判定します。電文組立てプラグインはシステム検証支援がパケットをキャプチャ又は受信するたびに起動します。電文が未完成のとき（後続パケットがある場合）は、後続パケットに対してframework_definition定義の-tオペランドのbuild_message_watchtime の監視タイマを設定します。

入力パケットの判定

システム検証支援は電文組立プラグインにパケットが格納されている受信バッファを引き渡します。電文組立プラグインでは、受信バッファを基に電文が完成しているかどうかを判定し、リターン値を設定します。

組み立て中のパケットの破棄

電文のフォーマット不正等により組立て中のパケットが不要な場合は、ESFRW_DESTRUCTでリターンすると不要な電文を破棄することができます。

パケットロスト、コネクション切断等が発生した場合は、組み立て中の電文を破棄します。

パラメタの内容

ESFRW_BUILD_IFのパラメタ内容

typedef struct es_frw_build_interface {
  ESULONG          call_timing; …………………… 呼び出し契機
  char             reserve1[4]    ………………… 予備
  ESFRW_COMMON     *cominf;   ……………………… プラグイン共通情報
  ESFRW_CONNECTION *conninf;  ……………………… コネクション情報
  ESFRW_TELEGRAM   *telinf;   ……………………… 電文情報
  ESULONG          comp_sz;       ………………… 完成した電文のサイズ
  char             reserve2[4]    ………………… 予備
} ESFRW_BUILD_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; …………………… プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid;  …………………… 通番
  char            conttype;  ………………… 引継ぎ領域種別
  char            contstat;  ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area; ………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;             ……………… 領域サイズ
  char      reserve[4];       ……………… 予備領域
  char      *data;            ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;             ……………… IPアドレス（IPv4）
  char reserve[16];            ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];           ……………… 予備領域
  char ip[4];                 ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_BUILD_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_PKTCAP：パケットのキャプチャ

ESFRW_TIMING_PKTRCV：パケットの受信

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

conninf

呼び出し契機となったコネクションの情報（IPアドレス等）を格納したESFRW_CONNECTIONアドレスを設定します。

telinf

組立て中の電文の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

comp_sz

ユーザが設定する項目です。システム検証支援はデフォルト値として、現時点の電文サイズを設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC:RPC

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_REQUEST_TST：要求電文（テスト環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

ESFRW_MSGFORM_NONE（電文形態未決定）を設定します。

head_area

領域サイズに0、領域アドレスにNULLを設定します。

body_area

組み立て中のデータ情報（サイズ等）を設定します。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

protocol_telinf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_TELEGRAM RPC

RPC以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT： テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ユーザが設定するパラメタ項目

ESFRW_BUILD_IFのパラメタ項目

comp_sz

電文の組立てが完成した場合、完成した電文のサイズを設定してください。サイズは、「1〜組立て中の電文サイズ」の範囲で設定してください。

それ以外の場合、システムテスト支援は設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

電文が完成しました。

完成した電文のサイズが組立中の電文サイズより小さい場合、残りのパケットを引数として、再度電文組立プラグインを呼び出します。

ESFRW_OK_NEXT

電文が未完成です。

ESFRW_DESTRUCT

電文を破棄します。

ESFRW_NG

プラグイン処理中に異常が発生しました。組立中の電文を破棄します。

上記以外

指定リターン値以外でリターンした場合、組立中の電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、組立中の電文を破棄します。

7.3.4　電文情報プラグイン

機能

電文の各種情報を設定します。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func（ESFRW_INFO_IF *parm）

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文情報プラグインは、本番環境から電文をキャプチャしたとき、もしくはテスト対象システムから電文を受信した時に、その電文の要否や電文情報（ペアリングキー等）を設定します。

キャプチャまたは受信に失敗した時、ダミーの電文情報を引数として、本プラグインを呼出します。必要に応じて後処理（テスト中断、独自確保したリソースの解放等）を行ってください。なお、ダミーの電文情報の場合、電文データ等の一部の情報は参照できません。

パラメタの内容

ESFRW_INFO_IFのパラメタ内容

typedef struct es_frw_info_interface {
  ESULONG          call_timing; …………………… 呼び出し契機
  ESULONG          error_flg;  ………………      エラー情報
  ESFRW_COMMON     *cominf;   ……………………… プラグイン共通情報
  ESFRW_CLIENT     *cltinf;   ……………………… テスト実行単位情報
  ESFRW_CONNECTION *conninf;  ……………………… コネクション情報
  ESFRW_TELEGRAM   *telinf;   ……………………… 電文情報
  ESULONG          msgform;     …………………… 電文形態
  ESULONG          pair_use;      ………………… ペアリング要否
  char             pair_key[64];      …………… ペアリングキー
  char             client_id[16];     …………… クライアント識別子
} ESFRW_INFO_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3]; ……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_TELEGRAM_RPCの内容

typedef struct es_frw_telegram_rpc {
  char         protocol_type; …………… プロトコル詳細種別
  char         clt_nid[5];………………… クライアント側ノードID
  char         srv_nid[5];………………… サーバ側ノードID
  char         reserve1[5]; ……………… 予備
  char         group[32]; ………………… サービスグループ名
  char         service[32]; ……………… サービス名
  ESLONG       rtncode; …………………… RPCリターンコード
  ESULONG      out_len; …………………… 応答データ長
} ESFRW_TELEGRAM_RPC;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid;  …………………… 通番
  char            conttype;  ………………… 引継ぎ領域種別
  char            contstat;  ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area; ………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;              ……………… 領域サイズ
  char      reserve[4];        ……………… 予備領域
  char      *data;             ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;             ……………… IPアドレス（IPv4）
  char reserve[16];            ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

対象となる電文種別やその他条件により、システムテスト支援が設定する項目が異なります。以下に、電文種別毎の設定有無を示します。なお、記載されていない項目については、電文種別やその他条件による差異はありません。

項目

電文種別

要求電文

（本番環境）

応答電文

（本番環境）

応答電文

（テスト環境）

テスト実行単位情報

×

×

○

ESFRW_INFO_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下のどれかとなります。

ESFRW_TIMING_PKTCAP：パケットのキャプチャ時

ESFRW_TIMING_FILRED ：電文ファイルからの電文読込み時

ESFRW_TIMING_PKTRCV：パケットの受信時

error_flg

フレームワーク機能で検知したエラー有無、およびエラー内容を設定します。以下のどれかとなります。

ESFRW_ERROR_NONE：エラー無し

ESFRW_ERROR_RECV_CON：コネクション切断による受信不可

ESFRW_ERROR_RECV_LOST：ロスト検知による受信不可

ESFRW_ERROR_BUILD_TIMEOUT：後続パケット待ちタイムアウトによる受信不可

ESFRW_ERROR_RECV_TIMEOUT：応答待ちタイムアウトによる受信不可

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

ESFRW_TIMING_PKTRCVの場合、テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

conninf

呼び出し契機となったコネクションの情報（IPアドレス等）を格納したESFRW_CONNECTIONアドレスを設定します。

telinf

電文の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

msgform

要求電文（本番環境）の場合にユーザが設定する項目です。システム検証支援はデフォルト値として、ESFRW_MSGFORM_SYNC_ANSWER（同期応答型）を設定します。

pair_use

要求電文（本番環境）の場合にユーザが設定する項目です。システム検証支援はデフォルト値として、ESFRW_PAIR_YES（ペアリング要）を設定します。framework_definition定義の-uオプションのproduction_pairingフラグメンバ値がNの場合はESFRW_PAIR_NO（ペアリング不要）を設定します。

pair_key

プロトコル種別がTCPの場合、ユーザが設定する項目です。

以下の条件を全て満たす場合、システム検証支援では、デフォルト値として、蓄積ファイル内の電文情報の電文キー値を設定します。

テスト実行フェーズ

プロトコル種別がTCPの場合、かつ電文ファイルの種別が蓄積ファイル（framework_definition定義の-fオプションのtelegram_file_typeフラグメンバに"afl"を指定）

蓄積ファイル内の電文情報に電文キーが設定されている

上記の条件を満たさない場合は、デフォルト値として、コネクション毎にユニークとなる値を設定します。このデフォルト値を使用した場合、同一コネクションの要求電文と応答電文がペアリングされます。

client_id

要求電文（本番環境）の場合にユーザが設定する項目です。システム検証支援はデフォルト値として、コネクション毎にユニークとなる値を設定します。

なお、framework_definition定義の-uオプションのipaddr_serializeフラグメンバ値にYを指定した場合は、デフォルト値として、外部システムのIPアドレスごとにユニークな値を設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下のどれかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下のどちらかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下のどちらかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下のどちらかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。以下のどれかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下のどれかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

ESFRW_MSGFORM_NOSYNC_ANSWER：非同期応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、およびHTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

エラー情報がESFRW_ERROR_NONE以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

エラー情報がESFRW_ERROR_NONE以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

エラー情報がESFRW_ERROR_NONE以外の場合は、NULLを設定します。

pair_telinf

NULLを設定します。

pair_telinf

以下の全ての条件を満たす場合、電文ファイル内の拡張情報1、および2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

protocol_telinf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_TELEGRAM RPC

RPC以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下のどれかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT：テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下のどれかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ESFRW_TELEGRAM_RPCのパラメタ項目

protocol_type

RPCのプロトコル詳細種別を設定します。以下のどれかになります。

ESFRW_PROT_RPC_RPC：RPC

ESFRW_PROT_RPC_RAP：RAP

clt_nid

要求電文（本番環境）の場合はクライアント側のノードIDを設定します。それ以外、または電文内にノードIDが格納されていない場合は、オールNULLを設定します。

srv_nid

応答電文の場合はサーバ側のノードIDを設定します。それ以外の場合はNULLを設定します。

group

要求電文の場合はサービスグループ名を設定します。それ以外の場合はオールNULLを設定します。

なお、要求電文（テスト環境）かつ電文送信プラグインでサービスグループ名を変更している場合、変更したサービスグループ名を設定します。

service

要求電文の場合はサービス名を設定します。それ以外の場合はオールNULLを設定します。

なお、要求電文（テスト環境）、かつ電文送信プラグインでサービス名を変更している場合、変更したサービス名を設定します。

rtncode

応答電文の場合はサーバ側が設定したRPCリターンコード（dc_rpc_call()等のリターン値）を設定します。それ以外の場合は0を設定します。

out_len

応答型の要求電文の場合は応答データ長（dc_rpc_call()等で指定したout_len値）を設定します。それ以外の場合は0を設定します。

ユーザが設定するパラメタ項目

対象となる電文種別やその他条件により、プラグインが設定する項目が異なります。以下に、電文種別毎の設定要否を示します。なお、記載されていない項目については、電文種別やその他条件による差異はありません。

エラー情報がESFRW_ERROR_NONE以外の場合、設定する必要はありません。設定した場合は設定値を無視します。

項目

電文種別

要求電文

（本番環境）

応答電文

（本番環境）

応答電文

（テスト環境）

電文形態

*1

×

×

クライアント識別子

*2

×

×

ペアリングキー

*1*3

○

○*1

ペアリング要否

*3

×

×

（凡例）

○：設定必要

×：設定不要（設定してもシステムテスト支援は無視）

*1：プロトコル種別がTCPの場合のみ

*2：テスト実行フェーズ（逐次実行モード）のみ

*3：応答型だけ

ESFRW_INFO_IFのパラメタ項目

msgform

以下の条件を全て満たす場合、電文形態を設定してください。

プロトコル種別がTCP

要求電文（本番環境）

設定値は以下のどちらかとなります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

条件を満たさない場合、設定する必要はありません。システムテスト支援は設定値を無視します。

pair_use

以下の条件を全て満たす場合、要求電文（本番環境）と応答電文（本番環境）のペアリング要否を設定してください。

要求電文（本番環境）

msgformで設定した電文形態が同期応答型

設定値は以下のどちらかとなります。

ESFRW_PAIR_YES：ペアリング要

ESFRW_PAIR_NO：ペアリング不要

条件を満たさない場合、設定する必要はありません。システムテスト支援は設定値を無視します。

pair_key

プロトコル種別がTCP、かつ電文形態が同期応答型の場合、ペアとなる要求電文と応答電文で同じ値となるペアリングキーを設定してください。

client_id

以下の条件を全て満たす場合、テスト実行単位となるクライアント識別子を設定してください。

テスト実行フェーズ（逐次実行モード）

要求電文（本番環境）

存在しないクライアント識別子を設定した場合、テスト実行単位情報（引継ぎ領域等）を新規作成します。存在するクライアント識別子を設定した場合、既存のテスト実行単位情報を使用します。

条件を満たさない場合、設定する必要はありません。システムテスト支援は設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

正常に終了しました。

ESFRW_DESTRUCT

電文を破棄します。

ESFRW_NG

プラグイン処理中に異常が発生しました。電文を破棄します。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

エラー情報がESFRW_ERROR_NONE以外の場合は、ESFRW_OKをリターンしても、ダミー電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、電文を破棄します。

7.3.5　電文編集プラグイン

機能

各種ファイルへ入出力する電文の編集を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_EDIT_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文編集プラグインは、電文ファイル又は結果ファイルへの電文書き込み前、もしくは、電文ファイルからの電文読み込み後、電文を編集します。

パラメタの内容

ESFRW_EDIT_IFのパラメタ内容

typedef struct es_frw_edit_interface {
  ESULONG         call_timing;…………… 呼び出し契機
  char            reserve1[4];…………… 予備領域
  ESFRW_COMMON    *cominf;  ……………… プラグイン共通情報
  ESFRW_CLIENT    *cltinf;  ……………… テスト実行単位情報
  ESFRW_TELEGRAM  *telinf;  ……………… 電文情報
  ESCOM_AREA      edit_area;  …………… 編集電文格納領域
  ESULONG         head_sz;  ……………… 電文のヘッダサイズ（HTTPのみ）
  ESULONG         data_sz;  ……………… 電文のデータサイズ
  ESFRW_EXT_INF   extinf: ………………… 電文拡張情報
} ESFRW_EDIT_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid; …………………… 通番
  char            conttype; ………………… 引継ぎ領域種別
  char            contstat; ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area;………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;             ……………… 領域サイズ
  char      reserve[4];       ……………… 予備領域
  char      *data;            ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;             ……………… IPアドレス（IPv4）
  char reserve[16];            ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_EDIT_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_FILWRT：ファイル書込み時

ESFRW_TIMING_FILRED：ファイル読込み時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

telinf

編集前の電文の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

edit_area

編集後電文の格納領域情報（格納先アドレス、領域サイズ）を設定します。領域サイズは、framework_definition定義の-bオプションのmax_message_sizeフラグメンバ値となります。

head_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

data_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

extinf

ユーザが設定する項目です。システムテスト支援では、領域をNULLクリアしてプラグインを呼び出します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

extinf

以下のすべての条件を満たす場合、電文ファイル内の拡張情報1及び2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

protocol_telinf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_TELEGRAM_RPC

上記以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT：テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ユーザが設定するパラメタ項目

ESFRW_EDIT_IFのパラメタ項目

head_sz

プロトコル種別がHTTPの場合、HTTPヘッダ（リクエスト行／レスポンス行、HTTPヘッダとHTTPボディ間の空行（¥r¥n）含む）のサイズを1〜max_message_sizeの範囲で設定してください。HTTPヘッダを編集しない場合は、編集前のHTTPヘッダを編集後領域へ複写後、編集前のHTTPヘッダサイズを設定してください。

プロトコル種別がRPCの場合、編集前のヘッダを編集後領域へ複写後、編集前のヘッダサイズを設定してください。

プロトコル種別が上記以外の場合、設定する必要はありません。システムテスト支援は設定値を無視し、0バイトとして処理します。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

data_sz

データのサイズを設定してください。

プロトコル種別がHTTPの場合、HTTPボディ部のサイズを0〜max_message_sizeの範囲を設定してください。0を指定した場合、HTTPヘッダのみの電文として処理を行います。

プロトコル種別がRPCの場合、データのサイズは1以上、かつ、max_message_size、および8MBの範囲を設定してください。

プロトコル種別が上記以外の場合、データのサイズを1〜max_message_sizeの範囲を設定してください。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

extinf

電文出力先ファイル（電文ファイル又は結果ファイル）の種別がCSVファイルの場合、CSVファイル拡張情報として、プラグインが任意の情報を最大で2列まで出力する事ができます。以下の条件を全て満たす場合、ファイル拡張情報の1列目（拡張情報1）と2列目（拡張情報2）のデータを設定してください。

電文ファイル又は結果ファイルの種別がCSVファイル

protocol_telinf

プロトコル固有の情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_TELEGRAM_RPC

上記以外：NULL

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

正常に終了しました。編集前の電文を使用して処理を続行します。

ESFRW_OK_EDIT

正常に終了しました。編集後の電文を使用して処理を続行します。

ESFRW_DESTRUCT

電文を破棄します。

ESFRW_NG

プラグイン処理中に異常が発生しました。電文を破棄します。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、電文を破棄します。

7.3.6　電文送信プラグイン

機能

送信する電文の編集や情報設定を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_SEND_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文送信プラグインは、テスト対象システムの要求電文の送信前に、電文の編集や電文情報の設定を行います。

パラメタの内容

ESFRW_SEND_IFのパラメタ内容

typedef struct es_frw_send_interface {
  ESULONG         call_timing;  …………… 呼び出し契機
  char            reserve1[4];  …………… ペアリングキー
  ESFRW_COMMON    *cominf;  ………………… プラグイン共通情報
  ESFRW_CLIENT    *cltinf;  ………………… テスト実行単位情報
  ESFRW_TELEGRAM  *tst_telinf;  …………… 要求電文（テスト環境）情報
  ESFRW_TELEGRAM  *pro_telinf;  …………… 要求電文（本番環境）情報
  ESCOM_AREA      edit_area;  ……………… 編集電文格納領域
  ESULONG         head_sz;  ………………… 電文のヘッダサイズ（HTTPのみ）
  ESULONG         data_sz;  ………………… 電文のデータサイズ
  char            pair_key[64]; …………… ペアリングキー
  void            *protocol_edit; ………… プロトコル固有の編集情報
} ESFRW_SEND_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_SEND_IF_RPCの内容

typedef struct es_frw_send_interface_rpc {
  char         group[32]; ………………… サービスグループ名
  char         service[32]; ……………… サービス名
   ESULONG     out_len; …………………… 応答データ長
} ESFRW_SEND_IF_RPC;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid; …………………… 通番
  char            conttype; ………………… 引継ぎ領域種別
  char            contstat; ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area;………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;            ……………… 領域サイズ
  char      reserve[4];      ……………… 予備領域
  char      *data;           ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;            ……………… IPアドレス（IPv4）
  char reserve[16];           ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_EDIT_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_PKTSND：テスト対象への送信時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

tst_telinf

編集前の要求電文（テスト環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

tst_telinf

編集前の要求電文（本番環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

edit_area

編集後電文の格納領域情報（格納先アドレス、領域サイズ）を設定します。領域サイズは、framework_definition定義の-bオプションのmax_message_sizeフラグメンバ値となります。

head_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

data_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

pair_key

ユーザが設定する項目です。システム検証支援では、電文情報プラグイン（ESFRW_TIMING_FILRED）で設定した要求電文（本番環境）のペアリングキー値を基に、デフォルト値を設定します。

要求電文（本番環境）のペアリングキーが、コネクション（本番環境）毎にユニークとなる値（デフォルト値をそのまま使用）の場合、デフォルト値として、コネクション（テスト環境）毎にユニークとなる値を設定します。このデフォルト値を使用した場合、同一コネクションの要求電文と応答電文がペアリングされます。

それ以外の場合、デフォルト値として、要求電文（本番環境）と同じペアリングキーを設定します。

protocol_telinf

プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_SEND_IF_RPC

RPC以外：NULL

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESCLT_RUNMODE_C：電文作成フェーズ（PCAP）

ESCLT_RUNMODE_A：電文作成フェーズ（キャプチャ）

ESCLT_RUNMODE_R：テスト実行フェーズ

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

pair_telinf

以下の全ての条件を満たす場合、電文ファイル内の拡張情報1及び2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT： テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ESFRW_SEND_IF_RPCのパラメタ項目

group

ユーザが設定する項目です。システム検証支援では、本番環境のサービスグループ名を、デフォルト値として設定します。

service

ユーザが設定する項目です。システム検証支援では、本番環境のサービス名を、デフォルト値として設定します。

out_len

ユーザが設定する項目です。システム検証支援では、応答型の要求電文の場合は本番環境の応答データ長（dc_rpc_call()等で指定したout_len値）を設定します。それ以外の場合は0を設定します。

ユーザが設定するパラメタ項目

ESFRW_SEND_IFのパラメタ項目

head_sz

プロトコル種別がHTTPの場合、HTTPヘッダ（リクエスト行／レスポンス行、HTTPヘッダとHTTPボディ間の空行（¥r¥n）含む）のサイズを1〜max_message_sizeの範囲で設定してください。HTTPヘッダを編集しない場合は、編集前のHTTPヘッダを編集後領域へ複写後、編集前のHTTPヘッダサイズを設定してください。

プロトコル種別がTCPの場合、設定する必要はありません。システムテスト支援は設定値を無視し、0バイトとして処理します。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

data_sz

データのサイズを設定してください。

プロトコル種別がHTTPの場合、HTTPボディ部のサイズを0〜max_message_sizeの範囲を設定してください。0を指定した場合、HTTPヘッダのみの電文として処理を行います。

プロトコル種別がTCPの場合、データのサイズを1〜max_message_sizeの範囲を設定してください。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

pair_key

プロトコル種別がTCP、かつ電文形態が同期応答型の場合、ペアとなる要求電文と応答電文で同じ値となるペアリングキーを設定してください。

ペアとなる応答電文（テスト環境）の受信時は、電文情報プラグインにおいて、このペアリングキーと同じ値を設定してください。

ESFRW_SEND_IF_RPCのパラメタ項目

group

本番環境とテスト環境でサービスグループ名が異なる場合、テスト環境のサービスグループ名を設定してください。

service

本番環境とテスト環境でサービス名が異なる場合、テスト環境のサービス名を設定してください。

out_len

本番環境とテスト環境で応答データ長が異なる場合、テスト環境の応答データ長を設定してください。非応答型の場合、設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

正常に終了しました。編集前の電文を送信します。

ESFRW_OK_EDIT

正常に終了しました。編集後の電文を送信します。

ESFRW_CANCEL

電文を送信しません。

ESFRW_NG

プラグイン処理中に異常が発生しました。電文を送信しません。

上記以外

指定リターン値以外でリターンした場合、電文を送信しません。

注意事項

UOCで設定した値に不正があった場合、電文を送信しません。

7.3.7　電文受信プラグイン

機能

受信した電文の編集を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_SEND_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文受信プラグインは、テスト対象システムから受信した電文の編集を行います。

パラメタの内容

ESFRW_RECV_IFのパラメタ内容

typedef struct es_frw_recv_interface {
  ESULONG         call_timing;  …………… 呼び出し契機
  char            reserve1[4];  …………… 予備領域
  ESFRW_COMMON    *cominf;  ………………… プラグイン共通情報
  ESFRW_CLIENT    *cltinf;  ………………… テスト実行単位情報
  ESFRW_TELEGRAM  *telinf;  ………………… 電文情報
  ESCOM_AREA      edit_area;  ……………… 編集電文格納領域
  ESULONG         head_sz;  ………………… 電文のヘッダサイズ（HTTPのみ）
  ESULONG         data_sz;  ………………… 電文のデータサイズ
} ESFRW_RECV_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;  ………………… プロトコル種別
  char           conntype; …………………… コネクション種別
  char            reserve1[3]; ……………… 予備
  ESFRW_ADDR      clt_addr;  ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr;…………………… サーバアドレス情報
  ESFRW_CONTAINER *continf;…………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid; …………………… 通番
  char            conttype; ………………… 引継ぎ領域種別
  char            contstat; ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area;………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;            ……………… 領域サイズ
  char      reserve[4];      ……………… 予備領域
  char      *data;           ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;            ……………… IPアドレス（IPv4）
  char reserve[16];           ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_RECV_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_PKTRCV：テスト対象からの受信時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

telinf

編集前の電文の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

edit_area

編集後電文の格納領域情報（格納先アドレス、領域サイズ）を設定します。領域サイズは、framework_definition定義の-bオプションのmax_message_sizeフラグメンバ値となります。

head_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

data_sz

ユーザが設定する項目です。システムテスト支援では、デフォルト値として0を設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

pair_telinf

以下の全ての条件を満たす場合、電文ファイル内の拡張情報1及び2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

protocol_telinf

プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_SEND_IF_RPC

RPC以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT： テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ユーザが設定するパラメタ項目

ESFRW_SEND_IFのパラメタ項目

head_sz

プロトコル種別がHTTPの場合、HTTPヘッダ（リクエスト行／レスポンス行、HTTPヘッダとHTTPボディ間の空行（¥r¥n）含む）のサイズを1〜max_message_sizeの範囲で設定してください。HTTPヘッダを編集しない場合は、編集前のHTTPヘッダを編集後領域へ複写後、編集前のHTTPヘッダサイズを設定してください。

プロトコル種別がTCPの場合、設定する必要はありません。システムテスト支援は設定値を無視し、0バイトとして処理します。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

data_sz

データのサイズを設定してください。

プロトコル種別がHTTPの場合、HTTPボディ部のサイズを0〜max_message_sizeの範囲を設定してください。0を指定した場合、HTTPヘッダのみの電文として処理を行います。

プロトコル種別がTCPの場合、データのサイズを1〜max_message_sizeの範囲を設定してください。

ヘッダサイズとデータサイズの合計値がmax_message_size以下となるように設定してください。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

正常に終了しました。編集前の電文を使用します。

ESFRW_OK_EDIT

正常に終了しました。編集後の電文を使用します。

ESFRW_DESTRUCT

電文を破棄します。

ESFRW_NG

プラグイン処理中に異常が発生しました。電文を破棄します。

上記以外

指定リターン値以外でリターンした場合、電文を破棄します。

注意事項

UOCで設定した値に不正があった場合、電文を破棄します。

7.3.8　結果判定プラグイン

機能

テスト結果（成功／失敗）の判定を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_JUDG_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

結果判定プラグインは、要求電文に対するテスト終了時に、各種電文を基にテスト結果（成功／失敗）を判定します。また、必要に応じてテストの後処理（テスト時に一時的に確保したリソースの解放等）を行います。

フレームワーク機能側でエラーを検知した場合（要求電文の送信失敗等）でも、結果判定プラグインを呼び出します。この場合は、プラグインでは結果判定は不要です。後処理のみを行ってください。

パラメタの内容

ESFRW_JUDG_IFのパラメタ内容

typedef struct es_frw_jude_interface {
  ESULONG          call_timing;  …………… 呼び出し契機
  ESULONG          error_flg;  ……………… エラー情報
  ESFRW_COMMON     *cominf;  ………………… プラグイン共通情報
  ESFRW_CLIENT     *cltinf;  ………………… テスト実行単位情報
  ESFRW_TELEGRAM   *req_pro_telinf;  ……… 要求電文（本番環境）情報
  ESFRW_TELEGRAM   *rsp_pro_telinf;  ……… 応答電文（本番環境）情報
  ESFRW_TELEGRAM   *req_tst_telinf;  ……… 要求電文（テスト環境）情報
  ESFRW_TELEGRAM   *rsp_tst_telinf;  ……… 応答電文（テスト環境）情報
  ESULONG          error_level;  …………… エラーレベル
  ESULONG          user_code;………………… ユーザ情報コード
  char             user_info[256]; ………… ユーザ情報文字列
} ESFRW_JUDG_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid; …………………… 通番
  char            conttype; ………………… 引継ぎ領域種別
  char            contstat; ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area;………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;            ……………… 領域サイズ
  char      reserve[4];      ……………… 予備領域
  char      *data;           ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;            ……………… IPアドレス（IPv4）
  char reserve[16];           ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_JUDG_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_JUDG：結果判定時

error_flg

フレームワーク機能で検知したエラー有無、及びエラー内容を設定します。以下の何れかとなります。ESFRW_ERROR_NONEの場合は、プラグインで結果判定を行ってください。ESFRW_ERROR_NONE以外の場合は結果判定は不要です。後処理のみを行ってください。

ESFRW_ERROR_NONE：エラー無し

ESFRW_ERROR_SEND_CON：コネクション確立失敗による送信不可

ESFRW_ERROR_SEND_CANCEL：電文送信プラグインにより送信取消し

ESFRW_ERROR_SEND：送信失敗

ESFRW_ERROR_RECV_CON：コネクション切断による受信不可

ESFRW_ERROR_RECV_TIMEOUT：応答待ちタイムアウトによる受信不可

ESFRW_ERROR_LISTEN_PORT：Listenポートオープン失敗による応答受信不可（RPCプロトコルだけで有効）

ESFRW_ERROR_SEND_RAPCON：常設コネクション確立失敗による送信不可（RPCプロトコルだけで有効）

ESFRW_ERROR_RECV_PROTO：プロトコルレベルのエラー検知（※）

注※

RPCプロトコルの場合、応答電文のリターン値が0以外の場合を含みます。

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

req_pro_telinf

要求電文（本番環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。

rep_pro_telinf

応答電文（本番環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。応答電文（本番環境）が存在しない場合はNULLとなります。

req_tst_telinf

要求電文（テスト環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。要求電文（テスト環境）が存在しない場合はNULLとなります。

rep_tst_telinf

応答電文（テスト環境）の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。応答電文（テスト環境）が存在しない場合はNULLとなります。

error_level

ユーザが設定する項目です。システムテスト支援では、デフォルト値として、1を設定します。

user_code

ユーザが設定する項目です。システムテスト支援では、デフォルト値として、0を設定します。

user_info

ユーザが設定する項目です。システムテスト支援では、領域をNULLクリアしてプラグインを呼び出します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

pair_telinf

以下の全ての条件を満たす場合、電文ファイル内の拡張情報1及び2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

protocol_telinf

プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_SEND_IF_RPC

RPC以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT： テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ユーザが設定するパラメタ項目

ESFRW_SEND_IFのパラメタ項目

error_level

フレームワーク機能がエラーを検知していない（ESFRW_ERROR_NONE）、かつ、プラグインでテスト失敗と判断（ESFRW_NOMATCH）した場合、KFSE84003-Iメッセージで出力するエラーレベルを1〜3の範囲で設定します。範囲外を指定した場合、システムテスト支援は1として処理します。

user_code

フレームワーク機能がエラーを検知していない（ESFRW_ERROR_NONE）、かつ、プラグインでテスト失敗と判断（ESFRW_NOMATCH）した場合、結果ファイルへ出力するユーザ情報コードを設定してください。

それ以外の場合、システムテスト支援は設定値を無視します。

user_info

フレームワーク機能がエラーを検知していない（ESFRW_ERROR_NONE）、かつ、プラグインでテスト失敗と判断（ESFRW_NOMATCH）した場合、結果ファイルへ出力するユーザ情報文字列を設定してください。文字列の最後にはnull文字を設定してください。文字列が設定されていない場合（デフォルトのNULLクリア状態含む）、結果ファイルに出力するユーザ情報文字列は「-」（ハイフン）となります。

それ以外の場合、システムテスト支援は設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

テストが成功しました。

ESFRW_NOMATCH

テストが失敗しました。

ESFRW_NG

プラグイン処理中に異常が発生しました。結果ファイルのユーザ情報コードに「0」、ユーザ情報文字列に「PLUGIN-ERROR」を出力します。

上記以外

指定リターン値以外でリターンした場合、結果ファイルのユーザ情報コードに「0」、ユーザ情報文字列に「PLUGIN-ERROR」を出力します。

7.3.9　電文選択プラグイン

機能

シナリオ実行モード時に送信電文の選択を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG plg_func(ESFRW_SEL_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文選択プラグインは、シナリオ実行モードでの同時テスト数、及び、テストで使用する要求電文を選択します。

最初に呼び出される電文選択プラグイン（シナリオ数選択）で、シナリオ実行数を設定してください。ここで指定した数が、テストの同時実行数となります。システムテスト支援では、シナリオ実行数分のテスト単位情報（引継ぎ領域等）を作成します。テスト単位情報（引継ぎ領域等）は、電文選択プラグイン（電文選択）に渡すので、シナリオ内で情報引継ぎを行う場合は、このテスト単位情報を使用してください。

電文選択プラグイン（電文選択）では、シナリオの継続／終了を判断し、継続する場合は要求電文を選択してください。システムテスト支援は、指定された要求電文を基にテストを実施（要求電文送信〜結果ファイル出力）後、再度、電文選択プラグイン（電文選択）を呼び出します。これを、シナリオ終了まで繰り返します。なお、要求電文として、電文情報プラグインに渡された要求電文情報アドレスを設定する必要がある為、テストで使用する要求電文のアドレスは、電文情報プラグインでメモリ等に退避しておいてください。

同時テスト数を途中で増やしたい場合、電文選択プラグイン（電文選択）にて、シナリオ数再選択を指示してください。この場合、再度、電文選択プラグイン（シナリオ数選択）を呼び出すので、同時テスト数を設定してください。継続中のシナリオがある場合は、継続中のシナリオ数＋プラグイン設定数が、シナリオ数となります。

実行中のシナリオが無くなった時点で、システムテスト支援が終了します。

以下に、電文選択プラグインの呼び出しの流れを示します。

パラメタの内容

ESFRW_SEL_IFのパラメタ内容

typedef struct es_frw_sel_interface {
  ESULONG         call_timing;  …………… 呼び出し契機
  char            reserve1[4];  …………… 送信間隔
  ESFRW_COMMON    *cominf;  ………………… プラグイン共通情報
  ESFRW_CLIENT    *cltinf;  ………………… テスト実行単位情報
  ESFRW_TELEGRAM  *telinf;  ………………… 電文情報
  ESULONG         interval_time;  ………… 送信間隔
  ESULONG         scenario_cnt; …………… シナリオ数
} ESFRW_SEL_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3];……………… 予備
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
  ESFRW_CONTAINER *continf;  …………………… 引継ぎ領域情報
  char            client_id[16]; ……………… クライアント識別子
} ESFRW_CLIENT;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char           conntype;  …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

ESFRW_CONTAINERのパラメタ内容

typedef struct es_frw_continfo {
  ESULONG         contid; …………………… 通番
  char            conttype; ………………… 引継ぎ領域種別
  char            contstat; ………………… 引継ぎ領域状態
  ESCOM_AREA      data_area;………………… 引継ぎ領域
} ESFRW_CONTAINER;

es_com_area（ESCOM_AREA）のパラメタ内容

typedef struct es_com_area {
  ESULONG   size;            ……………… 領域サイズ
  char      reserve[4];      ……………… 予備領域
  char      *data;           ……………… 領域先頭アドレス
} ESCOM_AREA;

ESFRW_ADDRのパラメタ内容

typedef struct es_frw_addr {
  ESCOM_IPADDR ip;         …………………… IPアドレス
  unsigned short  portno;  …………………… ポート番号
} ESFRW_ADDR;

es_com_ipaddr（ESCOM_IPADDR）のパラメタ内容

typedef union es_com_ipaddr{
  ESCOM_IPV4 ipv4;            ……………… IPアドレス（IPv4）
  char reserve[16];           ……………… 予備領域
} ESCOM_IPADDR;

es_com_ipv4（ESCOM_IPV4）のパラメタ内容

typedef struct es_com_ipv4 {
  char reserve[12];            ……………… 予備領域
  char ip[4];                  ……………… IPアドレス（IPv4）
} ESCOM_IPV4;

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_SEL_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下の何れかとなります。

ESFRW_TIMING_SCENARIO：シナリオ数選択時

ESFRW_TIMING_TEL：電文選択時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報等）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

telinf

ユーザが設定する項目です。

interval_time

ユーザが設定する項目です。システム検証支援はデフォルト値として、0を設定します。

interval_time

ユーザが設定する項目です。システム検証支援はデフォルト値として、1を設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下の何れかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下の何れかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下の何れかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

clt_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

当該電文のプロトコル種別を設定します。以下の何れかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

msgtype

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下の何れかとなります。

ESFRW_MSGFORM_NONE：電文形態未決定

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

ESFRW_MSGFORM_NOANSWER：非応答型

head_area

プロトコル種別がHTTPの場合、電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

HTTP以外の場合は、領域サイズが0、領域アドレスがNULLとなります。

body_area

電文のデータ情報（サイズ等）を設定します。プロトコル種別がHTTPで、HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

pair_telinf

以下の全ての条件を満たす場合、電文ファイル内の拡張情報1及び2を設定します。

テスト実行フェーズ

電文ファイル種別がCSVファイル

CSVファイル内に拡張情報が存在する（電文作成フェーズにおいて、電文ファイルに拡張情報を追加した）

protocol_telinf

プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_SEND_IF_RPC

RPC以外：NULL

ESFRW_CONTAINERのパラメタ項目

contid

引継ぎ領域毎に割当てる通番を設定します。

conttype

引継ぎ領域の種別を設定します。以下の何れかとなります。

ESFRW_CONTTYPE_TEL：電文単位

ESFRW_CONTTYPE_CON：コネクション単位

ESFRW_CONTTYPE_CLT： テスト実行単位

contstat

引継ぎ領域の状態を設定します。以下の何れかとなります。

ESFRW_CONTST_NEW：初回（新規割当て）

ESFRW_CONTST_RENEW：初回（再割当て）

ESFRW_CONTST_CONTINUE：2回目以降

data_area

引継ぎ領域の情報（サイズ等）を設定します。

ユーザが設定するパラメタ項目

ESFRW_SEL_IFのパラメタ項目

telinf

呼び出し契機がESFRW_TIMING_TEL（電文選択）の場合、要求電文のESFRW_TELEGRAMアドレスを設定してください。設定するESFRW_TELEGRAMアドレスは、電文情報プラグインで渡したアドレスです。

呼び出し契機がESFRW_TIMING_TEL（電文選択）以外の場合、設定する必要はありません。システムテスト支援は設定値を無視します。

interval_time

呼び出し契機がESFRW_TIMING_TEL（電文選択）、かつ、テスト実行までの間隔を空けたい場合は、テスト実行までの時間（ミリ秒単位）を設定してください。

設定可能な値は0〜1048576です。なお、CPU状態やシステムテスト支援の状態等により、指定時間より遅れてテスト実行される場合があります。

呼び出し契機がESFRW_TIMING_TEL（電文選択）以外の場合、設定する必要はありません。システムテスト支援は設定値を無視します。

scenario_cnt

呼び出し契機がESFRW_TIMING_SCENARIO（シナリオ数選択）の場合、同時実行するシナリオ数を設定してください。設定可能な値は0〜65535です。呼び出し契機がESFRW_TIMING_TEL（電文選択）の場合は設定する必要はありません。システムテスト支援は設定値を無視します。

リターン値

次のコードでリターン値を設定してください。

ESFRW_OK

call_timingがESFRW_TIMING_SCENARIOの場合は、シナリオ数を追加します。

call_timingがESFRW_TIMING_TELの場合は、シナリオを継続します。

ESFRW_END

call_timingがESFRW_TIMING_SCENARIOの場合は、シナリオ数を追加しません。

call_timingがESFRW_TIMING_TELの場合は、シナリオを終了します。

ESFRW_END2

call_timingがESFRW_TIMING_SCENARIOの場合は、シナリオ数を追加しません。

call_timingがESFRW_TIMING_TELの場合は、シナリオを終了します。シナリオ数を再選択します。

ESFRW_NG

プラグイン処理中に異常が発生しました。ESFRW_ENDをリターンした時と同じ動作を行います。

上記以外

指定リターン値以外でリターンした場合、ESFRW_ENDをリターンした時と同じ動作を行います。

7.3.10　電文増幅プラグイン

機能

要求電文を増幅します。

形式

ANSI C，C++の形式

#include <esfrw.h>
ESLONG  plg_func(ESFRW_AMPL_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

電文増幅プラグインは、電文ファイルから読み込んだ要求電文を増幅します。

増幅パターンとして、以下の2つがあります。

電文追加

クライアント増幅

「電文追加」は、増幅した電文を、複製元と同じクライアント識別子で実行します。

「クライアント増幅」は、増幅した電文を、複製元と異なるクライアント識別子として実行します。

「電文追加」と「クライアント増幅」を組み合わせることもできます。この場合、「電文追加」によって電文を増幅します。また、増幅された電文を、さらに「クライアント増幅」によって増幅し、異なるクライアント識別子として実行します。

「電文追加」を行う場合は、本プラグインの戻り値としてESFRW_OK_RECALLを返却してください。この場合、当該電文の送信後、複製した電文（電文内容、電文引継領域など、すべて複製）を引数として、再度本プラグインを呼び出します。「電文追加」が不要となるまで、繰り返しESFRW_OK_RECALLを返却してください。

「クライアント増幅」を行う場合は、本プラグインの戻り値としてESFRW_OK又はESFRW_OK_RECALLを返却し、かつ「クライアント増幅数」に1以上の値を設定してください。この場合、指定された「クライアント増幅数」分、電文を複製し、別クライアントとして実行します。増幅したクライアントのクライアント識別子（client_id）の14～15バイト目は、増幅通番（ネットワークバイトオーダー）となります。

パラメタの内容

ESFRW_AMPL_IFのパラメタ内容

typedef struct es_frw_ampl_interface {
  ESULONG          call_timing;  …………… 呼び出し契機
  char             reserve1[4];  …………… 予備領域
  ESFRW_COMMON     *cominf;  ………………… プラグイン共通情報
  ESFRW_CONNECTION *conninf; ………………… コネクション情報
  ESFRW_TELEGRAM   *telinf;  ………………… 電文情報
  ESULONG          tel_ampl_time; ………… 電文追加間隔
  ESULONG          clt_ampl_cnt;  ………… クライアント増幅数
  ESULONG          *clt_ampl_time; ………  クライアント増幅間隔リスト
  ESULONG          msgform;  ………………… 電文形態
  char             reserve1[4];  …………… 予備領域
} ESFRW_AMPL_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode;   ……………… 実行モード
  char            reserve1[3]; ……………  予備
} ESFRW_COMMON;

ESFRW_CONNECTIONのパラメタ内容

typedef struct es_frw_connection {
  ESULONG         protocol;   ………………… プロトコル種別
  char            conntype; …………………… コネクション種別
  char            reserve1[3];  ……………… 予備
  ESFRW_ADDR      clt_addr;   ………………… クライアントアドレス情報
  ESFRW_ADDR      srv_addr; …………………… サーバアドレス情報
  ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
} ESFRW_CONNECTION;

ESFRW_TELEGRAMのパラメタ内容

typedef struct es_frw_telinfo {
  ESULONG         protocol; ……………………プロトコル種別
  unsigned char   msgtype; …………………… 電文種別
  unsigned char   msgform; …………………… 電文形態
  char            reserve1[2]; ……………… 予備
  ESFRW_AREA      head_area; ………………… 電文（HTTPヘッダ）
  ESFRW_AREA      body_area; ………………… 電文（データ）
  ESFRW_ADDR      src_addr;  ………………… 送信元アドレス情報
  ESFRW_ADDR      dst_addr;  ………………… 送信先アドレス情報
  ESFRW_CONTAINER *continf;  ………………… 引継ぎ領域情報
  ESFRW_TELEGRAM  *pair_telinf;  …………… ペアリング電文情報
  ESFRW_EXT_INF   extinf;    ………………… 電文拡張情報
  char            protoinf[128]; …………… 製品情報1（参照出来ません）
  void            *protocol_telinf; ……… プロトコル固有情報
} ESFRW_TELEGRAM;

テーブル関連図

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_AMPL_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下になります。

ESFRW_TIMING_FILRED：電文ファイルからの電文読込み時

cominf

プラグインに共通する情報（フェーズ、テスト識別子等）を格納しているESFRW_COMMONアドレスを設定します。

conninf

呼び出し契機となったコネクションの情報（IPアドレス等）を格納したESFRW_CONNECTIONアドレスを設定します。

telinf

電文の情報（サイズ等）を格納しているESFRW_TELEGRAMアドレスを設定します。電文追加により増幅された電文の場合、増幅元となる電文情報（電文内容、引継領域等）が設定されます。

tel_ampl_time

ユーザが設定する項目です。システム検証支援はデフォルト値として、0を設定します。

clt_ampl_cnt

ユーザが設定する項目です。システム検証支援はデフォルト値として、0を設定します。

clt_ampl_time

ユーザが設定する項目です。システム検証支援はデフォルト値として、0を設定します。

msgform

ユーザが設定する項目です。システム検証支援はデフォルト値として、ESFRW_MSGFORM_SYNC_ANSWER（同期応答型）を設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下のどれかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP ：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

tel_filetype

電文ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

電文作成フェーズでは、ESFRW_SELMODE_NONEを設定します。

テスト実行フェーズでは、開始終了プラグインで設定された実行モードを設定します。開始終了プラグインを指定していない場合は、ESFRW_SELMODE_SEQ（逐次実行モード）を設定します。

ESFRW_CONNECTIONのパラメタ項目

protocol

コネクションのプロトコル種別を設定します。以下のどちらかとなります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_RPC：RPC

conntype

当該コネクションの種別を設定します。以下のどちらかとなります。

ESFRW_CONTYPE_PRO：本番環境のコネクション

ESFRW_CONTYPE_TST：テスト環境のコネクション

clt_addr

クライアント側のアドレス情報（IPアドレス、ポート番号等）を設定します。

本番環境の場合は、外部システムのアドレス情報となります。テスト環境の場合は、システム検証支援基盤のアドレス情報となります。

srv_addr

サーバ側のアドレス情報を設定します。

本番環境の場合は、既存システムのアドレス情報となります。テスト環境の場合は、テスト対象システムのアドレス情報となります。

continf

コネクション用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのconnection_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

ESFRW_TELEGRAMのパラメタ項目

protocol

プロトコル種別を設定します。以下のどちらかとなります。

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_TCP：TCP

ESFRW_PROT_RPC：RPC

msgtype

電文種別を設定します。以下のどれかとなります。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文（本番環境）

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文（本番環境）

ESFRW_MSGTYPE_REQUEST_TST：要求電文（テスト環境）

ESFRW_MSGTYPE_RESPONSE_TST：応答電文（テスト環境）

msgform

電文種別を設定します。以下になります。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

head_area

電文のHTTPヘッダ情報（サイズ等）を設定します。なお、HTTP電文先頭のリクエスト行／レスポンス行、及び、HTTPヘッダとHTTPボディの間の空行（¥r¥n）も、HTTPヘッダに含みます。

body_area

電文のデータ情報（サイズ等）を設定します。HTTPヘッダ部のみの場合（GETリクエスト等）、領域サイズが0、領域アドレスがNULLとなります。

src_addr

電文送信元のアドレス情報（IPアドレス、ポート番号等）を設定します。

dst_addr

電文送信先のアドレス情報（IPアドレス、ポート番号等）を設定します。

continf

電文用の引継ぎ領域情報（サイズ等）を格納したESFRW_CONTAINERアドレスを設定します。

framework_definition定義の-bオプションのtelegram_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

pair_telinf

NULLを設定します。

protocol_telinf

プロトコル固有の編集情報を格納した構造体のアドレスを設定します。各プロトコル用の構造体にキャストして使用してください。

RPC：ESFRW_SEND_IF_RPC

RPC以外：NULL

ユーザが設定するパラメタ項目

ESFRW_AMPL_IFのパラメタ項目

tel_ampl_time

「電文追加」を行う場合（ESFRW_OK_RECALLでリターン）、増幅した電文の送信間隔（当該電文と増幅電文の送信時間差異）をミリ秒単位（0～3600000）で設定してください。0（デフォルト値）を指定した場合は、即時に送信します。

本設定値は実行形態関連定義reply_send_modeの影響を受けます。

倍速送信実行時は、同定義で指定された倍速値で短縮した送信間隔となります。等間隔送信実行時、および連続送信実行時は、本設定値を無視します。

clt_ampl_cnt

「クライアント増幅」を行う場合、増幅するクライアント数（0～20000）を設定してください。

0（デフォルト値）を指定した場合、クライアント増幅は行いません。1以上を指定した場合、クライアント増幅を行います。

clt_ampl_time

「クライアント増幅」を行う場合、増幅した電文の送信間隔（当該電文と増幅電文の送信時間差異）をミリ秒単位（0～3600000）でクライアント毎に設定してください。

0（デフォルト値）を指定した場合は、即時に送信します。

clt_amplify_cntが3の場合の例

parm->clt_amplify_time[0]=1000; /* クライアント1 */

parm->clt_amplify_time[1]=0; /* クライアント2 */

parm->clt_amplify_time[2]=2000; /* クライアント3 */

msgform

要求電文の種別を指定できます。リターン値ESFRW_OK_RECALLを返した（電文を増幅して本プラグインを再度呼び出した）場合、電文情報プラグインが呼び出されないため、要求電文の種別を設定してください。次の電文種別を指定できます。

ESFRW_MSGFORM_SYNC_ANSWER：同期応答型

テスト対象システムからの応答電文を待ちます。

ESFRW_MSGFORM_NOANSWER：非応答型

テスト対象システムからの応答電文を待たずに、次の要求電文を送信します。

要求電文種別は次の条件をすべて満たす場合に設定してください。

プロトコル種別がTCP

要求電文（本番環境）

条件を満たさない場合、設定する必要はありません。システム検証支援基盤は設定値を無視します。

リターン値

plg_func()は次のコードでリターンしてください。

ESFRW_OK

正常。電文追加を行いません。クライアント増幅数が指定されていれば、クライアント増幅を行います。

ESFRW_OK_RECALL

正常。電文追加を行います。クライアント増幅数が指定されていれば、クライアント増幅を行います。

ESFRW_DESTRUCT

正常。電文を破棄します。

ESFRW_NG

プラグイン処理中に異常発生。システム検証支援はメッセージログを出力し、増幅を行わずに処理を継続します。

上記以外

ESFRW_NGを返したと見なします。

注意事項

ユーザの設定した値が不正な場合、システム検証支援はメッセージログを出力し、増幅を行わずに処理を継続します。

7.3.11　バッチ用プラグイン

機能

バッチ実行フェーズ時のテスト処理を行います。

形式

ANSI C、C++の形式

#include <esfrw.h>
ESLONG  plg_func(ESFRW_BATCH_IF *parm)

「plg_func」部分には、システム内で一意の名称を指定してください。

説明

バッチ用プラグインは、バッチ実行フェーズでのテスト処理を行います。定義または開始終了プラグインで指定されたシナリオ実行回数分呼び出されるか、プラグインの戻り値でテスト終了指示が設定されるまで、本プラグインは繰り返し呼び出されます。

パラメタの内容

ESFRW_BATCH_IFのパラメタ内容

typedef struct es_frw_batch_interface {
  ESULONG         call_timing;  …………… 呼び出し契機
  char            reserve1[4];  …………… 予備領域
  ESFRW_COMMON    *cominf;  ………………… プラグイン共通情報
  ESFRW_CLIENT    *cltinf;  ………………… テスト実行単位情報
  ESULONG         error_level;  …………… エラーレベル
} ESFRW_BATCH_IF;

ESFRW_COMMONのパラメタ内容

typedef struct es_frw_cominfo {
  ESULONG         run_mode; ………………… フェーズ
  char            testid[32]; ……………… テスト識別子
  char            plg_name[32]; …………… プラグイン名称
  ESULONG         max_msg_sz ;……………… 最大電文サイズ
  ESULONG         protocol; ………………… プロトコル一覧
  ESULONG         tel_filetype; …………… 電文ファイルの種別
  ESULONG         res_filetype; …………… 結果ファイルの種別
  char            sel_mode; ………………… 実行モード
  char            reserve1[3];  …………… 予備領域
  char            user_file[512]; ………… シナリオファイル名
  ESULONG         execution_count;………… シナリオ実行回数
  ESULONG         parallel_count; ………… シナリオ同時実行数
  char            *esstop_execution; ……  esstopコマンド実行有無
} ESFRW_COMMON;

ESFRW_CLIENTのパラメタ内容

typedef struct es_frw_cltinfo {
ESFRW_CONTAINER *continf; …………………… 引継ぎ領域情報
char            client_id[16];……………… クライアント識別子
} ESFRW_CLIENT;

テーブル関連図

各テーブル間は以下のチェイン構造となります。

システム検証支援が値を設定するパラメタ項目

ESFRW_BATCH_IFのパラメタ項目

call_timing

プラグインの呼び出し契機を設定します。以下になります。

ESFRW_TIMING_BATCH：バッチ実行時

cominf

プラグインに共通する情報（フェーズ、テスト識別子など）を格納しているESFRW_COMMONアドレスを設定します。

cltinf

テスト実行単位の情報（引継ぎ情報など）を格納したESFRW_CLIENTアドレスを設定します。それ以外の場合はNULLを設定します。

error_level

ユーザが設定する項目です。システム検証支援はデフォルト値として、1を設定します。

ESFRW_COMMONのパラメタ項目

run_mode

フレームワークのフェーズを設定します。以下のどれかとなります。

ESFRW_RUNMODE_CREATE_C：電文作成フェーズ（PCAP）

ESFRW_RUNMODE_CREATE_A：電文作成フェーズ（キャプチャ）

ESFRW_RUNMODE_TEST_R：テスト実行フェーズ

ESFRW_RUNMODE_TEST_C：テスト実行フェーズ（PCAP）

test_id

システムテスト支援開始時に指定したテスト識別子を設定します。

plg_name

framework_definition定義の-pオプションのnameフラグメンバで指定したプラグイン名称を設定します。

max_msg_sz

framework_definition定義の-bオプションのmax_message_sizeフラグメンバで指定した最大電文サイズを設定します。

protocol

address_destinationで指定したプロトコルを設定します。以下の論理和となります。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

tel_filetype

電文ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのtelegram_file_typeフラグメンバ値で指定します。

res_filetype

テスト実行フェーズの場合、結果ファイルの種別を設定します。以下のどちらかの値となります。

ESFRW_FILE_AFL：蓄積ファイル

ESFRW_FILE_CSV：csvファイル

電文ファイルの種別は、framework_definition定義の-fオプションのresult_file_typeフラグメンバ値で指定します。電文作成フェーズの場合は、ESFRW_FILE_NONE（無し）を設定します。

sel_mode

テスト実行フェーズのプロセス終了時は、プロセス開始時に設定した実行モードを設定します。それ以外では、ESFRW_SELMODE_NONEを設定します。

user_file

framework_definition定義の-pオプションのuser_fileフラグメンバで指定したファイル名称を設定します。

execution_count

framework_definition定義の-pオプションのexecution_countフラグメンバで指定した値を設定します。

parallel_count

framework_definition定義の-pオプションのparallel_countフラグメンバで指定した値を設定します。

esstop_execution

esstopコマンドが実行されたか否かを設定します。以下のどちらかとなります。

ESCOM_NO：esstopコマンド未実行

ESCOM_YES：esstopコマンド実行済み

ESFRW_CLIENTのパラメタ項目

continf

テスト実行単位の引継ぎ領域情報（サイズなど）を格納したESFRW_CONTAINERアドレスを設定します。framework_definition定義の-bオプションのclient_area_sizeに0（引継ぎ領域を使用しない）を指定した場合、NULLを設定します。

client_id

テストの実行単位となるクライアント識別子を設定します。

ユーザが設定するパラメタ項目

ESFRW_BATCH_IFのパラメタ項目

error_level

プラグインでテスト失敗と判断（ESFRW_NGまたはESFRW_NG_END）した場合、KFSE84003-Iメッセージで出力するエラーレベルを1～3の範囲で設定します。範囲外を指定した場合、システム検証支援は1として処理します。

リターン値

次のコードでリターンしてください。

ESFRW_OK

テスト成功。次のバッチ用プラグイン呼び出しを行う。

ESFRW_NG

テスト失敗。次のバッチ用プラグイン呼び出しを行う。

ESFRW_END

テスト成功。システム検証支援を終了する。

ESFRW_NG_END

テスト失敗。システム検証支援を終了する。

上記以外のコードでリターンした場合は、メッセージログを出力後、ESFRW_NGが返された時と同じ動作を行います。

8　蓄積ファイル編集ユーティリティ

蓄積ファイル編集ユーティリティについて説明します。

8.1　ユーザアプリケーション（UAP）の作成

蓄積ファイル編集ユーティリティで使用するUOCの作成手順を以下に示します。

図8‒1　UAPの作成手順

図8‒2　UAPの作成手順（媒体）

8.1.1　ユーザプログラム（UAP）のコーディング

ユーザプログラム（UAP）のコーディングにはC言語を使用し、ANSI C形式に従ってコーディングしてください。

ユーザプログラム（UAP）をコーディングしてソースファイルを作成するとき、OSの標準機能を使うことができます。

また、コーディング時は以下のコーディング規約に従ってください。

"ee"または"es"で始まる名称を使用しないでください。

マルチスレッドでの動作は対応していません。

8.1.2　翻訳と結合

ソースファイルをコンパイルして、UAPオブジェクトファイルを作成します。

コンパイルして作成したUAPオブジェクトファイルと以下のライブラリをリンケージして、UAP実行形式ファイルを作成します。

コンパイルオプション、及びリンケージオプションについては、蓄積ファイル編集ユーティリティのサンプル（makefile）を参照してください。

蓄積ファイル編集ユーティリティのライブラリ

libsic_aflutl.so

その他のライブラリ

UAPで蓄積ファイル編集ユーティリティ以外のライブラリ関数を使用している場合、必要に応じて指定してください。

8.1.3　UAPの実行

環境設定

UAPを実行する環境に以下の環境変数を設定してください。

LD_LIBRARY_PATH （Linux版限定）

以下のパスをすべて指定してください。

システム検証基盤のライブラリのインストールディレクトリ

その他のライブラリのインストールディレクトリ（その他のライブラリを使用する場合）

必要に応じて、UAPを実行する環境に以下の環境変数を設定してください。

SICAFLLOGSTDERR={Y | N}

蓄積ファイル編集ユーティリティでエラーが発生した時に、エラーメッセージを標準エラー出力に出力するかどうかを指定します。

Y：標準エラー出力にエラーメッセージを出力します。

N：標準エラー出力にエラーメッセージを出力しません。

ただし、以下のリターン値は、メッセージ出力対象外です。

ESAFLER_ARGUMENT

ESAFLER_TIMING

ESAFLER_CONDITION

ESAFLER_NO_DATA

ESAFLER_OVERFLOW（GET要求時のみ）

UAPの実行

UAP実行形式ファイルを実行します。

8.2　ライブラリ関数

蓄積ファイル編集ユーティリティで使用できるライブラリ関数一覧を以下に示します。

表8‒1　蓄積ファイル編集ユーティリティで使用できるライブラリ関数一覧

機能

C言語ライブラリ

INIT要求

es_afl_init

GET要求

es_afl_get

PUT要求

es_afl_put

拡張PUT要求

es_afl_put_ex

TERM要求

es_afl_term

各要求の発行可否と発行順序を以下に示します。

表8‒2　各要求の発行可否

前回の要求

今回の要求

INIT要求

GET要求

PUT要求

拡張PUT要求

TERM要求

最初の要求

○

×

×

×

×

INIT要求

×

○

×

○

○

GET要求

×

○

○

×

○

PUT要求

×

○

○

×

○

拡張PUT要求

×

×

×

○

○

TERM要求

○

×

×

×

×

8.3　APIの詳細（C言語）

8.3.1　INIT要求

機能

蓄積ファイル編集ユーティリティの初期化要求（INIT要求）を行います。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_init(ESAFL_INPARAM *inparam_pt, ESAFL_OUTPARAM *outparam_pt,
                ESLONG flags)

パラメタの内容

ESAFL_INPARAMのパラメタ内容

typedef struct es_afl_inparam_t{        ………入力ファイルパラメタ構造体
    char    file_dir[1024];             ………蓄積ファイル格納ディレクトリパス
    char    file_name[48];              ………蓄積ファイル名
    char    yobi1[32];                  ………予備
    ESULONG protocol;                   ………プロトコル種別
    char    yobi[92];                   ………予備
} ESAFL_INPARAM;

ESAFL_OUTPARAMFILEのパラメタ内容

typedef struct es_afl_outparam_t{       ………出力ファイルパラメタ構造体
    char    file_dir[1024];             ………蓄積ファイル格納ディレクトリパス
    char    file_name[48];              ………蓄積ファイル名
    char    test_id[32];                ………テスト識別子
    char    yobi1[4];                   ………予備
    ESULONG file_type;                  ………蓄積ファイル種別
    ESLONG  buf_size;                   ………蓄積バッファサイズ
    char    reuse_flg;                  ………蓄積ファイル上書き有無
    char    yobi[83];                   ………予備
} ESAFL_OUTPARAM;

UAPで値を設定するパラメタ項目

inparam_pt

入力ファイルパラメタ構造体のアドレスを設定します。

GET要求とPUT要求を行うときは、設定してください。拡張PUT要求を行うときは、NULLを設定してください。

入力ファイルパラメタ構造体に次の情報を設定してください。

蓄積ファイル格納ディレクトリパス

入力する蓄積ファイルが格納されているディレクトリを絶対パス名で980バイト以内（Windows版の場合は217バイト以内）で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

蓄積ファイル名

入力する蓄積ファイル名を41バイト以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

プロトコル種別

GET要求の対象となるプロトコル種別を論理輪で設定します。

ESAFL_PROTOMOD_TCP ：TCPプロトコル

ESAFL_PROTOMOD_UDP ：UDPプロトコル

ESAFL_PROTOMOD_HTTP：HTTPプロトコル

outparam_pt

出力ファイルパラメタ構造体のアドレスを設定します。

PUT要求と拡張PUT要求を行うときは、設定してください。PUT要求と拡張PUT要求を行わないときは、NULLを設定してください。

出力ファイルパラメタ構造体に次の情報を設定してください。

蓄積ファイル格納ディレクトリパス

出力する蓄積ファイルを格納するディレクトリを絶対パス名で980バイト以内（Windows版の場合は217バイト以内）で設定します。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

蓄積ファイル名

出力する蓄積ファイル名を41バイト以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

蓄積ファイル名の命名規則は「5.2.1　蓄積ファイルの構成」を参照してください。任意のファイル名としたときは、ファイル名を変更しないとリプレイ実行を行うことができません。

テスト識別子

テスト識別子を31バイト以内で設定します。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

蓄積ファイル種別

出力する蓄積ファイルの種別を設定します。

ESAFL_FILETYPE_REQ ：本番用の要求電文蓄積ファイル

蓄積バッファサイズ

蓄積ファイルを出力する際に使用する蓄積バッファの最大サイズを1から100（単位：メガバイト）の範囲で設定します。

蓄積ファイル上書き有無

出力先のディレクトリ下に既に蓄積ファイルが存在したときに上書きするかどうかを設定します。

蓄積ファイルが存在し、上書きしない設定を行っていたときは、エラーリターンします。

ESAFL_YES ：上書きする。

ESAFL_NO ：上書きしない。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESAFLER_ARGUMENT

引数に設定した値が間違っています。

ESAFLER_TIMING

この関数を発行できる状態ではありません。

ESAFLER_MEMORY_SHORT

メモリが不足しました。

ESAFLER_FILE

蓄積ファイル格納ディレクトリパス、または蓄積ファイルが不正です。

ESAFLER_IOERR

蓄積ファイルへのI/Oエラーが発生しました。

ESAFLER_SYSERR

システムエラーが発生しました。

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。

8.3.2　GET要求

機能

入力用の蓄積ファイルから電文情報の読み込み要求（GET要求）を行います。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_get（ESAFL_DTPARAM *dtparam_pt, ESLONG flags）

パラメタの内容

ESAFL_DTPARAMのパラメタ内容

typedef struct es_afl_dtparam_t{        ………データ管理パラメタ構造体
    ESAFL_HEAD    *head_pt;             ………ヘッダパラメタ構造体アドレス
    ESAFL_DATA    *data_pt;             ………データパラメタ構造体アドレス
    char    yobi1[64];                  ………予備
    char    hsic_area1[512];            ………HSIC使用領域1
    char    hsic_area2[512];            ………HSIC使用領域2
} ESAFL_DTPARAM;

ESAFL_HEADのパラメタ内容

typedef struct es_afl_head_t{           ………ヘッダパラメタ構造体
    unsigned char    src_ip[4];         ………送信元IPアドレス
    unsigned char    dst_ip[4];         ………送信先IPアドレス
    unsigned short   src_port;          ………送信元ポート番号
    unsigned short   dst_port;          ………送信先ポート番号
    ESULONG protocol;                   ………プロトコル種別
    char    data_key[32];               ………電文キー
    char    yobi[80];                   ………予備
} ESAFL_HEAD;

ESAFL_DATAのパラメタ内容

typedef struct es_afl_data_t{           ………データパラメタ構造体
    ESLONG  data_area_len;              ………電文格納エリア長
    char    yobi1[4];                   ………予備
    ESLONG  indata_len;                 ………入力電文長
    ESLONG  indata_len1;                ………実入力電文長
    char    *indata_area_pt;            ………入力電文格納エリアアドレス
    ESLONG  outdata_len;                ………出力電文長
    char    yobi2[4];                   ………予備
    char    *outdata_area_pt;           ………出力電文格納エリアアドレス
    char    yobi[88];                   ………予備
} ESAFL_DATA;

UAPで値を設定するパラメタ項目

dtparam_pt

データ管理パラメタ構造体のアドレスを設定してください。

データ管理パラメタ構造体に次の情報を設定してください。

ヘッダパラメタ構造体アドレス

ヘッダパラメタ構造体のアドレスを設定してください。

データパラメタ構造体アドレス

データパラメタ構造体のアドレスを設定してください。

データパラメタ構造体に次の情報を設定してください。

電文格納エリア長

電文を格納するエリア長を設定します。1以上の値を設定してください。

入力電文格納エリアアドレス

電文を格納するエリアのアドレスを設定します。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

dtparam_pt

データ管理パラメタ構造体に次の情報を設定します。

HSIC使用領域1

HSICが使用する情報が返されます。

PUT要求時に、本パラメタ情報をデータ管理パラメタ構造体のHSIC使用領域1に設定してください。

HSIC使用領域2

HSICが使用する情報が返されます。

PUT要求時に、本パラメタ情報をデータ管理パラメタ構造体のHSIC使用領域2に設定してください。

ヘッダパラメタ構造体に次の情報を設定します。

送信元IPアドレス

取得した電文の送信元IPアドレスが次に示す形式で返されます。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0x A5

0x70

0x14

送信先IPアドレス

取得した電文の送信先IPアドレスが次に示す形式で返されます。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0x A5

0x70

0x14

送信元ポート番号

取得した電文の送信元ポート番号が返されます。

送信先ポート番号

取得した電文の送信先ポート番号が返されます。

プロトコル種別

取得した電文のプロトコル種別が返されます。

ESAFL_PROTOMOD_TCP ：TCPプロトコル

ESAFL_PROTOMOD_UDP ：UDPプロトコル

ESAFL_PROTOMOD_HTTP：HTTPプロトコル

電文キー

取得した電文の電文キー（16進数）が返されます。

データパラメタ構造体に次の情報を設定します。

入力電文長

入力電文格納エリアに取得した電文のサイズが返されます。ESAFLER_OVERFLOWでリターンしたときは、電文格納エリア長が返されます。

コネクション切断、もしくはパケットロストが発生している場合、入力電文長は0が返されます。複数のGET要求で取得した電文を組み立ててPUT要求を行っているときは、本GET要求を契機にして後処理を行ってください。

実入力電文長

取得した電文の実サイズが返されます。

入力電文格納エリアアドレス

入力電文格納エリアに取得した電文が返されます。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESAFLER_ARGUMENT

引数に設定した値が間違っています。

ESAFLER_TIMING

この関数を発行できる状態ではありません。

ESAFLER_CONDITION

INIT要求時に入力ファイルパラメタ構造体を設定していません。

ESAFLER_NO_DATA

取得できる電文情報がありません。

ESAFLER_OVERFLOW

入力電文格納エリアが小さいです。

ESAFLER_IOERR

蓄積ファイルへのI/Oエラーが発生しました。

ESAFLER_SYSERR

システムエラーが発生しました。

ESAFLER_UNRESOLVABLE

その他のエラーが発生しました。

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。

取得した電文のサイズが電文格納エリア長より大きいときは、入力電文格納エリア長までの電文を取得し、ESAFLER_OVERFLOWでエラーリターンします。入力電文格納エリア長を実入力電文長以上にして、再度GET要求を行うことで、先ほど全て取得できなかった電文を全て取得することができます。

以下のエラーリターンのあとに再度GET要求を行うと、ESAFLER_TIMINGでエラーリターンします。

ESAFLER_NO_DATA

ESAFLER_IOERR

8.3.3　PUT要求

機能

GET要求で取得して編集した電文情報の書き込み要求（PUT要求）を行います。蓄積ファイルへの書き込みは、製品が付加するヘッダ情報を含めて最大1TBまで行うことができます。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_put(ESAFL_DTPARAM *dtparam_pt, ESLONG flags)

パラメタの内容

ESAFL_DTPARAMのパラメタ内容

typedef struct es_afl_dtparam_t{        ………データ管理パラメタ構造体
    ESAFL_HEAD    *head_pt;             ………ヘッダパラメタ構造体アドレス
    ESAFL_DATA    *data_pt;             ………データパラメタ構造体アドレス
    char    yobi1[64];                  ………予備
    char    hsic_area1[512];            ………HSIC使用領域1
    char    hsic_area2[512];            ………HSIC使用領域2
} ESAFL_DTPARAM;

ESAFL_DATAのパラメタ内容

typedef struct es_afl_data_t{           ………データパラメタ構造体
    ESLONG  data_area_len;              ………電文格納エリア長
    char    yobi1[4];                   ………予備
    ESLONG  indata_len;                 ………入力電文長
    ESLONG  indata_len1;                ………実入力電文長
    char    *indata_area_pt;            ………入力電文格納エリアアドレス
    ESLONG  outdata_len;                ………出力電文長
    char    yobi2[4];                   ………予備
    char    *outdata_area_pt;           ………出力電文格納エリアアドレス
    char    yobi[88];                   ………予備
} ESAFL_DATA;

UAPで値を設定するパラメタ項目

dtparam_pt

データ管理パラメタ構造体のアドレスを設定してください。

データ管理パラメタ構造体に次の情報を設定してください。

ヘッダパラメタ構造体アドレス

設定する必要はありません。

データパラメタ構造体アドレス

データパラメタ構造体のアドレスを設定してください。

HSIC使用領域1

GET要求時にHSICから返されたデータ管理パラメタ構造体のHSIC使用領域1を設定してください。

HSIC使用領域2

GET要求時にHSICから返されたデータ管理パラメタ構造体のHSIC使用領域2を設定してください。

ただし、GET要求時にHSICから返された入力電文長が0だった場合、そのときのデータ管理パラメタ構造体のHSIC使用領域2を設定しないでください。

データパラメタ構造体に次の情報を設定してください。

出力電文長

蓄積ファイルに出力する電文のサイズを1から9000000（単位：バイト）の範囲で設定してください。

電文長は、以下の計算式を満たす必要があります。

電文長≦INIT要求時の蓄積バッファサイズ−512バイト

出力電文格納エリアアドレス

電文を格納しているエリアのアドレスを設定します。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESAFLER_ARGUMENT

引数に設定した値が間違っています。

ESAFLER_TIMING

この関数を発行できる状態ではありません。

ESAFLER_CONDITION

INIT要求時に出力ファイルパラメタ構造体を設定していません。

ESAFLER_OVERFLOW

蓄積ファイルのサイズが1TBを超えるため、書き込みできません。

ESAFLER_IOERR

蓄積ファイルへのI/Oエラーが発生しました。

ESAFLER_SYSERR

システムエラーが発生しました。

ESAFLER_UNRESOLVABLE

その他のエラーが発生しました。

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。

以下のエラーリターンのあとに再度PUT要求を行うと、ESAFLER_TIMINGでエラーリターンします。

ESAFLER_OVERFLOW

ESAFLER_IOERR

8.3.4　拡張PUT要求

機能

蓄積実行により作成した蓄積ファイルを使用せずに新規に蓄積ファイルを作成するときに、ユーザ任意の電文情報の書き込み要求（拡張PUT要求）を行います。蓄積ファイルへの書き込みは、製品が付加するヘッダ情報を含めて最大1TBまで行うことができます。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_put_ex(ESAFL_DTPARAM *dtparam_pt, ESLONG flags)

パラメタの内容

ESAFL_DTPARAMのパラメタ内容

typedef struct es_afl_dtparam_t{        ………データ管理パラメタ構造体
    ESAFL_HEAD    *head_pt;             ………ヘッダパラメタ構造体アドレス
    ESAFL_DATA    *data_pt;             ………データパラメタ構造体アドレス
    char    yobi1[64];                  ………予備
    char    hsic_area1[512];            ………HSIC使用領域1
    char    hsic_area2[512];            ………HSIC使用領域2
} ESAFL_DTPARAM;

ESAFL_HEADのパラメタ内容

typedef struct es_afl_head_t{           ………ヘッダパラメタ構造体
    unsigned char    src_ip[4];         ………送信元IPアドレス
    unsigned char    dst_ip[4];         ………送信先IPアドレス
    unsigned short   src_port;          ………送信元ポート番号
    unsigned short   dst_port;          ………送信先ポート番号
    ESULONG protocol;                   ………プロトコル種別
    char    data_key[32];               ………電文キー
    char    yobi[80];                   ………予備
} ESAFL_HEAD;

ESAFL_DATAのパラメタ内容

typedef struct es_afl_data_t{           ………データパラメタ構造体
    ESLONG  data_area_len;              ………電文格納エリア長
    char    yobi1[4];                   ………予備
    ESLONG  indata_len;                 ………入力電文長
    ESLONG  indata_len1;                ………実入力電文長
    char    *indata_area_pt;            ………入力電文格納エリアアドレス
    ESLONG  outdata_len;                ………出力電文長
    char    yobi2[4];                   ………予備
    char    *outdata_area_pt;           ………出力電文格納エリアアドレス
    char    yobi[88];                   ………予備
} ESAFL_DATA;

UAPで値を設定するパラメタ項目

dtparam_pt

データ管理パラメタ構造体のアドレスを設定してください。

データ管理パラメタ構造体に次の情報を設定してください。

ヘッダパラメタ構造体アドレス

ヘッダパラメタ構造体のアドレスを設定してください。

データパラメタ構造体アドレス

データパラメタ構造体のアドレスを設定してください。

ヘッダパラメタ構造体に次の情報を設定してください。

送信元IPアドレス

電文の送信元IPアドレスを次に示す形式で設定します。

address_destination定義の-cオプションに指定する外部システムのIPアドレスを設定してください。設定した値のチェックは行いません。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0x A5

0x70

0x14

送信先IPアドレス

電文の送信先IPアドレスを次に示す形式で設定します。

address_destination定義の-sオプションに指定する既存システムのIPアドレスを設定してください。設定した値のチェックは行いません。

例） 172.165.112.20

[0]

[1]

[2]

[3]

0xAC

0x A5

0x70

0x14

送信元ポート番号

電文の送信元ポート番号を設定してください。

address_destination定義の-cオプションに指定する外部システムのポート番号を設定してください。設定した値のチェックは行いません。

送信先ポート番号

電文の送信先ポート番号を設定してください。

address_destination定義の-sオプションに指定する既存システムのポート番号を設定してください。設定した値のチェックは行いません。

プロトコル種別

電文のプロトコル種別を設定します。

ESAFL_PROTOMOD_TCP ：TCPプロトコル

ESAFL_PROTOMOD_UDP ：UDPプロトコル

ESAFL_PROTOMOD_HTTP：HTTPプロトコル

電文キー

電文の電文キー（16進数）を設定します。

システム内で一意となる値を設定してください。設定した値のチェックは行いません。

データパラメタ構造体に次の情報を設定してください。

出力電文長

蓄積ファイルに出力する電文のサイズを1から9000000（単位：バイト）の範囲で設定してください。

電文長は、以下の計算式を満たす必要があります。

電文長≦INIT要求時の蓄積バッファサイズ−512バイト

出力電文格納エリアアドレス

電文を格納しているエリアのアドレスを設定します。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESAFLER_ARGUMENT

引数に設定した値が間違っています。

ESAFLER_TIMING

この関数を発行できる状態ではありません。

ESAFLER_CONDITION

INIT要求時に出力ファイルパラメタ構造体を設定していません。

ESAFLER_OVERFLOW

蓄積ファイルのサイズが1TBを超えるため、書き込みできません。

ESAFLER_IOERR

蓄積ファイルへのI/Oエラーが発生しました。

ESAFLER_SYSERR

システムエラーが発生しました。

ESAFLER_UNRESOLVABLE

その他のエラーが発生しました。

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。

以下のエラーリターンのあとに再度PUT要求を行うと、ESAFLER_TIMINGでエラーリターンします。

ESAFLER_OVERFLOW

ESAFLER_IOERR

8.3.5　TERM要求

機能

蓄積ファイル編集ユーティリティの終了要求（TERM要求）を行います。

INIT要求後、終了するときは必ずTERM要求を行ってください。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_term（ESAFL_TPARAM *tparam_pt、 ESLONG flags）

パラメタの内容

ESAFL_TPARAMのパラメタ内容

typedef struct es_afl_tparam_t{        ………終了パラメタ構造体
    char    input_file_del;            ………蓄積ファイル削除有無
    char    yobi[127];                 ………予備
} ESAFL_TPARAM;

UAPで値を設定するパラメタ項目

tparam_pt

終了パラメタ構造体のアドレスを設定します。

終了パラメタ構造体に次の情報を設定してください。

蓄積ファイル削除有無

入力した蓄積ファイルを削除するかどうかを設定します。

INIT要求時に入力ファイルパラメタ構造体を指定したときのみ有効となります。

ESAFL_YES ：削除します。

ESAFL_NO ：削除しません。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

EE_OK

正常に終了しました。

ESAFLER_ARGUMENT

引数に設定した値が間違っています。

ESAFLER_TIMING

この関数を発行できる状態ではありません。

ESAFLER_IOERR

蓄積ファイルへのI/Oエラーが発生しました。

ESAFLER_SYSERR

システムエラーが発生しました。

ESAFLER_UNRESOLVABLE

その他のエラーが発生しました。

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。

9　システムテスト支援の障害情報の取得

システムテスト支援の障害情報の取得について説明します。

9.1　障害時に取得する情報

トラブルシュートのために以下に示す情報を取得し、取得したデータを解析して結果を出力します。

機能名及び内容を以下に示します。

表9‒1　トラブルシュート機能と内容

機能名

内容

メッセージログ

稼働状況管理および障害発生時の切り分けなどを目的としてメッセージをメッセージログファイルに出力する。

TASKTM

データ処理ごとのシステム統計情報を取得し、TASKTMファイルに出力する。

システム統計情報

システム稼働中の様々な事象の発生状況、頻度をシステム統計情報としてシステム統計情報ファイルに出力する。

出力されたシステム統計情報ファイルを編集出力コマンドにより読み込み、編集結果を標準出力またはcsvファイルに出力する。

モジュールトレース情報

関数の動作状況をモジュールトレースファイルに出力する。

9.2　メッセージログ

メッセージログの目的

システムテスト支援の稼働状況管理および障害発生時の切り分けなどを目的としてメッセージログを出力します。メッセージログ出力の契機は、稼働状況の変化、障害発生、コマンド入力などです。システムテスト支援の管理者は、システムテスト支援が出力するメッセージログを監視し、出力されたメッセージログに従って適切な対応をとる必要があります。

メッセージログの出力先

メッセージログはその種別や出力契機によって出力先が異なります。出力先を以下に示します。

表9‒2　メッセージログの出力先

出力先

出力するメッセージログ

syslog

エラーおよび警告を示すメッセージログを出力する。

システム定義により出力するメッセージログのレベルを設定できる。

メッセージログファイル

（標準出力／標準エラー出力）

全てのメッセージログと付加情報を出力する。

システムテスト支援プロセスでは、標準出力及び標準エラー出力はメッセージログファイルにリダイレクトして出力する。

コマンド実行画面

ログファイルオープン前のメッセージを出力する。

コマンド動作時、コマンド実行結果を出力する。

メッセージログファイル

メッセージログファイルはシステムテスト支援のメッセージログを出力するUNIXファイルです。

メッセージログファイルの内容は、テキストエディタ等で参照できます。ファイルの作成はシステムテスト支援が行い、システムテスト支援プロセスのテスト識別子毎に専用のファイルを作成します。

システムテスト支援の稼働状況を把握するために、運用方針にあわせてログファイルを管理する必要があります。

作成するファイルのサイズはシステムテスト支援の管理者がシステム定義にて設定します。

メッセージログファイルへは、複数ファイルのラウンドロビン方式でメッセージログを出力します。ファイルサイズがシステム定義の設定を超える場合に新しいファイルへ出力を切り替えます。

使用するログファイルのファイル数は最大10ファイル固定です。

システムテスト支援起動時、既にメッセージログファイルが全て使用済みの場合、更新日付が古い方のファイルから上書きで再利用し（ファイル内容を初期化（ファイルサイズを0）して使用する）ファイルに出力します。

図9‒1　メッセージログファイルの出力方式

メッセージログの付加情報

メッセージログファイルに出力するメッセージログの場合、TASKTM情報との突き合わせを目的として付加情報を出力します。出力する付加情報を以下に示します。

表9‒3　メッセージログの項目一覧

出力情報

内容

出力形式

プロセスID

メッセージログを出力したシステムテスト支援プロセスのID。

半角数字10文字

（スペース埋め）

メッセージ通番

メッセージログを出力したシステムテスト支援プロセス内での通番。

障害などでメッセージログファイル中のメッセージが欠落した場合でも、通番を基にメッセージのロストを検知できる。

半角数字7文字

（スペース埋め）

IFA番号

メッセージログを出力したスレッドの番号。

半角数字5文字

（スペース埋め）

中央処理通番

メッセージ処理中の出力の場合、当該メッセージ処理の中央処理通番。該当しない場合はハイフン（-）を表示。

半角数字8文字

（0埋め）

年月日

メッセージログを出力した日付。YYYY/MM/DD形式。

半角数字10文字

（スペース埋め）

時分秒マイクロ秒

メッセージログを出力した時刻。hh:mm:ss.xxxxxx形式。

半角数字15文字

（スペース埋め）

syslogの付加情報

syslogに出力する付加情報は、「メッセージログの項目一覧」の情報に加えてテスト識別子（1〜31バイト）を出力します。

表9‒4　syslog固有に出力するメッセージログ項目

出力情報

内容

出力形式

テスト識別子

メッセージログを出力したシステムテスト支援のテスト識別子。

識別子最大31バイト

メッセージログに関する設定

メッセージログは、出力先によってはシステム定義で出力するレベルなどを変更できます。システム定義で変更できる内容を以下に示します。

表9‒5　メッセージログのシステム定義で変更可能な項目

項目

機能

対応可能出力先

syslog

メッセージログファイル

メッセージログ抑止

出力するメッセージログのレベルを指定することで、意図するレベルのメッセージログのみを出力する。

○

×

メッセージログファイルのサイズ

メッセージログファイルの1ファイルあたりのサイズを変更する。

×

○

言語種別

出力するメッセージログの言語種別は、Linuxでは環境変数LANG、Windowsでは環境変数HSIC_LANGに設定する。

○

○

（凡例）

○：可、×：不可

環境変数LANGまたは環境変数HSIC_LANGに設定する言語種別（ロケール）

Linuxでは環境変数LANGによりメッセージの言語種別を設定します。Windowsでは環境変数HSIC_LANGによりメッセージの言語種別を設定します。

サポートする言語種別と、これらの環境変数に設定する文字列を以下に示します。

なお、環境変数LANGまたは環境変数HSIC_LANGが設定されていない場合、及びサポートしていない文字列が設定された場合の動作はCが指定されたものとして動作します。

表9‒6　サポートする言語種別

言語種別

LANGに設定する文字列

HSIC_LANGに設定する文字列

日本語UTF-8コード

ja_JP.UTF-8

設定できません。

日本語SJISコード

設定できません。

ja_JP.SJIS

英語

C

C

UOCからのメッセージログ出力

システムテスト支援プロセスで動作するUOCからprintf等の標準出力関数を使用してメッセージ出力すると、メッセージログファイルに出力します。

syslog遅延出力

syslogでメモリ不足またはバッファ不足が発生してsyslogに出力できないメッセージを極力少なくするため、用意したsyslog失敗リストにメッセージを保管して他タイミングで出力する機能です。

本機能は、システム定義のメッセージログ関連定義message_log -sオプションのsyslog_out（syslogへのメッセージ出力レベル）定義値が1以上の場合に動作します。

メッセージをsyslog失敗リストに保管する場合は、メッセージログ出力要求処理で次のいずれかの条件をみたしたときです。

条件1：syslog失敗リスト内のメッセージ数が0、かつ、syslog出力がメモリ不足またはバッファ不足で失敗

条件2：syslog失敗リスト内のメッセージ数が1以上

システムテスト支援コンポーネントの出力メッセージ長が、syslog失敗リストのエレメントのメッセージ格納領域長より長い場合、メッセージ終端から超過文字列＋4バイト分の文字列を切り捨てます。切捨て後メッセージの最後に半角英字記号4バイト文字列”(EL)”を付加します。

また、本機能は拡張SYSLOGがインストールされている場合のみ有効となります。

syslog出力不可状態からの回復

syslogへの出力が不可能状態になったとき、定期的に回復処理を行います。

syslogへの出力が可能になったときは、KFSE81902-I（SYSLOGへのメッセージ出力開始）メッセージを出力します。

出力先ディレクトリ

メッセージログファイルを作成するディレクトリとファイル名を以下に示します。

格納ディレクトリ：

/opt/HSIC/job/テスト識別子/spool/dceeinf/log/*

メッセージログファイルの名称：

XX……XXlognnn

XX……XX：テスト識別子の名称（識別子最大31バイト）

log：メッセージログファイルを示す固定文字列（半角英字3バイト）

nnn：メッセージログファイルのID（半角数字3バイト、001〜010）

イベントビューア

システムテスト支援のシステムメッセージはイベントビューアに出力されます。イベントビューアの出力形式を以下に示します。

表9‒7　イベントビューアへの出力形式

項目

出力内容

ソース

HSIC

タスクのカテゴリ

なし

イベントID

KFSExxxxx-Iメッセージ：25700～25709

KFSExxxxx-E、KFSExxxxx-Wメッセージ：25701～25709

バイナリデータ

なし

メッセージ

syslogファイルと同形式

9.3　TASKTMの概要

TASKTMは、システムテスト支援でなんらかの障害が発生した場合に、障害箇所を調査するためのシステムテスト支援内のデータ処理毎のシステム統計情報を出力する機能です。

TASKTMは主にシステムテスト支援のトラブルシュートで使用するもので通常の運用で使用することはありませんが、障害の調査の際に提供を依頼することがあります。

9.3.1　TASKTMの取得

各機能やUOCで取得したトラブルシュート情報は、処理するデータに付随する形で管理し、処理するプロトコルの電文単位に1レコードとして出力します。

処理対象のRPC・RAPプロトコル電文を例に以下に示します。

図9‒2　取得対象の電文

9.3.2　TASKTMのファイル出力

情報を取得する度にファイルへ出力するとディスクへのアクセス処理で時間が掛かります。

そこで、テストの並行実行や監視処理の妨げにならないようにファイルへの出力は専用のスレッドで行われます。また、ディスクへのアクセス回数を減らすために、メモリ上に情報を蓄積してから出力します。

メモリ上への蓄積はOSが提供するメモリマップ機能を利用します。これにより、coreファイルを出力して異常終了するような障害発生時でも、メモリ上に蓄積した情報がcoreファイルとは別のファイルに出力されます。このファイルを利用することで、coreファイルが無い場合でも、障害発生時のシステムテスト支援の実行状況を解析することができます。

1つのファイルにTASKTM情報が入り切らなくなった場合、出力先を次のファイルへ切り替えます。出力先のファイルを切り替える際にファイル名称をメッセージ出力します。また、強制出力コマンドを実行することで、メモリ上に蓄積した情報がファイルへ出力され編集可能となります。強制出力の詳細については「9.3.3　TASKTM強制出力」を参照してください。

メモリマップ

メモリマップ機能を利用したファイルへの出力方法の概要を以下に示します。

分割マッピング

1ファイル全てを一度にマッピングした場合、ファイルサイズが大きいと大量のメモリを消費してしまいます。トラブルシュート情報ファイルは先頭から順に書込みを行うためファイル全体を一度にマッピングしておく必要はなく、消費メモリ削減のために一定サイズに分割してマッピングを行います。この分割する単位を1ブロックとし、分割するサイズのことをブロックサイズと呼びます。ブロックサイズはシステム定義で指定します。

分割してマッピングするサイズはOSが提供するメモリマッピング機能の仕様によりページサイズの倍数にする必要があります。そのため、指定された値をブロックサイズの最大値として扱い、ページサイズの倍数値を実際のブロックサイズとして起動時に算出・決定します。

例を以下に示します。

図9‒3　実際のブロックサイズ算出例

マッピング領域管理

1ブロックがレコードサイズの倍数とならなかった場合は、ブロック内に未使用領域が発生してしまいます。そこで、1ブロック内の状態を管理するため、ヘッダとフッタを付加して未使用領域の管理を行います。概要を以下に示します。

図9‒4　メモリマップ領域管理の概要

複数マッピング

1ブロックに情報が入り切らなくなった場合はマッピング領域の切り替えを行う必要がありますが、マッピング領域を切り替えている間に取得したトラブルシュート情報は蓄積する先がないため欠落してしいます。トラブルシュート情報の欠落を少なくするために起動時に複数ブロックのマッピングを行い、マッピング領域を切り替えている間もトラブルシュート情報の取得が行えるようにします。

マッピングするブロック数はシステム定義で指定します。概要を以下に示します。

図9‒5　起動時の複数同時マッピング概要

マッピング領域の切り替え

1ブロック分の情報取得が終わりマッピング解除が完了した後に、次のマッピングを行います。既に出力先ファイルの終端までマッピングしていた場合は、次の出力先ファイルをマッピングします。概要を以下に示します。

図9‒6　マッピング領域の切り替え概要

図9‒7　マッピング領域の切り替え概要（ファイル跨ぎ）

ファイル管理

TASKTMで使用するファイルは、UNIXファイルを使用します。ファイルが存在しない場合は新たに作成します。既に存在する場合は既存ファイルを利用します。ファイル名は作成時に以下の命名基準に従って自動的に決定します。

「テスト識別子＋"tasktm"＋通番（10進数の3桁）」

また、ファイル数およびファイルサイズについてはシステム定義で指定します。システム起動時にファイルを新規作成する場合は、定義で指定したファイルサイズ×ファイル数のファイルを作成するため、十分なディスク容量を用意してください。

指定したファイル数を使い切った場合は、最も古いファイルを上書き再利用します。既存ファイルがシステム定義で指定したファイルサイズと異なる場合は、上書き再利用することが決まった時点で指定したサイズへ切り詰め・伸長を行います。

次の出力先として決定したファイルを上書き再利用することが決まるタイミングは、実際に出力先ファイルが切り替わるタイミングよりも早いためファイルの切り詰め・伸長を行う場合はメッセージを出力します。

ファイルの縮退が発生して出力可能なファイルが1つのみになった場合、ファイルの切り替えは発生しないためファイル切替メッセージの出力を行わずに、ファイルの先頭からマッピングを行います。

メッセージが出力されるタイミングについて以下に示します。

図9‒8　ファイル切り替えメッセージ出力タイミング

マッピング領域を3ブロックとして、1.、2.～6.の順にマッピングしていくとします。4.がマッピングされた時点で、ファイル2のサイズが定義と異なる場合、切り詰めや伸長を行い、メッセージを出力します。3.のマッピングが解除された時点で、出力先ファイルが切り替わるため、メッセージを出力します。

出力契機と出力先切り替え

ファイルへの出力はマッピングしているブロック単位に行います。マッピングしている領域が満杯になるか、または強制出力コマンド実行時にファイルへ出力します。

また、出力先ファイルが満杯になるか強制出力コマンドが出力先切り替えオプション指定で実行された場合は、次の出力先ファイルへ切り替えます。

強制出力コマンドで出力する場合、コマンド実行時点で以降の領域は未使用領域となるため、短時間で連続実行するとファイルの使用効率が悪くなります。最新のトラブルシュート情報をすぐ確認したい場合や、現行出力先ファイルのバックアップが必要な場合以外はメリットが無いため、必要以上に実行しないでください。

図9‒9　ファイル出力契機（マッピング領域満杯）

図9‒10　ファイル出力契機（強制出力）

図9‒11　出力先切り替え契機（出力先満杯）

図9‒12　出力先切り替え契機（強制出力）

出力先ディレクトリ

出力先ディレクトリは、「/opt/HSIC/job/テスト識別子/spool/dceeinf/tasktm」に出力します。

9.3.3　TASKTM強制出力

メモリ上に蓄積していたTASKTM情報を強制的にファイルへ出力できます。

ただし、処理中の電文情報は出力されません。

出力先ファイル切り替えオプションを指定することで出力先ファイルを切り替えられます。デフォルトでは出力先ファイルの切り替えは行わず、同一ファイルへ出力を続けます。

コマンドの詳細は「4.3.15　estrbtaskfput（TASKTMの情報強制出力）」を参照してください。

9.3.4　TASKTM機能の縮退

出力先のファイルが入出力障害となった場合、メッセージを出力してから障害が発生していないファイルに出力先を切り替えます。障害が発生したファイルは、使用不可能にします。これをファイルの縮退と呼びます。

出力先とするファイルが全て縮退した場合は、トラブルシュート情報の出力を停止します。

ただし、システムテスト支援は続行します。

正常開始時の初期化処理で障害が発生したファイルが2つ以上の場合はプロセス起動を停止し、異常終了します。

9.4　システム統計情報機能の概要

システム稼働中の様々な事象の発生状況、頻度をシステム統計情報としてファイルに取得します。また、これを編集出力することによりシステム稼働状況の把握に役立てることができます。

システム統計情報機能を使用する場合は、システム定義でシステム統計情報機能オプションを定義してください。また、システム統計情報ファイルのサイズとファイル数も定義で指定してください。

システム統計情報の取得

システム統計情報の取得はシステム定義に従い、指定された間隔で取得要求が発生するようタイマ登録して取得処理を行います。指定間隔で取得する処理の流れを以下に示します。取得範囲はシステム起動からシステム停止までの間で、取得要求ごとに1レコードとして出力します。

図9‒13　指定間隔でのシステム統計情報取得処理概要

システム統計情報の詳細

システム統計情報の詳細を以下に示します。

表9‒8　システム統計情報の詳細

システム統計情報種別

イベント

内容

出力プロトコル*1

編集ID

日本語

英字

日本語

英字

パケット

情報

packet-

information

パケット受信のサイズ

Captured

packet size

パケット受信したサイズ。

イベント数は、パケット受信した回数

キャプチャ制御で破棄したパケットは含まれません。

共通

1

パケットロストのサイズ

Failed capture

packets size

パケットロストしたサイズ。

イベントの数は、パケットロストした回数

2

キャプチャしたパケット数

Captured

packets

キャプチャに成功したパケット数。

3

キャプチャできなかった

パケット数

Failed capture

packets

トラブルシュートで使用する情報です。

4

エラーパケット数

Error packets

エラーにより破棄したパケット数。

5

フラグメントパケット数

Fragment packets

フラグメントパケット数。

6

再送パケット数

Retransmit packets

再送パケット数。

7

エラーによるコネクション切断数

Error connection count

エラーによりコネクション切断と認識した数。

8

通信制御

情報

communication-

control-

information

データ送信サイズ

Send size

トラブルシュートで使用する情報です。

共通

11

データ受信サイズ

Receive size

トラブルシュートで使用する情報です。

12

EAGAIN

EAGAIN

トラブルシュートで使用する情報です。

13

ディスクリプタ不足

（connect）

Connect descriptor shortage

トラブルシュートで使用する情報です。

14

ディスクリプタ不足

（accept）

Accept

descriptor shortage

トラブルシュートで使用する情報です。

15

IBF確保要求回数

IBF reservation request

トラブルシュートで使用する情報です。

16

IBF確保失敗回数

IBF reservation failure

トラブルシュートで使用する情報です。

17

コネクション確立回数

（connect）

Connect count

トラブルシュートで使用する情報です。

18

コネクション確立回数

（accept）

Accept count

トラブルシュートで使用する情報です。

19

コネクション解放回数

Release count

トラブルシュートで使用する情報です。

20

コネクション断検知回数

Disconnect count

トラブルシュートで使用する情報です。

21

電文組立て情報

constitution-

data-

information

完成したRPC電文数

Completed data

受信パケットから組み立てに成功した電文数

以下の電文数を含みます。

破棄したRPC電文数（定義）

破棄したRPC電文数（UOC）

破棄したRPC電文数（対象外）

破棄したRPC電文数（要求電文なし）

rpc

31

破棄したRPC未完成

電文数

Incomplete

discard data

rpc_build_message_watchtime -t watchtimeに指定した監視時間内に電文組立処理が完了しなかった電文数。

32

破棄したRPC電文数

（定義）

Definition discard data

定義：rpc_telegram_filterに従い破棄したRPC（またはRAP）電文数。

33

破棄したRPC電文数

（UOC）

UOC discard data

入力判定UOCで破棄したRPC（またはRAP）電文数。

34

破棄したRPC電文数

（対象外）

System discard data

取得対象外のRPC（またはRAP）電文のため破棄した電文数

35

破棄したRPC電文数

（要求電文なし）

No request discard dat

以下の要因で破棄した応答電文数。

応答電文に対応する要求電文が受信されなかった

address_destination -sオプションにて指定したIPアドレス・ポート番号の要求電文に対応していない応答電文を受信した

36

処理対象RPC電文数

Target for processing data

トラブルシュートで使用する情報です。

37

処理キュー

情報

processing-

queue-

information

プロトコルデータの

キュー滞留時間

Protocol data stayed time

キューに登録されてから引き出されるまでの時間

イベント数はプロトコルデータ処理を行った回数。

共通

41

プロトコルデータの

キュー滞留数合計

Queued protocol data total count

キュー引き出し時にキューに残っている処理対象のプロトコルデータ数の合計。

イベント数はプロトコルデータ処理を行った回数。

42

蓄積ファイル

情報

stored-file-

information

本番要求電文の

writeサイズ

Req Data Output buffer

トラブルシュートで使用する情報です。

共通

51

本番要求電文の

出力用バッファ面数

Req Data Buffer extension count

トラブルシュートで使用する情報です。

52

本番要求電文の

open時間

Req Data File open time

トラブルシュートで使用する情報です。

53

本番要求電文の

close時間

Req Data File close time

トラブルシュートで使用する情報です。

54

本番要求電文の

出力処理時間

Req Data Output time

トラブルシュートで使用する情報です。

55

本番応答電文の

writeサイズ

Rpy Data Output buffer

トラブルシュートで使用する情報です。

56

本番応答電文の

出力用バッファ面数

Rpy Data Buffer extension count

トラブルシュートで使用する情報です。

57

本番応答電文の

open時間

Rpy Data File open time

トラブルシュートで使用する情報です。

58

本番応答電文の

close時間

Rpy Data File close time

トラブルシュートで使用する情報です。

59

本番応答電文の

出力処理時間

Rpy Data Output time

トラブルシュートで使用する情報です。

60

テスト要求電文の

writeサイズ

Reqts Data Output buffer

トラブルシュートで使用する情報です。

61

テスト要求電文の

出力用バッファ面数

Reqts Data Buffer extension count

トラブルシュートで使用する情報です。

62

テスト要求電文の

open時間

Reqts Data File open time

トラブルシュートで使用する情報です。

63

テスト要求電文の

close時間

Reqts Data File close time

トラブルシュートで使用する情報です。

64

テスト要求電文の

出力処理時間

Reqts Data Output time

トラブルシュートで使用する情報です。

65

テスト応答電文の

writeサイズ

Rpyts Data Output buffer

トラブルシュートで使用する情報です。

66

テスト応答電文の

出力用バッファ面数

Rpyts Data Buffer extension count

トラブルシュートで使用する情報です。

67

テスト応答電文の

open時間

Rpyts Data File open time

トラブルシュートで使用する情報です。

68

テスト応答電文の

close時間

Rpyts Data File close time

トラブルシュートで使用する情報です。

69

テスト応答電文の

出力処理時間

Rpyts Data Output time

トラブルシュートで使用する情報です。

70

蓄積ファイルの

readサイズ

Data Input size for verification

トラブルシュートで使用する情報です。

71

蓄積ファイルの

read時間

Data Input time for verification

トラブルシュートで使用する情報です。

72

ファイル出力

スレッド情報

file-thread-

information

トラブルシュートの

キュー滞留数

Troubleshooting Queued count

トラブルシュートで使用する情報です。

共通

81

トラブルシュートの

キュー滞留時間

Troubleshooting Queuing time

トラブルシュートで使用する情報です。

82

トラブルシュートの

排他実行時間

Troubleshooting Exclusion time

トラブルシュートで使用する情報です。

83

本番要求電文蓄積の

キュー滞留数

Req Data Queued count

トラブルシュートで使用する情報です。

84

本番要求電文蓄積の

キュー滞留時間

Req Data Queuing time

トラブルシュートで使用する情報です。

85

本番要求電文蓄積の

排他実行時間

Req Data Exclusion time

トラブルシュートで使用する情報です。

86

本番応答電文蓄積の

キュー滞留数

Rpy Data Queued count

トラブルシュートで使用する情報です。

87

本番応答電文蓄積の

キュー滞留時間

Rpy Data Queuing time

トラブルシュートで使用する情報です。

88

本番応答電文蓄積の

排他実行時間

Rpy Data Exclusion time

トラブルシュートで使用する情報です。

89

テスト要求電文蓄積の

キュー滞留数

Reqts Data Queued count

トラブルシュートで使用する情報です。

90

テスト要求電文蓄積の

キュー滞留時間

Reqts Data Queuing time

トラブルシュートで使用する情報です。

91

テスト要求電文蓄積の

排他実行時間

Reqts Data Exclusion time

トラブルシュートで使用する情報です。

92

テスト応答電文蓄積の

キュー滞留数

Rpyts Data Queued count

トラブルシュートで使用する情報です。

93

テスト応答電文蓄積の

キュー滞留時間

Rpyts Data Queuing time

トラブルシュートで使用する情報です。

94

テスト応答電文蓄積の

排他実行時間

Rpyts Data Exclusion time

トラブルシュートで使用する情報です。

95

比較・検証情報

verification-

information

RPCのデータ一致数

（正常応答電文）

Normal reply detects match

既存システム環境とテストシステム環境の両方で正常応答電文が返り、比較結果が合致した数

rpc

101

RPCのデータ一致数

（エラー応答電文）

Error reply detects match

既存システム環境とテストシステム環境の両方でエラー応答電文が返り、比較結果が合致した数

102

RPCのデータエラー数

（システム検出）

System detects error

システムでデータ比較・検証時に検出したエラー数

103

RPCのデータエラー数

（UOC検出）

UOC detects error

UOCでデータ比較・検証時に検出したエラー数

104

メモリ情報

memory-

information

システム用テーブル領域

使用量

System table area

トラブルシュートで使用する情報です。

共通

111

システム用ワーク領域使用量

System work area

トラブルシュートで使用する情報です。

112

IBF使用量

IBF

トラブルシュートで使用する情報です。

113

トラブルシュート情報

troubleshooting-

information

TASKTM出力レコード数

TASKTM output records

トラブルシュートで使用する情報です。

共通

121

TASKTM破棄レコード数

TASKTM destruction records

ファイルに出力せずに破棄したTASKTMレコードの数

122

TASKTMopen時間

TASKTM open time

トラブルシュートで使用する情報です。

123

TASKTMclose時間

TASKTM close time

トラブルシュートで使用する情報です。

124

TASKTM書き込み時間

TASKTM write time

トラブルシュートで使用する情報です。

125

統計情報出力レコード数

Statistics output records

トラブルシュートで使用する情報です。

126

統計情報破棄レコード数

Statistics destruction records

ファイルに出力せずに破棄したシステム統計情報レコードの数

127

統計情報open時間

Statistics open time

トラブルシュートで使用する情報です。

128

統計情報close時間

Statistics close time

トラブルシュートで使用する情報です。

129

統計情報書き込み時間

Statistics write time

トラブルシュートで使用する情報です。

130

TCPスルー情報

tcp-through-information

処理対象パケット数

Target for processing packet

キャプチャしたパケットのうち、実際に処理された数。

tcp

http

141

送信できなかったパケット数

Sending error packets

送信処理に失敗したパケット数

142

破棄パケット数（コネクション不可）

Discard packet（connection）

トラブルシュートで使用する情報です

143

破棄パケット数（対象外キャプチャ）

Discard packet（capture）

トラブルシュートで使用する情報です

144

破棄パケット数（対象外受信）

Discard packet（recv）

トラブルシュートで使用する情報です

145

コネクション解放検知回数

Release connection

トラブルシュートで使用する情報です

146

UDPスルー情報

udp-through-information

処理対象パケット数

Target for processing packet

キャプチャしたパケットのうち、実際に処理された数。

udp

151

送信できなかったパケット数

Sending error packets

送信処理に失敗したパケット数

152

破棄パケット数（対象外キャプチャ）

Discard packet （capture）

トラブルシュートで使用する情報です

153

破棄パケット数（対象外受信）

Discard packet （recv）

トラブルシュートで使用する情報です

154

UDP通信制御情報

udp-communication- control-information

データ送信サイズ

Send size

トラブルシュートで使用する情報です。

udp

161

EAGAIN

EAGAIN

トラブルシュートで使用する情報です。

163

*1

この欄に記載されている文字列が、address_destination -pに指定されている場合に出力されます。

共通と記載されている項目は、address_destination –pの指定に関係なく出力されます。

システム統計情報ファイル出力

システム統計情報のファイル出力はTASKTMと同様の方法で行います。詳細は「9.3.2　TASKTMのファイル出力」を参照してください。

但し、参照する場合は「TASKTM情報」を「システム統計情報」に読み替えてください。

システム統計情報の強制出力コマンドの詳細については「4.3.14　estrbstcfput（システム統計情報の強制出力）」を参照してください。

メモリマップ

TASKTMと同様の方法で行います。詳細は「9.3.2　TASKTMのファイル出力」の「メモリマップ」を参照してください。

但し、参照する場合は「TASKTMファイル」を「システム統計情報ファイル」に読み替えてください。

ファイル管理

TASKTMと同様の方法で行います。詳細は「9.3.2　TASKTMのファイル出力」の「ファイル管理」を参照してください。

ファイル名は以下の命名基準に従います。

「テスト識別子＋"stc"＋通番（10進数の3桁）」

出力契機と出力先切り替え

TASKTMと同様の方法で行います。詳細は「9.3.2　TASKTMのファイル出力」の「出力契機と出力先切り替え」を参照してください。

但し、参照する場合は「TASKTMファイル」を「システム統計情報ファイル」に読み替えてください。

出力先ディレクトリ

出力先ディレクトリは、「/opt/HSIC/job/テスト識別子/spool/dceeinf/stc」とします。

システム統計情報リアルタイム出力

システム稼働中のリアルタイムな情報を「estrbreport」コマンドにより標準出力へ出力することができます。

システム統計情報強制出力コマンド

メモリ上に蓄積していたシステム統計情報をファイルへ出力します。

出力先ファイル切り替えオプションを指定することで出力先ファイルを切り替えられます。デフォルトでは出力先ファイルの切り替えは行わず、同一ファイルへ出力を続けます。

コマンドの詳細は「4.3.14　estrbstcfput（システム統計情報の強制出力）」を参照してください。

システム統計情報編集コマンド

システム統計情報ファイルを入力として、システム統計情報の編集結果を標準出力またはcsvファイルに出力します。

コマンドの詳細は「4.3.13　estrbstced（システム統計情報のファイル編集）」を参照してください。

システム統計情報機能の縮退

TASKTMと同様の方法で行います。詳細は「9.3.4　TASKTM機能の縮退」を参照してください。

但し、参照する場合は「TASKTM」を「システム統計情報」に読み替えてください。

9.5　モジュールトレース

モジュールトレースは、システムテスト支援でなんらかの障害が発生した場合に、障害箇所を調査するためのシステムテスト支援内部の関数の動作状況を出力する機能です。

通常の運用で使用することはありませんが、障害の調査の際に提供を依頼することがあります。

出力ディレクトリ

出力先ディレクトリは、「/opt/HSIC/job/テスト識別子/spool/dceeinf/mdl」とします。

モジュールトレースファイル名称

XX ……XXmdlnnn

XX……XX：テスト識別子（識別子最大31バイト）

mdl：モジュールトレースファイルを示す固定文字列（半角英字3バイト）

nnn：モジュールトレースファイルのID（半角数字3バイト、001〜002）

モジュールトレース機能での障害発生時の動作

オンライン開始時のモジュールトレースファイル作成失敗時はシステムテスト支援が異常終了します。

モジュールトレースファイルの作成に必要なディスク容量を用意してください。

必要なディスク容量は、「9.6.4　モジュールトレースファイル」を参照してください。

オンライン中のモジュールトレースファイル作成失敗時はメッセージを出力してシステムテスト支援はそのまま続行します。

9.6　トラブルシュートに関するファイルの運用

トラブルシュートに関するファイルとは、以下のファイルを指します。

メッセージログファイル

TASKTMファイル

システム統計情報ファイル

モジュールトレースファイル

ここでは、それぞれのファイルの運用方法について示します。

9.6.1　メッセージログファイル

メッセージログの保存

ファイルサイズとファイル数

ログファイルのサイズは、システム定義にて設定可能です。ログファイルのサイズはシステムテスト支援定義のメッセージログ関連定義message_logの-f fileszに指定します。

定義の設定方法は、「3.13　メッセージログ関連定義（message_log）」を参照してください。

ログファイルのファイル数は、10ファイル固定とします。

ハードディスク容量などのシステム構成を考慮してシステム定義を設定してください。

ログファイルのバックアップ

ログファイルは複数ファイルのラウンドロビン方式で使用するため、ログファイルの切替が発生すると古いファイルを上書きで再利用します（ファイル内容を初期化（ファイルサイズを0）して使用します）。したがって、ログファイルの内容を保存したい場合には古いログファイルをバックアップする必要があります。

システムテスト支援ではログファイルを切り替えた場合にその旨を示すメッセージログKFSE81901-Iを出力するため、当該メッセージをログファイルのバックアップ契機に使用できます。

KFSE81901-Iメッセージが出力されるタイミングで、メッセージログのバックアップを取得して、同一論理ボリューム上でファイル移動（mvコマンド）することを推奨します。

但し、JP1/Baseを使用しシステムテスト支援のメッセージログファイルを監視したい場合のバックアップ方法は、ファイル移動（mvコマンド）ではなくファイル複写（cpコマンド）で行ってください。ファイル移動を行うと、メッセージログファイルの削除と同じ扱いとなるためファイル移動を行ったメッセージログファイルはJP1/Baseの監視対象外となります。

図9‒14　メッセージログファイルの使用例

注：

プロセス起動時、該当ファイル名称のファイルがある場合はデータをクリアして使用（更新日付の最古のものから上書きで再利用）し、無い場合は作成して使用します。

メッセージログの障害時運用

ログファイルへの出力エラーなど何らかの要因でログファイルへのメッセージログ出力が失敗した場合、メッセージログファイルの運用とシステムテスト支援の動作は下表のようになります。

表9‒9　メッセージ出力失敗時のメッセージログファイルの運用とシステムテスト支援の動作

切り替え可能な

メッセージログファイル

メッセージログファイルの運用

システムテスト支援の

動作

あり

メッセージログファイルを切り替えて使用

動作続行

なし

（全メッセージログファイルが使用不能になった場合）

メッセージログ出力を中止

異常終了

9.6.2　TASKTMファイル

TASKTMファイルの容量設定

TASKTMファイルは、システムテスト支援のプロセス毎にUNIXファイルを作成し、作成したファイルをラウンドロビン方式で使用します。

TASKTMファイルのサイズ、およびファイル数は、ディスク容量と保存しておくTASKTM情報の量を考慮して設定します。1日分のTASKTM情報を保存できるように設定することを推奨します。

TASKTMファイルのサイズ、およびファイル数の見積もり方法を以下に示します。

まず全体のTASKTM情報量の計算式を示します。

求めた結果に安全率として1.2程度を掛けることを推奨します。

全体のTASKTM情報の量（T）＝　256×n＋↑256×n÷（b×1024）↑×96　＋（96+40×（v + g））×f

1電文毎に取得するTASKTM情報のバイト数 ：256

1ブロック毎に付加する情報のバイト数 ：96

1ファイル単位に付加する情報のバイト数 ：96 + 40×（v + g）

n=RPC電文数（キャプチャした電文数とテスト対象システムから受信した電文数の合計）

v=RPC要求先のサービスグループ名の数

g=RPC要求先のサービス名の数

b=TASKTMブロックサイズ（tasktm_information -b blocksz設定値）

f=TASKTMファイル数（tasktm_information -f fileno設定値）

全体のTASKTM情報の量（T）から、tasktm_information -f fileszに設定するTASKTMファイルのサイズを求めます。（単位はキロバイト）

TASKTMファイルのサイズ＝↑↑T÷f↑÷1024↑

求めたファイルのサイズがtasktm_information -f fileszに設定できる上限値を超える場合は、tasktm_information -f fileno設定値を大きくして再計算してください。

以下に計算例を示します。

RPCの電文数：1分間に10000電文で6時間実行
10000×360＝                               3600000
RPC要求先のサービスグループ名の数              100
RPC要求先のサービス名の数                      200
tasktm_information -b blocksz                  200(省略値)
tasktm_information -f fileno                     3(省略値)

T＝    256×3600000
   ＋↑256×3600000÷(200×1024）↑×96
   ＋（96＋40×(100＋200))×3
 ＝921640788バイト
1.2倍する
 ＝1105968946バイト

TASKTMファイルのサイズ＝
 ↑↑ 1105968946÷3↑÷1024↑
 ＝360016キロバイト

TASKTMファイルの作成と削除

TASKTMファイルはシステムテスト支援プロセス起動時にシステムテスト支援が作成します。古いファイルが残っている場合は、上書きして使用します。そのためシステムテスト支援の管理者がTASKTMファイルの作成と削除をする必要はありません。

TASKTMファイルの保存

TASKTMファイルのバックアップを保存する場合は、cpコマンド、mvコマンドなどでバックアップを保存してください。

システムテスト支援実行中にTASKTMファイルのバックアップを保存する場合は、TASKTMファイルスワップ時に出力されるKFSE85400-Iメッセージをきっかけとして、スワップ元ファイルを保存することを推奨します。

9.6.3　システム統計情報ファイル

システム統計情報ファイルの容量設定

システム統計情報ファイルは、システムテスト支援のプロセス毎にUNIXファイルを作成し、作成したファイルをラウンドロビン方式で使用します。

システム統計情報ファイルのサイズ、およびファイル数は、ディスク容量と保存しておくシステム統計情報の量を考慮して設定してください。1日分のシステム統計情報を保存できるように設定することを推奨します。

統計ファイルのサイズ、およびファイル数の見積もり方法を以下に示します。

まず全体のシステム統計情報量の計算式を示します。

求めた結果に安全率として1.2程度を掛けることを推奨します。

全体のシステム統計情報の量（T）＝　1312×n＋↑1312×n÷（b×1024）↑×96＋96×f

システム統計情報取得間隔毎に取得するシステム統計情報のバイト数 ：1312

1ブロック毎に付加する情報のバイト数 ：96

n=システム統計情報取得回数。

システムテスト支援のプロセス実行時間をシステム統計情報取得間隔（statistical_information -u interval_time設定値）で割って求める。

b=システム統計情報ブロックサイズ（statistical_information -b blocksz設定値）

f=システム統計情報ファイル数（statistical_information -f fileno設定値）

全体のシステム統計情報の量（T）から、statistical_information -f fileszに設定するシステム統計情報ファイルのサイズを求めます。（単位はキロバイト）

システム統計情報ファイルのサイズ＝↑↑T÷f↑÷1024↑

求めたファイルのサイズがstatistical_information -f fileszに設定できる上限値を超える場合は、statistical_information -f fileno設定値を大きくして再計算してください。下限値より小さい場合は、下限値を指定してください。

以下に計算例を示します。

統計情報取得回数：60秒間隔で6時間実行
6×3600÷60＝360回                        360
statistical_information -b blocksz        200(省略値)
statistical_information -f fileno           3(省略値)

T＝    1312×360
   ＋↑1312×360÷(200×1024）↑×96
   ＋96×3
 ＝458211バイト
1.2倍する
 ＝549854バイト

統計情報ファイルのサイズ＝
 ↑↑ 549854÷3↑÷1024↑
 ＝179キロバイト
下限値より小さいので、下限値の4000を設定する。

システム統計情報ファイルの作成と削除

システム統計情報ファイルはシステムテスト支援プロセス起動時にシステムテスト支援が作成します。古いファイルが残っている場合は、上書きして使用します。そのためシステムテスト支援の管理者がシステム統計情報ファイルの作成と削除をする必要はありません。

システム統計情報ファイルの保存

システム統計情報ファイルのバックアップを保存する場合は、cpコマンド、mvコマンドなどでバックアップを保存してください。

システムテスト支援実行中にシステム統計情報ファイルのバックアップを保存する場合は、システム統計情報ファイルスワップ時に出力されるKFSE85400-Iメッセージをきっかけとして、スワップ元ファイルを保存することを推奨します。

9.6.4　モジュールトレースファイル

モジュールトレースファイルの容量設定

モジュールファイルは、システムテスト支援のプロセス毎にUNIXファイルを2つ作成し、プロセス起動時にファイルを切り替えて使用します。

モジュールトレースファイルの容量の見積もり方法を以下に示します。

処理スレッド数がシステムテスト支援実行中に動的に増加すると、モジュールトレースファイルサイズが増加するため、余裕を持って充分なディスク容量を用意してください。

スレッド数の総数の求め方は、メモリ算定式を参照してください。

モジュールトレースの容量=　↑（48＋8×n）÷p↑×p×スレッド数の総数×2

n：module_trace -e entry設定値

p：OSのページサイズ。OSのページサイズについては、OSのマニュアルを参照してください。（Linux（x86、x86_64）では通常4KBです）。

以下に計算例を示します。

module_trace -e entry設定値     256(省略値)
OSのページサイズ               4096
スレッド数の総数                100

T＝  ↑(48＋8×256)÷4096↑×4096×100×2
 ＝819200バイト

モジュールトレースファイルの作成と削除

モジュールトレースファイルはシステムテスト支援プロセス起動時にシステムテスト支援が作成します。古いファイルが残っている場合は、上書きして使用します。そのためシステムテスト支援の管理者がモジュールトレースファイルの作成と削除をする必要はありません。

モジュールトレースファイルの保存

モジュールトレースファイルのバックアップを保存する場合は、cpコマンド、mvコマンドなどでバックアップを保存してください。保守員がバックアップの取得を依頼したとき以外は、バックアップを取得する必要はありません。

10　システムテスト支援の主な障害の要因と対処

システムテスト支援の主な障害の要因と対処について説明します。

10.1　障害の要因と対処

システムテスト支援で発生する障害要因とその後処理、および回復方法について以下に示します。

10.1.1　全プロトコル共通

表10‒1　システムテスト支援で発生する障害要因とその後処理、および回復方法（共通）

障害要因

並行実行

リプレイ実行

PCAP実行

後処理

回復方法

後処理

回復方法

後処理

回復方法

プログラム不良

（製品、UOCでシグナル発生）

プロセスダウン

再開始なし

（手動再開始）

プロセスダウン

再開始なし

（手動再開始）

プロセスダウン

再開始なし

（手動再開始）

マシンダウン

（電源断、OSダウン）

同上

同上

同上

同上

同上

同上

蓄積ファイル障害

（I/O障害）

全ファイルが出力不可の場合プロセスダウン

再開始なし

（手動再開始）

プロセスダウン

再開始なし

（手動再開始）

該当無し

該当無し

出力可の場合処理続行（縮退）

ファイル蓄積無しで続行

現新比較/システム監視のみ続行

該当サービス/経路のみ停止

10.1.2　RPC・RAP

表10‒2　システムテスト支援で発生する障害要因とその後処理、および回復方法 （ RPC/RAP ）

障害要因

並行実行

リプレイ実行

PCAP実行

後処理

回復方法

後処理

回復方法

後処理

回復方法

外部システムと既存システム間のコネクション障害

RSTパケット受信

中途半端な受信済パケットデータの破棄

次データから処理継続

該当しない

該当しない

中途半端な受信済パケットデータの破棄

次データから処理継続

FINパケット受信

破棄（無視）

なし

破棄（無視）

なし

システム検証支援基盤システムとテスト対象システム間のコネクション障害

システム検証支援基盤システムがクライアント

FIN/RST受信

なし

なし

なし

なし

なし

なし

テスト対象システムへのコネクション確立失敗

処理続行不可の場合

プロセスダウン

再開始なし

（手動再開始）

処理続行不可の場合

プロセスダウン

再開始なし

（手動再開始）

処理続行不可の場合

プロセスダウン

再開始なし

（手動再開始）

処理続行可の場合

要求電文破棄

送信しない。次データから処理継続

処理続行可の場合

要求電文破棄

送信しない。次データから処理継続

処理続行可の場合

要求電文破棄

送信しない。次データから処理継続

通信障害（送信エラー）

（システム検証支援基盤システムとテスト対象システム間の障害）

リトライ可の場合

（EAGAIN等）

再送

（リトライ回数/間隔定義指定）

なし

リトライ可の場合

（EAGAIN等）

再送

（リトライ回数/間隔定義指定）

なし

リトライ可の場合

（EAGAIN等）

再送

（リトライ回数/間隔定義指定）

なし

リトライ不可の場合

（相手サーバダウン等）

要求電文破棄

送信しない。次データから処理継続

リトライ不可の場合

（相手サーバダウン等）

要求電文破棄

送信しない。次データから処理継続

リトライ不可の場合

（相手サーバダウン等）

要求電文破棄

送信しない。次データから処理継続

パケットロスト

（RPC/RAPプロトコルの場合）

中途半端な受信済パケットデータの破棄

次データから処理継続

該当しない

該当しない

中途半端な受信済パケットデータの破棄

次データから処理継続

10.1.3　TCPスルー

表10‒3　システムテスト支援で発生する障害要因とその後処理、および回復方法 （ TCPスルー ）

障害要因

並行実行

リプレイ実行

PCAP実行

後処理

回復方法

後処理

回復方法

後処理

回復方法

外部システムと既存システム間のコネクション障害

RSTパケット受信

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

FINパケット受信

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

パケット破棄し、テスト対象システムとの間のコネクション解放※

次パケットから処理継続

システム検証支援基盤システムとテスト対象システム間のコネクション障害

システム検証支援基盤システムがクライアント

FIN/RST受信

なし

なし

なし

なし

なし

なし

パケット送信時のコネクション確立失敗

処理続行可の場合

パケット破棄

送信しない。次パケットから処理継続。（ただし、15秒間は破棄）

処理続行可の場合

パケット破棄

送信しない。次パケットから処理継続。（ただし、15秒間は破棄）

処理続行可の場合

パケット破棄

送信しない。次パケットから処理継続。（ただし、15秒間は破棄）

通信障害（送信エラー）

（システム検証支援基盤システムとテスト対象システム間の障害）

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ不可の場合

（相手サーバダウン等）

パケット破棄

送信しない。次パケットから処理継続

リトライ不可の場合

（相手サーバダウン等）

パケット破棄

送信しない。次パケットから処理継続

リトライ不可の場合

（相手サーバダウン等）

パケット破棄

送信しない。次パケットから処理継続

パケットロスト

コネクション解放

次パケットから処理継続

コネクション解放

次パケットから処理継続

コネクション解放

次パケットから処理継続

※：address_destinationの-k cnrlssyncにNを指定した場合は、テスト対象システムとのコネクションを解放しません。

10.1.4　UDPスルー

表10‒4　システムテスト支援で発生する障害要因とその後処理、および回復方法 （ UDPスルー ）

障害要因

並行実行

リプレイ実行

PCAP実行

後処理

回復方法

後処理

回復方法

後処理

回復方法

通信障害（送信エラー）

（システム検証支援基盤システムとテスト対象システム間の障害）

データ破棄

送信しない。次データから処理継続

データ破棄

送信しない。次データから処理継続

データ破棄

送信しない。次データから処理継続

10.1.5　HTTP

表10‒5　システムテスト支援で発生する障害要因とその後処理、および回復方法 （ HTTP ）

障害要因

並行実行

リプレイ実行

PCAP実行

後処理

回復方法

後処理

回復方法

後処理

回復方法

外部システムと既存システム間のコネクション障害

RSTパケット受信

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

FINパケット受信

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

中途半端な受信済パケットデータを破棄し、テスト対象システムとの間のコネクション解放

次データから処理継続

システム検証支援基盤システムとテスト対象システム間のコネクション障害

システム検証支援基盤システムがクライアント

FIN/RST受信

なし

なし

なし

なし

なし

なし

パケット送信時のコネクション確立失敗

処理続行可の場合

データ破棄

送信しない。次データから処理継続。（ただし、15秒間は破棄）

処理続行可の場合

データ破棄

送信しない。次データから処理継続。（ただし、15秒間は破棄）

処理続行可の場合

データ破棄

送信しない。次データから処理継続。（ただし、15秒間は破棄）

通信障害（送信エラー）

（システム検証支援基盤システムとテスト対象システム間の障害）

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ可の場合

（EAGAIN等）

再送

なし

リトライ不可の場合

（相手サーバダウン等）

データ破棄

送信しない。次データから処理継続

リトライ不可の場合

（相手サーバダウン等）

データ破棄

送信しない。次データから処理継続

リトライ不可の場合

（相手サーバダウン等）

データ破棄

送信しない。次データから処理継続

パケットロスト

中途半端な受信済パケットデータの破棄

次データから処理継続

中途半端な受信済パケットデータの破棄

次データから処理継続

中途半端な受信済パケットデータの破棄

次データから処理継続

11　システムテスト支援のメッセージ

システムテスト支援のメッセージについて説明します。

11.1　メッセージの形式

11.1.1　メッセージの出力形式

メッセージIDとメッセージテキストの他に、付加情報を出力します。

出力するメッセージログの形式を以下に示します。

 AA△BB△CC△DD△yyyy/mm/dd△hh:mm:ss.zzzzzz△EE△KFSEN₁N₂N₃N₄N₅-X△YY....YY

付加情報

AA

プロセスID（半角数字10バイト）

BB

プロセス内メッセージ通番（半角数字7バイト）

CC

IFA番号（半角数字5バイト）

DD

中央処理通番（半角数字8バイト）

yyyy/mm/dd

年月日（半角数字記号10バイト）

hh:mm:ss.zzzzzz

時分秒マイクロ秒（半角数字記号15バイト）

EE

テスト識別子（識別子1〜31バイト）

メッセージ固定部

KFSEN₁N₂N₃N₄N₅-X

メッセージID（半角英数字記号11バイト）

YY....YY

メッセージテキスト

その他

△

スペース（半角1バイト）

syslog遅延出力では、メッセージログの末尾を切捨て、半角英字記号4バイト文字列”(EL)”を付加したメッセージログをsyslogに出力することがあります。メッセージログの切捨ては、syslog失敗リストのエレメントのメッセージ領域を超えるメッセージログを保管した場合に発生します。

11.1.2　メッセージの記述形式

メッセージログの記述形式を示します。

KFSEN₁N₂N₃N₄N₅-X (Y) (L)

メッセージテキスト

メッセージの説明、要因コードなど個別出力項目の説明。

（S）

システムがメッセージを出力したあとにする主な処理を示します。

（O）

メッセージ確認時、オペレータが行う必要のある処置を示します。

（P）

メッセージ確認時、プログラマが行う必要のある処置を示します。

［対策］

メッセージ確認時、システム管理者の処置を示します。

※：メッセージ中の、オペレータの処置、または対策で「保守員に連絡してください。」とは、購入時の契約に基づいて、システム管理者が弊社問い合わせ窓口へ連絡することを示します。

以下、各項目についての記述の説明を示します。

KFSE

メッセージプリフィックス

N₁N₂N₃N₄N₅

コード

X

インジケータ

インジケータはsyslogへのメッセージログ出力のレベルとしても使用します。

インジケータの表記種別を以下に示します。

表11‒1　メッセージインジケータ

表記

内容

E

システム検証支援基盤の稼働に支障のあるメッセージ。

システム検証支援基盤の環境設定誤り。

システム検証支援基盤の障害発生。

コマンドオペランドの指定誤り。

W

システム検証支援基盤は継続稼働するが注意が必要なメッセージ。

システム検証支援基盤の環境設定誤りのうちシステム検証支援基盤が継続稼働可能なケースの警告。

メモリの使用状況などの警告。

コマンドオペランドの指定誤りに関する警告。

I

システム検証支援基盤の稼働状況変化（正常動作）を示すメッセージ。

起動／終了。

コマンド投入。

Q

ユーザ入力応答待ちを示すメッセージ。

Y

メッセージログの出力先

複数の出力先に出力する場合は、出力する可能性のある出力先を複数記載します。

出力先の表記種別を以下に示します。

表11‒2　メッセージ出力先

表記

出力先

E

標準エラー出力

S

標準出力

P

メッセージログファイル

L

syslog

L

メッセージの出力優先順位

メッセージログの出力優先順位を以下に示します。

表11‒3　メッセージ優先順位

レベル※

指針

１

情報（I）：SICの起動および終了など。

異常（E）：プロセスダウンなど致命的なエラーなど。

応答（Q）：コンソール出力のため、常に表示。

２

異常（E）：業務レベルでのエラーなど。

３

異常（E）：基本レイヤ（部品）でのエラーなど。

４

警告（W）：処理継続に支障はないが、通知が必要なもの。

５

情報（I）：スレッド起動、コネクション確立など。

６

情報（I）：５よりも優先順位が低いもの。

注※

レベルの数値は「1」がもっとも優先順位が高く、数値が大きくなるほど優先順位は低くなります。

11.1.3　メッセージに出力される処理種別

表11‒4　処理種別一覧

処理種別

処理名称

MI

初期化処理

CM

コマンド処理

MN

プロトコル電文処理

ME

終了処理

SE

プロセス終了監視処理

SI

プロセス開始監視処理

TT

インタバルタイマ処理

ST

システム統計情報取得タイマ処理

TS

任意処理タイマ処理

11.2　KFSE40001からKFSE49999までのメッセージ

KFSE40107-E　（Y）E（L）3

yyyy/mm/dd hh:mm:ss (aa....aa) (bb....bb) KFSE40107-E "cc....cc" failed. errno=ddd

ee....ee

システムコールがエラーリターンしました。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

aa....aa：プロセスID（10進形式）

bb....bb：スレッドID（10進形式）

cc....cc：システムコール名（31桁以内の半角英数字）

ddd：エラーコード（3桁以内の10進形式）

エラーコードの出力内容とシステムコールの対応を以下に示します。

出力内容

システムコール名

0（※1）

catclose

catopen

getenv

openlog_r

time_base_to_time

localtime_r

dlopen

dlsym

システムコール

リターン値

pthread_attr_destroy

pthread_attr_init

pthread_attr_setscope

pthread_attr_setstackaddr

pthread_attr_setstacksize

pthread_cancel

pthread_cond_destroy

pthread_cond_init

pthread_cond_signal

pthread_cond_timedwait

pthread_cond_wait

pthread_create

pthread_join

pthread_key_create

pthread_key_delete

pthread_kill

pthread_mutex_destroy

pthread_mutex_init

pthread_mutex_lock

pthread_mutex_trylock

pthread_mutex_unlock

pthread_setcancelstate

pthread_setcanceltype

pthread_setspecific

pthread_sigmask

sigwait

dlclose

—

EINVAL値

raise

—

h_errno値

gethostbyaddr_r

gethostbyname_r

errno値

上記以外

—

ee....ee（※2）：ダイナミックローディングモジュールのシステムコールがエラーリターンした場合のエラー内容。

※1：エラー内容を示す情報が返ってこないため、0を出力します。

※2：ダイナミックローディングモジュール以外のシステムコールでは出力されません。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

次行以降に出力されるメッセージを参照し、対策の必要があれば対策をしてください。

KFSE40300-E　（Y）E+P+L（L）3

処理中に電文の破壊を検出しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

Message corruption was detected while processing. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

処理中に電文の破壊を検出しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

電文を破棄し、処理を続行します。

（O）

なし。

［対策］

なし。

KFSE40301-E　（Y）E+P+L（L）3

ＲＡＰコネクションの切断を検出しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，詳細コード１＝ee....ee，詳細コード２＝ff....ff

An interruption of the RAP connection was detected. local IP address = aa....aa, local port number = bb....bb, remote IP address = cc....cc, remote port number = dd....dd, detail code 1 = ee....ee, detail code 2 = ff....ff

RAPコネクションの切断を検出しました。

aa....aa：自IPアドレス

システム検証支援基盤側のIPアドレスを示します。

bb....bb：自ポート番号

システム検証支援基盤側のポート番号を示します。

cc....cc：相手IPアドレス

テスト対象システム側のIPアドレスを示します。

dd....dd：相手ポート番号

テスト対象システム側のポート番号を示します。

ee....ee：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

ff....ff：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

テスト対象システム側の状態を確認してください。

KFSE40310-E　（Y）E+P+L（L）3

電文の組立処理に失敗しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd，詳細コード４＝ee....ee

Failed to compose the message. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd, detail code 4 = ee....ee

電文の組立処理に失敗しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MEMORY_SHORT

システムリソース（メモリ）不足により、領域の確保に失敗しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

PROTO

ARGUMENT

TIMER_FATAL

予期せぬエラーが発生しました。

保守員に連絡してください。

KFSE40351-E　（Y）E+P+L（L）3

電文の送信処理に失敗しました。電文キー＝aa....aa，電文種別＝bb....bb，理由コード＝cc....cc，詳細コード１＝dd....dd，詳細コード２＝ee....ee，詳細コード３＝ff....ff，詳細コード４＝gg....gg

Failed to send a message. message key = aa....aa, message type = bb....bb, reason code = cc....cc, detail code 1 = dd....dd, detail code 2 = ee....ee, detail code 3 = ff....ff, detail code 4 = gg....gg

テスト対象システムへの電文送信に失敗しました。

aa....aa：電文キー

送信に失敗した電文の電文キーを示します。

bb....bb：電文種別

送信に失敗した電文の種別情報を示します。

電文種別

意味

RPC_CALL

RPCのサービス要求電文です。

RAP_CON

RAPのコネクション確立要求電文です。

RAP_DISCON

RAPのコネクション解放要求電文です。

RAP_RPC

RAPのRPC代理実行要求電文です。

NONE

上記のいずれにも分類されない種別の電文です。

cc....cc：理由コード

送信に失敗した理由を示します。

理由コード

意味

CONNECTION_NOTHING

送信用のコネクションがありませんでした。

このコードが出力される場合は以下の要因が考えられます。

電文種別がRPC_CALLの場合

RPC送信先のプロセス、もしくはシステムがダウンした。

RPC送信用に作成したコネクションが、障害等で切断されてしまった。

電文種別がRAP_RPCの場合

本番環境で常設コネクションを確立した後に、システム検証支援基盤を起動、または並行実行形態を追加した場合、RAPのコネクション確立要求電文をキャプチャしていないため、テスト対象システムとの間にRAPの常設コネクションが作成できていない。

RAPのコネクション確立要求電文を構成するパケットをシステム検証支援基盤が取り漏らしてしまい、テスト対象システムとの間にRAPの常設コネクションが作成できていない。

RAPのコネクション確立要求電文の送信に失敗したため、テスト対象システムとの間にRAPの常設コネクションが作成できていない。

テスト対象システムとの間にRAPの常設コネクション作成後、一定時間（外部システム、既存システムのrpc_rap_inquire_timeオペランド（TP1/SB、TP1/EEの場合）や、dccltinquiretimeオペランド（TP1/Clientの場合）の指定値）、RPC代理実行要求電文が送信されなかったため、RAPサーバが常設コネクションを切断した。

CONNECTION_CLOSING

送信用のコネクションが解放中です。

PROTO

電文の形式不正を検出しました。

MEMORY_SHORT

領域不足が発生しました。

ARGUMENT

送信処理で内部矛盾が検出されました。

CONDITION

送信処理で内部矛盾が検出されました。

NET_DOWN

ネットワーク障害が発生しました。

TIMED_OUT

電文送信がタイムアウトしました。

WAIT_TIMED_OUT

送信待ち中にタイムアウトが発生しました。

SEND_CANCEL

送信がキャンセルされました。

CONNECT_FAILED

テスト対象システムへのコネクションが確立できませんでした。

LISTEN_FAILED

電文受信用のソケットが作成できませんでした。

SEND_FATAL

予期せぬエラーを検出したため送信を中止しました。

dd....dd：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

ff....ff：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コードが「CONNECT_FAILED」または「LISTEN_FAILED」の場合で、直前にメッセージ「KFSE43301-W 詳細コード＝-40024」が出力されている場合、RPC・RAPプロトコルで同時に使用するファイルディスクリプタの数が足りません。

以下の対策でオープンファイル数を増やすことでこの問題が解決できることがあります。

詳しくはrpc_socket -m max_socketの注意事項を参照してください。

理由コードが「CONNECTION_NOTHING」の場合は、メッセージが出力された原因を調査してください。「CONNECTION_NOTHING」と一緒に、電文種別に「RAP_RPC」が出力されている場合は、RPC代理実行を行える状態になかった可能性があります。RAPのコネクション確立要求電文が、テスト対象システムへ送信されていたかどうかを確認してください。

送信されていなかった場合は、RAPのコネクション確立要求電文がシステム検証支援基盤に入力されていなかった可能性があります。システム検証支援基盤の起動タイミングを調整する等して、既存システムと外部システムの間のRAPのコネクション確立要求電文が取得できるようにしてください。

送信されていた場合は、コネクション確立要求から、代理実行要求を送信するまでの時間が長すぎた可能性があります。テスト対象システムに送信する電文を絞り込んだり、テスト対象システムの定義で代理実行要求が到着するまでの待ち時間を調整してください。

その他の場合は、テスト対象システムの状態や、ネットワークの状態、定義に記述したIPアドレス、ポート番号を見直してください。

KFSE40390-E　（Y）E+P+L（L）3

領域不足が発生しました。確保要求サイズ＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc

The area is insufficient. allocation request size = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc

システム検証支援基盤が動作する上で必要なメモリが確保できませんでした。

aa....aa：確保要求サイズ

領域確保失敗時に要求していたメモリサイズを示します（単位：byte）。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE40391-E　（Y）E+P+L（L）3

ＵＯＣで設定した値が不正です。種別＝aa....aa，リターンコード＝bb....bb，電文キー＝cc....cc，理由コード＝dd....dd，詳細コード＝ee....ee

The value specified with UOC is invalid. type = aa....aa, return code = bb....bb, message key = cc....cc, reason code = dd....dd, detail code = ee....ee

UOCでユーザが設定した値に誤りがありました。

aa....aa：種別

誤りを検出したUOCの種別を示します。

種別

意味

STR

蓄積編集UOCで値の誤りを検出しました。

SND

送信編集UOCで値の誤りを検出しました。

bb....bb：リターンコード

UOCが返したリターン値を示します。

cc....cc：電文キー

誤りを検出したときにUOCで処理していた電文の電文キーを示します。

dd....dd：理由コード

どの値で誤りが検出されたかを示します。

理由コード

意味

IN_LEN_BIG

UOCのリターンコードが1（ESRPC_UOC_OK_IN）（編集前のユーザデータを使用する）でリターンしたので、in_len（要求電文長）の値をユーザデータ編集前の値より大きくすることができません。

IN_LEN

in_len（要求電文長）に1より小さい値か、8Mより大きい値が設定されました。

OUT_LEN

out_len（応答電文長）に1より小さい値か、8Mより大きい値が設定されました。

GROUP

group（サービスグループ名称）に値が設定されていません。

SERVICE

service（サービス名称）に値が設定されていません。

USR_DATA_LEN

usr_data_len（ユーザデータ長）に1より小さい値か、8Mより大きい値が設定されました。

USR_DATA_LEN_BIG

UOCのリターンコードが1（ESRPC_UOC_OK_IN）（編集前のユーザデータを使用する）でリターンしたので、usr_data_len（ユーザデータ長）の値をユーザデータ編集前の値より大きくすることができません。

ee....ee：詳細コード

メッセージ出力後の動作を示します。

詳細コード

意味

DESTROY

UOCで編集していた電文を破棄し、以降の処理を行いません。

ACCUMULATE

UOCのリターンコードにより処理が異なります。

リターンコードが0（ESRPC_UOC_OK）の場合

UOCで編集していた電文を破棄し、ファイルに蓄積しません。

リターンコードが1（ESRPC_UOC_OK_IN）の場合

UOCで編集していた電文を、編集前の情報でファイルに蓄積します。

（S）

処理を続行します。

（O）

種別、リターンコード、理由コードの情報を元に、UOCの処理を見直してください。

［対策］

UOCの処理を見直してください。

KFSE40803-W　（Y）E（L）4

ＵＯＣ共用ライブラリ名が２重に定義されています。ＵＯＣ共用ライブラリ名＝aa....aa

A UOC common library name is defined twice. UOC common library name = aa....aa

UOC関連定義moduleオペランドにUOC共用ライブラリ名aa....aaが重複して設定されています。

aa....aa：UOC共用ライブラリ名

（S）

重複したUOC共用ライブラリ名を無視して処理を継続します。

（O）

システム管理者に連絡してください。

［対策］

UOC関連定義moduleオペランドを見直してシステム検証支援基盤を再起動してください。

KFSE40910-W　（Y）E+P+L（L）4

不正ファイルが検出されました。ファイル種別＝aaa，理由コード＝bb....bb，ファイル名＝cc....cc，詳細コード＝dd....dd

An invalid file was detected. file type = aaa, reason code = bb....bb, file name = cc....cc, detail code = dd....dd

リプレイ実行中に不正なファイルである可能性があるファイルが検出されました。

aaa：ファイル種別

不正なファイルである可能性が検出された蓄積ファイルの種別（REQ/RPY）を示します。

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

bb....bb：理由コード

不正なファイルである可能性があると判断した理由を示します。

理由コード

意味

FILE_SIZE

ファイルサイズがファイルヘッダサイズ以下です。

EYECATCH

アイキャッチャ不正があります。

蓄積ファイルではない可能性があります。

FILE_KIND

ファイル名とファイルヘッダ中のファイル種別が一致しません。

SAME_FILE

同じ内容の蓄積ファイルが存在します。

OVERLAP

電文受信時刻が重なっている蓄積ファイルがあります。

cc....cc：ファイル名

蓄積ファイル名を表示します。蓄積ファイルが蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションのdirpathで指定されたディレクトリの1階層下のディレクトリ下のファイルのときは、その1階層下のディレクトリ名を付加して表示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

理由コードがOVERLAPのときは、処理を続行します。理由コードがOVERLAP以外のときは、当該ファイルをリプレイ実行対象から除外して処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

蓄積ファイル関連定義accumulate_reply_fileの-fオプションの指定値に問題がないか確認してください。

蓄積ファイルを取得したときのシステム検証支援基盤プロセスで障害が発生していなかったか確認してください。

蓄積ファイル名を変更していないか確認してください。

KFSE40911-W　（Y）E+P+L（L）4

蓄積ファイルの最大面数に達しました。ファイル種別＝aa....aa，最大面数＝bb....bb，ファイル名＝cc....cc

The number of accumulation files reached the maximum. file type = aa....aa, maximum number = bb....bb, file name = cc....cc

蓄積ファイルの最大面数に達しました。

aa....aa：蓄積ファイル種別

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：当該蓄積ファイル種別の最大面数（蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfilenoで指定）

cc....cc：蓄積ファイル名

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

当該蓄積ファイルを最大サイズ（蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfileszで指定）まで使用した場合は、1面目の蓄積ファイルから再使用するため、必要に応じて再使用対象の使用済みファイルをバックアップしてください。

KFSE40960-E　(Y) E+P+L (L)3

稼働情報蓄積機能で障害が発生しました。保守情報１＝aa…aa，保守情報２＝bb…bb

An error occurred in the operation information file output function. maintenance information 1 = aa…aa, maintenance information 2 = bb…bb

稼働情報蓄積機能で障害が発生しました。

aa…aa：保守情報１

システム検証支援基盤がトラブルシュートで使用する情報です。

bb…bb：保守情報２

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE43301-W　（Y）E+P+L（L）4

コネクション処理に失敗しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，理由コード＝eeee，詳細コード＝ff....ff，保守情報１＝gg....gg，保守情報２＝hh....hh，保守情報３＝ii…ii

An attempt to connection processing has failed. my IP address = aa....aa, my port number = bb....bb, target IP address = cc....cc, target port number = dd....dd, reason code = eeee, detail code = ff....ff, maintenance information 1 = gg....gg, maintenance information 2 = hh....hh, maintenance information 3 = ii…ii

コネクション確立処理に失敗しました。

aa....aa：自IPアドレス

0.0.0.0と表示されることがあります。

bb....bb：自ポート番号

0と表示されることがあります。

cc....cc：相手IPアドレス

0.0.0.0と表示されることがあります。

dd....dd：相手ポート番号

0と表示されることがあります。

eeee：理由コード

理由コードの意味と対策を［対策］に示します。

ff....ff：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

hh....hh：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

ii…ii：保守情報3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

ソケットの生成に失敗しました。

OSのファイルディスクリプタ数を見直してください。設定値に問題がない場合は、保守員に連絡してください。

0002

自IPアドレス自ポート番号のソケットへの割り当てに失敗しました。

自IPアドレスに「0.0.0.0」以外が表示されている場合は、表示されたアドレスが有効なアドレスであるか確認してください。

自ポート番号に「0」が表示されている場合は、割り当て可能なポート番号が不足していないか確認してください。

0004

コネクションに失敗しました。

相手IPアドレスと相手ポート番号を見直してください。

自ポート番号に「0」が表示されている場合は、割り当て可能なポート番号が不足していないか確認してください。

0005

0040

登録できるファイルディスクリプタの総数の上限を超えています。

カーネルパラメタ「fs.epoll.max_user_watches」を見直してください。設定値に問題がない場合は、保守員に連絡してください。

0042

コネクションに失敗しました。

相手IPアドレスと相手ポート番号を見直してください。

0050

コネクション情報テーブルの取得に失敗しました。

メモリ使用状況を確認してください。

0060

コネクション確立直後に相手プロセスからコネクションが切断された。

相手IPアドレスと相手ポート番号を見直してください。

0110

SSLコネクション確立時のハンドシェイクに失敗しました。

以下を確認してください。問題がない場合は、保守員に連絡してください。

テスト対象システムがHTTPSに対応しているか

テスト対象システムが、address_destination定義で指定した暗号プロトコルに対応しているか

テスト対象システムが、クライアント認証未使用時にエラーとなる設定になってないか

0111

0112

0113

0114

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE43302-W　（Y）E+P+L（L）4

受信スレッドの終了処理中に障害が発生しました。理由コード＝aaaa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred during termination processing of a received thread. reason code = aaaa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

終了処理中に障害が発生しました。

aaaa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE43303-W　（Y）E+P+L（L）4

送信処理で障害が発生しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，理由コード＝eeee，詳細コード＝ff....ff，保守情報１＝gg....gg，保守情報２＝hh....hh，保守情報３＝ii…ii

An error occurred during transmission processing. my IP address = aa....aa, my port number = bb....bb, target IP address = cc....cc, target port number = dd....dd, reason code = eeee, detail code = ff....ff, maintenance information 1 = gg....gg, maintenance information 2 = hh....hh, maintenance information 3 = ii…ii

データの送信処理で障害が発生しました。

aa....aa：自IPアドレス

bb....bb：自ポート番号

cc....cc：相手IPアドレス

dd....dd：相手ポート番号

eeee：理由コード

理由コードの意味と対策を［対策］に示します。

ff....ff：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

hh....hh：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

ii…ii：保守情報3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

送信処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0011

TCP/IPバッファ不足が発生しました。

ソケット送信バッファの設定値を見直してください

0012

0021

送信処理に失敗しました。

相手システムの状態を確認してください。

0120

SSLによる送信時にエラーが発生しました。

相手システムの状態を確認してください。問題がない場合は、保守員に連絡してください。

0122

0123

0121

SSLによる送信時にタイムアウトが発生しました。

以下を実施してください。問題がない場合は、保守員に連絡してください。

ソケット送信バッファの設定値を見直してください

相手システムの状態を確認してください

KFSE43304-E　（Y）E+P+L（L）3

受信系スレッド用タイマ機能で障害が発生しました。理由コード＝aaaa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred in the reception system thread timer function. reason code = aaaa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

受信系スレッド用タイマ機能で障害が発生しました。

aaaa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE43305-W　（Y）E+P+L（L）4

キャプチャスレッドの終了処理中に障害が発生しました。理由コード＝aaaa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred during termination processing of a capture thread. reason code = aaaa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

終了処理中に障害が発生しました。

aaaa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE43310-W　（Y）E+P+L（L）4

相手システムがコネクションを切断しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，詳細コード＝ee....ee，保守情報１＝ff....ff，保守情報２＝gg....gg

The remote system disconnected. my IP address = aa....aa, my port number = bb....bb, target IP address = cc....cc, target port number = dd....dd, detail code = ee....ee, maintenance information 1 = ff....ff, maintenance information 2 = gg....gg

データの送信処理で障害が発生しました。

aa....aa：自IPアドレス

0.0.0.0と表示されることがあります。

bb....bb：自ポート番号

cc....cc：相手IPアドレス

0.0.0.0と表示されることがあります。

dd....dd：相手ポート番号

0と表示されることがあります。

ee....ee：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

ff....ff：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

相手IPアドレスと相手ポート番号が0の場合は、テスト対象システムからのコネクション確立要求の受付がファイルディスクリプタ不足で失敗しましたので、OSのファイルディスクリプタ数を見直してください。

KFSE43320-E　（Y）E+P+L（L）3

電文の組立処理に失敗しました。ＩＰアドレス＝aa....aa，ポート番号＝bb....bb，理由コード＝cc....cc，保守情報１＝dd....dd，保守情報２＝ee....ee，保守情報３＝ff....ff，保守情報４＝gg....gg

Failed to compose the message. IP address = aa....aa, port number = bb....bb, reason code = cc....cc, maintenance information 1 = dd....dd, maintenance information 2 = ee....ee, maintenance information 3 = ff....ff, maintenance information 4 = gg....gg

HTTP電文の組立て処理に失敗しました。

aa....aa：送信元IPアドレス

bb....bb：送信元ポート番号

cc....cc：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

ff....ff：保守情報3

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE43321-W　（Y）E+P+L（L）3

識別子の数が上限を超過しました。

The number of identifiers exceeded the upper limit.

マッピング情報の識別子数が、http_definition定義の-m maxcntフラグメンバで指定した上限数を超過した為、古い識別子を破棄しました。

本メッセージはシステム検証支援基盤起動後、初回の上限超過時のみ出力します。

（S）

処理を続行します。

（O）

なし。

［対策］

http_definition定義の-m maxcntフラグメンバ値を増やしてください。

KFSE44001-E　（Y）E+P+L（L）4

プラグインで設定した値が不正です。種別＝aa....aa，呼出し契機＝bb....bb，理由コード＝cc....cc，詳細コード＝dd....dd，保守情報＝ee....ee

The value specified with plugin is invalid. type = aa....aa, call timing = bb....bb, reason code = cc....cc, detail code = dd....dd, maintenance information ee....ee

プラグインで設定した値に誤りがありました。

aa....aa：種別

誤りを検出したプラグインの種別を示します。

種別

意味

PLG_STEN

開始終了プラグイン

PLG_BUILD

電文組立プラグイン

PLG_INFO

電文情報プラグイン

PLG_EDIT

電文編集プラグイン

PLG_SEND

電文送信プラグイン

PLG_RECV

電文受信プラグイン

PLG_JUDGE

結果判定プラグイン

PLG_SELECT

電文選択プラグイン

bb....bb：呼出し契機

誤りを検出したプラグインの呼出し契機を示します。

呼出し契機

意味

ESFRW_TIMING_ST

プロセス開始時

ESFRW_TIMING_EN

プロセス終了時

ESFRW_TIMING_PKTCAP

パケットまたは電文のキャプチャ時

ESFRW_TIMING_PKTRCV

パケットまたは電文の受信時

ESFRW_TIMING_PKTSND

電文の送信時

ESFRW_TIMING_FILWRT

ファイルへの書き込み時

ESFRW_TIMING_FILRED

ファイルからの読み込み時

ESFRW_TIMING_JUDG

結果判定時

ESFRW_TIMING_SCENARIO

シナリオ実行数選択時

ESFRW_TIMING_TEL

電文選択時

cc....cc：理由コード

どの値で誤りが検出されたかを示します。

理由コード

意味

RTN_CD

プラグインの戻り値が不正（ESFRW_NG含む）

SEL_MODE

実行モード（sel_mode）の設定値が不正

COMP_SZ

実際の電文サイズより大きいな値を、完成電文サイズ（comp_szメンバ）として設定した

EDIT_SZ

編集領域サイズより大きな値を、編集後電文サイズ（head_szメンバ＋data_szメンバ）として指定した

MSG_OVER

既に電文サイズの上限に達しているが、プラグインが電文未完成（ESFRW_OK_NEXT）でリターンした

MSGFORM

電文形態（msgform）の設定値が不正

PAIR_USE

ペアリング要否（pair_use）の設定値が不正

TELINF

要求電文アドレス（telinf）の設定値がNULL、又は、該当する要求電文が存在しない

INTERVAL_TIME

送信間隔（interval_time）の設定値が不正

SCENARIO_CNT

シナリオ実行数（scenario_cnt）の設定値が不正

dd....dd：詳細コード

プラグインが設定した値です。

ee....ee：保守情報

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

種別、呼出し契機、理由コードの情報を元に、プラグインの処理を見直してください。

［対策］

プラグインの処理を見直してください。

KFSE44002-W　(Y)E+P+L (L)4

識別子の数が上限を超過しました。

The number of identifiers exceeded the upper limit.

マッピング情報の識別子数が、framework_definition定義の-m maxcntフラグメンバで指定した上限数を超過したため、古い識別子を破棄しました。

本メッセージは、システム検証支援基盤起動後、初回の上限超過時のみ出力します。

（S）

処理を続行します。

（O）

なし。

［対策］

framework_definition定義の-m maxcntフラグメンバ値を増やしてください。

KFSE44401-E　（Y）E+P+L（L）3

内部関数で障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd

An internal function error occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd

システム検証支援基盤プロセス内の内部関数で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE44402-E　（Y）E+P+L（L）3

システムコールで障害が発生しました。システムコール名＝aa....aa，詳細コード＝bbbbb

A system call error occurred. system call name = aa....aa, detail code = bbbbb

システムコールがエラーリターンしました。

aa....aa：システムコール名

bbbbb：詳細コード

出力内容とシステムコールの対応を以下に示します。

詳細コード

システムコール名

errno値

epoll_create1

epoll_ctl

epoll_pwait

gettimeofday

time

—

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

システムコール名が「epoll_ctl」、詳細コードが「00028」の場合、epollに登録できるファイルディスクリプタの総数の上限を超えています。epollに登録できるファイルディスクリプタの総数の上限は、カーネルパラメタ「fs.epoll.max_user_watches」により制限されており、fs.epoll.max_user_watchesを増やしてください。なお、パケットキャプチャを行うネットワークインタフェース1つ毎に、1つのファイルディスクリプタを登録します。

その他の場合は、保守員に連絡してください。

KFSE44403-E　（Y）E+P+L（L）3

システムコールで障害が発生しました。ネットワークインタフェース名＝aa....aa，システムコール名＝bb....bb，詳細コード＝ccccc

A system call error occurred. network interface name = aa....aa, system call name = bb....bb, detail code = ccccc

システムコールがエラーリターンしました。

aa....aa：ネットワークインタフェース名

bb....bb：システムコール名

ccccc：詳細コード

出力内容とシステムコールの対応を以下に示します。

詳細コード

システムコール名

errno値

close

getsockopt

ioctl

munmap

recvmsg

—

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE44404-E　（Y）E+P+L（L）3

バッファの確保に失敗しました。要求サイズ＝aa....aa，要求数＝bb....bb，詳細コード１＝ccccc，詳細コード２＝dd....dd

Failed to allocate a buffer. request size = aa....aa, request quantity = bb....bb, detail code 1 = ccccc, detail code 2 = dd....dd

バッファの確保に失敗しました。

aa....aa：要求サイズ（10進表記）

不足サイズが表示されます。（単位：バイト）

bb....bb：要求数（10進表記）

要求数が表示されます。

ccccc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。バッファの確保に失敗したため、キャプチャした受信パケットを廃棄しました。

（O）

システム管理者に連絡してください。

［対策］

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE44406-E　（Y）E+P+L（L）3

領域確保に失敗しました。対象領域コード＝aa....aa，要求サイズ＝bb....bb，詳細コード１＝ccccc，詳細コード２＝dd....dd

Failed to allocate an area. target area code = aa....aa, request size = bb....bb, detail code 1 = ccccc, detail code 2 = dd....dd

領域確保に失敗しました。

aa....aa：対象領域コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：要求サイズ（10進表記）

不足サイズが表示されます。（単位：バイト）

ccccc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。領域確保に失敗したため、キャプチャした受信パケットを廃棄しました。

（O）

システム管理者に連絡してください。

［対策］

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE44407-W　（Y）E+P+L（L）4

pcap形式ファイルを読み取り対象外にします。理由コード＝aa....aa，ディレクトリ／ファイル名＝bb....bb，詳細コード１＝cc....cc，詳細コード２＝dd....dd，保守情報＝ee....ee

Excludes a pcap file from reading target. reason code = aa....aa, directory/file name = bb....bb, detail code 1 = cc....cc, detail code 2 = dd....dd, maintenance information = ee....ee

pcap形式ファイルを読み取り対象外にします。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ディレクトリ／ファイル名

読み取り対象外となるファイル名

cc....cc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

1102

システム検証支援基盤稼働中にpcap形式ファイルが削除された為、ファイルのアクセスに失敗しました。

pcap形式ファイルを不当に削除していないか確認してください。

2001

ファイルヘッダ長が不正です。

バージョン2.4のpcap形式ファイルを使用してください。

2002

ファイルヘッダが不正です。

2003

ファイルバージョンが対象外です。

2101

pcap形式ファイルが壊れています。

正しいpcap形式ファイルを指定してください。

2102

2103

pcap形式ファイル内のパケットキャプチャ時刻がテスト対象範囲外です。

マシン時刻が不当な環境下でpcap形式ファイルを作成していた場合は、マシン時刻を正しく設定してpcap形式ファイルを作成しなおしてください。

3001

ディスクリプタ不足が発生しました。

OSのファイルディスクリプタ数を見直してください。設定値に問題がない場合は、保守員に連絡してください。

3002

OSのメモリ不足が発生しました。

メモリ使用状況を確認してください。

3003

ファイルの読込みに失敗しました。

ファイルシステムに異常がないかを確認してください。

上記以外

予期しないエラーが発生しました。

保守員に連絡してください。

KFSE45008-E　（Y）E+P+L（L）3

内部矛盾が発生しました。詳細コード＝aa....aa

An internal contradiction occurred. detail code = aa....aa

システム検証支援基盤で予期しない障害が発生しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

直後に出力するメッセージを参照してください。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE45300-E　（Y）E+P+L（L）3

内部関数で障害が発生しました。理由コード＝aaaa，サイズ＝bb....bb，詳細コード１＝cccccccc，詳細コード２＝dddddddd，詳細コード３＝eeeeeeee

An error has occurred in an internal function. reason code = aaaa, size = bb....bb, detail code 1 = cccccccc, detail code 2 = dddddddd, detail code 3 = eeeeeeee

システム検証支援基盤プロセス内の内部関数で障害が発生しました。

aaaa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：サイズ（10進表記）

領域不足時に不足サイズが表示されます。（単位：バイト）

領域不足以外の障害、又は不足サイズが特定できない場合は、「-1」が表示されます。

cccccccc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dddddddd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

eeeeeeee：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

システムリソース（メモリ）不足

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

0002

システムリソース（メモリ以外）不足

不要なプログラムを終了してください。

0012

システムリソース（メモリ）不足

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

9999

上記以外の障害

保守員に連絡してください。

KFSE45310-E　（Y）E+P+L（L）3

時刻の同期に失敗しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An attempt to synchronize the time has failed. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

システム検証支援基盤プロセス内の時刻とマシン時刻の同期に失敗しました。システム検証支援基盤プロセスが出力するメッセージ等に含まれる時刻と、マシン時刻に誤差が生じる可能性があります。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

メッセージが多発する場合は、保守員に連絡してください。

KFSE45311-W　（Y）E+P+L（L）4

時刻の誤差が１秒以上あります。マシン時刻＝aa....aa，システム検証支援基盤プロセス内時刻＝bb....bb

The time error is one second or more. machine time = aa....aa, time in SIC process = bb....bb

システム検証支援基盤プロセス内の時刻とマシン時刻の時刻同期の結果、1秒以上の誤差がありました。

aa....aa：マシン時刻（10進表記）

bb....bb：プロセス内時刻（10進表記）

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

メッセージが多発する場合は、保守員に連絡してください。

KFSE45402-W　（Y）E+P+L（L）4

強制出力コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb，詳細コード＝cc

The forced output command failed. command name = aa....aa, reason code = bb, detail code = cc

強制出力コマンドが失敗しました。

aa....aa：強制出力コマンド名。理由コードが99の場合、「****」を表示する場合があります。

bb：理由コード

01：スワップ処理でファイルIOエラーが発生しました。

03：TASKTM機能が障害により停止しています。

04：以下の理由により強制出力により出力する情報がありません。

・プロセス開始時、またはファイル切り替え後に、システム統計情報出力間隔が経過していない

05：トラブルシュート関連定義のstatistical_information -u useにNが指定されているため、システム統計情報機能を使用できません。

06：システム統計情報機能が障害により停止しています。

99：予期せぬエラーが発生しました。

cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

理由コードが04の場合は、statistical_information -u interval_timeに設定した時間経過後に、コマンドを再実行してください。

理由コードが05の場合は、statistical_information -u useに設定した値を見直してください。理由コードが04、05以外の場合は、システム管理者に連絡してください。

［対策］

理由コードに示す原因を取り除いてシステム検証支援基盤を再起動してください。

理由コードが99の時は保守員に連絡してください。

KFSE45404-W　（Y）E+P+L（L）4

トラブルシュートファイルに障害が発生しました。ファイル名＝aa....aa，理由コード＝bb，詳細コード＝cc....cc

Failure occurred for the troubleshooting file. file name = aa....aa, reason code = bb, detail code = cc....cc

トラブルシュートファイルに障害が発生しました。

aa....aa：ファイル名（10～40桁）

bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

当該ファイルは使用不可としシステムを続行します。

（O）

理由コードを参照して対策してください。

理由

コード

意味

対策

01

openエラー

ファイル名で表示するファイルと、以下のディレクトリのアクセス権限を確認してください。

/opt/HSIC/job/KKK/spool/dceeinf/tasktm

および

/opt/HSIC/job/KKK/spool/dceeinf/stc

KKKはテスト識別子です。

02

closeエラー

03

readエラー

04

writeエラー

ディスクの空き容量を確認してください。

05

mmapエラー

ディスクの空き容量およびOSのメモリを確認してください。

06

munmapエラー

ファイル名で表示するファイルと、以下のディレクトリのアクセス権限を確認してください。

/opt/HSIC/job/KKK/spool/dceeinf/tasktm

および

/opt/HSIC/job/KKK/spool/dceeinf/stc

KKKはテスト識別子です。

07

書き込み読み込みポイント設定エラー

08

fstat64またはfstatエラー

10

stat64またはstatエラー

11

ファイルのヘッダ情報エラー

ファイル名で表示するファイルを削除するか、ファイル名を変更してください。

ファイルのディレクトリは、以下のどちらかです。

/opt/HSIC/job/KKK/spool/dceeinf/tasktm

/opt/HSIC/job/KKK/spool/dceeinf/stc

KKKはテスト識別子です。

［対策］

なし。

KFSE45405-W　（Y）E+P+L（L）4

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb，詳細コード＝cc

The command failed. command name = aa....aa, reason code = bb, detail code = cc

コマンドが失敗しました。

aa....aa：コマンド名。

理由コードが99の場合、「****」を表示する場合があります。

bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

理由コードに従って原因を取り除きコマンドを再実行してください。

［対策］

理由コードに従って対策してください。

理由コード

意味

対策

01

トラブルシュート関連定義のstatistical_information -u useにNが指定されているため、システム統計情報機能を使用できません。

トラブルシュート関連定義のstatistical_information -u useにYを設定してシステム検証支援基盤プロセスを再起動してください。

03

内部矛盾を検知しました。

保守員に連絡してください。

99

KFSE45410-W　（Y）E+P+L（L）4

OSのシステム定数の取得に失敗しました。詳細コード＝aa....aa

Failed to retrieve an OS system constant. detail code = aa....aa

OSのシステム定数の取得に失敗しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

11.3　KFSE50001からKFSE59999までのメッセージ

KFSE50300-E　（Y）E+P+L（L）2

ＰＲＦトレース取得機能でエラーが発生しました。理由コード＝aa…aa，ＩＰアドレス＝bb…bb，ポート番号＝cc…cc，ファイル名＝dd…dd，詳細コード１＝ee…ee，詳細コード２＝ff…ff

An error occurred in the PRF trace files collecting function. reason code = aa…aa, IP address = bb…bb, port number = cc…cc, file name = dd…dd, detail code 1 = ee…ee, detail code 2 = ff…ff

PRFトレース取得機能でエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を表に示します。

bb....bb：IPアドレス

取得対象サーバのprf_definition定義の-a ipaddr設定値を表示します。表示する情報がない場合は"0.0.0.0"を表示します。

cc....cc：ポート番号

取得対象サーバのprf_definition定義の-a portno設定値を表示します。表示すべき情報がない場合は"0"を表示します。

dd....dd：PRFトレースファイル名

取得対象サーバのPRFトレースファイル名をパス名込みで表示します。表示すべき情報がない場合は"**"を表示します。

ee....ee：詳細コード１

システム効率化支援がトラブルシュートで使用する情報です。

ff…ff：詳細コード２

システム効率化支援がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

0001

FTPサーバへの接続失敗

（IPアドレス、ポート番号不正）

prf_definition定義の-a ipaddrおよび-a portnoの設定値に問題がないかどうか確認してください。また、通信相手の状態を確認してください。

0002

FTPサーバへの接続失敗

（ログイン情報不正）

prf_definition定義の-a userの設定値に問題がないかどうか確認してください。

0003

FTPサーバへの接続失敗

（接続モード不正）

prf_definition定義の-a connection_modeの設定値に問題がないかどうか確認してください。

1001

通信エラー

通信相手の状態を確認してください。

1002

リモートファイルのアクセス失敗

prf_definition定義の-a user設定値で指定したユーザに、PRFトレースファイルの読込権限があるかどうか確認してください。

9001

cURL処理失敗

保守員に連絡してください。

9002

ローカルファイルのアクセス失敗

ディスク容量の不足、ファイルディスクリプタの不足、ディレクトリへのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE50900-E　（Y）E、E+P+L（L）2

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd，詳細コード５＝ee....ee

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd, detail code 5 = ee....ee

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード5

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡して下さい。

KFSE50901-E　（Y）E、E+P+L（L）2

領域の確保に失敗しました。要求サイズ＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

An attempt to allocate area has failed. request size = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd

必要なメモリの確保に失敗しました。

aa....aa：確保に失敗した領域の要求サイズ（単位：バイト）

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE50910-E　（Y）E+P+L（L）2

蓄積ファイル出力機能で障害が発生しました。ファイル種別＝aa....aa，理由コード＝bb....bb，ファイル名＝cc....cc，詳細コード＝dd....dd

An error occurred in the accumulation file output function. file type = aa....aa, reason code = bb....bb, file name = cc....cc, detail code = dd....dd

蓄積ファイル出力機能で障害が発生しました。

aa....aa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：蓄積ファイル名

以下に示す理由コードの場合は、「****」を表示します。

「QUE ENTR」

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

理由コードがWRT DATAまたはWRT HCRTの場合は、障害スワップしスワップ先の蓄積ファイルで書込みをリトライします。理由コードが上記以外の場合は、エラーを無視して、処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コードに従って対策してください。

理由コード

意味

対策

WRT DATA

電文データの書込みに失敗しました。（writeエラー）

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

WRT HCRT

使用を開始する蓄積ファイルのヘッダ更新に失敗しました。（write/エラー）

WRT HUSE

使用済みとした蓄積ファイルのヘッダ更新に失敗しました。（write/lseekエラー）

LSEEK

CLOSE

ファイルのクローズに失敗しました。（closeエラー）

QUE ENTR

内部矛盾が発生しました。

保守員に連絡してください。

KFSE50911-E　（Y）E+P+L（L）2

リプレイ実行対象時刻範囲内に蓄積した電文を持つ蓄積ファイルが存在しません。ファイル種別＝aaa，ディレクトリ＝bb....bb，詳細コード＝cc....cc

The accumulation file that contains the messages that were accumulated within the replay execution target time range does not exist. file type = aaa, directory = bb....bb, detail code = cc....cc

リプレイ実行のテスト対象範囲内に、蓄積した電文を持つ蓄積が存在しません。

aaa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

bb....bb：ディレクトリ

リプレイ実行時指定蓄積ファイル格納ディレクトリ

またはデフォルトの蓄積ファイル格納ディレクトリを表示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

esstartコマンドの-tオプションの指定値、またはフィルタ関連定義target_timeコマンドの-tオプションの指定値に誤りがないかを確認してください。

KFSE50920-E　（Y）E+P+L（L）2

フレームワーク用ファイル出力機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ファイル名＝cc....cc，詳細コード＝dd....dd

An error occurred in the framework for the file output function. file type = aaa, reason code = bb....bb, file name = cc....cc, detail code = dd....dd

フレームワーク用ファイル出力機能で障害が発生しました。

aaa：フレームワーク用ファイル種別

TEL：電文ファイル

RES：結果ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：フレームワーク用ファイル名

以下に示す理由コードの場合は、「****」を表示します。

「MAX CNT」

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

理由コードがWRT DATAの場合は、障害スワップしスワップ先のファイルに書込みをリトライします。理由コードが上記以外の場合は、エラーを無視して、処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

WRT DATA

電文データの書込みに失敗しました。

（writeエラー）

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

CLOSE

ファイルのクローズに失敗しました。

（closeエラー）

KFSE50921-E　（Y）E+P+L（L）2

フレームワーク用ファイル読込み機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ファイル名＝cc....cc，詳細コード＝dd....dd

An framework function's file loading-error occurred. file type = aaa, reason code = bb....bb, directory/file name = cc....cc, detail code = dd....dd

フレームワーク用ファイル読込み機能で障害が発生しました。

aaa：フレームワーク用ファイル種別

TEL：電文ファイル

対象種別外の読込み要求時は、「***」を表示します。

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：フレームワーク用ファイル名

以下に示す理由コードの場合は、「****」を表示します。

「FIL CLAS」

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

エラーを無視して、処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

FIL CLAS

読込み対象ではないファイルに対し読込み要求が行われました。

保守員に連絡してください。

LIN SIZE

CSVファイル関連定義csvfile_definitionコマンド-fオプションのlineszで指定されたサイズ以上のデータを読み込みました。

CSVファイル関連定義csvfile_definitionコマンド-fオプションのlineszで指定する1行あたりの最大サイズを見直してください。

READ

ファイルの読込みに失敗しました。（readエラー）

ファイルシステムに異常がないかを確認してください。

KFSE50950-E　（Y）E+P+L（L）2

比較エラー情報ファイル出力機能で障害が発生しました。理由コード＝aa....aa，ファイル名＝bb....bb，詳細コード＝cc....cc

An error occurred in the function that outputs data to the comparison error information file. reason code = aa....aa, file name = bb....bb, detail code = cc....cc

比較エラー情報ファイル出力機能で障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ファイル名

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

別の比較エラー情報ファイルのオープンおよび書込みをリトライします。

理由コードが「MAX ERR」の場合は、当該コマンドの処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

FIL OPEN

ファイルのオープンに失敗しました。

（openエラー）

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

FIL STAT

ファイルのオープンに失敗しました。

（statエラー）

WRITE

比較エラー情報ファイルへの書込みに失敗しました。

（writeエラー）

MAX ERR

比較エラー情報ファイル定義のfilenoオペランドに指定された数のファイル全てがエラーになりました。

KFSE50960-E　(Y)E+P+L (L)2

コネクション処理に失敗しました。プロトコル種別＝aa…aa，自ＩＰアドレス＝bb…bb，自ポート番号＝cc…cc，相手ＩＰアドレス＝dd…dd，相手ポート番号＝ee…ee，理由コード＝ffff，詳細コード＝gg…gg，保守情報１＝hh…hh，保守情報２＝ii…ii

An attempt to connection processing has failed. protocol type = aa…aa, my IP address = bb…bb, my port number = cc…cc, target IP address = dd…dd, target port number = ee…ee, reason code = ffff, detail code = gg…gg, maintenance information 1 = hh…hh, maintenance information 2 = ii…ii

システム分析支援リアルタイムモニタとのコネクション確立に失敗しました。

aa…aa：プロトコル種別

RTM：システム分析支援リアルタイムモニタとのコネクション

bb…bb：自IPアドレス

0.0.0.0と表示されることがあります。

cc…cc：自ポート番号

0と表示されることがあります。

dd…dd：相手IPアドレス

0.0.0.0と表示されることがあります。

ee…ee：相手ポート番号

0と表示されることがあります。

ffff：理由コード

理由コードの意味と対策を［対策］に示します。

gg…gg：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

hh…hh：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ii…ii：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

システム分析支援リアルタイムモニタが起動しているかどうかを確認してください。起動しているときは、次のとおりに対策してください。

KFSE43301-Wメッセージの理由コード一覧に従って対策してください。

KFSE50961-E　(Y)E+P+L (L)2

送信処理で障害が発生しました。プロトコル種別＝aa…aa，自ＩＰアドレス＝bb…bb，自ポート番号＝cc…cc，相手ＩＰアドレス＝dd…dd，相手ポート番号＝ee…ee，理由コード＝ffff，詳細コード＝gg…gg，保守情報１＝hh…hh，保守情報２＝ii…ii

An error occurred during transmission processing. protocol type = aa…aa, my IP address = bb…bb, my port number = cc…cc, target IP address = dd…dd, target port number = ee…ee, reason code = ffff, detail code = gg…gg, maintenance information 1 = hh…hh, maintenance information 2 = ii…ii

システム分析支援リアルタイムモニタへのデータの送信で障害が発生しました。

aa…aa：プロトコル種別

RTM：システム分析支援リアルタイムモニタとのコネクション

bb…bb：自IPアドレス

cc…cc：自ポート番号

dd…dd：相手IPアドレス

ee…ee：相手ポート番号

ffff：理由コード

理由コードの意味と対策を［対策］に示します。

gg…gg：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

hh…hh：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ii…ii：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

システム分析支援リアルタイムモニタが起動しているかどうかを確認してください。起動しているときは、次のとおりに対策してください。

KFSE43303-Wメッセージの理由コード一覧に従って対策してください。

KFSE50965-E　(Y)E+P+L (L)2

稼働情報蓄積機能で障害が発生しました。理由コード＝aa…aa，ファイル名＝bb…bb，詳細コード＝cc…cc

An error occurred in the operation information file output function. reason code = aa...aa, file name = bb...bb, detail code = cc...cc

稼働情報蓄積機能で障害が発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：稼働情報ファイル名

以下に示す理由コードの場合は、稼働情報ファイルを格納するディレクトリ名を表示します。

「NONE DIR」

「DIR STAT」

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

応答監視機能を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

WRT DATA

電文データの書き込みに失敗しました。

（writeエラー）

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

DISK FULL

電文データの書き込みに失敗しました。

（ディスク空き容量無し）

FILE STAT

稼働情報ファイルの状態取得に失敗しました。

DIR STAT

稼働情報ファイルの出力先ディレクトリの状態取得に失敗しました。

OPEN

ファイルのオープンに失敗しました。

（openエラー）

CLOSE

ファイルのクローズに失敗しました。

（closeエラー）

LSEEK

ファイルの読込みに失敗しました。（lseekエラー）

UNLINK

稼働情報ファイルの削除に失敗しました。

（unlinkエラー）

BUF GET

バッファの追加確保に失敗しました。

直前に出力されているKFSE50901-Eメッセージの対策をしてください。

NONE DIR

RTM関連定義rtm_definitionコマンド-fオプションのdirpathまたはctldirpathで指定した稼働情報ファイルの出力先ディレクトリが存在しません。

出力先に指定したディレクトリを確認してください。存在しない場合は作成するか、存在するディレクトリを指定してください。

CTL OPEN

管理ファイルの操作に失敗しました。

本理由コードが連続して出力される場合は、保守員に連絡してください。

EXEC

PREPARE

STEP

CTL CLOSE

QUE ENTR

内部矛盾が発生しました。

保守員に連絡してください。

KFSE50966-E　(Y)E+P+L (L)2

稼働情報蓄積機能を閉塞しました。

The operation information file output function was held.

稼働情報蓄積機能を閉塞しました。

（S）

稼働情報の稼働情報蓄積ファイルへの出力を停止し、応答監視機能を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前に出力されたKFSE50965-Eメッセージに従い閉塞要因を取り除き、応答監視機能を再起動してください。

KFSE51901-E　（Y）E+L（L）2

メッセージログファイルの初期化に失敗しました。メッセージログファイル名＝aa....aa，理由コード＝bbbbbbbb，詳細コード＝cc....cc

Failed to initialize logfile. logfile name=aa....aa, reason code=bbbbbbbb, detail code=cc....cc

aa....aaで示すメッセージログファイルの初期化に失敗しました。メッセージログファイルを切り替えてメッセージ出力を継続します。

aa....aa：メッセージログファイル名

bbbbbbbb：理由コード

00000001：ファイルオープンエラー

00000002：ファイルヘッダ出力エラー

00000003：メッセージ出力開始の出力エラー

00000004：ファイル種別が取得できません

00000005：ファイルが通常ファイルでありません

00000006：ファイルに書込み権限がありません

00000007：ファイルを削除できません

00000008：実効ユーザIDを取得できません

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

なし。

［対策］

ディスク容量の不足、ディレクトリ／ファイルへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE51902-E　（Y）E+L（L）2

メッセージログファイルの切り替えに失敗しました。メッセージログファイル名＝aa....aa，理由コード＝bbbbbbbb，詳細コード＝cc....cc

Failed to change logfile. logfile name=aa....aa, reason code=bbbbbbbb, detail code=cc....cc

aa....aaで示すメッセージログファイルへの切り替えに失敗しました。次のメッセージログファイルに切り替えてメッセージ出力を継続します。

aa....aa：メッセージログファイル名

bbbbbbbb：理由コード

00000001：ファイルオープンエラー

00000002：ファイルヘッダ出力エラー

00000003：メッセージ出力開始の出力エラー

00000004：ファイル種別が取得できません

00000005：ファイルが通常ファイルでありません

00000006：ファイルに書込み権限がありません

00000007：ファイルを削除できません

00000008：実効ユーザIDを取得できません

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

なし。

［対策］

ディスク容量の不足、ディレクトリ／ファイルへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE51903-E　（Y）E+L（L）2

メッセージログファイルへのメッセージ出力を停止しました。

Stopped to output message to logfile.

全てのメッセージログファイルへの切り替えに失敗したため、メッセージログファイルへのメッセージ出力を停止しました。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

ディスク容量の不足、ディレクトリ／ファイルへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE51904-E　（Y）E+L（L）2

全てのメッセージログファイルのオープンに失敗しました。メッセージログファイルへのメッセージ出力を停止しました。理由コード＝aaaaaaaa

Failed to open all logfiles, stopped to output message to logfile. reason code=aaaaaaaa

全てのメッセージログファイルのオープンに失敗したため、メッセージログファイルへのメッセージ出力を停止しました。

aaaaaaaa：理由コード

00000001：メッセージログファイル格納ディレクトリの作成失敗

00000002：全てのファイルのオープンエラー

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

ディスク容量の不足、ディレクトリへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE51905-E　（Y）E+P（L）2

SYSLOGのオープンに失敗しました。SYSLOGへのメッセージ出力を停止しました。詳細コード＝aa....aa

Failed to open SYSLOG, stopped to output message to SYSLOG. detail code=aa....aa

syslogのオープンに失敗したため、syslogへのメッセージ出力を停止しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

なし。

［対策］

syslogに異常がないかを確認してください。

KFSE51906-E　（Y）E（L）2

Failed to initialize. reason code=aa....aa, detail code=bb....bb

ログの初期化で障害が発生しました。メッセージを出力することができません。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

理由コードがOTHERのときは、システム管理者に連絡してください。

［対策］

理由コードにより以下の対策を行ってください。

理由

コード

意味

対策

CATALOG

メッセージオブジェクトファイルがオープンできません。

所定のディレクトリに、システムの言語環境に対応したメッセージオブジェクトファイルがあるかどうか確認してください。

MEMORY

メモリが取得できません。

しばらくしてから再実行してください。繰り返し発生する場合、必要の無いプロセスを停止する、メモリを増やすなどの対策を行ってください。

OTHER

その他の障害が発生しました。

保守員に連絡してください。

KFSE51907-E　（Y）E（L）2

Failed to close. detail code1=aa....aa, detail code2=bb....bb

ログの終了処理で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE51908-E　（Y）E（L）2

Failed in the assembly of the message. detail code1=aa....aa, detail code2=bb....bb, detail information=cc....cc

メッセージの組立処理で障害が発生しました。

aa....aa：細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細情報

出力に失敗したメッセージ番号と詳細情報を、ハイフンで区切って出力します。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

システムのメモリが不足している場合には、メモリの不足を解消してください。メモリ不足でない状況で発生する場合には、保守員に連絡してください。

KFSE51909-E　（Y）E（L）2

SYSLOGへのメッセージ出力が失敗しました。理由コード＝aa....aa，詳細情報＝bb....bb : cc....cc

Failed to output message to SYSLOG. reason code=aa....aa, detail information=bb....bb : cc....cc

syslogへのメッセージ出力に失敗しました。

aa....aa：理由コード

SYSTEM：メモリ不足とバッファ不足以外のエラーがsyslogで発生しました。

OVERFLOW：syslogでメモリ不足とバッファ不足が発生したあと、syslog失敗リストに保管可能なメッセージ数を超過しました。

bb....bb：詳細情報

理由コード

詳細情報

SYSTEM

システム検証支援基盤がトラブルシュートで使用する情報です。

OVERFLOW

メッセージ出力に失敗した連続メッセージ数（10進数で1～65536の範囲）

メッセージ出力に失敗した連続メッセージ数が65536を超過した場合、65536と出力します。

cc....cc：出力に失敗したメッセージ

（S）

処理を続行します。

（O）

なし。

［対策］

syslogに異常がないかを確認してください。

システム検証支援基盤のsyslog出力レベルの定義値を上げてください。

KFSE51910-E　（Y）E+P（L）2

SYSLOG失敗リストのメッセージを破棄しました。詳細情報＝aa....aa

Discard messages in SYSLOG error list. detail information=aa....aa

syslog失敗リスト内のメッセージを破棄しました。

aa....aa：詳細情報

破棄したメッセージ数（10進数）

（S）

処理を続行します。

（O）

なし。

［対策］

syslogに異常がないかを確認してください。

システム検証支援基盤のsyslog出力レベルの定義値を上げてください。

KFSE51911-E　（Y）E（L）2

Failed to open the catalog file. catalog name=aa....aa

aa....aaで示すカタログファイルのオープン処理で障害が発生しました。

aa....aa：メッセージカタログ名称

メッセージカタログ名称を示します。

（S）

処理を続行します。

（O）

後に出力されるKFSE51906-Eに従ってください。

［対策］

KFSE51906-Eの理由コードにより対策を行ってください。

KFSE51913-I　（Y）S（L）5

拡張SYSLOG機能を使用します。

The SYSLOG delayed output function has been enabled.

拡張SYSLOG機能を使用します。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE53301-E　（Y）E+P+L（L）3

データの受信処理で障害が発生しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，理由コード＝eeee，詳細コード＝ff....ff，保守情報１＝gg....gg，保守情報２＝hh....hh

An error occurred in the receive processing of data. my IP address = aa....aa, my port number = bb....bb, target IP address = cc....cc, target port number = dd....dd, reason code = eeee, detail code = ff....ff, maintenance information 1 = gg....gg, maintenance information 2 = hh....hh

データの受信処理で障害が発生しました。

aa....aa：自IPアドレス

bb....bb：自ポート番号

cc....cc：相手IPアドレス

dd....dd：相手ポート番号

eeee：理由コード

理由コードの意味と対策を［対策］に示します。

ff....ff：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

hh....hh：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

受信データを破棄します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

受信バッファ数が不足しました。

メモリ使用状況を確認してください。

0130

SSLによる受信時にエラーが発生しました。

相手システムの状態を確認してください。問題がない場合は、保守員に連絡してください。

0133

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE53302-E　（Y）E+P+L（L）2

受信系スレッド用タイマ機能で障害が発生しました。理由コード＝aaaa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred in the reception system thread timer function. reason code = aaaa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

受信系スレッド用タイマ機能で障害が発生しました。

aaaa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE53370-E　（Y）E+P+L（L）3

領域の確保に失敗しました。詳細コード＝aa....aa，保守情報１＝bb....bb，保守情報２＝cc....cc

An attempt to allocate area has failed. detail code = aa....aa, maintenance information 1 = bb....bb, maintenance information 2 = cc....cc

通信制御コマンド処理において、作業領域の確保に失敗しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

当該コマンドの処理を中止し、次の処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE53371-E　（Y）E+P+L（L）3

通信障害が発生しました。詳細コード＝aa....aa，保守情報１＝bb....bb，保守情報２＝cc....cc

A communication error has occurred. detail code = aa....aa, maintenance information 1 = bb....bb, maintenance information 2 = cc....cc

通信制御コマンド処理において、通信障害が発生しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

当該コマンドの処理を中止し、次の処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE53372-E　（Y）E+P+L（L）3

内部矛盾が発生しました。詳細コード＝aa....aa，保守情報１＝bb....bb，保守情報２＝cc....cc

An internal conflict has occurred. detail code = aa....aa, maintenance information 1 = bb....bb, maintenance information 2 = cc....cc

通信制御コマンド処理において、システム検証支援基盤で予期しない障害が発生しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

当該コマンドの処理を中止し、次の処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE53401-E　（Y）E+P+L（L）1

ＵＯＣリターンコードにより終了が指示されました。ＵＯＣ種別＝aa....aa，リターンコード＝bb....bb

Termination was instructed by the UOC return code. UOC type = aa....aa, return code = bb....bb

UOCからのリターンコードにより終了が指示されました。

aa....aa：UOC種別

STENUOC：開始終了UOC

bb....bb：リターンコード

UOCのリターンコード。

（S）

システム検証支援基盤を終了します。

（O）

システム管理者に連絡してください。

［対策］

UOCのリターンコードを確認し、開始終了UOCのエラーの原因を取り除いてください。

KFSE53403-E　（Y）E+P+L（L）2

実行形態の変更に失敗しました。変更種別＝aa....aa，実行形態＝bb....bb，理由コード１＝cc....cc，理由コード２＝dd....dd，詳細コード＝ee....ee

Failed to change the execution format. change type = aa....aa, execution format = bb....bb, reason code1 = cc....cc, reason code2 = dd....dd, detail code = ee....ee

実行形態の変更に失敗しました。

aa....aa：変更種別

ADD：実行形態追加

DEL：実行形態削除

bb....bb：実行形態

変更に失敗した実行形態を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

cc....cc：理由コード1

理由コード1の意味と対策を［対策］に示します。

dd....dd：理由コード2

理由コード1の補足情報を出力します。

理由コード1

理由コード2

UOC_ERROR

開始終了UOCのリターンコード

上記以外

"*"が表示されます

ee....ee：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

実行形態の変更処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コードにより以下の対策を行ってください。

理由コード1

意味

対策

NOTHING

実行形態が並行実行の場合

テスト対象システムが未定義である為、並行実行の追加を中止しました。

実行形態が蓄積実行の場合

蓄積実行に対応したプロトコルの定義がないため中止しました。

実行形態が並行実行の場合

システム検証支援基盤を終了後、定義した全てのaddress_destination定義の-tオプションを定義し、再起動してください。

実行形態が蓄積実行の場合

システム検証支援基盤を終了後、蓄積実行に対応したプロトコルの定義を定義し、再起動してください。

COMMUNICATION

データの通信に失敗しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

TIMED_OUT

実行形態変更処理でタイムアウトが発生しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

EXECUTE

起動中の実行形態の追加を指定しました。

esmodaddコマンドのオプションに未起動の実行形態を指定してください。

UOC_ERROR

UOCにより実行形態の変更を中止しました。

理由コード2を参照して、開始終了UOCのリターンコードを見直してください。

INVALID

リプレイ実行またはPCAP実行時に実行形態変更を指定しました。

実行中のシステム検証支援基盤の実行を終了し、並行実行または蓄積実行でシステム検証支援基盤を再起動してください。

STATUS

実行形態の追加が出来る状態ではありません。

システム検証支援基盤プロセスのメッセージログを参照して原因を調査してください。システム検証支援基盤プロセスのメッセージログにメッセージが出力されていなければ、コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

NOT_UP

未起動の実行形態の削除を指定しました。

esmoddelコマンドのオプションに起動済の実行形態を指定してください。

LIMITS_INVALID

実行中の全実行形態を削除形態に指定したため、実行形態削除を中止しました。

全実行形態の削除はesstopコマンドで行ってください。

KFSE53700-E　（Y）E+P+L（L）2

内部関数で障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd，詳細コード５＝ee....ee

An error has occurred in an internal function. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd, detail code 5 = ee....ee

システム検証支援基盤プロセスの開始処理中にエラーが発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード5

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE53701-E　（Y）E+P+L（L）2

領域の確保に失敗しました。要求サイズ＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

An attempt to allocate area has failed. request size = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd

必要なメモリの確保に失敗しました。

aa....aa：確保に失敗した領域の要求サイズ（単位：バイト）

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE53710-E　（Y）E+P+L（L）2

コネクション処理に失敗しました。プロトコル種別＝aa....aa，自ＩＰアドレス＝bb....bb，自ポート番号＝cc....cc，相手ＩＰアドレス＝dd....dd，相手ポート番号＝ee....ee，理由コード＝ffff，詳細コード＝gg....gg，保守情報１＝hh....hh，保守情報２＝ii....ii

An attempt to connection processing has failed. protocol type = aa....aa, my IP address = bb....bb, my port number = cc....cc, target IP address = dd....dd, target port number = ee....ee, reason code = ffff, detail code = gg....gg, maintenance information 1 = hh....hh, maintenance information 2 = ii....ii

システム分析支援アキュムレータとのコネクション確立に失敗しました。

aa....aa：プロトコル種別（システム分析支援アキュムレータとのコネクション種別）

HIR：システム分析支援アキュムレータ（HiRDB電文）

COS：システム分析支援アキュムレータ（Cosminexus電文）

HTTP：システム分析支援アキュムレータ（HTTP電文）

TNS：システム分析支援アキュムレータ（TNS電文）

bb....bb：自IPアドレス

0.0.0.0と表示されることがあります。

cc....cc：自ポート番号

0と表示されることがあります。

dd....dd：相手IPアドレス

0.0.0.0と表示されることがあります。

ee....ee：相手ポート番号

0と表示されることがあります。

ffff：理由コード

プロトコル種別がTNS以外の場合

理由コードの意味と対策を［対策］に示します。

プロトコル種別がTNSの場合

0000を表示します。

gg....gg：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

hh....hh：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ii....ii：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

システム分析支援アキュムレータが起動しているか確認してください。

起動しているときは、以下のとおりに対策してください。

プロトコル種別がTNS以外の場合

KFSE43301-Wメッセージの理由コード一覧に従って対策してください。

プロトコル種別がTNSの場合

本メッセージより前に出力されているメッセージに従って対策してください。

KFSE53711-E　（Y）E+P+L（L）2

送信処理で障害が発生しました。プロトコル種別＝aa....aa，自ＩＰアドレス＝bb....bb，自ポート番号＝cc....cc，相手ＩＰアドレス＝dd....dd，相手ポート番号＝ee....ee，理由コード＝ffff，詳細コード＝gg....gg，保守情報１＝hh....hh，保守情報２＝ii....ii

An error occurred during transmission processing. protocol type = aa....aa, my IP address = bb....bb, my port number = cc....cc, target IP address = dd....dd, target port number = ee....ee, reason code = ffff, detail code = gg....gg, maintenance information 1 = hh....hh, maintenance information 2 = ii....ii

システム分析支援アキュムレータへのデータの送信で障害が発生しました。

aa....aa：プロトコル種別（システム分析支援アキュムレータとのコネクション種別）

HIR：システム分析支援アキュムレータ（HiRDB電文）

COS：システム分析支援アキュムレータ（Cosminexus電文）

HTTP：システム分析支援アキュムレータ（HTTP電文）

TNS：システム分析支援アキュムレータ（TNS電文）

bb....bb：自IPアドレス

cc....cc：自ポート番号

dd....dd：相手IPアドレス

ee....ee：相手ポート番号

ffff：理由コード

プロトコル種別がTNS以外の場合

理由コードの意味と対策を［対策］に示します。

プロトコル種別がTNSの場合

0000を表示します。

gg....gg：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

hh....hh：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ii....ii：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

システム分析支援アキュムレータが起動しているか確認してください。

起動しているときは、以下のとおりに対策してください。

プロトコル種別がTNS以外の場合

KFSE43303-Wメッセージの理由コード一覧に従って対策してください。

プロトコル種別がTNSの場合

本メッセージより前に出力されているメッセージに従って対策してください。

KFSE53901-E　（Y）E+P+L（L）2

Oracle Databaseとのコネクション確立に失敗しました。詳細コード＝aa....aa

Failed to establish a connection with Oracle Database. detail code = aa....aa

Oracle Databaseとのコネクション確立に失敗しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

OracleClientとのコネクションを切断します。SQLを実行したアプリケーションには、SQLCODE=3113,12537など、通信障害を示すSQLCODEがリターンされます。

（O）

Oracle Database、Oracle Net Listenerが起動しているか確認してください。

起動している場合は、システム検証支援基盤の定義address_destinationの-tオプションに指定したIPアドレス、ポート番号をOracle Net ListenerのIPアドレス、ポート番号と同じ値に設定してシステム検証支援基盤を再起動してください。

解決しない場合は、システム管理者に連絡してください。

［対策］

このメッセージの前に出力されているKFSE43301-Wを参照して対策してください。

KFSE53902-E　（Y）E+P+L（L）2

TNS電文の送信に失敗しました。送信先＝aa....aa，詳細コード＝bb....bb

Failed to transmit a TNS message. transmission destination = aa....aa, detail code = bb....bb

TNS電文の送信に失敗しました。

aa....aa：

Client：Oracle Clientへの送信に失敗しました。

Database：Oracle Databaseへの送信に失敗しました。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

OracleClientとのコネクションを切断します。SQLを実行したアプリケーションには、SQLCODE=3113,12537など、通信障害を示すSQLCODEがリターンされます。OracleClientとのコネクションが既に切断されている場合は、通信障害以外のSQLCODEがリターンされる場合があります。

（O）

Oracle Databaseへの送信に失敗した場合は、Oracle Database、Oracle Net Listenerが起動しているか確認してください。

Oracle Clientへの送信に失敗した場合は、APが停止していないか確認してください。

解決しない場合は、システム管理者に連絡してください。

［対策］

このメッセージの前に出力されているKFSE43303-Wを参照して対策してください。

KFSE53903-E　（Y）E+P+L（L）2

パケットキャプチャ時に実行されていないSQLが実行されました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，相手ＩＰアドレス＝cc....cc，相手ポート番号＝dd....dd，詳細コード＝ee....ee

An SQL statement that was not executed during the packet capture was executed. local IP address = aa....aa, local port number = bb....bb, remote IP address = cc....cc, remote port number = dd....dd, detail code = ee....ee

パケットキャプチャ時に実行されていないSQLが実行されました。OracleClientとのコネクションを切断します。

aa....aa：自IPアドレス

システム検証支援基盤のIPアドレスを示します。

bb....bb：自ポート番号

システム検証支援基盤のポート番号を示します。

cc....cc：相手IPアドレス

OracleClientのIPアドレスを示します。

dd....dd：相手ポート番号

OracleClientのポート番号を示します。

ee....ee：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

OracleClientとのコネクションを切断します。SQLを実行したアプリケーションには、SQLCODE=3113,12537など、通信障害を示すSQLCODEがリターンされます。

（O）

アプリケーションがパケットキャプチャ時と同じように動作しているか見直してください。

［対策］

なし。

KFSE53904-E　（Y）E+P+L（L）2

タイムアウトを検知しました。監視先＝aa....aa，自ＩＰアドレス＝bb....bb，自ポート番号＝cc....cc，相手ＩＰアドレス＝dd....dd，相手ポート番号＝ee....ee，詳細コード＝ff....ff

A timeout was detected. target being monitored = aa....aa, local IP address = bb....bb, local port number = cc....cc, remote IP address = dd....dd, remote port number = ee....ee, detail code = ff....ff

OracleClientからの次の要求、またはOracleDatabaseからの応答を待つ監視時間のタイムアウトを検知しました。OracleClientとのコネクションを切断します。

aa....aa：

Client：Oracle Clientからの次の要求待ちタイムアウトです。

Database：Oracle Databaseからの応答待ちタイムアウトです。

bb....bb：自IPアドレス

システム検証支援基盤のIPアドレスを示します。

cc....cc：自ポート番号

システム検証支援基盤のポート番号を示します。

dd....dd：相手IPアドレス

OracleClientのIPアドレスを示します。

ee....ee：相手ポート番号

OracleClientのポート番号を示します。

ff....ff：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

OracleClientとのコネクションを切断します。SQLを実行したアプリケーションには、SQLCODE=3113,12537など、通信障害を示すSQLCODEがリターンされます。

（O）

OracleClientからの次の要求待ちの場合、アプリケーションが正しく動作しているか確認してください。アプリケーションが正しく動作している場合は、address_destinationの-iオプションserv_watchtime指定値を見直してください。

Oracle Databaseからの応答待ちの場合、OracleDatabaseの動作状況を確認してください。Oracle Databaseが正常に動作している場合は、address_destinationの-iオプションclt_watchtime指定値を見直してください

［対策］

なし。

KFSE53905-E　（Y）E+P+L（L）2

解析できないパケットを受信しました。送信元＝aa....aa，自ＩＰアドレス＝bb....bb，自ポート番号＝cc....cc，相手ＩＰアドレス＝dd....dd，相手ポート番号＝ee....ee，詳細コード＝ff....ff

A timeout was detected. target being monitored = aa....aa, local IP address = bb....bb, local port number = cc....cc, remote IP address = dd....dd, remote port number = ee....ee, detail code = ff....ff

OracleClient、またはOracleDatabaseからOracleのTNS電文として解析できないパケットを受信しました。

aa....aa：

Client：解析できなかったのはOracle Clientからの要求です。

Database：解析できなかったのはOracle Databaseからの応答です。

bb....bb：自IPアドレス

システム検証支援基盤のIPアドレスを示します。

cc....cc：自ポート番号

システム検証支援基盤のポート番号を示します。

dd....dd：相手IPアドレス

OracleClientのIPアドレスを示します。

ee....ee：相手ポート番号

OracleClientのポート番号を示します。

ff....ff：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

OracleClientとのコネクションを切断します。SQLを実行したアプリケーションには、SQLCODE=3113,12537など、通信障害を示すSQLCODEがリターンされます。

（O）

テスト実行時の環境が、SQLリプロダクションが適応している環境か確認してください。適応していない環境の場合は、適応する環境で実行してください。適応している環境でこのメッセージが出力された場合は、システム管理者に連絡してください。

このメッセージが出力されると、以下のディレクトリにトラブルシュート情報が出力されます。出力されるファイルは単調増加ファイルです。保守員への連絡が不要な場合は、ファイルを削除してください。

/opt/HSIC/job/KKK/spool/dceeinf/packet/

KKKはテスト識別子

［対策］

適応している環境でこのメッセージが出力された場合は、保守員に連絡してください。

KFSE53930-E　（Y）E+P+L（L）2

解析できないパケットを検知しました。

A packet that cannot be parsed was detected.

パケット解析中に、OracleのTNS電文として解析できないパケットを検知しました。

（S）

当該パケットを破棄し、処理を続行します。

（O）

HSICが適応する環境か確認してください。適応する環境でこのメッセージが出力された場合は、システム管理者に連絡してください。

［対策］

適応する環境でこのメッセージが出力された場合は、保守員に連絡してください。

KFSE54101-E　（Y）E+P+L（L）2

UOCでエラーが発生しました。UOC名＝aa....aa，理由コード＝bb....bb，詳細コード＝cc....cc

A UOC error occurred. UOC name = aa....aa, reason code = bb....bb, detail code = cc....cc

UOCでエラーが発生しました。

aa....aa：エラーが発生したUOC名です。

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

電文組立UOC、電文情報設定UOC、蓄積復元UOC、送信編集UOC、受信編集UOC、蓄積編集UOCの場合、電文を破棄します。結果判定UOCの場合結果ファイルのユーザ情報コードに「0」、ユーザ情報文字列に「PLUGIN-ERROR」を出力します。オペレーション名判定UOCの場合、システム検証支援はデフォルトのオペレーション名を設定し、処理を続行します。電文追加UOC、電文増幅UOCの場合、クライアントの増幅および電文の追加を行わずに処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧を見て対策してください。

理由コード

意味

対策

0001

UOCが詳細リターンコードcc....ccでエラーリターンしました。

cc....ccに示す詳細リターンコードからUOC処理におけるエラーの原因を調査してください。原因が判明できない場合は、保守員に連絡してください。

1001

電文サイズが不正です。

now_data_size設定値を確認してください。

1002

すでに電文サイズの上限に達しているにも関わらず、電文組立UOCが電文未完成でリターンしました。

電文サイズがframework_definition定義の-bオプションmax_message_sizeフラグメンバ設定値、または電文組立UOCのリターンコードを確認してください。

2001

電文種別が不正です。

reqtype設定値を確認してください。

3001

TCP電文のサイズが不正です。

edt_sizeのtcpsizeのsize設定値を確認してください。

3002

HTTP電文のヘッダサイズが不正です。

edt_sizeのhttpsizeのheader_size設定値を確認してください。

3003

HTTP電文のボディサイズが不正です。

edt_sizeのhttpsizeのbody_size設定値を確認してください。

3004

IIOP電文のヘッダサイズが不正です。

edt_telegram_sizeのhttpsizeのheader_size設定値を確認してください。

3005

IIOP電文のボディサイズが不正です。

edt_telegram_sizeのhttpsizeのbody_size設定値を確認してください。

3006

RPC電文のヘッダサイズが不正です。

edt_telegram_sizeのrpc_sizeのheader_size設定値を確認してください。

3007

RPC電文のボディサイズが不正です。

edt_telegram_sizeのrpc_sizeのbody_size設定値を確認してください。

3008

サービスグループ名が不正です。

protocol_editinf（ESFRW_SEND_IF_RPCにキャスト）のgroup設定値を確認してください。

3009

サービス名が不正です。

protocol_editinf（ESFRW_SEND_IF_RPCにキャスト）のservice設定値を確認してください。

4001

エラーレベルが不正です。

error_levelの設定値を確認してください。

5001

オペレーション名が不正です。

operation_nameの設定値を確認してください。

6001

クライアント増幅数が不正です。

amp_client_cnt設定値を確認してください。

6002

クライアント増幅の遅延時間が不正です。

amp_client_delay設定値を確認してください。

6003

電文追加の送信間隔が不正です。

amp_telegram_interval設定値を確認してください。

KFSE54102-E　(Y)E+P+L (L)2

プラグインでエラーが発生しました。理由コード＝aa…aa，ファイル名＝bb…bb，詳細コード１＝cc…cc，詳細コード２＝dd…dd

A plugin error occurred. reason code = aa…aa, file name = bb…bb, detail code 1 = cc…cc, detail code 2 = dd…dd

プラグインでエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：ファイル名

エラー契機となったファイル名を表示します。

表示すべき情報がない場合は"**"を表示します。

cc…cc：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

dd…dd：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

当該プラグインはESFRW_NGでリターンし、処理を続行します。

（O）

システム管理者へ連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0004

電文サイズ上限超過

電文サイズがframework_definition定義の-bオプションmax_message_sizeフラグメンバ設定値を超過していないか確認してください。

0005

cURL処理失敗

シナリオファイルの内容に問題がないか確認してください。また、通信相手の状態を確認してください。

0006

ファイルアクセス失敗

表示されたファイルの有無、およびアクセス権に問題がないか確認してください。

KFSE54401-E　（Y）E+P+L（L）2

テスト対象パケットを含むpcap形式ファイルが存在しません。理由コード＝aa....aa，テスト開始時刻＝bb....bb，テスト終了時刻＝cc....cc

The pcap file including the test target packet does not exist. reason code = aa....aa, test begin time = bb....bb, test end time = cc....cc

テスト対象パケットを含むpcap形式ファイルが存在しません。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：テスト開始時刻

テスト対象範囲の開始時刻を「yyyy/mm/dd hh:mm:ss」形式で出力します。

テスト対象範囲の開始時刻を省略した場合は「----/--/-- --:--:--」を表示します。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

cc....cc：テスト終了時刻

テスト対象範囲の終了時刻を「yyyy/mm/dd hh:mm:ss」形式で出力します。

テスト対象範囲の終了時刻を省略した場合は「----/--/-- --:--:--」を表示します。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

ディレクトリ内にpcap形式ファイルが存在しません。

capture_network_interfaceオペランドの-iオプションのpcapdirで指定するpcap形式ファイル格納ディレクトリを見直しください。

0002

pcap形式ファイル格納ディレクトリ内に、テスト対象範囲のpcap形式ファイルがありません。

capture_network_interfaceオペランドの-iオプションのpcapdirで指定するpcap形式ファイル格納ディレクトリを見直しください。または、ディレクトリ内のpcap形式ファイルを見直してください。

KFSE55002-E　（Y）E+P+L（L）2

コマンド制御の受信処理でエラーが発生しました。詳細コード＝aa....aa

An error occurred during receive processing for command control. detail code = aa....aa

コマンドからの電文受信処理においてエラーが発生しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55003-E　（Y）E+P+L（L）2

コマンド制御の送信処理でエラーが発生しました。詳細コード＝aa....aa

An error occurred during transmit processing for command control. detail code = aa....aa

コマンドへの電文送信処理においてエラーが発生しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

コマンドがタイムアウトしていないか、又はコマンドを強制終了していないか確認してください。該当しない場合は保守員に連絡してください。

KFSE55004-E　（Y）E+P+L（L）2

メモリ不足が発生しました。メモリ種別＝aa....aa，要求サイズ＝bb....bb

Memory is insufficient. memory type = aa....aa, required size = bb....bb

コマンド制御処理において、メモリ確保できませんでした。

aa....aa：要求したメモリ種別

CIBF（コマンド用入力バッファ）

COBF（コマンド用出力バッファ）

WORK（ワークセグメント）

bb....bb：要求サイズ

確保しようとしたメモリのサイズ（単位：バイト）

（S）

処理を続行します。

（O）

メモリ種別がWORK、CIBFの場合

しばらくしてからコマンドをもう一度実行してください。繰り返し発生する場合は、システム管理者に連絡してください。

メモリ種別がCOBFの場合

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55006-E　（Y）E+P+L（L）2

不正な電文を受信しました。詳細コード＝aa....aa

An invalid message was received. detail code = aa....aa

コマンドからの受信データに設定した電文サイズと、受信データサイズが一致しません。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55007-E　（Y）E+P+L（L）2

電文バージョン不正が発生しました。詳細コード＝aa....aa

A message version error occurred. detail code = aa....aa

コマンドから受信した電文が、処理可能な形式ではありませんでした。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55009-E　（Y）E+P+L（L）2

受信電文サイズがシステム用バッファ領域より大きいので処理できません。詳細コード＝aa....aa

The received message cannot be processed because it is larger than the system buffer area. detail code = aa....aa

コマンドからの受信電文を格納する領域より大きいサイズの電文を受信しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

システム検証支援基盤のコマンド（esstartを除く）を実行していない時に本メッセージが出力された場合は、コマンド用ポートにて不正な電文を受信した可能性があります。

システム検証支援基盤のコマンド（esstartを除く）を実行した時に本メッセージが出力された場合は、保守員に連絡してください。

KFSE55011-E　（Y）E+P+L（L）2

コマンド制御で障害が発生しました。詳細コード１＝aaaa，詳細コード２＝bb....bb

A command control error occurred. detail code 1 = aaaa, detail code 2 = bb....bb

コマンド制御で障害が発生しました。

aaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55101-E　（Y）E（L）2

メモリ確保処理に失敗しました。要求種別＝aa....aa，要求サイズ＝bb....bb

An attempt to allocate memory has failed. request type = aa....aa, request size = bb....bb

システム検証支援基盤プロセスにおいて、メモリの確保処理に失敗しました。

aa....aa：要求種別

SYSTBL：システムテーブル

SYSWRK：システムワーク

IBF：入力バッファ

PCE：電文処理用バッファ

ICB：タイマ処理用バッファ

CIBF：コマンド用入力バッファ

COBF：コマンド用出力バッファ

aa....aa：要求サイズ

確保要求したサイズ値。（単位：バイト）

（S）

メモリ確保処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

OS 全体のメモリ使用状況を確認してください。

KFSE55190-E　（Y）E、E+P+L（L）2

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

関数発行時に、内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55313-E　（Y）E+P+L（L）2

監視タイマのタイムアウトを検出しました。スレッド種別＝a，ＩＦＡ番号＝bb....bb，タイマ種別＝cc....cc，タイマ監視時間＝dd....dd，タイマ監視開始時刻＝yyyy/mm/dd hh:mm:ss，追加情報１＝ee....ee，追加情報２＝ff....ff，詳細コード＝gg....gg

A timer timeout was detected. thread type = a, IFA number = bb....bb, timer type = cc....cc, timer monitoring time = dd....dd, timer monitoring start time = yyyy/mm/dd hh:mm:ss, additional information 1 = ee....ee, additional information 2 = ff....ff, detail code = gg....gg

処理時間監視のタイムアウトを検出しました。

a：スレッド種別

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：IFA番号（10進表記）

タイムアウトが発生したスレッドのIFA番号が表示されます。

cc....cc：タイマ種別

HUNGUP：ハングアップタイマ

UOC：UOC監視タイマ

タイマ種別の取得に失敗した場合は「*」が表示されます。

dd....dd：タイマ監視時間（10進表記）（単位：秒）

タイムアウトが発生したタイマの監視時間が表示されます。

yyyy/mm/dd hh:mm:ss：タイマ監視開始時刻

タイムアウトが発生したタイマの監視開始時刻が表示されます。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

ee....ee：追加情報1

追加情報1に表示される内容ごとの対策を［対策］に示します。

ff....ff：追加情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

追加情報1の内容に応じた対策を行ってください。

追加情報1

対策

file_out_control -t output_time

トラブルシュート関連定義file_out_controlオペランドの-tオプションoutput_timeメンバの設定値を見直してください。

file_out_control -t open_time

トラブルシュート関連定義file_out_controlオペランドの-tオプションopen_timeメンバの設定値を見直してください。

uoc_hungup_time -t

UOC関連定義uoc_hungup_timeオペランドの-tオプションの設定値を見直してください。

上記以外

保守員に連絡してください。

KFSE55325-E　（Y）E+P+L（L）2

メインスレッドの初期化中に障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An error has occurred during initialization processing of the main thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

メインスレッドの初期化中に障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE55326-E　（Y）E+P+L（L）2

メインスレッドの終了中に障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An error has occurred during termination processing of the main thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

メインスレッドの終了中に障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE55331-E　（Y）E+P+L（L）2

モニタスレッドの終了中に障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An error has occurred during termination processing of a monitor thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

モニタスレッドの終了中に障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE55335-E　（Y）E+P+L（L）2

処理スレッドの終了中に障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An error has occurred during termination processing of a processing thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

処理スレッドの終了中に障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE55340-E　（Y）E+P+L（L）2

シグナルスレッドの終了中に障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

An error has occurred during termination processing of a signal thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

シグナルスレッドの終了中に障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE55355-E　（Y）E+P+L（L）2

ＵＯＣが不正な手段によりスレッドを強制終了しました。ＩＦＡ番号＝aa....aa

The UOC has used an invalid method to forcibly terminate a thread. IFA number = aa....aa

UOCが不正な手段（pthread_exit等）によりスレッドを強制終了しました。

aa....aa：IFA番号（10進表記）

強制終了したスレッドのIFA番号を表示します。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

スレッドの強制終了を行わないようにUOCを修正してください。

KFSE55365-E　（Y）E+P+L（L）2

処理の登録に失敗しました。処理種別＝aa，理由コード＝bbbb，詳細コード１＝cccccccc，詳細コード２＝dddddddd

Failed to register. process type = aa, reason code = bbbb, detail code 1 = cccccccc, detail code 2 = dddddddd

処理の登録に失敗しました。

aa：処理種別

処理種別は「11.1.3　メッセージに出力される処理種別」を参照してください。

bbbb：理由コード

理由コードの意味と対策を［対策］に示します。

cccccccc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dddddddd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0013

PCE（電文処理用バッファ）不足が発生しました。

メモリの使用状況を確認してください。

9999

予期しないエラーが発生しました。

保守員に連絡してください。

KFSE55390-E　（Y）E（L）1

システム検証支援基盤プロセスで障害が発生しました。ＩＦＡ番号＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc

An error has occurred in a SIC process. IFA number = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc

システム検証支援基盤プロセスで障害が発生したため、障害情報を表示します。

aa....aa：IFA番号（10進表記）

強制終了したスレッドのIFA番号を表示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

なし。

KFSE55401-E　（Y）E+P+L（L）2

トラブルシュートファイルの初期化処理に障害が発生しました。ファイル種別＝a，理由コード＝bb

Failure occurred for initialization processing for the troubleshooting file. file type = a, reason code = bb

トラブルシュートファイルの初期化処理に障害が発生しました。

a：ファイル種別

t：TASKTMファイル

s：システム統計情報ファイル

bb：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由に応じた対策を行ってください。

理由コード

意味

対策

01

ファイル作成エラー（システム定義に設定した数のファイルが作成できませんでした）

メッセージログファイルを参照し、原因を検証して下さい。システム検証支援基盤の続行に影響がある場合は、原因を取り除いた上でシステム検証支援基盤を再起動して下さい。

02

作業エリア確保エラー

OSのメモリの使用状況を確認してください。

03

ファイルI/Oエラー

メッセージログファイルを参照し、原因を検証して下さい。システム検証支援基盤の続行に影響がある場合は、原因を取り除いた上でシステム検証支援基盤を再起動して下さい。

KFSE55402-E　（Y）E+P+L（L）2

ＴＡＳＫＴＭ出力機能を停止します。理由コード＝aa

The TASKTM output function will stop. reason code = aa

TASKTM出力機能を停止します。

aa：理由コード

01：出力可能なTASKTMファイルがなくなりました。

02：TASKTMファイルを格納するディレクトリが作成できませんでした。

03：TASKTMファイル初期化処理に障害が発生しました。

（S）

処理を続行します。

（O）

メッセージログファイルを参照し、原因を検証して下さい。システム検証支援基盤の続行に影響がある場合は、原因を取り除いた上でシステム検証支援基盤を再起動して下さい。

［対策］

なし。

KFSE55405-E　（Y）E+P+L（L）2

ディレクトリ作成処理に障害が発生しました。ディレクトリ名＝aa....aa，理由コード＝bb

Failure occurred for directory creation processing. directory name = aa....aa, reason code = bb

ディレクトリ作成処理に障害が発生しました。

aa....aa：ディレクトリ名

bb：理由コード

01：mkdirエラー

02：stat64またはstatエラー

（S）

処理を続行します。

（O）

ディレクトリの使用状況を見直して下さい。システム検証支援基盤の続行に影響がある場合は、原因を取り除いた上でシステム検証支援基盤を再起動して下さい。

［対策］

なし。

KFSE55406-E　（Y）E+P+L（L）2

統計情報出力機能を停止します。理由コード＝aa

The output function for statistical information will stop. reason code = aa

システム統計情報出力機能を停止します。

aa：理由コード

01：出力可能なシステム統計情報ファイルがなくなりました。

02：システム統計情報ファイルを格納するディレクトリが作成できませんでした。

03：システム統計情報ファイル初期化処理に障害が発生しました。

（S）

処理を続行します。

（O）

メッセージログファイルを参照し、原因を検証して下さい。システム検証支援基盤の続行に影響がある場合は、原因を取り除いた上でシステム検証支援基盤を再起動して下さい。

［対策］

なし。

KFSE55407-E　（Y）E+P+L（L）2

タイマの登録に失敗しました。処理種別＝aa....aa

An attempt to register a timer failed. processing type = aa....aa

タイマの登録に使用するメモリが不足したため、タイマ登録に失敗しました。時間をおいて再度登録します。

aa....aa：処理種別

1：システム統計情報のインタバル取得

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE55521-E　（Y）E+P+L（L）2

開始処理中にエラーが発生しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc

An error occurred in the start-up processing. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc

システム検証支援基盤プロセスの開始処理中にエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

システム検証支援基盤プロセスの初期化に失敗しました。

esstartコマンドを再実行してください。

KFSE55580-E　（Y）E+P+L（L）2

内部関数で障害が発生しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc

An error has occurred in an internal function. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc

システム検証支援基盤プロセスの開始処理中にエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

11.4　KFSE60001からKFSE69999までのメッセージ

KFSE60300-E　（Y）E+P+L（L）1

内部矛盾を検出しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd

An internal conflict was detected. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd

関数発行時に、内部矛盾を検出しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE60301-E　（Y）E+P+L（L）1

処理を続行できません。システム検証支援基盤プロセスを終了します。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd

The process could not be continued. The SIC process will now end. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd

処理続行できない障害が発生したためシステム検証支援基盤プロセスを終了します。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE60302-E　（Y）E+P+L（L）1

排他処理に失敗しました。対象資源＝aa....aa，排他処理＝bb....bb，詳細コード＝cc....cc

The exclusion process failed. target resource = aa....aa, exclusive process = bb....bb, detail code = cc....cc

排他処理で障害が発生しました。

aa....aa：対象資源

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：排他処理

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE60303-E　（Y）E+P+L（L）1

コネクションの作成に失敗しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

Failed to establish a connection. detail code 1 = aa....aa, detail code 2 = bb....bb

コネクションの作成に失敗しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

詳細コード1が「TIMEOUT_CONNECTION_TEMPORARY_CLOSE」の場合、システム検証支援基盤のrpc_socketオペランドの指定値、およびテスト対象システムのOpenTP1の定義を見直すことで、現象を回避できる場合があります。

一時クローズ処理の発生頻度を下げることで解決することがあります。この場合、rpc_socket -m max_socketの指定値を大きくしてください。

rpc_socket -m max_socketの指定値を変更できない場合、かつ、テスト対象システムのOpenTP1でpolling_control_dataオペランドにYが設定されている場合は、rpc_socket -t sockctl_watchtimeの指定値を見直してください。

詳細はrpc_socketオペランドの各フラグメンバを参照してください。

その他の場合、保守員に連絡してください。

KFSE60590-E　（Y）E（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An internal contradiction occurred. detail code 1 = aa....aa, detail code 2 = bb....bb

関数発行時に、内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE60801-E　（Y）E（L）1

領域不足のためテーブル作成に失敗しました。テーブル名＝aa....aa

An attempt to create a table has failed due to insufficient space. table name = aa....aa

システム検証支援基盤プロセスの初期化処理において、領域不足のためテーブル作成に失敗しました。

aa....aa：テーブル名

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

OS 全体のメモリ使用状況を確認してください。

KFSE60802-E　（Y）E+L（L）1

クライアント数が上限を超えました。クライアント数＝aa....aa

The number of clients exceeded the upper limit. number of clients = aa....aa

システム検証支援基盤で処理するクライアント数が上限を超えたため、システム検証支援基盤プロセスを強制停止します。

aa....aa：現在のクライアント数

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

システム検証支援基盤で処理するクライアント数が、現在のクライアント数未満になるようにパケットキャプチャ関連定義やフィルタ関連定義を見直してください。

上記の対策で解決できない場合は、保守員に連絡してください。

KFSE60803-E　（Y）E+P+L（L）1

ＵＯＣ共用ライブラリのオープンに失敗しました。理由コード＝aaaa，ＵＯＣ共用ライブラリ名＝bb....bb

An attempt to open a UOC common library has failed. reason code = aaaa, UOC common library name = bb....bb

UOC共用ライブラリをオープンしようとしましたが失敗しました。

aaaa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：UOC共用ライブラリ名

（S）

UOC 共用ライブラリのオープン処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧を見て対策してくだい。

理由コード

意味

対策

0021

UOCの共用ライブラリに関する定義のmodule定義が設定されていません。

UOCの共用ライブラリに関する定義のmodule定義を見直してシステム検証支援基盤を再起動してください。

0022

UOC共用ライブラリのオープンに失敗しました。

UOC共用ライブラリファイルのアクセス権限を確認してください。

0023

パス名が指定値を超えています。

パス名を確認してください。

0024

メモリが不足しています。

以前に出力されたメッセージに従って障害を取り除き、再度システム検証支援基盤を起動してください。

0031

ファイルのヘッダが正しくありません。

UOC共用ライブラリファイルの状態を確認してください。

0032

シンボリックの数が多すぎます。

0033

ローディング、またはシンボル解決時にエラーが発生しました。

0034

既に他プロセスがファイルをオープンしています。

0035

パス・プレフィクスが存在しません。

0036

パス・プレフィクスの構成要素がディレクトリではありません。

0037

対象ディレクトリが既にアンマウントされたファイルシステムの領域に割り付けられています。

8000

システムコールの呼出に失敗しました。

このメッセージの直前に出力したKFSE40107-Eを参照して原因を取り除いて、再実行してください。原因を取り除けない場合は、保守員に連絡してください。

9000

内部矛盾を検知しました。

保守員に連絡してください。

KFSE60804-E　（Y）E+P+L（L）1

エントリポインタ名は見つかりませんでした。ＵＯＣ種別＝aa....aa，エントリポインタ名＝bb....bb

The entry pointer name could not be found. UOC type = aa....aa, entry point name = bb....bb

UOC関連定義で設定されたエントリポインタがUOC共用ライブラリ内で見つかりませんでした。

aa....aa：UOC種別

当該UOC種別

UOC_STEN：プロトコル共通UOC

UOC_IND：入力判定UOC

UOC_STR：蓄積編集UOC

UOC_SND：送信編集UOC

UOC_CMP：データ比較UOC

bb....bb：エントリポインタ名

当該エントリポインタ名

（S）

UOC 共用ライブラリのローディング処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

システム検証支援基盤定義を見直してください。

UOC種別

見直し定義内容

UOC_STEN

UOC関連定義のuoc_func_com 定義-sオプション

UOC_IND

UOC関連定義のuoc_func_rpc 定義-iオプション

UOC_STR

UOC関連定義のuoc_func_rpc 定義-aオプション

UOC_SND

UOC関連定義のuoc_func_rpc 定義-sオプション

UOC_CMP

UOC関連定義のuoc_func_rpc 定義-cオプション

UOC_JDG

UOC関連定義のuoc_func_rpc 定義-jオプション

UOC_AMP

UOC関連定義のuoc_func_rpc 定義-tオプション

UOC_RECV

UOC関連定義のuoc_func_rpc 定義-rオプション

KFSE60890-E　（Y）E（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb

関数発行時に、内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE60901-E　（Y）E、E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc，詳細コード４＝dd....dd，詳細コード５＝ee....ee

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc, detail code 4 = dd....dd, detail code 5 = ee....ee

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード4

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード5

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡して下さい。

KFSE60910-E　（Y）E+P+L（L）1

蓄積ファイル出力機能で障害が発生しました。ファイル種別＝aa....aa，理由コード＝bb....bb，ファイル名＝cc....cc，詳細コード＝dd....dd

An error occurred in the accumulation file output function. file type = aa....aa, reason code = bb....bb, file name = cc....cc, detail code = dd....dd

蓄積ファイル出力機能で障害が発生しました。

aa....aa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：蓄積ファイル名

以下に示す理由コードの場合は、蓄積ファイルを格納するディレクトリ名を表示します。

「MAKE DIR」、 「OPEN DIR」、「READ DIR」、 「NONE DIR」

理由コードが「DIR STAT」のときは、蓄積ファイルを格納するディレクトリ名、もしくは、蓄積ファイルを格納するディレクトリ内のディレクトリ名、または、ファイル名を表示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MAKE DIR

ディレクトリの作成に失敗しました。

（mkdirエラー）

ディスク容量の不足、ディレクトリへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

DIR STAT

ディレクトリまたはファイルの状態取得に失敗しました。

（statエラー）

OPEN DIR

ディレクトリのオープンに失敗しました。（opendirエラー）

READ DIR

ディレクトリエントリの取得

失敗しました。（readdir_rエラー）

FIL OPEN

ファイルのオープンに失敗しました。

（openエラー）

蓄積ファイルを格納するディレクトリ内に、蓄積ファイルと同じ名称のディレクトリがある場合は、ディレクトリ名称を変更するか、別ディレクトリに移動してください。

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

UNLINK

ファイルの削除に失敗しました。

（unlinkエラー）

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

NONE DIR

蓄積ファイル関連定義accumulate_fileコマンド-fオプションのdirpathで指定したファイル格納ディレクトリが存在しません。

蓄積ファイル関連定義accumulate_fileコマンド-fオプションのdirpathで指定したファイル格納ディレクトリを作成してください。

MAX CNT

蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfilenoで指定したファイル最大面数を超えた出力要求がありました。

直前にKFSE50910-Eメッセージが出力されている場合は、当該メッセージの対策をしてください。

蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfilenoで指定するファイル最大面数、および、蓄積ファイル関連定義accumulate_fileコマンド-fオプションのfileszで指定するファイル最大サイズの値を見直してください。

HUNG ADD

内部矛盾が発生しました。

保守員に連絡してください。

HUNG INF

BUF FAIL

KFSE60911-E　（Y）E+P+L（L）1

蓄積バッファ管理機能で障害が発生しました。ファイル種別＝aa....aa，理由コード＝bb....bb，バッファ面数＝cc....cc，詳細コード１＝dd....dd，詳細コード２＝ee....ee

An error occurred in the accumulation buffer management function. file type = aa....aa, reason code = bb....bb, buffer count = cc....cc, detail code 1 = dd....dd, detail code 2 = ee....ee

蓄積バッファ管理機能で障害が発生しました。

aa....aa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：使用したバッファ面数

dd....dd：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MSG SIZE

accumulate_fileコマンド-bオプションのsizeで指定したバッファサイズを超えた電文の格納要求がありました。

蓄積ファイル関連定義accumulate_fileコマンド-bオプションのsizeで指定するバッファサイズを見直してください。

BUF GET

蓄積バッファの追加確保に失敗しました。

直前に出力されているKFSE50901-Eメッセージの対策をしてください。

QUE ENTR

内部矛盾が発生しました。

保守員に連絡してください。

KFSE60912-E　（Y）E+P+L（L）1

蓄積ファイル読込み機能で障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An accumulation-file loading-error occurred. detail code 1 = aa....aa, detail code 2 = bb....bb

蓄積ファイル読込み機能で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は 、保守員に連絡してください。

KFSE60913-E　（Y）E+P+L（L）1

蓄積ファイル読込み機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ディレクトリ／ファイル名＝cc....cc，詳細コード＝dd....dd

An accumulation-file loading-error occurred. file type = aaa, reason code = bb....bb, directory/file name = cc....cc, detail code = dd....dd

蓄積ファイル読込み機能で障害が発生しました。

aaa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：蓄積ファイル格納ディレクトリ名/蓄積ファイル名

以下に示す理由コードの場合は、蓄積ファイルを格納するディレクトリ名か蓄積ファイル名を表示します。

「DIR STAT」、「READ DIR」

以下に示す理由コードの場合は、蓄積ファイルを格納するディレクトリ名を表示します。

「OPEN DIR」、「NONE DIR」

上記以外の理由コードの場合は、蓄積ファイル名を表示します。蓄積ファイルが蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションのdirpathで指定されたディレクトリの1階層下のディレクトリ下のファイルのときは、その1階層下のディレクトリ名を付加して表示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

DIR STAT

ディレクトリまたはファイルの状態取得に失敗しました。（statエラー）

ディスク容量の不足、ディレクトリへのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

OPEN DIR

ディレクトリのオープンに失敗しました。（opendirエラー）

READ DIR

ディレクトリエントリの取得に

失敗しました。（readdir_rエラー）

FIL OPEN

ファイルのオープンに失敗しました。

（openエラー）

LSEEK

蓄積ファイルの読込みに失敗しました。（lseekエラー）

ファイルシステムに異常がないかを確認してください。

NONE DIR

デフォルトの蓄積ファイル格納ディレクトリもしくは蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションで指定したファイル格納ディレクトリが存在しません。

蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションのdirpathで指定する蓄積ファイルディレクトリを見直してください。

READ

蓄積ファイルの読込みに失敗しました。（readエラー）

ファイルシステムに異常がないかを確認してください。

REALPATH

蓄積ファイル格納ディレクトリの絶対パス作成に失敗しました。（realpathエラー）

ファイルシステムに異常がないかを確認してください。

KFSE60914-E　（Y）E+P+L（L）1

リプレイ実行対象蓄積ファイルが存在しません。理由コード＝aa....aa，ディレクトリ＝bb....bb，詳細コード＝cc....cc

The replay execution target accumulation file was not found. reason code = aa....aa, directory = bb....bb, detail code = cc....cc

リプレイ実行の対象となる蓄積ファイルが存在しません。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ディレクトリ

蓄積ファイルが格納してあるディレクトリを表示します。

理由コードが「UNMATCH」の場合は‘****’を表示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

NO_FILE

ディレクトリ内に蓄積ファイルが存在しません。

蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションのdirpathで指定する蓄積ファイル格納ディレクトリを見直してください。

UNMATCH

要求電文蓄積ファイル、及び応答電文蓄積ファイルを格納したディレクトリ内に、同じシステム検証支援基盤プロセスで取得した蓄積ファイルがありません。

蓄積ファイル関連定義accumulate_reply_fileコマンドの-fオプションのdirpathで指定する蓄積ファイル格納ディレクトリを見直してください。

KFSE60915-E　（Y）E+P+L（L）1

リプレイ実行対象蓄積ファイル格納ディレクトリが不正です。理由コード＝aa....aa，ディレクトリ＝bb....bb，詳細コード＝cc....cc

The directory that contains replay execution target accumulation file is incorrect. reason code = aa....aa, directory = bb....bb, detail code = cc....cc

テスト応答電文を使用したリプレイ実行環境が不正です。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ディレクトリ

重複したディレクトリを表示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

OVERLAP

テスト応答電文の蓄積を行うディレクトリとリプレイ実行対象のテスト応答電文が格納されているディレクトリが重複しているか、リプレイ実行対象のテスト応答電文蓄積ファイルが格納されているディレクトリ直下にテスト応答電文蓄積ファイルを格納するディレクトリが存在します。

蓄積ファイル関連定義のうち-tオプションにRPYを指定したaccumulate_reply_fileコマンドの-fオプションのdirpathで指定する蓄積ファイル格納ディレクトリを変更し、変更先にテスト応答電文蓄積ファイルを移動してください。

蓄積ファイル関連定義のうち-tオプションにRPYTSを指定したaccumulate_fileコマンドの-fオプションのdirpathで指定するテスト応答電文蓄積ファイル格納ディレクトリを変更してください。

KFSE60920-E　（Y）E+P+L（L）1

フレームワーク用ファイル機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ディレクトリ＝cc....cc，詳細コード＝dd....dd

An error occurred in the file for the framework function. file type = aaa, reason code = bb....bb, directory = cc....cc, detail code = dd....dd

フレームワーク用ファイル機能で障害が発生しました。

aaa：フレームワーク用ファイル種別

TEL：電文ファイル

RES：結果ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：ディレクトリ

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

DIR STAT

ディレクトリの状態取得に失敗しました。またはディレクトリではありません。

（statエラー）

ディレクトリへのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

KFSE60921-E　（Y）E+P+L（L）1

フレームワーク用ファイル出力機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ディレクトリ／ファイル名＝cc....cc，詳細コード＝dd....dd

An error occurred in the function that outputs data to the file for the framework function. file type = aaa, reason code = bb....bb, directory/file name = cc....cc, detail code = dd....dd

フレームワーク用ファイル出力機能で障害が発生しました。

aaa：フレームワーク用ファイル種別

TEL：電文ファイル

RES：結果ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：ディレクトリ/ファイル名

理由コードがBUF GETの場合は‘****’を表示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

DIR STAT

ディレクトリまたはファイルの状態取得に失敗しました。（statエラー）

ディレクトリへのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

OPEN DIR

ディレクトリのオープンに失敗しました。（opendirエラー）

READ DIR

ディレクトリエントリの取得

失敗しました。（readdir_rエラー）

FIL OPEN

ファイルのオープンに失敗しました

（fopenエラー）

フレームワーク用ファイルを格納するディレクトリ内に、フレームワーク用ファイルと同じ名称のディレクトリがある場合は、ディレクトリ名称を変更するか、別ディレクトリに移動してください。

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

UNLINK

ファイルの削除に失敗しました。

（unlinkエラー）

ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

BUF GET

ヘッダデータ記録用バッファの確保に失敗しました。

直前に出力されているKFSE50901-Eメッセージの対策をしてください。

MAX CNT

-tオプションにtelegramを指定したCSVファイル関連定義csvfile_definitionコマンド-fオプションのfilenoで指定したファイル最大面数を超えた出力要求がありました。

-tオプションにtelegramを指定したCSVファイル関連定義csvfile_definitionコマンド-fオプションのfilenoで指定するファイル最大面数およびCSVファイル関連定義csvfile_definitionコマンド-fオプションのlinenoで指定する1ファイルに書き込む最大行数を見直してください。

MAX LOOP

スワップに失敗しました。

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE60922-E　（Y）E+P+L（L）1

フレームワーク用ファイル読込み機能で障害が発生しました。ファイル種別＝aaa，理由コード＝bb....bb，ディレクトリ／ファイル名＝cc....cc，詳細コード＝dd....dd

File load errors for the framework function occurred. file type = aaa, reason code = bb....bb, directory/file name = cc....cc, detail code = dd....dd

フレームワーク用ファイル読込み機能で障害が発生しました。

aaa：フレームワーク用ファイル種別

TEL：電文ファイル

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：フレームワーク用ファイル格納ディレクトリ名/フレームワーク用ファイル名

以下に示す理由コードの場合は、フレームワーク用ファイルを格納するディレクトリ名を表示します。

「OPEN DIR」「READ DIR」

理由コードが「DIR STAT」のときは、フレームワーク用ファイルを格納するディレクトリ名、もしくは、フレームワーク用ファイルを格納するディレクトリ内のディレクトリ名またはファイル名を表示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

DIR STAT

ディレクトリまたはファイルの状態取得に失敗しました。（statエラー）

ディスク容量の不足、ディレクトリへのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

OPEN DIR

ディレクトリのオープンに失敗しました。（opendirエラー）

READ DIR

ディレクトリエントリの取得に失敗しました。（readdir_rエラー）

FIL OPEN

ファイルのオープンに失敗しました。

（fopenエラー）

KFSE60923-E　（Y）E+P+L（L）1

フレームワーク用ファイル機能で障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An error occurred in the file for the framework function. detail code 1 = aa....aa, detail code 2 = bb....bb

フレームワーク用ファイル機能で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE60924-E　（Y）E+P+L（L）1

リプレイ実行対象フレームワーク用ファイルが存在しません。理由コード＝aa....aa，ディレクトリ＝bb....bb，詳細コード＝cc....cc

The replay execution target file for the framework function was not found. reason code = aa....aa, directory = bb....bb, detail code = cc....cc

リプレイ実行の対象となるフレームワーク用ファイルが存在しません。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ディレクトリ

フレームワーク用ファイルが格納してあるディレクトリを表示します。

対象となるディレクトリが複数あるときは，‘****’を表示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

NO_FILE

ディレクトリ内にフレームワーク用ファイルが存在しません。

CSVファイル関連定義csvfile_definitionコマンドの-fオプションのdirpathで指定するフレームワーク用ファイル格納ディレクトリを見直してください。

KFSE60950-E　（Y）E+P+L（L）1

比較エラー情報ファイル出力機能で障害が発生しました。理由コード＝aa....aa，ファイル名＝bb....bb，詳細コード＝cc....cc

An error occurred in the function that outputs data to the comparison error information file. reason code = aa....aa, file name = bb....bb, detail code = cc....cc

比較エラー情報ファイル出力機能で障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ファイル名

以下に示す理由コードの場合は、ディレクトリ名を表示します。

「MAKE DIR」、「DIR STAT」

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MAKE DIR

ディレクトリの作成に失敗しました。

（mkdirエラー）

ディスク容量の不足、ディレクトリへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

DIR STAT

ディレクトリの作成に失敗しました。

（statエラー）

MAX ERR

比較エラー情報ファイル定義のfilenoオペランドに指定された数のファイル全てがエラーになりました。

FC PROTO

内部矛盾が発生しました。

保守員に連絡してください。

MAX LOOP

スワップに失敗しました。

直前にメッセージが出力されている場合は、そのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE60981-E　（Y）E+P+L（L）1

HSIC-APで障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An error occurred in HSIC-AP. detail code 1 = aa....aa, detail code 2 = bb....bb

HSIC-APで障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE61801-E　（Y）E（L）1

定義解析処理中に領域確保に失敗しました。対象領域＝aa....aa，領域サイズ＝bb....bbバイト

Failed to allocate an area during the definition analysis. target area = aa....aa, area size = bb....bb bytes

定義格納領域、定義解析作業用領域の確保に失敗しました。

aa....aa：エラーの対象領域

READ1：定義読み込み作業領域の初期確保失敗

READ2：定義読み込み作業領域の追加確保失敗

FARGV1：定義解析作業領域の初期確保失敗

FARGV2：定義解析作業領域の追加確保失敗

LINE：定義行数読み込み作業領域の確保失敗

ADDR_DST：address_destinationコマンド形式定義の格納領域の確保失敗

CAP_NET：capture_network_interfaceコマンド形式定義の格納領域の確保失敗

ACL_FIL：accumulate_fileコマンド形式定義の格納領域の確保失敗

ACL_REP：accumulate_reply_fileコマンド形式定義の格納領域の確保失敗

RPC_TEL：rpc_telegram_filterコマンド形式定義の格納領域の確保失敗

UOC_FUNC：uoc_func_comまたはuoc_func_rpcコマンド形式定義の格納領域の確保失敗

MODULE：moduleコマンド形式定義の格納領域の確保失敗

bb....bb：確保に失敗した領域のサイズ

（S）

定義解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

必要なメモリを確保しシステム検証支援基盤を再起動してください。

KFSE61803-E　（Y）E（L）1

定義解析処理中に定義ファイルのオープンに失敗しました。ファイル名＝aa....aa

Opening of the definition file failed during definition analysis. file name = aa....aa

定義ファイルのオープンができませんでした。

aa....aa：ファイル名の絶対パス

esstartコマンドの引数に指定した定義ファイル格納ディレクトリ名、定義ファイル名が表示されます。

（S）

定義解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義ファイルの障害を取り除き、再実行してください。

障害の要因と考えられる事象

設定されたファイルが存在しない

ファイル障害が発生

ディスク障害が発生

設定されたパスが不正

設定されたファイルに対するアクセス権限が不正

リソース不足

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE61804-E　（Y）E（L）1

定義解析処理中に定義ファイルの読込みに失敗しました。ファイル名＝aa....aa，行数＝bb....bb

Loading of the definition file failed during definition analysis. file name = aa....aa, line = bb....bb

定義ファイルのbb....bb行目読込みの際にファイルエラーが発生しました。

aa....aa：ファイル名の絶対パス

bb....bb：読込みに失敗した行の行数

（S）

定義解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義ファイルの障害を取り除き、再実行してください。

障害の要因と考えられる事象

ファイル障害が発生

ディスク障害が発生

設定されたファイルに対するアクセス権限が不正

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE61805-E　（Y）E（L）1

定義解析処理中にエラーが発生しました。定義形式が不正です。ファイル名＝aa....aa，行数＝bb....bb，理由コード＝cc....cc

An error occurred during definition analysis. The definition format is incorrect. file name = aa....aa, line = bb....bb, reason code = cc....cc

定義形式が不正です。

aa....aa：ファイル名の絶対パス

bb....bb：不正があった行の行数

cc....cc：理由コード

OPERAND：オペランドが不正です。またはオペランドに指定した値が不正です。

FORMAT：定義形式が不正です。

NOTHING：文字列がありません。

OVER：定義ファイルの1行のバイト数が規定の範囲（4096バイト）を超えています。

（S）

定義解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義ファイル中のbb....bb行目に設定した定義形式を、理由コードに従って見直し、対策後システム検証支援基盤を再起動してください。

KFSE61807-E　（Y）E（L）1

定義解析処理においてエラーが発生しました。定義間に不正があります。ファイル名＝aa....aa，行数＝bb....bb，定義名＝cc....cc，オプションフラグ＝dd，オペランド名＝ee....ee，理由コード＝ff....ff

An error occurred in the definition analysis processing. An invalid value is specified in the definition. file name = aa....aa, line number = bb....bb, definition name = cc....cc, option flag = dd, operand name = ee....ee, reason code = ff....ff

定義ファイルのコマンド形式定義が不正です。コマンド形式定義間に不正があります。

aa....aa：障害が発生したファイルパス

bb....bb：不正があった行の行数

cc....cc：コマンド形式定義名

複数のコマンド形式定義名に関わる場合は、以下の形式でコマンド形式名、オプションフラグ、オペランド名を以下の様に表示します。

（コマンド形式名/オプションフラグ/オペランド名）：（コマンド形式名/オプションフラグ/オペランド名）：...

また、オプションフラグやオペランド名に関わらない場合は、それぞれに「**」を表示します。

（例）定義名＝（definition1/-x/**）：（definition2/-y/**）

dd：オプションフラグ

cc....ccでオプションフラグを出力している場合は「**」を表示します。

ee....ee：オペランド名

cc....ccでオペランド名を出力している場合は「**」を表示します。

ff....ff：理由コード

DUPLICATE：すでに定義されています。

NOTHING：先に定義すべき項目がありません。

OPERAND：既に定義されたオペランド値と矛盾します。

OVER：定義数の上限を超過しました。

COMMAND：既に定義されたコマンド形式定義と矛盾します。

（S）

定義解析を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義ファイルのbb....bb行目に指定したコマンド形式定義を見直し再起動してください。

KFSE61808-E　（Y）E（L）1

定義解析中にエラーが発生しました。省略できない定義が未定義です。ファイル名＝aa....aa，定義名＝bb....bb，オプションフラグ＝cc，オペランド名＝dd....dd

An error occurred during definition analysis. A mandatory definition is incorrect. file name = aa....aa, definition name = bb....bb, option flag = cc, operand name = dd....dd

省略できないコマンド形式定義が未定義です。

aa....aa：障害が発生したファイルパス

bb....bb：コマンド形式定義名

cc：オプションフラグ

オプションフラグに関係の無い場合は「**」を表示します。

dd....dd：オペランド名

オペランド名に関係の無い場合は「**」を表示します。

（S）

定義解析を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義内容を見直しbb....bbを追加して再起動してください。

KFSE61809-E　（Y）E（L）1

定義解析中にエラーが発生しました。実行形態と定義間に不正があります。実行形態＝aa....aa，ファイル名＝bb....bb，行数＝cc....cc，定義名＝dd....dd，オプションフラグ＝ee，オペランド名＝ff....ff，理由コード＝gg....gg

An error occurred during the definition analysis. There is a conflict between the execution format and the definition. execution format = aa....aa, file name = bb....bb, number of lines = cc....cc, definition name = dd....dd, option flag = ee, operand name = ff....ff, reason code = gg....gg

定義ファイルのコマンド形式定義が不正です。コマンドで指定した実行形態と、コマンド形式定義間に不正があります。

aa....aa：コマンドで指定した実行形態

複数の実行形態に関わる場合は、「-」区切りで実行形態を表示します。

-a：蓄積実行

-p：並行実行

-r：リプレイ実行

-c：PCAP実行

-o：SQLリプロダクション、またはDBテスタ

bb....bb：障害が発生したファイルパス

cc....cc：不正があった行の行数

特定の行に関わらない場合は0行を表示します。

dd....dd：コマンド形式定義名

複数のコマンド形式定義名に関わる場合は、以下の形式でコマンド形式名、オプションフラグ、オペランド名を表示します。

「（コマンド形式名/オプションフラグ/オペランド名）：（コマンド形式名/オプションフラグ/オペランド名）：...」

また、オプションフラグやオペランド名に関わらない場合は、それぞれに「**」を表示します。

（表示例） 定義名＝（definition1/-x/**）：（definition2/-y/**）

ee：オプションフラグ

オプションフラグに関係の無い場合、cc....ccでオプションフラグを出力している場合は「**」を表示します。

ff....ff：オペランド名

オペランド名に関係の無い場合は、cc....ccでオプションフラグを出力している場合「**」を表示します。

gg....gg：理由コード

NOTHING：実行形態aa....aaを指定時に定義必須の項目がありません。

OPERAND：実行形態aa....aaとオペランドが矛盾します。

FLAG：実行形態aa....aaとオプションフラグが矛盾します。

COMMAND：実行形態aa....aaとコマンド形式定義が矛盾します。

（S）

定義解析を中止しプロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義内容を見直して再起動してください。

KFSE61812-E　（Y）E（L）1

定義解析処理においてメモリリソース領域作成時にエラーが発生しました。

An error occurred while a memory resource area was being created during definition analysis.

定義解析処理においてメモリリソース領域作成中にエラーが発生しました。

（S）

定義解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

本メッセージの前に以下に示すメッセージが出てますのでそのメッセージを参照し、原因を取り除いた後、システム検証支援基盤を再起動してください。

KFSE55101-E、KFSE55190-E、KFSE65102-E、KFSE65103-E

KFSE61826-E　（Y）E+P+L（L）1

ＲＰＣ用ライブラリのローディングに失敗しました。ライブラリ名＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

Failed to load the RPC library. library name = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd

RPC用ライブラリのローディングに失敗しました。

aa....aa：ローディングに失敗したライブラリ名

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

address_destinationコマンド形式定義の-pオプション指定値を確認してください。

指定値に問題がなければ保守員に連絡してください。

KFSE61827-E　（Y）E+P+L（L）1

SQL解析用ライブラリのローディングに失敗しました。ライブラリ名＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

Failed to load the SQL parser library. library name = aa....aa, detail code 1 = bb....bb, detail code 2 ＝ cc....cc, detail code 3＝dd....dd

SQL解析用ライブラリのローディングに失敗しました。

aa....aa：ローディングに失敗したライブラリ名

bb....bb：システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

esibstartコマンド実行時にこのメッセージが出力された場合はHSICを再インストールしてください。

essqlstartコマンド実行時にこのメッセージが出力された場合はHSIC-DBを再インストールしてください。

KFSE61828-E　（Y）E+P+L（L）1

システム検証支援基盤とSQL解析用ライブラリのバージョンが不正です。システム検証支援基盤のバージョン＝aa....aa, SQL解析用ライブラリのバージョン＝bb....bb，詳細コード１＝cc....cc，詳細コード２＝dd....dd

The versions of SIC and the SQL parser library are invalid. version of SIC = aa....aa, version of the SQL parser library = bb....bb, detail code 1 = cc....cc, detail code 2 = dd....dd

システム検証支援基盤とSQL解析用ライブラリのバージョンが不正です。

aa....aa：システム検証支援基盤のバージョンです。

bb....bb：SQL解析用ライブラリのバージョンです。

cc....cc：システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

esibstartコマンド実行時にこのメッセージが出力された場合はHSICを再インストールしてください。

essqlstartコマンド実行時にこのメッセージが出力された場合はHSICとHSIC-DBのバージョンを確認して、正しい組み合わせのバージョンをインストールしてください。

KFSE61831-E　（Y）E（L）1

コマンド形式定義の定義解析中にエラーが発生しました。ファイル名＝aa....aa，行数＝bb....bb，定義名＝cc....cc，オプションフラグ＝dd....dd，オペランド名＝ee....ee，理由コード＝ff....ff

An error occurred while a command format definition was being analyzed. file name = aa....aa, line = bb....bb, definition name = cc....cc, option flag = dd, operand name = ee....ee, reason code = ff....ff

定義ファイルのコマンド形式定義を解析中にエラーが発生しました。

aa....aa：障害が発生したファイルパス

bb....bb：不正があった行の行番号

行番号に関係のない場合は「**」を表示します。

cc....cc：コマンド形式定義名

複数のコマンド形式定義名に関係のある場合は、「：」で区切って複数表示します。

dd....dd：オプションフラグ

複数のオプションフラグに関係のある場合は、「：」で区切って複数表示します。オプションフラグに関係の無い場合は「**」を表示します。

ee....ee：オペランド名

複数のオペランドに関係のある場合は、「：」で区切って複数表示します。オペランド名に関係の無い場合は「**」を表示します。

ff....ff：理由コード

MAX：最大定義数を超過しました。

MIN：最小定義数を超過しました。または、省略できないコマンド形式定義が未定義です。

OVER：設定内容が多すぎます。または、フラグ引数のどれかに空白が含まれている可能性があります。

DUPLICATE：オプションフラグまたはオペランドを重複して指定しています。

FLAG：オプションフラグに指定したフラグ引数が不正または指定できないフラグを指定しています。

OPERAND：オペランドに指定したオペランド値が不正または指定できないオペランドを指定しています。

NOTHING：省略できないコマンド、オプションフラグまたはオペランドを指定していません。

（S）

定義解析を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

定義ファイルのbb....bb行目に指定したコマンド形式定義を理由コードに従って見直し再起動してください。

KFSE61832-E　（Y）E+P+L（L）1

共用ライブラリのオープンに失敗しました。ライブラリ種別＝aaaa，共用ライブラリ名＝bb....bb

An attempt to open a common library has failed. library type = aaaa, common library name = bb....bb

共用ライブラリをオープンしようとしましたが失敗しました。

aaaa：ライブラリ種別

当該ライブラリ種別

PLG：プラグイン用ライブラリ

PLG_UOC：UOC用ライブラリ

bb....bb：共用ライブラリ名

当該共用ライブラリ名

（S）

共用ライブラリのオープン処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

ライブラリ種別一覧に従って対策してください。

ライブラリ種別に出力された内容

対策

PLG

framework_definition 定義-pオプションlibrary_file_name指定値を確認してください。または指定したライブラリの有無、アクセス権限を確認してください。

PLG_UOC

plugin_definition 定義-uオプションlibrary_file_name指定値を確認してください。または指定したライブラリの有無、アクセス権限を確認してください。

RPC_EXT

以下の定義の指定値を確認してください。または指定したライブラリの有無、アクセス権限を確認してください。

reply_send_mode定義-rオプションthreshold指定値およびinterval指定値

uoc_func_com定義-jオプション指定値および-tオプション指定値

rpc_definition定義-pオプション指定値およびproduction_reply_need指定値

KFSE61833-E　（Y）E+P+L（L）1

エントリポインタ名は見つかりませんでした。エントリポインタ種別＝aa....aa，エントリポインタ名＝bb....bb

The entry pointer name could not be found. entry point type = aa....aa, entry point name = bb....bb

定義で設定されたエントリポインタが共用ライブラリ内で見つかりませんでした。

aa....aa：エントリポインタ種別

当該エントリポインタ種別

PLG_STEN：開始終了プラグイン

PLG_BUILD：電文組立てプラグイン

PLG_INFO：電文情報プラグイン

PLG_EDIT：電文編集プラグイン

PLG_SEND：電文送信プラグイン

PLG_RECV：電文受信プラグイン

PLG_JUDGE：結果判定プラグイン

PLG_SELECT：電文選択プラグイン

UOC_PLG_BUILD：電文組立UOC

UOC_PLG_INFO：電文情報設定UOC

UOC_PLG_SEND：送信電文編集UOC

UOC_PLG_RECV：受信電文編集UOC

UOC_PLG_ACCU：蓄積編集UOC

UOC_PLG_RESTO：復元UOC

UOC_PLG_JUDGE：結果判定UOC

UOC_PLG_OPE：オペレーション名判定UOC

bb....bb：エントリポインタ名

当該エントリポインタ名

（S）

共用ライブラリのローディング処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

エントリポインタ種別一覧に従って対策してください。

エントリポインタ種別に出力された内容

見直し定義内容

PLG_STEN

framework_definition定義-pオプションstartend_entry_point

PLG_BUILD

framework_definition定義-pオプションbuild_entry_point

PLG_INFO

framework_definition定義-pオプションinformation_entry_point

PLG_EDIT

framework_definition定義-pオプションedit_entry_point

PLG_SEND

framework_definition定義-pオプションsend_entry_point

PLG_RECV

framework_definition定義-pオプションreceive_entry_point

PLG_JUDGE

framework_definition定義-pオプションjudge_entry_point

PLG_SELECT

framework_definition定義-pオプションselect_entry_point

UOC_PLG_BUILD

plugin_definition定義-uオプションuoc_build

UOC_PLG_INFO

plugin_definition定義-uオプションuoc_information

UOC_PLG_SEND

plugin_definition定義-uオプションuoc_send

UOC_PLG_RECV

plugin_definition定義-uオプションuoc_receive

UOC_PLG_ACCU

plugin_definition定義-uオプションuoc_accumulate

UOC_PLG_RESTO

plugin_definition定義-uオプションuoc_restore

UOC_PLG_JUDGE

plugin_definition定義-uオプションuoc_judgement

UOC_PLG_OPE

plugin_definition定義-uオプションuoc_operation

UOC_PLG_RTM

plugin_definition定義-uオプションuoc_rtm

KFSE61834-E　(Y) E+P+L (L) 1

ＳＳＬ用ライブラリのローディングに失敗しました。ライブラリ名＝aa…aa，詳細コード１＝bb…bb，詳細コード２＝cc…cc，詳細コード３＝dd…dd

Failed to load the SSL library. library name = aa…aa, detail code 1 = bb…bb, detail code 2 = cc…cc, detail code 3 = dd…dd

SSL用ライブラリのローディングに失敗しました。

aa…aa：ライブラリ名

ローディングに失敗したライブラリ名です。

bb…bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc…cc：：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd…dd：：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

SSLによる暗号化通信が必要な場合は、OpenSSLのバージョン1.0.1以降がインストールされている事を確認してください。Windowsの場合は、環境変数PATHに、「OpenSSLインストールディレクトリ¥bin」が指定されている事を確認してください。問題がなければ保守員に連絡してください。

SSLによる暗号化通信が不要な場合は、address_destinationコマンド形式定義の-tオプションのssl_useフラグメンバの設定値を見直してください。

KFSE61835-E　(Y) E+P+L (L) 1

ライブラリのローディングに失敗しました。種別＝aa…aa，ライブラリ名＝bb…bb，詳細コード１＝cc…cc，詳細コード２＝dd…dd，詳細コード３＝ee…ee

Failed to load the library. type = aa…aa, library name = bb…bb, detail code 1 = cc…cc, detail code 2 = dd…dd, detail code 3 = ee…ee

ライブラリのローディングに失敗しました。

aa…aa：種別

ローディングに失敗したライブラリ種別です。

bb…bb：ライブラリ名

ローディングに失敗したライブラリ名です。

cc…cc：：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd…dd：：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

ee…ee：：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

ライブラリ種別に応じて、次の対策をしてください。

ライブラリ種別

対策

FRW_ZLIB

Windowsの場合は、環境変数PATHに「zlibライブラリインストールディレクトリ」が指定されていることを確認してください。

Linuxの場合は、環境変数LD_LIBRARY_PATHに「zlibライブラリを格納しているディレクトリ」が指定されていることを確認してください。

環境変数の設定に問題がない場合は、保守員に連絡してください。

電文の解凍、および圧縮機能が不要な場合は、framework_definition定義の-uオプションのcompression_encodingフラグメンバの指定値を見直してください。

PLG_MCF_LIBXML2

Windowsの場合は、環境変数PATHに「libxml2.dllの格納されたディレクトリ」が指定されていることを確認してください。

Linuxの場合は、環境変数LD_LIBRARY_PATHに「libxml2.soの格納されたディレクトリ」が指定されていることを確認してください。

環境変数の設定に問題がない場合は、保守員に連絡してください。

KFSE61901-E　（Y）E（L）1

拡張SYSLOGライブラリルーチンのローディングに失敗しました。ライブラリ名＝aa....aa，理由コード＝bb....bb，詳細コード１＝cc....cc，詳細コード２＝dd....dd

An attempt to load the library routine failed. library name = aa....aa, reason code = bb....bb, detail code 1 = cc....cc, detail code 2 = dd....dd

拡張SYSLOGライブラリルーチンのローディングに失敗しました。

aa....aa：ローディングに失敗した拡張SYSLOGライブラリ名

bbbb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コードに応じた対処を行ってください。

理由

コード

意味

対策

0001

拡張SYSLOGライブラリのオープン失敗

拡張SYSLOGがインストールされているか確認して下さい。

直前にKFSE40107-Eが出力されていれば、エラーコード、およびダイナミックローディングモジュールのシステムコールがエラーリターンした場合のエラー内容を参照して原因を取り除いてください。メッセージが出力されていなければ、保守員に連絡してください。

0002

拡張SYSLOGライブラリルーチンのアドレス取得失敗

直前にKFSE40107-Eが出力されていれば、エラーコード、およびダイナミックローディングモジュールのシステムコールがエラーリターンした場合のエラー内容を参照して原因を取り除いてください。メッセージが出力されていなければ、保守員に連絡してください。

0003

拡張SYSLOG v02-00以降がインストールされているか確認して下さい。

直前にKFSE40107-Eが出力されていれば、エラーコード、およびダイナミックローディングモジュールのシステムコールがエラーリターンした場合のエラー内容を参照して原因を取り除いてください。メッセージが出力されていなければ、保守員に連絡してください。

KFSE63301-E　（Y）E+P+L（L）1

内部矛盾が発生しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，保守情報１＝dd....dd，保守情報２＝ee....ee

An internal conflict has occurred. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, maintenance information 1 = dd....dd, maintenance information 2 = ee....ee

内部矛盾が発生しました。

aa....aa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE63302-E　（Y）E+P+L（L）1

受信スレッドの処理中に障害が発生しました。理由コード＝aa....aa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred during processing of a received thread. reason code = aa....aa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

処理中に回復不可能な障害が発生しましたので、プロセスを終了します。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

登録できるファイルディスクリプタの総数の上限を超えています。

カーネルパラメタ「fs.epoll.max_user_watches」を見直してください。設定値に問題がない場合は、保守員に連絡してください。

0003

0021

コネクション確立要求の受付に失敗しました。

OSのファイルディスクリプタ数を見直してください。設定値に問題がない場合は、保守員に連絡してください。

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE63303-E　（Y）E+P+L（L）1

受信スレッドの初期化処理に失敗しました。理由コード＝aa....aa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred during initialization processing of a received thread. reason code = aa....aa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

初期化処理中に回復不可能な障害が発生しましたので、プロセスを終了します。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0021

ファイルディスクリプタ数が不足しました。

OSのファイルディスクリプタ数を見直してください。設定値に問題がない場合は、保守員に連絡してください。

0022

登録できるファイルディスクリプタの総数の上限を超えています。

カーネルパラメタ「fs.epoll.max_user_watches」を見直してください。設定値に問題がない場合は、保守員に連絡してください。

0023

領域確保に失敗しました。

OS全体のメモリ使用状況を確認してください。

0031

サーバ型コネクション受付処理に失敗しました。

本メッセージの前に出力されているKFSE43301-Wメッセージに従って原因を取り除いてください。

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE63304-E　（Y）E（L）1

ＩＰＣの初期化処理に失敗しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，保守情報１＝dd....dd，保守情報２＝ee....ee

Failed to format the IPC. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, maintenance information 1 = dd....dd, maintenance information 2 = ee....ee

IPCの初期化処理で障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

領域確保に失敗しました。

OS全体のメモリ使用状況を確認してください。

0002

0003

0004

0100

SSL通信の準備に失敗しました。

保守員に連絡してください。

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE63305-E　（Y）E+P+L（L）1

ＩＰＣの処理中に致命的な障害が発生しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，保守情報１＝dd....dd，保守情報２＝ee....ee

A fatal error occurred during IPC processing. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, maintenance information 1 = dd....dd, maintenance information 2 = ee....ee

IPCの処理中に致命的な障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

領域確保に失敗しました。

OS全体のメモリ使用状況を確認してください。

0002

0003

0005

UDPソケットの作成に失敗しました。

直前にメッセージが出力されている場合はそのメッセージに従って原因を取り除いてください。出力されていない場合は保守員に連絡してください。

上記以外

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE63306-E　（Y）E+P+L（L）1

キャプチャスレッドの初期化処理に失敗しました。理由コード＝aa....aa，詳細コード＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd

An error occurred during initialization processing of a capture thread. reason code = aa....aa, detail code = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd

初期化処理中に回復不可能な障害が発生しましたので、プロセスを終了します。

aa....aa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE63401-E　（Y）E+P+L（L）1

実行中のシステム検証支援基盤で内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An internal conflict occurred in the running SIC. detail code 1 = aa....aa, detail code 2 = bb....bb

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE63402-E　（Y）E+P+L（L）1

領域不足のためテーブル作成に失敗しました。テーブル名＝aa....aa

An attempt to create a table has failed due to insufficient space. table name = aa....aa

システム検証支援基盤プロセスの初期化処理において、領域不足のためテーブル作成に失敗しました。

aa....aa：テーブル種別

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE63403-E　（Y）E+P+L（L）1

コネクションの確立待ちがタイムアウトしました。ＩＰアドレス＝aa....aa，ポート番号＝bb....bb

A timeout was detected during the connection wait. IP address = aa....aa, port number = bb....bb

テスト開始前にサーバ型コネクションのコネクション確立が、一定時間内に確認できませんでした。

aa....aa：自IPアドレス

コネクションの確立待ちがタイムアウトしたIPアドレスです。

bb....bb：自ポート番号

コネクションの確立待ちがタイムアウトしたポート番号です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

システム検証支援基盤を再起動し、テスト対象システムからコネクションを確立してください。当メッセージで出力したIPアドレスとポート番号をテストで使用しない場合は、このIPアドレスとポート番号を-hオプションで指定しているaddress_destination定義を削除してください。

KFSE63501-E　（Y）E+P+L（L）1

メモリ不足が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

Lack of memory occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

メモリ不足が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE63599-E　（Y）E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE63901-E　（Y）E+P+L（L）1

メモリ不足が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

Lack of memory occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

メモリ不足が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE63902-E　（Y）E+P+L（L）1

パケットを蓄積したファイルから解析できないパケットを検知しました。

A packet that cannot be parsed was detected in file that stores packets.

パケットキャプチャして蓄積したファイルのパケット解析中に、OracleのTNS電文として解析できないパケットを検知しました。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

以下の環境を確認してください。

パケットキャプチャ時の環境が、SQLリプロダクションが適応する環境か確認してください。適応していない環境の場合は、適応する環境を準備してパケットの蓄積をしなおしてください。

パケットキャプチャ時にType2JDBCドライバを使用しているか確認し、tns_definitionの-bオプションtype2_JDBC_use指定値を見直してください。

適応する環境でこのメッセージが出力された環境に問題ない場合は、システム管理者に連絡してください。

このメッセージが出力されると、以下のディレクトリにトラブルシュート情報が出力されます。出力されるファイルは単調増加ファイルです。保守員への連絡が不要な場合は、ファイルを削除してください。

/opt/HSIC/job/KKK/spool/dceeinf/packet/

KKKはテスト識別子

［対策］

適応する環境でこのメッセージが出力された場合は、保守員に連絡してください。

KFSE63903-E　（Y）E+P+L（L）1

パケットを蓄積したファイルからパケットロストを検知しました。

A lost packet was detected in a file that stores packets.

パケットキャプチャして蓄積したファイルのパケット解析中に、パケットロストを検知しました。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

パケットの蓄積をしなおしてください。

［対策］

なし。

KFSE63904-E　（Y）E+P+L（L）1

パケットを蓄積したファイルにSQLがありませんでした。

No SQL statement exists in the file that stores packets.

蓄積したファイルにSQLがありませんでした。原因としていかのどれかが考えられます。

capture_network_interface -iオプションに設定したディレクトリに格納したPCAPファイルが、誤っている。

address_destinationの-cオプションに指定したOracleClientのIPアドレスが誤っている。

address_destinationの-sオプションに指定したOracleDatabaseのIPアドレス、またはポート番号が誤っている。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

原因を取り除いて再実行してください。

［対策］

なし。

KFSE63905-E　（Y）E+P+L（L）1

リスニングポートのオープンに失敗しました。自ＩＰアドレス＝aa....aa，自ポート番号＝bb....bb，詳細コード＝cc....cc

Failed to open the listening port. local IP address = aa....aa, local port number = bb....bb, detail code = cc....cc

リスニングポートのオープンに失敗しました。

aa....aa：自IPアドレス

address_destinationの-lオプションipaddrに指定したIPアドレスを表示します。指定を省略している場合は、0.0.0.0で出力します。

bb....bb：自ポート番号

address_destinationの-lオプションのportnoに指定したシステム検証支援基盤のリスニングポートの番号を出力します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

出力したリスニングポートの番号に他のプロセスが使用していないポート番号を指定して再実行してください。他のプロセスが使用していないポート番号を指定している場合にこのメッセージが出力された場合は、システム管理者に連絡してください。

［対策］

このメッセージの前に出力されているKFSE43301-Wを参照して対策してください。

KFSE63999-E　（Y）E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE64001-E　（Y）E+P+L（L）1

内部矛盾が発生しました。理由コード＝aa....aa，保守情報１＝bb....bb，保守情報２＝cc....cc，保守情報３＝dd....dd，保守情報４＝ee....ee

An internal conflict has occurred. reason code = aa....aa, maintenance information 1 = bb....bb, maintenance information 2 = cc....cc, maintenance information 3 = dd....dd, maintenance information 4 = ee....ee

フレームワーク機能で内部矛盾が発生しました。

aa....aa：理由コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報3

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報4

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE64002-E　（Y）E+P+L（L）1

処理中に致命的な障害が発生しました。理由コード＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，保守情報１＝dd....dd，保守情報２＝ee....ee

A fatal error occurred during processing. reason code = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, maintenance information 1 = dd....dd, maintenance information 2 = ee....ee

フレームワーク機能の処理中に致命的な障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

0001

0021

0031

0211

メモリの確保に失敗しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE64101-E　（Y）E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

関数発行時に、内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE64102-E　（Y）E+P+L（L）1

ファイルのオープンに失敗しました。ファイル名＝aa....aa

Opening of the file failed. file name = aa....aa

CSVファイルのオープンができませんでした。

aa....aa：ファイル名の絶対パス

esstartコマンドの引数に指定したファイル格納ディレクトリ名、ファイル名が表示されます。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

ファイルの障害を取り除き、再実行してください。

障害の要因と考えられる事象

設定されたファイルが存在しない

ファイル障害が発生

ディスク障害が発生

設定されたパスが不正

設定されたファイルに対するアクセス権限が不正

リソース不足

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE64103-E　（Y）E+P+L（L）1

領域確保に失敗しました。対象領域＝aa....aa，領域サイズ＝bb....bbバイト，詳細コード＝cc....cc

Failed to allocate an area. target area = aa....aa, area size = bb....bb bytes

領域の確保に失敗しました。

aa....aa：システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：確保に失敗した領域のサイズ

cc....cc：システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

必要なメモリを確保しシステム検証支援基盤を再起動してください。

KFSE64104-E　（Y）E+P+L（L）1

CSV解析処理中にエラーが発生しました。記述形式が不正です。ファイル名＝aa....aa，ファイル種別＝bb....bb，行数＝cc....cc，列数＝dd....dd，項目名＝ee....ee，理由コード＝ff....ff

An error occurred during CSV analysis. The CSV format is incorrect. file name = aa....aa, file type = bb....bb, line = cc....cc, column = dd....dd, item name = ee....ee, reason code = ff....ff

CSV形式が不正です。

aa....aa：ファイル名の絶対パス

bb....bb：CSVファイル種別

OPE：オペレーション情報ファイル

VAR：変数情報ファイル

SCE：シナリオファイル

cc....cc：不正があった行の行数

dd....dd：不正があった列の列数

特定の列に関わらない場合は0列を表示します。

ee....ee：項目名

項目名に関係の無い場合は「**」を表示します。

ff....ff：理由コード

LINEOVER：CSVファイルの1行のバイト数が規定の範囲（10Mバイト）を超えています。

DIVIDEOVER：CSVファイルの1行の項目数が規定の範囲を超えています。

LACK：CSVファイルの1行の項目数が不足しています。

FORMAT：記述形式が不正です。

DUPLICATE：すでに記述されています。

PLACE：記述箇所が不正です。

VALUE：不正な値または不正な文字列です。

OVER：項目の文字数またはバイト数が規定の範囲を超えています。または、項目内のセミコロン区切りの数が規定の範囲（64個）を超えています。

（S）

CSV解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

CSVファイル中のcc....cc行目のdd....dd列目の記述を、理由コードに従って見直し、対策後システム検証支援基盤を再起動してください。

KFSE64105-E　（Y）E+P+L（L）1

CSV解析中にエラーが発生しました。省略できない項目が記述されていません。ファイル名＝aa....aa，ファイル種別＝bb....bb，行数＝cc....cc，列数＝dd....dd，項目名＝ee....ee

An error occurred during CSV analysis. A mandatory item is incorrect. file name = aa....aa, file type = bb....bb, line = cc....cc, column = dd....dd, item name = ee....ee

省略できない項目が記述されていません。

aa....aa：ファイル名の絶対パス

bb....bb：CSVファイル種別

OPE：オペレーション情報ファイル

VAR：変数情報ファイル

SCE：テスト用の要求電文蓄積ファイル

cc....cc：不正があった行の行数

特定の行に関わらない場合は0行を表示します。

dd....dd：不正があった列の列数

特定の列に関わらない場合は0列を表示します。

ee....ee：項目名

項目名に関係の無い場合は「**」を表示します。

（S）

CSV解析を中止しプロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

記述内容を見直し、cc....cc行目のdd....dd列目の記述内容を見直し、再起動してください。またはee....eeに示された項目を追加して再起動してください。

KFSE64106-E　（Y）E+P+L（L）1

CSV解析処理においてエラーが発生しました。項目間に不正があります。ファイル名＝aa....aa，ファイル種別＝bb....bb，行数＝cc....cc，列数＝dd....dd，項目名＝ee....ee，理由コード＝ff....ff

An error occurred in CSV analysis processing. An invalid value is specified in the CSV. file name = aa....aa, file type = bb....bb, line = cc....cc, column = dd....dd, item name = ee....ee, reason code = ff....ff

CSVファイルの項目が不正です。項目間に不正があります。

aa....aa：ファイル名の絶対パス

bb....bb：CSVファイル種別

OPE：オペレーション情報ファイル

VAR：変数情報ファイル

SCE：テスト用の要求電文蓄積ファイル

cc....cc：不正があった行の行数

特定の行に関わらない場合は0行を表示します。

dd....dd：不正があった列の列数

特定の列に関わらない場合は0列を表示します。

ee....ee：項目名

項目名に関係の無い場合は「**」を表示します。

複数の項目が関わる場合は、以下の形式でセクション名、項目名を表示します。

「(セクション名/項目名):(セクション名/項目名):…」

（例）項目名＝(<take_over>/SESSIONID):(<telegram_convert>/SESSIONID)

ff....ff：理由コード

DUPLICATE：すでに定義されています。

NOTHING：先に定義すべき項目がありません。

（S）

定義解析を中止しプロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

CSVファイルのcc....cc行目のdd....dd列目の記述を見直し再起動してください。

KFSE64107-E　（Y）E+P+L（L）1

CSV解析処理中にCSVファイルの読込みに失敗しました。ファイル名＝aa....aa，行数＝bb....bb

Loading of the CSV file failed during CSV analysis. file name = aa....aa, line = bb....bb

CSVファイルのbb....bb行目読込みの際にファイルエラーが発生しました。

aa....aa：ファイル名の絶対パス

bb....bb：読込みに失敗した行の行数

（S）

CSV解析処理を中止しシステム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

CSVファイルの障害を取り除き、再実行してください。

障害の要因と考えられる事象

ファイル障害が発生

ディスク障害が発生

設定されたファイルに対するアクセス権限が不正

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE64108-E　（Y）E+P+L（L）1

HSIC - Custom Option用ライブラリのローディングに失敗しました。理由コード＝aa....aa，詳細コード＝bb....bb

Failed to load the HSIC - Custom Option library. reason code = aa....aa, detail code = bb....bb

Hitachi System Information Capture - Custom Option用ライブラリのローディングで障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

このメッセージの直前にほかのメッセージが出力されていれば、そのメッセージに従って原因を取り除いてください。ほかのメッセージが出力されていなければ、理由コード一覧を見て対策してください。

理由コード

意味

対策

VERSION

システム検証支援基盤のバージョンが不正です。

システム検証支援基盤のバージョンを確認してください。

KFSE64110-E　(Y) E+P+L (L) 1

プラグインでエラーが発生しました。理由コード＝aa…aa，ファイル名＝bb…bb，詳細コード１＝cc…cc，詳細コード２＝dd…dd

A plugin error occurred. reason code = aa…aa, file name = bb…bb, detail code 1 = cc…cc, detail code 2 = dd…dd

プラグインでエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：ファイル名

エラー契機となったファイル名を表示します。

表示すべき情報が無い場合は"**"を表示します。

cc…cc：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

dd…dd：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者へ連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

シナリオファイル未指定

framework_definition定義-f オプションのuser_fileオペランド設定値を見直してください。

0007

0002

ファイル種別が不正

表示されたファイル名のファイル種別に問題がないか確認してください。

0003

開始終了プラグイン未実行

framework_definition定義-p オプションのstartend_entry_pointオペランド設定値を見直してください。

0004

引継ぎ領域のサイズが不十分

framework_definition定義-bオプションの次のオペランドの設定値を見直してください。

telegram_area_sizeオペランド

connection_area_sizeオペランド

client_area_sizeオペランド

0005

必須定義が指定されていない

esstartコマンド実行時に-mオプションが指定されているか確認してください。また、定義内容を見直して、当該プラグインで必須となる定義の設定値に問題がないか確認してください。

0006

ファイルアクセス失敗

表示されたファイルの有無、およびアクセス権に問題がないか確認してください。

0008

プロトコル種別不一致

framework_definition定義-p オプションの各エントリポインタ名の設定値を見直してください。

9999

内部矛盾が発生

保守員に連絡してください。

KFSE64401-E　（Y）E+P+L（L）1

領域確保に失敗しました。対象領域コード＝aa....aa，要求サイズ＝bb....bb，詳細コード１＝ccccc，詳細コード２＝dd....dd

Failed to allocate an area. target area code = aa....aa, request size = bb....bb, detail code 1 = ccccc, detail code 2 = dd....dd

領域確保に失敗しました。

aa....aa：対象領域コード

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：要求サイズ（10進表記）

不足サイズが表示されます。（単位：バイト）

ccccc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

KFSE64403-E　（Y）E+P+L（L）1

ソケットの初期化に失敗しました。ネットワークインタフェース名＝aa....aa，理由コード＝bbbbb，詳細コード＝cc....cc

Failed to initialize the socket. network interface name = aa....aa, reason code = bbbbb, detail code = cc....cc

ソケットの初期化に失敗しました。

aa....aa：ネットワークインタフェース名

bbbbb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

00001

RAWソケットを作成する権限がありません。

root権限で再実行もしくは、CAP_NET_RAWケーパビリティを追加して再実行してくだい。

00012

メモリ不足が発生しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

00023

オープンできるソケット数を超えました。

プロセスもしくは、システムで設定できるソケット数を拡張してください。

00024

00105

メモリ不足が発生しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

その他

上記以外のエラーが発生しました。

保守員に連絡してください。

KFSE64404-E　（Y）E+P+L（L）1

ネットワークインタフェースが存在しません。ネットワークインタフェース名＝aa....aa

The network interface does not exist. network interface name = aa....aa

ネットワークインタフェースが存在しません。

aa....aa：ネットワークインタフェース名

（S）

処理を中止します。

（O）

パケットキャプチャ関連定義のcapture_network_interfaceのnameオペランドを指定している場合は、指定したネットワークインタフェースが存在するか確認してください。

パケットキャプチャ関連定義のcapture_network_interfaceのnameオペランドを省略している場合は、ネットワークインタフェース（eth0）が存在するか確認してください。

パケットキャプチャ関連定義のcapture_network_interface定義を省略した場合は、実行形態が正しいか確認してください。実行形態が正しい場合は、ネットワークインタフェース（eth0）が存在するか確認してください。

［対策］

パケットキャプチャ関連定義のcapture_network_interfaceに指定したネットワークインタフェース名を修正する、もしくは、実行形態を変更して再実行してください。

KFSE64407-E　（Y）E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE64409-E　（Y）E+P+L（L）1

キャプチャスレッドの処理中に障害が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb

An error occurred while processing a capture thread. detail code 1 = aa....aa, detail code 2 = bb....bb

パケットキャプチャ処理中に障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE64412-E　（Y）E+P+L（L）1

pcap形式ファイル読込み機能で障害が発生しました。理由コード＝aa....aa，ディレクトリ／ファイル名＝bb....bb，詳細コード１＝cc....cc，詳細コード２＝dd....dd，保守情報＝ee....ee

An error occurred in function of pcap file reading. reason code = aa....aa, directory/file name = bb....bb, detail code 1 = cc....cc, detail code 2 = dd....dd, maintenance information = ee....ee

pcap形式ファイル読込み機能で障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：ディレクトリ／ファイル名

障害が発生したディレクトリ名またはファイル名

cc....cc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

1001

ディレクトリのオープンに失敗しました。

capture_network_interfaceオペランドの-iオプションのpcapdirで指定したpcap形式ファイル格納ディレクトリのパスが正しいか見直しください。pcap形式ファイル格納ディレクトリが無い場合は、ディレクトリを作成してpcapファイルを格納してください。

1002

1003

ファイルのアクセスに失敗しました。

capture_network_interfaceオペランドの-iオプションのpcapdirで指定したpcap形式ファイル格納ディレクトリのパスが正しいか見直してください。

1101

システム検証支援基盤稼働中にpcap形式ファイルが削除された為、ファイルのアクセスに失敗しました。

pcap形式ファイルを不当に削除していないか確認してください。

1102

2101

pcap形式ファイルが壊れています。

正しいpcap形式ファイルを指定してください。

2102

2103

pcap形式ファイル内のパケットキャプチャ時刻がテスト対象範囲外です。

マシン時刻が不当な環境下でpcap形式ファイルを作成していた場合は、マシン時刻を正しく設定してpcap形式ファイルを作成しなおしてください。

2105

pcap形式ファイルが壊れています。

正しいpcap形式ファイルを指定してください。

3001

ディスクリプタ不足が発生しました。

OSのファイルディスクリプタ数を見直してください。設定値に問題がない場合は、保守員に連絡してください。

3002

メモリ不足が発生しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

3003

ファイルの読込みに失敗しました。

ファイルシステムに異常がないかを確認してください。

4001

メモリ不足が発生しました。

物理メモリの増設、ページングスペースサイズ拡張、もしくは不要なプログラムを終了してください。

4002

上記以外

予期しないエラーが発生しました。

保守員に連絡してください。

KFSE65001-E　（Y）E+P+L（L）1

コマンド制御でエラーが発生したため，システム検証支援基盤を続行することができません。理由コード＝aa....aa，詳細コード＝bb....bb

The SIC cannot continue operation because a command control error occurred. reason code = aa....aa, detail code = bb....bb

システム検証支援基盤プロセスの起動処理において、処理続行不能なエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

以下に示す理由コード一覧に従って対策してください。

理由コード

意味

対策

1

コマンド制御で使用するポートを割り当てることができません。

しばらくしてからシステム検証支援基盤を起動してください。

2

コマンド制御が使用するファイルの作成でエラーが発生しました。

システム検証支援基盤のセットアップディレクトリ下のディスクスペースに空きがあるかどうか確認してください。

3

その他のエラー

保守員に連絡してください。

KFSE65102-E　（Y）E（L）1

領域不足のためテーブル作成に失敗しました。テーブル名＝aa....aa

An attempt to create a table has failed due to insufficient space. table name = aa....aa

システム検証支援基盤プロセスの初期化処理において、領域不足のためテーブル作成に失敗しました。

aa....aa：テーブル名

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE65103-E　（Y）E（L）1

テーブル初期化に失敗しました。詳細コード＝aa....aa

An attempt to initialize tables has failed. detail code = aa....aa

システム検証支援基盤プロセスの初期化処理において、テーブル初期化に失敗しました。

aa....aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

初期化処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

本メッセージの前にKFSEメッセージが出力されますので、そのメッセージを参照し、システム検証支援基盤の定義の見直しを行ってください。

KFSE65105-E　（Y）P＋L（L）1

メモリ破壊を検知しました。

Corrupted memory was detected.

システム検証支援基盤のメモリ領域においてメモリ破壊を検知しました。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE65190-E　（Y）E、E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb....bb，詳細コード３＝cc....cc

An internal conflict has occurred. detail code 1 = aa....aa, detail code 2 = bb....bb, detail code 3 = cc....cc

関数発行時に、内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE65305-E　（Y）E+P+L（L）1

メインスレッドの初期化中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during initialization processing of the main thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

メインスレッドの初期化中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65306-E　（Y）E+P+L（L）1

メインスレッドの終了中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during termination processing of the main thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

メインスレッドの終了中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65310-E　（Y）E+P+L（L）1

モニタスレッドの初期化中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during initialization processing of a monitor thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

モニタスレッドの初期化中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65311-E　（Y）E+P+L（L）1

モニタスレッドの処理中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during processing of a monitor thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

モニタスレッドの処理中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65315-E　（Y）E+P+L（L）1

処理スレッドの初期化中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during initialization processing of a processing thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

処理スレッドの初期化中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65316-E　（Y）E+P+L（L）1

処理スレッドの処理中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during processing of a processing thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

処理スレッドの処理中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65320-E　（Y）E+P+L（L）1

シグナルスレッドの初期化中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during initialization processing of a signal thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

シグナルスレッドの初期化中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65321-E　（Y）E+P+L（L）1

シグナルスレッドの処理中に致命的な障害が発生しました。詳細コード１＝aaaaaaaa，詳細コード２＝bbbbbbbb

A fatal error has occurred during processing of a signal thread. detail code 1 = aaaaaaaa, detail code 2 = bbbbbbbb

シグナルスレッドの処理中に致命的な障害が発生しました。

aaaaaaaa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bbbbbbbb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65330-E　（Y）E+P+L（L）1

システム検証支援基盤プロセス内の時刻が，制御可能な上限値を超過しました。

The time in a SIC process has exceeded the system's upper limit.

システム検証支援基盤プロセス内の時刻が、制御可能な上限値（0xfffffffe）を超過しました。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

マシン時刻が不正な場合は時刻を修正してください。正しい場合は保守員に連絡してください。

KFSE65380-E　（Y）E+P+L（L）1

継続不可の障害が発生した為，システム検証支援基盤プロセスを強制停止します。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb，ＩＦＡ番号＝cc....cc，エラー要因コード＝dd....dd，中央処理通番＝eeeeeeee，処理種別＝ff，クライアント識別子＝gg....gg，詳細コード１＝hh....hh

A SIC process will now be forcibly terminated because an error preventing the SIC process from continuing has occurred. test ID = aa....aa, run ID = bbbbbbbb, IFA number = cc....cc, error reason code = dd....dd, central processing number = eeeeeeee, process type = ff, client ID = gg....gg, detail code 1 = hh....hh

継続不可の障害が発生した為、システム検証支援基盤プロセスを強制停止します。

aa....aa：テスト識別子

bbbbbbbb：ランID

ランIDがまだ決定されていない場合は「00000000」が表示されます。

cc....cc：IFA番号

障害の発生したスレッドのIFA番号を表示します。

IFA作成前、もしくはIFAを特定できない場合は「0」を表示します。

dd....dd：エラー要因コード

システム検証支援基盤がトラブルシュートで使用する情報です。

eeeeeeee：中央処理通番

エントリ中央処理通番が表示されます。

処理種別が「**」の場合は「00000000」が表示されます。

ff：処理種別

処理種別は「11.1.3　メッセージに出力される処理種別」を参照してください。

gg....gg：クライアント識別子

クライアント識別子の内容を16進数で表示します。

hh....hh：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65385-E　（Y）E（L）1

シグナルが発生した為，システム検証支援基盤プロセスを強制停止します。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb，ＩＦＡ番号＝cc....cc，シグナル番号＝dd....dd，中央処理通番＝eeeeeeee，処理種別＝ff，クライアント識別子＝gg....gg，ＵＯＣ種別＝hh....hh，詳細コード１＝ii....ii

A SIC process will now be forcibly terminated because a signal has occurred. test ID = aa....aa, run ID = bbbbbbbb, IFA number = cc....cc, signal number = dd....dd, central processing number = eeeeeeee, process type = ff, client ID = gg....gg, UOC type = hh....hh, detail code 1 = ii....ii

継続不可の障害が発生した為、システム検証支援基盤プロセスを強制停止します。

aa....aa：テスト識別子

bbbbbbbb：ランID

ランIDがまだ決定されていない場合は「00000000」が表示されます。

cc....cc：IFA番号（10進数表記）

障害の発生したスレッドのIFA番号を表示します。

IFA作成前、もしくはIFAを特定できない場合は「0」を表示します。

dd....dd：シグナル番号（10進数表記）

捕捉したシグナルの番号です。「12」が表示された場合、タイムアウトが原因です。

eeeeeeee：中央処理通番

エントリ中央処理通番が表示されます。

処理種別が「**」の場合は「00000000」が表示されます。

ff：処理種別

処理種別は「11.1.3　メッセージに出力される処理種別」を参照してください。

処理種別が特定できない場合は「**」が表示されます。

gg....gg：クライアント識別子

クライアント識別子の内容を16進数で表示します。

hh....hh：UOC種別

障害が発生したUOC種別を表示します。

UOC実行中の障害でない場合は「＊」が表示されます。

ii....ii：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

本メッセージの前にKFSE55313-Eメッセージが出力されている場合は、そのメッセージに従って対策してください。UOC種別に「＊」以外が表示されている場合は、下表に示すUOCを見直してください。UOCに問題が無い、もしくはUOC実行中以外の場合は、保守員に連絡してください。

UOC種別

見直し定義内容

UOC_STEN

UOC関連定義のuoc_func_com 定義-sオプション

UOC_IND

UOC関連定義のuoc_func_rpc 定義-iオプション

UOC_STR

UOC関連定義のuoc_func_rpc 定義-aオプション

UOC_SND

UOC関連定義のuoc_func_rpc 定義-sオプション

UOC_CMP

UOC関連定義のuoc_func_rpc 定義-cオプション

UOC_JDG

UOC関連定義のuoc_func_rpc 定義-jオプション

UOC_AMP

UOC関連定義のuoc_func_rpc 定義-tオプション

UOC_RECV

UOCＣ関連定義のuoc_func_rpc 定義-rオプション

KFSE65387-E　（Y）E（L）1

システム検証支援基盤プロセスのハングアップを検出した為，システム検証支援基盤プロセスを強制停止します。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb，詳細コード１＝cc....cc，詳細コード２＝dd....dd

A SIC process will now be forcibly terminated because a hung SIC process was detected. test ID = aa....aa, run ID = bbbbbbbb, detail code 1 = cc....cc, detail code 2 = dd....dd

継続不可の障害が発生した為、システム検証支援基盤プロセスを強制停止します。

aa....aa：テスト識別子

bbbbbbbb：ランID

ランIDがまだ決定されていない場合は「00000000」が表示されます。

cc....cc：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

マシン内の負荷（CPU、ファイルI/O等）が増加した事によりシステム検証支援基盤プロセスの処理が遅延し、本現象が発生した可能性があります。

マシン高負荷時は、マシン高負荷の原因を取り除いてください。

解決できない場合は、保守員に連絡してください。

KFSE65400-E　（Y）E+P+L（L）1

トラブルシュート機能初期化処理に障害が発生しました。詳細コード＝aa

Failure occurred for initialization processing for the troubleshooting function. detail code = aa

トラブルシュート機能初期化処理に障害が発生したため、システム検証支援基盤を終了します。

aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65401-E　（Y）E+P+L（L）1

トラブルシュート機能終了処理に障害が発生しました。詳細コード＝aa

Failure occurred for termination processing for the troubleshooting function. detail code = aa

トラブルシュート機能終了処理に障害が発生しました。

aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65402-E　（Y）E+P+L（L）1

トラブルシュート情報出力処理に障害が発生しました。詳細コード＝aa

Failure occurred for output processing for troubleshooting information. detail code = aa

トラブルシュート情報出力処理に障害が発生しました。

aa：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。出力されていない場合は、保守員に連絡してください。

KFSE65403-E　（Y）E+P+L（L）1

内部矛盾が発生しました。詳細コード１＝aa....aa，詳細コード２＝bb

An internal conflict occurred. detail code 1 = aa....aa, detail code 2 = bb

内部矛盾が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE65404-E　（Y）E（L）1

定義解析処理中にエラーが発生しました。理由コード１＝aa....aa，詳細コード＝bb....bb

An error occurred during definition analysis processing. reason code = aa....aa, detail code = bb....bb

トラブルシュート関連定義の定義解析時にエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

1

tasktm_informationの-f fileszと-b blockszの大小関係が不正です。

tasktm_informationの-f fileszと-b blockszの設定値を見直し、再起動して下さい。

5

statistical_informationの-f fileszと-b blockszの大小関係が不正です。

statistical_informationの-f fileszと-b blockszの設定値を見直し、再起動してください

KFSE65405-E　（Y）E+P+L（L）1

モジュールトレースファイル作成時に障害が発生しました。ファイル名＝aa....aa，理由コード＝bb....bb

An error occurred while creating a module trace file. file name = aa....aa, reason code = bb....bb

モジュールトレースファイル作成時に障害が発生しました。

aa....aa：ファイル名

障害の発生したファイル名です。

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

CREATE

ファイル作成失敗

ファイル名で表示するファイルと、以下のディレクトリのアクセス権限を確認してください。

/opt/HSIC/job/****/spool/dceeinf/mdl

****はテスト識別子です。

DELETE

ファイル削除失敗

READ

ファイルREAD失敗

OPEN

ファイルOPEN失敗

ENSURE

ファイル確保失敗

ディスクの空き容量を確認してください。

MMAP

mmap失敗

ディスクの空き容量およびOSのメモリを確認してください。

HEAD

ファイルヘッダ不正（モジュールトレースファイルではない）

ファイル名で表示するファイルを削除するか、ファイル名を変更してください。

ファイルのディレクトリは、以下です。

/opt/HSIC/job/****/spool/dceeinf/mdl

****はテスト識別子です。

KFSE65406-E　（Y）E+P+L（L）1

モジュールトレースファイル作成時に障害が発生しました。理由コード＝aa....aa

An error occurred while creating a module trace file. reason code = aa....aa

モジュールトレースファイル作成時に障害が発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

システム検証支援基盤プロセスを強制停止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由

コード

意味

対策

DIR

ディレクトリ作成失敗

以下のディレクトリのアクセス権限を確認してください。

/opt/HSIC/job/****/spool/dceeinf

****はテスト識別子です。

11.5　KFSE80001からKFSE89999までのメッセージ

KFSE80001-I　（Y）S+P+L（L）1

システム検証支援基盤の初期化処理を開始します。

SIC initialization will start.

システム検証支援基盤プロセスの初期化処理を開始します。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80003-I　（Y）S+P+L（L）1

システム検証支援基盤を開始します。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb

SIC will start. test ID = aa....aa, run ID = bbbbbbbb

システム検証支援基盤プロセスの初期化処理が完了し、システム検証支援基盤を開始します。

aa....aa：テスト識別子

bbbbbbbb：ランID

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80021-I　（Y）S+P+L（L）2

システム検証支援基盤の終了処理を開始します。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb，終了モード＝cc....cc

SIC termination will start. test ID = aa....aa, run ID = bbbbbbbb, termination mode = cc....cc

システム検証支援基盤プロセスの終了処理を開始します。

aa....aa：テスト識別子

bbbbbbbb：ランID

cc....cc：終了モード

NORMAL：正常終了

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80022-I　（Y）S+P+L（L）1

システム検証支援基盤の終了処理が完了しました。テスト識別子＝aa....aa，ランＩＤ＝bbbbbbbb

SIC termination was completed. test ID = aa....aa, run ID = bbbbbbbb

システム検証支援基盤プロセスの終了処理が完了しました。

aa....aa：テスト識別子

bbbbbbbb：ランID

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80801-I　（Y）S+P+L（L）5

電文が滞留しています。電文件数＝aa....aa

There are messages remaining. number of messages = aa....aa

電文が滞留しているため、滞留している電文が全て決着するまでシステム検証支援基盤のプロセスは終了しません。

aa....aa：電文件数

0が設定されても、応答電文待合わせ等によりプロセスが終了しない場合があります。

（S）

処理を続行します。

（O）

しばらく待っても電文件数が0、または値が変わらない場合は、システム管理者に連絡してください。

［対策］

しばらく待っても電文件数が0、または値が変わらない場合は、応答電文の待ち合わせ処理等に時間がかかっている可能性があります。

プロセスを終了したい場合は、esstopコマンドに-fオプションを指定して実行してください。

KFSE80910-I　（Y）S+P+L（L）1

蓄積ファイル機能を開始しました。ファイル種別＝aa....aa，ファイル名＝bb....bb

Accumulation file function started. file type = aa....aa, file name = bb....bb

蓄積ファイル機能を開始しました。

aa....aa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：蓄積ファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80911-I　（Y）S+P+L（L）1

蓄積ファイルがスワップしました。ファイル種別＝aa....aa，スワップ元ファイル名＝bb....bb，スワップ先ファイル名＝cc....cc，スワップ要因＝dd....dd

Accumulation file was swapped. file type = aa....aa, swap source file name = bb....bb, swap destination file name = cc....cc, swap reason = dd....dd

蓄積ファイルがスワップしました。

aa....aa：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

bb....bb：スワップ元蓄積ファイル名

cc....cc：スワップ先蓄積ファイル名

dd....dd：スワップ要因

FULL：蓄積ファイルの満杯検知

ERR：障害スワップ

COMMAND：強制出力コマンド（esaflfput）

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80920-I　（Y）S+P+L（L）1

フレームワーク用出力ファイルを決定しました。ファイル種別＝aaa，ファイル名＝bb....bb

Output file for framework function decided. file type = aaa, file name = bb....bb

フレームワーク用出力ファイルを決定しました。

aaa：フレームワーク用出力ファイル種別

TEL：電文ファイル

RES：結果ファイル

bb....bb：フレームワーク用出力ファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80921-I　（Y）S+P+L（L）1

フレームワーク用出力ファイルがスワップしました。ファイル種別＝aaa，スワップ元ファイル名＝bb....bb，スワップ先ファイル名＝cc....cc，スワップ要因＝dd....dd

Output file for Framework function was swapped. file type = aaa, swap source file name = bb....bb, swap destination file name = cc....cc, swap reason = dd....dd

フレームワーク用出力ファイルがスワップしました。

aaa：フレームワーク用出力ファイル種別

TEL：電文ファイル

RES：結果ファイル

bb....bb：スワップ元フレームワーク用出力ファイル名

cc....cc：スワップ先フレームワーク用出力ファイル名

dd....dd：スワップ要因

FULL：フレームワーク用出力ファイルの満杯検知

ERR：障害スワップ

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80950-I　（Y）S+P+L（L）1

比較エラー情報ファイル出力機能を開始しました。ファイル名＝aa....aa

The function that outputs data to the comparison error information file has started. file name = aa....aa

比較エラー情報ファイル出力機能を開始しました。

aa....aa：ファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80951-I　（Y）S+P+L（L）1

比較エラー情報ファイルがスワップしました。スワップ元ファイル名＝aa....aa，スワップ先ファイル名＝bb....bb

The comparison error information file was swapped. swap source file name = aa....aa, swap destination file name = bb....bb

比較エラー情報ファイルがスワップしました。

aa....aa：スワップ元ファイル名

bb....bb：スワップ先ファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80952-I　（Y）S+P+L（L）5

統計情報：プロトコル種別＝aa....aa,　総処理件数＝bb....bb, 正常処理件数＝cc....cc, プロトコルレベルエラー／不一致件数＝dd....dd, ユーザレベルエラー／不一致件数＝ee....ee

Statistical information: protocol type = aa....aa, total number of processed items = bb....bb, number of normally processed items = cc....cc, protocol level errors/number of inconsistencies = dd....dd, user level errors/number of inconsistencies = ee....ee

プロセス終了時に、プロトコル種別毎の比較処理件数を出力します。該当プロトコルの処理件数が0件の場合には本メッセージは出力されません。

aa....aa：プロトコル種別

RPC：RPC・RAPプロトコル

TCP：TCPプロトコル

HTTP：HTTPプロトコル

IIOP：IIOPプロトコル

bb....bb：総処理件数

cc....cc：正常処理件数

dd....dd：プロトコルエラー／不一致件数

ee....ee：ユーザエラー／不一致件数

（S）

終了処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80960-I　(Y)S+P+L (L)1

稼働情報蓄積機能を開始します。ファイル名＝aa…aa

Operation information file output function will start. file name = aa...aa

稼働情報蓄積機能を開始します。

aa…aa：稼働情報ファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE80961-I　(Y)S+P+L (L)1

稼働情報ファイルがスワップしました。スワップ元ファイル名＝aa…aa，スワップ先ファイル名＝bb…bb，スワップ要因＝cc…cc

Operation information file was swapped. swap source file name = aa...aa, swap destination file name = bb...bb, swap reason = cc...cc

稼働情報ファイルがスワップしました。

aa…aa：スワップ元稼働情報ファイル名

bb…bb：スワップ先稼働情報ファイル名

cc…cc：スワップ要因

FULL：稼働ファイルの満杯検知

ERR：障害スワップ

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE81900-I　（Y）S+P+L（L）5

メッセージ出力を開始します。メッセージログファイル名＝aa....aa

Start to output message. logfile name=aa....aa

メッセージで示すメッセージログファイルにメッセージ出力を開始します。

aa....aa：メッセージログファイル名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE81901-I　（Y）S+P+L（L）5

メッセージログファイルがスワップしました。スワップ元ファイル＝aa....aa，スワップ先ファイル＝bb....bb，ランＩＤ＝cccccccc

Swap logfile. previous logfile name=aa....aa, next logfile name=bb....bb, runid=cccccccc

メッセージログファイルがスワップしました。

aa....aa：スワップ元ファイル名

bb....bb：スワップ先ファイル名

cccccccc：ランID

ランIDが表示されます。

ランIDがまだ決定されていない場合は、「00000000」が表示されます。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE81902-I　（Y）S+P+L（L）5

SYSLOGへのメッセージ出力を開始します。

Start to output message to SYSLOG.

syslogへのメッセージ出力を開始します。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE83301-I　（Y）S+P+L（L）5

ＨＴＴＰのテストが終了しました。総処理件数＝aa....aa，正常処理件数＝bb....bb，保守情報１＝cc....cc，保守情報２＝dd....dd，保守情報３＝ee....ee，保守情報４＝ff....ff，保守情報５＝gg....gg

HTTP testing finished. total number of processed items = aa....aa, number of normally processed items = bb....bb, maintenance information 1 = cc....cc, maintenance information 2 = dd....dd, maintenance information 3 = ee....ee, maintenance information 4 = ff....ff, maintenance information 5 = gg....gg

HTTPのテストが終了しました。テスト結果を表示します。

aa....aa：総処理件数（10進表記）

テストしたHTTP要求電文数を表示します。

HTTP要求電文数が4294967295を超えた場合は、4294967295を表示します。

bb....bb：正常終了件数（10進表記）

既存システムとテスト対象システムの両方からHTTP応答電文を受信したHTTP要求電文数を表示します。

cc....cc：保守情報1

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：保守情報2

システム検証支援基盤がトラブルシュートで使用する情報です。

ee....ee：保守情報3

システム検証支援基盤がトラブルシュートで使用する情報です。

ff....ff：保守情報4

システム検証支援基盤がトラブルシュートで使用する情報です。

gg....gg：保守情報5

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE83302-I　（Y）S+P+L（L）5

マッピング情報の統計。上限数＝aa....aa，有効期限＝bb....bb，識別子数＝cc....cc，破棄数１＝dd....dd，破棄数２＝ee....ee，書き換え成功回数＝ff....ff，書き換え失敗回数＝gg....gg，書き換え不要回数＝hh....hh

This message contains the mapping information statistics. maximum number = aa....aa, expiry date = bb....bb, number of identifiers = cc....cc, number of discards 1 = dd....dd, number of discards 2 = ee....ee, number of successful rewrites = ff....ff, number of failed rewrites = gg....gg, number of times rewrite was not necessary = hh....hh

マッピング情報の統計を表示します。

マッピング情報は、Webサーバの識別子種別（Cookie、リソースのエンティティタグ、リソースの更新時刻）毎に管理します。本メッセージでは、各出力項目について、全マッピング情報間で最も大きい値を表示します。上限数と有効期限については、定義値をそのまま表示します。

aa....aa：識別子の上限数（10進表記）

http_definition定義の-m maxcntフラグメンバ値

bb....bb：識別子の有効期限（10進表記）

http_definition定義の-m expiredateフラグメンバ値

cc....cc：識別子数（10進表記）

テスト中の識別子の最大数。

dd....dd：破棄数1（10進表記）

上限数超過により破棄した識別子数。

ee....ee：破棄数2（10進表記）

有効期限満了により破棄した識別子数。

ff....ff：書き換え成功回数（10進表記）

マッピング情報が存在し、識別子の書き換えを行った回数。

gg....gg：書き換え失敗回数（10進表記）

マッピング情報が存在しない為、識別子の書き換えが行えなかった回数。この値が1以上の場合、テスト対象システム側で何らかのエラー（識別子不正等）が発生する可能性があります。「破棄数1」又は「破棄数2」が1以上の場合、識別子を破棄した事が原因の可能性がある為、上限数又は有効期限を拡張する事を推奨します。

hh....hh：書き換え不要回数（10進表記）

マッピング情報が存在するが、既存システムとテスト対象システムが同じ識別子の為、識別子の書き換えを行わなかった回数。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE83401-I　（Y）S+P+L（L）3

実行形態を変更しました。旧実行形態＝aa....aa, 新実行形態＝bb....bb

The execution format was changed. old execution format = aa....aa, new execution format = bb....bb

システム検証支援基盤の実行形態を変更しました。

aa....aa：旧実行形態

変更前の実行形態を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

bb....bb：新実行形態

変更後の実行形態を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE83402-I　（Y）S+P+L（L）2

システム検証支援基盤を実行します。実行形態＝aa....aa，プロトコル種別＝bb....bb

The SIC is executing. execution format = aa....aa, protocol type = bb....bb

システム検証支援基盤の処理を実行します。

開始時刻を指定された場合は開始時刻を経過し、実行形態の処理を開始する際に出力します。

aa....aa：実行形態

現在の実行形態。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

r：リプレイ実行

c：PCAP実行

bb....bb：プロトコル種別

複数のプロトコル種別を表示する場合は「：」区切りで表示します。

RPC：RPC・RAPプロトコル

TCP：TCPスルー

HIRDB：システム分析支援アダプタ（HiRDB）

COSMI：システム分析支援アダプタ（Cosminexus）

HTTP：HTTP

UDP：UDPスルー

IIOP：IIOPプロトコル

（S）

電文の処理を開始します。

（O）

なし。

［対策］

なし。

KFSE83403-I　（Y）S+P+L（L）5

コネクションの確立を待ち合わせ中です。コネクション数＝aa....aa／bb....bb

Waiting connections to be established. number of connections = aa....aa / bb....bb

テスト対象システムからのコネクション確立要求を待ち合わせています。

aa....aa：確立済サーバ型コネクション数

bb....bb：定義したサーバ型コネクション数

address_destination定義-kオプションcnmodeオペランドに"server"を指定した定義数

（S）

処理を続行します。

（O）

なし。

［対策］

テスト対象システムからコネクションを確立してください。

KFSE83901-I　（Y）S+P+L（L）5

SQLの解析が終了し，テストを実行できる状態になりました。

SQL parsing finished, and the system is now ready for a test.

SQLの解析が終了しテストを実行できる状態になりました。

（S）

処理を続行します。

（O）

アプリケーションを実行しテストを開始してください。

［対策］

なし。

KFSE84001-I　（Y）S+P+L（L）5

フレームワーク機能を開始します。テスト識別子＝aa....aa，プラグイン名称＝bb....bb，フェーズ＝cc....cc

The framework function will start. test ID = aa....aa, plugin name = bb....bb, phase = cc....cc

フレームワーク機能を開始します。

aa....aa：テスト識別子

bb....bb：プラグイン名称

cc....cc：フレームワーク機能の動作フェーズ

CREATE：電文作成フェーズ

TEST：テスト実行フェーズ

BATCH：バッチ実行フェーズ

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84002-I　（Y）S+P+L（L）5

フレームワーク機能を終了します。テスト識別子＝aa....aa，プラグイン名称＝bb....bb，フェーズ＝cc....cc

The framework function will stop. test ID = aa....aa, plugin name = bb....bb, phase = cc....cc

フレームワーク機能を終了します。

aa....aa：テスト識別子

bb....bb：プラグイン名称

cc....cc：フレームワーク機能の動作フェーズ

CREATE：電文作成フェーズ

TEST：テスト実行フェーズ

BATCH：バッチ実行フェーズ

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84003-I　（Y）S+P+L（L）5

フレームワーク機能テスト結果：総処理件数＝aa....aa，正常処理件数＝bb....bb，フレームワークエラー件数＝cc....cc，プラグインレベル１エラー件数＝dd....dd，プラグインレベル２エラー件数＝ee....ee，プラグインレベル３エラー件数＝ff....ff

The test result of framework function: total number of processed items = aa....aa, number of normally processed items = bb....bb, number of framework error items = cc....cc, number of plugin error level 1 items = dd....dd, number of plugin error level 2 items = ee....ee, number of plugin error level 3 items = ff....ff

フレームワーク機能のテスト結果を表示します。

aa....aa：総処理件数

フレームワーク機能でテストを実施した件数です。

bb....bb：正常処理件数

正常終了したテストの件数です。

cc....cc：フレームワークエラー件数

フレームワーク機能がエラーを検知したテストの件数です。

dd....dd：プラグインレベル1エラー件数

プラグインがレベル1エラーを検知したテストの件数です。

ee....ee：プラグインレベル2エラー件数

プラグインがレベル2エラーを検知したテストの件数です。

ff....ff：プラグインレベル3エラー件数

プラグインがレベル3エラーを検知したテストの件数です。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84004-I　(Y)S+P+L (L)5

マッピング情報の統計。上限数＝aa…aa，有効期限＝bb…bb，識別子数＝cc…cc，破棄数１＝dd…dd，破棄数２＝ee…ee，書き換え成功回数＝ff…ff，書き換え失敗回数＝gg…gg，書き換え不要回数＝hh…hh

This message contains the mapping information statistics. maximum number = aa…aa, expiry date = bb…bb, number of identifiers = cc…cc, number of discards 1 = dd…dd, number of discards 2 = ee…ee, number of successful rewrites = ff…ff, number of failed rewrites = gg…gg, number of times rewrite was not necessary = hh…hh

マッピング情報の統計を表示します。

マッピング情報は、Webサーバの識別子種別（HTTPクッキー）毎に管理します。本メッセージでは、各出力項目について、全マッピング情報間で最も大きい値を表示します。上限数と有効期限については、定義値をそのまま表示します。

aa…aa：識別子の上限数（10進表記）

framework_definition定義の-m maxcntフラグメンバ値

bb…bb：識別子の有効期限（10進表記）

framework_definition定義の-m expiredateフラグメンバ値

cc…cc：識別子数（10進表記）

テスト中の識別子の最大数。

dd…dd：破棄数１（10進表記）

上限数超過により破棄した識別子数。

ee…ee：破棄数２（10進表記）

有効期限満了により破棄した識別子数。

ff…ff：書き換え成功回数（10進表記）

マッピング情報が存在し、識別子の書き換えを行った回数。

gg…gg：書き換え失敗回数（10進表記）

マッピング情報が存在しないため、識別子の書き換えが行えなかった回数。この値が1以上の場合、テスト対象システム側で何らかのエラー（識別子不正等）が発生する可能性があります。「破棄数１」又は「破棄数２」が1以上の場合、識別子を破棄した事が原因の可能性があるため、上限数又は有効期限を拡張する事を推奨します。

hh…hh：書き換え不要回数（10進表記）

マッピング情報が存在するが、既存システムとテスト対象システムが同じ識別子のため、識別子の書き換えを行わなかった回数。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84401-I　（Y）S+P+L（L）5

パケットキャプチャを開始しました。ネットワークインタフェース名＝aa....aa

Packet capture will start. network interface name = aa....aa

パケットキャプチャを開始しました。

aa....aa：ネットワークインタフェース名

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84402-I　（Y）S+P+L（L）5

パケットキャプチャを終了しました。受信データ数＝aa....aa，ロスト数＝bb....bb，受信サイズ＝cc....cc，ロストサイズ＝dd....dd

Packet capture will now end. received data count = aa....aa, lost count = bb....bb, received size = cc....cc, lost size = dd....dd

パケットキャプチャを終了しました。

パケットキャプチャの情報を表示します。

aa....aa：受信データ数（10進表記）

受信パケット数が表示されます。

bb....bb：ロスト数（10進表記）

パケットがロストした回数が表示されます。

cc....cc：受信サイズ（10進表記）

受信データサイズが表示されます。（単位：バイト）

dd....dd：ロストサイズ（10進表記）

ロストしたデータサイズが表示されます。（単位：バイト）

（S）

続けてKFSE84403-Iを出力します。

（O）

なし。

［対策］

なし。

KFSE84403-I　（Y）S+P+L（L）5

ネットワークインタフェース名＝aa....aa，受信パケット数＝bb....bb，ドロップパケット数＝cc....cc

Packet capture information. network interface name = aa....aa, received packet count = bb....bb, dropped packet count = cc....cc

パケットキャプチャを終了しました。

ネットワークインタフェース毎のパケットキャプチャ情報を表示します。

aa....aa：ネットワークインタフェース名

bb....bb：受信パケット数（10進表記）

当該ネットワークインタフェースが受信したパケット数が表示されます。

パケットキャプチャ関連定義のcapture_definitionで指定した、既存システムのサーバIPアドレスのパケット数です。

cc....cc：ドロップパケット数（10進表記）

当該ネットワークインタフェースが受信できなかったパケット数が表示されます。

0を超えた値の場合、キャプチャ性能を超えたパケットを受信しています。

受信パケットがパケットキャプチャ関連定義のcapture_definitionで指定した、既存システムのサーバIPアドレス以外のIPアドレスの場合で廃棄されたときのパケット数は含みません。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE84404-I　（Y）S+P+L（L）5

パケットキャプチャ情報。pcap形式ファイル名＝aa....aa，受信パケット数＝bb....bb，先頭パケット時刻＝cc....cc，末尾パケット時刻＝dd....dd，終了コード＝ee....ee

Packet capture information. pcap file name = aa....aa, received packet count = bb....bb, first packet time = cc....cc, last packet time = dd....dd, termination code = ee....ee

パケットキャプチャを終了しました。

pcap形式ファイル毎のパケットキャプチャ情報を表示します。

aa....aa：pcap形式ファイル名

bb....bb：受信パケット数（10進表記）

pcap形式ファイルから読み込んだパケット数が表示されます。

cc....cc：先頭パケット時刻

pcap形式ファイルから読み込んだ最初のパケットのキャプチャ時刻を「yyyy/mm/dd hh:mm:ss.ssssss」形式で出力します。

パケットを読み込んでいない場合は「----/--/-- --:--:--.------」を表示します。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

ssssss　マイクロ秒

dd....dd：末尾パケット時刻

pcap形式ファイルから読み込んだ最後のパケットのキャプチャ時刻を「yyyy/mm/dd hh:mm:ss.ssssss」形式で出力します。

パケットを読み込んでいない場合は「----/--/-- --:--:--.------」を表示します。

yyyy　　年（西暦）

mm　　　月

dd　　　日

hh　　　時

mm　　　分

ss　　　秒

ssssss　マイクロ秒

ee....ee：終了コード

pcap形式ファイルの読み込みを終了した時の要因を出力します。

内容は下表を参照してください。

終了コード

意味

0001

システム検証支援基盤が終了しました。

0002

全パケットの読込みが完了しました。

0003

テスト対象範囲内のパケットの読込みが完了しました。

0101

パケットがありません。

0102

テスト対象範囲内のパケットがありません。

上記以外

読み取り対象外になりました。

読み取り対象外となった時点で出力された、KFSE44407-Wメッセージの理由コードが表示されます。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85001-I　（Y）S+P+L（L）1

コマンドを受け付けました。コマンド＝aa....aa

A command is accepted. command = aa....aa

コマンドを受け付けました。

aa....aa：入力コマンド

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85101-I　（Y）P+L（L）6

プロセス終了時のメモリ確保情報。メモリサイズ＝aa....aa

Memory area information at process termination. memory size = aa....aa

プロセス終了時にシステム検証支援基盤が確保していたメモリサイズを出力します。

aa....aa：プロセス終了時に確保していたメモリサイズ（単位：バイト）

（S）

終了処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85307-I　（Y）S+P+L（L）1

スレッドを生成しました。テスト識別子＝aa....aa，スレッド種別＝b，ＩＦＡ番号＝cc....cc，スレッドＩＤ＝dd....dd

A thread was created. test ID = aa....aa, thread type = b, IFA number = cc....cc, thread ID = dd....dd

スレッドを生成しました。

aa....aa：テスト識別子

b：スレッド種別

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：IFA番号

生成したスレッドのIFA番号を表示します。

dd....dd：スレッドID

生成したスレッドのスレッドIDを表示します。

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85400-I　（Y）S+P+L（L）5

トラブルシュートファイルがスワップしました。スワップ元ファイル＝aa....aa，スワップ先ファイル＝bb....bb

The troubleshooting file was swapped. swap source file = aa....aa, swap destination file = bb....bb

トラブルシュートファイルがスワップしました。

aa....aa：スワップ元ファイル名（10～40桁）

bb....bb：スワップ先ファイル名（10～40桁）

（S）

処理を続行します。

（O）

必要に応じて、スワップ元ファイルのバックアップを実施してください。

［対策］

なし。

KFSE85404-I　（Y）S+P+L（L）5

トラブルシュート機能を開始します。機能名＝aaa，ファイル名＝bb....bb

The troubleshooting function will start. function name = aaa, file name = bb....bb

ファイル名＝bb....bbで示すファイルでトラブルシュート機能を開始します。

aaa：ファイル種別

tsk：TASKTM機能

stc：システム統計情報機能

bb....bb：ファイル名（10～40桁）

（S）

システムを続行します。

（O）

なし。

［対策］

なし。

KFSE85405-I　（Y）S+P+L（L）5

タイマの再登録が成功しました。処理種別＝aa....aa

The timer was successfully reregistered. processing type = aa....aa

タイマの再登録処理が成功しました。

aa....aa：処理種別

1：システム統計情報のインタバル取得

（S）

システムを続行します。

（O）

なし。

［対策］

なし。

KFSE85410-I　（Y）S+P+L（L）6

ファイルサイズが定義サイズと異なります。トラブルシュートファイルを再作成します。ファイル名＝aa....aa，再作成前サイズ＝bb....bb，再作成後サイズ＝cc....cc

The file size differs from the defined size. The troubleshooting file will be recreated. file name = aa....aa, size before recreation = bb....bb, size after recreation = cc....cc

ファイルサイズが定義サイズと異なります。ファイルを再作成します。

aa....aa：再作成するファイル名

bb....bb：再作成前のファイルサイズ

cc....cc：再作成後のファイルサイズ

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85411-I　（Y）S+P+L（L）6

モジュールトレースファイルの出力に失敗しました。ファイル名＝aa....aa，ＩＦＡ番号＝bb....bb，理由コード＝cc....cc

Failed to output a module trace file. file name = aa....aa, IFA number = bb....bb, reason code = cc....cc

モジュールトレースファイルへの出力登録に失敗しました。モジュールトレース情報はIFAへ出力します。

aa....aa：ファイル名

bb....bb：IFA番号（10進表記）

cc....cc：理由コード

CREATE：ファイル追加作成に失敗しました。（オンライン中にモジュールトレースファイルが削除された）

ENSURE：ディスク容量不足

MMAP：メモリ領域不足

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85501-I　（Y）S+P+L（L）1

システム検証支援基盤プロセスを開始します。テスト識別子＝aa....aa

The SIC process will start. test ID = aa....aa

システム検証支援基盤プロセスを開始します。

aa....aa：テスト識別子

（S）

処理を続行します。

（O）

なし。

［対策］

なし。

KFSE85502-I　（Y）S+P+L（L）1

システム検証支援基盤プロセスを終了します。テスト識別子＝aa....aa

The SIC process will now end. test ID = aa....aa

システム検証支援基盤プロセスを終了します。

aa....aa：テスト識別子

（S）

終了処理を続行します。

（O）

なし。

［対策］

なし。

11.6　KFSE90001からKFSE99999までのメッセージ

KFSE90910-I　（Y）S（L）

強制出力コマンドが成功しました。コマンド名＝aa....aa，ファイル種別＝bb....bb，ファイル名＝cc....cc

The forced output command was successful. command name = aa....aa, file type = bb....bb, file name = cc....cc

強制出力コマンドaa....aaが成功しました。

aa....aa：コマンド名

bb....bb：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

cc....cc：強制出力した蓄積ファイル名

（S）

コマンド処理を終了します。

（O）

なし。

［対策］

なし。

KFSE90911-I　（Y）S（L）

強制出力コマンドが成功しました。コマンド名＝aa....aa，ファイル種別＝bb....bb，ファイル名＝cc....cc，スワップ先ファイル名＝dd....dd

The forced output command was successful. command name = aa....aa, file type = bb....bb, file name = cc....cc, swap destination file name = dd....dd

強制出力コマンドaa....aaが成功しました。

aa....aa：コマンド名

bb....bb：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

cc....cc：強制出力した蓄積ファイル名

dd....dd：スワップ先の蓄積ファイル名

（S）

コマンド処理を終了します。

（O）

なし。

［対策］

なし。

KFSE90912-I　（Y）S（L）

使用方法：esaflfput [-g テスト識別子] [-m {all|req|rpy|reqts|rpyts} [-s]]

Usage: esaflfput [-g <test-ID>] [-m {all|req|rpy|reqts|rpyts} [-s]]

esaflfputコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE90913-E　（Y）E（L）

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb....bb，詳細コード＝cc....cc

Command execution has failed. command name = aa....aa, reason code = bb....bb, detail code = cc....cc

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

EXECUTE

システム検証支援基盤プロセス側でエラーが発生しました。

システム検証支援基盤プロセスのメッセージログを参照して原因を調査してください。システム検証支援基盤プロセスのメッセージログにメッセージが出力されていなければ、詳細コードを保守員に連絡してください。

ACCEPT

強制出力できる蓄積ファイルはありません。

次に示す要因が考えられます。問題がない場合は、保守員に連絡してください。

KFSE90914-Eメッセージの理由コードSTART及びDATAの対策参照してください。

DATA

電文エラー

詳細コードを保守員に連絡してください。

INSIDE

内部矛盾

詳細コードを保守員に連絡してください。

KFSE90914-E　（Y）E（L）

強制出力コマンドが失敗しました。コマンド名＝aa....aa，ファイル種別＝bb....bb，理由コード＝cc....cc，詳細コード＝dd....dd

The forced output command failed. command name = aa....aa, file type = bb....bb, reason code = cc....cc, detail code = dd....dd

aa....aa：コマンド名

bb....bb：蓄積ファイル種別

REQ：本番用の要求電文蓄積ファイル

RPY：本番用の応答電文蓄積ファイル

REQTS：テスト用の要求電文蓄積ファイル

RPYTS：テスト用の応答電文蓄積ファイル

cc....cc：理由コード

理由コードの意味と対策を［対策］に示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

START

蓄積ファイル機能が開始していません。

蓄積ファイル種別がREQ、又はRPYのときは、実行形態が蓄積実行か確認してください。

蓄積ファイル種別がREQTS、又はRPYTSのときは、実行形態が並行実行、又はリプレイ実行か確認してください。また、テスト用の要求電文/応答電文を蓄積する定義となっているか確認してください。

DATA

強制出力する電文情報がありません。

要求電文/応答電文の送受信により蓄積ファイルへの蓄積処理が実行したあとに、再度コマンドを実行してください。

FPUT

強制出力コマンドは受付できません。

accumulate_fileオペランドの-fオプションのfileno指定値とfilesz指定値を見直して、システム検証支援基盤を再起動してください。

SWAP

強制出力しましたが、出力先を切り替える蓄積ファイルがありません。

以降、強制出力コマンドは受付できません。

KFSE90915-I　（Y）S（L）

使用方法：esaflfills [-e {f | r}] [-k 電文キー] [-s 蓄積ファイル種別[,蓄積ファイル種別...]] [-r] [-d 電文長] [-L ライブラリ名] [-u [起動UOC名],[編集UOC名],[停止UOC名]] [-c csv出力ファイル名 [-l ファイル出力行]] [-g テスト識別子] -p {rpc | tcp | http | iiop} [-o {all | error}] {蓄積ファイル名 [蓄積ファイル名...] | 蓄積ファイル格納ディレクトリ [蓄積ファイル格納ディレクトリ...]}

Usage: esaflfills [-e {f | r}] [-k <message-key>] [-s <accumulation-file-type>[,<accumulation-file-type>...]] [-r] [-d <message-length>] [-L <library-name>] [-u [<start-UOC-name>],[<edit-UOC-name>],[<stop-UOC-name>]] [-c <csv-output-file-name> [-l <file-output-line>]] [-g <test-ID>] -p {rpc | tcp | http | iiop} [-o {all | error}] {<accumulation-file-name> [<accumulation-file-name>...] | <accumulation-file-storage-directory> [<accumulation-file-storage-directory>...]}

esaflfillsコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE90916-E　（Y）E（L）

ファイルアクセスでエラーが発生しました。コマンド名＝aa....aa,ファイル名＝bb....bb, 理由コード＝cc....cc，詳細コード＝dd....dd

A file access error occurred. command name = aa....aa, file name = bb....bb, reason code = cc....cc, detail code = dd....dd

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：エラーが発生したファイル名です。

cc....cc：理由コード

理由コードの意味と対策を［対策］に示します。

dd....dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

open

openシステムコールでエラーが発生しました。

コマンドの-cオプションにて指定したディレクトリの有無やアクセス権限を確認してください。

write

writeシステムコールでエラーが発生しました。

詳細コードを保守員に連絡してください。

KFSE90917-E　（Y）E（L）

コマンド引数が不正です。コマンド名＝aa....aa，理由コード＝bb....bb

A command parameter is invalid. command name = aa....aa, reason code = bb....bb

コマンド引数に誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bb....bb：理由コード

NOTHING：コマンド引数の指定がありません。

INVALID：コマンド引数の内容が不正です。

NODATA：コマンド引数には使用するファイルがありません。

COMB_ERR：コマンド引数の内容の組合せが不正です。

（S）

コマンド処理を中止します。

（O）

正しいコマンド引数を設定してコマンドを再実行してください。

［対策］

なし。

KFSE90918-E　（Y）E（L）

UOCでエラーが発生しました。コマンド名＝aa....aa，UOC名＝bb....bb，詳細コード＝cc....cc

A UOC error occurred. command name = aa....aa, UOC name = bb....bb, detail code = cc....cc

UOCでエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：エラーが発生したUOC名です。

cc....cc：詳細コード

UOCからのリターン値です。

（S）

コマンド処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

UOCからのリターン値を確認し、UOCの処理を見直してください。

KFSE90919-E　（Y）E（L）

UOC用ライブラリのローディングに失敗しました。コマンド名＝aa....aa，ライブラリ名＝bb....bb，UOC名＝cc....cc，理由コード＝dd....dd，詳細コード＝ee....ee

Failed to load a UOC library. command name = aa....aa, library name = bb....bb, UOC name = cc....cc, reason code = dd....dd, detail code = ee....ee

UOCでエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：エラーが発生したライブラリ名です。

cc....cc：エラーが発生したUOC名です。

（理由コードがdlopenの場合は“＊”を表示します。）

dd....dd：理由コード

理由コードの意味と対策を［対策］に示します。

ee....ee：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

dl open

dlopenシステムコールでエラーが発生しました。

コマンドの-Lオプション指定値やデフォルトライブラリの有無またはアクセス権限を確認してください。

dlsym

dlsymシステムコールでエラーが発生しました。

UOC名に示すUOCの有無を確認してください。

KFSE90920-I　(Y)S (L)

使用方法：esrtmstced [-r] -f 制御文ファイル

Usage: esrtmstced [-r] -f control-statement-file-name

esrtmstcedコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE90921-Q　(Y)S (L)

指定したファイルは既に存在します。上書きしていいですか。[y：上書きする　n：上書きしない] ファイル名＝aa…aa

The specified file already exists. Are you sure you want to overwrite the existing file? [y: Yes. n: No.] file name = aa…aa

ファイルを上書きしていいか応答を求めます。

aa…aa：ファイル名

（S）

オペレータが設定した応答に従って処理します。y、またはn以外を応答した場合は、再度応答を求めます。

（O）

y：ファイルを上書きしてコマンド処理を続行します。

n：ファイルを上書きしないでコマンド処理を終了します。

［対策］

なし。

KFSE90922-E　(Y)E (L)

制御文ファイルアクセスでエラーが発生しました。ファイル名＝aa…aa，理由コード＝bb…bb，詳細コード＝cc…cc

Control-statement-file access error occurred. file name = aa…aa, reason code = bb…bb, detail code = cc…cc

コマンド実行中にエラーが発生したため、処理を中止しました。

aa…aa：エラーが発生したファイル名です。

bb…bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

stat

statシステムコールでエラーが発生しました。

コマンドに指定したファイルの有無やアクセス権限を確認してください。

fopen

fopenシステムコールでエラーが発生しました。

詳細コードを保守員に連絡してください。

getc/fread

getc/freadシステムコールでエラーが発生しました。

詳細コードを保守員に連絡してください。

KFSE90923-E　(Y)E (L)

メモリ不足が発生しました。要求サイズ＝aa…aa，詳細コード１＝bb…bb，詳細コード２＝cc…cc

Memory is insufficient. required size = aa…aa, detail code 1 = bb…bb, detail code 2 = cc…cc

メモリ確保できませんでした。

aa…aa：要求サイズ

確保しようとしたメモリのサイズ（単位：バイト）。サイズが不明の場合、「*」を表示します。

bb…bb：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

cc…cc：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

保守員に連絡してください。

KFSE90924-E　(Y)E (L)

制御文の形式が不正です。理由コード＝aa…aa，行数＝bb…bb，ファイル名＝cc…cc

The definition format is incorrect. reason code = aa…aa, line = bb…bb, file name = cc…cc

制御文ファイルの形式が不正です。

aa…aa：理由コード

1：input/output/range/select/analyze以外で制御文が開始しています。

2：オペランドの解析で構文エラーが発生しました。

制御文の仕様にないオペランドを指定しました。

制御文にオペランドがありません。

オペランド値の後に";"、またはオペランド以外を指定しました。

3：オペランドとオペランド値の間に"="がありません。

4："="の後のオペランド値の解析で構文エラーが発生しました。

オペランド値以外を指定しました。

オペランド値を囲むダブルクォーテーションの一方が欠けています。

オペランド値の途中でEOFを検出しました。

bb…bb：行数

エラーを検知した行番号を出力します。スペースやタブ、改行コード、コメントのみの行があると、出力する行番号がずれる場合があります。

cc…cc：ファイル名

指定した制御文ファイルのパスを出力します。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

bb…bb行目を理由コードに従って見直し、対策後コマンドを実行してください。

KFSE90925-E　(Y)E (L)

制御文の内容に不正があります。制御文＝aa…aa，オペランド＝bb…bb，理由コード＝cc…cc，行数＝dd…dd，ファイル名＝ee…ee

An invalid is specified in the control-statement. statement = aa…aa, operand = bb…bb, reason code = cc…cc, line = dd…dd, file name = ee…ee

制御文に不正があります。

aa…aa：制御文

エラーを検知した制御文名を出力します。

bb…bb：オペランド

エラーを検知したオペランド名を出力します。オペランドがエラー検知対象でない場合は「*」を出力します。

cc…cc：理由コード

1：指定必須の制御文、もしくはオペランドを指定していません。

2：複数指定できない制御文、もしくはオペランドを複数指定しました。

3：複数指定可能な制御文、もしくはオペランドを最大数を超えて指定しました。

dd…dd：行数

エラーを検知した行番号を出力します。理由コードが1で、かつエラー対象が制御文の場合は「*」を出力します。理由コードが1で、かつエラー対象がオペランドの場合は制御文が開始した行番号を出力します。

ee…ee：ファイル名

指定した制御文ファイルのパスを出力します。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

dd…dd行目を理由コードに従って見直し、対策後コマンドを実行してください。

KFSE90926-E　(Y)E (L)

オペランド値に不正があります。制御文＝aa…aa，オペランド＝bb…bb，理由コード＝cc…cc，行数＝dd…dd，ファイル名＝ee…ee

An invalid value is specified. statement = aa…aa, operand = bb…bb, reason code = cc…cc, line = dd…dd, file name = ee…ee

オペランド値に不正があります。

aa…aa：制御文

エラーを検知した制御文名を出力します。

bb…bb：オペランド

エラーを検知したオペランド名を出力します。理由コードが15の場合、後に指定したオペランドの名称を出力します。

cc…cc：理由コード

1：指定できない文字を指定しました。

2：指定値の長さが範囲外です。

3：範囲外の数値を指定しました。

4：ファイルやディレクトリのパスに誤りがあります。

5：指定可能な文字列以外を指定しました。

6：IPアドレスのフォーマットに誤りがあります。

11：カンマ区切りでオペランド値を複数指定できません。

12：カンマ区切りで複数指定したオペランド値で、指定可能な最大数を超えました。

13：カンマ区切りで複数指定したオペランド値で、同じ値を指定しました。

14：カンマ区切りで複数指定したオペランド値で、数値が昇順ではありません。

15：start_timeオペランド値より前の日時をend_timeオペランドに指定しました。

dd…dd：行数

エラーを検知したオペランド先頭の行番号を出力します。

ee…ee：ファイル名

指定した制御文ファイルのパスを出力します。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

dd…dd行目を理由コードに従って見直し、対策後コマンドを実行してください。

KFSE90927-E　(Y)E (L)

内部矛盾が発生しました。詳細コード１＝aa…aa，詳細コード２＝bb…bb，詳細コード３＝cc…cc

An internal conflict has occurred. detail code 1 = aa…aa, detail code 2 = bb…bb, detail code 3 = cc…cc

内部矛盾が発生しました。

aa…aa：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

bb…bb：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

cc…cc：詳細コード３

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

システム管理者へ連絡してください。

［対策］

保守員に連絡してください。

KFSE90928-E　(Y)E (L)

稼働状況編集出力コマンドが失敗しました。理由コード＝aa…aa，ファイル名＝bb…bb，詳細コード＝cc…cc

The operation status edit output command failed. reason code = aa…aa, file name = bb…bb, detail code = cc…cc

esrtmstcedコマンド実行時にエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：ファイル名

理由コードによって表示内容が異なります。表示内容を以下に示します。

理由コード

表示内容

OPEN DIR

READ DIR

稼働情報ファイルを格納するディレクトリ名

CTL OPEN

PREPARE

STEP

EXEC

稼働情報ファイルを格納するファイル名、または「*」

NO DATA

OFFLINE

UNRESOLVABLE

「*」

上記以外

稼働情報ファイル名

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中断します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

NO DATA

稼働情報ファイルがないか、集計対象となるデータを持つ稼働情報ファイルがありません。

制御文ファイルの内容を確認して下さい。

OPEN DIR

ディレクトリの状態取得に失敗しました。

ディスク容量の不足、ディレクトリのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

READ DIR

ファイルの状態取得に失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

FILE STAT

FIL OPEN

ファイルのオープンに失敗しました。

CTL OPEN

稼働情報管理ファイルのオープンに失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。理由コードが「*」の場合、保守員に連絡してください。

PREPARE

稼働情報ファイルからの読込みに失敗しました。

STEP

EXEC

OFFLINE

システム分析支援リアルタイムモニタが実行中でないため、リアルタイムに稼働状況を分析できません。

システム分析支援リアルタイムモニタの起動を確認して下さい。

UNRESOLVABLE

内部エラーが発生しました。

保守員に連絡してください。

KFSE90970-E　（Y）E（L）

An error occurred in the accumulation file edit utility. reason code = aa....aa, file name = bb....bb, detail code = cc....cc

蓄積ファイル編集ユーティリティ実行時にエラーが発生しました。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：蓄積ファイル名

以下に示す理由コードの場合は、蓄積ファイルを格納するディレクトリ名を表示します。

「PARAM DIR」、「DIR STAT」

以下に示す理由コードの場合は、「*」を表示します。

「MALLOC」、「UNRESOLVABLE」

上記以外の理由コードについては、蓄積ファイル名を表示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中断します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MALLOC

領域確保に失敗しました。

OS全体のメモリ使用状況を確認してください。

PARAM DIR

ディレクトリパスが不正です。

INIT要求時に設定したディレクトリパスを確認してください。

DIR STAT

REALPATH

ディレクトリの状態取得に失敗しました。

ディスク容量の不足、ディレクトリのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

PARAM FILE

蓄積ファイルが不正です。

INIT要求時に設定した蓄積ファイル名を確認してください。

NO DATA

蓄積ファイルに電文情報がありません。

FILE STAT

ファイルの状態取得に失敗しました。

ディスク容量の不足、ディレクトリへのファイル作成権限があるか、ファイルシステムに異常がないかを確認してください。

FIL OPEN

ファイルのオープンに失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルの作成権限があるか、ファイルシステムに異常がないかを確認してください。

READ

蓄積ファイルからの読込みに失敗しました。

WRITE

蓄積ファイルへの書込みに失敗しました。

LSEEK

CLOSE

ファイルのクローズに失敗しました。

FCNTL

ファイルのロック確保に失敗しました。

他で実行している蓄積ファイル編集ユーティリティと出力用の蓄積ファイル名が重なっていないか確認してください。

WRITE OVER

蓄積ファイルのサイズが最大となったため、書込みできません。

PUT要求、または拡張PUT要求時の出力電文長に問題がないか確認してください。

UNLINK

ファイルの削除に失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルシステムに異常がないかを確認してください。

UNRESOLVABLE

内部エラーが発生しました。

保守員に連絡してください。

KFSE90975-E　(Y)E (L)

An error occurred in the operation information extraction utility. reason code = aa…aa, file name = bb…bb, detail code = cc…cc

稼働情報抽出ユーティリティ実行時にエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：ファイル名

以下に示す理由コードの場合は、稼働情報ファイルを格納するディレクトリ名を表示します。

「PARAM DIR」,「DIR STAT」

以下に示す理由コードの場合は、「*」を表示します。

「MALLOC」,「NO FILE」,「UNRESOLVABLE」

上記以外の理由コードについては、稼働情報ファイル名を表示します。

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中断します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

MALLOC

領域確保に失敗しました。

ＯＳ全体のメモリ使用状況を確認してください。

PARAM DIR

ディレクトリパスが不正です。

INIT要求時に設定したディレクトリパスを確認してください。

NO FILE

稼働情報管理ファイルと稼働情報ファイルがありません。

OPEN DIR

ディレクトリの状態取得に失敗しました。

ディスク容量の不足、ディレクトリのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

DIR STAT

READ DIR

ファイルの状態取得に失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

FILE STAT

FIL OPEN

ファイルのオープンに失敗しました。

CTL OPEN

稼働情報管理ファイルのオープンに失敗しました。

ディスク容量不足、ファイルディスクリプタ不足、ファイルのアクセス権限があるか、ファイルシステムに異常がないかを確認してください。

PREPARE

稼働情報ファイルからの読込みに失敗しました。

STEP

EXEC

READ

LSEEK

DATA

稼働情報管理ファイル、または稼働情報ファイルが壊れています。

保守員に連絡してください。

UNRESOLVABLE

内部エラーが発生しました。

KFSE91801-E　（Y）E（L）

コマンドの形式が不正です。コマンド名＝aa....aa，理由コード＝bbbb

The command format is incorrect. command name = aa....aa, reason code = bbbb

コマンドの引数に誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bbbb：理由コード

0001：オプションフラグの不正があります。

0002：必要なフラグ引数がありません。

0003：引数に不正があります。

（S）

コマンド処理を行わずに終了します。

（O）

正しい引数を設定してコマンドを再実行してください。

［対策］

なし。

KFSE91802-E　(Y)E (L)

コマンドが失敗しました。コマンド名＝aa…aa，ファイル名＝bb…bb，理由コード＝cc…cc，詳細コード＝dd…dd

Execution of a command failed. command name = aa…aa, file name = bb…bb, reason code = cc…cc, details code = dd…dd

コマンド実行中にエラーが発生したため、処理を中止しました。

aa…aa：コマンド名

bb…bb：ライセンスファイルのパス

cc…cc：理由コード

理由コードの意味と対策を［対策］に示します。

dd…dd：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を中止します。

（O）

理由コードに示した原因を取り除きコマンドを再実行してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

OPEN

ファイルオープンに失敗しました。

ライセンスファイルの障害を取り除きコマンドを再実行してください。

考えられる障害の要因を次に示します。

ファイル障害が発生しました。

ディスク障害が発生しました。

設定されたファイルに対するアクセス権が不正です。

OSの制限（ファイルディスクリプタ、シンボリックリンク数など）を超えています。

NFS障害が発生しました。

WRITE

ファイル書き込みに失敗しました。

KFSE91804-E　(Y)S (L)

ライセンスファイルでエラーが発生しました。ファイル名＝aa…aa，理由コード＝bb…bb，詳細コード＝cc…cc

An error occurred during processing of the license file. file name = aa…aa, reason code = bb…bb, details code = cc…cc

ライセンスファイル解析中にエラーが発生しました

aa…aa：障害が発生したファイルパス

bb…bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

NOTHING

ライセンスファイルがありません。

ライセンスファイルを配置し、再起動してください。

OPEN

ライセンスファイルオープンに失敗しました。

ライセンスファイルの障害を取り除き再起動してください。考えられる障害の要因を次に示します。

ファイル障害が発生しました。

ディスク障害が発生しました。

設定されたファイルに対するアクセス権が不正です。

リソースが不足しています。

OSの制限（ファイルディスクリプタ、シンボリックリンク数など）を超えています。

NFS障害が発生しました。

FORMAT

ライセンスファイルの形式が不正です。

ライセンスファイルを確認してください。

OVER

システム検証支援基盤の使用期限が切れました。

システム管理者に連絡してください。

KFSE91901-E　（Y）E（L）

Failed to initialize. reason code=aa....aa, detail code=bb....bb

ログの初期化で障害が発生しました。メッセージを出力することができません。

aa....aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

理由コードがOTHERのときは、システム管理者に連絡してください。

［対策］

理由コードにより以下の対策を行ってください。

理由

コード

意味

対策

CATALOG

メッセージオブジェクトファイルがオープンできません。

所定のディレクトリに、システムの言語環境に対応したメッセージオブジェクトファイルがあるかどうか確認してください。

MEMORY

メモリが取得できません。

しばらくしてから再実行してください。繰り返し発生する場合、必要の無いプロセスを停止する、メモリを増やすなどの対策を行ってください。

OTHER

その他の障害が発生しました。

保守員に連絡してください。

KFSE91902-E　（Y）E（L）

Failed to close. detail code1=aa....aa, detail code2=bb....bb

ログの終了処理で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE91903-E　（Y）E（L）

Failed in the assembly of the message. detail code1=aa....aa, detail code2=bb....bb, detail information=cc....cc

メッセージの組立処理で障害が発生しました。

aa....aa：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

bb....bb：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細情報

出力に失敗したメッセージ番号と詳細情報を、ハイフンで区切って出力します。

（S）

処理を続行します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE93301-I　（Y）S（L）

使用方法：esipclscn [-g テスト識別子]

Usage: esipclscn [-g <test-ID>]

esipclscnコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93302-I　（Y）S（L）

使用方法：esipcsockcls [-g テスト識別子] {[-i 自IPアドレス] [-m 自ポート番号] [-t 相手IPアドレス] [-o 相手ポート番号] | -a} [-p {all | rpc | tcp | hir | cos | htp | tns | iop}]

Usage: esipcsockcls [-g <test-ID>] {[-i <My-IP-address>] [-m <My-port-number>] [-t <Target-IP-address>] [-o <Target-port-number>] | -a} [-p {all | rpc | tcp | hir | cos | htp | tns | iop}]

esipcsockclsコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93306-I　（Y）S（L）

コネクション切断を受け付けました。テスト識別子＝aa....aa，プロトコル種別＝bbb，自ＩＰアドレス＝cc....cc，自ポート番号＝dd....dd，相手ＩＰアドレス＝ee....ee，相手ポート番号＝ff....ff

The connection close has been accepted. test ID = aa....aa, protocol type = bbb, my IP address = cc....cc, my port number = dd....dd, target IP address = ee....ee, target port number = ff....ff

指定されたコネクションを切断します。

aa....aa：テスト識別子

bbb：プロトコル種別

all：すべてのプロトコル

rpc：RPC・RAPプロトコル

tcp：TCPスルー

hir：システム分析支援アダプタ（HiRDB）

cos：システム分析支援アダプタ（Cosminexus）

htp：HTTP

tns：システム分析支援アダプタ（Oracle Database電文）

iop：IIOPプロトコル

cc....cc：自IPアドレス

esipcsockclsコマンドの-iオプションを省略した場合は、「*」を表示します。

dd....dd：自ポート番号

esipcsockclsコマンドの-mオプションを省略した場合は、「*」を表示します。

ee....ee：相手IPアドレス

esipcsockclsコマンドの-tオプションを省略した場合は、「*」を表示します。

ff....ff：相手ポート番号

esipcsockclsコマンドの-oオプションを省略した場合は、「*」を表示します。

（S）

コネクションを切断します。

（O）

なし。

［対策］

なし。

KFSE93401-I　（Y）S（L）

使用方法：esmodadd [-g テスト識別子] { -p | -a }

Usage: esmodadd [-g <test-ID>] { -p | -a }

esmodaddコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93402-I　（Y）S（L）

使用方法：esmoddel [-g テスト識別子] { -p | -a }

Usage: esmoddel [-g <test-ID>] { -p | -a }

esmoddelコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93403-E　（Y）E（L）

実行形態の追加に失敗しました。テスト識別子＝aa....aa，実行形態＝bb....bb，理由コード＝cc....cc

Failed to add the execution format. test ID = aa....aa, execution format = bb....bb, reason code = cc....cc

esmodaddコマンドによる実行形態の追加に失敗しました。

aa....aa：テスト識別子

実行形態の追加に失敗したシステム検証支援基盤のテスト識別子

bb....bb：実行形態

追加に失敗した実行形態を表示します。理由コードがINVALID またはCOMMUNICATIONの場合は"*"を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

cc....cc：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

コマンド処理を行わずに終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コードにより以下の対策を行ってください。

理由コード

意味

対策

NOTHING

実行形態が並行実行の場合

テスト対象システムが定義されていないため中止しました。

実行形態が蓄積実行の場合

蓄積実行に対応したプロトコルの定義がないため中止しました。

実行形態が並行実行の場合

システム検証支援基盤を終了後、送信先対応付け定義でテスト対象システムを定義し、再起動してください。

実行形態が蓄積実行の場合

システム検証支援基盤を終了後、蓄積実行に対応したプロトコルの定義を定義し、再起動してください。

COMMUNICATION

データの通信に失敗しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

TIMED_OUT

実行形態追加処理でタイムアウトが発生しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

EXECUTE

起動中の実行形態の追加を指定しました。

esmodaddコマンドのオプションに未起動の実行形態を指定してください。

UOC_ERROR

UOCにより実行形態の追加を中止しました。

開始終了UOCのリターンコードを見直してください

INVALID

リプレイ実行またはPCAP実行時に実行形態追加を指定しました。

実行中のシステム検証支援基盤の実行を終了し、並行実行または蓄積実行でシステム検証支援基盤を再起動してください。

STATUS

実行形態の追加が出来る状態ではありません。

システム検証支援基盤プロセスのメッセージログを参照して原因を調査してください。システム検証支援基盤プロセスのメッセージログにメッセージが出力されていなければ、コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

KFSE93404-E　（Y）E（L）

実行形態の削除に失敗しました。テスト識別子＝aa....aa，実行形態＝bb....bb，理由コード＝cc....cc

Failed to delete the execution format. test ID = aa....aa, execution format = bb....bb, reason code = cc....cc

esmoddelコマンドによる実行形態の削除に失敗しました。

aa....aa：テスト識別子

実行形態の削除に失敗したシステム検証支援基盤のテスト識別子

bb....bb：実行形態

削除に失敗した実行形態を表示します。理由コードがINVALID またはCOMMUNICATIONの場合は"*"を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

cc....cc：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

コマンド処理を行わずに終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コードにより以下の対策を行ってください。

理由コード

意味

対策

COMMUNICATION

データの通信に失敗しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

TIMED_OUT

実行形態削除処理でタイムアウトが発生しました。

コマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

NOT_UP

未起動の実行形態の削除を指定しました。

esmoddelコマンドのオプションに起動済の実行形態を指定してください。

UOC_ERROR

UOCにより実行形態の削除を中止しました。

開始終了UOCのリターンコードを見直してください。

INVALID

リプレイ実行またはPCAP実行時に実行形態削除を指定しました。

実行中のシステム検証支援基盤の実行を終了し、並行実行または蓄積実行でシステム検証支援基盤を再起動してください。

LIMITS_INVALID

実行中の全実行形態を削除形態に指定したため、実行形態削除を中止しました。

全実行形態の削除はesstopコマンドで行ってください。

KFSE93405-I　（Y）S（L）

実行形態の追加に成功しました。テスト識別子＝aa....aa，実行形態＝bb....bb

The execution format was successfully added. test ID = aa....aa, execution format = bb....bb

esmodaddコマンドによる実行形態の追加に成功しました。

aa....aa：テスト識別子

実行形態を追加したシステム検証支援基盤のテスト識別子

bb....bb：実行形態

現在の実行形態を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

（S）

コマンド処理を終了します。

（O）

なし。

［対策］

なし。

KFSE93406-I　（Y）S（L）

実行形態の削除に成功しました。テスト識別子＝aa....aa，実行形態＝bb....bb

The execution format was successfully deleted. test ID = aa....aa, execution format = bb....bb

実行形態の削除に成功しました。

aa....aa：テスト識別子

実行形態を削除したシステム検証支援基盤のテスト識別子

bb....bb：実行形態

現在の実行形態を表示します。複数の形態を表示する場合は「：」区切りで表示します。

p：並行実行

a：蓄積実行

（S）

コマンド処理を終了します。

（O）

なし。

［対策］

なし。

KFSE93901-I　（Y）S（L）

使用方法：essqlstart [-g テスト識別子] [-d 定義ファイル格納ディレクトリ名] [{-r | -c}]

Usage: essqlstart [-g <test-ID>] [-d <definition-file-storage-directory-name>] [{-r | -c}]

essqlstartコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93902-I　（Y）S（L）

使用方法：essqlstop [-g テスト識別子] [{-f [-d] | -e {sum | analyze | result}}]

Usage: essqlstop [-g <test-ID>] [{-f [-d] | -e {sum | analyze | result}}]

essqlstopコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93903-I　（Y）S（L）

使用方法：essqlresult [-g テスト識別子] [-e {sum | analyze | result}]

Usage: essqlresult [-g <test-ID>] [-e {sum | analyze | result}]

essqlresultコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93904-I　（Y）S（L）

使用方法：essqlclear [-g テスト識別子]

Usage: essqlclear [-g <test-ID>]

essqlclearコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE93905-E　（Y）E（L）

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb....bb，詳細コード＝cc....cc　

The command failed. command name = aa....aa, reason code = bb....bb, detail code = cc....cc

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を行わずに終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

JOBDIR

指定したテスト識別子の実行環境が存在しません。

指定したテスト識別子を見直してください。

KFSE93906-I　（Y）S（L）

SQLの解析が終了し，テストを実行できる状態になりました。コマンド名＝aa....aa

SQL parsing finished, and the system is now ready for a test. command name = aa....aa

SQLの解析が終了しテストを実行できる状態になりました。

aa....aa：コマンド名

（S）

システム検証支援基盤プロセスは処理を続行します。essqlstartコマンドは終了します。

（O）

アプリケーションを実行しテストを開始してください。

［対策］

なし。

KFSE93907-E　（Y）E（L）

内部矛盾が発生しました。コマンド名＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

An internal conflict has occurred. command name = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd

コマンド処理で内部矛盾が発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を行わずに終了します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。コマンドプロセスが強制停止した場合、コアダンプも保守員に送付してください。

KFSE93908-E　（Y）E（L）

コネクションが残っているためコマンドを実行できません。コマンド名＝aa....aa

The command cannot be executed, because a connection remains. command name = aa....aa

コネクションが残っているためコマンドを実行できません。

aa....aa：コマンド名

（S）

実行したコマンドがessqlclearの場合はテスト実行結果を初期化せずにコマンドを終了します。

実行したコマンドがessqlstopの場合はシステム検証支援基盤プロセスを終了せずにコマンドを終了します。

（O）

アプリケーションを終了させてください。アプリケーションが終了している場合にこのメッセージが出力される場合は、esipcsockclsでコネクションを切断してからコマンドを再実行してください。

［対策］

なし。

KFSE94101-I　(Y)S (L)

使用方法：esdataextract -i 共通定義ファイル

Usage: esdataextract -i <common-definition-file>

esdataextractコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE94102-E　(Y) E (L)１

ファイルのオープンに失敗しました。ファイル名＝aa…aa

Opening of the file failed. file name = aa…aa

ファイルのオープンができませんでした。

aa…aa：ファイル名の絶対パス

オープンに失敗したファイル格納ディレクトリ名、ファイル名が表示されます。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

ファイルの障害を取り除き、コマンドを再実行してください。

障害の要因と考えられる事象

設定されたファイルが存在しない

ファイル障害が発生

ディスク障害が発生

設定されたパスが不正

設定されたファイルに対するアクセス権限が不正

リソース不足

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE94103-E　(Y) E (L)１

領域確保に失敗しました。対象領域＝aa…aa，領域サイズ＝bb…bbバイト，詳細コード＝cc…cc

Failed to allocate an area. target area = aa…aa, area size = bb…bb bytes, detail code = cc…cc

領域の確保に失敗しました。

aa…aa：確保に失敗した対象領域

システム検証支援基盤がトラブルシュートで使用する情報です。

bb…bb：確保に失敗した領域のサイズ

cc…cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を途中で中止して終了します。

（O）

しばらく待ってから、コマンドを再実行してください。再発する場合、システム管理者へ連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE94104-E　(Y) E (L)１

CSV解析処理中にエラーが発生しました。記述形式が不正です。ファイル名＝aa…aa，ファイル種別＝bb…bb，行数＝cc…cc，列数＝dd…dd，項目名＝ee…ee，理由コード＝ff…ff

An error occurred during CSV analysis. The CSV format is incorrect. file name = aa…aa, file type = bb…bb, line = cc…cc, column = dd…dd, item name = ee…ee, reason code = ff…ff

CSV形式が不正です。

aa…aa：ファイル名の絶対パス

bb…bb：CSVファイル種別

COMDEF：共通定義ファイル

EXTRACT：入力データ抽出定義ファイルまたは出力データ抽出定義ファイル

UAP_INOUT：UAP入出力データファイル

cc…cc：不正があった行の行数

dd…dd：不正があった列の列数

特定の列に関わらない場合は0列を表示します。

ee…ee：項目名

項目名に関係の無い場合は「**」を表示します。

ff…ff：理由コード

LINEOVER：CSVファイルの１行のバイト数が規定の範囲（10Mバイト）を超えています。

DIVIDEOVER：CSVファイルの１行の項目数が規定の範囲を超えています。

LACK：CSVファイルの１行の項目数が不足しています。

FORMAT：記述形式が不正です。

DUPLICATE：すでに記述されています。

PLACE：記述箇所が不正です。

VALUE：不正な値または不正な文字列です。

OVER：項目の文字数またはバイト数が規定の範囲を超えています。または、項目内のセミコロン区切りの数が規定の範囲(64個）を超えています。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

CSVファイル中のcc…cc行目のdd…dd列目の記述を、理由コードに従って見直し、コマンドを再実行してください。

KFSE94105-E　(Y) E (L)１

CSV解析中にエラーが発生しました。省略できない項目が記述されていません。ファイル名＝aa…aa，ファイル種別＝bb…bb，行数＝cc…cc，列数＝dd…dd，項目名＝ee…ee

An error occurred during CSV analysis. A mandatory item is incorrect. file name = aa…aa, file type = bb…bb, line = cc…cc, column = dd…dd, item name = ee…ee

省略できない項目が記述されていません。

aa…aa：ファイル名の絶対パス

bb…bb：CSVファイル種別

COMDEF：共通定義ファイル

EXTRACT：入力データ抽出ファイルまたは出力データ抽出ファイル

UAP_INOUT：UAP入出力データファイル

cc…cc：不正があった行の行数

特定の行に関わらない場合は0行を表示します。

dd…dd：不正があった列の列数

特定の列に関わらない場合は0列を表示します。

ee…ee：項目名

項目名に関係の無い場合は「**」を表示します。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

記述内容を見直し、cc…cc行目のdd…dd列目の記述内容を見直し、コマンドを再実行してください。またはee…eeに示された項目を追加してコマンドを再実行してください。

KFSE94107-E　(Y) E (L)１

CSV解析処理中にCSVファイルの読込みに失敗しました。ファイル名＝aa…aa，行数＝bb…bb

Loading of the CSV file failed during CSV analysis. file name = aa…aa, line = bb…bb

CSVファイルのbb…bb行目読込みの際にファイルエラーが発生しました。

aa…aa：ファイル名の絶対パス

bb…bb：読込みに失敗した行の行数

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

CSVファイルの障害を取り除き、再実行してください。

障害の要因と考えられる事象

ファイル障害が発生

ディスク障害が発生

設定されたファイルに対するアクセス権限が不正

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE94108-E　(Y) E (L)1

内部矛盾が発生しました。詳細コード１＝aa…aa，詳細コード２＝bb…bb，詳細コード３＝cc…cc

An internal conflict has occurred. detail code 1 = aa…aa, detail code 2 = bb…bb, detail code 3 = cc…cc

コマンド実行中に予期しない障害が発生したため、処理を中止しました。

aa…aa：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

bb…bb：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

cc…cc：詳細コード３

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。

KFSE94109-E　(Y) E (L)１

ファイルの書き込みに失敗しました。ファイル名＝aa…aa

Writing of the file failed. file name = aa…aa

ファイルの書き込みができませんでした。

aa…aa：ファイル名の絶対パス

書き込みに失敗したファイル格納ディレクトリ名、ファイル名が表示されます。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

ファイルの障害を取り除き、コマンドを再実行してください。

障害の要因と考えられる事象

ファイル障害が発生

ディスク障害が発生

設定されたファイルに対するアクセス権限が不正

リソース不足

OSの制限を超えている（ファイルディスクリプタ、シンボリックリンク数等）

NFS障害が発生

KFSE94110-E　(Y)E (L)

パラメタ抽出コマンドが失敗しました。理由コード＝aa…aa，詳細コード１＝bb…bb，詳細コード２＝cc…cc

The parameter extraction command failed. reason code = aa…aa, detail code1 = bb…bb, detail code2 = cc…cc

esdataextractコマンドによるパラメタ抽出に失敗しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

bb…bb：詳細コード１

システム検証支援基盤がトラブルシュートで使用する情報です。

cc…cc：詳細コード２

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

処理を中断します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

ENVIRONMENT

環境が不正です。

Hitachi Code Converter - Development Kit for C/COBOL(64)がインストールされているか確認してください。

MAPFILE

外字マッピングファイルが不正です。

外字マッピングファイルを見直してください。

直前にメッセージが出力されている場合、Hitachi Code Converter - Development Kit for C/COBOL(64)のメッセージです。メッセージおよび製品マニュアルを参照して対策を行ってください。

INVALID_DATA

抽出対象データが不正です。

UAP入出力データファイルを見直してください。

KFSE94111-I　(Y)S (L)

使用方法：esjnledit -i ジャーナルファイル名 -o UAP入出力データファイル名

Usage: esjnledit -i journal-file-name -o uap-iodata-file-name

esjnleditコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行して下さい。

［対策］

なし。

KFSE94112-I　(Y)E (L)1

ジャーナルファイルの解析中にエラーが発生しました。理由コード＝aa…aa

An error occurred during journal-file analysis. reason code = aa…aa

ジャーナルファイルの解析中にエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

NODATA

ジャーナルファイルに入出力データが存在しません。

正しいジャーナルファイルを指定して、再度コマンドを実行して下さい。

FORMAT

ジャーナルファイルの形式が不正です。

KFSE95001-E　（Y）E（L）

現在コマンドを受け付けることができません。

No commands can be accepted now.

システム検証支援基盤は現在、当該コマンドの処理を実行できる状態ではありません。

（S）

コマンド処理を行わずに終了します。

（O）

システム検証支援基盤の状態を確認してコマンドを再実行してください。

［対策］

なし。

KFSE95002-E　（Y）E（L）

メモリが確保できません。

No memory can be allocated.

システム検証支援基盤でメモリ確保できなかったため、コマンド処理できませんでした。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドを再実行してください。繰り返し発生するようであれば、システム管理者に連絡してください。

［対策］

繰り返し発生する場合、保守員に連絡してください。

KFSE95003-E　（Y）E（L）

コマンド処理で障害が発生しました。

A command processing error occurred.

システム検証支援基盤で障害が発生したため、コマンド処理できませんでした。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドを再実行してください。繰り返し発生するようであれば、システム管理者に連絡してください。

［対策］

繰り返し発生する場合、保守員に連絡してください。

KFSE95088-E　（Y）E（L）

コマンド引数が不正です。コマンド名＝aa....aa，コマンド引数＝bb....bb，理由コード＝cc....cc

The command argument is invalid. command name = aa....aa, command argument = bb....bb, reason code = cc....cc

コマンド引数に誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bb....bb：コマンド引数

cc....cc：理由コード

LENGTH：コマンド引数の長さが不正です。

INVALID：コマンド引数の内容が不正です。

（S）

コマンド処理を行わずに終了します。

（O）

正しいコマンド引数を設定してコマンドを再実行してください。

［対策］

なし。

KFSE95089-E　（Y）E（L）

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb....bb，詳細コード＝cc....cc

Command execution has failed. command name = aa....aa, reason code = bb....bb, detail code = cc....cc

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

COMMUNICATION

データの通信に失敗しました。

または、起動していないシステム検証支援基盤に対してコマンドを実行しました。

システム検証支援基盤との通信障害の原因を調査し、取り除いてください。

なお、システム検証支援基盤ではコマンドを正常に受け付けていることがあります。そのため、コマンドの実行結果をメッセージログで確認してください。

esjoblsコマンドで、システム検証支援基盤プロセスの状態を確認してください。

TEST_ID

コマンドに指定したテスト識別子のシステム検証支援基盤が起動していません。

esjoblsコマンドで、システム検証支援基盤プロセスの状態を確認し、正しいテスト識別子を指定してください。

DATA

データの取得に失敗しました。

詳細コードを保守員に連絡してください。

SYSERR

システム検証支援基盤プロセス側でエラーが発生しました。

詳細コードを保守員に連絡してください。

KFSE95090-E　（Y）E（L）

コマンドの形式が不正です。コマンド名＝aa....aa，理由コード＝bb....bb

The command format is invalid. command name = aa....aa, reason code = bb....bb

コマンドの引数に誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bb....bb：理由コード

OPERAND：不正なオプションフラグを使用しています。

FLAG：必要なフラグ引数がありません。

ARGUMENT：必要なオプションフラグがありません。

CMD_ARG：コマンド引数がありません。

LIMITS_OVER：コマンド引数の個数が多すぎます。

（S）

コマンド処理を行わずに終了します。

（O）

正しい引数を設定してコマンドを再実行してください。

［対策］

なし。

KFSE95091-E　（Y）E（L）

フラグ引数が不正です。コマンド名＝aa....aa，オプション＝bb，理由コード＝cc....cc

The flag argument is invalid. command name = aa....aa, option = bb, reason code = cc....cc

フラグ引数に誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bb：オプション名

cc....cc：理由コード

LENGTH：フラグ引数の長さが不正です。

INVALID：フラグ引数に設定できない文字を設定しています。

NOTHING：設定された値・名称が見つかりません。

RANGE：設定値が設定可能値以外です。

LIMITS_INVALID：フラグ引数の設定値とコマンド引数の設定数の組合せが不正です。

（S）

コマンド処理を行わずに終了します。

（O）

正しいフラグ引数を設定してコマンドを再実行してください。

［対策］

なし。

KFSE95092-E　（Y）E（L）

オプションの組み合わせが不正です。コマンド名＝aa....aa，オプション１＝bb，オプション２＝cc

The combination of options is invalid. command name = aa....aa, option 1 = bb, option 2 = cc

オプションの組み合わせに誤りがあったため、処理を中止しました。

aa....aa：コマンド名

bb：組み合わせが不正なオプション1（2文字）

cc：組み合わせが不正なオプション2（2文字）

（S）

コマンド処理を行わずに終了します。

（O）

正しいオプションを設定してコマンドを再実行してください。

［対策］

なし。

KFSE95093-E　（Y）E（L）

領域の確保に失敗しました。コマンド名＝aa....aa，要求サイズ＝bb....bb

An attempt to allocate area has failed. command name = aa....aa, request size = bb....bb

コマンド処理に必要なメモリの確保に失敗したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：確保に失敗した領域の要求サイズ（単位：バイト）

（S）

コマンド処理を行わずに終了します。

（O）

しばらく待ってから、コマンドを再実行してください。再発する場合、システム管理者に連絡してください。

［対策］

OS全体のメモリ使用状況を確認してください。

KFSE95094-E　（Y）E（L）

内部矛盾が発生しました。コマンド名＝aa....aa，詳細コード＝bb....bb

An internal conflict has occurred. command name = aa....aa, detail code = bb....bb

コマンド実行中に予期しない障害が発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。コマンドプロセスが強制停止した場合、コアダンプも保守員に送付してください。

KFSE95095-Q　（Y）S（L）

指定したファイルは既に存在します。上書きしていいですか。[y：上書きする　a：全てのファイルを上書きする　n：上書きしない] ファイル名＝aa....aa

The specified file already exists. Are you sure you want to overwrite the existing file? [y: Yes. a: Overwrite all files. n: No.] file name = aa....aa

ファイルを上書きしていいか応答を求めます。

aa....aa：ファイル名

（S）

オペレータが設定した応答に従って処理します。y、aまたはn以外を応答した場合は、再度応答を求めます。

（O）

y：ファイルを上書きしてコマンド処理を続行します。

a：全てのファイルを上書きしてコマンド処理を続行します。

n：ファイルを上書きしないでコマンド処理を終了します。

［対策］

なし。

KFSE95405-E　（Y）E（L）

ファイルのヘッダ情報が不正です。コマンド名＝aa....aa，理由コード＝bb，ファイル名＝cc....cc

The file header information is invalid. command name = aa....aa, reason code = bb, file name = cc....cc

ファイルのヘッダ情報が不正です。

aa....aa：コマンド名

bb：理由コード（10進数2桁）

01：設定したファイルにヘッダ情報がありません。

02：設定したファイルがシステム統計情報ファイルではありません。

cc....cc：ファイル名

（S）

ヘッダ情報が不正なファイルへのI/O処理を中止します。

（O）

コマンド引数に設定したファイル名が正しいか確認してください。

［対策］

なし。

KFSE95406-E　（Y）E（L）

データブロックが不正です。コマンド名＝aa....aa，詳細コード＝bb，ファイル名＝cc....cc

The data block is invalid. command name = aa....aa, detail code = bb, file name = cc....cc

データブロックが不正です。

aa....aa：コマンド名

bb：詳細コード（10進数2桁）

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：ファイル名

（S）

コマンド処理を終了します。

（O）

コマンド引数に設定したファイル名が正しいか確認してください。

［対策］

なし。

KFSE95408-E　（Y）E（L）

編集できないファイルタイプです。コマンド名＝aa....aa，コマンドバージョン＝bb....bb，ファイル作成バージョン＝cc....cc，ファイルタイプ＝d，ファイル名＝ee....ee

This file type cannot be edited. command name = aa....aa, command version = bb....bb, file creation version = cc....cc, file type = d, file name = ee....ee

実行したコマンドのシステム検証支援基盤のバージョンでは編集できないファイルタイプです。

aa....aa：コマンド名

bb....bb：実行したコマンドのシステム検証支援基盤のバージョン

cc....cc：ファイルを作成したシステム検証支援基盤のバージョン

d：ファイルタイプ

ee....ee：ファイル名

（S）

コマンド処理を終了します。

（O）

システム検証支援基盤のバージョンを確認してください。表示したファイルタイプを編集できるバージョンで再実行してください。

［対策］

なし。

KFSE95410-E　（Y）E（L）

ファイルのオープン処理で障害が発生しました。コマンド名＝aa....aa，理由コード＝bb，ファイル名＝cc....cc

Failure occurred for file open processing. command name = aa....aa, reason code = bb, file name = cc....cc

入出力ファイル（UNIXファイル）のオープンエラーが発生しました。

aa....aa：コマンド名

bb：理由コード（10進数2桁）

01：設定されたファイルが存在しません。

02：I/Oエラーが発生しました。

cc....cc：ファイル名

（S）

障害の発生したファイルへのI/O処理を中止します。

（O）

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。

［対策］

なし。

KFSE95411-E　（Y）E（L）

ファイルからのリード処理で障害が発生しました。コマンド名＝aa....aa，ファイル名＝bb....bb

Failure occurred for read processing from the file. command name = aa....aa, file name = bb....bb

入出力ファイル（UNIXファイル）からのリードエラーが発生しました。

aa....aa：コマンド名

bb....bb：ファイル名

（S）

障害の発生したファイルへのI/O処理を中止します。

（O）

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。

［対策］

なし。

KFSE95412-E　（Y）E（L）

ファイルへのライト処理で障害が発生しました。コマンド名＝aa....aa，ファイル名＝bb....bb

Failure occurred for write processing to the file. command name = aa....aa, file name = bb....bb

入出力ファイル（UNIXファイル）へのライトエラーが発生しました。

aa....aa：コマンド名

bb....bb：ファイル名。標準出力の場合は、’stdout’を表示します。

（S）

障害の発生したファイルへのI/O処理を中止します。

（O）

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。

［対策］

なし。

KFSE95413-E　（Y）E（L）

ファイルのクローズ処理で障害が発生しました。コマンド名＝aa....aa，ファイル名＝bb....bb

Failure occurred for file close processing. command name = aa....aa, file name = bb....bb

入出力ファイル（UNIXファイル）のクローズエラーが発生しました。

aa....aa：コマンド名

bb....bb：ファイル名

（S）

障害の発生したファイルへのI/O処理を中止します。

（O）

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。

［対策］

なし。

KFSE95414-E　（Y）E（L）

ファイルポインタの移動処理で障害が発生しました。コマンド名＝aa....aa，ファイル名＝bb....bb

Failure occurred for file pointer move processing. command name = aa....aa, file name = bb....bb

入出力ファイル（UNIXファイル）のファイルポインタの移動エラーが発生しました。

aa....aa：コマンド名

bb....bb：ファイル名

（S）

障害の発生したファイルへのI/O処理を中止します。

（O）

直前にメッセージが出力されている場合はそのメッセージに従って、原因を取り除いてください。

［対策］

なし。

KFSE95416-E　（Y）E（L）

指定したファイルに編集するデータがありません。コマンド名＝aa....aa，ファイル名＝bb....bb

The specified file contains no data to be edited. command name = aa....aa, file name = bb....bb

設定したファイルに編集するデータがありません。以下の何れかが理由として考えられます。

設定したファイルがcoreファイルではありません。

データが破壊されています。

コマンドのパラメタに設定したアイキャッチャが誤っています。

（estrbtbldumpコマンドの-xオプション設定値）

aa....aa：コマンド名

bb....bb：ファイル名

（S）

コマンド処理を終了します。

（O）

コマンドのパラメタの入力が誤っていないか、確認してください。または、ファイルが正しいか確認してください。

［対策］

なし。

KFSE95417-E　（Y）E（L）

データの編集途中でファイルの終わりに達しました。コマンド名＝aa....aa，ファイル名＝bb....bb

The end of the file was reached during data modification. command name = aa....aa, file name = bb....bb

データの編集途中でファイルの終わりに達しました。データが破壊されています。

aa....aa：コマンド名

bb....bb：ファイル名

（S）

コマンド処理を終了します。

（O）

ファイルが正しいか確認してください。

［対策］

なし。

KFSE95425-I　（Y）S（L）

強制出力コマンドが成功しました。コマンド名＝aa....aa，スワップ元ファイル名＝bb....bb，スワップ先ファイル名＝cc....cc

The forced output command was successful. command name = aa....aa, swap source file name = bb....bb, swap destination file name = cc....cc

強制出力コマンドaa....aaが成功しました。これによりスワップ元ファイル名bb....bbのファイルからスワップ先ファイル名cc....ccへ交代しました。

aa....aa：強制出力コマンド名

bb....bb：スワップ元ファイル名

強制出力コマンドに-sオプションを指定しなかった場合は「*」を表示します。

cc....cc：スワップ先ファイル名

強制出力コマンドに-sオプションを指定しなかった場合は「*」を表示します。

（S）

コマンド処理を終了します。

（O）

なし。

［対策］

なし。

KFSE95426-E　（Y）E（L）

強制出力コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb，詳細コード＝cc

The forced output command failed. command name = aa....aa, reason code = bb, detail code = cc

強制出力コマンドaa....aaが失敗しました。

aa....aa：強制出力コマンド名

bb：理由コード

01：スワップ処理でファイルIOエラーが発生しました。

03：TASKTM機能が障害により停止しています。

04：以下の理由により強制出力により出力する情報がありません。

プロセス開始時、またはファイル切り替え後に、システム統計情報出力間隔が経過していない

05：トラブルシュート関連定義のstatistical_information -u useにNが指定されているため、システム統計情報機能を使用できません。

06：システム統計情報機能が障害により停止しています。

99：予期せぬエラーが発生しました。

cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

理由コードが05の場合は、statistical_information -u interval_timeに設定した時間経過後に、コマンドを再実行してください。

理由コードが05以外の場合は、システム管理者に連絡してください。

［対策］

理由コードに示す原因を取り除いてシステム検証支援基盤を再起動してください。

理由コードが99の時は保守員に連絡してください。

KFSE95427-E　（Y）E（L）

強制出力コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb

The forced output command failed. command name = aa....aa, reason code = bb

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

05

システム検証支援基盤プロセス側でエラーが発生しました。

システム検証支援基盤プロセスのメッセージログを参照して原因を調査してください。システム検証支援基盤プロセスのメッセージログにメッセージが出力されていなければ、保守員に連絡してください。

KFSE95429-E　（Y）E（L）

コマンドでエラーが発生しました。コマンド名＝aa....aa，理由コード＝bb....bb

An error occurred for the command. command name = aa....aa, reason code = bb....bb

コマンド実行時エラーが発生しました。

aa....aa：コマンド名

bb....bb：コマンドで発生したエラーを示します。

PARAM：引数が正しくありません。

ENVIRONMENT VARIABLE：コマンドの実行に必要な環境変数が不正です。

TEMPORARY DIRECTORY：一時作業領域に十分な空き領域がありません。

OS COMMAND FAILED：オペレーティングシステムのコマンド処理に失敗しました。出力されているオペレーティングシステムのコマンドのメッセージに従って対処してください。

ファイルのアーカイブ処理もしくはディレクトリの作成に失敗しました。

（S）

コマンド処理を終了します。

（O）

エラーの要因を取り除いたあと、コマンドを再度入力してください。

［対策］

なし。

KFSE95434-I　（Y）S（L）

使用方法：estrbtaskfput [-g テスト識別子] [-s]

Usage: estrbtaskfput [-g <test-ID>] [-s]

estrbtaskfputコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95436-I　（Y）S（L）

使用方法：esrasget [-c] 取得先ファイル名

Usage: esrasget [-c] <acquisition-destination-file-name>

esrasgetコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95438-I　（Y）S（L）

使用方法：estrbstcfput [-g テスト識別子] [-s]

Usage: estrbstcfput [-g <test-ID>] [-s]

estrbstcfputコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95439-I　（Y）S（L）

使用方法：estrbstced [-e 編集種別] [-t [開始時刻][,終了時刻]] [-i 時間間隔] [-s [開始編集ＩＤ][,終了編集ＩＤ]] [-c ｃｓｖ出力ファイル名] 統計情報ファイル名 [統計情報ファイル名...]

Usage: estrbstced [-e <modification-type>] [-t [<start-time>][,<end-time>]] [-i <time-interval>] [-s [<start-modification-id>][,<end-modification-id>]] [-c <csv-output-file-name>] <statistical-information-file-name> [<statistical-information-file-name>...]

estrbstcedコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95440-I　（Y）S（L）

使用方法：estrbreport [-g テスト識別子] [-c] [-s [開始編集ＩＤ][,終了編集ＩＤ]]

Usage: estrbreport [-g <test-ID>] [-c] [-s [<start-modification-id>][,<end-modification-id>]]

estrbreportコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95451-E　（Y）E（L）

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb，詳細コード＝cc

The command failed. command name = aa....aa, reason code = bb, detail code = cc

コマンド名：aa....aaが失敗しました。

bb：理由コード

理由コードの意味と対策を［対策］に示します。

cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

理由コードに示した原因を取り除きコマンドを再実行してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

01

トラブルシュート関連定義のstatistical_information -u useにNが指定されているため、システム統計情報機能を使用できません。

トラブルシュート関連定義のstatistical_information -u useにYを設定してシステム検証支援基盤プロセスを再起動してください。

03

内部矛盾を検知しました。

保守員に連絡してください。

99

KFSE95452-E　（Y）E（L）

コマンドが失敗しました。コマンド名＝aa....aa，理由コード＝bb

The command failed. command name = aa....aa, reason code = bb

コマンド実行中にエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bb：理由コード

理由コードの意味と対策を［対策］に示します。

（S）

コマンド処理を途中で中止して終了します。

（O）

システム管理者に連絡してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

05

システム検証支援基盤プロセス側でエラーが発生しました。

システム検証支援基盤プロセスのメッセージログを参照して原因を調査してください。システム検証支援基盤プロセスのメッセージログにメッセージが出力されていなければ、保守員に連絡してください。

KFSE95455-I （Y）S（L）

使用方法：esrasget 取得先ディレクトリ名

Usage: esrasget <acquisition-destination-directory-name>

esrasgetコマンドの使用方法を示します。コマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を行わずに終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95503-E　（Y）E（L）

コマンド処理でエラーが発生しました。コマンド名＝aa....aa，理由コード＝bbbb，詳細コード＝cc....cc

An error occurred during command processing. command name = aa....aa, reason code = bbbb, detail code = cc....cc

コマンド処理でエラーが発生したため、処理を中止しました。

aa....aa：コマンド名

bbbb：理由コード

理由コードの意味と対策を［対策］に示します。

cc....cc：詳細コード

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

理由コードに示した原因を取り除きコマンドを再実行してください。

［対策］

理由コード一覧に従って対策してください。

理由コード

意味

対策

0005

実行環境の構成が不完全な状態のテスト識別子を指定しました。

esjobrmコマンドで指定したテスト識別子を見直してください。指定したテスト識別子が正しい場合は、esjobrmコマンドに-fオプションを追加して再実行してください。

0006

指定したテスト識別子の実行環境が存在しません。

指定したテスト識別子を見直してください。

1002

リソース不足が発生しました。

直前にメッセージが出力されている場合は、そのメッセージに従って対策してください。そうでない場合は、システムのリソース状態を確認してください。

1005

定義ファイルの退避に失敗しました。

システム検証支援基盤環境のディレクトリ構成およびアクセス権限を確認してください。

1008

同じテスト識別子を指定したシステム検証支援基盤プロセスが稼働中、または同じテスト識別子を指定したesjobrmコマンドが実行中です。

同じテスト識別子を指定したシステム検証支援基盤プロセス、および同じテスト識別子を指定したesjobrmコマンドが終了した状態でコマンドを再実行してください。

同じテスト識別子を指定したessqlstartコマンド、essqlstopコマンド、essqlresultコマンド、essqlclearコマンドのいずれかが実行中です。

同じテスト識別子を指定したessqlstartコマンド、essqlstopコマンド、essqlresultコマンド、essqlclearコマンドが終了した状態でコマンドを再実行してください。

1010

実行環境の作成に失敗しました。

システム検証支援基盤環境のディレクトリ構成およびアクセス権限を再確認してください。

1011

1012

1013

1014

1016

メッセージの初期化に失敗しました。

直前に出力されているメッセージに従って対策してください。

1017

保守情報ファイルの出力に失敗しました。

ディスク容量の不足や、ファイルシステムの異常が無いかを確認してください。

1019

対象プロセスは既に終了処理を開始しています。

なし。

2001

定義ファイルが不正です。

指定したテスト識別子に対応する、定義ファイルの有無およびアクセス権限を確認してください。

3001

システム検証支援基盤プロセスの初期化処理が完了する前に、システム検証支援基盤プロセスがプロセスダウンしました。

システム検証支援基盤プロセスで出力されているメッセージに従って対策してください。

3002

システム検証支援基盤プロセスの初期化処理が完了する前に、esstartコマンドまたはessqlstartコマンドがプロセスダウンしました。

コマンドを再実行してください。

その他

予期しない障害が発生しました。

保守員に連絡してください。

KFSE95504-E　（Y）E（L）

内部矛盾が発生しました。コマンド名＝aa....aa，詳細コード１＝bb....bb，詳細コード２＝cc....cc，詳細コード３＝dd....dd

An internal conflict has occurred. command name = aa....aa, detail code 1 = bb....bb, detail code 2 = cc....cc, detail code 3 = dd....dd

コマンド処理で内部矛盾が発生したため、処理を中止しました。

aa....aa：コマンド名

bb....bb：詳細コード1

システム検証支援基盤がトラブルシュートで使用する情報です。

cc....cc：詳細コード2

システム検証支援基盤がトラブルシュートで使用する情報です。

dd....dd：詳細コード3

システム検証支援基盤がトラブルシュートで使用する情報です。

（S）

コマンド処理を終了します。

（O）

システム管理者に連絡してください。

［対策］

保守員に連絡してください。コマンドプロセスが強制停止した場合、コアダンプも保守員に送付してください。

KFSE95550-I　（Y）S（L）

使用方法：esstart [-g テスト識別子] [-d 定義ファイル格納ディレクトリ名] [{[-p] [-a] | -r | -c}] [-t [開始時刻][,終了時刻]] [-m {CREATE|TEST|BATCH}]

Usage: esstart [-g <test-ID>] [-d <definition-file-storage-directory-name>] [{[-p] [-a] | -r | -c}] [-t [<begin-time>][,<end-time>]] [-m {CREATE|TEST|BATCH}]

esstartコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95551-I　（Y）S（L）

使用方法：esstop [-g テスト識別子] [-f [-d]]

Usage: esstop [-g <test-ID>] [-f [-d]]

esstopコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95552-I　（Y）S（L）

使用方法：esjobls

Usage: esjobls

esjoblsコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

KFSE95553-I　（Y）S（L）

使用方法：esjobrm -g テスト識別子 [-f]

Usage: esjobrm -g <test-ID> [-f]

esjobrmコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

（S）

コマンド処理を終了します。

（O）

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

［対策］

なし。

付録

付録A　ディレクトリとファイル

付録A.1　システムテスト支援の実行環境のディレクトリとファイル

システム検証支援基盤インストール時、及び、システムテスト支援実行時に作成されるファイル及びディレクトリを以下に示します。

表A‒1　システムテスト支援実行環境下のファイル及びディレクトリ

ファイル名又はディレクトリ名

説明

アクセス権

/opt/HSIC

システム検証支援基盤環境ホームディレクトリ

755

eshsic_gui.exe

テスト支援GUI（Windows版だけ）

－

/opt/HSIC/conf/

システムテスト支援定義ファイル格納ディレクトリ

定義ファイル名省略時の参照先となる。

755

/opt/HSIC/job/

システムテスト支援実行ベースディレクトリ

755

/opt/HSIC/job/テスト識別子/

システムテスト支援実行環境（※1）

755

/opt/HSIC/job/テスト識別子/bin/

運用コマンド格納ディレクトリへのシンボリックリンク

777

/opt/HSIC/job/テスト識別子/lib/

ライブラリ格納ディレクトリへのシンボリックリンク

777

/opt/HSIC/job/テスト識別子/run/

実行ディレクトリ。

システムテスト支援が異常終了した場合はこのディレクトリ下にcoreファイルが作成される。ユーザは必要に応じて削除すること。（※2）

755

/opt/HSIC/job/テスト識別子/conf/

定義ファイル退避ディレクトリ

755

deffile

定義ファイル

644

deffile_save

定義ファイル（最後に正常終了した時のファイル）

644

/opt/HSIC/job/テスト識別子/spool/

スプールディレクトリ

755

テスト識別子_env

実行時環境変数退避ファイル

644

/opt/HSIC/job/テスト識別子/spool/dceeinf/

トラブルシュート情報格納ディレクトリ

755

/opt/HSIC/job/テスト識別子/spool/dceeinf/log/

ログファイル格納ディレクトリ

755

テスト識別子logxxx

ログファイル（xxxは通番）

644

/opt/HSIC/job/テスト識別子/spool/dceeinf/tasktm/

TASKTMファイル格納ディレクトリ

755

テスト識別子tasktmxxx

TASKTMファイル（xxxは通番）

644

/opt/HSIC/job/テスト識別子/spool/dceeinf/mdl/

モジュールトレースファイル格納ディレクトリ

755

テスト識別子mdlxxx

モジュールトレースファイル（xxxは通番）

644

/opt/HSIC/job/テスト識別子/spool/dceeinf/stc/

システム統計情報ファイル格納ディレクトリ

755

テスト識別子stcxxx

システム統計情報ファイル（xxxは通番）

644

/opt/HSIC/job/テスト識別子/spool/dceeinf/cmp/

比較エラー情報ファイル格納ディレクトリ

755

テスト識別子errxxx

比較エラー情報ファイル（xxxは通番）

644

/opt/HSIC/job/テスト識別子/afile/

蓄積ファイル格納ディレクトリ

755

/opt/HSIC/job/テスト識別子/afile/req/

本番用の要求電文蓄積ファイル格納ディレクトリ（※3）

755

テスト識別子reqxxxxx

本番用の要求電文蓄積ファイル（xxxxxは通番）

600

/opt/HSIC/job/テスト識別子/afile/rpy/

本番用の応答電文蓄積ファイル格納ディレクトリ（※3）

755

テスト識別子rpyxxxxx

本番用の応答電文蓄積ファイル（xxxxxは通番）

600

/opt/HSIC/job/テスト識別子/afile/reqts/

テスト用の要求電文蓄積ファイル格納ディレクトリ（※3）

755

テスト識別子reqtsxxxxx

テスト用の要求電文蓄積ファイル（xxxxxは通番）

600

/opt/HSIC/job/テスト識別子/afile/rpyts/

テスト用の応答電文蓄積ファイル格納ディレクトリ（※3）

755

テスト識別子rpytsxxxxx

テスト用の応答電文蓄積ファイル（xxxxxは通番）

600

/opt/HSIC/job/テスト識別子/pcapfile/

pcap形式ファイル格納ディレクトリ

755

/opt/HSIC/job/テスト識別子/tmp/

テンポラリディレクトリ

755

/opt/HSIC/bin/

運用コマンド格納ディレクトリ

755

esaflfills

蓄積ファイル内容表示

544

esaflfput

蓄積ファイル情報の強制出力

544

estrbtaskfput

TASKTM情報強制ファイル出力

544

estrbtasked

トラブルシュート用ファイル

555

estrbtbldump

トラブルシュート用ファイル

555

estrbstcfput

システム統計情報強制出力

544

estrbstced

システム統計情報編集

555

estrbreport

システム統計情報リアルタイム編集

555

esrasget

保守情報取得

544

esmemls

トラブルシュート用ファイル

555

esipclscn

コネクション状態の表示

555

esipcsockcls

コネクションの切断

544

esstart

システムテスト支援実行

544

esstop

システムテスト支援の中断

544

esjobls

システムテスト支援状態一覧表示

555

esjobrm

システムテスト支援実行環境削除

544

esmodadd

実行形態の追加

544

esmoddel

実行形態の削除

544

esadmshmsg

トラブルシュート用ファイル

555

/opt/HSIC/lib/

ライブラリ格納ディレクトリ

755

libsic.so

システムテスト支援用ライブラリ

555

libsic_rpc.so

システムテスト支援（RPC・RAP）用ライブラリ

555

libsic_iiop.so

システムテスト支援（IIOP）用ライブラリ

555

libsic_ipc_ssl.so

システムテスト支援（HTTPS）用ライブラリ

555

libsic_aflutl.so

システムテスト支援（蓄積ファイル編集ユーティリティ）用ライブラリ

555

libsic_rtmutl.so

稼働情報抽出ユティリティ用ライブラリ

555

libsic_rpc_curl.so

PRFトレース取得機能（FTP）用ライブラリ

555

libsic_frw_zlib.so

gzip形式の圧縮対応用ライブラリ

555

emsgtxt.sic

メッセージカタログファイル（英語）

444

jmsgtxt.sic

メッセージカタログファイル（日本語SJIS）

444

u8msgtxt.sic

メッセージカタログファイル（日本語UTF-8）

444

umsgtxt.sic

メッセージカタログファイル（日本語EUC）

444

/opt/HSIC/lock/

排他ファイル格納ディレクトリ

755

/opt/HSIC/uoclib/

UOC格納用ディレクトリ

755

/opt/HSIC/include/

HSIC提供のヘッダファイル配置用ディレクトリ

755

escom.h

HSIC共通ヘッダファイル

444

esrpc.h

rpc用ヘッダファイル

444

esafl.h

蓄積ファイル用ヘッダファイル

444

esfrw.h

フレームワーク用ヘッダファイル

444

esplg_uoc.h

プラグインUOC用ヘッダファイル

444

esrtm.h

応答監視機能用ヘッダファイル

444

/opt/HSIC/examples/

サンプルファイル配置用ディレクトリ

755

/opt/HSIC/examples/hsic/

HSIC提供のサンプルファイル配置用ディレクトリ

755

/opt/HSIC/examples/hsic/aplib/

HSIC提供のサンプルプログラムファイル配置用ディレクトリ

755

/opt/HSIC/examples/hsic/aplib/c/

HSIC提供のC言語のサンプルプログラムファイル配置用ディレクトリ

755

makefile_base

プロトコル共通C言語UOC作成用サンプルmakefile

444

eshsic_uoc_base.c

プロトコル共通C言語UOCサンプルコーディングファイル

444

makefile_aflfills

蓄積ファイル内容表示コマンドC言語UOC作成用サンプルmakefile

444

eshsic_uoc_aflfills.c

蓄積ファイル内容表示コマンドC言語UOCサンプルコーディングファイル

444

makefile_rpc

RPCプロトコルC言語UOC作成用サンプルmakefile

444

eshsic_uoc_rpc.c

RPCプロトコルC言語UOCサンプルコーディングファイル

444

makefile_aflutl

蓄積ファイル編集ユーティリティC言語サンプルmakefile

444

eshsic_aflutl.c

蓄積ファイル編集ユーティリティC言語サンプルコーディングファイル

444

makefile_rtm

応答監視機能C言語UOC作成用サンプルmakefile

444

eshsic_uoc_rtm.c

応答監視機能C言語UOCサンプルコーディングファイル

444

makefile_iiop

IIOPプロトコルC言語UOC作成用サンプルmakefile

444

eshsic_uoc_iiop.c

IIOPプロトコルC言語UOCサンプルコーディングファイル

444

makefile_rtmutl

稼働情報抽出ユティリティC言語サンプルmakefile

444

eshsic_rtmutl.c

稼働情報抽出ユティリティC言語サンプルコーディングファイル

444

/opt/HSIC/tool

ツール格納ディレクトリ

755

/opt/HSIC/tool/def

定義関連ツール格納ディレクトリ

755

hsic_def.xls

定義生成Excelファイル

444

（凡例）

－：該当なし

※1： esstartコマンド実行時に、コマンド引数で指定したテスト識別子でディレクトリが作成されます。

※2： esstartコマンド実行前に、当該ディレクトリと同名のシンボリックリンクを作成し、出力ファイルの格納先を変更可能。以下に例を示します。

# mkdir /opt/HSIC/job/テスト識別子                 （システムテスト支援実行環境ディレクトリ作成）
# ln -s /aaaa/run /opt/HSIC/job/テスト識別子/run   （実行ディレクトリ(=coreファイル格納先)の変更）

※3：蓄積ファイルの出力先は定義で変更可能。デフォルトの出力先が表中のディレクトリとなります。

付録A.2　システム検証支援基盤が作成するファイル

システム検証支援基盤が作成するファイルを以下に示します。

表A‒2　システム検証支援基盤が作成するファイル

名称

ファイル名

タイプ

ファイル形式

取得タイミング

削除可否

サイズ

ファイル数

バックアップ

メッセージログファイル

/opt/HSIC/job/KKK/spool/dceeinf/log/KKKlogNNN

KKK：テスト識別子

NNN：001〜010の通番

C、F、H

テキスト

esstartコマンドによりシステムテスト支援実行中に、メッセージログ出力対象の事象が発生したとき

×※

message_log -f filesz

10

必要に応じて

システム統計情報ファイル

/opt/HSIC/job/KKK/spool/dceeinf/stc/KKKstcNNN

KKK：テスト識別子

NNN：001〜の通番

C、F、H

バイナリ

esstartよりシステムテスト支援実行中に、定期的に出力

・システム統計情報取得間隔経過によりバッファが満杯時

・システムテスト支援終了時

△

statistical_information -f filesz

statistical_information -f fileno

必要に応じて

TASKTMファイル

/opt/HSIC/job/KKK/spool/dceeinf/tasktm/KKKtasktmNNN

KKK：テスト識別子

NNN：001〜の通番

C、F、H

バイナリ

esstartによりシステムテスト支援実行中に、不定期出力

・TASKTMバッファが満杯時

・システムテスト支援終了時

△

tasktm_information -f filesz

tasktm_information -f fileno

必要に応じて

モジュールトレースファイル

/opt/HSIC/job/KKK/spool/dceeinf/mdl/KKKmdlNNN

KKK：テスト識別子

NNN：001〜002の通番

L

バイナリ

システムテスト支援終了時

△

ページサイズ（4KB）×スレッド数

2

必要に応じて

esrasgetワークファイル

ZZZ/ESRAS.TMP

ZZZ：esrasgetコマンド引数にした取得先ファイル名からファイル名を取り除いたディレクトリ

J

バイナリ

esrasget実行時

□（esrasget）

収集する情報に依存

収集する情報に依存

不要

システムテスト支援実行環境構築用排他ファイル

/opt/HSIC/lock/.jobsetup_lock

J

なし

システム検証支援基盤インストール時

×

0

1

不要

定義ファイル

/opt/HSIC/job/KKK/conf/deffile

KKK：テスト識別子

L

テキスト

esstart実行時

△

使用する定義ファイルに依存

1

必要に応じて

定義ファイル（正常終了時）

/opt/HSIC/job/KKK/conf/deffile_save

KKK：テスト識別子

L

テキスト

システムテスト支援正常終了時

△

使用する定義ファイルに依存

1

必要に応じて

実行時環境変数退避ファイル

/opt/HSIC/job/KKK/spool/KKK_env

KKK：テスト識別子

L

テキスト

esstart実行時

△

環境変数設定内容に依存

1

必要に応じて

プロセス情報ファイル

/opt/HSIC/job/KKK/spool/KKK_jobinfo

KKK：テスト識別子

L

テキスト

esstart実行時

△

収集する情報に依存

1

必要に応じて

ジョブ実行環境構築ファイル

/opt/HSIC/job/KKK/spool/KKK_setup

KKK：テスト識別子

J

なし

esstart実行時

×

0

1

不要

ポート番号格納ファイル

/opt/HSIC/job/KKK/tmp/KKK_portnum

KKK：テスト識別子

J

バイナリ

esstart実行時

×

10

1

不要

異常終了排他ファイル

/opt/HSIC/job/KKK/tmp/KKK_sigabdlock

KKK：テスト識別子

J

なし

esstart実行時

×

0

1

不要

コアファイル

/opt/HSIC/job/KKK/run/XXX

KKK：テスト識別子

XXX：コアファイル名

（OSの命名規則による）

K

バイナリ

システムテスト支援異常終了時

△

収集する情報に依存

単調増加

必要に応じて

蓄積ファイル

/opt/HSIC/job/KKK/afile/AAA/KKKAAANNNNN

または

Dirpath/KKKAAANNNNN

Dirpath：accumulate_file -f dirpath設定値

KKK：テスト識別子

AAA：

req ：本番用の要求電文蓄積ファイル

rpy ：本番用の応答電文蓄積ファイル

reqts：テスト用の要求電文蓄積ファイル

reqts：テスト用の要求電文蓄積ファイル

rpyts：テスト用の応答電文蓄積ファイル

NNNNN：00001〜の通番

C、F、H

バイナリ

蓄積対象の電文受信時

○

accumulate_file -f filesz

accumulate_file -f fileno

必要に応じて

比較エラー情報ファイル

/opt/HSIC/job/KKK/spool/dceeinf/cmp/KKKerrNNN

KKK：テスト識別子

NNN：001〜の通番

C、F、H

テキスト

本番応答とテスト応答の不一致検出時

○

compare_error_file -f filesz

compare_error_file -f fileno

必要に応じて

電文ファイル

KKKtelNNNNN.csv

KKK：テスト識別子

NNNNN：00001〜の通番

C、F

テキスト

蓄積対象の電文受信時

○

csvfile_definition -f lineno

×1電文サイズ

csvfile_definition -f fileno

必要に応じて

結果ファイル

KKKresNNNNN.csv

KKK：テスト識別子

NNNNN：00001〜の通番

C、F

テキスト

要求電文、応答電文（既存）、及び、応答電文（テスト）を基にテスト結果を判定時

○

csvfile_definition -f lineno

×1電文サイズ

csvfile_definition -f fileno

必要に応じて

TNS解析エラーファイル

/opt/HSIC/job/KKK/spool/dceeinf/packet/KKK_packet.txt

KKK：テスト識別子

A

テキスト

HSIC-DB、HSIC-APを使用時に、TNS電文として解析できない電文を入力したとき

○

単調増加（解析できなかったパケットの数、サイズによる）

単調増加

必要に応じて

稼働情報蓄積機能管理ファイル

KKKCTL

KKK：テスト識別子

J

バイナリ

稼働情報蓄積機能を使用したHSIC-RTMの起動時

×

単調増加（HSIC-RTM定義のfile_del=N指定時）

1ファイル

不要

抽出結果ファイル

scenario_definition -f

extract_file設定値

A

テキスト

蓄積対象の電文受信時

○

単調増加（電文の抽出対象データ数、サイズによる）

1ファイル

必要に応じて

比較結果ファイル

scenario_definition -f

compare_file設定値

A

テキスト

応答電文（既存）、応答電文（テスト）を基に比較結果を判定時

○

単調増加（応答電文の比較エラー件数、比較データのサイズによる）

1ファイル

必要に応じて

稼働情報ファイル

KKKDATYYYYMMDDhhmmssNN

KKK：テスト識別子

YYYYMMDDhhmmss：年月日時分秒

NN：01～99の通番

B、E

バイナリ

HSIC-RTM監視対象の電文受信時

○

HSIC-RTM定義のfilesz

HSIC-RTM定義のfileno

必要に応じて

稼働情報管理ファイル

KKKIDXYYYYMMDDhhmmssNN

KKK：テスト識別子

YYYYMMDDhhmmss：年月日時分秒

NN：01～99の通番

B、E

バイナリ

HSIC-RTM監視対象の電文受信時

○

単調増加（稼働情報ファイル内の稼働情報数による）

HSIC-RTM定義のfileno

必要に応じて

（凡例）

タイプ

A：単調増加（削除機能がないタイプ）

B：単調増加（削除機能があるタイプ）

C：ラウンドロビン（バックアップ取得機能がないタイプ）

E：ラウンドロビン（一定量に達した直後の出力で、新しいファイルに切り替わるタイプ）

F：ラウンドロビン（一定量に達する直前の出力で、新しいファイルに切り替わるタイプ）

H：ラウンドロビン（切り替わった先のファイルのデータを、削除してから先頭から書き込むタイプ）

J：制御ファイル、一時ファイル

K：バックアップファイル

L：コマンド実行などで1回ごとに出力し、最大容量が決まっているファイル

削除可否

○：ユーザ判断で削除できます。

△：削除しないでください。ただし、障害調査が不要であれば、ユーザ判断で削除できます。

□：コマンド終了時に削除します。（　）内は該当するコマンド名です。

×：削除しないでください。

注※

システムテスト支援終了後は、障害調査やJP1での監視が不要なケースであればユーザ判断で削除可能。

用語解説

（英字）

IFA番号

システム検証支援基盤がスレッドに付加する番号です。IFA番号は、プロセス内で通番です。

pcap形式ファイル

OS標準、またはフリーソフトとして提供されているパケットキャプチャコマンドを実行することで作成されるファイルです。システム検証支援基盤がサポートするpcap形式ファイルは、バージョン2.4です。

PCAP実行

既存システムからキャプチャしたpcap形式ファイルのパケットを基にプロトコル電文を組み立てて、任意のタイミングでテストの対象システムへ送信する形式のテストです。

TASKTM

処理キュー経由で動作する処理単位に取得されるトラブルシュート情報です。システム検証支援基盤がデータ処理をするごとに、システム統計情報が出力されます。障害が発生した場合、原因を調査するためにTASKTMが必要です。

TCPスルー

1つのTCP/IPパケットを1つの電文として扱い、テストの対象システムへ送信する形式のテストです。

UDPスルー

UDPパケットをそのままテストの対象システムへ送信する形式のテストです。

（カ行）

クライアント識別子

データ送信元を識別するための属性です。デフォルトのクライアント識別子は、パケットを送信したTCPコネクションです。

（サ行）

システムテスト支援

本番環境の既存システムからキャプチャしたデータをそのままテストの対象システムへ送信したり、キャプチャしたデータをファイルに蓄積してからテストの対象システムに送信したりする機能です。

システムテスト支援実行環境

システム検証支援基盤を起動したタイミングで作成されるディレクトリです。システムテスト支援実行環境のディレクトリは、テスト識別子と同じ名称です。

システムテスト支援定義ファイル

システム検証支援基盤の動作や実行環境の情報を定義するためのファイルです。

（タ行）

蓄積実行

本番環境の既存システムからキャプチャしたパケットを基にプロトコル電文に組み立てて、ファイルとして保存する処理です。

蓄積ファイル

本番環境の既存システム間でやり取りされるデータ、およびテストの対象システムが送受信したデータを、システム検証支援基盤がキャプチャして、ファイルとして保存したものです。蓄積ファイルは、並行実行時またはリプレイ実行時に必要です。

中央処理通番

処理キュー経由で動作する処理単位に採番される番号です。処理キューの種類（システム用なのかデータ処理用なのか）は区別されません。中央処理通番は、システム検証支援基盤が起動してから停止するまで、連続して採番されます。

テスト識別子

システム検証支援基盤を起動するごとに付与される、プロセス単位の属性です。システムテスト支援定義ファイルは、テスト識別子ごとに定義できます。

（ハ行）

比較エラー情報ファイル

エラー情報だけをまとめたCSVファイルです。レスポンスデータがエラーの場合、および既存システムとテストの対象システムのレスポンスデータが一致しない場合は、エラーと見なされます。比較エラー情報ファイル内のエラー情報は、テキストエディタなどで参照できます。

フィルタリング

既存システムからキャプチャしたパケットを選択的に破棄する機能です。システムテスト支援定義ファイルで指定されていないパケット、およびUOCから破棄を要求する戻り値があったパケットが、破棄の対象です。

並行実行

既存システムからキャプチャしたパケットを基にプロトコル電文に組み立てて、リアルタイムにテストの対象システムへ送信する形式のテストです。

（ラ行）

リプレイ実行

ファイルに蓄積されたプロトコル電文を、任意のタイミングでテストの対象システムへ送信する形式のテストです。

索引

A

APIの詳細（C言語）[1]

C

COBOL2002[1]

COBOL連携機能[1], [2]

COBOL連携機能とは[1]

CSVファイル関連定義（csvfile_definition）[1]

CSVファイルの運用[1]

CSVファイルの構成[1]

CSVファイルの再読込み

電文ファイルの再読込み[1]

CSVファイルの作成[1]

CSVファイルの総容量の目安[1]

CSVファイルの内容[1]

E

esaflfills（蓄積ファイルの内容表示）[1]

esaflfput（蓄積ファイルの情報強制出力）[1]

eshsic_gui.exe[1]

esipclscn（コネクションの表示）[1]

esipcsockcls（コネクションの切断）[1]

esjobls（システム検証支援の状態表示）[1]

esjobrm（システムテスト支援の実行環境の削除）[1]

esmodadd（システムテスト支援の実行形態の追加）[1]

esmoddel（システムテスト支援の実行形態の削除）[1]

esrasget（保守資料の取得）[1]

esstart（システムテスト支援の起動）[1]

esstop（システムテスト支援の終了）[1]

estrbreport（システム統計情報のリアルタイム編集）[1]

estrbstced（システム統計情報のファイル編集）[1]

estrbstcfput（システム統計情報の強制出力）[1]

estrbtaskfput（TASKTMの情報強制出力）[1]

G

GET要求[1]

gzip形式で圧縮されたHTTP電文の解凍および再圧縮[1]

H

HTTP[1], [2]

HTTPS通信[1]

HTTP応答電文待ち合わせ[1]

HTTPで電文を送信するための前提条件[1]

HTTP電文関連定義（http_definition）[1]

HTTP電文の送信（コネクションの確立・解放）[1]

HTTPの概要[1]

HTTP要求電文の識別子書き換え[1], [2]

I

IIOP[1]

IIOPテスト関連定義（iiop_definition）[1]

IIOPテスト機能の概要[1]

IIOPテスト機能の結果判定機能[1]

IIOPテスト機能のシステム定義[1]

IIOPテスト機能の実行形態[1]

IIOPテスト機能のシリアライズ機能[1]

IIOPテスト機能の前提条件[1]

IIOPテスト機能のテスト実行の流れ[1]

IIOPテスト機能のテスト手順[1]

IIOPテスト機能の電文増幅機能[1]

INIT要求[1]

K

KFSE40001からKFSE49999までのメッセージ[1]

KFSE50001からKFSE59999までのメッセージ[1]

KFSE60001からKFSE69999までのメッセージ[1]

KFSE80001からKFSE89999までのメッセージ[1]

KFSE90001からKFSE99999までのメッセージ[1]

P

pcap形式ファイル[1]

pcap形式ファイルからのパケットキャプチャ[1]

pcap形式ファイルの再読込み[1]

PCAP実行[1]

PUT要求[1]

R

RAP使用時の注意事項[1]

RAPの対応電文[1]

RPC・RAP[1], [2]

RPC応答受信待ち時間に関する定義（rpc_watchtime）[1]

RPC関連定義[1]

RPCコネクション管理に関する定義（rpc_socket）[1]

RPC使用時の注意事項[1]

RPC電文組立監視に関する定義（rpc_build_message_watchtime）[1]

RPCのUOCに関する定義（uoc_func_rpc）[1]

RPCの対応電文[1]

RPCフィルタに関する定義（rpc_telegram_filter）[1]

T

TASKTM機能の縮退[1]

TASKTM強制出力[1]

TASKTMに関する定義（tasktm_information）[1]

TASKTMの概要[1]

TASKTMの取得[1]

TASKTMのファイル出力[1]

TASKTMファイル[1]

TCPスルー[1], [2]

TCPスルーの概要[1]

TCP電文の送信（コネクションの確立・解放）[1]

TERM要求[1]

TPS情報の確認[1]

U

UAPの実行[1]

UDPスルー[1], [2]

UDPスルーの概要[1]

UOCインタフェース[1], [2], [3]

UOC関連定義[1]

UOCの位置づけ[1]

UOCの共用ライブラリに関する定義（module）[1]

UOCの詳細[1]

UOCのタイマに関する定義（uoc_hungup_time）[1]

う

運用コマンド（esaflfills）でのUOCの実行[1]

え

エージェント機能[1]

お

応答電文のデータの比較[1]

応答電文の比較[1]

オペレーション名判定UOC[1]

か

開始終了UOC[1]

開始・終了情報の設定[1]

開始終了プラグイン[1]

概要[1], [2]

拡張PUT要求[1]

各プロトコルで使用可能なＵＯＣインタフェース[1]

カスタム情報シートの表示項目[1]

カバレージ情報[1], [2], [3], [4]

カバレージ統計情報[1]

環境変数の設定[1]

き

記号の説明[1]

記述形式[1]

既存システムとテスト対象システムに対する定義例[1]

起動時のコネクション確立待ち合わせ（リプレイ実行・PCAP実行時）[1]

基本情報シートの表示項目[1]

キャプチャ対象のネットワークインタフェースに関する定義（capture_network_interface）[1]

く

クライアント関連定義（client_definition）[1]

クライアントの増幅[1]

クライアントの増幅に関する定義（rpc_definition）[1]

け

結果判定UOC[1]

結果判定プラグイン[1]

こ

コネクションの管理[1]

コマンド一覧[1]

コマンド形式定義一覧[1]

コマンド実行結果の出力[1]

コマンド実行結果の出力場所と出力内容[1]

コマンドのexitコード[1]

コマンドの記述形式[1]

コマンドライン情報[1]

さ

サーバ関連定義[1]

し

時刻フィルタに関する定義（target_time）[1]

システム関連定義（lightmode_definition）[1]

システム検証支援基盤が作成するファイル[1]

システム検証支援基盤の機能[1]

システム定義の作成[1]

システムテスト支援で使用できる電文プロトコル[1]

システムテスト支援でのUOCの実行[1]

システムテスト支援と各TP1製品のリターンコード[1]

システムテスト支援とは[1]

システムテスト支援のUOC[1]

システムテスト支援のUOC（フレームワーク機能）[1]

システムテスト支援の運用コマンド[1]

システムテスト支援の主な障害の要因と対処[1]

システムテスト支援のシステム定義[1]

システムテスト支援の実行[1]

システムテスト支援の実行環境のディレクトリとファイル[1]

システムテスト支援の実行方式[1]

システムテスト支援の障害情報の取得[1]

システムテスト支援の処理の詳細[1]

システムテスト支援の正常終了時の動作[1]

システムテスト支援の蓄積ファイル[1]

システムテスト支援のメッセージ[1]

システム統計情報機能の概要[1]

システム統計情報に関する定義（statistical_information）[1]

システム統計情報ファイル[1]

実行形態関連定義（reply_send_mode）[1]

受信電文UOC[1]

障害時に取得する情報[1]

障害の要因と対処[1]

使用できる電文プロトコルと実行方式の対応[1]

シリアライズ機能[1]

せ

製品提供プラグイン関連定義（plugin_definition）[1]

全プロトコル共通[1]

そ

送信先対応付け定義（address_destination／HTTPの場合）[1]

送信先対応付け定義（address_destination／IIOPの場合）[1]

送信先対応付け定義（address_destination／RPC・RAPの場合）[1]

送信先対応付け定義（address_destination／TCPスルーのクライアントの場合）[1]

送信先対応付け定義（address_destination／TCPスルーのサーバの場合）[1]

送信先対応付け定義（address_destination／UDPスルーの場合）[1]

送信電文間隔制御[1]

送信編集UOC[1]

ソースカバレージ情報[1]

た

対象の蓄積ファイルおよびプロトコル[1]

タイマ[1]

ち

蓄積実行[1]

蓄積ファイル関連定義[1]

蓄積ファイル強制出力[1]

蓄積ファイル作成に関する定義（accumulate_file）[1]

蓄積ファイル種別[1]

蓄積ファイル内容表示コマンド起動UOC[1]

蓄積ファイル内容表示コマンド終了UOC[1]

蓄積ファイル内容表示コマンドデータ編集UOC[1]

蓄積ファイルの運用[1]

蓄積ファイルの構成[1]

蓄積ファイルの再読込み

電文ファイルの再読込み[1]

蓄積ファイルの状態表示[1]

蓄積ファイルの使用目的[1]

蓄積ファイルの総容量の目安について[1]

蓄積ファイルへの出力タイミング[1]

蓄積ファイル編集ユーティリティ[1]

蓄積ファイル編集ユーティリティ（蓄積ファイルの編集）[1]

蓄積ファイル編集ユーティリティの実行単位[1]

蓄積編集UOC[1]

注意事項[1]

て

定義生成Excelの項目の説明[1]

定義生成Excelの操作時の注意事項[1]

定義の規則[1]

定義の設定[1]

ディレクトリとファイル[1]

データ比較UOC[1]

テスト開始時の蓄積ファイルの運用[1]

テスト支援GUI[1]

テスト支援GUIの起動[1]

テスト対象システム（Webサーバ）とのHTTPS通信[1]

テスト対象システムからの応答電文待ち合わせ（RPC・RAP）[1]

テスト対象システムの選択[1]

テスト対象システムへの送信先の決定[1]

テストの開始[1]

テスト用電文の蓄積ファイルが最大ファイル数に達した場合[1]

テストを終了する[1]

電文キー[1]

電文組立UOC[1]

電文組立てプラグイン[1]

電文受信プラグイン[1]

電文情報設定UOC[1]

電文情報プラグイン[1]

電文選択プラグイン[1]

電文送信プラグイン[1]

電文増幅[1]

電文増幅UOC[1]

電文増幅プラグイン[1]

電文追加UOC[1]

電文に対応する蓄積ファイル[1]

電文のシリアライズ処理[1]

電文のフィルタリング[1]

電文ファイルの再読み込み[1]

電文ファイルの再読込み[1]

電文ペアリング[1]

電文編集プラグイン[1]

と

トラブルシュート関連定義[1]

トラブルシュートに関するファイルの運用[1]

に

入力判定UOC[1]

は

パケットキャプチャ関連定義[1]

パケットキャプチャに関する定義（capture_definition）[1]

パケットキャプチャによるテスト対象システムへの電文転送[1]

パケットキャプチャの構成[1]

パケットキャプチャの対象[1]

パケットロスト[1]

バッチ用プラグイン[1]

ひ

比較エラー情報ファイルに関する定義（compare_error_file）[1]

比較エラー情報ファイルの運用[1]

比較エラー情報ファイルの形式[1]

比較エラー情報ファイルの削除[1]

比較エラー情報ファイルの作成[1]

比較エラー情報ファイルの保存[1]

比較エラー情報ファイルの容量設定[1]

ふ

ファイル出力に関する定義（file_out_control）[1]

フィルタ関連定義[1]

フィルタリング[1], [2], [3], [4]

プラグイン[1]

プラグインインタフェース[1]

プラグイン機能のUOCインタフェース[1]

フレームワーク関連定義（framework_definition）[1]

フレームワーク機能（ユーザ独自のシステムテストの支援）[1]

フレームワーク機能とは[1]

フレームワーク機能のテスト手順[1]

フレームワーク機能を使用した場合のHTTP要求電文の識別子書き換え[1]

フレームワーク機能を適用できる環境[1]

フレームワーク用CSVファイルの運用[1]

プロセス関連定義（process_definition）[1]

プロセス情報の確認[1]

プロトコル共通UOCに関する定義（uoc_func_com）[1]

へ

並行実行[1]

並行実行と蓄積実行の同時実行[1]

編集UOC（復元UOC、蓄積編集UOC、送信電文編集UOC、受信電文編集UOC）[1]

ほ

本番用電文の蓄積ファイルが最大ファイル数に達した場合[1]

翻訳と結合[1], [2]

め

メッセージに出力される処理種別[1]

メッセージの記述形式[1]

メッセージの形式[1]

メッセージの出力形式[1]

メッセージログ[1]

メッセージログ関連定義（message_log）[1]

メッセージログファイル[1]

も

モジュールトレース[1]

モジュールトレースに関する定義（module_trace）[1]

モジュールトレースファイル[1]

ゆ

ユーザアプリケーション（UAP）の作成[1]

ユーザオウンコーディング（UOC）のコーディング[1]

ユーザオウンコーディング（UOC）の作成[1]

ユーザプログラム（UAP）のコーディング[1]

ら

ライブラリ関数[1]

り

リプレイ実行[1]

リプレイ実行時の蓄積ファイルに関する定義（accumulate_reply_file）[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号