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

3021-3-737-20

前書き

著作権

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

輸出時の注意

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

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

商標類

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

Adobeは、Adobe Systems Incorporated(アドビシステムズ社)の米国ならびに他の国における商標または登録商標です。

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

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

RSAおよびBSAFEは、米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

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

Hitachi System Information Capture - Real-Time Monitorは、米国EMC コーポレーションのRSA BSAFEソフトウェアを搭載しています。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by Andy Clark.

発行

2019年3月

はじめに

このマニュアルは、Hitachi System Information Captureのシステム分析支援リアルタイムモニタの機能と使い方について説明したものです。

対象製品

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

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

対象読者

システム分析支援リアルタイムモニタを使用して、次の作業をする方を対象にしています。

業務システムの稼働状況の分析結果を参照する方

業務システムの稼働状況を収集・集計・分析する環境を構築する方

対象読者に必要な知識を次に示します。

OSに関する基本的な知識

システムの開発環境および言語

システムの周辺環境（ネットワークなど）および標準仕様

このマニュアルで使用する製品名・機能名

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

表記

製品名と機能名

Excel

Microsoft Office Excel

Flash Player

Adobe Flash Player

HiRDB/SD

HiRDB Server Structured Data Access Edition Version 9

Internet Explorer

Windows Internet Explorer

JP1/IM

JP1/IM - Manager

JP1/Integrated Management - Manager

JP1/IM - View

JP1/Integrated Manager - View

TP1製品

TP1/SB

TP1/Server Base

TP1/Client

TP1/Client/J

TP1/Client/P

TP1/Client/W

Windows

Windows Server 2008 R2 Standard (x64)

Microsoft Windows Server 2008 R2 Standard 日本語版（64ビット版）

Windows Server 2012 R2 Standard

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ビット版）

システム分析支援リアルタイムモニタ

システム分析支援リアルタイムモニタ

Hitachi System Information Capture - Real-Time Monitor

システム分析支援アダプタ

Hitachi System Information Capture（システム検証支援基盤（システム分析支援アダプタ機能））

このマニュアルで使用する英略語

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

英略語

英字での表記

BI

Business Intelligence

CORBA

Common Object Request Broker Architecture

DNS

Domain Name System

HTTP

Hyper Text Transfer Protocol

I/O

Input/Output

ID

Identifier

IIOP

Internet Inter-ORB Protocol

IP

Internet Protocol

Java VM

Java Virtual Machine

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

UAC

User Account Control

UAP

User Application Program

UNC

Universal Naming Convention

UOC

User Own Coding

URL

Uniform Resource Locator

XML

Extensible Markup Language

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

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

関連マニュアル

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

表記

正式名称

資料番号

Hitachi System Information Capture 基本ガイド

Hitachi System Information Capture 基本ガイド

3021-3-731

Hitachi System Information Capture リファレンス

Hitachi System Information Capture リファレンス

3021-3-732

1　システム分析支援リアルタイムモニタの概要

システム分析支援リアルタイムモニタの概要について説明します。

1.1　システム分析支援リアルタイムモニタとは

システム分析支援リアルタイムモニタは、業務システムの運用管理者が実施する、業務システムの稼働状況の監視作業を効率化するために使用する製品です。

システム分析支援リアルタイムモニタは、複数の業務システムと業務システムの利用者の間でやり取りされるデータをリアルタイムに収集し、業務システムの稼働状況を分析します。また、分析した稼働状況をダッシュボードに表示することで、業務システムの稼働状況を視覚的に確認できるようにします。

業務システムの運用者は、ダッシュボードに表示される分析結果を参照することで、複数の業務システムのリアルタイムな稼働状況を把握できます。

システム分析支援リアルタイムモニタの位置づけを次の図に示します。

図1‒1　システム分析支援リアルタイムモニタの位置づけ

表1‒1　システム分析支援リアルタイムモニタでできること

項目

説明

トランザクションの稼働状況の監視

業務システムのトランザクションの稼働状況を監視します。

業務システムの利用者と、業務システムとの間では、次に示すデータをやり取りします。

利用者からのリクエスト時に送信される電文（要求電文）

業務システムからのレスポンス時に送信される電文（応答電文）

システム分析支援リアルタイムモニタでは、トランザクション単位で稼働状況を監視します。1つのサービス（トランザクション）は次のとおり定義されます。

各要求電文に対する応答電文の組み合わせ

業務システムから実行する1つのSQL文

稼働情報の収集

システム分析支援アダプタを使用して、監視対象のトランザクションの稼働情報を収集し、稼働情報格納領域（ファイル）に保存します。

システム分析支援リアルタイムモニタでは、システム検証支援基盤（Hitachi System Information Capture）をシステム分析支援アダプタとして使用します。

稼働情報の集計・分析

システム分析支援リアルタイムモニタは、システム分析支援アダプタから送信された稼働情報を集計・分析して、レスポンスタイムやスループット（TPS）を抽出します。

稼働情報の分析については、「2.　稼働情報の分析」で説明します。

トランザクションの稼働状況の可視化

システム分析支援リアルタイムモニタは、次のようにトランザクションの稼働状況を可視化します。

稼働情報の集計・分析の結果をダッシュボード画面に表示します。

監視している稼働情報に対して閾値を設定しておくことで、閾値の超過を検知してダッシュボード画面で確認できます。

JP1/IMと連携することで、閾値を超過した場合に、JP1イベントを発行してアラートを出力したり、アラートを出力したときの処理を自動化したりできます。

ダッシュボードの操作やダッシュボードの画面については、「4.　システムの運用」で説明します。

JP1/IMとの連携については、「6.　他システムとの連携」で説明します。

閾値の超過などでアラートを検知した場合に、アラートをメールで通知します。

メールでの通知については、「6.2　アラートのメール通知」を参照してください。

esrtmstcedコマンドを使用して稼働情報をCSVに出力すると、BIツールなどを使用して可視化・分析することもできます。

システム分析支援リアルタイムモニタによる業務システムの稼働状況の監視の仕組みを次の図に示します。

図1‒2　業務システムの稼働状況の監視の仕組み

1.1.1　サーバ間連携機能

通信プロトコルがRPCプロトコルの場合、サーバ間連携機能を使用できます。

サーバ間連携機能は、本番環境のサーバ間の業務システムのやり取り（トランザクション）を関連づけて表示します。業務システムの呼び出し関係や、同時間帯に実行していた業務をグラフィカルに表示することで、障害発生時に問題のあった業務を特定するためのトラブルシュート作業を簡易化します。

サーバ間連携機能の概要を次の図に示します。

図1‒3　サーバ間連携機能の概要

使用できるクライアント

サーバ間連携機能で使用できるクライアントを次に示します。

TP1/Client（TP1/Client/P、TP1/Client/W、またはTP1/Client/J）

TP1/Server BaseのSUPまたはSPP

SQLの情報を関連づける場合の対象データベース

サーバ間連携機能では、データベースにHiRDBを使用している場合に、業務が発行したSQLの情報も関連づけて表示できます（ただし、HiRDB/SDは対象外）。

ほかのデータベースを使用している場合は、RPCプロトコルのトランザクション情報だけを取得します。

サーバ間連携機能が使用する情報

サーバ間連携機能では、主に、次に示す2種類の情報を使用して、業務システムのやり取りや、同時間帯に実行していた業務を表示します。

クライアント情報

SQL情報

これらの情報については、ネットワークに流れるパケット情報をキャプチャ・解析します。

このほかの情報については、本番環境からOpenTP1のPRFトレースを取得・解析し、トランザクションの流れを可視化します。

トランザクションの特定のしかた

サーバ間連携機能では、OpenTP1のPRFキーでトランザクションを特定します。トランザクションを特定できるPRFキーは次のどちらかです。

パケット情報の「ルートOpenTP1識別子」と「ルート通信番号」の組み合わせ

PRFトレース内の「ルートOpenTP1識別子」と「ルート通信番号」の組み合わせ

1.2　システム分析支援リアルタイムモニタがサポートする通信プロトコル

システム分析支援リアルタイムモニタがサポートする通信プロトコルを次に示します。

HTTPプロトコル（SOAPプロトコルを含む）

サポートするプロトコルの詳細は、システム検証支援基盤（Hitachi System Information Capture）に準じます。

ただし、システム分析支援リアルタイムモニタでは、次の制限があります。

HTTPパイプラインには対応していません。

IIOPプロトコル

サポートするプロトコルの詳細は、システム検証支援基盤（Hitachi System Information Capture）に準じます。

RPCプロトコル

サポートするプロトコルの詳細は、システム検証支援基盤（Hitachi System Information Capture）に準じます。

TCPプロトコル

TCPプロトコルを使用するためには、電文組立UOCを利用して、TCPレベルで分割されているパケットをプロトコル電文に組み立てる処理を追加する必要があります。

HiRDBプロトコル

HiRDBクライアントとHiRDBサーバ間のSQL文実行時の通信プロトコルです。次の制限があります。

コネクション接続のSQL(CONNECT文,xa_open)には対応していません。

コネクション切断のSQL(DISCONNECT文,xa_close)には対応していません。

各ユティリティには対応してません。

メモリDBには対応していません。

システム検証支援基盤（Hitachi System Information Capture）がサポートするプロトコルについては、マニュアルHitachi System Information Capture リファレンスのシステムテスト支援で使用できる電文プロトコルの説明を参照してください。

すべてのプロトコルに共通する条件

システム分析支援リアルタイムモニタは、応答電文がある場合には、要求電文→応答電文→要求電文→応答電文のように、要求電文と応答電文を交互に送受信するシステムにだけ適用できます。

応答電文がない場合、特に条件はありません。

1.3　システム分析支援リアルタイムモニタがサポートするシステム構成

システム分析支援リアルタイムモニタは、HTTP、IIOP、RPCなどの通信プロトコルを使用したクライアントとサーバで構成されるシステムに適用できます。

システム分析支援リアルタイムモニタのシステム構成を次の図に示します。なお、サーバ間連携機能を使用する場合のシステム構成については、「1.3.1　サーバ間連携機能を使用する場合のシステム構成」を参照してください。

図1‒4　システム分析支援リアルタイムモニタのシステム構成

ネットワークスイッチ（ミラーポート）

業務システムの稼働情報を収集するために、ミラーポートを設定できるネットワークスイッチを配置します。

システム分析支援アダプタ

システム分析支援アダプタは、ネットワークスイッチのミラーポートを使用して、トランザクションの稼働情報としてリクエストおよびレスポンスのパケットを取得（キャプチャ）します。また、取得したデータをシステム分析支援リアルタイムモニタに送信します。

システム分析支援リアルタイムモニタでは、システム検証支援基盤（Hitachi System Information Capture）をシステム分析支援アダプタとして使用します。

稼働情報の収集・集計・分析をするマシンに、Hitachi System Information Captureをインストールします。

システム分析支援リアルタイムモニタ

稼働情報の収集・集計・分析をするマシンに、システム分析支援リアルタイムモニタ（Hitachi System Information Capture - Real-Time Monitor）をインストールします。

Webブラウザ

ダッシュボード画面を参照するマシンに、Internet Explorerをインストールします。

ブラウザプラグイン

ダッシュボード画面を参照するマシンに、Flash Playerをインストールします。

各プログラムのバージョンについては、システム分析支援リアルタイムモニタのリリースノートを参照してください。

1.3.1　サーバ間連携機能を使用する場合のシステム構成

サーバ間連携機能は、通信プロトコルにRPCプロトコルを使用している、クライアントとサーバで構成されるシステムに適用できます。

サーバ間連携機能を使用する場合のシステム構成を次の図に示します。

図1‒5　サーバ間連携機能を使用する場合のシステム構成

ここでは、サーバ間連携機能だけで使用するプログラムについて説明します。サーバ間連携機能を使用しない場合でも使用するプログラムの説明については、「1.3　システム分析支援リアルタイムモニタがサポートするシステム構成」を参照してください。

クライアント

サーバ間連携機能で使用できるクライアントを次に示します。

TP1/Client（TP1/Client/P、TP1/Client/W、またはTP1/Client/J）

TP1/Server BaseのSUPまたはSPP

サーバ（TP1/Server Base稼働サーバ）

TP1/Server Baseが必要です。また、TP1/Server Baseが稼働しているサーバ（TP1/Server Base稼働サーバ）では、FTPサーバも稼働させておく必要があります。

データベースサーバ

サーバ間連携機能でサポートしているデータベースはHiRDBです（ただし、HiRDB/SDは対象外）。

ほかのデータベースを使用している場合は、RPCプロトコルのトランザクション情報だけを取得します。

各プログラムのバージョンについては、システム分析支援リアルタイムモニタのリリースノートを参照してください。

1.4　サーバ間連携機能の注意事項

サーバ間連携機能を使用する場合の注意事項を説明します。

トランザクション情報表示のタイミング

パケットをキャプチャし次第、パケット情報を表示します。PRFトレースが出力されてから、PRFトレースを取得および表示するまでに、rpc_def定義値分時間が掛かる場合があります。

rpc_prf定義のPRFトレースファイル監視間隔指定値

また、TP1/Server BaseのPRFトレースファイルが更新されない限り、システム分析支援リアルタイムモニタで表示するPRFトレース情報も更新されません。TP1/Server BaseのPRFトレースファイルの出力契機を次に示します。

未出力のPRFトレース情報が一定量以上となった時点

prfgetコマンドの実行時

TP1/Server Baseの終了時

Windows上のサーバが監視対象の場合は、TP1/Server BaseのPRFトレースファイルのスワップが発生するまで、システム分析支援リアルタイムモニタで表示するPRFトレース情報も更新されません。

一部のトランザクション情報が取得できない場合に表示されるトランザクション情報

クライアントからTP1稼働サーバ間のパケットキャプチャができない場合

システム分析支援リアルタイムモニタのダッシュボードのメイン画面では、トランザクション情報が一切表示されません。ただし、条件によっては、一部表示できます。情報の表示の有無を次に示します。

情報の種類

表示の有無

クライアントとTP1/Server Base稼働サーバとの間のトランザクション情報

表示されない。

TP1/Server Base稼働サーバの情報

表示されない。

ただし、関連付け情報検索画面で対象のトランザクションが実行された時刻を入力すると、その時刻に対応したグラフを表示できる。

TP1/Server Base稼働サーバとデータベースサーバとの間のトランザクション情報

表示されない。

ただし、関連付け情報検索画面で対象のトランザクションが実行された時刻を入力すると、その時刻に対応したグラフを表示できる。

PRFトレースが取得できない場合

一時的な通信障害などでPRFトレースファイルを取得できない場合、システム分析支援リアルタイムモニタのメイン画面で表示するPRFトレース情報は更新されません。情報の表示の有無を次に示します。

情報の種類

表示の有無

クライアントとTP1/Server Base稼働サーバとの間のトランザクション情報

表示される。

TP1/Server Base稼働サーバの情報

表示されない。

TP1/Server Base稼働サーバとデータベースサーバとの間のトランザクション情報

表示される。

また、回復不可能な原因でPRFトレースファイルの取得に失敗した場合は、該当するTP1/Server Base稼働サーバに対して、定期的なPRFトレースファイルの取得処理を中断します。

TP1/Server Base稼働サーバとDBサーバとの間のパケットキャプチャができない場合

システム分析支援リアルタイムモニタのダッシュボードのメイン画面では、TP1/Server Base稼働サーバとDBサーバとの間のトランザクション情報は表示されません。情報の表示の有無を次に示します。

情報の種類

表示の有無

クライアントとTP1/Server Base稼働サーバとの間のトランザクション情報

表示される。

TP1/Server Base稼働サーバの情報

表示される。

TP1/Server Base稼働サーバとデータベースサーバとの間のトランザクション情報

表示されない。

系切り替え検出時に表示されるトランザクション情報

PRFトレースファイルの更新時刻が時系列に並んでいない場合、または最新のPRFトレースファイルのスワップが世代番号順になっていない場合は、系切り替えが発生したものと判断します。

このとき、系切り替えが発生した監視間隔中のPRFトレース情報が欠落するため、システム分析支援リアルタイムモニタでその間のトランザクション情報は表示されません。

2　稼働情報の分析

システム分析支援リアルタイムモニタの稼働情報の分析について説明します。分析対象となるプロトコルは、HTTPプロトコル、TCPプロトコル、RPCプロトコル、IIOPプロトコル、HiRDBプロトコル（サーバ間連携機能未使用時だけ）です。

2.1　稼働情報の分析の種類

システム分析支援アダプタから送られた稼働情報を分析・集計し、レスポンスタイムやスループット（TPS）を抽出します。

システム分析支援リアルタイムモニタで実施できる、稼働情報の分析の種類を次に示します。

表2‒1　稼働情報の分析の種類

項目

分析内容

分析結果のユーザーへの通知方法

レスポンス監視

トランザクションごとに応答時間を計測し、アラート検知、および外れ値検知を行います。

メッセージの出力

JP1イベントの出力

ダッシュボードへの表示（アラート検知画面、稼働情報画面）

メールでの通知

TPS分析

1秒当たりに実行されたトランザクション件数を計測します。

ダッシュボードへの表示（グラフ画面）

平均応答時間分析

1秒当たりに実行されたトランザクションの平均応答時間を計測します。

ダッシュボードへの表示（グラフ画面）

2.1.1　レスポンス監視

レスポンス監視では、クライアントからサーバへの要求電文とその応答電文の対応づけをして、すべてのトランザクションのトランザクション性能（応答時間）を算出します。HiRDBプロトコルの場合、1回のSQL文の実行で複数の要求電文と応答電文の通信が行われますが、SQL文の実行単位でトランザクション性能（応答時間）を算出します。応答時間は、システム分析支援アダプタが電文をキャプチャした時刻を基に算出します。

システム分析支援リアルタイムモニタのレスポンス監視では、応答時間の情報を基に次の監視を行います。

表2‒2　レスポンス監視の監視項目

項目

内容

アラート検知

トランザクション性能（応答時間）が、定義した閾値を超過した場合などを検知する監視方法です。

外れ値検知

トランザクション性能が平均値と大きく異なっている場合に、異常の予兆として検知する監視方法です。

アラート検知

アラート検知は、トランザクション性能が、定義した閾値を超過した場合などを検知する監視方法です。検知対象となる項目を次に示します。

トランザクション性能が閾値超過

稼働情報編集UOC指示

応答待ちタイムアウト検知（コネクション切断、パケットロスト含む）

プロトコルレベルエラー検知

RPCプロトコルの場合

リターン値が0以外

IIOPプロトコルの場合

応答電文がReply（システム例外、ユーザー例外）、またはCancelRequest

トランザクション性能が閾値を超過して危険域に達したなどのアラートを検知したときは、次の処理を実施できます。

KFSE84215-Iメッセージを出力してJP1イベントを発行します。

ダッシュボードのアラート検知画面に表示します。

ダッシュボードの稼働情報画面の稼働情報レコードに色を付けて表示します。

アラートをメールで通知します。

プロトコル関連定義でプロトコルごと（web_threshold_watchtime、tcp_threshold_watchtime、iiop_threshold_watchtime、rpc_threshold_watchtime、hirdb_threshold_watchtime）にトランザクション性能の閾値を指定します。定義の詳細は「7.3　システム分析支援リアルタイムモニタ定義ファイル」を参照してください。

ダッシュボードの情報については、「4.3　システムの稼働状況を確認する」を参照してください。

メールでのアラートの通知については、「6.2　アラートのメール通知」を参照してください。

外れ値検知

外れ値検知は、トランザクション性能がふだんのトランザクション性能と大きく異なっている場合に、トランザクション性能の異常の予兆として検知する監視方法です。過去に実行したトランザクションの性能からシステム名ごとに平均値（平均応答時間）を算出して、平均値と大きく異なる値を外れ値として検知します。平均値の算出範囲は、稼働情報分析関連定義のoutlier_rangeプロパティで指定します。

トランザクション性能が平均応答時間から外れ値を超えて乖離したときは、ダッシュボードの稼働情報画面の稼働情報レコードに色を付けて表示します。

外れ値については、稼働情報分析関連定義のoutlierプロパティで指定します。定義の詳細は「7.3.3　稼働情報分析関連定義」を参照してください。

ダッシュボードの情報については、「4.3　システムの稼働状況を確認する」を参照してください。

ふだんと異なるトランザクション性能が検知されたときの例を次に示します。

図2‒1　外れ値検知でふだんと異なるトランザクション性能が検知された例

2.1.2　TPS分析

1つのトランザクションを1件としてカウントします。この情報は1秒おきにダッシュボードに出力されます。

2.1.3　平均応答時間分析

1秒当たりのトランザクションの平均応答時間を算出します。トランザクションの応答時間は、システム分析支援アダプタが電文をキャプチャした時刻を基に算出します。この情報は1秒おきにダッシュボードに出力されます。

2.2　蓄積した稼働情報の抽出およびファイル出力

稼働情報は、稼働情報ファイルに蓄積されます。蓄積された稼働情報は、稼働情報抽出ユティリティで抽出したり、コマンドでファイルに出力したりできます。

2.2.1　稼働情報ファイルへの稼働情報の蓄積

稼働情報蓄積とは、稼働情報を次に示す2つのファイルに取得して、永続化することです。

稼働情報ファイル※

稼働情報管理ファイル※

注※　以降の説明では、特にファイル名を併記していない場合、「稼働情報ファイル」と表記するときに「稼働情報管理ファイル」を含みます。

稼働情報ファイルに取得した稼働情報は、稼働情報抽出ユティリティを実行することで、ユーザー任意の検索条件で抽出できます。

稼働情報ファイルは、システム分析支援アダプタ起動時に作成し、定義されたファイルサイズに達したときは新たに稼働情報ファイルを作成して書き込み先を切り替えます。

開始時の稼働情報ファイルの決定

システム分析支援アダプタの起動時、前回の終了状態から稼働情報ファイルの新規作成または継続使用を決定します。前回、正常終了しているときは、新規に稼働情報ファイルを作成し、異常終了しているときは、前回使用した稼働情報ファイルを継続して使用します。

稼働情報ファイルの削除

システム分析支援アダプタの起動時、システム分析支援リアルタイムモニタ定義ファイルの稼働情報蓄積関連定義のfile_delプロパティにYを指定している場合、以前に作成した稼働情報ファイルをすべて削除します。また、次のどちらかの場合、稼働情報管理ファイルおよび稼働情報ファイルを削除します。

稼働情報管理ファイルがない場合

save_user_dataプロパティにYを指定して作成した稼働情報ファイルがない場合

稼働情報ファイル数がfilenoプロパティ値に達したとき、古い方から順に稼働情報ファイルを削除します。稼働情報ファイルの全体サイズがall_fileszプロパティ値を超過したとき、古い方から順に稼働情報ファイルを削除します。削除対象の稼働情報ファイルが大量・大容量である場合、システム分析支援アダプタの起動に時間が掛かることがあります。

稼働情報ファイルのスワップ

稼働情報ファイルの書き込み先を切り替えることをスワップと呼びます。

スワップを行うタイミングを次に示します。

ファイルサイズによるスワップ

稼働情報ファイルのサイズが、システム分析支援リアルタイムモニタ定義の稼働情報蓄積関連定義のfileszプロパティに指定したサイズに達したときにスワップします。

書き込み件数によるスワップ

稼働情報が1000万件を超えたときにスワップします。

書き込みエラーによるスワップ

稼働情報ファイルへの書き込みエラーが発生したときは、スワップします。

障害時対応

稼働情報ファイルの出力先がディスク容量不足によって書き込めなくなったときは、以前に作成したいちばん古い稼働情報ファイルを削除して処理を継続します。稼働情報ファイルへの書き込みエラーなどが発生し、稼働情報を稼働情報ファイルに書き込めないときは、KFSE50966-Eメッセージを出力して稼働情報の出力を停止します。

2.2.2　稼働情報抽出ユティリティによる稼働情報の抽出

稼働情報ファイルに取得した稼働情報は、稼働情報抽出ユティリティが提供するライブラリ関数を使用することで、ユーザー任意の検索条件で抽出できます。詳細については、「9.　UOCインタフェース」を参照してください。

2.2.3　コマンドによる稼働情報のファイル出力

稼働情報を集計して、稼働状況を分析するために必要な情報をCSVファイルに出力できます。稼働情報のファイル出力には、esrtmstcedコマンドを使用します。コマンドについては「8.4.3　esrtmstced（稼働情報のファイル出力）」を参照してください。

図2‒2　稼働情報のファイル出力

2.2.4　稼働情報の蓄積で使用するファイル

ファイルの構成

稼働情報は、次の3つのファイルで管理しています。

稼働情報蓄積機能管理ファイル（以降、管理ファイルと略す）

稼働情報管理ファイルと稼働情報ファイルを管理します。

稼働情報管理ファイル

稼働情報に関する情報を管理します。稼働情報ファイルと対となります。

稼働情報ファイル

稼働情報を管理します。

ファイルの命名規則

各ファイルの命名規則を次に示します。

ファイル

ファイル名

管理ファイル

アダプタ識別子CTL

稼働情報管理ファイル

アダプタ識別子IDX時刻※

稼働情報ファイル

アダプタ識別子DAT時刻※

注※

時刻は、YYYYMMDDhhmmssnn（YYYY（年）、MM（月）、DD（日）、hh（時）、mm（分）、ss（秒）、nn（カウンタ：01～99））の形式で表示されます。

ファイル格納ディレクトリ

各ファイルの格納ディレクトリを次に示します。

ファイル

ディレクトリ

管理ファイル

システム分析支援リアルタイムモニタ定義のsave_dirプロパティ指定値

稼働情報管理ファイル

稼働情報ファイル

稼働情報蓄積ユティリティ実行時の運用

稼働情報ファイルを別ディスクなどに移動/コピーしてから稼働情報抽出ユティリティを実行するときは、稼働情報管理ファイルと稼働情報ファイルを対にして移動/コピーしてください。また、稼働情報管理ファイルと稼働情報ファイルのファイル名は変更しないでください。

注意事項

各ファイルを編集した場合の動作は保証できません。

管理ファイルを削除した場合の動作は保証できません。

3　システムの構築

システム分析支援リアルタイムモニタのシステムの構築について説明します。

3.1　システムの構築の流れ

システム分析支援リアルタイムモニタのシステムの構築の流れを次に示します。

図3‒1　システムの構築の流れ

必須の手順については、この章の各節で説明します。

任意の手順については、次の個所を参照してください。

稼働情報を取得するためのUOCの作成

「9.　UOCインタフェース」を参照してください。

稼働情報を取得するためのUAPの作成

「10.　稼働情報抽出ユティリティ」を参照してください。

JP1/IM連携の設定

「6.　他システムとの連携」を参照してください。

3.2　システムの構築の準備

システム分析支援リアルタイムモニタのシステムを構築する前に、次のことを実施してください。

表3‒1　システムの構築の準備で実施すること

項目

説明

運用ディレクトリの作成の準備

運用ディレクトリは、システム分析支援リアルタイムモニタの実行で使用する実行環境です。

システムの構築の準備では、次の作業を実施してください。

運用ディレクトリを作成するディスクに、運用ディレクトリの作成に必要なディスク容量があることを確認します。

運用ディレクトリの作成に必要なディスク容量については、システム分析支援リアルタイムモニタのリリースノートを参照してください。

手順1.で容量を確認したディスクの任意の場所に、運用ディレクトリとして使用するディレクトリを作成します。

「3.5　実行環境の作成」で、esrtmsetup（実行環境のセットアップ）コマンドを実行するときに、ここで作成したディレクトリを指定します。

標準ホスト名の確認

標準ホスト名はOSのhostnameコマンド実行時に表示されるホスト名です。

標準ホスト名をアドレス変換して、ローカルループバックアドレス（127.0.0.1）以外のIPアドレスで変換できるかを確認してください。

変換できない場合、またはローカルループバックアドレスに変換された場合は、次のどちらかの方法を実施してください。

システム分析支援リアルタイムモニタをインストールするマシンの標準ホスト名とIPアドレスを、DNSに登録する。

システム分析支援リアルタイムモニタをインストールするマシンの標準ホスト名とIPアドレスを、hostsファイルに記述する。

「4.3　システムの稼働状況を確認する」で、ダッシュボードを起動するときに指定するURLの中に、ここで確認したホスト名を指定します。

Webサーバのポート番号の決定

ダッシュボード画面を参照するために、WebブラウザからアクセスするWebサーバ（システム分析支援リアルタイムモニタのこと）のポート番号を決定します。

5001～65535の半角数字を指定してください。デフォルト値は、29104です。

「3.4　システム分析支援リアルタイムモニタのインストール」で、ここで決定したポート番号を指定します。

3.3　前提プログラムのインストール

システム分析支援リアルタイムモニタの前提プログラムをインストールします。なお、前提プログラムのバージョンについては、システム分析支援リアルタイムモニタのリリースノートを参照してください。

システム分析支援リアルタイムモニタをインストールするマシン

システム分析支援リアルタイムモニタをインストールする前に、次の前提プログラムをインストールしてください。

システム検証支援基盤（Hitachi System Information Capture）

システム分析支援リアルタイムモニタでは、システム検証支援基盤（Hitachi System Information Capture）をシステム分析支援アダプタとして使用します。Hitachi System Information Captureのインストール方法については、マニュアルHitachi System Information Capture 基本ガイドを参照してください。

システム分析支援リアルタイムモニタのダッシュボード画面を参照するマシン

次の前提プログラムをインストールしてください。

Flash Player

Internet Explorer

3.4　システム分析支援リアルタイムモニタのインストール

システム分析支援リアルタイムモニタのインストールについて説明します。

前提条件

システム分析支援アダプタのインストールが完了している。

Administrators権限でログインしている。

なお、初回インストールでない場合は、次の点に注意してください。

システム分析支援リアルタイムモニタのインストール時は、次に示すWindowsのシステム環境変数を更新します。

システム環境変数

設定値

HSICRealTimeMonitor_ROOT

システム分析支援リアルタイムモニタのインストールディレクトリのパス

SDP_HNTRCLASSPATH

システム分析支援リアルタイムモニタの実行に使用するディレクトリパス

インストールマシンにこれらのシステム環境変数が設定してある場合、バックアップを取ってください。

上書きインストールする場合、システム分析支援リアルタイムモニタが停止しているかを確認してください。システム分析支援リアルタイムモニタが起動している場合、esrtmstopコマンドを実行して正常終了してください。その後、esrtmunsetupコマンドを実行して、システム分析支援リアルタイムモニタの実行環境を削除してください。

手順

インストール媒体（CD-ROM）をCD-ROMドライブにセットします。

日立総合インストーラーが起動します。

起動しない場合は、CD-ROM内のHCD_INST.EXEを実行してください。

インストーラーの指示に従ってインストールを進めます。

［ユーザ情報］を入力します。

［ユーザー名］：最大50文字の文字列を指定してください。

［会社名］：最大512文字の文字列を指定してください。

［インストール先のフォルダ］でインストール先のディレクトリを確認し、必要に応じてインストール先ディレクトリを変更します。

デフォルトでは、OSインストールドライブ:¥Hitachi¥HSIC_RTM¥が設定されます。

変更したい場合は［変更］ボタンをクリックし、任意のディレクトリを選択してください。

選択した任意のディレクトリに¥Hitachi¥HSIC_RTM¥ディレクトリが作成されて、そのディレクトリにシステム検証支援基盤がインストールされます。

選択したディレクトリが「～¥Hitachi¥」の場合は、ディレクトリ直下に¥HSIC_RTM¥ディレクトリが作成されて、そのディレクトリにシステム検証支援基盤がインストールされます。

選択したディレクトリが「～¥Hitachi¥HSIC_RTM¥」の場合は、そのディレクトリにシステム検証支援基盤がインストールされます。

ここで指定したインストール先ディレクトリは、環境変数HSICRealTimeMonitor_ROOTに設定されます。

注意事項

絶対パスで80バイト以内の文字列を指定してください。

UNC表記はできません。

ネットワークドライブは指定できません。

インストール先ディレクトリのパス中には「#」およびマルチバイト文字を指定できません。

先頭が小文字の「u」で始まるディレクトリは指定できません。

［Webサーバポート番号］を指定します。

「3.2　システムの構築の準備」で決定したポート番号を指定してください。

5001～65535の半角数字を指定してください。デフォルト値は、29104です。

［プログラムをインストールする準備ができました］に表示された内容に問題がなければ、［インストール］ボタンをクリックします。

インストールを実行中に［キャンセル］ボタンをクリックしてインストールを中断した場合、システム分析支援リアルタイムモニタの実行環境が正常に作成されないおそれがあります。インストールを中断した場合は、再度、手順1.から実行してください。

インストール処理が完了したら、マシンを再起動します。

システム分析支援リアルタイムモニタのインストールが完了します。

次に示すすべての条件に該当する場合は、インストール先ディレクトリにアクセス権を追加するために、OSのicaclsコマンドを実行します。

Administrator以外のユーザーでシステム分析支援リアルタイムモニタを使用する。

OSのユーザーアカウント制御（UAC）機能が動作するパス（C:¥Program Files、C:¥ProgramData、またはC:¥Windows）にシステム分析リアルタイムモニタをインストールした。

OSのユーザーアカウント制御（UAC）機能の「管理者承認モードですべての管理者を実行する」が有効になっている。

OSのユーザーアカウント制御（UAC）機能の設定は、次の手順で確認できます。

1.OSのコントロールパネルを起動します。

2.［管理ツール］をクリックします。

3.［ローカルセキュリティポリシー］をクリックします。

4.［ローカルポリシー］－［セキュリティオプション］を選択します。

5.［ユーザーアカウント制御: 管理者承認モードですべての管理者を実行する］ポリシーのセキュリティ設定が有効になっているかを確認します。

icaclsコマンドの実行例

icacls %HSICRealTimeMonitor_ROOT% /t /grant everyone:(OI)(F)

3.5　実行環境の作成

システム分析支援リアルタイムモニタの実行環境の作成について説明します。

前提条件

システム分析支援リアルタイムモニタのインストールが完了している。

運用ディレクトリとして使用するディレクトリが作成されている。

手順

esrtmsetup（実行環境のセットアップ）コマンドを実行します。

esrtmsetup -d 運用ディレクトリ

-dオプションには、「3.2　システムの構築の準備」で作成したディレクトリを指定します。

コマンドの詳細については、「8.3.3　esrtmsetup（実行環境のセットアップ）」を参照してください。

3.6　定義ファイルの作成

定義ファイルを作成して、システム分析支援リアルタイムモニタの動作環境を定義します。

「3.5　実行環境の作成」で実行環境を作成すると、運用ディレクトリ下に定義ファイルが作成されます。運用ディレクトリ下のファイルを変更してください。

システム分析支援リアルタイムモニタ定義ファイル（hsicrtm_config.properties）は必ず変更してください。このほかのファイルは、必要に応じて変更してください。

定義ファイルの変更の要否については、「7.2　システム定義の一覧」を参照してください。

3.7　サーバ間連携機能を使用する場合の環境設定

システム分析支援リアルタイムモニタでサーバ間連携機能を使用する場合の環境設定について説明します。

対象ソフトウェアの設定

クライアントでの設定

監視したいTP1/Server Baseへ接続するクライアントで、次に示す項目が設定されている必要があります。

表3‒2　クライアントでの設定項目

クライアント種別

設定項目

設定値

TP1/Client/P

環境変数DCCLTPRFINFOSEND

性能検証用トレースの識別情報を、TP1/Server Baseへ伝播するかどうかを指定します。

Y：性能検証用トレースの識別情報を、TP1/Server Baseに伝播します。

N：性能検証用トレースの識別情報を、TP1/Server Baseに伝播しません。

Y

TP1/Client/W

環境変数DCCLTPRFINFOSEND

性能検証用トレースの識別情報を、TP1/Server Baseへ伝播するかどうかを指定します。

Y：性能検証用トレースの識別情報を、TP1/Server Baseに伝播します。

N：性能検証用トレースの識別情報を、TP1/Server Baseに伝播しません。

Y

TP1/Client/J

環境定義dccltprfinfosend

性能検証用トレースの識別情報を付加するかどうかを指定します。

Y：性能検証用トレースの識別情報を付加します。

N：性能検証用トレースの識別情報を付加しません。

Y

TP1/Server Base（SUPまたはSPP）

－

－

（凡例）

－：設定が必要な項目および設定する値はありません。

TP1稼働サーバでの設定

監視したいTP1/Server Baseで、次に示す定義が設定されている必要があります。

表3‒3　TP1/Server Baseでの設定項目

定義種別

オペランド名

設定値

システム共通定義

prf_trace

Y

rapリスナーサービス定義※1

scs_prf_trace_level

00000001を論理和で指定

トランザクションサービス定義

trn_extend_function

00000002を論理和で指定

ロックサービス定義※2

lck_prf_trace_level

00000001を論理和で指定

システム共通定義※3

nam_prf_trace_level

00000001を論理和で指定

注※1

リモートAPI機能（RAP）を使用する場合に設定が必要です。

注※2

排他機能を使用する場合に設定が必要です。設定しない場合はRTMで表示される排他情報がすべて「0」となります。

注※3

RPCプロトコルでネームサービス機能を使用した場合に設定が必要です。設定しない場合はRTMで表示されるネーム情報がすべて「0」となります。

メモ

サーバ間連携機能を使用する前に、次の前提条件を満たしているか確認してください。

監視対象のTP1/Server Baseが稼働しているサーバでFTPサーバが稼動している。

FTP接続時のホームディレクトリ配下でTP1/Server BaseのPRFトレースファイルの格納ディレクトリを参照できる。

その他の設定

SQLの情報も業務の流れと関連づけて表示したい場合は、SQLを実行する際にHiRDBクライアント環境変数に、次に示す定義を指定する必要があります。

PDUAPREPLVL=ut

uの代わりにaを指定できます。

PDSQLTRACE=SQLトレースファイルのサイズ

指定できる値は、4096～2000000000（単位：バイト）です。

4　システムの運用

システム分析支援リアルタイムモニタのシステムの運用について説明します。

4.1　システムの運用の流れ

システム分析支援リアルタイムモニタのシステムの運用の流れを次に示します。

システムを起動する

コマンドを実行して、システム分析支援リアルタイムモニタを起動します。

起動の操作については、「4.2　システムを起動する」を参照してください。

システムの稼働状況を確認する

ダッシュボード画面を参照して、システムの稼働状況を確認します。

ダッシュボードの起動、およびダッシュボード画面での稼働状況の確認の操作については、「4.3　システムの稼働状況を確認する」を参照してください。

ダッシュボード画面の詳細については、「4.5　ダッシュボード画面の構成」を参照してください。

システムを停止する

システム分析支援リアルタイムモニタを停止する場合（例：監視をやめる）は、コマンドを実行して停止します。

停止の操作については、「4.4　システムを停止する」を参照してください。

4.2　システムを起動する

システム分析支援リアルタイムモニタの起動手順を次に示します。

前提条件

Administrators権限でログインしている

操作手順

システム分析支援リアルタイムモニタの起動に必要な定義を指定します。

システム分析支援リアルタイムモニタの初回起動前には必ず定義ファイルを編集してください。

また、前回の起動から動作を変更したい場合も定義ファイルを編集してください。

esrtmstartコマンドを実行します。

システム分析支援リアルタイムモニタの運用ディレクトリ¥bin¥esrtmstart

コマンドが正常に終了すると、システム分析支援リアルタイムモニタが起動して、稼働情報の収集と分析を開始します。

なお、システム分析支援リアルタイムモニタの起動時に、自動でシステム分析支援アダプタも起動されます。

esrtmstartコマンドの詳細は「8.3.4　esrtmstart（起動）」を参照してください。

4.3　システムの稼働状況を確認する

ダッシュボードを表示するWebブラウザの設定について

ダッシュボード出力を正しく表示するために、Webブラウザのインターネット一時ファイルに関する設定を行います。

［ツール］－［インターネットオプション］－［全般］タブで、［閲覧の履歴］の［設定］ボタンをクリックします。

［Webサイトデータの設定］の［インターネット一時ファイル］タブで、［保存しているページの新しいバージョンがあるかどうかの確認］の［Webサイトを表示するたびに確認する］を選択します。

ダッシュボードを起動する

Webブラウザから次のURLを入力します。

http://システム分析支援リアルタイムモニタが稼働しているホスト名:ポート番号/URLパターン名/

ポート番号

インストール時に設定したWebサーバのポート番号

URLパターン名

HSICRealTimeMonitor

ダッシュボードの表示情報の更新について

ダッシュボードに表示する情報は一定間隔で更新します。ダッシュボードの更新間隔を次に示します。

表4‒1　ダッシュボードの更新間隔

項目

更新間隔

アラート検知

10秒

グラフ

1秒

稼働情報

10秒

Webブラウザの「最新の情報に更新」について

ダッシュボード実行中に次の現象が発生した場合、Webブラウザの［最新の情報に更新］を実行して再表示してください。

Webブラウザの画面サイズを極端に縮小して、画面が応答しなくなった場合

ダッシュボード更新時のスクロールバー操作や詳細画面の移動操作によって、画面が正しく表示されない場合や操作できなくなった場合

システム分析支援リアルタイムモニタを再起動した際は、Webブラウザの［最新の情報に更新］を実行して再表示してください。

Webブラウザの［最新の情報に更新］を実行した場合、ダッシュボード画面は初期状態で表示されます。

4.4　システムを停止する

システム分析支援リアルタイムモニタの停止手順を次に示します。

前提条件

Administrators権限でログインしている

操作手順

esrtmstopコマンドを実行します。

システム分析支援リアルタイムモニタの運用ディレクトリ¥bin¥esrtmstop

コマンドが正常に終了すると、システム分析支援リアルタイムモニタが停止して、稼働情報の収集と分析を終了します。

なお、システム分析支援リアルタイムモニタの停止時に、自動でシステム分析支援アダプタも停止されます。

esrtmstopコマンドの詳細は「8.3.5　esrtmstop（停止）」を参照してください。

4.5　ダッシュボード画面の構成

ここでは、ダッシュボード画面の構成について説明します。

4.5.1　ダッシュボード画面の一覧

システム分析支援リアルタイムモニタのダッシュボード画面の一覧を次に示します。

表4‒2　ダッシュボード画面の一覧

画面名

説明

メイン画面

操作メニューとダッシュボードのフレームを表示します。

ブラウザからWebサーバへアクセスすると表示されます。

アラート検知画面

閾値超過やタイムアウトなどのアラートを検知したトランザクションの稼働情報を表示します。

この画面はメイン画面のアラート表示エリアの［Alert TRN］タブ内に表示されます。

グラフ画面

TPSと平均応答時間をグラフに表示します。

この画面はメイン画面のグラフ表示エリアに表示されます。

稼働情報画面

トランザクションの稼働情報を表示します。

この画面はメイン画面のアラート表示エリアの［Completed TRN］タブ内に表示されます。

稼働情報詳細画面

トランザクションの稼働情報の詳細情報を表示します。

この画面は、アラート検知画面または稼働情報画面でレコードをダブルクリックすると、ポップアップでメイン画面上に表示されます。

関連付け情報画面

サーバ間連携機能またはHiRDBプロトコルを使用した場合にトランザクションに関連づけられた情報を表示します。

関連付け情報検索画面

サーバ間連携機能またはHiRDBプロトコルを使用した場合にトランザクションに関連づけられた情報を検索します。

比較情報画面

サーバ間連携機能を使用した場合、RPCプロトコルの比較情報についての操作メニューとフレームを表示します。

グラフ比較画面

集計項目ごとに比較元と比較先の稼働情報のグラフを表示します。この画面は比較情報画面のフレームとして表示されます。

4.5.2　メイン画面

メイン画面の構成、画面に表示される項目について説明します。

メイン画面の構成

図4‒1　メイン画面

表示選択エリア

図4‒2　表示選択エリア

1.　データ更新ボタン

［リアルタイムデータ更新ON］

ダッシュボードのデータの自動更新を開始します。

このボタンは、自動更新をしていない場合だけ表示します。

［リアルタイムデータ更新OFF］

ダッシュボードのデータの自動更新を停止します。

このボタンは、自動更新中の場合だけ表示します。

画面はOFFボタンをクリックしたときの表示内容を保持します。

2.　過去の稼働情報取得ボタン

アラート検知画面、または稼働情報画面に、過去情報取得数スクロールバーで指定した数の過去の稼働情報を取得して表示します。リアルタイムデータ更新OFFのときだけ使用できます。

3.　グラフ表示対象システム選択ドロップダウンリスト

グラフ画面に表示する対象のシステム名を指定します。

4.　グラフレンジスクロールバー

グラフ画面のスループット（TPS）と平均応答時間のレンジを指定します。平均応答時間グラフレンジについては、時間切替ボタンをクリックして単位を「秒」または「ミリ秒」に設定できます。

［TPSグラフレンジ］

10～2000（10件刻み）（デフォルト値：300）（単位：件）

［平均応答時間グラフレンジ］

10～5000（10ミリ秒刻み）（デフォルト値：1000）（単位：ミリ秒）

5～3600（5秒刻み）（デフォルト値：5）（単位：秒）

5.　時間切替ボタン

平均応答時間グラフレンジの単位を「秒」または「ミリ秒」に設定します。

6.　タブ（稼働情報）

［Alert TRN］タブ

閾値超過やタイムアウトなどのアラートを検知したトランザクションの稼働情報（アラート検知画面)をメイン画面に表示します。詳細については、「4.5.3　アラート検知画面」を参照してください。

［Completed TRN］タブ

処理が完了したトランザクションの稼働情報（稼働情報画面）をメイン画面に表示します。詳細については、「4.5.5　稼働情報画面」を参照してください。

7.　過去情報取得数スクロールバー

過去の稼働情報を取得する件数をスクロールバーで指定します。

10～5000件（10件刻み）（デフォルト値：100）（単位：件）

8.　関連付け情報検索画面表示ボタン

関連付け情報検索画面を別ウィンドウで開きます。画面の詳細については、「4.5.7　関連付け情報画面」を参照してください。次のどちらかの条件を満たす場合だけ使用できます。

サーバ間連携関連定義rpc_linkにYを指定

プロトコル関連定義hirdb_serverを指定

9.　関連付け情報表示ボタン

アラート検知表示エリアまたは稼働情報表示エリアで選択された項目の関連付け情報画面をポップアップでメイン画面上に表示します。次のどちらかの条件を満たし、アラート検知表示エリアまたは稼働情報表示エリアでレコードを選択していたときだけ使用できます。

サーバ間連携関連定義rpc_linkにYを指定（RPCプロトコルのレコードを選択）

プロトコル関連定義hirdb_serverを指定（HiRDBプロトコルのレコードを選択）

10.　比較情報画面表示ボタン

比較情報画面を別ウィンドウで開きます。画面の詳細については、「4.5.9　比較情報画面」を参照してください。

次の条件を満たす場合だけ使用できます。

サーバ間連携関連定義rpc_linkにYを指定

警告エリア

稼働情報蓄積機能が閉塞したとき、［閉塞］を点滅して表示します。システム分析支援アダプタのログを確認し、エラーメッセージに従って障害に対処してください。その後、システム分析支援リアルタイムモニタを再起動してください。

アラート表示エリア

［Alert TRN］タブを選択した場合に表示される内容については、「4.5.3　アラート検知画面」を参照してください。

［Completed TRN］タブを選択した場合に表示される内容については、「4.5.5　稼働情報画面」を参照してください。

グラフ表示エリア

スループット（TPS）と平均応答時間をグラフ表示します。表示される内容については、「4.5.4　グラフ画面」を参照してください。

4.5.3　アラート検知画面

アラート検知画面は、メイン画面のアラート表示エリアの［Alert TRN］タブ内に表示されます。

図4‒3　アラート検知画面

アラート検知画面では、閾値超過やタイムアウトなどのアラートを検知したトランザクションの稼働情報（分析開始以降の稼働情報）を一覧表示します。

アラート検知画面に表示される項目

アラート検知画面に表示される項目を次に示します。

表4‒3　アラート検知画面に表示される項目

ヘッダの表示項目名

説明

レスポンスタイム

トランザクション性能（応答時間）をマイクロ秒で表示します。

応答種別がNONEのときは、0を表示します。

トランザクション開始時刻

トランザクションを開始した時刻を

「YYYY-MM-DD hh:mm:ss.SSSSSS」形式で表示します。

トランザクション終了時刻

トランザクションを終了した時刻を

「YYYY-MM-DD hh:mm:ss.SSSSSS」形式で表示します。

稼働情報種別がTIMEOUTのときは、そのときの時刻を表示します。

稼働情報種別

稼働情報の種別を表示します。

複数の種別が重複しているときは、ユーザー指示を優先します。

RESPONSE：応答電文あり

NONE：応答電文なし

TIMEOUT：応答電文待ちタイムアウト検知

コネクション切断やパケットロストによって、応答電文を受信できない場合も含みます。

PROTOCOL：プロトコルレベルエラー検知

USER：ユーザー指示あり（稼働情報編集UOC）

クライアントIPアドレス

クライアントのIPアドレスを表示します。

クライアントポート番号

クライアントのポート番号を表示します。

サーバIPアドレス

サーバ（要求電文の送信先）のIPアドレスを表示します。

サーバポート番号

サーバ（要求電文の送信先）のポート番号を表示します。

システム名

稼働情報編集UOC、または稼働情報分析関連定義で指定されたシステム名を1～31文字の文字列で表示します。UOC、および稼働情報分析関連定義での指定がなかったときは、次のプロトコル情報を表示します。

TCP：TCPプロトコル

HTTP：HTTPプロトコル

IIOP：IIOPプロトコル

HIRDB：HiRDBプロトコル

ユーザ情報コード

稼働情報編集UOCで指定されたユーザ情報コードを表示します。UOCでの指定がなかったときは、0が表示されます。

稼働情報の表示件数

最新の稼働情報を最大50件まで表示します。以前の稼働情報については、過去の稼働情報取得ボタンをクリックすると、最大でセットアップ時に指定したアラート検知稼働情報最大保持件数まで表示できます。

ヘッダの表示項目名をクリックすることで、クリックした項目についてソートできます。なお、アラート検知画面が更新されると、指定した列はリセットされます。このため、ダッシュボードの自動更新をOFFにしてからソートすることを推奨します。

4.5.4　グラフ画面

グラフ画面は、メイン画面のグラフ表示エリアに表示されます。

グラフ画面では、スループット（TPS）と平均応答時間をグラフ表示します。

グラフ画面に表示される項目

グラフの横軸は時刻、縦軸はスループット（TPS）と平均応答時間です。時刻はシステム分析支援アダプタがキャプチャした時刻です。

選択するタブによって、表示されるグラフが変わります。

［選択表示］タブを選択した場合

グラフ表示対象システム選択ドロップダウンリストで選択したシステムについて、スループット（TPS）と平均応答時間をグラフ表示します。

図4‒4　［選択表示］タブを選択した場合の表示例

ドロップダウンリストで選択できる項目を次に示します。

［ALL_SYSTEM］

全システムの稼働状況を表示します。

表示対象のデフォルト値です。

［システム名］

watch_system_nameプロパティに指定したシステム名の稼働状況を表示します。

［HTTP］

Webシステム（HTTPプロトコル）の稼働状況を表示します。

watch_system_nameプロパティを省略した場合だけ選択できます。

［TCP］

TCPプロトコルシステムの稼働状況を表示します。

watch_system_nameプロパティを省略した場合だけ選択できます。

［IIOP］

CORBAシステム（IIOPプロトコル）の稼働状況を表示します。

watch_system_nameプロパティを省略した場合だけ選択できます。

［RPC］

OpenTP1システム（RPCプロトコル）の稼働状況を表示します。

watch_system_nameプロパティを省略した場合だけ選択できます。

［HIRDB］

HiRDBシステム（HiRDBプロトコル）の稼働状況を表示します。

watch_system_nameプロパティを省略した場合だけ選択できます 。

［OTHER_SYSTEM］

上記以外の稼働状況を表示します。

watch_system_nameプロパティを指定した場合だけ選択できます。

watch_system_nameプロパティについては、「7.3.3　稼働情報分析関連定義」を参照してください。

［全表示］タブを選択した場合

グラフ表示対象システム選択ドロップダウンリストで選択できる全システムについて、システムごとにスループット（TPS）と平均応答時間をグラフ表示します。

例えば、グラフ表示対象システム選択ドロップダウンリストで上から順に「ALL_SYSTEM」「HTTP」「TCP」「IIOP」と並んでいる場合に［全表示］タブを選択すると、次の図のように表示されます。

図4‒5　［全表示］タブを選択した場合の表示例

稼働情報の表示件数

直近3分の件数を表示します。

稼働情報の測定期間

システム分析支援リアルタイムモニタが開始してから終了するまでです。

ダッシュボード上のリアルタイムデータ更新ONボタン実行時から、常に直近3分ぶんのグラフが表示されます。ただし、分析開始後3分経過していない場合は、分析開始から現在までのグラフを表示します。

4.5.5　稼働情報画面

稼働情報画面は、メイン画面のアラート表示エリアの［Completed TRN］タブ内に表示されます。

図4‒6　稼働情報画面

処理が完了したトランザクションの稼働情報（分析開始以降の稼働情報）を一覧表示します。

稼働情報画面に表示される項目

稼働情報画面に表示される項目を次に示します。

表4‒4　稼働情報画面に表示される項目

ヘッダの表示項目名

説明

レスポンスタイム

「4.5.3　アラート検知画面」の「アラート検知表示エリア」の説明を参照してください。

トランザクション開始時刻

トランザクション終了時刻

稼働情報種別

クライアントIPアドレス

クライアントポート番号

サーバIPアドレス

サーバポート番号

システム名

ユーザ情報コード

稼働情報の表示件数

最新の稼働情報を最大100件まで表示します。過去の稼働情報については、過去の稼働情報取得ボタンをクリックすると、最大でセットアップ時に指定した稼働情報最大保持件数まで表示できます。

ヘッダの表示項目名をクリックすることで、クリックした項目についてソートできます。なお、稼働情報表示が更新されると、指定した列はリセットされます。このため、ダッシュボードの自動更新をOFFにしてからソートすることを推奨します。

警告対象の稼働情報レコード表示

警告対象の稼働情報レコードを、色分けして表示します。

表4‒5　警告対象の稼働情報レコードの色

警告内容

レコードの色

検知対象

閾値超過

赤

アラート検知

稼働情報編集UOC指示

赤

応答待ちタイムアウト

赤

外れ値超過

黄

外れ値検知

4.5.6　稼働情報詳細画面

稼働情報詳細画面は、アラート検知画面または稼働情報画面でレコードをダブルクリックすると、ポップアップでメイン画面上に表示されます。

図4‒7　稼働情報詳細画面

稼働情報詳細画面に表示される項目

稼働情報詳細画面に表示される項目を次に示します。

表4‒6　稼働情報詳細画面に表示される項目

ヘッダの表示項目名

説明

レスポンスタイム

「4.5.3　アラート検知画面」の「アラート検知表示エリア」の説明を参照してください。

トランザクション開始時刻

トランザクション終了時刻

稼働情報種別

クライアントIPアドレス

クライアントポート番号

サーバIPアドレス

サーバポート番号

システム名

ユーザ情報コード

ユーザ情報文字列

稼働情報編集UOCで指定されたユーザ情報文字列を最大127文字まで表示します。

平均応答時間

システム名ごとにoutlier_rangeプロパティに指定した数のトランザクションの平均応答時間をマイクロ秒で表示します。

電文キー

要求電文と応答電文をマッチングするための電文キーを最大64文字で表示します。

関連付け情報画面や関連付け情報検索画面では「PRFキー」として説明します。

サーバ間連携機能を使用した場合、RPCプロトコルについては次の形式で表示します。

aaaa-0xbbbbbbbb

aaaa：ルートOpenTP1識別子

bbbbbbbb：ルート通信番号

サーバ間連携機能未使用時、HiRDBプロトコルでX/OpenのXAインタフェースを使用しているときは、グローバルトランザクションIDを文字列にして表示します（ただし、グローバルトランザクションIDが24バイト以下の場合だけ）。

プロトコル情報1

プロトコル情報を最大63バイトの文字列で表示します。プロトコル情報がないときは、「-」を表示します。

HTTPプロトコル使用時は、リクエストURIを%エンコーディングして表示します。

IIOPプロトコル使用時は、オペレーション名を表示します。

RPCプロトコル使用時は、サービスグループ名を表示します。

HiRDBプロトコル使用時は、SQL文を表示します。

プロトコル情報2

プロトコル情報を最大63バイトの文字列で表示します。プロトコル情報がないときは、「-」を表示します。

HTTPプロトコル使用時は、ステータスコードを表示します。

IIOPプロトコル使用時は、応答電文のreply_statusの値を表示します。

RPCプロトコル使用時は、サービス名を表示します。

HiRDBプロトコル使用時は、SQLCODEを表示します。

プロトコル情報3

プロトコル情報を最大63バイトの文字列で表示します。プロトコル情報がないときは、「-」を表示します。

RPCプロトコル使用時は、応答電文のリターン値を表示します。

起動できる画面数

制限はありません。

画面の移動・サイズ変更

メイン画面内で移動できます。画面サイズは変更できません。

表示されるレコード情報

稼働情報詳細画面に表示される情報は、対象レコードをダブルクリックした時点のレコード情報です。レコード情報を表示したあとで、該当の稼働情報がアラート検知画面または稼働情報画面から存在しなくなっても、稼働情報詳細画面の情報は変動しません。

4.5.7　関連付け情報画面

関連付け情報画面は、アラート検知表示エリアまたは稼働情報表示エリアでレコードを選択して関連付け情報表示ボタンをクリックすると、関連づけされた情報がポップアップでメイン画面上に表示されます。

図4‒8　関連付け情報画面

関連付け情報表示領域

図4‒9　関連付け情報表示領域

関連付け情報表示領域には、アラート検知表示エリアまたは稼働情報表示エリアで選択されたレコードの関連付け情報を縦棒（以降、情報バーと記載する）でグラフィカルに表示されます。縦軸は時刻、横軸はPRFキー情報です。

情報バーは、処理開始時刻の早いものから順に、左から右に向かって配置されます。情報バーの長さはレスポンスタイムに応じて変わります。レスポンスタイムが1ミリ秒未満の情報バーについては1ミリ秒相当の長さに補正して表示されます。情報を取得した機器の設定時刻がずれていた場合、処理の呼び出し先が処理の呼び出し元よりも左側に表示されることがあります。また、処理開始時刻が同一の情報バーが複数存在した場合、実際の処理順序とは異なる順序で配置されることがあります。

情報バーは、システム分析支援リアルタイムモニタ定義ファイルに記載された配色ルールに従って順番に配色されます。ただし、サーバ間連携機能を使用する場合、PRFトレース情報を基にした情報バーで、同一のサーバOpenTP1識別子の情報を持つものは、同一色で表示されます。

縦軸は時刻の差が250ミリ秒以下の場合は、関連付け情報表示領域の下端まで拡大表示されます。

ツールチップ表示

情報バーにマウスオーバーすることでツールチップが表示されます。情報の取得元によって表示する情報が異なります。

情報取得元と表示する情報の詳細を次に示します。

表4‒7　ツールチップ表示内容

情報取得元

表示する情報

RPCパケット

トランザクション開始時刻

レスポンスタイム

クライアントIPアドレス

クライアントポート番号

PRFトレース

サービス関数開始時刻

レスポンスタイム

サーバOpenTP1識別子

サービスグループ名

サービス名

HiRDBパケット

SQL要求時刻

レスポンスタイム

SQL文

ツールチップには、「【表示する情報名】表示する情報」の形式で表示します。

（例）

【レスポンスタイム】1000us

【SQL文】SELECT COL1,COL2 from TABLE1

マルチバイト文字の場合、文字化けして表示されるおそれがあります。

SQL文は最大で255バイト分まで表示されます。255バイト以上のSQL文を確認したい場合は、HiRDBパケット情報詳細画面で確認してください。

RPCパケット情報表示

RPCパケット情報の場合、情報バーをクリックすることでRPCパケット情報詳細画面が表示されます。

表示する情報については、「RPCパケット情報詳細画面」を参照してください。

PRFトレース情報表示

PRFトレース情報の場合、情報バーをクリックすることでPRFトレース情報詳細画面が表示されます。

表示する情報については、「PRFトレース情報詳細画面」を参照してください。

HiRDBパケット情報表示

HiRDBパケット情報の場合、情報バーをクリックすることでHiRDBパケット情報詳細画面が表示されます。

表示する情報については、「HiRDBパケット情報詳細画面」を参照してください。

ハイライト表示

情報バーにマウスオーバーすることで、該当情報バーと同一の要求元クライアント、同一のサービス、または同一のデータベースの情報バーがハイライト表示されます。

同一の要求元、同一のサービスまたは同一のデータベースと判断する条件を次に示します。

表4‒8　同一ノードの判断条件

情報取得元

判断する条件

RPCパケット

クライアントIPアドレス

クライアントポート番号

PRFトレース

サーバOpenTP1識別子

サービスグループ名

サービス名

HiRDBパケット

接続先IPアドレス

接続先ポート番号

指定トランザクション削除

一部のトランザクションの情報を表示から削除したい場合、削除したいトランザクションの情報バー上で右クリックからコンテキストメニューを表示して、トランザクション削除を選択してください。

表示されているトランザクションの数が3つ以下の場合は、トランザクション削除メニューを非活性化します。

表示から削除したトランザクションを再表示したい場合は、関連付け情報画面を開き直してください。

表示倍率選択ボックス

関連付け情報表示領域の縦軸の表示倍率を選択します。

表示倍率を変更した場合、全体の時刻差に表示倍率を掛け合わせた値が250ミリ秒を超えている場合だけ選択した表示倍率に変更されます。

全体の時刻差に表示倍率を掛け合わせた値が250ミリ秒以下の場合は、表示倍率選択ボックスの値は変わりますが、表示倍率は変わりません。

表示倍率は、10%～300%まで10%刻みで選択できます。

CSVダウンロードボタン

表示中の関連付け情報をCSV形式ファイルとしてダウンロードします。保存先とファイル名を指定して、保存してください。

表示から削除したトランザクションの情報も出力されます。

RPCパケット情報詳細画面

関連付け情報画面のRPCパケット情報を表す情報バーをクリックした場合に、RPCパケット情報の詳細をポップアップでメイン画面上に表示します。

行を選択してCtrl+Cを押すと、クリップボードに選択行のデータを「項目名：値」の形式で転送します。

（例）

レスポンスタイム（マイクロ秒）：40135000

図4‒10　RPCパケット情報詳細画面

RPCパケット情報詳細表示エリア

RPCパケット情報詳細表示エリアに表示する項目を次に示します。

なお、表示する情報がない場合（ロストなどによって情報を取得できなかった場合も含む）は、値欄に「-」が表示されます。

表4‒9　RPCパケット情報詳細表示エリアの表示項目

表示項目名

説明

サーバOpenTP1識別子

サーバOpenTP1識別子を表示します。

クライアントOpenTP1識別子

クライアントOpenTP1識別子を表示します。

クライアント通信番号

クライアント通信番号を表示します。

トランザクション開始時刻

トランザクションを開始した時刻を

「YYYY-MM-DD hh:mm:ss.SSSSSS」形式で表示します。

トランザクション終了時刻

トランザクションを終了した時刻を

「YYYY-MM-DD hh:mm:ss.SSSSSS」形式で表示します。

稼働情報種別がTIMEOUTのときは、そのときの時刻を表示します。

レスポンスタイム（マイクロ秒）

トランザクション性能（応答時間）をマイクロ秒で表示します。

応答種別がNONEのときは、0を表示します。

稼働情報種別

稼働情報の種別を表示します。複数の種別が重複しているときは、ユーザー指示を優先します。

RESPONSE：応答電文あり

NONE：応答電文なし

TIMEOUT：応答電文待ちタイムアウト検知

コネクション切断やパケットロストによって、応答電文を受信できない場合も含みます。

PROTOCOL：プロトコルレベルエラー検知

USER：ユーザー指示あり（稼働情報編集UOC）

クライアントIPアドレス

クライアントのIPアドレスを表示します。

クライアントポート番号

クライアントのポート番号を表示します。

サーバIPアドレス

サーバ（要求電文の送信先）のIPアドレスを表示します。

サーバポート番号

サーバ（要求電文の送信先）のポート番号を表示します。

システム名

稼働情報編集UOC、またはsystem_nameプロパティで指定されたシステム名を1～31文字の文字列で表示します。UOC、およびsystem_nameプロパティでの指定がなかったときは、次のプロトコル情報を表示します。

サービスグループ名：RPCプロトコル

ユーザ情報コード

稼働情報編集UOCで指定されたユーザ情報コードを表示します。

UOCでの指定がなかったときは、0が表示されます。

ユーザ情報文字列

稼働情報編集UOCで指定されたユーザ情報文字列を最大127文字まで表示します。

サービスグループ名

サービスグループ名を表示します。

サービス名

サービス名を表示します。

RPCリターンコード

応答電文のリターン値を表示します。

RPC形態

RPCの形態を表示します。

NOFLAGS：同期応答型

NOWAIT：非同期応答型

NOREPLY：非応答型

PRFトレース情報詳細画面

関連付け情報画面のPRFトレース情報を表す情報バーをクリックした場合に、PRFトレース情報の詳細をポップアップでメイン画面上に表示します。

行を選択してCtrl+Cを押すと、クリップボードに選択行のデータを「項目名：値」の形式で転送します。

（例）

レスポンスタイム（マイクロ秒）：1877591

図4‒11　PRFトレース情報詳細画面

PRFトレース情報詳細表示エリア

PRFトレース情報詳細表示エリアに表示する項目を次に示します。

なお、表示する情報がない場合（ロストなどによって情報を取得できなかった場合も含む）は、値欄には「-」が表示されます。

表4‒10　PRFトレース情報詳細表示エリアの表示項目

表示項目名

説明

サーバOpenTP1識別子

サーバ側のOpenTP1識別子を表示します。

クライアントOpenTP1識別子

クライアント側のOpenTP1識別子を表示します。

クライアント通信番号

他ノードや他プロセスに通信するときに、OpenTP1システムが付加する番号を表示します。

サービス関数開始時刻

サービス関数開始直前の時刻を表示します。

リモートAPI機能使用時は、クライアントからのAPI代理実行要求受信時刻を表示します。

サービス関数終了時刻

サービス関数終了直後の時刻を表示します。

リモートAPI機能使用時は、API代理実行応答送信前時刻を表示します。

レスポンスタイム（マイクロ秒）

サービス関数開始時刻とサービス関数終了時刻の差（応答時間）をマイクロ秒で表示します。

サービスグループ名

サービスグループ名を表示します。

サービス名

サービス名を表示します。

リターンコード

OpenTP1提供関数のリターンコードを表示します。

RPC形態

RPCの形態を表示します。

NOFLAGS：同期応答型

NOWAIT：非同期応答型

NOREPLY：非応答型

情報取得ステータス

表示用情報の取得状態を表示します。

0：クライアント／サーバともに情報が存在する

1：クライアント／サーバともに情報が存在しない

2：クライアント／サーバともに情報が一部存在しない

3：サーバの情報が一部存在しない

4：クライアントの情報が一部存在しない

トランザクションブランチ開始時刻

トランザクションブランチを開始した時刻を「YYYY-MM-DD HH:MM:SS.mmmmmm」形式で表示します。

PRFトレース情報の一部がロストしている、またはトランザクションを開始していないときは、「0000-00-00 00:00:00.000000」を表示します。

トランザクションブランチ終了時刻

トランザクションブランチを終了した時刻を「YYYY-MM-DD HH:MM:SS.mmmmmm」形式で表示します。

PRFトレース情報の一部がロストしている、またはトランザクションを開始していないときは、「0000-00-00 00:00:00.000000」を表示します。

キュー滞留時間（マイクロ秒）

スケジュールキューに滞留している時間をマイクロ秒で表示します。

RPC実行時間合計（マイクロ秒）

API（dc_rpc_call、dc_rpc_call_to、またはdc_rpc_poll_any_replies）の時間をマイクロ秒で表示します。

排他待ち時間合計（マイクロ秒）※

資源の排他要求時に排他待ちとなった時間をマイクロ秒で表示します。

排他占有時間合計（マイクロ秒）※

資源の排他要求によって排他を占有した時間をマイクロ秒で表示します。

要求受信時間（マイクロ秒）

RPC要求を行ってからサーバ側のスケジュールキューに登録するまでの時間をマイクロ秒で表示します。マシン時刻の差異によってマイナスとなる場合があります。

応答受信時間（マイクロ秒）

サーバ側でUAPリターンしてからクライアント側で応答受信するまでの時間をマイクロ秒で表示します。マシン時刻の差異によってマイナスとなる場合があります。

ネーム検索時間（マイクロ秒）※

RPC要求によるネーム検索時間をマイクロ秒で表示します。

ネーム検索回数※

RPC要求によるネーム検索回数を表示します。

同期応答型RPC発行回数

同期応答型RPCを要求した回数を表示します。

同期応答型RPC成功回数

同期応答型RPCが成功した回数を表示します。

非同期応答型RPC発行回数

非同期応答型RPCを要求した回数を表示します。

非同期応答型RPC成功回数

非同期応答型RPCが成功した回数を表示します。

非同期応答型RPC破棄回数

非同期応答型RPCを破棄した回数を表示します。

非応答型RPC発行回数

非応答型RPCを要求した回数を表示します。

非応答型RPC成功回数

非応答型RPCが成功した回数を表示します。

排他回数※

資源の排他要求をした回数を表示します。

排他成功回数※

資源の排他要求が成功した回数を表示します。

同期点取得回数

トランザクションの同期点を取得した回数を表示します。

注※

OpenTP1の定義の設定が必要です。詳細については、「3.1　システムの構築の流れ」を参照してください。

メモ

PRFトレース情報詳細表示エリアのクライアントOpenTP1識別子の情報を、次のどちらかに表示されるサーバOpenTP1識別子の情報と照らし合わせることで、呼び出し元を特定できます。

RPCパケット情報詳細表示エリア

PRFトレース情報詳細表示エリア

ただし、TP1/Clientから非応答型RPCを複数回連続で呼び出していた場合に、呼び出し元を特定できないことがあります。

HiRDBパケット情報詳細画面

関連付け情報画面のHiRDBパケット情報を表す情報バーをクリックした場合に、HiRDBパケット情報の詳細をポップアップでメイン画面上に表示します。

行を選択してCtrl+Cを押すと、クリップボードに選択行のデータを「項目名：値」の形式で転送します。

（例）

レスポンスタイム（マイクロ秒）：5000

図4‒12　HiRDBパケット情報詳細画面（サーバ間連携機能使用時）

図4‒13　HiRDBパケット情報詳細画面（サーバ間連携機能未使用時）

タブ（SQL情報）

［SQL詳細情報］タブ

SQLのオペレーションごとの詳細を表示します。

［SQL統計情報］タブ

統計情報が存在する場合だけ表示され、選択するとSQL統計情報を表示します。

SQL情報表示エリア

SQL情報表示エリアに表示する項目を次に示します。

なお、表示する情報がない場合（ロストなどによって情報を取得できなかった場合も含む）は、値欄には「-」が表示されます。

表4‒11　SQL情報表示エリアの表示項目（サーバ間連携機能使用時）

表示項目名

説明

サーバOpenTP1識別子

サーバOpenTP1識別子を表示します。

クライアントOpenTP1識別子

クライアントOpenTP1識別子を表示します。

クライアント通信番号

クライアント通信番号を表示します。

SQL要求時刻

SQL要求した時刻を表示します。

SQL応答時刻

SQL応答された時刻を表示します。

レスポンスタイム（マイクロ秒）

要求時刻と応答時刻の差（応答時間）をマイクロ秒で表示します。

SQL文

SQL文を最大で1023バイトまで表示します。

マルチバイト文字の場合、文字化けして表示されるおそれがあります。

接続先IPアドレス

接続先DBのIPアドレスを表示します。

接続先ポート番号

接続先DBのポート番号を表示します。

セクション番号

セクション番号を表示します。

表4‒12　SQL情報表示エリアの表示項目（サーバ間連携機能未使用時）

表示項目名

説明

PRFキー

電文キーを表示します。

SQL要求時刻

SQL要求した時刻を表示します。

SQL応答時刻

SQL応答された時刻を表示します。

レスポンスタイム（マイクロ秒）

要求時刻と応答時刻の差（応答時間）をマイクロ秒で表示します。

SQL文

SQL文を最大で1023バイトまで表示します。

マルチバイト文字の場合、文字化けして表示されるおそれがあります。

接続元IPアドレス

接続元のIPアドレスを表示します。

接続元ポート番号

接続元のポート番号を表示します。

接続先IPアドレス

接続先DBのIPアドレスを表示します。

接続先ポート番号

接続先DBのポート番号を表示します。

セクション番号

セクション番号を表示します。

長いSQL文の全体を確認したい場合は、列の幅を広げるか、Ctrl+Cで値をクリップボードに転送後、テキストエディターなどに貼り付けて確認してください。

メモ

サーバ間連携機能使用時、SQL情報表示エリアのサーバOpenTP1識別子、クライアントOpenTP1識別子、クライアント通信番号の情報を、次のどちらかに表示される情報と照らし合わせることで、呼び出し元を特定できます。

RPRパケット情報詳細表示エリア

PRFトレース情報詳細表示エリア

ただし、SQL要求元のクライアントが非応答型RPCを複数回連続で呼び出していた場合に、呼び出し元を特定できないことがあります。

SQL詳細表示エリア

HiRDBパケット情報詳細画面で［SQL詳細情報］タブを選択すると、SQL詳細情報を表示します。

行を選択してCtrl+Cを押すと、1レコード分の情報を項目ごとに「項目名：値」の形式で改行してクリップボードに転送します。

SQL詳細表示エリアに表示する項目を次に示します。

なお、表示する情報がない場合（ロストなどによって情報を取得できなかった場合も含む）は、値欄には「-」が表示されます。

表4‒13　SQL詳細表示エリアの表示項目

表示項目名

説明

SQL要求時刻

SQL要求した時刻を表示します。

SQL応答時刻

SQL応答された時刻を表示します。

レスポンスタイム（マイクロ秒）

要求時刻と応答時刻の差（応答時間）をマイクロ秒で表示します。

オペレーションコード

オペレーションコードを表示します。

SQLコード

サーバで設定されたSQLコードを表示します。

FETCH文での検索行数

1回のFETCH文での検索行数を表示します。

SQLエラーメッセージ

サーバで設定されたエラーメッセージを表示します。

マルチバイト文字の場合、文字化けして表示されるおそれがあります。

ロールバックフラグ

暗黙的にトランザクションが取り消されたかどうかのフラグを表示します。

W：暗黙的にトランザクションが取り消された

-：暗黙的にトランザクションが取り消されていない

SQL統計表示エリア

HiRDBパケット情報詳細画面で［SQL統計情報］タブが表示されている場合に、［SQL統計情報］タブを選択すると、SQL統計情報を表示します。

図4‒14　RPCパケット情報詳細画面

SQL統計表示エリアに表示する項目を次に示します。

なお、表示する情報がない場合（ロストなどによって情報を取得できなかった場合も含む）は、値欄には「-」が表示されます。

接続先サーバ名

接続先コネクト通番

接続先プロセスID

排他待ち時間

CPU時間（単位：ミリ秒）

ストアドプロシジャオブジェクト取得要求回数

ストアドプロシジャオブジェクトバッファヒット回数

SQLオブジェクト取得要求回数

SQLオブジェクトバッファヒット回数

SQLオブジェクト作成回数

SQLオブジェクトサイズ最大値（単位：バイト）

FETCH-SELECT文での検索行数

DELETE文での削除行数

INSERT文での挿入行数

UPDATE文での更新行数

前処理実行回数

OPEN文実行回数

FETCH文実行回数

CLOSE文実行回数

SELECT文実行回数

INSERT文実行回数

UPDATE文実行回数

DELETE文実行回数

LOCK文実行回数

CALL文実行回数

ディスク入出力時間の最大値

ディスク入出力時間の最小値

ディスク入出力時間の累計

DBページ参照回数

DBページ更新回数

DBページバッファヒット回数

DBページディスク入力回数

DBページディスク出力回数

LOBページ参照回数

LOBページ更新回数

LOBページ参照バッファヒット回数

LOBページ更新バッファヒット回数

LOBページディスク入力回数

LOBページディスク出力回数

グローバルバッファフラッシュ回数

グローバルバッファディスク入力待ち回数

グローバルバッファディスク出力待ち回数

グローバルバッファの排他待ち回数

作業表用ファイル数の最大値

作業表用ファイル最大増分回数

作業表用ファイル最大容量（単位：メガバイト）

作業表用ファイルディスク入力回数

作業表用ファイルディスク出力回数

作業表用バッファ強制出力回数

ハッシュ表サイズ推定値（単位：キロバイト）

1レベル最大バケットサイズ（単位：キロバイト）

2レベル最大バケットサイズ（単位：キロバイト）

3レベル最大バケットサイズ（単位：キロバイト）

空き領域再利用適用除外回数

空き領域再利用適用回数

ローカルバッファ参照回数

ローカルバッファ更新回数

ローカルバッファヒット回数

ローカルバッファディスク入力回数

ローカルバッファディスク出力回数

ローカルバッファフラッシュ回数

排他制御用プール排他要求回数

排他制御用プール排他待ち回数

排他制御用プール排他待ち待ち行列数合計値

排他制御用プール排他待ち待ち行列数最大値

ログフラッシュ要求回数

ログフラッシュ待ち回数

ログフラッシュ待ち時間合計値

ログフラッシュ待ち時間最大値

ログフラッシュ待ち行列数合計値

ログフラッシュ待ち行列数最大値

グローバルバッファプール排他要求回数

グローバルバッファプール排他待ち回数

グローバルバッファプール排他待ち時間合計値

グローバルバッファプール排他待ち時間最大値

グローバルバッファプール排他待ち行列数合計値

グローバルバッファプール排他待ち行列数最大値

一時表使用セグメント数合計

4.5.8　関連付け情報検索画面

関連付け情報検索画面は、ダッシュボード画面の関連付け情報検索画面表示ボタンをクリックすると表示されます。

メイン画面

関連付け情報を表示するための検索条件を入力する画面を表示します。

図4‒15　メイン画面

タブ（検索条件）

［検索範囲指定］タブ

関連付け情報画面を表示するための条件として、日時範囲と最大取得件数を設定する画面を表示します。

検索範囲指定エリア

日時の範囲と最大取得件数を検索条件として関連付け情報を表示するための画面を表示します。

この画面はメイン画面の［検索範囲指定］タブ内に表示されます。

検索範囲指定エリア

検索範囲指定エリアは、メイン画面の［検索範囲指定］タブ内に表示されます。

図4‒16　検索範囲指定エリア

検索範囲入力エリア

関連付け情報の表示対象としたいトランザクションの検索範囲を設定するためのエリアです。

検索範囲入力エリアの詳細については、「検索範囲入力エリア」を参照してください。

初回画面表示時に、次の処理をします。

システム分析支援リアルタイムモニタ定義ファイルの値を取得

データベース上で管理しているPRFキー情報の最古日時を取得

開始日時と終了日時にデータベース上で管理しているPRFキー情報の最古日時を設定

ただし、データベースにPRFキー情報が存在しない場合は、データベース作成日時を最古日時とします。

最古日時の取得に失敗した場合は、エラーメッセージを表示します。取得した最古日時の解析に失敗した場合は警告を表示します。

最古日時の取得または解析に失敗した場合は、開始日時と終了日時に現在日時を設定します。

開始日時から終了日時までの間で指定可能な範囲は最大で24時間です。

開始日時を基準に、次に示す規則に従って入力値を補正します。

開始日時確定時に24時間を超えていた場合、終了日時に開始日時の24時間後を設定

終了日時確定時に24時間を超えていた場合、終了日時に開始日時の24時間後を設定

開始日時確定時に、開始日時が終了日時よりもあとの場合、終了日時に開始日時と同一日時を設定

終了日時確定時に、終了日時が開始日時よりも前の場合、終了日時に開始日時と同一日時を設定

最大取得件数選択ボックス

検索結果の最大取得数を選択します。

20件より大きい値を指定すると処理に時間が掛かることがあります。

関連付け情報表示ボタン

入力された日時範囲と最大取得件数を検索条件として検索した結果を関連付け情報画面に表示します。

ただし、次の場合は、警告が表示され、関連付け情報画面は表示されません。

検索条件に該当する関連付け情報がデータベース上に存在しなかった場合

開始日時と終了日時に同じ値が入力されていた場合

検索範囲入力エリア

図4‒17　検索範囲入力エリア

開始日選択カレンダー

カレンダーコントロールの日付を選択し、開始日を設定します。

開始時間入力コントロール

開始時間を「時」「分」「秒」「ミリ秒」の単位で設定します。

直接入力で値を設定する場合は、半角数字だけ有効です。無効な値が確定された場合は、入力前の値に戻します。

終了日選択カレンダー

カレンダーコントロールの日付を選択し、終了日を設定します。

終了時間入力コントロール

終了時間を「時」「分」「秒」「ミリ秒」の単位で設定します。

直接入力で値を設定する場合は、半角数字だけ有効です。無効な値が確定された場合は、入力前の値に戻します。

最大で開始時間の24時間後まで指定できますが、検索範囲を広くすると検索処理に時間が掛かる場合があります。

検索範囲と表示対象の関係

各処理の開始時刻、または終了時刻が検索範囲に含まれる場合に、検索結果として表示されます。

検索範囲入力エリアに設定した検索範囲と、検索結果として表示対象となる情報の関係を次に示します。

図4‒18　検索範囲と表示対象の関係

注意事項

システム分析支援リアルタイムモニタを再起動した場合は、ブラウザの「最新の情報に更新」を実行して再表示してください。

なお、ブラウザの「最新の情報に更新」を実行した場合、関連付け情報検索画面は初期状態で表示されます。

4.5.9　比較情報画面

比較情報画面に表示される項目について説明します。

図4‒19　比較情報画面

比較情報入力エリア

グラフ表示エリアまたはグラフ比較画面に表示したい比較情報を設定するためのエリアです。

図4‒20　比較情報入力エリア

［比較元開始日選択カレンダー］

カレンダーコントロールの日付を選択し、比較元の稼働情報の開始日を設定します。

［比較元開始時間入力コントロール］

比較元の稼働情報の開始時間を「時」「分」の単位で設定します。

集計間隔が「時」の場合、「分」の単位は設定できません。

この項目に時間を設定すると、［比較先開始時間入力コントロール］にも同じ時間が自動で設定されます。

なお、比較元の開始日時と比較先の開始日時が同じ日時の場合、比較できません。

［比較先開始日選択カレンダー］

カレンダーコントロールの日付を選択し、比較先の稼働情報の開始日を設定します。

［比較先開始時間入力コントロール］

比較先の稼働情報の開始時間を「時」「分」の単位で設定します。

集計間隔が「時」の場合、「分」の単位は設定できません。

［集計間隔入力コントロール］

稼働情報の集計間隔を「秒」「分」「時」のどれかの単位で設定します。

単位の初期値は「分」です。

単位が「秒」の場合、10、20、30、40、または50から選択できます。

単位が「分」の場合、1～30の間で選択できます。

単位が「時」の場合、1～24の間で選択できます。

［集計件数レンジスクロールバー］

稼働情報を集計間隔ごとに集計する件数を設定します。

　10～300（10件刻み）（デフォルト値：100）（単位：件）

［集計項目選択ドロップダウンリスト］

稼働情報を集計する項目を設定します。

表4‒14　稼働情報を集計する項目

項番

集計項目

内容

1

TPS

スループット（TPS）。

2

平均応答時間

サーバに要求を送信してからサーバから応答を受け取るまでの平均時間。

単位は、グラフレンジ入力エリアで設定します。

3

平均キュー滞留時間

スケジュールキューに滞留している平均時間。

単位は、グラフレンジ入力エリアで設定します。

PRFトレース情報があるときだけ有効です。

4

平均RPC実行時間合計

API（dc_rpc_call、dc_rpc_call_to、またはdc_rpc_poll_any_replies）の平均時間。

単位は、グラフレンジ入力エリアで設定します。

PRFトレース情報があるときだけ有効です。

5

平均排他待ち時間合計※

資源の排他要求時に排他待ちとなった平均時間。

単位は、グラフレンジ入力エリアで設定します。

PRFトレース情報があるときだけ有効です。

6

平均排他占有時間合計※

資源の排他要求によって排他を占有した平均時間。

単位は、グラフレンジ入力エリアで設定します。

PRFトレース情報があるときだけ有効です。

7

平均ネーム検索時間※

RPC要求によるネーム検索の平均時間。

単位は、グラフレンジ入力エリアで設定します。

PRFトレース情報があるときだけ有効です。

注※

OpenTP1の定義の設定が必要です。詳細については、「3.1　システムの構築の流れ」を参照してください。

［比較情報表示ボタン］

比較情報入力エリアで設定したグラフを表示します。

ボタンをクリックしてからグラフを表示するまでの間、非活性となります。

グラフレンジ入力エリア

グラフ比較画面のグラフレンジを設定するためのエリアです。

図4‒21　グラフレンジ入力エリア

［グラフ表示対象システム選択ドロップダウンリスト］

グラフ比較画面の［選択表示］タブを選択した場合に表示する対象のシステム名を設定します。

［TPSグラフレンジスクロールバー］

グラフ比較画面のスループット（TPS）のレンジを設定します。

グラフの縦軸のレンジ（最大値）を設定します。［集計項目選択ドロップダウンリスト］で「TPS」を設定した場合にスループット（TPS）の件数を表します。

　10～2000（10件刻み）（デフォルト値：300）（単位：件）

［時間単位グラフレンジスクロールバー］

グラフ比較画面のスループット（TPS）以外のレンジを設定します。

グラフの縦軸のレンジ（最大値）を設定します。［集計項目選択ドロップダウンリスト］で「TPS」以外を設定した場合の時間を表します。

　10～5000（10ミリ秒刻み）（デフォルト値：1000）（単位：ミリ秒）

　5～3600（5秒刻み）（デフォルト値：5）（単位：秒）

［時間切替選択ボックス］

時間単位グラフレンジの単位を「秒」または「ミリ秒」に設定します。

グラフ表示エリア

比較情報入力エリアで設定したグラフを表示します。表示される内容については、「4.5.10　グラフ比較画面」を参照してください。

4.5.10　グラフ比較画面

グラフ比較画面は、比較情報画面のグラフ表示エリアに表示されます。

グラフ比較画面では、比較情報入力エリアで設定したグラフを表示します。グラフの横軸は時刻（上段が比較先の時刻、下段が比較元の時刻）、縦軸は、集計項目が「TPS」のときはTPS（件）、TPS以外のときは時間（単位はグラフレンジ入力エリアの時間切替選択ボックスで設定）となります。

選択するタブによって、表示されるグラフが変わります。

［選択表示］タブを選択した場合

グラフ表示対象システム選択ドロップダウンリストで選択したシステムについてグラフ表示します。

ドロップダウンリストで選択できる項目については、「4.5.9　比較情報画面」を参照してください。

図4‒22　［選択表示］タブを選択した場合のTPSの表示例

［全表示］タブを選択した場合

グラフ対象システム選択ドロップダウンリストで選択できる全システムについてグラフ表示します。

例えば、グラフ表示システム選択ドロップダウンリストで上から順に「ALL_SYSTEM」「XXXX」「YYYY」「ZZZZ」と並んでいる場合に［全表示］タブを選択すると、次の図のように表示されます。

図4‒23　［全表示］タブを選択した場合のTPSの表示例

縦軸の値（TPS）と比べて表示するグラフの値が大きすぎる場合、画面が壊れることがあります。そのときは、TPSグラフレンジスクロールバー、または時間単位グラフレンジスクロールバーでレンジの値を大きくしてください。

5　トラブルシュート

システム分析支援リアルタイムモニタのトラブルシュートについて説明します。

5.1　トラブルシュートの手順

システム分析支援リアルタイムモニタで障害が発生したときの動作、および対処方法について示します。

システム分析支援リアルタイムモニタで障害が発生した場合、メッセージログにメッセージを出力します。トラブルが発生した場合は、出力されたメッセージを確認して、対処できる内容であれば対処してください。

ただし、次の場合には、要因調査に必要な資料を採取した上で、システム管理者に連絡する必要があります。

メッセージに対して対処できない場合

メッセージに従って対処しても解決できない場合

トラブルが発生しているのにメッセージが出力されていない場合

要因調査に必要な資料はesrtmrasgetコマンドを実行して取得してください。コマンドでの障害の場合は、標準出力・標準エラー出力に出力された内容も合わせて連絡してください。

5.2　主なトラブルへの対処方法

システム分析支援リアルタイムモニタの主なトラブルへの対処方法について説明します。

5.2.1　システムの運用時のトラブル

ダッシュボード画面が表示されない

ダッシュボード画面が表示されないときは、次の項目を確認してください。原因が特定できないときは、esrtmrasgetコマンドを実行して必要な資料を採取して、保守員に確認してください。

ブラウザ、およびFlash Playerが前提条件を満たしているか確認してください。

Webブラウザから入力したURLが誤っていないかどうかを確認してください。

Webサーバが起動しているかどうかを確認してください。

サービス名「Hitachi Web Server for HSICRTM」の稼働状況を確認し、停止しているときは開始してください。開始しているときは、インストール時に指定したWebサーバのポート番号が他プログラムで使用されていないかどうかを確認してください。

ポート番号が他プログラムで使用されているときは、他プログラムのポート番号を変更するか、アンインストール後にポート番号を変更して再度インストールしてください。

esrtmsetupコマンド実行時に指定したポート番号が他プログラムで使用されていないか確認してください。使用されているときは、アンセットアップ後に指定値を変更してセットアップを行ってください。

Webコンテナ通信用ポート番号

ダッシュボード実行中にエラーが発生した

ダッシュボード実行時にエラーが発生した場合、エラーメッセージをダッシュボード上のポップアップ画面に出力し、ダッシュボードの更新を停止します。次の項目を確認してください。原因が特定できないときは、esrtmrasgetコマンドを実行して必要な資料を採取して、保守員に確認してください。

esrtmlsコマンドを実行して、システム分析支援リアルタイムモニタが起動しているか確認してください。

esrtmsetupコマンド実行時に指定したポート番号が他プログラムで使用されていないか確認してください。使用されているときは、アンセットアップ後に指定値を変更してセットアップを行ってください。

ダッシュボード出力用ポート番号

Webコンテナ通信用ポート番号

Webコンテナ終了用ポート番号

ダッシュボードに表示されるポップアップ画面を次に示します。

強制終了のメッセージが出力された

esrtmrasgetコマンドを実行して必要な資料を採取して、保守員に確認してください。再起動するときは、esrtmstop -fコマンドを実行したあとにesrtmstartコマンドを実行してください。

ダッシュボード画面の表示速度が遅い

Java VMが確保するヒープ領域のメモリ不足が考えられます。次の値を確認してください。

Java VMオプションファイル（jvm_options.cfg）のJavaヒープの初期サイズとJavaヒープの最大サイズ

Webコンテナサーバ用オプション定義ファイル（usrconf.cfg）のJavaヒープの初期サイズとJavaヒープの最大サイズ

指定値に問題がないときは、esrtmrasgetコマンドを実行して必要な資料を採取して、保守員に確認してください。

6　他システムとの連携

システム分析支援リアルタイムモニタと他システムとの連携について説明します。

6.1　JP1/IM連携

JP1/IM連携の概要、JP1/IM連携の設定方法、および出力できるJP1イベントについて説明します。

6.1.1　JP1/IM連携機能

システム分析支援リアルタイムモニタはJP1/Baseと連携した場合、サーバ側の遅延などを検知するとJP1イベントを発行できます。

発行したJP1イベントは、JP1/Baseの転送設定ファイルで転送設定を行いJP1/IM-Managerに転送することで、JP1/IM-Viewの［イベントコンソール］画面から一元的に監視できます。

図6‒1　JP1/IM連携によるシステム検証支援クライアントの起動例

JP1イベントの詳細は「6.1.3　システム分析支援リアルタイムモニタが出力できるJP1イベント」を参照してください。

6.1.2　JP1/IM連携の設定

システム分析支援定義

JP1/IMと連携する場合は、システム分析支援定義のjp1_eventに［Y］を設定してください。

また、必要に応じてjp1_hostnameにJP1/Baseの論理ホスト名を指定してください。

JP1/IM連携に関する定義は「7.3.10　他システム連携関連定義」を参照してください。

イベント拡張属性定義ファイル

JP1/IMと連携する場合は、システム分析支援リアルタイムモニタのインストールディレクトリ¥examples¥hsic_rtm¥confディレクトリ下のhitachi_hsic_rtm_attr_ja.confおよびhitachi_hsic_rtm_attr_en.confをJP1/IM - Manager運用マシンの特定の場所にコピーし、格納する必要があります。格納先を次に示します。

物理ホスト

Consoleパス¥conf¥console¥attribute

論理ホスト

共有ディレクトリ¥JP1Cons¥conf¥console¥attribute

6.1.3　システム分析支援リアルタイムモニタが出力できるJP1イベント

システム分析支援リアルタイムモニタが発行するJP1イベント

システム分析支援リアルタイムモニタが発行するJP1イベントを次に示します。

表6‒1　システム分析支援リアルタイムモニタが発行するJP1イベント

イベントID

イベント発行契機

メッセージID

0x00007320

システム分析支援リアルタイムモニタを開始したとき

KFSE84211-I

0x00007321

システム分析支援リアルタイムモニタを終了したとき

KFSE84212-I

0x00007322

システム分析支援リアルタイムモニタが異常終了したとき

KFSE64214-E

0x00007330

システム分析支援リアルタイムモニタがアラートを検知したとき

KFSE84215-I

システム分析支援リアルタイムモニタが発行するJP1イベントの詳細をイベントIDごとに説明します。

なお、JP1イベントの属性については、JP1/IMのマニュアルを参照してください。

イベントID：0x00007320（開始）

表6‒2　システム分析支援リアルタイムモニタの開始時に発行するイベント

属性種別

項目

属性名

内容

基本

イベントID

－

0x00007320

メッセージ

－

KFSE84211-I The HSIC Real-Time Monitor started.

拡張

共通情報

重大度

SEVERITY

Information

ユーザー名

USER_NAME

SYSTEM

プロダクト名

PRODUCT_NAME

"/HITACHI/HSIC"

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

HSIC-RTM

事象種別

OCCURRENCE

START

固有情報

HSICアダプタ識別子

ADAPTER_ID

アダプタ識別子

イベントID：0x00007321（終了）

表6‒3　システム分析支援リアルタイムモニタの終了時に発行するイベント

属性種別

項目

属性名

内容

基本

イベントID

－

0x00007321

メッセージ

－

KFSE84212-I The HSIC Real-Time Monitor ended.

拡張

共通情報

重大度

SEVERITY

Information

ユーザー名

USER_NAME

SYSTEM

プロダクト名

PRODUCT_NAME

"/HITACHI/HSIC"

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

HSIC-RTM

事象種別

OCCURRENCE

END

固有情報

HSICアダプタ識別子

ADAPTER_ID

アダプタ識別子

イベントID：0x00007322（異常終了）

表6‒4　システム分析支援リアルタイムモニタの異常終了時に発行するイベント

属性種別

項目

属性名

内容

基本

イベントID

－

0x00007322

メッセージ

－

KFSE64214-E The HSIC Real-Time Monitor was forcibly terminated.

拡張

共通情報

重大度

SEVERITY

Error

ユーザー名

USER_NAME

SYSTEM

プロダクト名

PRODUCT_NAME

"/HITACHI/HSIC"

オブジェクトタイプ

OBJECT_TYPE

SERVICE

オブジェクト名

OBJECT_NAME

HSIC-RTM

事象種別

OCCURRENCE

END

固有情報

HSICアダプタ識別子

ADAPTER_ID

アダプタ識別子

イベントID：0x00007330（アラート検知）

表6‒5　アラートを検知した際に発行するイベント

属性種別

項目

属性名

内容

基本

イベントID

－

0x00007330

メッセージ

－

KFSE84215-I An alert was detected.

拡張

共通情報

重大度

SEVERITY

Error

ユーザー名

USER_NAME

SYSTEM

プロダクト名

PRODUCT_NAME

"/HITACHI/HSIC"

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

HSIC-RTM

事象種別

OCCURRENCE

NOTICE

固有情報

システム名

SYSTEM_NAME

システム名

開始日時

OCCURRENCE_TIME

アラートを検知したトランザクションの開始日時yyyy-mm-dd hh:mm:ss.fffffffff

HSICアダプタ識別子

ADAPTER_ID

アダプタ識別子

6.2　アラートのメール通知

アラートのメール通知の概要、およびメールの形式について説明します。

6.2.1　アラートのメール通知の概要

通知する情報

システム分析支援リアルタイムモニタはアラートを検知したときに、異常をメールで通知できます。

図6‒2　メール通知機能の概要

メール通知が行われるのは、次の場合です。

レスポンス監視によってアラートを検知したとき

アラートをメールで通知するには、システム分析支援リアルタイムモニタ定義ファイルでプロパティの設定が必要です。アラートをメールで通知するときに設定するプロパティについては、「7.3.10　他システム連携関連定義」を参照してください。

メールで通知する情報を次に示します。

アラートを検知した稼働情報の時刻

アラートを検知した稼働情報のシステム名

アラートを検知した稼働情報の電文キー

アラートを検知した稼働情報のアラート要因

ユーザ任意情報

テスト用メールの通知

システム分析支援リアルタイムモニタの起動時、アラート検知有無に関係なくテスト用のメールを通知できます。テスト用のメールを使用すると、メール通知機能に関連する定義が誤っていないかを確認できます。

6.2.2　メールの形式

アラート通知用のメール形式

アラート通知用のメールの形式を次に示します。

図6‒3　メール形式（アラート通知用）

ユーザ作成のメール形式

ユーザ独自の内容をメール本文に付加したいときは、次のファイルを作成してください。

メール雛形の文字コードはISO-2022-JP(JISコード)で作成してください。

運用ディレクトリ¥conf¥mail_user

テスト用メールのメール形式

テスト用のメール形式を次に示します。本文はありません。

図6‒4　メール形式（テスト用）

7　システム定義

システム分析支援リアルタイムモニタのシステム定義について説明します。

7.1　システム定義の形式

7.1.1　システム定義の記述形式

システム分析支援リアルタイムモニタのプロパティファイルの記述形式について次に示します。

行の長さ

1行の長さは最大1024バイトです。1024バイトを超える指定の場合は、複数行に分けて記述してください。

空白文字の定義

空白文字は、半角スペース、水平タブを示します。文中の'△'は1つ以上の空白文字を示します。

キーと要素

キーと要素間の区切り文字は「=」とします。キーの前や「=」の前後に空白文字を記述できます。

同じキーが複数回記述されていた場合、最後に指定されている要素が有効とします。

要素内の区切り文字「,」「:」の前後には空白文字を記入できません。

形式1　キー=要素

形式2　△キー△=△要素

コメント

コメントを記入する場合は、行の先頭に'#'を記述してください。'#'の前には空白文字だけ記述できます。

キーと要素の記述と同じ行にコメントを記入することはできません。

形式1　#コメント・・・・・・・

形式2　△#コメント・・・・・・

行の継続

行を継続させるには、行の末尾に継続文字「¥」を記述し、その直後で改行してください。

行の継続は、継続文字「¥」と改行文字（「¥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しか設定されません。

AA

BB

7.1.2　システム定義の説明で使用する記号

文法記述記号

オプションおよびコマンド引数を説明する記号を示します。各記号の意味は次のとおりです。

表7‒1　文法記述記号一覧

文法記述記号

意味

[　　]

この記号で囲まれている項目は省略してもよいことを示します。

…

この記号で示す直前の項目を繰り返し指定できることを示します。

（例）[［、ポート番号：自ホスト名称］…］

これは、ポート番号：自ホスト名称を繰り返し指定できることを示します。

{{ }}

この記号で囲まれた複数の項目が1つの繰り返し項目の単位であることを示します。

{ }

この記号で囲まれている複数の項目のうちから1つを選択することを示します。項目の区切りは｜で示します。

｜

この記号で区切られた項目は選択できることを示します。

＿

（下線）

この記号で示す項目は、該当プロパティを省略した場合の省略時解釈値を示します。

属性表示記号

ユーザー指定値の範囲などを説明する記号です。各記号の意味は次のとおりです。

表7‒2　属性表示記号一覧

属性表示記号

意味

～

この記号のあとにユーザー指定値の属性を示します。

《 》

ユーザーが指定を省略したときの値を示します。

〈 〉

ユーザー指定値の構文要素を示します。

(( ))

ユーザー指定値の範囲を示します。

構文要素記号

ユーザー指定値の内容を説明する記号です。各記号の意味は次のとおりです。

なお、すべて半角文字を使用してください。

表7‒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）

識別子

先頭がアルファベットの英数字列

英大識別子

先頭がアルファベットの大文字英数字列

記号名称

先頭が英字記号の英数字記号列

文字列

“（ダブルクォーテーション）を除く任意の文字の配列

パス名

ドライブ名で始まり、'A～Z'、'a～z'、'0～9'、'_'（下線）、パス区切り文字の'¥'で構成される半角文字列

ホスト名

英数字、!、#、$、%、&、‘、（、）、*、+、,、-、.、/、;、<、=、>、?、@、[、¥、]、^、_（アンダースコア）、`、{、|、}、~

ただし、プラットフォームごとに使用可能な文字はOSのマニュアルを参照してください。

7.2　システム定義の一覧

システム分析支援リアルタイムモニタ用定義ファイルでは、システム分析支援リアルタイムモニタで使用するパラメタ値を指定します。

システム分析支援リアルタイムモニタで使用する定義ファイルと各定義ファイルの格納先を次に示します。各定義ファイルを必要に応じて変更してください。

表7‒4　定義ファイル一覧

格納先

ファイル名

変更の要否

運用ディレクトリ¥conf

システム分析支援リアルタイムモニタ定義ファイル

hsicrtm_config.properties

○

Java VMオプションファイル

jvm_options.cfg

△

システムコンフィグプロパティファイル

system_config.properties

△

クエリグループ用プロパティファイル

HSICRTM_Analysis

×

インプロセス連携用プロパティファイル

user_app.HSICRTM.properties

×

インプロセス連携用プロパティファイル

user_app.HSICRTM1.properties

×

ログファイル出力用プロパティファイル

logger.properties

×

運用ディレクトリ¥conf¥xml

アダプタ構成定義ファイル

AdaptorCompositionDefinition.xml

×

インストールディレクトリ¥sys¥hitachi¥sdp¥psb¥CC¥web¥containers¥Webコンテナ名¥usrconf

Webコンテナサーバ用ユーザープロパティファイル

usrconf.properties

×

Webコンテナサーバ用オプション定義ファイル

usrconf.cfg

△

インストールディレクトリ¥sys¥hitachi¥sdp¥psb¥httpsd¥conf

Webサーバ用動作環境設定ファイル

httpsd.conf

×

インストールディレクトリ¥sys¥hitachi¥sdp¥psb¥CC¥web¥redirector

HTTP Server用リダイレクタ動作定義ファイル

mod_jk.conf

×

ワーカ定義ファイル

workers.properties

×

（凡例）

○：必ず変更してください。

△：必要に応じて変更してください。

×：変更しないでください。

7.3　システム分析支援リアルタイムモニタ定義ファイル

7.3.1　システム分析支援リアルタイムモニタ定義ファイルの定義の種類

システム分析支援リアルタイムモニタ定義ファイルでの定義名とキー（以降、プロパティと記載する）を次に示します。

表7‒5　システム分析支援リアルタイムモニタ定義ファイルの定義名とプロパティ

定義名

プロパティ

説明

アダプタ連携関連定義

network_interface

adapter_id

max_connection

max_message_size

reply_watchtime

my_port_no

agent_server

システム分析支援アダプタ連携に関する定義

稼働情報分析関連定義

outlier

outlier_range

system_name

watch_system_name

rpc_system_name_default

rpc_system_name_group

rpc_system_name_node

稼働情報分析に関する定義

プロトコル関連定義

web_server

web_client

web_threshold_watchtime

tcp_server

tcp_client

tcp_threshold_watchtime

iiop_server

iiop_client

iiop_threshold_watchtime

rpc_server

rpc_client

rpc_threshold_watchtime

hirdb_server

hirdb_client

hirdb_threshold_watchtime

hirdb_reply_watchtime

通信プロトコルに関する定義

トラブルシュート関連定義

adapter_tasktm_fileno

adapter_tasktm_filesz

adapter_statistics_interval_time

adapter_statistics_fileno

adapter_statistics_filesz

adapter_file_output_time

adapter_file_open_time

システム分析支援アダプタのトラブルシュートに関する定義

他システム連携関連定義

jp1_event

jp1_hostname

mail_use

mail_smtp_host

mail_smtp_port

mail_smtp_userid

mail_smtp_password

mail_from_address

mail_to_address

mail_timeout

mail_send_interval_time

mail_err_max_cnt

mail_test

他システムとの連携に関する定義

ユーザープログラム関連定義

library_file_name

uoc_startend

uoc_build

uoc_information

uoc_rtm

uoc_stack_size

ユーザープログラムに関する定義

稼働情報蓄積関連定義

save_type

file_del

save_dir

filesz

save_user_data

fileno

command_use

all_filesz

稼働情報の蓄積に関する定義

サーバ間連携関連定義

rpc_link

rpc_prf

rpc_prf_file_watchtime

サーバ間連携に関する定義

画面情報関連定義

rpc_pac_color

rpc_prf_color_1

rpc_prf_color_2

rpc_prf_color_3

rpc_prf_color_4

rpc_prf_color_5

rpc_prf_color_6

rpc_prf_color_7

rpc_prf_color_8

hirdb_pac_color

hirdb_server_pac_color

画面表示で利用する情報に関する定義

7.3.2　アダプタ連携関連定義

形式

[network_interface = ネットワークインターフェース名]
[adapter_id=アダプタ識別子]
[max_connection =コネクション最大数]
[max_message_size=最大メッセージサイズ]
[reply_watchtime=タイムアウト時間]
[my_port_no=稼働情報を受け付けるポート番号]
[agent_server=プロトコル種別:エージェントのIPアドレス:ポート番号:接続リトライ間隔]

機能

システム分析支援アダプタとの連携に関連するパラメタを指定します。

指定数

0～1

network_interfaceプロパティ

設定値と省略値

ネットワークインターフェースのIPアドレス(nnn.nnn.nnn.nnn)[,ネットワークインターフェースのIPアドレス(nnn.nnn.nnn.nnn)…]～〈符号なし整数〉((nnn:0～255))《0.0.0.0》

説明

スイッチングハブのミラーポートと接続している、EthernetのネットワークインターフェースのIPアドレスを指定します。

システム分析支援アダプタでは、指定されたネットワークインターフェースからパケットをキャプチャします。

network_interfaceプロパティで、同一のIPアドレスを指定しないでください。

IPアドレスとして0.0.0.0を指定した場合は、自動的にネットワークインターフェースを選択します。

そのため、ネットワークインターフェースが1つの場合はIPアドレスを省略できます。しかし、ネットワークインターフェースが複数存在する場合は、スイッチングハブのミラーポートと接続しているネットワークインターフェースのIPアドレスを明示的に指定してください。省略すると、スイッチングハブのミラーポートと接続されていないネットワークインターフェースを選択し、パケットがキャプチャされない場合があります。

指定できるnetwork_interfaceの最大数は8個です。

adapter_idプロパティ

設定値と省略値

～〈1～26文字の英大識別子〉《HSICRTM00》

説明

システム分析支援アダプタのアダプタ識別子を指定します。

システムテスト支援を使用するテスト識別子と同じ名称とならないよう指定してください。

max_connectionプロパティ

設定値と省略値

～〈符号なし整数〉((1～32))《3》

説明

システム分析支援アダプタから稼働情報を送信するコネクションの最大数を指定します。

max_message_sizeプロパティ

設定値と省略値

～〈符号なし整数〉 ((1～1048576))《1024》（単位：キロバイト）

説明

プロトコル電文の最大メッセージサイズを指定します。

このサイズを超過する電文をキャプチャしたときは、破棄します。

見積もり式への影響

メモリ使用量の見積もりに影響します。

reply_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (10～65530) 《自動算出》（単位:秒）

説明

要求電文に対する応答電文の到着待ち時間を指定します。

コネクション切断やパケットロストによって、応答電文が到着しない場合の待ち時間も含みます。

定義を省略したときは、web_threshold_watchtime、tcp_threshold_watchtime、iiop_threshold_watchtime、rpc_threshold_watchtime、hirdb_reply_watchtimeの指定値のうち、いちばん大きな時間（秒単位に切り上げ）に30秒を加算した値を応答電文の到着待ち時間とします。

ほかのプロパティとの関連

web_threshold_watchtime、tcp_threshold_watchtime、iiop_threshold_watchtime、rpc_threshold_watchtime、hirdb_reply_watchtimeで指定した時間より大きな時間を指定してください。

利点

メモリリークの防止

指定値の目安

クライアントで応答電文待ちを時間監視している場合、その時間よりも大きな時間を指定してください。

my_port_noプロパティ

設定値と省略値

～〈符号なし整数〉((5001～65535))《29109》

説明

システム分析支援アダプタから送られる稼働情報を受け付けるポート番号を指定します。

注意事項

このプロパティで指定するポート番号は、ほかのプログラムと重複しないようにしてください。

agent_serverプロパティ

設定値と省略値

プロトコル種別:エージェントのIPアドレス(nnn.nnn.nnn.nnn): エージェントのポート番号:接続リトライ間隔[,プロトコル種別:エージェントのIPアドレス(nnn.nnn.nnn.nnn): エージェントのポート番号:接続リトライ間隔…]

設定値と省略値については、それぞれの説明を参照してください。

説明

システム分析支援エージェントを使用する場合の定義です。

プロトコル種別、エージェントのIPアドレス/ポート番号、および接続リトライ間隔を関連づける定義です。

指定できる組み合わせの最大数は64個です。

プロトコル種別

プロトコル種別を指定します。

http：HTTPプロトコル

tcp ：TCPプロトコル

iiop：IIOPプロトコル

rpc：RPCプロトコル

hirdb：HiRDBプロトコル

エージェントのIPアドレスの指定nnn.nnn.nnn.nnn〈符号なし整数〉

システム分析支援エージェントのIPアドレスを指定します。

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

システム分析支援エージェントのaddress_destination定義の-hオプションipaddrオペランド値を指定してください。

エージェントのポート番号〈符号なし整数〉((1～65535))

システム分析支援エージェントのポート番号を指定します。

システム分析支援エージェントのaddress_destination定義の-hオプションportnoオペランド値を指定してください。

接続リトライ間隔〈符号なし整数〉((10～3600))（単位：秒）

システム分析支援エージェントとの接続に失敗したときのリトライ間隔を指定します。

リトライ間隔は最大5秒の誤差が発生します。

ほかのプロパティとの関連

プロトコル種別で指定したプロトコルに対応するプロトコル関連定義（web_server、tcp_server、iiop_server、rpc_server、hirdb_serverのどれか）を指定してください。

7.3.3　稼働情報分析関連定義

形式

[outlier=外れ値]
[outlier_range=外れ値対象範囲]
[system_name=システム名:プロトコル種別:サーバのIPアドレス:ポート番号
             [:クライアントのIPアドレス]]
[watch_system_name=システム名]
[rpc_system_name_default={GROUP | NODE}]
[rpc_system_name_group=システム名:サービスグループ名]
[rpc_system_name_node=システム名:ノード識別子]

機能

稼働情報分析に関連するパラメタを指定します。

指定数

0～1

outlierプロパティ

設定値と省略値

～〈符号なし整数〉((10～2147483647))《100》（単位：％）

説明

トランザクション実行時間（応答時間）が平均応答時間から外れ値を超えて乖離したときに警告する値を％で指定します。

外れ値検知によって警告対象となったときは、ダッシュボードの稼働情報画面で色を付けて表示します。ただし、アラート検知対象のときは、アラート検知による警告が優先されます。

平均応答時間は、システムごとにoutlier_rangeプロパティ指定値のトランザクションの実行時間を平均した時間となります。

（例）outlier=50、平均応答時間が200ミリ秒の場合

応答時間が290ミリ秒：警告対象でない

応答時間が300ミリ秒：警告対象

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

outlier_rangeプロパティ

設定値と省略値

～〈符号なし整数〉((10～10000))《1000》（単位：件）

説明

平均応答時間を算出するトランザクション件数を指定します。

トランザクション件数が本指定値未満のときは、トランザクション数で算出します。

稼働情報分析では、システム名ごとに本指定値分の情報をメモリ上で保持しますので、次の算出式を満たすよう指定してください。次の算出式を満たさない場合、システム分析支援リアルタイムモニタが強制停止するおそれがあります。

システム名の数×本指定値 ≦ 1000000

システム名の数：system_nameプロパティ、および稼働情報編集UOCでの指定がないときはプロトコルごとに1つ（RPCプロトコルの場合はサービスグループ名の数）です。

稼働情報編集UOCでシステム名の指定があったときは、システム名の種類の数です。ただし、異なるプロトコルで同じシステム名を指定したときは別システム名としてカウントします。

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

system_nameプロパティ

設定値と省略値

システム名:プロトコル種別:サーバのIPアドレス(nnn.nnn.nnn.nnn):サーバのポート番号[:クライアントのIPアドレス(nnn.nnn.nnn.nnn)][,システム名:プロトコル種別:サーバのIPアドレス(nnn.nnn.nnn.nnn):サーバのポート番号[:クライアントのIPアドレス(nnn.nnn.nnn.nnn)]…]

設定値と省略値については、それぞれの説明を参照してください。

説明

システム名をプロトコル種別、サーバのIPアドレス/ポート番号、およびクライアントのIPアドレスと関連づける定義です。

本指定値は、稼働情報編集UOCがないとき、または稼働情報編集UOCでシステム名を設定しないときに有効となります。

指定できる組み合わせの最大数は256個です。

組み合わせを複数指定した場合、先に指定した定義を優先します。

システム名

自動設定するシステム名を1～31文字の英数字で指定します。

プロトコル種別

プロトコル種別を指定します。

http：HTTPプロトコル

tcp ：TCPプロトコル

iiop：IIOPプロトコル

rpc ：RPCプロトコル

hirdb：HiRDBプロトコル

サーバのIPアドレスnnn.nnn.nnn.nnn〈符号なし整数〉

各プロトコルのサーバのIPアドレスを指定します。

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

サーバのポート番号 〈符号なし整数〉((0～65535))

各プロトコルのサーバのポート番号を指定します。

0を指定したときは、すべてのポート番号が対象になります。

プロトコル種別がhirdbの場合は0を指定してください。

クライアントのIPアドレスnnn.nnn.nnn.nnn〈符号なし整数〉

各プロトコルのクライアントのIPアドレスを指定します。

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

ほかのプロパティとの関連

RPCプロトコルの場合、rpc_system_name_group、またはrpc_system_name_nodeの指定値が優先されます。

利点

稼働情報編集UOCによるシステム名の設定が不要となります。

注意事項

次のシステム名はwatch_system_nameプロパティに指定できないため、本定義に指定しないことを推奨します。

ALL_SYSTEM

OTHER_SYSTEM

watch_system_nameプロパティ

設定値と省略値

システム名[,システム名…]　～〈1～31文字の英数字〉

説明

ダッシュボードのグラフ画面とグラフ比較画面にスループット（TPS）や平均応答時間などを表示対象とするシステム名を指定します。

システム名を省略した場合、プロトコルごとにスループット（TPS）や平均応答時間などを表示対象とします。

指定できるシステム名は最大16個です。

システム名に次の値は指定できません。

ALL_SYSTEM

OTHER_SYSTEM

利点

システム名ごとにスループット（TPS）や平均応答時間などをダッシュボードで確認できます。

rpc_system_name_defaultプロパティ

設定値と省略値

GROUP｜NODE《GROUP》

説明

RPCプロトコルのシステム名の初期値として、サービスグループ名、またはノード識別子のどちらを使用するかを指定します。

GROUP：システム名として、サービスグループ名を使用します。

NODE ：システム名としてノード識別子を使用します。

ただし、キャプチャした稼働情報に応答電文がないとき（非応答型RPC、または障害発生などによって応答電文なし）は、サービスグループ名を使用します。

ほかのプロパティとの関連

rpc_server、またはrpc_prfを指定したときだけ有効となります。

rpc_system_name_groupプロパティ

設定値と省略値

システム名:サービスグループ名[,システム名:サービスグループ名]…]

説明

RPCプロトコルのサービスグループ名をシステム名に関連づける定義です。

この指定値は、稼働情報編集UOCがないとき、または稼働情報編集UOCでシステム名を設定しないときに有効となります。

指定できる組み合わせの最大数は256個です。

組み合わせを複数指定した場合、先に指定した定義を優先します。

システム名

自動設定するシステム名を1～31文字の英数字で指定します。

サービスグループ名

サービスグループ名を1～31文字で指定します。

ほかのプロパティとの関連

rpc_server、またはrpc_prfを指定したときだけ有効となります。

利点

複数のサービスグループを1つのシステム名にまとめることができます。

注意事項

次のシステム名はwatch_system_nameプロパティに指定できないため、指定しないことを推奨します。

ALL_SYSTEM

OTHER_SYSTEM

rpc_system_name_nodeプロパティ

設定値と省略値

システム名:ノード識別子[,システム名:ノード識別子]…]

説明

RPCプロトコルのノード識別子をシステム名に関連づける定義です。

ただし、キャプチャした稼働情報に応答電文がないとき（非応答型RPC、または障害発生などによって応答電文なし）は、有効となりません。

この指定値は、稼働情報編集UOCがないとき、または稼働情報編集UOCでシステム名を設定しないときに有効となります。

指定できる組み合わせの最大数は256個です。

組み合わせを複数指定した場合、先に指定した定義を優先します。

システム名

自動設定するシステム名を1～31文字の英数字で指定します。

ノード識別子

ノード識別子を4文字で指定します。

ほかのプロパティとの関連

rpc_server、またはrpc_prfを指定したときだけ有効となります。

rpc_system_name_groupの指定値を優先します。

利点

複数のノード識別子を1つのシステム名にまとめることができます。

注意事項

次のシステム名はwatch_system_nameプロパティに指定できないため、指定しないことを推奨します。

ALL_SYSTEM

OTHER_SYSTEM

7.3.4　プロトコル関連定義（HTTPプロトコル定義）

形式

[web_server=WebサーバのIPアドレス[:ポート番号]]
[web_client=WebクライアントのIPアドレス[:ポート番号]]
[web_threshold_watchtime=閾値]

機能

HTTPプロトコル（SOAPプロトコルを含む）に関連するパラメタを指定します。

指定数

0～1

web_serverプロパティ

設定値と省略値

WebサーバのIPアドレス(nnn.nnn.nnn.nnn)[:Webサーバのポート番号][,WebサーバのIPアドレス(nnn.nnn.nnn.nnn)[:Webサーバのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

Webサーバ（HTTPプロトコル（SOAPプロトコルを含む））のIPアドレスとポート番号を組み合わせて指定します。

HTTPプロトコルを使用するときは、必須の定義となります。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

サーバ間連携機能を使用しない場合、web_server、tcp_server、iiop_server、rpc_server、hirdb_serverのどれかを指定します。

同一マシン（同一IPアドレス）上に監視対象の他プロトコルのサーバがあるときは、ポート番号を指定してください。

利点

特定のWebサーバに送信されるパケットだけをキャプチャできます。

web_clientプロパティ

設定値と省略値

WebクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:Webクライアントのポート番号][,WebクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:Webクライアントのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

Webクライアント（HTTPプロトコル（SOAPプロトコルを含む））のIPアドレスとポート番号を指定します。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

web_serverを指定したときだけ有効となります。

利点

特定のクライアントから送信されるパケットだけをキャプチャできます。

web_threshold_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～359900) 《1000》(単位:10ミリ秒)

説明

アラート検知機能によって、ダッシュボードのアラート検知画面の表示対象となる応答時間の閾値を指定します。

応答時間が閾値以上となった場合に、ダッシュボードのアラート検知画面に稼働情報を表示します。

ほかのプロパティとの関連

web_serverを指定したときだけ有効となります。

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

7.3.5　プロトコル関連定義（IIOPプロトコル定義）

形式

[iiop_server=IIOPサーバのIPアドレス[:ポート番号]]
[iiop_client=IIOPクライアントのIPアドレス[:ポート番号]]
[iiop_threshold_watchtime=閾値]

機能

IIOPプロトコルに関連するパラメタを指定します。

指定数

0～1

iiop_serverプロパティ

設定値と省略値

IIOPサーバのIPアドレス(nnn.nnn.nnn.nnn)[:IIOPサーバのポート番号][,IIOPサーバのIPアドレス(nnn.nnn.nnn.nnn)[:IIOPサーバのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

IIOPサーバのIPアドレスとポート番号を組み合わせて指定します。

IIOPプロトコルを使用するときは、必須の定義となります。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

サーバ間連携機能を使用しない場合、web_server、tcp_server、iiop_server、rpc_server、hirdb_serverのどれかを指定します。

利点

特定のIIOPサーバに送信されるパケットだけをキャプチャできます。

注意事項

同一マシン（同一IPアドレス）上に監視対象の他プロトコルのサーバがあるときは、ポート番号を指定してください。

iiop_clientプロパティ

設定値と省略値

IIOPクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:IIOPクライアントのポート番号][,IIOPクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:IIOPクライアントのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

IIOPクライアントのIPアドレスを指定します。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

iiop_serverを指定したときだけ有効となります。

利点

特定のクライアントから送信されるパケットだけをキャプチャできます。

iiop_threshold_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～359900) 《1000》（単位:10ミリ秒）

説明

アラート検知機能によって、ダッシュボードのアラート検知画面の表示対象となる、応答時間の閾値を指定します。

応答時間が閾値以上となった場合に、ダッシュボードのアラート検知画面に稼働情報を表示します。

ほかのプロパティとの関連

iiop_serverを指定したときだけ有効となります。

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

7.3.6　プロトコル関連定義（RPCプロトコル定義）

形式

[rpc_server=RPCサーバのIPアドレス[:ポート番号]]
[rpc_client=RPCクライアントのIPアドレス[:ポート番号]]
[rpc_threshold_watchtime=閾値]

機能

RPCプロトコルに関連するパラメタを指定します。

指定数

0～1

rpc_serverプロパティ

設定値と省略値

RPCサーバのIPアドレス(nnn.nnn.nnn.nnn)[: RPCサーバのポート番号][, RPCサーバのIPアドレス(nnn.nnn.nnn.nnn)[: RPCサーバのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

RPCサーバのIPアドレスとポート番号を組み合わせて指定します。

RPCプロトコルを使用するときは、必須の定義となります。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

サーバ間連携機能を使用しない場合、web_server、tcp_server、iiop_server、rpc_server、hirdb_serverのどれかを指定します。

利点

特定のRPCサーバに送信されるパケットだけをキャプチャできます。

注意事項

同一マシン（同一IPアドレス）上に監視対象の他プロトコルのサーバがあるときは、ポート番号を指定してください。

rpc_clientプロパティ

設定値と省略値

RPCクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:RPCクライアントのポート番号][,RPCクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:RPCクライアントのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

RPCクライアントのIPアドレスを指定します。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

rpc_serverを指定したときだけ有効となります。

利点

特定のクライアントから送信されるパケットだけをキャプチャできます。

rpc_threshold_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～359900) 《1000》(単位:10ミリ秒)

説明

アラート検知機能によって、ダッシュボードのアラート検知画面の表示対象となる応答時間の閾値を指定します。

応答時間が閾値以上となった場合に、ダッシュボードのアラート検知画面に稼働情報を表示します。

ほかのプロパティとの関連

rpc_serverを指定したときだけ有効となります。

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

7.3.7　プロトコル関連定義（TCPプロトコル定義）

形式

[tcp_server=TCPサーバのIPアドレス[:ポート番号]]
[tcp_client=TCPクライアントのIPアドレス[:ポート番号]]
[tcp_threshold_watchtime=閾値]

機能

TCPプロトコル（TCP/IPを使用したユーザー独自プロトコル）に関連するパラメタを指定します。

指定数

0～1

tcp_serverプロパティ

設定値と省略値

TCPサーバのIPアドレス(nnn.nnn.nnn.nnn)[:TCPサーバのポート番号][,TCPサーバのIPアドレス(nnn.nnn.nnn.nnn)[:TCPサーバのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

TCPサーバのIPアドレスとポート番号を組み合わせて指定します。

TCPプロトコルを使用するときは、必須の定義となります。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

サーバ間連携機能を使用しない場合、web_server、tcp_server、iiop_server、rpc_server、hirdb_serverのどれかを指定します。

利点

特定のTCPサーバに送信されるパケットだけをキャプチャできます。

注意事項

同一マシン（同一IPアドレス）上に監視対象の他プロトコルのサーバがあるときは、ポート番号を指定してください。

tcp_clientプロパティ

設定値と省略値

TCPクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:TCPクライアントのポート番号][,TCPクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:TCPクライアントのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

TCPクライアントのIPアドレスとポート番号を指定します。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

指定できるIPアドレス、ポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

tcp_serverを指定したときだけ有効となります。

利点

特定のクライアントから送信されるパケットだけをキャプチャできます。

tcp_threshold_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～359900) 《1000》(単位:10ミリ秒)

説明

アラート検知機能によって、ダッシュボードのアラート検知画面の表示対象となる応答時間の閾値を指定します。

応答時間が閾値以上となった場合に、ダッシュボードのアラート検知画面に稼働情報を表示します。

ほかのプロパティとの関連

tcp_serverを指定したときだけ有効となります。

指定値の目安

監視する業務の性能要件に応じて値を指定してください。

7.3.8　プロトコル関連定義（HiRDBプロトコル定義）

形式

[hirdb_server=HiRDBサーバのIPアドレス[:サーバ種別][:HiRDBサーバのポート番号]]
[hirdb_client=HiRDBクライアントのIPアドレス[:HiRDBクライアントのポート番号]]
[hirdb_threshold_watchtime=閾値]
[hirdb_reply_watchtime=タイムアウト時間]

機能

HiRDBプロトコルに関連するパラメタを指定します。

指定数

0～1

hirdb_serverプロパティ

設定値と省略値

HiRDBサーバのIPアドレス(nnn.nnn.nnn.nnn):WS|PC[:HiRDBサーバのポート番号][[,HiRDBサーバのIPアドレス(nnn.nnn.nnn.nnn):WS|PC[:HiRDBサーバのポート番号]]…]～〈符号なし整数〉((nnn:0～255))

説明

HiRDBサーバのIPアドレスとサーバ種別とポート番号を組み合わせて指定します。

HiRDBのSQL情報を取得するときは、必ず定義してください。

HiRDBサーバ種別

指定する値

AIX

WS

HP-UX

Solaris

Linux

PC

Windows

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

ポート番号 〈符号なし整数〉((ポート番号:1～65535))

HiRDBサーバが使用するポート番号を範囲指定(ポート番号-ポート番号)で指定します。

HiRDBシステム定義のpd_registered_portで指定したポート番号の予約範囲を指定してください。

ポート番号の予約範囲が6000～8999のときは、「6000-8999」と指定します。

指定できるIPアドレス、サーバ種別およびポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

サーバ間連携機能を使用する場合、OpenTP1のUAPから実行したSQLだけが対象になります。

サーバ間連携機能を使用しない場合、hirdb_server、web_server、tcp_server、iiop_server、rpc_serverのどれかを指定します。

注意事項

実際のサーバ種別と異なるサーバ種別が指定されたときは、動作保証しません。

hirdb_clientプロパティ

設定値と省略値

HiRDBクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:HiRDBクライアントのポート番号][,HiRDBクライアントのIPアドレス(nnn.nnn.nnn.nnn)[:HiRDBクライアントのポート番号]]～〈符号なし整数〉((nnn:0～255))

説明

HiRDBクライアントのIPアドレスとポート番号を指定します。

IPアドレスの指定 nnn.nnn.nnn.nnn〈符号なし整数〉

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

ポート番号 〈符号なし整数〉((ポート番号:1～65535))

HiRDBクライアントが使用するポート番号を範囲指定（ポート番号-ポート番号）で指定します。

HiRDBクライアント環境定義のPDCLTRCVPORTで指定した受信ポート番号の範囲を指定してください。

受信ポート番号の範囲が10000～10100のときは、「10000-10100」と指定します。

指定できるIPアドレスとポート番号の組み合わせの最大数は64個です。

ほかのプロパティとの関連

hirdb_serverを指定し、rpc_linkにYを指定しているときだけ有効となります。

利点

特定のクライアントから送信されるパケットだけをキャプチャできます。

hirdb_threshold_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～359900) 《100》(単位:10ミリ秒)

説明

アラート検知機能でダッシュボードのアラート検知画面の表示対象となるSQL応答時間の閾値を指定します。

応答時間が、閾値以上となった場合に、ダッシュボードのアラート検知画面に稼働情報を表示します。

ほかのプロパティとの関連

rpc_linkがNでhirdb_serverを指定したときだけ有効です。

設定値の目安

監視する業務の性能要件に応じて、設定値を指定してください。

hirdb_reply_watchtimeプロパティ

設定値と省略値

～〈符号なし整数〉 (1～3600) 《10》(単位:秒)

説明

HiRDBクライアントからの要求に対する応答の最大待ち時間を指定します。

ほかのプロパティとの関連

hirdb_serverを指定し、rpc_linkにYを指定しているときだけ有効となります。

利点

メモリリークを防止できます。

指定値の目安

HiRDBのクライアント環境変数PDCWAITTIMEの値を基に設定してください。

7.3.9　トラブルシュート関連定義

形式

[adapter_tasktm_fileno=TASKTMファイル数]
[adapter_tasktm_filesz=TASKTMファイルサイズ]
[adapter_statistics_interval_time=統計情報取得間隔]
[adapter_statistics_fileno=統計情報ファイル数]
[adapter_statistics_filesz=統計情報ファイルサイズ]
[adapter_file_output_time=ファイル出力ハングアップ監視時間]
[adapter_file_open_time=ファイルopenハングアップ監視時間]

機能

トラブルシュートに関連するパラメタを指定します。

指定数

0～1

adapter_tasktm_filenoプロパティ

設定値と省略値

～〈符号なし整数〉((3～100))《3》

説明

TASKTM情報を出力する最大ファイル数を指定します。

指定値の目安

adapter_tasktm_fileszプロパティとの組み合わせで、保存したいTASKTM情報量にあわせて指定してください。

見積もり式への影響

TASKTMファイルの容量設定、およびメモリ使用量の見積もりに影響します。

adapter_tasktm_fileszプロパティ

設定値と省略値

～〈符号なし整数〉((4000～1000000))《40000》（単位：キロバイト）

説明

TASKTM情報を出力するファイルの容量をキロバイト単位で指定します。

指定値の目安

adapter_tasktm_filenoプロパティとの組み合わせで、保存したいTASKTM情報量にあわせて指定してください。

見積もり式への影響

TASKTMファイルの容量設定、およびメモリ使用量の見積もりに影響します。

adapter_statistics_interval_timeプロパティ

設定値と省略値

～〈符号なし整数〉((1～3600))《60》（単位：秒）

説明

統計情報を取得する時間間隔を指定します。単位は秒です。

見積もり式への影響

統計情報ファイルの容量設定、およびメモリ使用量の見積もりに影響します。

adapter_statistics_filenoプロパティ

設定値と省略値

～〈符号なし整数〉((3～100))《3》

説明

統計情報を出力する最大ファイル数を指定します。

指定値の目安

adapter_statistics_fileszプロパティとの組み合わせで、保存したい統計情報量にあわせて指定してください。

見積もり式への影響

統計情報ファイルの容量設定、およびメモリ使用量の見積もりに影響します。

adapter_statistics_fileszプロパティ

設定値と省略値

～〈符号なし整数〉((4000～1000000))《40000》（単位：キロバイト）

説明

統計情報を出力するファイルの容量をキロバイト単位で指定します。

指定値の目安

adapter_statistics_filenoプロパティとの組み合わせで、保存したい統計情報量にあわせて指定してください。

見積もり式への影響

統計情報ファイルの容量設定、およびメモリ使用量の見積もりに影響します。

adapter_file_output_timeプロパティ

設定値と省略値

～〈符号なし整数〉((0～65535))《60》（単位：秒）

説明

ファイル出力する処理のハングアップ監視時間を指定します。単位は秒です。

監視の対象となる処理の時間が、このプロパティに指定した時間を超えるとプロセスが異常終了します。0を指定した場合は、監視しません。

このプロパティによる監視の対象となるのは、次の処理です。

TASKTMファイル出力

統計情報ファイル出力

モジュールトレースファイル出力

稼働情報ファイル

指定値の目安

カーネルやドライバがディスクの障害を検出する時間よりも大きい時間を指定することを推奨します。小さい時間を指定するとドライバが一部のディスクパスの障害を検出してフェールオーバーしている場合などにハングアップを検知してしまい、カーネルやドライバの機能を有効に使えない場合があります。

adapter_file_open_timeプロパティ

設定値と省略値

～〈符号なし整数〉((0～65535))《3000》（単位：秒）

説明

ファイルを作成したり削除したりする処理のハングアップ監視時間を指定します。

監視の対象となる処理の時間が、このプロパティに指定した時間を超えるとプロセスが異常終了します。0を指定した場合は、監視しません。

このプロパティによる監視の対象となるのは、次の処理です。

TASKTMファイル作成／削除

統計情報ファイル作成／削除

モジュールトレースファイル作成／削除

指定値の目安

通常は、このプロパティを指定する必要はありません。ディスク障害が発生していない場合にシステム分析支援アダプタでKFSE55313-Eが頻繁に出力される場合は、この定義値を大きくしてください。ファイルを作成したり削除したりする時間は、ディスクの性能、ファイルサイズ、ファイルのエクステント数、使用しているファイルシステムなどによって大きく異なります。

7.3.10　他システム連携関連定義

形式

[jp1_event=Y|N]
[jp1_hostname=JP1/Baseの論理ホスト名]
[mail_use=Y|N]
[mail_smtp_host=SMTPサーバのホスト名]
[mail_smtp_port=SMTPサーバのポート番号]
[mail_smtp_userid=SMTP認証ID]
[mail_smtp_password=SMTP認証パスワード]
[mail_from_address=送信元メールアドレス]
[mail_to_address=送信先メールアドレス]
[mail_timeout=タイムアウト値]
[mail_send_interval_time=メール送信間隔]
[mail_err_max_cnt=メール送信失敗最大回数]
[mail_test=Y|N]

機能

他システム連携と関連するパラメタを指定します。

指定数

0～1

jp1_eventプロパティ

設定値と省略値

Y | N《N》

説明

JP1/IMと連携し、JP1イベントを発行するかどうかを指定します。

JP1/IMとの連携時には必ずプロパティを指定してください。JP1/IMとの連携方法については、「6.　他システムとの連携」を参照してください。

Y

JP1/IMと連携し、JP1イベントを発行する

N

JP1/IMと連携しない

前提条件

JP1/Baseが起動していること。

利点

JP1/IMと連携できます。

jp1_hostnameプロパティ

設定値と省略値

～〈1～196バイトの文字列〉

説明

JP1/Baseの論理ホスト名を指定します。

論理ホスト名については、JP1/Baseのマニュアルを参照してください。

JP1/Baseのクラスタ構成は未サポートです。非クラスタ構成で論理ホスト名を使用する運用の場合は必ずプロパティを指定してください。

ほかのプロパティとの関連

jp1_eventにYを指定したときだけ有効となります。

mail_useプロパティ

設定値と省略値

Y | N《N》

説明

メール通知機能を使用するかどうかを指定します。

Y

メール通知機能を使用する

N

メール通知機能を使用しない

前提条件

SMTPサーバが起動していること。

ほかのプロパティとの関連

web_server、tcp_server、iiop_server、rpc_serverのどれかを指定します。

利点

アラート検知をメールで確認できます。

mail_smtp_hostプロパティ

設定値と省略値

～〈1～255バイトの文字列〉

説明

SMTPサーバのアドレスをIPv4、またはホスト名で指定します。

メール通知機能を使用する場合は必ず指定してください。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_smtp_portプロパティ

設定値と省略値

～〈符号なし整数〉((1～65535))《25》

説明

SMTPサーバのポート番号を指定します。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_smtp_useridプロパティ

設定値と省略値

～〈1～255バイトの文字列〉

説明

SMTPサーバにログインするユーザーのユーザーIDを指定します。

ユーザー認証が不要な場合は、任意の文字列を指定してください。

メール通知機能を使用するときは必ず指定してください。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_smtp_passwordプロパティ

設定値と省略値

～〈1～255バイトの文字列〉

説明

SMTPサーバにログインするユーザーのパスワードを指定します。

ユーザー認証が不要な場合は、任意の文字列を指定してください。

メール通知機能を使用するときは必ず指定してください。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_from_addressプロパティ

設定値と省略値

～〈1～255バイトの文字列〉

説明

通知メールの送信元（From）を指定します。メール通知機能を使用する場合は必ず指定してください。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_to_addressプロパティ

設定値と省略値

～〈1～255バイトの文字列〉

説明

通知メールの送信先（To）を指定します。

「,」で区切ることで複数のメールアドレスを指定できます。

メール通知機能を使用する場合は必ず指定してください。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_timeoutプロパティ

設定値と省略値

～〈符号なし整数〉((1～300))《10》（単位：秒）

説明

SMTPサーバへの接続、およびメール送信時のタイムアウト時間を指定します。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

mail_send_interval_timeプロパティ

設定値と省略値

～〈符号なし整数〉((10～3600))《300》（単位：秒）

説明

アラートを検知したときに通知メールを送信する時間間隔を指定します。

この指定値はプロトコル単位に有効となります。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

利点

アラート検知が多発したときに、通知メールを抑止できます。

mail_err_max_cntプロパティ

設定値と省略値

～〈符号なし整数〉((0～60))《3》

説明

メール通知の失敗によってメール通知機能を閉塞する場合の、メール通知連続失敗最大回数を指定します。0を指定したときは、メール通知機能を閉塞しません。

メール通知機能が閉塞すると、以降のメール通知を行いません。

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

利点

定義不正などによって、メール通知失敗が多発することを抑止できます。

mail_testプロパティ

設定値と省略値

Y | N《N》

説明

メールテスト機能を使用するかどうかを指定します。

Y

メールテスト機能を使用する

N

メールテスト機能を使用しない

ほかのプロパティとの関連

mail_useにYを指定したときだけ有効となります。

利点

アラートを検知しなくても、テスト用のメール通知を行うことができるので、定義に問題がないかどうかを確認できます。

7.3.11　ユーザープログラム関連定義

形式

[library_file_name=プラグイン(応答監視機能)用UOC共用ライブラリ名]
[uoc_startend=開始終了UOCのエントリポインタ名]
[uoc_build=電文組立UOCのエントリポインタ名]
[uoc_information=電文情報設定UOCのエントリポインタ名]
[uoc_rtm=稼働情報編集UOCのエントリポインタ名]
[uoc_stack_size=UOCで使用するスタックサイズ]

機能

ユーザープログラムに関連するパラメタを指定します。

指定数

0～1

library_file_nameプロパティ

設定値と省略値

～〈259字以内のパス名〉

説明

システム分析支援アダプタ側のUOC処理を含んだ共用ライブラリ名称を絶対パスで指定します。

ほかのプロパティとの関連

UOCのエントリポインタ名を指定している場合は、本プロパティを必ず指定してください。

uoc_startendプロパティ

設定値と省略値

～〈1～31字以内の識別子〉

説明

開始終了UOCエントリポインタ名を指定します。

前提条件

本プロパティにはlibrary_file_nameプロパティで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_buildプロパティ

設定値と省略値

～〈1～31字以内の識別子〉

説明

電文組立UOCエントリポインタ名を指定します。

前提条件

本プロパティにはlibrary_file_nameプロパティで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_informationプロパティ

設定値と省略値

～〈1～31字以内の識別子〉

説明

電文情報設定UOCエントリポインタ名を指定します。

前提条件

本プロパティにはlibrary_file_nameプロパティで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_rtmプロパティ

設定値と省略値

～〈1～31字以内の識別子〉

説明

稼働情報編集UOCエントリポインタ名を指定します。

前提条件

本プロパティにはlibrary_file_nameプロパティで指定するライブラリ中に存在するエントリポインタ名を指定します。

uoc_stack_sizeプロパティ

設定値と省略値

～〈符号なし整数〉 (0～60000) 《0》（単位：キロバイト）

説明

UOCを使用する場合に、UOCが必要とするスタックサイズを指定します。

UOCを実行するスレッドのスタックサイズは、製品が必要とするスタックサイズ＋本オペランドの指定値となります。

スタックサイズが不足した場合は、スタックオーバーフローが発生してプロセスダウンします。

次の条件がすべて該当する場合はスタックサイズ不足の可能性があるため、本オペランドの指定値を増やしてください。

停止コマンドを実行していないのに、プロセスダウンしている

障害検知メッセージ（KFSE65380-E、KFSE65385-E、KFSE65387-E）が出力されていない

7.3.12　稼働情報蓄積関連定義

形式

[save_type=rtm | none]
[file_del={Y | N}]
[save_dir=稼働情報ファイル格納ディレクトリパス]
[filesz=稼働情報ファイルサイズ]
[save_user_data={Y | N}]
[fileno=稼働情報ファイル最大数]
[command_use={Y | N}]
[all_filesz=稼働情報ファイル全体サイズ]

機能

稼働情報の蓄積に関連するパラメタを指定します。

指定数

0～1

save_typeプロパティ

設定値と省略値

rtm | none《none》

説明

電文情報の取得有無を指定します。

rtm

稼働情報を稼働情報ファイルに取得します。

次の機能を使用するときは、指定してください。

ダッシュボード画面の関連付け情報画面と関連付け情報検索画面

稼働情報抽出ユティリティ

esrtmstcedコマンド

esrtmtrcedコマンド

none

電文稼働情報を取得しません。

file_delプロパティ

設定値と省略値

Y | N《N》

説明

前回までの稼働情報ファイルの削除有無を指定します。

Y

稼働情報ファイルを削除してシステム分析支援アダプタを起動します。

N

稼働情報ファイルを削除せずにシステム分析支援アダプタを起動します。

ほかのプロパティとの関連

save_typeにrtmを指定したときだけ有効になります。

利点

Yを指定した場合、前回までの稼働情報ファイルを削除したり、移動したりする運用を省略できます。

注意事項

Nを指定した場合、前回までの稼働情報ファイルはディスク満杯とならないよう必要に応じて削除してください。

Yを指定した場合でも、稼働情報ファイル格納ディレクトリパスから移動したり、ファイル名を変更したりした稼働情報ファイルは削除されません。

save_dirプロパティ

設定値と省略値

～〈210バイト文字以内のパス名〉《運用ディレクトリ¥save》

説明

稼働情報ファイルを作成するディレクトリを絶対パスで指定します。

前提条件

システム分析支援リアルタイムモニタを起動する前に、本プロパティで指定したディレクトリを作成してください。

ほかのプロパティとの関連

save_typeにrtmを指定したときだけ有効です。

利点

ユーザー任意のディレクトリに稼働情報ファイルを作成できます。

注意事項

指定したディレクトリ内にある稼働情報ファイルは、ディスク満杯によるスワップによって削除されるおそれがあります。必要に応じて別ディレクトリに退避してください。

fileszプロパティ

設定値と省略値

4～1024《32》（単位：ギガバイト）

説明

稼働情報ファイル（稼働情報管理ファイル除く）の最大サイズをギガバイト単位で指定します。

利点

最大サイズを大きくすることで、作成するファイル数が少なくなり、管理が容易になります。

指定値の目安

ディスクサイズおよびファイル運用を考慮して設定してください。

見積もり式への影響

稼働情報ファイルの容量設定の見積もりに影響します。

ほかのプロパティとの関連

save_user_dataがYのときだけ有効となります。

save_user_dataプロパティ

設定値と省略値

Y | N《N》

説明

稼働情報ファイルにユーザーデータを取得するかどうかを指定します。

Y

稼働情報ファイルにユーザーデータを取得します。

稼働情報管理ファイルと稼働情報ファイルを作成します。

稼働情報抽出ユティリティを使用する場合に指定してください。

N

稼働情報ファイルにユーザーデータを取得しません。

稼働情報管理ファイルを作成します。

ほかのプロパティとの関連

save_typeにrtmを指定したときだけ有効となります。

利点

Nを指定した場合、ユーザーデータを稼働情報ファイルに取得しないため、ディスクサイズを抑えることができます。

filenoプロパティ

設定値と省略値

16～1000000《10000》

説明

稼働情報ファイルの最大ファイル数を指定します。

この指定値を超えたときは、一番古い稼働情報ファイルを削除します。

利点

作成するファイル数を制限できます。

指定値の目安

ディスクサイズおよびファイル運用を考慮して設定してください。

command_useプロパティ

設定値と省略値

Y | N《N》

説明

esrtmstced（稼働情報のファイル出力）コマンドを使用するかどうかを指定します。

Y

esrtmstcedコマンドを使用します。

N

esrtmstcedコマンドを使用しません。esrtmstcedコマンドを使用した場合、稼働情報の数に比例して情報出力に時間が掛かります。

ほかのプロパティとの関連

save_typeにrtmを指定したときだけ有効となります。

利点

Nを指定した場合、ディスクサイズを抑えることができます。

all_fileszプロパティ

設定値と省略値

128～1048576《256》（単位：ギガバイト）

説明

稼働情報ファイル全体の最大サイズをギガバイト単位で指定します。

稼働情報ファイルの全体サイズがこの指定値を超えた場合、古い方から順に稼働情報ファイルを削除します。

ほかのオペランドとの関連

save_typeにrtmを指定したときだけ有効です。

fileszに指定した稼働情報ファイルサイズの2倍以上の値を設定してください。

設定値の目安

ディスクサイズを考慮して設定してください。

見積もり式への影響

稼働情報ファイルの容量設定

利点

ディスクサイズを制限できます。

7.3.13　サーバ間連携関連定義

形式

[rpc_link={Y | N}]
[rpc_prf=PRFトレースファイル取得先のOpenTP1ホームディレクトリ:PRFトレースファイル監視間隔:FTPサーバのIPアドレス:FTPサーバのポート番号:ユーザ名:パスワード:接続モード]
[rpc_prf_file_watchtime=PRFトレースファイル取得待ち時間]

機能

サーバ間連携に関連するパラメタを指定します。

指定数

0～1

rpc_linkプロパティ

設定値と省略値

Y | N《N》

説明

RPCプロトコルのサーバ間連携機能の使用有無を指定します。

Y

RPCプロトコルのサーバ間連携機能を使用します。

N

RPCプロトコルのサーバ間連携機能を使用しません。

ほかのプロパティとの関連

save_typeにrtmを指定してください。

また、rpc_server、またはrpc_prfのどちらかを指定してください。

rpc_prfプロパティ

設定値と省略値

PRFトレースファイル取得先のOpenTP1ホームディレクトリ:PRFトレースファイル監視間隔:FTPサーバのIPアドレス:FTPサーバのポート番号:ユーザ名:パスワード:接続モード [,PRFトレースファイル取得先のOpenTP1ホームディレクトリ:PRFトレースファイル監視間隔:FTPサーバのIPアドレス:FTPサーバのポート番号:ユーザ名:パスワード:接続モード…]

説明

OpenTP1のPRFトレースに関する定義を指定します。

指定できるOpenTP1のPRFトレース情報の組み合わせの最大数は64個です。

PRFトレースファイル取得先のOpenTP1ホームディレクトリ～＜260バイト以内のパス＞

PRFトレースファイル取得先のOpenTP1ホームディレクトリを、FTP接続時のホームディレクトリからの相対パスで指定します。

ディレクトリの区切り文字は'/'(スラッシュ)を使用してください。

指定例を以下に示します。

●Linux版TP1/Server Baseが監視対象の場合

OpenTP1ホームディレクトリ

(物理パス)

FTP接続時のホームディレクトリ

(物理パス)

このオペランドの指定値

/home/aaa/TP1

/

home/aaa/TP1

/home/aaa

TP1

/home/aaa/TP1

.

●Windows版TP1/Server Baseが監視対象の場合

OpenTP1ホームディレクトリ

(物理パス)

FTP接続時のホームディレクトリ

(物理パス)

このオペランドの指定値

C:¥OpenTP1

C:¥

OpenTP1

C:¥OpenTP1

.

PRFトレースファイル監視間隔 〈符号なし整数〉((10～3600))(単位：秒)

PRFトレースファイルの監視間隔を指定します。

監視間隔の時間が経過した時点でPRFファイルが更新されていた場合は、前回監視時点から増加した差分をダウンロードします。

FTPサーバのIPアドレス～(nnn.nnn.nnn.nnn)〈符号なし整数〉((nnn:0～255))

PRFトレースファイル監視で接続する、FTPサーバのIPアドレスを指定します。

ただし、0.0.0.0および255.255.255.255は指定できません。

FTPサーバのポート番号 〈符号なし整数〉((1～65535))

PRFトレースファイル監視で接続する、FTPサーバのポート番号を指定します。

ユーザ名 ～<1～32バイトの文字列>

PRFトレースファイル監視でFTPサーバに接続するためのユーザ名を指定します。

パスワード ～<1～32バイトの文字列>

PRFトレースファイル監視でFTPサーバに接続するためのパスワードを指定します。

接続モード ～ passive | active

PRFトレースファイル監視でFTPサーバに接続する際の接続モードを指定します。

passive

パッシブモードで接続します

active

アクティブモードで接続します

ほかのプロパティとの関連

rpc_linkにYを指定しているときだけ有効となります。

rpc_prf_file_watchtimeプロパティ

設定値と省略値

11～86400《300》（単位：秒）

説明

OpenTP1のPRFトレースファイルの取得待ち時間を指定します。

このプロパティで指定した時間内に、クライアント/サーバのPRFトレースファイルからロストなどによって対応するPRFトレース情報を取得できない場合、PRFトレース情報は不完全な情報(PRFトレース情報詳細表示エリアの情報取得ステータスに0以外)で出力します

ほかのプロパティとの関連

rpc_prfを指定しているときだけ有効となります。

rpc_prfで指定するPRFトレースファイル監視間隔より長い時間を指定してください。

指定値の目安

監視対象がWindows上のサーバの場合は、PRFトレースファイルがスワップされる間隔より長い時間を指定してください。

7.3.14　画面情報関連定義

形式

[rpc_pac_color=RPCパケット用の色]
[rpc_prf_color_1=PRFトレース用の色1]
[rpc_prf_color_2=PRFトレース用の色2]
[rpc_prf_color_3=PRFトレース用の色3]
[rpc_prf_color_4=PRFトレース用の色4]
[rpc_prf_color_5=PRFトレース用の色5]
[rpc_prf_color_6=PRFトレース用の色6]
[rpc_prf_color_7=PRFトレース用の色7]
[rpc_prf_color_8=PRFトレース用の色8]
[hirdb_pac_color=HiRDBパケット用の色]
[hirdb_server_pac_color=HiRDBサーバのIPアドレス:HiRDBサーバパケット用の色]

機能

画面表示で利用する情報に関連するパラメタを指定します。

指定数

0～1

rpc_pac_colorプロパティ

設定値と省略値

RPCパケット用の色(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《0:0:255》

説明

関連付け情報表示で表示されるRPCパケット用の情報バーに設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_1プロパティ

設定値と省略値

PRFトレース用の色1(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《255:136:68》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの1番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_2プロパティ

設定値と省略値

PRFトレース用の色2(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《136:68:255》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの2番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_3プロパティ

設定値と省略値

PRFトレース用の色3(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《68:255:255》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの3番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_4プロパティ

設定値と省略値

PRFトレース用の色4(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《136:68:68》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの4番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_5プロパティ

設定値と省略値

PRFトレース用の色5(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《68:255:68》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの5番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_6プロパティ

設定値と省略値

PRFトレース用の色6(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《136:136:0》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの6番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_7プロパティ

設定値と省略値

PRFトレース用の色7(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《255:255:68》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの7番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

rpc_prf_color_8プロパティ

設定値と省略値

PRFトレース用の色8(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《255:68:255》

説明

関連付け情報表示で表示されるPRFトレース用の情報バーの8番目に設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

rpc_prf_color_1からrpc_prf_color_8まで順番に利用され、rpc_prf_color_8まで利用された場合はrpc_prf_color_1から順に再利用されます。

ほかのプロパティとの関連

rpc_linkにYを指定したときだけ有効となります。

hirdb_pac_colorプロパティ

設定値と省略値

HiRDBパケット用の色1(RR:GG:BB)

～〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255)) 《0:136:136》

説明

関連付け情報表示で表示されるHiRDBパケット用の情報バーに設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

ほかのプロパティとの関連

hirdb_serverを指定したときだけ有効となります。

hirdb_server_pac_colorプロパティ

設定値と省略値

HiRDBサーバのIPアドレス:HiRDBパケット用の色[,HiRDBサーバのIPアドレス:HiRDBパケット用の色…]

説明

関連付け情報表示で表示されるHiRDBパケット用の情報バーに設定する色と、HiRDBサーバを関連づける定義です。指定できる組み合わせの最大数は8個です。このプロパティで指定していないHiRDBサーバの情報バーの色については、hirdb_pac_color指定値になります。

HiRDBサーバのIPアドレス nnn.nnn.nnn.nnn〈符号なし整数〉

HiRDBサーバのIPアドレスを指定します。

nnnに0以上255以下の数を入力します。

ただし、0.0.0.0および255.255.255.255は指定できません。

HiRDBパケット用の色　RR:GG:BB〈符号なし整数〉((RR:0～255))((GG:0～255))((BB:0～255))

HiRDBパケット用の情報バーに設定する色を「赤の値:緑の値:青の値」の形式で指定します。赤、緑、青の各色を0～255の値で指定すると、値の組み合わせによって色が決まります。

ほかのプロパティとの関連

hirdb_serverを指定したときだけ有効になります。

7.4　Java VMオプションファイル

Java VMオプションファイルの定義項目

Java VMオプションファイルでは、システム分析支援リアルタイムモニタが使用するJava VMのオプションを設定します。

運用環境によって変更が必要となる定義について説明します。ここで説明していない定義については変更しないでください。

表7‒6　Java VMオプションファイルの定義項目

プロパティ

内容

SDP_INITIAL_MEM_SIZE

オプション名： -Xms<size>※

Javaヒープの初期サイズを指定します。

このプロパティには、システム分析支援リアルタイムモニタのメモリ所要量として計算した値を指定してください。

メモリ所要量については、システム分析支援リアルタイムモニタのリリースノートを参照してください。

SDP_MAX_MEM_SIZE

オプション名： -Xmx<size>※

Javaヒープの最大サイズを指定します。

このプロパティには、システム分析支援リアルタイムモニタのメモリ所要量として計算した値を指定してください。

メモリ所要量については、システム分析支援リアルタイムモニタのリリースノートを参照してください。

注※

<size>の単位はバイトです。

kまたはKを付記するとキロバイト、mまたはMを付記するとメガバイトで指定できます。

（例）

-Xms6291456：6,291,456バイト

-Xms6144k：6,144キロバイト

-Xms6m：6メガバイト

記述形式

パラメタは次の形式で記述します。

プロパティ=オプション名

空白はコメントにだけ指定してください。

1つのパラメタ名に指定できるJava VMオプションは1つです。

7.5　システムコンフィグプロパティファイル

システムコンフィグプロパティファイルでは、システム分析支援リアルタイムモニタが使用するJava VMのポート番号を設定します。

運用環境によって変更が必要となる定義について説明します。ここで説明していない定義については変更しないでください。

表7‒7　システムコンフィグプロパティファイルの定義項目

プロパティ

内容

デフォルト値

rmi.serverPort

Java VMのポート番号を指定します。

29108

7.6　Webコンテナサーバ用オプション定義ファイル

Webコンテナサーバ用オプション定義ファイルでは、ダッシュボードの環境を設定します。

運用環境によって変更が必要となる定義について説明します。ここで説明していない定義については変更しないでください。

表7‒8　Webコンテナサーバ用オプション定義ファイル

プロパティ

内容

デフォルト値

add.jvm.arg※

Javaヒープの初期サイズを指定します。

このプロパティには、システム分析支援リアルタイムモニタのメモリ所要量として計算した値を指定してください。

メモリ所要量については、システム分析支援リアルタイムモニタのリリースノートを参照してください。

-Xms256m

Javaヒープの最大サイズを指定します。

このプロパティには、システム分析支援リアルタイムモニタのメモリ所要量として計算した値を指定してください。

メモリ所要量については、システム分析支援リアルタイムモニタのリリースノートを参照してください。

-XmxNNNm

NNN:esrtmsetupコマンドの情報を基に製品が設定

DefNew領域に対するTenured領域の割合を指定します。

Garbage First Garbage Collection（G1GC）を使用するときは指定しないでください。

-XX:NewRatio=2

Permanent領域の初期サイズを指定します。

（-XX:PermSize）

-XX:PermSize=64m

Permanent領域の最大サイズを指定します。

（-XX:MaxPermSize）

-XX:MaxPermSize=64m

その他のJava VMオプション

－

注※

複数のオプションを指定する場合は、次のように複数回指定してください。

add.jvm.arg=-Xms256m

add.jvm.arg=-Xmx1024m

8　運用コマンド

システム分析支援リアルタイムモニタの運用コマンドについて説明します。

8.1　運用コマンドの記述形式

運用コマンドの記述形式を次に示します。

コマンド名　オプション　コマンド引数

コマンド名

コマンド名は、実行する運用コマンドのファイル名です。

オプション

コマンドオプションの指定方法を次に記します。

なお、次の説明文中の‘$’はシェルプロンプトを、“cmd”はコマンド名称をそれぞれ示します。

オプションの指定方法

オプションは‘-’（半角のマイナス記号）で始まる文字列です。オプションは、コマンド引数より前に指定する必要があります。なお、オプションの指定順序は問いません。

2つのマイナス記号（--）はオプションの終わりを示します。なお、マイナス記号だけのオプションは入力できません。

オプションの記述形式を次に示します。

$cmd -オプションフラグ

（凡例）オプションフラグ：1文字の英数字（英字の大文字小文字は区別する）。

オプションの記述例を次に示します。

（記述例1）

$cmd -a -b -c

（記述例2）

次の入力では、“-b”をコマンド引数と見なします。

$cmd -a -- -b

（記述例3）

次の入力では、‘-’をオプションではなくコマンド引数と見なします。

$cmd -

ヘルプメッセージオプション

システム分析支援リアルタイムモニタが提供するコマンドでは、コマンドの使用方法などのヘルプメッセージを出力するためのオプション（-h）があります。当該オプションを指定してコマンドを入力した場合、当該コマンドのヘルプメッセージを出力します。

ヘルプメッセージオプションの記述例を次に示します。

$cmd -h

フラグ引数

オプションには、1つのフラグ引数を持つものと、フラグ引数を持たないものがあります。

フラグ引数を持たないオプションの指定方法

フラグ引数を持たないオプションは、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）

次の入力は、‘a’のフラグ引数として2を有効とします。

$cmd -a 1 -a 2
（aはフラグ引数を持つオプション、1、2はフラグ引数）

（記述例3）

次の入力はエラーとなります。

$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文字は記述できません。

戻り値

コマンド実行結果の戻り値について説明しています。

出力形式

コマンドを受け付けた場合、次の形式で標準出力にメッセージを出力します。

Command△:△コマンド名,△Setup△directory△name△:△運用ディレクトリ名

注意事項

各コマンドは同時に複数実行しないでください。同時に実行した場合、実行環境が壊れるおそれがあります。実行環境が壊れた場合、再セットアップが必要となります。

8.2　運用コマンドの一覧

表8‒1　システム分析支援リアルタイムモニタの運用コマンド

コマンド名

機能

esrtmls

システム分析支援プロセスの状態を一覧表示します。

esrtmrasget

保守資料を取得します（一次資料）。

esrtmsetup

システム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を作成・更新します。

esrtmstart

システム分析支援リアルタイムモニタ、システム分析支援アダプタを起動します。

esrtmstop

システム分析支援リアルタイムモニタ、システム分析支援アダプタを終了します。

esrtmunsetup

システム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を削除します。

esrtmtrced

稼働情報ファイルを編集してCSVファイルに出力します。

表8‒2　システム分析支援アダプタの運用コマンド

コマンド名

機能

esipclscn

システム分析支援リアルタイムモニタとのコネクションを表示します。

esjobls

システム検証支援基盤のプロセスの状態を一覧表示します。

esrtmstced

稼働状況を分析するための情報をファイル出力します。

8.3　システム分析支援リアルタイムモニタの運用コマンド

8.3.1　esrtmls（プロセスの状態表示）

目的

システム分析支援プロセスの状態を一覧表示します。

形式

esrtmls [ -s { all | rtm | adp } ]

機能

システム分析支援リアルタイムモニタ、システム分析支援アダプタの状態を一覧表示します。

コマンド実行パス

運用ディレクトリ¥bin¥esrtmls

オプション

-s { all | rtm | adp }《 all 》

プロセス状態を出力するプロセスを指定する場合に指定します。

all

システム分析支援リアルタイムモニタ、システム分析支援アダプタの状態を表示します。

rtm

システム分析支援リアルタイムモニタの状態だけを表示します。

adp

システム分析支援アダプタの状態だけを表示します。

戻り値

0：-sオプションで指定されたすべてのプロセスが稼働中（ONLINE）です。

1：コマンドでエラーが発生しました。

2：-sオプションで指定されたプロセスは停止中（OFFLINE）のものがあります。

出力形式

次の情報を標準出力に表示します。

Real-Time Monitor：システム分析支援リアルタイムモニタ

Adapter：システム分析支援アダプタ

Item                    Name              Status
Real-Time Monitor       -                 bb…bb
Adapter                 aa…aa            bb…bb

aa…aa

アダプタ識別子

StatusがOFFLINEの場合は「-」で表示します。

bb…bb

状態

ONLINE：稼働中

OFFLINE：停止中

8.3.2　esrtmrasget（保守資料の取得）

目的

システム分析支援のトラブルシュートに必要な保守資料を取得します。

形式

esrtmrasget 取得先ディレクトリ名

機能

システム分析支援リアルタイムモニタのトラブルシュートに必要な保守資料を、指定されたファイルに取得します。

取得するのは、esrtmrasgetコマンド実行時の運用ディレクトリのシステム分析支援リアルタイムモニタの情報と、システム分析支援アダプタの情報です。

コマンド実行パス

運用ディレクトリ¥bin¥esrtmrasget

オプション

なし。

コマンド引数

保守資料取得先ファイルを格納するディレクトリ名を128文字以内のフルパスで指定します。空白を含むディレクトリ名は指定できません。

戻り値

0：保守資料を取得しました。

1：保守資料を取得できませんでした。

出力形式

esrtmrasget:TargetDirectory=xxx

8.3.3　esrtmsetup（実行環境のセットアップ）

目的

運用ディレクトリ下にシステム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を作成、または更新します。

形式

esrtmsetup [-d 運用ディレクトリパス] [-w Webコンテナ名]
           [-o ダッシュボード出力用ポート番号]
           [-c Webコンテナ通信用ポート番号]
           [-e Webコンテナ終了用ポート番号]
           [-i 稼働情報最大保持件数]
           [-a アラート検知稼働情報最大保持件数]

機能

システム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を作成します。

コマンドの実行結果は標準出力に出力されます。実行環境の更新時は作成するディレクトリ、ファイルが存在しない場合に作成し、存在した場合はファイルを上書きします。例外的に上書きしないファイルを次に示します。

稼働情報格納領域

本コマンドは次の用途で使用します。

新規に実行環境を作成する

構築済みの実行環境を更新する

また、次のシステム分析支援リアルタイムモニタの定義ファイルは上書き対象ですが、元のファイルのバックアップを作成します。

運用ディレクトリ¥conf¥hsicrtm_config.properties

運用ディレクトリ¥conf¥jvm_options.cfg

運用ディレクトリ¥conf¥system_config.properties

バックアップファイルは運用ディレクトリ¥conf内に格納します。

バックアップファイルは定義ファイルごとに最大3つまで作成し定義ファイル名の末尾に.bk1、.bk2、.bk3を付けて作成します。

バックアップファイル名の形式例を次に示します。

形式例

hsicrtm_config.properties.bk1
hsicrtm_config.properties.bk2
hsicrtm_config.properties.bk3

バックアップファイルは、.bk1、.bk2、.bk3の順に新しい定義のバックアップです。

バックアップファイル作成時に、運用ディレクトリ¥conf内にすでにバックアップファイルが3つ存在する場合は、.bk3のバックアップファイルの定義が消去されます。

コマンド実行の前提条件

実行環境を更新する前に、esrtmlsコマンドでシステム分析支援リアルタイムモニタが終了していることを確認してください。

システム分析支援リアルタイムモニタが起動している場合はesrtmstopコマンドで終了後、本コマンドを実行してください。

コマンド実行パス

インストールディレクトリ¥bin¥esrtmsetup

オプション

-d 運用ディレクトリパス ～〈108文字以内のパス名〉

《 インストールディレクトリ¥job¥HSICRTM00 》

作成（または更新）するシステム分析支援リアルタイムモニタの運用ディレクトリを絶対パスで指定します。

次の条件に該当するディレクトリパスは指定しないでください。

存在しないディレクトリパス

"¥¥"を含むディレクトリパス

"¥"で終端しているディレクトリパス

シンボリックリンクを含むディレクトリパス

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

空白を含むディレクトリパス

-w Webコンテナ名～〈16文字以内の文字列〉《HSICRTM_Server》

ダッシュボード出力時に使用するWebコンテナのサーバ名を指定します。

指定するサーバ名の条件を次に示します。

サーバ名称には、半角英数字（0～9、A～Z、a～z）、アンダースコア（_）またはハイフン（-）が使用できます。サーバ名称の先頭の文字は英数字でなければなりません。

セットアップ済みのサーバ名称を指定して再セットアップを行うと、エラーとなります。

サーバ名称の大文字・小文字は区別されません。

-o ダッシュボード出力用ポート番号～〈符号なし整数〉((1～65535))《29105》

ダッシュボード出力用のポート番号を指定します。

ポート番号は、ほかのプログラムと重複しないようにしてください。

-c Webコンテナ通信用ポート番号～〈符号なし整数〉((1～65535))《29106》

Webコンテナとの通信で使用するポート番号を指定します。

ポート番号は、ほかのプログラムと重複しないようにしてください。

-e Webコンテナ終了用ポート番号～〈符号なし整数〉((1～65535))《29107》

Webコンテナの終了時に使用するポート番号を指定します。

ポート番号は、ほかのプログラムと重複しないようにしてください。

-i 稼働情報最大保持件数～〈符号なし整数〉((10000～1000000))《100000》

ダッシュボードの稼働情報表示エリアに表示するために保持する稼働情報の最大件数を指定します。

稼働情報が本指定値を超えたときは、古い稼働情報を削除します。

-a アラート検知稼働情報最大保持件数～〈符号なし整数〉((100～100000))《1000》

ダッシュボードのアラート検知表示エリアに表示するために保持する稼働情報の最大件数を指定します。

稼働情報が本指定値を超えたときは、古い稼働情報を削除します。

実行環境の新規作成、または実行環境の更新時に指定できるオプションを次に記載します。

目的

-d

-w

-o

-c

-e

-i

-a

実行環境の新規作成

○

○

○

○

○

○

○

実行環境の更新

○

×

×

×

×

×

×

（凡例）

○：省略できるオプション

×：指定できないオプション（コマンドがエラー終了）

戻り値

0：コマンドが正常に終了しました。

1：コマンドでエラーが発生しました。

コマンド実行例

実行環境の新規作成の場合

# esrtmsetup -d 運用ディレクトリ
KFSE94255-Q The execution environment will be set up. Do you want to continue? [y: Continue n: Cancel] setup mode = new, setup directory = <運用ディレクトリ>
y （ユーザーがyと入力）
KFSE94254-I The execution environment was set up. setup directory = 運用ディレクトリ

実行環境の更新の場合

# esrtmsetup -d 運用ディレクトリ
KFSE94255-Q The execution environment will be set up. Do you want to continue? [y: Continue n: Cancel] setup mode = update, setup directory = <運用ディレクトリ>
y （ユーザーがyと入力）
KFSE94254-I The execution environment was set up. setup directory = 運用ディレクトリ

注意事項

実行環境は1つだけ作成できます。実行環境を2つ以上作成した場合の動作は保証しません。

このコマンドの実行中にこのコマンドを含むほかのコマンドを実行しないでください。

8.3.4　esrtmstart（起動）

目的

システム分析支援リアルタイムモニタ、システム分析支援アダプタを起動します。

形式

esrtmstart

機能

システム分析支援リアルタイムモニタ、システム分析支援アダプタを起動します。

次の場合に、本コマンドを実行してください。

システム分析支援を起動して、電文分析を開始する場合

システム分析支援リアルタイムモニタ、システム分析支援アダプタのどちらかが停止している状態から、電文分析を再開したい場合

本コマンドは次の処理を実行します。

システム分析支援リアルタイムモニタの起動

システム分析支援アダプタの起動

コマンド実行の前提条件

esrtmstartコマンド実行には次の設定が必要です。

システム分析支援リアルタイムモニタ定義

運用ディレクトリ¥conf¥hsicrtm_config.properties

コマンド実行パス

運用ディレクトリ¥bin¥esrtmstart

オプション

なし。

戻り値

0：コマンドが正常に終了しました。

1：コマンドでエラーが発生しました。

注意事項

システム分析支援が起動中の場合、システム分析支援リアルタイムモニタの定義情報を変更しないでください。システム分析支援リアルタイムモニタの定義情報を変更する場合は、esrtmstopコマンドでシステム分析支援を停止させてください。

前回の起動からシステム分析支援アダプタのアダプタ識別子を変更する場合は、不要なアダプタの実行環境を削除するため、esjobrmコマンドのテスト識別子に古いアダプタ識別子を指定し、esjobrmコマンドを実行してください。

8.3.5　esrtmstop（停止）

目的

システム分析支援リアルタイムモニタ、システム分析支援アダプタを停止します。

形式

esrtmstop [-f [-d]]

機能

システム分析支援リアルタイムモニタ、システム分析支援アダプタを停止します。

本コマンドは次の処理を実行します。

システム分析支援リアルタイムモニタ、システム分析支援アダプタの停止

システム分析支援リアルタイムモニタ、システム分析支援アダプタの強制停止

システム分析支援アダプタのcoreファイル取得

コマンド実行パス

運用ディレクトリ¥bin¥esrtmstop

オプション

-f

システム分析支援リアルタイムモニタ、システム分析支援アダプタを強制停止したい場合に指定します。

-d

システム分析支援アダプタを強制終了する際に、coreファイルを出力します。

coreファイルのサイズは、システム分析支援アダプタの実行環境のcoreファイルサイズ上限によります。coreファイルサイズ上限に0が設定されている場合は、このオプションフラグを指定してもcoreファイルを出力しません。

本オプションを指定した場合でも、システム分析支援リアルタイムモニタのcoreファイルは取得できません。

戻り値

0：コマンドが正常に終了しました。

1：コマンドでエラーが発生しました。

注意事項

本コマンドを実行してもシステム分析支援リアルタイムモニタ、システム分析支援アダプタが停止しない場合はesrtmstop -fで強制終了してください。

-fオプションを指定して終了した場合、KFSE64214-Eメッセージは出力されません。

8.3.6　esrtmunsetup（実行環境のアンセットアップ）

目的

システム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を削除します。

形式

esrtmunsetup [-d 運用ディレクトリパス]

機能

システム分析支援リアルタイムモニタの実行環境（運用ディレクトリ）を削除します。コマンドの実行結果は標準出力に出力されます。

本コマンドは次の用途で使用します。

実行環境を削除する

システム分析支援リアルタイムモニタをアンインストールする場合（バージョンアップの手順としてのアンインストールは除く）は、アンインストール前に必ず本コマンドを実行してください。

アンセットアップコマンドは、運用ディレクトリ下の情報のうち、次の情報は削除しません。これ以外の運用ディレクトリ下の情報はすべて削除しますので、注意してください。

運用ディレクトリのconfディレクトリ内の定義ファイル

運用ディレクトリのsave ディレクトリ内の稼働情報格納領域

コマンド実行の前提条件

コマンド実行前に、esrtmlsコマンドでシステム分析支援リアルタイムモニタが停止していることを確認してください。

システム分析支援リアルタイムモニタが稼働している場合はesrtmstopコマンドで終了後、本コマンドを実行してください。

コマンド実行パス

インストールディレクトリ¥bin¥esrtmunsetup

オプション

-d 運用ディレクトリパス ～〈108文字以内のパス名〉

《 インストールディレクトリ¥job¥HSICRTM00 》

削除する運用ディレクトリのパスを絶対パスで指定します。

次の条件に該当するディレクトリパスは指定しないでください。

存在しないディレクトリパス

"¥¥"を含むディレクトリパス

"¥"で終端しているディレクトリパス

シンボリックリンクを含むディレクトリパス

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

空白を含むディレクトリパス

戻り値

0：コマンドが正常に終了しました。

1：コマンドでエラーが発生しました。

コマンド実行例

# esrtmunsetup -d 運用ディレクトリ
KFSE94259-Q Do you want to delete the execution environment? [y: Continue n: Cancel] operation directory = 運用ディレクトリ
y （ユーザーがyと入力）
KFSE94258-I The unsetup of the execution environment was performed. setup directory = 運用ディレクトリ

注意事項

アンセットアップ中にエラーが発生した場合、エラーの要因を取り除いたあとに再度このコマンドを実行してください。

このコマンドの実行中にこのコマンドを含むほかのコマンドを実行しないでください。

8.3.7　esrtmtrced（稼働情報ファイルの編集出力）

目的

稼働情報ファイルを編集してCSVファイルに出力します。

形式

esrtmtrced -f 制御文ファイル名

機能

稼働情報ファイルに取得した稼働情報を制御文ファイルに指定された情報を基に編集して、CSVファイルに出力します。

制御文ファイルのプロパティに指定できる検索条件を次に示します。複数のプロパティを指定したときは、論理積条件になります。

時刻範囲による検索

サーバのIPアドレスとポート番号による検索

クライアントのIPアドレスとポート番号による検索

応答時間による検索

電文キー（PRFキー含む）による検索

システム名による検索

コマンド実行パス

運用ディレクトリ¥bin¥esrtmtrced

オプション

-f 制御文ファイル名 ～〈259文字以内のパス名〉

検索条件などを指定した制御文ファイル名を絶対パスで指定します。

戻り値

0：正常に修了しました。

1：コマンドでエラーが発生しました。

制御文ファイル

形式

制御文ファイルの記述形式や記号については、「7.1.1　システム定義の記述形式」を参照してください。

プロパティ

形式

adapter_id=アダプタ識別子
save_dir=稼働情報ファイル格納ディレクトリパス
out_file=結果出力ファイル名
[out_file_type={1 | 2 | 3 | 4}]
[start_time=検索開始時刻]
[end_time=検索終了時刻]
[server=サーバのIPアドレス[:サーバのポート番号]]
[client=クライアントのIPアドレス[:クライアントのポート番号]]
[response_time=応答時間]
[telkey=電文キー]
[system_name=システム名]

adapter_idプロパティ

指定数

1

設定値と省略値

～〈1～26文字の英大識別子〉

説明

稼働情報を取得したアダプタ識別子を指定します。

save_dirプロパティ

指定数

1

設定値と省略値

～〈210バイト文字以内のパス名〉

説明

稼働情報ファイル格納ディレクトリの絶対パスを指定します。

稼働情報蓄積関連定義のsave_dirプロパティの値、または管理ファイルと稼働情報管理ファイルが格納されているディレクトリを指定してください。

out_fileプロパティ

指定数

1

設定値と省略値

～〈258バイト文字以内のパス名〉

説明

編集結果を出力するファイルの絶対パスを指定します。

稼働情報蓄積関連定義のsave_dirプロパティの値、または管理ファイルと稼働情報管理ファイルが格納されているディレクトリを指定してください。

out_file_typeプロパティ

指定数

0～1

設定値と省略値

1 | 2 | 3 | 4《1》

説明

結果出力ファイルの出力形式を指定します。

1：プロトコル共通形式

2：RPCプロトコルのサーバ間連携機能形式

3：HiRDB形式（オペレーション単位）

4：HiRDB形式（SQL文単位）

start_timeプロパティ

指定数

0～1

設定値と省略値

開始時刻(YYYYMMDDhhmmss)〈符号なし整数〉

((1971〜9999、01〜12、01〜31、00〜23、00〜59、00〜59)) 《19710101000000》

説明

検索対象とする稼働情報の開始時刻を指定します。

開始時刻以降の稼働情報が検索対象になります。

end_timeプロパティ

指定数

0～1

設定値と省略値

終了時刻(YYYYMMDDhhmmss)〈符号なし整数〉

((1971〜9999、01〜12、01〜31、00〜23、00〜59、00〜59))《現在時刻》

説明

検索対象とする稼働情報の終了時刻を指定します。

終了時刻以前の稼働情報が検索対象になります。

serverプロパティ

指定数

0～1

設定値と省略値

サーバのIPアドレス(nnn.nnn.nnn.nnn)[:サーバのポート番号][,サーバのIPアドレス(nnn.nnn.nnn.nnn) [:サーバのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

検索対象とするサーバのIPアドレスとポート番号を組み合わせて指定します。

組み合わせの最大数は64個です。複数指定したときは、論理和条件になります。

このプロパティを省略するとすべてのサーバが検索対象です。

clientプロパティ

指定数

0～1

設定値と省略値

クライアントのIPアドレス(nnn.nnn.nnn.nnn)[:クライアントのポート番号][,クライアントのIPアドレス(nnn.nnn.nnn.nnn) [:クライアントのポート番号]…]～〈符号なし整数〉((nnn:0～255)) ((ポート番号:1～65535))

説明

検索対象とするクライアントのIPアドレスとポート番号を組み合わせて指定します。

組み合わせの最大数は64個です。複数指定したときは、論理和条件になります。

このプロパティを省略するとすべてのクライアントが検索対象です。

response_timeプロパティ

指定数

0～1

設定値と省略値

～〈符号なし整数〉((1～3600000))(単位:ミリ秒)

説明

検索対象とする応答時間を指定します。

この指定時間以上、時間が掛かっている稼働情報が検索対象になります。

このプロパティを省略するとすべての応答時間が検索対象です。

telkeyプロパティ

指定数

0～1

設定値と省略値

～〈2～64文字の文字列〉

説明

検索対象とする電文キーを指定します。

このプロパティを省略するとすべての電文キーが検索対象です。

system_nameプロパティ

指定数

0～1

設定値と省略値

システム名[,システム名…]～〈1～31文字の英数字〉

説明

検索対象とするシステム名を指定します。

システム名の最大数は64個です。複数指定したときは、論理和条件になります。

このプロパティを省略するとすべてのシステム名が検索対象です。

結果出力ファイル形式

結果出力ファイルの出力形式については、「付録D　ダウンロード可能なCSV ファイルの一覧」を参照してください。

制御文ファイル例

次の検索条件のときの制御文ファイルの例を示します。

開始時刻が2018/07/24 09:00:00から2018/07/24 17:00:00の間

サーバIPアドレスが10.197.35.35、または10.197.35.36

応答時間が1000ミリ秒以上

adapter_id=HSICRTM00
save_dir=C:¥¥hitachi¥¥HSIC_RTM¥¥job¥¥HSICRTM00¥¥save
out_file=C:¥¥out_file.csv
out_file_type=1
start_time=20180724090000
end_time=20180724170000
server=10.197.35.35,10.197.35.36
response_time=1000

8.4　システム分析支援アダプタの運用コマンド

8.4.1　esipclscn（コネクションの表示）

目的

システム分析支援リアルタイムモニタとのコネクションを表示します。

形式

esipclscn [-g テスト識別子]

機能

システム分析支援アダプタが使用しているシステム分析支援リアルタイムモニタとのコネクションを表示します。

オプション

-g テスト識別子　～〈1～31文字の識別子〉《HSIC00》

テスト識別子としてアダプタ識別子を指定します。

アダプタ識別子は実行中のシステム分析支援アダプタ識別子を指定してください。

出力形式

日本語の場合

テスト識別子＝aa…aa
自ＩＰアドレス     自ポート番号  相手ＩＰアドレス  相手ポート番号  プロトコル種別  作成時刻            最終使用時刻
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

aa…aa ：テスト識別子としてアダプタ識別子が表示されます。

bbb.bbb.bbb.bbb：自IPアドレス

ccccc ：自ポート番号

ddd.ddd.ddd.ddd：相手IPアドレス

eeeee ：相手ポート番号

fff ：システム分析支援リアルタイムモニタとのコネクション種別

RTM：システム分析支援リアルタイムモニタ

y1/m1/d1 h1:m1:s1：作成時刻（『年/月/日 時:分:秒』、年は下2桁で表示）

y2/m2/d2 h2:m2:s2：最終使用時刻（『年/月/日 時:分:秒』、年は下2桁で表示）

コネクションを使用して一度も送受信を行っていない場合は、「-」を出力します。

表示対象がない場合は、次のメッセージを出力します。

日本語の場合

表示対象のコネクションがありません。

英語の場合

There is no connection to be displayed.

注意事項

本コマンドと通信制御の処理が競合すると、一時的にシステム検証支援基盤の性能が低下することがあります。

8.4.2　esjobls（システム検証支援基盤のプロセスの状態表示）

目的

システム検証支援基盤のプロセスの状態を一覧表示します。

形式

esjobls

機能

システム検証支援基盤のプロセスの状態を一覧表示します。

1回以上起動したことがあるアダプタ識別子のプロセスが表示対象となります。

なお、同一マシンでシステムテスト支援を起動した場合は、システムテスト支援のプロセスの状態も一覧表示されます。

本コマンドはスーパーユーザー、または一般ユーザーで実行できます。

オプション

なし。

出力形式

アダプタ識別子ごとに、次の情報を標準出力に表示します。

アダプタ識別子

状態・終了要因

実行形態

プロセスID

プロセス起動時刻

プロセス終了時刻

開始時刻

終了時刻

動作種別

プロトコル種別

表示形式を次に示します。

なお、テスト識別子としてアダプタ識別子、テスト開始・終了時刻として開始・終了時刻が表示されます。

日本語の場合

テスト識別子  状態       実行形態         ＰＩＤ  プロセス起動時刻      プロセス終了時刻      テスト開始時刻        テスト終了時刻        種別      プロトコル
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  ffff            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  ffff            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  ffff            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  ffff            gg…gg

aa…aa ：テスト識別子（アダプタ識別子）

bbb ：状態

ACT：稼働中

STP：停止中

eeee ：終了要因

"----"：稼働中

"****"：異常終了

"NORM"：正常終了

"TERM"：強制終了

c1c2c3c4 ：実行形態

未実行の実行形態の個所には"-"を表示する。状態が「STP」の場合は最後に稼働していたときの実行形態を表示する。

c1：p（並行実行）

c2：a（蓄積実行）

c3：r（リプレイ実行）

c4：c（PCAP実行）

未実行の実行形態の個所には「-」を表示する。

dd…dd ：プロセスID

状態が「STP」の場合は最後に稼働していた時のプロセスID

fff ：システム検証支援基盤種別

"RTM"：システム分析支援アダプタ

"---"：種別未確定（プロセス開始時に異常終了など）

gg…gg：プロトコル種別

複数のプロトコルが稼働している場合は":"区切りで表示する。

状態が「STP」の場合は最後に稼働していたときのプロトコル種別を表示する。

TCP：TCP

HTTP：HTTP

RPC：RPC・RAPプロトコル

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環境変数に合わせて取り扱います。

8.4.3　esrtmstced（稼働情報のファイル出力）

目的

稼働状況の分析に必要な稼働情報をCSVファイルに出力します。

形式

esrtmstced [-r] -f 制御文ファイル名

機能

稼働状況を分析するために、一定時間ごと（1日、1時間、1分単位など）や、任意の範囲内の応答時間ごとに、次の情報を稼働情報から集計してファイルに出力します。

応答時間（平均、最大、最小）

トランザクション件数（すべて、正常、エラー、タイムアウト、閾値超過、ユーザー指示）

指定した単位で集計できます。指定できる項目を次に示します。複数指定した場合は、指定した値の組み合わせごとに集計します。例えば、システム名とサーバを指定すると、（システム名×サーバ）ごとに応答時間やトランザクション件数を出力します。

プロトコル種別

システム名

クライアントのIPアドレスとポート番号

サーバのIPアドレスとポート番号

応答時間（ユーザーによる範囲指定）

プロトコル情報（IIOPならばオペレーション名、RPCならばサービスグループ名など）

分析キー情報（稼働情報編集UOCで設定する分析キー情報1と分析キー情報2）

オプション

-r

システム分析支援リアルタイムモニタ実行中にリアルタイムに稼働状況を分析する場合に指定します。制御文ファイルanalyze文time_intervalオペランドに指定した間隔から約1分後に結果を出力します。

-f 制御文ファイル名　　～ ＜259文字以内のパス名＞

稼働状況を分析する方法を記述した制御文ファイルのパスを指定します。

制御文ファイルの形式（共通）

次の文を記述します。

input文

output文

range文

select文

analyze文

input文とoutput文は省略できません。range文、select文、analyze文は省略できます。

それぞれの文は次の形式です。△は1文字以上の半角スペースやタブコード、改行コードです。オペランド名と半角等号記号（=）、半角等号記号（=）とオペランド値、オペランド値と半角セミコロン記号（;）、半角セミコロン記号（;）と次の文の間に1文字以上の半角スペースやタブコード、改行コードを記述することもできます。

コメントを記述することもできます。コメントは半角シャープ記号（#）を使用します。半角シャープ記号（#）から行末までをコメントとして扱います。

オペランドによっては複数の値を列挙できます。その場合、半角コンマ記号（,）で値と値を区切ります。

半角スペース、タブコード、半角コンマ記号（,）、半角セミコロン記号（;）、半角シャープ記号（#）を含む値を記述する場合、その値を半角ダブルクォーテーション記号（"）で囲んでください。半角ダブルクォーテーション記号（"）を含むオペランド値を記述する場合、そのオペランド値を半角ダブルクォーテーション記号（"）で囲み、値に含まれる半角ダブルクォーテーション記号（"）を二重にしてください。

制御文ファイルの形式（input文の場合）

分析する稼働情報の入力情報について指定します。必ず1つ指定してください。複数指定できません。各オペランドは任意の順番で指定できます。

形式を次に示します。

input adapter_id=アダプタ識別子
   save_directory=稼働情報格納ディレクトリ名
  ;

オペランドを次に示します。

adapter_id=アダプタ識別子 ～ 〈1～26文字の英大識別子〉

稼働情報を取得したアダプタ識別子を指定します。

save_directory=稼働情報格納ディレクトリ ～ ＜210文字以内のパス名＞

稼働情報格納ディレクトリの絶対パスを指定します。

稼働情報蓄積関連定義のsave_dirプロパティの値を指定してください。

-rオプションを指定していない場合、稼働情報管理ファイルがあるディレクトリを指定してください。-rオプションを指定した場合、システム分析支援リアルタイムモニタ定義ファイルのsave_dirプロパティに指定したディレクトリを指定してください。

制御文ファイルの形式（output文の場合）

結果の出力先や出力形式を指定します。必ず1つ指定してください。複数指定できません。各オペランドは任意の順番で指定できます。

形式を次に示します。

output target={response | transaction} [,{response | transaction}]
  [ file=結果出力ファイル名 ]
  [ file_header={ y | n } ]
  [ data_title={ y | n } ]
  [ inquiry_overwrite={ y | n } ]
  ;

オペランドを次に示します。

target={ response | transaction } [,{ response | transaction }]

稼働情報から集計して出力したい情報を指定します。同じ値を重複して指定した場合はエラーとします。

response：応答時間の平均値、最大値、最小値

transaction：トランザクションの全体、正常、エラー、タイムアウト、閾値超過、稼働情報編集UOCのユーザー指示件数

file=結果出力ファイル名 ～ ＜259文字以内のパス名＞

結果を出力するファイルの絶対パスを指定します。省略すると標準出力に結果を出力します。

file_header={ y | n }

出力結果の先頭にファイルヘッダ情報を出力するかどうかを指定します。省略するとnを仮定します。

y：ファイルヘッダ情報を出力する

n：ファイルヘッダ情報を出力しない

data_title={ y | n }

集計データ行の前にタイトル行を出力するかどうかを指定します。省略するとyを仮定します。

y：出力する

n：出力しない

inquiry_overwrite={ y | n }

fileオペランドに指定したファイルがすでに存在していた場合、ファイルを上書きする前に問い合わせを行うかどうかを指定します。省略するとyを仮定します。

y：問い合わせを行う

n：問い合わせを行わず上書きする

制御文ファイルの形式（range文の場合）

集計対象とするデータの時間範囲を指定します。省略できます。複数指定できません。

形式を次に示します。

range [ start_time={ YYYYMMDDhhmmss | MMDDhhmmss | hhmmss } ]
  [ end_time={ YYYYMMDDhhmmss | MMDDhhmmss | hhmmss } ]
  [ get_day_num=取得日数 ]
  ;

オペランドを次に示します。

start_time={ YYYYMMDDhhmmss | MMDDhhmmss | hhmmss }

検索開始日時を指定します。本オペランドに指定した日時以降に応答電文を受信した稼働情報が検索対象となります。省略した場合は稼働情報の先頭から検索します。YYYYを省略した場合、コマンド起動時刻の年（西暦）を仮定します。MMDDを省略した場合、コマンド起動時刻の月日を仮定します。-rオプションを指定した場合、本オペランドを無視します。

end_timeとともに指定する場合、オペランド値はend_timeより前の日時を設定してください。

YYYY ～ 〈1971～9999〉

MM ～ 〈01～12〉

DD ～ 〈01～31〉

hh ～ 〈00～23〉

mm ～ 〈00～59〉

ss ～ 〈00～59〉

end_time={ YYYYMMDDhhmmss | MMDDhhmmss | hhmmss }

検索終了日時を指定します。本オペランドに指定した日時より前に応答電文を受信した稼働情報が検索対象となります。20170101000000を指定した場合、検索対象となるのは20161231235959までに応答電文を受信した稼働情報になります。省略した場合は稼働情報の最終まで検索します。YYYYを省略した場合、コマンド起動時刻の年（西暦）を仮定します。MMDDを省略した場合、コマンド起動時刻の月日を仮定します。-rオプションを指定した場合、本オペランドを無視します。

start_timeとともに指定する場合、オペランド値はstart_timeより後の日時を設定してください。

YYYY ～ 〈1971～9999〉

MM ～ 〈01～12〉

DD ～ 〈01～31〉

hh ～ 〈00～23〉

mm ～ 〈00～59〉

ss ～ 〈00～59〉

get_day_num=取得日数 ～ 〈0～1000〉

検索対象開始日付を現在日付から指定値の日数以前とするときに指定します。0を指定したときは、コマンド起動日だけが検索対象となります。start_timeオペランド、もしくはend_timeオペランドのどちらかを指定した場合、または-rオプションを指定した場合、本オペランドを無視します。

制御文ファイルの形式（select文の場合）

集計対象とするデータの検索条件を指定します。指定した各オペランドの論理積条件となります。select文は省略、または64個まで複数指定できます。複数指定した場合、それぞれのselect文同士の論理和条件となります。

複数指定するときは、検索条件が重複しないようにしてください。重複していた場合、検索性能に影響します。

形式を次に示します。

select [ protocol={ tcp | http | iiop | rpc } ]
  [ system_name=システム名 ]
  [ server=IPアドレス[:ポート番号] ]
  [ user_key_1=分析キー情報1 ]
  [ user_key_2=分析キー情報2 ]
  [ prot_inf_1=プロトコル情報1 ]
  [ prot_inf_2=プロトコル情報2 ]
  ;

オペランドを次に示します。

protocol={ tcp | http | iiop | rpc }

検索対象のプロトコル種別を指定します。次の値のどれかを指定します。本オペランドを省略すると、すべてのプロトコル種別が検索対象となります。

tcp：TCPプロトコル

http：HTTPプロトコル

iiop：IIOPプロトコル

rpc：RPCプロトコル

system_name=システム名 ～ 〈1～31文字の英数字〉

検索対象のシステム名を指定します。本オペランドを省略すると、すべてのシステム名が検索対象となります。

server= IPアドレス[:ポート番号] ～ 〈IPアドレス nnn.nnn.nnn.nnn、ポート番号 1～65535〉

検索対象のサーバ（クライアントの接続先）のIPアドレスとポート番号を指定します。IPアドレス、またはIPアドレスとポート番号で指定します。本オペランドを省略すると、すべてのサーバが検索対象となります。

user_key_1=分析キー情報1 ～〈1～32バイトの文字列〉

検索対象の分析キー情報1を指定します。分析キー情報1は稼働情報編集UOCで指定した値です。本オペランドを省略すると、すべての分析キー情報1が検索対象となります。

user_key_2=分析キー情報2 ～〈1～32バイトの文字列〉

検索対象の分析キー情報2を指定します。分析キー情報2は稼働情報編集UOCで指定した値です。本オペランドを省略すると、すべての分析キー情報2が検索対象となります。

prot_inf_1=プロトコル情報1 ～〈1～63バイトの文字列〉

検索対象のプロトコル情報1を指定します。protocolオペランドにiiopを指定した場合はオペレーション名を、protocolオペランドにrpcを指定したときはサービスグループ名を指定することで検索条件を絞ることができます。本オペランドを省略すると、すべてのプロトコル情報1が検索対象となります。

prot_inf_2=プロトコル情報2 ～〈1～63バイトの文字列〉

検索対象のプロトコル情報2を指定します。protocolオペランドにrpcを指定したときはサービス名を指定することで検索条件を絞ることができます。本オペランドを省略すると、すべてのプロトコル情報2が検索対象となります。

制御文ファイルの形式（analyze文の場合）

分析情報を集計する単位を指定します。省略できます。複数指定できません。各オペランドは任意の順番で指定できます。

形式を次に示します。

analyze [ time_interval={ s | m | h | d }[間隔] ]
  [ response_interval=境界値[,境界値…]]
  [ unit=集計単位[,集計単位] ]
  ;

オペランドを次に示します。

time_interval={ s | m | h | d }[ 間隔 ]

応答電文の受信時刻を基に、稼働情報を一定時間ごとに集計し出力する場合に指定します。range文を指定した場合は、range文で指定した範囲で一定時間ごとに集計して出力します。省略すると、稼働情報全体で集計して出力します。このオペランドを指定すると、分析情報の各行に日時を出力します。コマンドの-rオプションを指定した場合、本オペランドを指定しなければなりません。

s[SS]：SS秒間隔で出力します。SSは10、20、30を指定できます。SSを省略すると30を仮定します。10秒間隔とする場合は、「s10」と指定してください。

m[MM]：MM分間隔で出力します。MMは1～30を指定できます。MMを省略すると1を仮定します。10分間隔とする場合は、「m10」と指定してください。

h[HH]：HH時間隔で出力します。HHは1～24を指定できます。HHを省略すると1を仮定します。2時間間隔とする場合は、「h2」と指定してください。

d[D]：D日間隔で出力します。Dは1～7を指定できます。Dを省略すると1を仮定します。7日間隔とする場合は、「d7」と指定してください。

response_interval=境界値[,境界値…] ～〈1～3600000〉（単位:ミリ秒）

稼働情報を応答時間の範囲ごとに集計し出力する場合に指定します。境界値は昇順に32個まで指定できます。本オペランドを省略すると応答時間ごとの集計は行いません。例えば、100,500,1000と指定した場合、0秒以上100ミリ秒未満、100ミリ秒以上500ミリ秒未満、500ミリ秒以上1000ミリ秒未満、1000ミリ秒以上それぞれの範囲のデータを集計します。

このオペランドを指定すると、分析情報の各行に応答時間の範囲の値と単位を出力します。

unit=集計単位[,集計単位]

次の項目単位に集計するときに指定します。コンマ区切りで2つまで指定できます。ただしresponse_intervalオペランドを指定した場合は、1つしか指定できません。

複数指定した場合は指定した各項目の値ごとに集計します。例えば、システム名とサーバを指定した場合、（システム名×サーバ）の組み合わせごとに応答時間やトランザクション件数を出力します。

protocol：プロトコル種別

system_name：システム名

client：クライアントのIPアドレスとポート番号

client_ip：クライアントのIPアドレス

server：サーバのIPアドレスとポート番号（クライアント接続先のIPアドレスとポート番号）

server_ip：サーバのIPアドレス（クライアント接続先のIPアドレス）

user_key_1：稼働情報編集UOCで設定した分析キー情報1

user_key_2：稼働情報編集UOCで設定した分析キー情報2

prot_inf_1：プロトコル情報1

prot_inf_2：プロトコル情報2

出力形式

出力形式を次に示します。コンマ区切り、ダブルクォーテーションで囲んだ形式です。

"*** Operation information Version(aa-aa-aa) ***"  ファイルヘッダ行
"input statement:bb…bb"                           ファイルヘッダ行
"output statement:cc…cc"                          ファイルヘッダ行
"range statement:dd…dd"                           ファイルヘッダ行
"select statement:ee…ee"                          ファイルヘッダ行
  :                                                ファイルヘッダ行
  :                                                ファイルヘッダ行
"analyze statement:ff…ff"                         ファイルヘッダ行

"*** Operation information ***"                    集計データタイトル行
"gg…gg","gg…gg", …… ,"gg…gg"                  集計データ行
"hh…hh","hh…hh", …… ,"hh…hh"                  集計データ行
  :                                                集計データ行
  :                                                集計データ行

aa-aa-aa：当該コマンドを実行したシステム分析支援アダプタのバージョン

bb…bb：制御文ファイルのinput文に指定したオペランドの内容※1

cc…cc：制御文ファイルのoutput文に指定したオペランドの内容※1

dd…dd：制御文ファイルのrange文に指定したオペランドの内容※1※2

ee…ee：制御文ファイルのselect文に指定したオペランドの内容※1※2

ff…ff：制御文ファイルのanalyze文に指定したオペランドの内容※1※2

gg…gg：集計データ行に出力する各データのタイトル

hh…hh：集計データ

注※1：制御文ファイルに余分なスペース、コメントなどを除去し1行で出力します

注※2：該当する文を記述しなかった場合は出力しません

ファイルヘッダ行

コマンド実行時の情報です。制御文ファイルoutput文file_headerオペランドにyを指定した時だけ出力します。

集計データタイトル行

集計データのタイトル行です。集計データ行に出力するデータにあわせて次の表に示す文字列を出力します。制御文ファイルoutput文data_titleオペランドを省略するか、yを指定した時だけ出力します。

表8‒3　集計データタイトル行に出力する文字列

出力内容

説明

date and time

集計時間帯の先頭日時

response lower limit

集計応答時間範囲の下限

response upper limit

集計応答時間範囲の上限

protocol

プロトコル種別

system_name

システム名

client_ip

クライアントのIPアドレス

client_port

クライアントのポート番号

server_ip

サーバのIPアドレス

server_port

サーバのポート番号

user_key_1

分析キー情報1

user_key_2

分析キー情報2

prot_inf_1

プロトコル情報1

prot_inf_2

プロトコル情報2

response average

応答時間の平均値

response maximum

応答時間の最大値

response minimum

応答時間の最小値

transaction all

全トランザクション件数

transaction normal

正常終了したトランザクション件数

transaction protocol error

プロトコルレベルでエラーリターンしたトランザクション件数

transaction time-out

タイムアウトしたトランザクション件数

transaction threshold

閾値超過したトランザクション件数

transaction user error

稼働情報編集UOCの指示でエラーリターンしたトランザクション件数

集計データ行

集計データを、制御文ファイルで指定した単位で1行として出力します。出力条件を満たしたデータを下表の項番順に出力します。項番4の各項目については、unitオペランドで指定した順番となります。項番4の各項目について対象となる情報がないときは、「-」を出力します。

表8‒4　集計データ行に出力する内容

項番

出力内容

出力条件

出力形式

1

集計時間帯の先頭日時

analyze文time_intervalオペランドを指定

YYYY-MM-DD hh:mm:ss形式

2

集計応答時間範囲の下限

analyze文response_intervalオペランドを指定

0～3600000（ミリ秒）

3

集計応答時間範囲の上限

1～65535000（ミリ秒）

4

プロトコル種別

analyze文unitオペランドで当該項目を指定

TCP :TCPプロトコル

HTTP :HTTPプロトコル

IIOP :IIOPプロトコル

RPC :RPCプロトコル

システム名

1～31字以内の英数字

クライアントのIPアドレス

nnn.nnn.nnn.nnn（nnn:0～255）

クライアントのポート番号

1～65535

サーバのIPアドレス

nnn.nnn.nnn.nnn （nnn:0～255）

サーバのポート番号

1～65535

分析キー情報1

稼働情報編集UOCで設定した分析キー情報1

分析キー情報2

稼働情報編集UOCで設定した分析キー情報2

プロトコル情報1

IIOPプロトコルの場合：オペレーション名

RPCプロトコルの場合：サービスグループ名

上記以外の場合：プロトコル個別情報

プロトコル情報2

RPCプロトコルの場合：サービス名

上記以外の場合：プロトコル個別情報

5

応答時間の平均値

output文targetオペランドにresponseを指定

ミリ秒単位、小数点以下第三位までの数値

6

応答時間の最大値

7

応答時間の最小値

8

全トランザクション件数

output文targetオペランドにtransactionを指定

0～9223372036854775807

9

正常終了したトランザクション件数

10

プロトコルレベルでエラーリターンしたトランザクション件数

11

タイムアウトしたトランザクション件数

12

閾値超過したトランザクション件数

13

稼働情報編集UOCの指示でエラーリターンしたトランザクション件数

制御文ファイルと出力例

例1：応答時間ごとにトランザクション件数を出力する場合

制御文ファイル

# コメント
input adapter_id=ADAPTER                         # コメント
      save_directory=d:¥taihi;

output file=c:¥Users¥Guest¥Documents¥output.txt  # コメント
       target=transaction;

analyze response_interval=1000,10000

出力結果

"response lower limit","response upper limit","transaction all","transaction normal",……
"0","1000","30","30","0","0","0","0"
"1000","10000","3","3,"0","0","0","0"
"10000","65535000","0","0","0","0","0"

例2：30秒ごとに応答時間を出力する場合

00:01:30～00:02:00の時間帯は対象となるデータが0件のため、0を出力します。

制御文ファイル

input adapter_id=ADAPTER;

output file=c:¥Users¥Guest¥Documents¥output.txt
       target=response;

analyze time_interval=s30;

出力結果

"date and time","response average","response maximum","response minimum"
"2017-01-01 00:00:00","123.456","987.654","0.999"
"2017-01-01 00:00:30","123.456","987.654","0.999"
"2017-01-01 00:01:00","123.456","987.654","0.999"
"2017-01-01 00:01:30","0","0","0"
"2017-01-01 00:02:00","123.456","987.654","0.999"
  :
  :
  :

例3：1分間隔でサーバごとに応答時間を出力する場合

サーバは3つあり、それぞれIPアドレスが1.1.1.1、2.2.2.2、3.3.3.3とします。

00:01:00～00:02:00の間は、IPアドレス2.2.2.2のデータがないため、1.1.1.1と3.3.3.3の行だけ出力します（データがあるIPアドレスの情報だけを出力）。

00:02:00～00:03:00の間はすべてのサーバについてのデータがないため、"server_ip"と"server_port"には"-"を出力します（データがないときは、unitオペランドに指定した項目は「-」を出力）。

制御文ファイル

input adapter_id=ADAPTER;

output file=c:¥Users¥Guest¥Documents¥output.txt
       target=response;

analyze time_interval=m1 unit=server;

出力結果

"date and time","server_ip","server_port","response average","response maximum","response minimum"
"2017-01-01 00:00:00","1.1.1.1","1","123.456","987.654","0.999"
"2017-01-01 00:00:00","2.2.2.2","2","123.456","987.654","0.999"
"2017-01-01 00:00:00","3.3.3.3","3","123.456","987.654","0.999"
"2017-01-01 00:01:00","1.1.1.1","1","123.456","987.654","0.999"
"2017-01-01 00:01:00","3.3.3.3","3","123.456","987.654","0.999"
"2017-01-01 00:02:00",“-",“-","0","0","0"
"2017-01-01 00:03:00","3.3.3.3","3","123.456","987.654","0.999"
"2017-01-01 00:04:00","1.1.1.1","1","123.456","987.654","0.999"
"2017-01-01 00:04:00","2.2.2.2","2","123.456","987.654","0.999"
"2017-01-01 00:04:00","3.3.3.3","3","123.456","987.654","0.999"
  :
  :
  :

例4：システム名ごとに応答時間を出力する場合

制御文ファイル

input adapter_id=ADAPTER;

output file=c:¥Users¥Guest¥Documents¥output.txt
       target=response;

analyze unit=system_name;

出力結果

"system_name","response average","response maximum","response minimum"
"SYSTEM1","123456","987654","999"
"SYSTEM2","123456","987654","999"
"SYSTEM3","123456","987654","999"

メッセージ

メッセージID

内容

出力先

KFSE95088-E

コマンド引数が不正です

標準エラー出力

KFSE95090-E

コマンドの形式が不正です。

標準エラー出力

KFSE95091-E

フラグ引数が不正です。

標準エラー出力

KFSE90920-I

ヘルプ表示

標準出力

KFSE90921-Q

上書き確認

標準出力

KFSE90922-E

制御文ファイルのアクセスエラー

標準エラー出力

KFSE90923-E

メモリ不足

標準エラー出力

KFSE90924-E

制御文の形式不正

標準エラー出力

KFSE90925-E

制御文の内容不正

標準エラー出力

KFSE90926-E

オペランド値不正

標準エラー出力

KFSE90927-E

内部矛盾

標準エラー出力

KFSE90928-E

コマンド処理で障害発生

標準エラー出力

9　UOCインタフェース

稼働情報を編集するために作成する、UOCインタフェースについて説明します。

9.1　UOCの位置づけ

システム分析支援リアルタイムモニタでのUOCの位置づけを次に示します。

図9‒1　UOCの位置づけ

キャプチャしたパケットを組み立て、要求電文／応答電文を作成します。

応答電文を待ち合わせます。応答電文を受信後に3．を実行します。

システム分析支援リアルタイムモニタに各トランザクションの稼働情報を送信します。

9.2　システム分析支援アダプタで使用できるUOC

システム分析支援アダプタで使用できるUOCを次に示します。

表9‒1　システム分析支援アダプタで使用できるUOC

UOC名

プロトコル

HTTP

IIOP

RPC

TCP

開始終了UOC

○

○

○

○

電文組立UOC

×

×

×

○

電文情報設定UOC

×

×

×

○

稼働情報編集UOC

○

○

○

○

（凡例）

○：使用できる

×：使用できない

9.3　UOCの作成

UOCの作成方法については、マニュアルHitachi System Information Capture リファレンスのユーザオウンコーディング（UOC）の作成の説明を参照してください。

9.4　UOCの詳細

UOCの詳細を説明します。

9.4.1　開始終了UOC

機能

システム分析支援アダプタの開始終了時にUOCを実行します。

形式

ANSI C、C++の形式

#include <escom.h>
ESLONG uoc_func(ESSTENINTERFACE *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

システム分析支援アダプタの開始終了時に呼び出されるUOCです。システム分析支援アダプタは、各情報を格納したパラメタの領域アドレスを引数としてUOCに渡します。

パラメタの内容

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：プロセス終了

run_mode

実行形態を通知します。

ESCLT_RUNMODE_A：システム分析支援リアルタイムモニタ連携

ユーザが設定するパラメタ項目

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と同じ動作をします。

9.4.2　電文組立UOC

機能

業務システムの利用者と、業務システムとの間のパケットをキャプチャしたときにUOCを実行します。パケットをプロトコル電文に組み立てます。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(struct es_plg_uoc_build *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文組立UOCは、パケットをキャプチャしたときに、そのパケットで電文が完成しているかどうかを判定します。

入力パケットの組立

システム検証支援はパケット受信ごとに電文組立UOCにパケットが格納されている受信バッファを引き渡します。電文組立UOCでは、受信バッファを基に電文が完成しているかどうかを判定し、電文が完成したかどうかをリターン値で指定します。電文が未完成の場合、前回までのパケットと、今回受信したパケットを連結して通知します。

なお、電文を組立中のコネクションでパケットロストやコネクション断が検知された場合、システム検証支援は組立中の電文を破棄します。

図9‒2　電文組立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_A：システム分析支援リアルタイムモニタ連携

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文

src_ip

パケットの送信元のIPアドレスを設定します。※

dst_ip

パケットの送信先のIPアドレスを設定します。※

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に通知済みの領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

注※

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オペランドで指定したサイズを超える値が設定されていた場合、該当するメッセージを破棄します。

9.4.3　電文情報設定UOC

機能

電文情報設定UOCは、システム分析支援アダプタの処理に必要な電文情報を指定するUOCです。

形式

ANSI C、C++の形式

#include <esplg_uoc.h>
ESLONG uoc_func(struct es_plg_uoc_info *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

電文入力時に呼び出されるUOCです。

電文情報設定UOCでは、次の情報を設定する必要があります。

ペアリングキー

要求電文種別（クライアントからサーバへの電文の場合）

ペアリングキーの判定

UOCでは、要求電文と応答電文を関連づけるためのペアリングキーを指定する必要があります。

また、要求電文を電文組立UOCで組立後、framework_definition定義の-t reply_watchtimeオペランドに指定した時間経過すると応答待ちタイムアウトとなり、要求電文を破棄します。タイムアウト後に応答電文を受信した場合、応答電文を破棄します。

要求電文種別の判定

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           reserve5[4]; …………… 予備領域
  char           key[64];    ……………… ペアリングキー
  void           *protoinf;  ……………… プロトコル情報（参照できません）
  ESULONG         abort_code;  …………… 強制停止理由コード
  char            reserve6[4]; …………… 予備領域
} 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;

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_A：システム分析支援リアルタイムモニタ連携

protocol

プロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

msgtype

電文種別を設定します。

ESFRW_MSGTYPE_REQUEST_PRO：要求電文

ESFRW_MSGTYPE_RESPONSE_PRO：応答電文

reqtype

ユーザが設定する値です。

システム検証支援はデフォルト値 ESFRW_MSGFORM_SYNC_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アドレスを設定します。※

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_con_area

コネクション単位で共有するユーザ領域を設定します。

各メンバには以下の値が設定されています。

size

コネクション単位ユーザ領域のサイズを設定します。

data

コネクション単位ユーザ領域の先頭アドレスを設定します。

usr_con_area_state

コネクション単位ユーザ領域の状態を設定します。コネクション単位ユーザ領域の状態はコネクション単位ユーザ領域の領域サイズが0以外のときに設定します。

ESFRW_CONTST_NEW

新規に割り当てられた領域であることを示します。

ESFRW_CONTST_RENEW

切断されたコネクションのユーザ領域が再割り当てされて、通知されたことを示します。ユーザ領域内には現在のコネクションとは無関係の情報が設定されている場合があります。必要に応じて、ユーザ領域に残っている必要な情報の退避、および初期化などを実施して使用してください。

ESFRW_CONTST_CONTINUE

当該コネクションのユーザ領域として、UOCに通知済みの領域であることを示します。以前に通知された際に情報を設定していれば、参照することができます。

telegram

入力電文に関する情報を設定します。

各メンバには以下の値が設定されています。

size

入力電文のサイズを設定します。

data

入力電文の先頭アドレスを設定します。

telegram_size

プロトコル種別ごとの入力電文のヘッダ領域を設定します。

client_id

コネクションごとに一意となる値を設定します。

key

ユーザが設定する値です。

デフォルト値として、コネクションごとに一意となる値を設定します。このデフォルト値を使用した場合、同一コネクションの要求電文と応答電文がペアリングされます。

注※

IPアドレスは、次に示す形式で設定します。

IPv4の場合

例）送信元IPが172.165.112.20の場合

ユーザが設定するパラメタ項目

reqtype

要求電文の種別を指定できます。指定できる電文種別は次のとおりです。

ESFRW_MSGFORM_SYNC_ANSWER:同期応答型

ESFRW_MSGFORM_NOANSWER:非応答型

デフォルトでは ESFRW_MSGFORM_SYNC_ANSWERを指定しています。

次の条件を満たす場合に設定してください。

要求電文

条件を満たさない場合、設定する必要はありません。

client_id

設定しないでください。

rtn_detail

詳細コードを-2147483648 〜 2147483647の範囲で設定できます。このコードはUOCがES_UOC_NGをリターンしたときにシステム検証支援に返されます。システム検証支援は詳細エラーコードをメッセージログファイルに出力します。

key

要求電文と応答電文について、システム内で一意となる同じキーを指定してください。

次の条件のどれかに該当する場合、このキーを設定してください。

要求電文と応答電文が異なるコネクション

複数のクライアントがコネクションを共用してサーバと送受信する

条件を満たさない場合、設定する必要はありません。

abort_code

システム検証支援を強制停止する理由を示すコードを0 ～ 4294967295の範囲で設定できます。

このコードはUOCがESPLG_UOC_ABORTをリターンしたときのみ有効です。システム検証支援は強制停止理由コードをKFSE64109-Eメッセージに出力します。

ユーザが設定する項目は、電文のプロトコルとリターン値によって異なります。

ユーザが設定する項目と、電文のプロトコルとリターン値の関係を次に示します。

項目

TCPのリターン値

ES_UOC_OK

ESPLG_UOC_MSG_DESTRUCT

ES_UOC_NG

ESPLG_UOC_ABORT

要求電文種別

○※

×

×

×

クライアント識別子

○

×

×

×

詳細エラーコード

×

×

○

×

ペアリングキー

○

×

×

×

強制停止理由コード

×

×

×

○

（凡例）

○：指定可能

×：指定不可（指定値は無視します）

注※

パケットの電文種別がESFRW_MSGTYPE_REQUEST_PROの場合に有効となります。

リターン値

次のコードでリターン値を設定してください。

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メッセージを出力し、システム検証支援プロセスを強制停止します。

上記以外の場合

システム検証支援は処理を続行します。

9.4.4　稼働情報編集UOC

機能

システム分析支援リアルタイムモニタに送信する稼働情報にユーザ任意の情報を付加できます。

形式

#include <esplg_uoc.h>
ESLONG uoc_func(ESPLG_UOC_RTM *parm)

「uoc_func」部分には、システム内で一意の名称を指定してください。

説明

要求電文と応答電文がそろったときに呼び出されるUOCです。

パラメタの内容

ESPLG_UOC_RTMのパラメタ内容

typedef struct es_plg_uoc_rtm {
  ESULONG run_mode; ………………実行形態
  ESULONG protocol;…………………プロトコル種別
  ESULONG error_inf;……………… エラー情報
  char reserve1[4];……………予備領域
  ESCOM_AREA usr_clt_area;……………未使用
  char usr_clt_area_state;……未使用
  char reserve2[7];…………… 予備領域
  ESCOM_AREA ext_request;…………… 要求電文の情報
  ESPLG_UOC_TELSIZE ext_request_size;… 要求電文のサイズ
  ESCOM_AREA ext_reply;………………応答電文の情報
  ESPLG_UOC_TELSIZE ext_reply_size;……応答電文の電文長
  ESLONG user_code;………………ユーザ情報コード
  char user_system[32];………システム名
  char user_info[128];……… ユーザ情報文字列
  char *protoinf; ……………プロトコル情報
  char analysis_key1[33];…… 分析キー情報1
  char analysis_key2[33];…… 分析キー情報2
  char reserve[54];……………予備領域
} ESPLG_UOC_RTM;

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_TCPSIZE tcp_size; ………… TCP電文サイズ形式
  ESPLG_UOC_HTTPSIZE http_size; ………… HTTP電文サイズ形式
} ESPLG_UOC_TELSIZE;

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_plg_proto_rpc（ESPLG_PROTO_RPC）の内容

typedef struct es_plg_proto_rpc {
  ESLONG protocol_type; …… プロトコル種別詳細
  ESLONG rpc_model; …… RPC形態
  char group[32]; …… サービスグループ名
  char service[32]; …… サービス名
  ESLONG rtncode; …… リターン値
  ESULONG root_number; …… 製品情報
  ESULONG client_number; …… 製品情報
  char root_nodeid[5]; …… 製品情報
  char client_nodeid[5]; …… 製品情報
  char server_nodeid[5]; …… 製品情報
  char reserve[29]; …… 予備領域
} ESPLG_PROTO_RPC;

システム検証支援基盤が設定するパラメタ項目

■es_plg_uoc_rtmのパラメタ項目

run_mode

システム分析支援の実行形態を設定します。

ESFRW_RUNMODE_CREATE_A：システム分析支援リアルタイムモニタ連携

protocol

電文のプロトコル種別を設定します。

ESFRW_PROT_TCP：TCP

ESFRW_PROT_HTTP：HTTP

ESFRW_PROT_IIOP：IIOP

ESFRW_PROT_RPC：RPC

error_inf

要求電文受信後に発生したエラー情報を設定します。

ESFRW_ERROR_NONE

エラーなし

ESFRW_ERROR_RECV_TIMEOUT

応答待ちタイムアウトによる受信不可

コネクション切断、およびパケットロストを含みます。

ESFRW_ERROR_RECV_PROTO

プロトコルレベルのエラー検知

IIOPプロトコルの場合、応答電文のリプライステータスがユーザ例外、システム例外を含みます。

RPCプロトコルの場合、応答電文のリターン値が0以外を含みます。

ext_request

要求電文のサイズと先頭アドレスを設定します。

ext_request_size

プロトコルに応じて電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

ESPLG_UOC_TELSIZE形式については「ESPLG_UOC_TELSIZEの内容」を参照してください。

ext_reply

応答電文のサイズと先頭アドレスを設定します。応答電文がないときは、サイズが0となります。

ext_reply_size

プロトコルに応じて電文のサイズをESPLG_UOC_TELSIZE形式で設定します。

ESPLG_UOC_TELSIZE形式については「ESPLG_UOC_TELSIZEの内容」を参照してください。

protoinf

プロトコル情報の領域アドレスを設定します。

プロトコル種別がESFRW_PROT_IIOPの場合：ESPLG_PROTO_IIOP形式で設定します。

プロトコル種別がESFRW_PROT_RPCの場合：ESPLG_PROTO_RPC形式で設定します。

その他：参照できません。

■es_plg_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 ※3

要求電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

req_service_context_size※1

要求電文のサービスコンテキストサイズを設定します。

サイズが0の場合、要求電文サービスコンテキストは参照できません。

rpy_service_context※2 ※3

応答電文のサービスコンテキストの格納領域アドレスを設定します。

サービスコンテキストの形式は、OMGで規定されているIOP::ServiceContextListとなります。

rpy_service_context_size※1 ※2

応答電文のサービスコンテキストサイズを設定します。

サイズが0の場合、応答電文サービスコンテキストは参照できません。

reply_status※2

応答電文のリプライステータス（reply_status）を設定します。

ESPLG_IIOP_NO_EXCEPTION：NO_EXCEPTION（正常応答）

ESPLG_IIOP_USER_EXCEPTION：USER_EXCEPTION（ユーザ例外）

ESPLG_IIOP_SYSTEM_EXCEPTION：SYSTEM_EXCEPTION（システム例外）

注※1

プロトコル情報種別にESPLG_IIOP_MSG_REQUESTが設定されているときだけ参照できます。

注※2

プロトコル情報種別にESPLG_IIOP_MSG_REPLYが設定されているときだけ参照できます。

注※3

各電文のバイトオーダを考慮して参照してください。

■es_plg_proto_rpcのパラメタ項目

protocol_type

プロトコル種別の詳細を設定します。

ESPLG_PROT_RPC_TYPE_RPC:RPCプロトコル

ESPLG_PROT_RPC_TYPE_RAP:RAPプロトコル

rpc_model

RPC形態（RAPの場合はdc_rpc_callの代理実行形態）を設定します。

ESPLG_PROT_RPC_MODEL_NOFLAGS：同期応答型

ESPLG_PROT_RPC_MODEL_NOWAIT：非同期応答型

ESPLG_PROT_RPC_MODEL_NOREPLY：非応答型

group

要求先のサービスグループ名を設定します。

service

要求先のサービス名を設定します。

rtncode

応答電文のリターン値を設定します。

ユーザが設定するパラメタ項目

user_code

ユーザ任意のコードを-2147483648 ～ 2147483647の範囲で設定してください。

user_system

次に示す機能でシステム名を使用する場合に、英数字で設定してください。

システム分析支援リアルタイムモニタのダッシュボード画面

稼働情報抽出ユティリティ

esrtmstced（稼働情報のファイル出力）

製品では英数字かどうかをチェックしません。英数字以外を設定した場合、上記機能が正常に動作しないことがあります。

文字列の最後にはnull文字を設定してください。null文字がない場合、32バイト目をnull文字に置換します。

システム名の指定がなく、かつシステム分析支援リアルタイムモニタのsystem_nameプロパティに指定がないときは、次のように設定します。

プロトコル種別がESFRW_PROT_TCPの場合：TCP

プロトコル種別がESFRW_PROT_HTTPの場合：HTTP

プロトコル種別がESFRW_PROT_IIOPの場合：IIOP

プロトコル種別がESFRW_PROT_RPCの場合：サービスグループ名

user_info

システム分析支援リアルタイムモニタの画面に出力したいユーザ任意の文字列を設定してください。

文字列にはASCII文字を設定してください。ASCII文字以外を設定した場合、画面に正しく表示されないことがあります。

文字列の最後にはnull文字を設定してください。null文字がない場合、128バイト目をnull文字に置換します。

analysis_key1

次に示す機能で分析キー情報を使用するときに、文字列で設定してください。

稼働情報抽出ユティリティ

esrtmstced（稼働情報のファイル出力）

文字列の最後にはnull文字を設定してください。null文字がない場合、33バイト目をnull文字に置換します。

analysis_key2

次に示す機能で分析キー情報を使用するときに、文字列で設定してください。

稼働情報抽出ユティリティ

esrtmstced（稼働情報のファイル出力）

文字列の最後にはnull文字を設定してください。null文字がない場合、33バイト目をnull文字に置換します。

リターン値

次のコードでリターン値を設定してください。

ESPLG_UOC_OK

アラート検知機能によって、アラート検知画面への出力有無を決定します。

ESPLG_UOC_MSG_DESTRUCT

電文を破棄します。

ESPLG_UOC_NG

アラート検知対象として、アラート検知画面にトランザクションの稼働情報を出力します。

上記以外

ESPLG_UOC_NGと同じ動作をします。

注意事項

電文を編集した場合、その後の処理の保証はしません。

プロトコル種別がESFRW_PROT_IIOP、およびESFRW_PROT_RPCのときは、プロトコルヘッダ部を参照しないでください。

次のシステム名はシステム分析支援リアルタイムモニタのwatch_system_nameプロパティに指定できないため、指定しないことを推奨します。

ALL_SYSTEM

OTHER_SYSTEM

10　稼働情報抽出ユティリティ

稼働情報抽出ユティリティについて説明します。

10.1　稼働情報抽出ユティリティとは

稼働情報抽出ユティリティは、システム分析支援リアルタイムモニタが稼働情報管理ファイルと稼働情報ファイルに格納した稼働情報を、稼働情報単位にUAPが入力できる機能です。UAPは、稼働情報抽出ユティリティが提供するライブラリ関数を使用することで、分析などに必要な稼働情報を入力できます。

以降、稼働情報管理ファイルと稼働情報ファイルを纏めて稼働情報ファイルとして説明します。

表10‒1　稼働情報抽出ユティリティが提供するライブラリ関数

ライブラリ関数

説明

INIT要求

入力する稼働情報の検索条件の設定などを要求します。

GET要求

稼働情報の入力を要求します。

COUNT要求

稼働情報の件数の入力を要求します。

TERM要求

稼働情報の入力の終了を要求します。

図10‒1　稼働情報抽出ユティリティの概要

稼働情報抽出ユティリティが提供する機能を次に示します。

表10‒2　機能一覧

分類

機能名

稼働情報の入力元

稼働情報ファイルからの入力

稼働情報の検索

時刻による検索範囲の指定

プロトコル種別による検索

システム名による検索

電文キーによる検索

ユーザー任意情報による検索

アラート検知対象の検索

応答時間による検索

稼働情報の入力

GET要求による稼働情報の入力

COUNT要求による稼働情報の件数の入力

稼働情報の入力元

稼働情報を取得したシステム分析支援リアルタイムモニタのアダプタ識別子と稼働情報ファイル格納ディレクトリを指定することで、入力対象とする稼働情報ファイルを決定します。

稼働情報の検索

入力する稼働情報の検索条件を指定できます。

時刻による検索範囲の指定

設定した時刻範囲内の稼働情報だけを入力します。

プロトコル種別による検索

プロトコル種別が一致する稼働情報だけを入力します。

システム名による検索

システム名が一致する稼働情報だけを入力します。

電文キーによる検索

電文キーが一致する稼働情報だけを入力します。

ユーザー任意情報による検索

ユーザー任意情報がある稼働情報だけを入力します。

アラート検知対象の検索

アラート検知対象の稼働情報だけを入力します。

応答時間による検索

設定した応答時間以上の稼働情報だけを入力します。

稼働情報の入力

GET要求による稼働情報の入力

GET要求では、INIT要求で設定した検索条件に一致する稼働情報について、次の情報を入力できます。

要求電文の情報

応答電文の情報

システム名

プロトコル情報

COUNT要求による稼働情報の件数の入力

COUNT要求では、INIT要求で設定した検索条件に一致する稼働情報の件数を入力できます。

10.2　稼働情報抽出ユティリティによるUAPの作成

稼働情報抽出ユティリティのUAPの作成を次に示します。

図10‒2　稼働情報抽出ユティリティのUAPの作成

UAPのコーディング

UAPのコーディングにはC言語を使用し、ANSI C形式に従ってコーディングします。UAPをコーディングしてソースファイルを作成するとき、OSの標準機能を使えます。また、コーディング時は次のコーディング規約に従ってください。

"ee"または"es"で始まる名称を使用しないでください。

マルチスレッドでの動作は対応していません。

UAPの翻訳と結合

UAPオブジェクトファイルの作成

ソースファイルをコンパイルして、UAPオブジェクトファイルを作成します。

UAP実行形式ファイルの作成

UAPオブジェクトファイルと次のライブラリをリンケージして、UAP実行形式ファイルを作成します。リンケージオプションについては、稼働情報抽出ユティリティのサンプル（makefile）を参照してください。

稼働情報抽出ユティリティのライブラリ

libsic_rtmutl.dll

その他のライブラリ

UAPで稼働情報抽出ユティリティ以外のライブラリ関数を使用している場合、必要に応じて指定してください。

UAPの環境設定

必要に応じてUAPを実行する環境に次の環境変数を設定します。

SICRTMLOGSTDERR=｛Y｜N｝

稼働情報抽出ユティリティでエラーが発生したときに、エラーメッセージを標準エラー出力に出力するかどうかを指定します。

Y：標準エラー出力にエラーメッセージを出力します。

N：標準エラー出力にエラーメッセージを出力しません。

ただし、次のリターン値は、メッセージ出力対象外です。

ESRTMER_ARGUMENT

ESRTMER_TIMING

ESRTMER_NO_DATA

UAPの実行

UAP実行形式ファイルを実行します。

10.3　稼働情報抽出ユティリティのライブラリ関数の概要

稼働情報抽出ユティリティのライブラリ関数の概要を説明します。

10.3.1　ライブラリ関数の一覧

稼働情報抽出ユティリティのライブラリ関数の一覧を次に示します。

表10‒3　稼働情報抽出ユティリティのライブラリ関数の一覧

機能

C言語ライブラリ

INIT要求

es_rtm_init

GET要求

es_rtm_get

COUNT要求

es_rtm_count

TERM要求

es_rtm_term

10.3.2　ライブラリ関数の発行順序

稼働情報抽出ユティリティのライブラリ関数の発行順序を次に示します

表10‒4　ライブラリ関数の発行順序

前回の要求

今回の要求

INIT要求

GET要求

COUNT要求

TERM要求

なし（最初の要求）

○

×

×

×

INIT要求

×

○

○

○

GET要求

×

○

×

○

COUNT要求

×

×

×

○

TERM要求

○

×

×

×

（凡例）

○：発行できる

×：発行できない

10.3.3　ライブラリ関数の説明形式

ライブラリ関数の文法を、次の形式で説明します。

形式

ライブラリ関数の形式と、パラメタ項目のデータ型を示します。

ANSI Cの形式でコーディングする場合は「ANSI C形式」に従ってください。

パラメタ項目に値を設定するときは、ここで示すデータ型に従ってください。特に断りがないかぎり、パラメタ項目には固有の名称を任意で付けられます。

機能

ここで説明する関数の機能について説明します。

UAPが設定するパラメタ項目

関数の実行時に、値を指定しておくパラメタ項目を示します。各パラメタ項目の説明に従って、値を設定してください。

システム検証支援基盤から値が返されるパラメタ項目

関数を実行したあとに、システム検証支援基盤から値が返されるパラメタ項目（データ領域含む）です。関数の実行後にこのパラメタ項目の内容を参照してください。

リターン値

関数を実行したときに戻ってくる値を、表形式で説明します。このリターン値によって、関数が正常に実行されたかどうかがわかります。エラーが起こったときは、エラーの内容を示します。

UAPを作成するときは、互換性を保つために、必ずここで示す定数名でリターン値を使ってください。リターン値の定数名は、ヘッダファイルで定義されています。リターンされる値の情報が必要なときは、ヘッダファイルの定義を参照してください。

指定例

指定例が必要な関数には記述します。

注意事項

関数を使うときの注意について記述します。

10.4　稼働情報抽出ユティリティのライブラリ関数の詳細

稼働情報抽出ユティリティのライブラリ関数の詳細を説明します。

10.4.1　es_rtm_init（INIT要求）

形式：ANSI Cの形式

#include <esrtm.h>
int es_rtm_init(ESRTM_INITPARAM *initparam_pt, ESLONG flags)
typedef struct es_rtm_initparam_t{ /*INITパラメタ構造体 */
 char adapter_id[32]; /*アダプタ識別子 */
 ESRTM_DIR *dir_pt; /*DIRパラメタ構造体アドレス */
 ESLONG dir_param_num; /*DIRパラメタ数 */
 char yobi1[4]; /*予備 */
 ESRTM_RANGE *range_param_pt;/*RANGEパラメタ構造体アドレス */
 ESRTM_SELECT *select_param_pt;/*SELECTパラメタ構造体アドレス */
 ESLONG select_param_num; /*SELECTパラメタ数 */
 char yobi[188]; /*予備 */
 char system_inf[1024]; /*HSIC情報 */
} ESRTM_INITPARAM;

typedef struct es_rtm_dir_t{ /*DIRパラメタ構造体 */
 char dirpath[1024]; /*稼働情報ファイル格納ディレクトリ */
 char yobi[32]; /*予備 */
} ESRTM_DIR;

typedef struct es_rtm_range_t{ /*RANGEパラメタ構造体 */
 char start_time[16]; /*開始時刻 */
 char end_time[16]; /*終了時刻 */
 ESULONG get_day_num; /*取得日数 */
 char yobi[208]; /*予備 */
 ESULONG system_inf1; /*HSIC情報 */
 ESULONG system_inf2; /*HSIC情報 */
 ESULONG system_inf3; /*HSIC情報 */
} ESRTM_RANGE;

typedef struct es_rtm_select_t{ /*SELECTパラメタ構造体 */
 ESULONG protocol; /*プロトコル種別 */
 char yobi1[4]; /*予備 */
 ESRTM_SYSNAME *sysname_pt /*SYSNAMEパラメタ構造体アドレス */
 ESRTM_TELKEY *telkey_pt; /*TELKEYパラメタ構造体アドレス */
 ESRTM_USERKEY *userkey_pt; /*USERKEYパラメタ構造体アドレス */
 ESRTM_LOCATION *location_pt; /*LOCATIONパラメタ構造体アドレス */
 ESRTM_ALERT *alert_pt; /*ALERTパラメタ構造体アドレス */
 ESRTM_RESPONSE *response_pt; /*RESPONSEパラメタ構造体アドレス */
 char yobi[188]; /*予備 */
 ESULONG system_inf1; /*HSIC情報 */
 ESULONG system_inf2; /*HSIC情報 */
 ESULONG system_inf3; /*HSIC情報 */
} ESRTM_SELECT;

typedef struct es_rtm_sysname_t{ /*SYSNAMEパラメタ構造体 */
 char name[32]; /*システム名 */
 char yobi[224]; /*予備 */
} ESRTM_SYSNAME;

typedef struct es_rtm_telkey_t{ /*TELKEYパラメタ構造体 */
 char key[64]; /*電文キー */
 char yobi[192]; /*予備 */
} ESRTM_TELKEY;

typedef struct es_rtm_userkey_t{ /*USERKEYパラメタ構造体 */
 unsigned char key[64]; /*検索キー */
 ESULONG key_type; /*検索対象種別 */
 ESULONG key_size; /*検索キーサイズ */
 char yobi[184]; /*予備 */
} ESRTM_USERKEY;

typedef struct es_rtm_location_t{ /*LOCATIONパラメタ構造体 */
 unsigned char key[64]; /*検索キー */
 ESULONG key_type; /*検索対象種別 */
 ESULONG key_size; /*検索キーサイズ */
 ESULONG key_location; /*ロケーション */
 char yobi[180]; /*予備 */
} ESRTM_LOCATION;

typedef struct es_rtm_alert_t{ /*ALERTパラメタ構造体 */
 ESULONG alert_type; /*アラート種別 */
 char yobi[252]; /*予備 */
} ESRTM_ALERT;

typedef struct es_rtm_response_t{ /*RESPONSEパラメタ構造体 */
 ESULONG response_time; /*応答時間 */
 char yobi[252]; /*予備 */
} ESRTM_RESPONSE;

es_rtm_initのパラメタとアドレスを次に示します。

機能

稼働情報抽出ユティリティの初期化要求（INIT要求）を行います。

INIT要求では、GET要求、およびCOUNT要求の検索条件を設定します。

次の検索条件については、インデクスを利用して検索するため、検索結果をすぐに返却できます。

RANGEパラメタ構造体の開始時刻、終了時刻、取得日数

UAPが設定するパラメタ項目：initparam_pt

INITパラメタ構造体のアドレスを設定してください。

INITパラメタ構造体に次の情報を設定してください。

■アダプタ識別子

アダプタ識別子を26文字以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

アダプタ連携関連定義のadapter_idプロパティに指定したアダプタ識別子を設定してください。

■DIRパラメタ構造体アドレス

DIRパラメタ構造体のアドレスを設定してください。

DIRパラメタ構造体に次の情報を設定してください。

■稼働情報ファイル格納ディレクトリ

稼働情報管理ファイルと稼働情報ファイルを格納したディレクトリを絶対パス名で210バイト以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

稼働情報ファイル格納ディレクトリの重複チェックは行いません。

■DIRパラメタ数

稼働情報ファイル格納ディレクトリを設定したDIRパラメタ構造体の数を1～16までの範囲で設定してください。

■RANGEパラメタ構造体アドレス

RANGEパラメタ構造体のアドレスを設定してください。

本パラメタを省略するときは、NULLを設定してください。

RANGEパラメタ構造体に次の情報を設定してください。開始時刻、終了時刻、取得日数のどれかを設定する必要があります。稼働情報の検索対象有無については、要求電文の受信時刻を基に決定します。

■開始時刻

検索対象とする開始時刻をYYYYMMDDHHMMSSの形式の文字列で設定してください。開始時刻以降の稼働情報が対象となります。

文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

開始時刻を省略するときは、先頭文字列にnull文字を設定してください。

開始時刻を省略したときは、19710101000000を開始時刻とします。

YYYY：年（西暦）（1971≦YYYY≦9999）

MM：月（01≦MM≦12）

DD：日（01≦DD≦31）

hh：時（00≦hh≦23）

mm：分（00≦mm≦59）

ss：秒（00≦ss≦61）

■終了時刻

検索対象とする終了時刻をYYYYMMDDHHMMSSの形式の文字列で設定してください。終了時刻以前の稼働情報が対象となります。

文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

終了時刻を省略するときは、先頭文字列にnull文字を設定してください。

終了時刻を省略したときは、現在時刻を終了時刻とします。

YYYY：年（西暦）（1971≦YYYY≦9999）

MM：月（01≦MM≦12）

DD：日（01≦DD≦31）

hh：時（00≦hh≦23）

mm：分（00≦mm≦59）

ss：秒（00≦ss≦61）

■取得日数

検索対象とする稼働情報を現在日から本設定日数以前までとするときの日数を0～65535（単位：日）までの範囲で設定してください。

0を設定したときは、現在日の稼働情報だけが検索対象となります。

開始時刻、または終了時刻が設定されている場合、本設定は無効となります。

■SELECTパラメタ構造体アドレス

SELECTパラメタ構造体の先頭アドレスを設定してください。

本パラメタを省略するときは、NULLを設定してください。

SELECTパラメタ構造体の各パラメタに設定した情報は、論理積の検索条件となります。

SELECTパラメタ構造体を複数設定した場合は、各SELECTパラメタ構造体に設定した内容が論理和の検索条件となります。

各SELECTパラメタ構造体の設定内容の整合性チェックは行いません。

SELECTパラメタ構造体に次の情報を設定してください。

■プロトコル種別

検索対象とするプロトコル種別を設定してください。

ESRTM_PROT_ALL：全プロトコル

ESRTM_PROT_TCP：TCPプロトコル

ESRTM_PROT_HTTP：HTTPプロトコル

ESRTM_PROT_IIOP：IIOPプロトコル

ESRTM_PROT_RPC：RPCプロトコル

■SYSNAMEパラメタ構造体アドレス

システム名を検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

SYSNAMEパラメタ構造体に次の情報を設定してください。

情報

設定する内容

システム名

システム名を1～31文字以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

■TELKEYパラメタ構造体アドレス

電文キーを検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

本パラメタを設定した場合、USERKEYパラメタ構造体の情報とLOCATIONパラメタ構造体の情報は無効となります。

TELKEYパラメタ構造体に次の情報を設定してください。

情報

設定する内容

電文キー

電文キーを64バイト以内で設定してください。電文キーは、システム分析支援リアルタイムモニタが出力したKFSE84215-Iメッセージ、またはダッシュボードの稼働情報詳細画面の情報から設定してください。

■USERKEYパラメタ構造体アドレス

ユーザー任意情報（検索キー）を検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

COUNT要求のときは、本設定は無効となります。

各電文について先頭から1バイトずつ検索キーと一致しているかどうかを確認するため、他パラメタの検索条件と比較すると時間が掛かります。

USERKEYパラメタ構造体に次の情報を設定してください。

情報

設定する内容

検索キー

検索条件とするユーザー任意情報（検索キー）を1～64バイトの範囲で設定してください。

検索対象種別

検索対象とする電文の種別を設定してください。

ESRTM_TYPE_REQUEST：要求電文

ESRTM_TYPE_RESPONSE：応答電文

検索キーサイズ

検索条件とするユーザー任意情報（検索キー）のサイズを1～64までの範囲で設定してください。

■LOCATIONパラメタ構造体アドレス

特定のロケーションのユーザー任意情報（検索キー）を検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

COUNT要求のときは、本設定は無効となります。

LOCATIONパラメタ構造体に次の情報を設定してください。

情報

設定する内容

検索キー

検索条件とするユーザー任意情報（検索キー）を1～64バイトの範囲で設定してください。

検索対象種別

検索対象とする電文の種別を設定します。

ESRTM_TYPE_REQUEST：要求電文

ESRTM_TYPE_RESPONSE：応答電文

検索キーサイズ

検索条件とするユーザー任意情報（検索キー）のサイズを1～64の範囲で設定してください。

ロケーション

電文（ユーザーデータ部）の先頭からのロケーションを0～1073741823の範囲で設定してください。

■ALERTパラメタ構造体アドレス

アラート検知有無を検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

ALERTパラメタ構造体に次の情報を設定してください。

情報

設定する内容

アラート種別

アラート検知対象の種別を設定してください。

ESRTM_ALERT_NONE：アラート検知なし

ESRTM_ALERT_ALL：アラート検知対象すべて

ESRTM_ALERT_PROTO：プロトコルレベルのエラー検知

ESRTM_ALERT_TIMEOUT：応答待ちタイムアウト検知（コネクション切断、およびパケットロストを含む）

ESRTM_ALERT_THRESHOLD：閾値超過

ESRTM_ALERT_USER：ユーザー指示（稼働情報編集UOC）

■RESPONSEパラメタ構造体アドレス

応答時間を検索条件とするときに設定してください。

本パラメタを省略するときは、NULLを設定してください。

RESPONSEパラメタ構造体に次の情報を設定してください。

情報

設定する内容

応答時間

検索対象とする応答時間をミリ秒単位で1～3600000の範囲で設定してください。

本設定時間以上、時間が掛かっている稼働情報が検索対象となります。

■SELECTパラメタ数

検索条件を設定したSELECTパラメタ構造体の数を1～64の範囲で設定してください。

UAPが設定するパラメタ項目：flags

ESNOFLAGSを設定してください。

システム検証支援基盤から値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESRTMER_ARGUMENT

引数に設定した値が間違っています。

ESRTMER_TIMING

この関数を発行できる状態ではありません。

ESRTMER_MEMORY_SHORT

メモリが不足しました。

ESRTMER_FILE

アダプタ識別子、または稼働情報ファイル格納ディレクトリが不正です。

ESRTMER_IOERR

稼働情報ファイルへのI/Oエラーが発生しました。

ESRTMER_SYSERR

システムエラーが発生しました。

注意事項

各パラメタ構造体の予備はnull文字クリアしてください。

SELECTパラメタ構造体を複数設定する場合、検索条件が重複しないようにしてください。重複していた場合、検索性能に影響します。

INIT要求の設定例

プロトコル種別とシステム名を検索条件とするときのINIT要求の設定例

プロトコル種別RPC、かつシステム名がSYSTEM1の稼働情報を取得対象とします。

ESRTM_INITPARAM init;
ESRTM_SELECT sel;
ESRTM_SYSNAME sysname;
 :
init.select_param_pt = &sel;
init.select_param_num = 1;
sel.sysname_pt = &sysname;
 :
sel.protocol=ESRTM_PROT_RPC;
strncpy(sysname.name,"SYSTEM1", sizeof(sysname.name));
 :
rc = es_rtm_init(&init, ESNOFLAGS);

複数の検索キーを検索条件とするときのINIT要求の設定例

プロトコル種別HTTP、かつ応答電文に「system=aaa」、または「system=bbb」を含んだ稼働情報を取得対象とします。

ESRTM_INITPARAM init;
ESRTM_SELECT sel[2];
ESRTM_USERKEY ukey[2];
 :
init.select_param_pt = &sel;
init.select_param_num = 2;
sel[0].userkey_pt = &ukey[0];
sel[1].userkey_pt = &ukey[1];
 :
sel[0].protocol=ESRTM_PROT_HTTP;
ukey[0].tel_type = ESRTM_TYPE_RESPONSE;
ukey[0].key_size = 10;
strncpy(ukey[0].key,"system=aaa", sizeof(ukey[0].key));
sel[1].protocol=ESRTM_PROT_HTTP;
ukey[1].tel_type = ESRTM_TYPE_RESPONSE;
ukey[1].key_size = 10;
strncpy(ukey[1].key,"system=bbb", sizeof(ukey[1].key));
 :
rc = es_rtm_init(&init, ESNOFLAGS);

10.4.2　es_rtm_get（GET要求）

形式：ANSI Cの形式

#include <esrtm.h>
int es_rtm_get(ESRTM_GETPARAM *getparam_pt, ESLONG flags)

typedef struct es_rtm_getparam_t{ /*GETパラメタ構造体 */
 ESULONG protocol; /*プロトコル種別 */
 char yobi1[12]; /*予備 */
 char system_name[32]; /*システム名 */
 ESRTM_TELEGRAM *ext_request; /*要求電文のTELEGRAMパラメタ構造体 */
 /*アドレス */
 ESRTM_TELEGRAM *ext_reply; /*応答電文のTELEGRAMパラメタ構造体 */
 /*アドレス */
 void *protoinf; /*プロトコル情報パラメタ構造体 */
 /*アドレス */
 ESULONG64 response_time; /*応答時間 */
 ESULONG alert_type; /*アラート種別 */
 ESLONG user_code; /*ユーザ情報コード */
 char analysis_key1[33];/*分析キー情報1 */
 char analysis_key2[33];/*分析キー情報2 */
 char yobi[102]; /*予備 */
} ESRTM_GETPARAM;

typedef struct es_rtm_telegram_t{ /*TELEGRAMパラメタ構造体 */
 ESULONG tv_sec; /*受信時刻(秒) */
 ESULONG tv_usec; /*受信時刻(マイクロ秒) */
 unsigned char src_ip[4]; /*送信元IPアドレス */
 unsigned char dst_ip[4]; /*送信先IPアドレス */
 unsigned short src_port; /*送信元ポート番号 */
 unsigned short dst_port; /*送信先ポート番号 */
 ESULONG indata_len; /*入力電文長 */
 ESULONG proto_len; /*プロトコルヘッダ部長 */
 ESULONG user_len; /*ユーザーデータ部長 */
 char *indata_area_pt; /*入力電文格納エリアアドレス */
 char yobi[24]; /*予備 */
} ESRTM_TELEGRAM;

RPCプロトコルのプロトコル情報パラメタ構造体

typedef struct es_plg_proto_rpc { /*プロトコル情報パラメタ構造体 */
 ESLONG protocol_type; /*プロトコル種別詳細 */
 ESLONG rpc_model; /*RPC形態 */
 char group[32]; /*サービスグループ名 */
 char service[32]; /*サービス名 */
 ESLONG rtncode; /*リターン値 */
 ESULONG root_number; /*製品情報 */
 ESULONG client_number; /*製品情報 */
 char root_nodeid[5]; /*製品情報 */
 char client_nodeid[5]; /*製品情報 */
 char server_nodeid[5]; /*製品情報 */
 char reserve[29]; /*予備 */
} ESPLG_PROTO_RPC;

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;

機能

検索条件に一致した稼働情報の読み込み要求（GET要求）を行います。

UAPが設定するパラメタ項目：getparam_pt

GETパラメタ構造体のアドレスを設定してください。

UAPが設定するパラメタ項目：flags

ESNOFLAGSを設定してください。

システム検証支援基盤から値が返されるパラメタ項目：getparam_pt

GETパラメタ構造体に次の情報を設定します。

■プロトコル種別

プロトコル種別を設定します。

ESRTM_PROT_TCP：TCPプロトコル

ESRTM_PROT_HTTP：HTTPプロトコル

ESRTM_PROT_IIOP：IIOPプロトコル

ESRTM_PROT_RPC：RPCプロトコル

■システム名

システム名を1～31文字以内で設定します。

■要求電文/応答電文のTELEGRAMパラメタ構造体アドレス

要求電文と応答電文のTELEGRAMパラメタ構造体のアドレスを設定します。

応答電文がない場合、応答電文のTELEGRAMパラメタ構造体のアドレスはNULLを設定します。

TELEGRAMパラメタ構造体に次の情報を設定します。

■受信時刻（秒）

要求電文/応答電文の受信時刻の秒部分を設定します。

■受信時刻（マイクロ秒）

要求電文/応答電文の受信時刻のマイクロ秒部分を設定します。

■送信元IPアドレス

要求電文/応答電文の送信元IPアドレスが次に示す形式で設定します。

例）172.165.112.20

■送信先IPアドレス

要求電文/応答電文の送信先IPアドレスが次に示す形式で設定します。

例）172.165.112.20

■送信元ポート番号

要求電文/応答電文の送信元ポート番号を設定します。

■送信先ポート番号

要求電文/応答電文の送信先ポート番号を設定します。

■入力電文長

要求電文/応答電文のサイズを設定します。

■プロトコルヘッダ部長

要求電文/応答電文のプロトコルヘッダ部のサイズを設定します。

■ユーザーデータ部長

要求電文/応答電文のユーザーデータ部のサイズを設定します。

■入力電文格納エリアアドレス

要求電文/応答電文を格納したエリアのアドレスを設定します。

■プロトコル情報パラメタ構造体アドレス

プロトコル情報パラメタ構造体のアドレスを設定します。プロトコル種別がESRTM_PROT_IIOP、またはESRTM_PROT_RPCの場合に設定します。

■RPCプロトコルのプロトコル情報パラメタ構造体

「9.4.4　稼働情報編集UOC」のes_plg_proto_rpcの設定内容を参照してください。

■IIOPプロトコルのプロトコル情報パラメタ構造体

「9.4.4　稼働情報編集UOC」のes_plg_proto_iiopの設定内容を参照してください。

■応答時間

応答時間をマイクロ秒単位で設定します。

■アラート種別

アラート検知対象の種別を論理和で設定します。

ESRTM_ALERT_NONE：アラート検知なし

ESRTM_ALERT_PROTO：プロトコルレベルのエラー検知

ESRTM_ALERT_TIMEOUT：応答待ちタイムアウト検知（コネクション切断、およびパケットロストを含む）

ESRTM_ALERT_THRESHOLD：閾値超過

ESRTM_ALERT_USER：ユーザー指示（稼働情報編集UOC）

■ユーザ情報コード

稼働情報編集UOCで設定したユーザ情報コードを設定します。

■分析キー情報1

稼働情報編集UOCで設定した分析キー情報1を設定します。

■分析キー情報2

稼働情報編集UOCで設定した分析キー情報2を設定します。

リターン値

リターン値

意味

ES_OK

正常に終了しました。

ESRTMER_ARGUMENT

引数に設定した値が間違っています。

ESRTMER_TIMING

この関数を発行できる状態ではありません。

ESRTMER_NO_DATA

取得できる稼働情報がありません。

TERM要求を行ってください。

ESRTMER_FILE

稼働情報ファイルが壊れています。

TERM要求を行ってください。

ESRTMER_IOERR

稼働情報ファイルへのI/Oエラーが発生しました。

TERM要求を行ってください。

ESRTMER_SYSERR

システムエラーが発生しました。

ESRTMER_UNRESOLVABLE

継続不可のエラーが発生しました。

注意事項

各パラメタ構造体の予備はnull文字クリアしてください。

以下の領域については、次回の要求後には参照できませんので、必要に応じて退避してください。

要求電文/応答電文のTELEGRAMパラメタ構造体

プロトコル情報パラメタ構造体

10.4.3　es_rtm_count（COUNT要求）

形式：ANSI Cの形式

#include <esrtm.h>
int es_rtm_count(ESRTM_COUNTPARAM *countparam_pt, ESLONG flags)
typedef struct es_rtm_countparam_t{ /*COUNTパラメタ構造体 */
 ESULONG64 count; /*稼働情報数 */
 char yobi[248]; /*予備 */
} ESRTM_COUNTPARAM;

機能

検索条件に一致した稼働情報の件数の取得（COUNT要求）を行います。

UAPが設定するパラメタ項目：countparam_pt

COUNTパラメタ構造体のアドレスを設定してください。

UAPが設定するパラメタ項目：flags

ESNOFLAGSを設定してください。

システム検証支援基盤から値が返されるパラメタ項目：countparam_pt

COUNTパラメタ構造体に次の情報を設定します。

■稼働情報数

検索条件に一致した稼働情報数を設定します。

リターン値

リターン値

意味

EE_OK

正常に終了しました。

ESRTMER_ARGUMENT

引数に設定した値が間違っています。

ESRTMER_TIMING

この関数を発行できる状態ではありません。

ESRTMER_FILE

稼働情報ファイルが壊れています。

TERM要求を行ってください。

ESRTMER_IOERR

稼働情報ファイルへのI/Oエラーが発生しました。

TERM要求を行ってください。

ESRTMER_SYSERR

システムエラーが発生しました。

ESRTMER_UNRESOLVABLE

継続不可のエラーが発生しました。

注意事項

各パラメタ構造体の予備はnull文字クリアしてください。

10.4.4　es_rtm_term（TERM要求）

形式：ANSI Cの形式

#include <esrtm.h>
int es_rtm_term(ESRTM_TERMPARAM *termparam_pt, ESLONG flags)
typedef struct es_rtm_termparam_t{ /*TERMパラメタ構造体 */
 char yobi[256]; /*予備 */
} ESRTM_TERMPARAM;

機能

稼働情報抽出ユティリティの終了要求（TERM要求）を行います。

INIT要求後、終了するときは必ずTERM要求を行ってください。

UAPが設定するパラメタ項目：termparam_pt

TERMパラメタ構造体のアドレスを設定してください。

UAPが設定するパラメタ項目：flags

ESNOFLAGSを設定してください。

システム検証支援基盤から値が返されるパラメタ項目

ありません。

リターン値

リターン値

意味

EE_OK

正常に終了しました。

ESRTMER_ARGUMENT

引数に設定した値が間違っています。

ESRTMER_TIMING

この関数を発行できる状態ではありません。

ESRTMER_SYSERR

システムエラーが発生しました。

ESRTMER_UNRESOLVABLE

継続不可のエラーが発生しました。

注意事項

各パラメタ構造体の予備はnull文字クリアしてください。

11　メッセージ

システム分析支援リアルタイムモニタのメッセージについて説明します。

11.1　メッセージログの形式

メッセージログの形式、およびメッセージログの注意事項について説明します。

11.1.1　メッセージログのタイトル行およびラベル行形式

システム分析支援リアルタイムモニタの起動によってメッセージログファイルにタイトル行およびラベル行を出力します。出力するメッセージログファイルのタイトル行およびラベル行の形式を次に記します。

タイトル行の形式

0     5                    83        116
****△OS名(バージョン含む)△TZ=AA…AA△yyyy/mm/dd△hh:mm:ss.sss

OS名

OS名（半角数字記号60バイト以内。超える場合は切り詰めて出力）

TZ=AA…AA

タイムゾーン（半角数字記号32バイト以内）

yyyy/mm/dd

トレース開始年月日（半角数字記号10バイト）

hh:mm:ss.sss

トレース開始時分秒ミリ秒（半角数字記号12バイト）

△

スペース（半角1バイト以上）

ラベル行の形式

0 5          16            50   59   68          90
△yyyy/mm/dd△hh:mm:ss.sss△pid△tid△message-id△message(LANG=AA))

yyyy/mm/dd

トレース開始年月日ラベル（半角数字記号10バイト）

hh:mm:ss.sss

トレース開始時分秒ミリ秒ラベル（半角数字記号12バイト）

pid

プロセスIDラベル（半角数字記号3バイト）

tid

スレッドIDラベル（半角数字記号3バイト）

message-id

メッセージIDラベル（半角数字記号10バイト）

message

メッセージラベル（半角数字記号7バイト）

(LANG=AA……AA)

メッセージ出力言語コード（バイト上限なし）

Java仮想マシンのデフォルトロケールの言語コード

メッセージテキストの言語コードではありません

△

スペース（半角1バイト以上）

11.1.2　メッセージログのレコード行形式

メッセージログを出力する際にレコード行を出力します。

出力するメッセージログのレコード行形式を次に記します。

0 5 16 33 50 59 68 90
AAAA△yyyy/mm/dd△hh:mm:ss.sss△BB……BB△CCCCCCCC△DDDDDDDD△KFSEN₁N₂N₃N₄N₅-X△YY△ZZ……ZZ

付加情報

AAAA

メッセージ通番（半角数字記号4バイト）

Javaプロセス起動ごとに0初期化される

yyyy/mm/dd

年月日（半角数字記号10バイト）

hh:mm:ss.sss

時分秒ミリ秒（半角数字記号12バイト）

BB……BB

アプリケーション名（ADP）とJavaプロセスのバージョン番号、リビジョン番号、および限定コード

CCCCCCCC

プロセス識別子（半角英数字記号16進数8バイト）※

DDDDDDDD

スレッド識別子（半角英数字記号16進数8バイト）※

メッセージ固定部

KFSEN₁N₂N₃N₄N₅-X

メッセージID（半角英数字記号11バイト）

YY

メッセージ種別

EC：例外発生

ER：エラーメッセージ

設定なし：ECとER以外

ZZ……ZZ

メッセージテキスト

その他

△

スペース（半角1バイト以上）

メッセージログの出力先が標準出力、または標準エラー出力の場合、メッセージIDとメッセージテキストだけ出力されます。

注※

OSが管理しているプロセスIDやスレッドIDとは異なった値が出力されます。

11.1.3　メッセージログの記述形式

メッセージログの記述形式を記します。

KFSEN₁N₂N₃N₄N₅-X (Y)

メッセージテキスト

メッセージの説明、要因コードなど個別出力項目の説明。

（S）

システムの動作

（O）

オペレータの処置

［対策］

管理者の処置

各項目についての記述の説明を次に記します。

KFSE

メッセージプリフィックス

N₁N₂N₃N₄N₅

コード

X

インジケータ

メッセージの種別です。インジケータはJava監査ログへのメッセージログ出力のレベルとしても使用します。インジケータの表記種別を次に記します。

表11‒1　メッセージインジケータ

表記

内容

E

システム分析支援リアルタイムモニタの稼働に支障があることを示すメッセージ。

システム分析支援リアルタイムモニタの障害発生。

W

システム分析支援リアルタイムモニタは継続稼働するが、注意が必要なことを示すメッセージ。

システム分析支援リアルタイムモニタの環境設定誤りのうち、システム分析支援リアルタイムモニタが継続稼働可能なケースの警告。

メモリの使用状況などの警告。

I

システム分析支援リアルタイムモニタの情報を示すメッセージ。

各機能の起動／終了

統計情報の出力

Q

ユーザーからの応答を待っているメッセージ。

Y

メッセージログの出力先

メッセージログの出力先です。複数の出力先に出力する場合は、出力されることがある出力先を複数記載します。出力先の表記種別を次に記します。

表11‒2　メッセージ出力先

表記

出力先

E

標準エラー出力

S

標準出力

P

メッセージログファイル

X

メッセージボックス

11.1.4　メッセージログの注意事項

メッセージログには、メッセージプリフィックスが「KFSE」以外のメッセージも出力されます。

メッセージプリフィックスが「KFSE」以外で、インジケータがEのメッセージが出力された場合は、保守員に連絡してください。

インジケータがE以外は無視してください。

11.2　KFSE44200からKFSE44299までのメッセージ

KFSE44202-W　(Y) E+P

定義数の上限値を超える指定がされています。定義名＝aa…aa

The maximum number of definitions has been exceeded. definition name = aa…aa

システム分析支援リアルタイムモニタ定義ファイルの設定値に定義可能数の上限を超過しているものがあります。

aa…aa：定義名

定義可能数の上限を超過している定義名

(S)

設定値のうち、定義可能数を超える値を無視して、処理を続行します。

(O)

なし。

[対策]

出力された定義に設定している値を見直してください。

KFSE44211-W　(Y) P

終了処理でエラーが発生しました。詳細コード1＝aa…aa、詳細コード2＝bb…bb、詳細コード3＝cc…cc、詳細コード4＝dd…dd

An error occurred in the end processing. 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)

なし。

[対策]

なし。

KFSE44212-W　(Y) P

ソケット入力処理でエラーが発生しました。プロトコル＝aa…aa、理由コード＝bb…bb、詳細コード＝cc…cc

An error occurred in the socket input processing. protocol = aa…aa, reason code = bb…bb, detail code = cc…cc

システム分析支援リアルタイムモニタのソケット入力処理でエラーが発生しました。

aa…aa：プロトコル

複数のプロトコルを監視している場合、プロトコルを:で区切ってすべて表示します。

HTTP ：HTTPプロトコル

TCP ：TCPプロトコル

IIOP ：IIOPプロトコル

RPC ：RPCプロトコル

HIRDB：HiRDBプロトコル

bb…bb：理由コード

理由コード

意味

SELECTOR_CLOSE

内部矛盾が発生しました。

cc…cc：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

処理を続行します。

(O)

なし。

[対策]

なし。

KFSE44213-W　(Y) P

システム分析支援アダプタとの接続が切断されました。

Connection of the HSIC Real-Time Monitor(adapter) has disconnected.

システム分析支援リアルタイムモニタとシステム分析支援アダプタ間の接続が切断されました。

(S)

システム分析支援アダプタを再起動して処理を続行します。

(O)

システム管理者に連絡してください。

[対策]

システム分析支援アダプタの状態を確認し、アダプタが未起動の場合や本メッセージが頻繁に出力される場合は保守員に連絡してください。

KFSE44251-W　(Y) P

JP1/IM連携用イベントの発行に失敗しました。詳細コード＝aa…aa

Failed to issue an event to link with JP1/IM. detail code = aa…aa

JP1/IM連携用イベントの発行に失敗しました。JP1/IM連携機能は継続します。

このメッセージは、イベント発行の失敗が継続している間は一回だけ出力されます。

イベント発行が一度以上成功した場合でも、再度イベント発行が失敗するたびに、このメッセージが出力されます。

aa…aa：詳細コード

システム分析支援がトラブルシュートで使用する情報です。

(S)

処理を続行します。

(O)

システム管理者に連絡してください。

[対策]

JP1/Baseの状態を確認し、未起動の場合は起動してください。起動している場合は保守員に連絡してください。

11.3　KFSE54200からKFSE54299までのメッセージ

KFSE54212-E　(Y) P

入力したパケットのヘッダ情報が不正です。プロトコル＝aa…aa、理由コード＝bb…bb、電文内容＝cc…cc、送信元IPアドレス＝dd…dd、送信元ポート＝ee…ee、詳細コード＝ff…ff

The header information entered for the packet is invalid. protocol = aa…aa, reason code = bb…bb, telegraph message = cc…cc, source IP address = dd…dd, source port = ee…ee, detail code = ff…ff

システム分析支援リアルタイムモニタに入力されたパケットのヘッダ情報が不正です。

aa…aa：プロトコル

複数のプロトコルを監視している場合、プロトコルを:で区切ってすべて表示します。

HTTP ：HTTPプロトコル

TCP ：TCPプロトコル

IIOP ：IIOPプロトコル

RPC ：RPCプロトコル

HIRDB：HiRDBプロトコル

bb…bb：理由コード

理由コードの意味と対策を表に示します。

cc…cc：電文内容

不正となった電文の内容

dd…dd：送信元IPアドレス

パケットの送信元IPアドレス

ee…ee：送信元ポート

パケットの送信元IPポート番号

ff…ff：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

コネクションを切断して電文解析処理を中断します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

VERSION

ヘッダ情報不正

システム分析支援アダプタのバージョンを確認した後に、システム分析支援アダプタを再起動してください。

PROTOCOL

ヘッダ情報不正

システム分析支援アダプタで使用するポート番号の指定を修正した後に、システム分析支援アダプタを再起動してください。

ADAPTER_ID

アダプタ識別子不正

システム分析支援アダプタで使用するアダプタ識別子の指定を修正した後に、システム分析支援アダプタを再起動してください。

KFSE54251-E　(Y) P

JP1/IM連携時に障害が発生しました。

A failure occurred when linking with JP1/IM.

JP1/IM連携機能を停止します。

(S)

JP1/IM連携機能を停止し、処理を続行します。

(O)

システム管理者に連絡してください。

[対策]

保守員に連絡してください。

KFSE54252-E　(Y) P

メール通知機能でエラーが発生しました。 理由コード＝ aa…aa

An error occurred in mail notification function. reason code = aa…aa

メール通知機能でエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を表に示します。

(S)

処理を続行します。

(O)

システム分析支援管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

MAIL_SENDING

メール送信エラー

定義、およびメールサーバの設定が正しいかどうか確認してください。

SMTP_AUTH

SMTP認証エラー

SMTP認証の定義、およびメールサーバの設定が正しいかどうか確認してください。

KFSE54253-E　(Y) P

メール通知機能を閉塞しました。

The mail notification function stoped.

メール通知機能を閉塞しました。

(S)

メール通知機能を停止します。

(O)

システム分析支援管理者に連絡してください。

[対策]

事前に出力されたKFSE54252-Eメッセージの対策をしてください。

KFSE54293-E　(Y) X

An error occurred during data processing.

Detail =

FUNC:aa…aa

CODE:bb…bb

An error occurred during data processing.

Detail =

FUNC:aa…aa

CODE:bb…bb

データ処理中にエラーが発生しました。

aa…aa：詳細情報1

システム分析支援がトラブルシュートで使用する情報です。

bb…bb：詳細情報2

システム分析支援がトラブルシュートで使用する情報です。

(S)

関連付け情報画面の表示、またはCSVダウンロード処理を中断します。

(O)

CSVダウンロードの際に表示された場合は、保存先のファイルが書き込める状態になっているか次の対策内容を確認してください。

状態

対策

保存先のファイルが既に存在していて、上書き保存に失敗する場合

保存先のファイルを開いている場合は閉じてください。

保存先に指定したディレクトリへのアクセス権限がない場合

実行中のユーザーに対して保存先に指定したディレクトリへのアクセス権限を付与してください。

解決しない場合は、システム分析支援の管理者に連絡してください。

[対策]

保守員に連絡してください。

KFSE54294-E　(Y) X

An error occurred while acquiring the CSV data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

An error occurred while acquiring the CSV data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

関連付け情報のCSVデータ取得時にエラーが発生しました。

aa…aa：エラー要因

エラー要因

エラー要因の意味

dataCSVFault

関連付け情報のCSVデータ取得の際、通信に失敗しました。

bb…bb：詳細情報1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細情報2

システム分析支援がトラブルシュートで使用する情報です。

(S)

CSVダウンロード処理を中断します。

(O)

システム分析支援の管理者に連絡してください。

[対策]

システム分析支援リアルタイムモニタが起動しているかどうか確認してください。起動中の場合は設定を確認して再起動してください。

解決しない場合は保守員に連絡してください。

KFSE54295-W　(Y) X

The data of the appointed condition do not exist.

Key = aa…aa

Start Time = bb…bb

End Time = cc…cc

The data of the appointed condition do not exist.

Key = aa…aa

Start Time = bb…bb

End Time = cc…cc

指定された条件のデータが存在しませんでした。

aa…aa：電文キーまたはPRFキー

表示する情報を表に示します。

表示対象トランザクション

表示する情報

アラート検知トランザクション

電文キー

処理完了トランザクション

電文キー

検索範囲指定トランザクション

“*”

bb…bb：開始時間

表示する情報を表に示します。

表示対象トランザクション

表示する情報

アラート検知トランザクション

トランザクション開始時刻

処理完了トランザクション

トランザクション開始時刻

検索範囲指定トランザクション

指定した開始日時

cc…cc：終了時間

表示する情報を表に示します。

表示対象トランザクション

表示する情報

アラート検知トランザクション

トランザクション終了時刻

処理完了トランザクション

トランザクション終了時刻

検索範囲指定トランザクション

指定した終了日時

(S)

処理を続行します。

(O)

関連付け情報表示対象トランザクションか確認してください。表示対象トランザクションの場合はブラウザの「最新の情報に更新」を実行して再表示してください。

解決しない場合はシステム分析支援管理者に連絡してください。

[対策]

システム分析支援リアルタイムモニタが起動しているか確認してください。起動中の場合は設定を確認して再起動してください。

解決しない場合は保守員に連絡してください。

KFSE54296-E　(Y) X

An error occurred while acquiring the basic data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

An error occurred while acquiring the basic data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

画面用基本情報取得時にエラーが発生しました。

aa…aa：エラー要因

エラー要因

エラー要因の意味

dataBasicFault

画面用基本情報取得の際、通信に失敗しました。

dataBasicResult

取得した画面用基本情報の解析に失敗しました。

bb…bb：詳細情報1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細情報2

システム分析支援がトラブルシュートで使用する情報です。

(S)

処理を続行します。

(O)

ブラウザの「最新の情報に更新」を実行して再表示してください。解決しない場合はシステム分析支援の管理者に連絡してください。

[対策]

システム分析支援リアルタイムモニタが起動しているか確認してください。起動中の場合は設定を確認して再起動してください。

解決しない場合は保守員に連絡してください。

KFSE54297-E　(Y) X

An error occurred while acquiring the related data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

An error occurred while acquiring the related data.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

関連付け情報表示で利用するデータの取得時にエラーが発生しました。

aa…aa：エラー要因

エラー要因

エラー要因の意味

dataRelatedFault

関連付け情報取得の際、通信に失敗しました。

dataRelatedResult

取得した関連付け情報の解析に失敗しました。

bb…bb：詳細情報1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細情報2

システム分析支援がトラブルシュートで使用する情報です。

(S)

関連付け情報表示処理を中断します。

(O)

関連付け情報表示ボタンを再度押下してください。解決しない場合はシステム分析支援の管理者に連絡してください。

[対策]

エラー要因一覧に従って対策してください。

エラー要因

対策

dataRelatedFault

システム分析支援リアルタイムモニタが起動しているかどうか確認してください。起動中の場合は設定を確認して再起動してください。

dataRelatedResult

保守員に連絡してください。

KFSE54298-E　(Y) X

An error occurred while acquiring the data for the dashboard.

Component = aa…aa

Detail =

CODE:bb…bb

STATUS:cc…cc

ダッシュボードで表示するデータの取得時にエラーが発生しました。

aa…aa：エラー要因

エラー要因

エラー要因の意味

dataAlertTRNFault

アラート検知情報の取得の際、通信に失敗しました。

dataCompletedTRNFault

稼働情報の取得の際、通信に失敗しました。

dataOldTRNFault

過去の稼働情報の取得の際、通信に失敗しました。

dataTPSFault

TPS情報の取得の際、通信に失敗しました。

dataTPSResult

取得したTPS情報が異常です。TPS情報がないか、前回の取得時からグラフ表示情報が更新されないことがあります。

bb…bb：詳細情報1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細情報2

システム分析支援がトラブルシュートで使用する情報です。

(S)

リアルタイム更新をOFFにします。

(O)

ブラウザの「最新の情報に更新」を実行して再表示してください。解決しない場合はシステム管理者に連絡してください。

[対策]

システム分析支援リアルタイムモニタが起動しているかどうかを確認してください。起動中の場合は設定を確認して再起動してください。

11.4　KFSE64200からKFSE64299までのメッセージ

KFSE64201-E　(Y) E

定義解析処理中にエラーが発生しました。ファイル名＝aa…aa, 理由コード＝bb…bb

An error occurred during definition analysis processing. file name = aaaa, reason code = bb…bb

システム分析支援リアルタイムモニタ定義ファイルでエラーが発生しました。

aa…aa：ファイル名

システム分析支援リアルタイムモニタ定義ファイル

bb…bb：理由コード

理由コードの意味と対策を表に示します。

(S)

システム分析支援リアルタイムモニタの起動を中止します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

NONE

定義ファイルが存在していません。

定義ファイルが存在しているかどうかを確認してください。

IO_ERROR

定義ファイルのアクセス時にエラーが発生しました。

定義ファイルの読み込み中にエラーが発生した場合

定義ファイルのクローズ時に入出力エラーが発生した場合

定義ファイルに対するアクセス権限が不正した場合

定義ファイルに対する権限が正しいかどうかを確認してください。

それ以外の場合は、保守員に連絡してください。

PATH

内部矛盾

保守員に連絡してください。

KFSE64202-E　(Y) E

定義ファイルの指定値に誤りがあります。定義名＝aa…aa、 理由コード＝bb…bb

An invalid value is specified in the definition file. definition name = aa…aa, reason code = bb…bb

システム分析支援リアルタイムモニタ定義ファイルの設定値に誤りがあります。

aa…aa：定義名

設定値に誤りがある定義名

bb…bb：理由コード

理由コードの意味と対策を表に示します。

(S)

システム分析支援リアルタイムモニタの起動を中止します。

(O)

なし。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

NONE

必須定義が指定されていません。

出力された定義名の値を指定してください。

FORMAT

定義形式または定義の設定値が不正です。

出力された定義名の値を見直してください。

VALUE

定義の設定値が不正です。

不正な値を指定した場合

数値指定の定義に数値以外の値を定義した場合

数値が指定範囲外の場合

定義[jp1_hostname]の指定値でエンコーディングがサポートされていない文字を指定した場合

出力された定義名の値を修正してください。

KFSE64203-E　(Y) E

定義に誤りがあります。理由コード＝aa…aa

The combination of definition is invalid. reason code = aa…aa

システム分析支援リアルタイムモニタ定義ファイルに指定した定義に誤りがあります。

aa…aa：理由コード

理由コードの意味と対策を表に示します。

(S)

システム分析支援リアルタイムモニタの起動を中止します。

(O)

なし。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

0001

web_server、tcp_server、iiop_server、hirdb_server、またはrpc_serverのどれも指定されていません。

web_server、tcp_server、iiop_server、hirdb_server、またはrpc_serverのどれかを指定してください。

0002

library_file_nameが定義されているにも関わらず、エントリポインタ名が指定されていません。

どれかのエントリポインタ名を指定してください。またはlibrary_file_nameを削除してください。

0003

応答時間の到着待ち時間（reply_watchtime）以上の閾値が設定されています。

reply_watchtime、web_threshold_watchtime、tcp_threshold_watchtime、iiop_threshold_watchtime、rpc_threshold_watchtime、hirdb_reply_watchtimeを見直してください。

0004

rpc_linkがYにも関わらず、rpc_serverまたはrpc_prfが指定されていません。

rpc_serverまたはrpc_prfを指定してください。

0005

mail_useがYにも関わらず、web_server、tcp_server、iiop_server、hirdb_server、またはrpc_serverのどれも指定されていません。

web_server、tcp_server、iiop_server、hirdb_server、またはrpc_serverのどれかを指定してください。

0006

PRFトレースファイル取得待ち時間にPRFトレースファイル監視間隔より大きな値が指定されていません。

rpc_prf_file_watchtimeおよびrpc_prfを見直してください。

0007

all_fileszの設定値がfileszの設定値の2倍以上となっていません。

all_filesz、fileszを見直してください。

KFSE64211-E　(Y) P

開始処理でエラーが発生しました。理由コード＝aa…aa、詳細コード1＝bb…bb、詳細コード2＝cc…cc、詳細コード3＝dd…dd

An error occurred in the start processing. reason code = 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)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

REQUEST_PROCESS

開始処理でエラーが発生しました。

事前に出力されたエラーメッセージの対策をしてください。

OUT_OF_MEMORY

必要なメモリの確保に失敗しました。

OS全体のメモリ使用状況を確認してください。

RUNTIME

内部矛盾が発生しました。

保守員に連絡してください。

LOCKFILE_ERR

システム分析支援リアルタイムモニタ用ロックファイルの排他取得に失敗しました。

保守員に連絡してください。

KFSE64212-E　(Y) P

監視処理でエラーが発生しました。理由コード＝aa…aa、詳細コード1＝bb…bb、詳細コード2＝cc…cc、詳細コード3＝dd…dd

An error occurred in the monitoring processing. reason code = 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)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

THREAD_DOWN

スレッドが停止しました。

事前に出力されたエラーメッセージがあるときはその対策をしてください。

OUT_OF_MEMORY

必要なメモリの確保に失敗しました。

OS全体のメモリ使用状況、およびJava VMオプションファイルSDP_MAX_MEM_SIZEの設定値を確認してください。

RUNTIME

内部矛盾が発生しました。

保守員に連絡してください。

KFSE64213-E　(Y) P

ソケット入力処理でエラーが発生しました。プロトコル＝aa…aa、理由コード＝bb…bb、詳細コード＝cc…cc

An error occurred in the socket input processing. protocol = aa…aa, reason code = bb…bb, detail code = cc…cc

システム分析支援リアルタイムモニタのソケット入力処理でエラーが発生しました。

aa…aa：プロトコル

複数のプロトコルを監視している場合、プロトコルを:で区切ってすべて表示します。

HTTP ：HTTPプロトコル

TCP ：TCPプロトコル

IIOP ：IIOPプロトコル

RPC ：RPCプロトコル

HIRDB：HiRDBプロトコル

bb…bb：理由コード

理由コードの意味と対策を表に示します。

cc…cc：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

システム分析支援リアルタイムモニタを強制停止します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

SOCKET_BIND

プロトコルで示す電文用ポート(プロトコル関連定義my_port_noの指定値)のバインドに失敗しました。

他プログラムで当該ポートを使用していないか確認してください。使用している場合はmy_port_noの指定値を変更してから再起動してください。使用していない場合は、保守員に連絡してください。

OUTPUT_QUEUE

内部矛盾が発生しました。

保守員に連絡してください。

SELECTOR_OPEN

SOCKET_READ

CHANNEL_ACCEPT

BUFFER_READ

TIME_WAIT

CHANNEL_CLOSE

KFSE64214-E　(Y) P

システム分析支援リアルタイムモニタが強制終了しました。理由コード＝aa…aa、詳細コード＝bb…bb

The HSIC Real-Time Monitor was forcibly terminated. reason code = aa…aa, detail code = bb…bb

システム分析支援リアルタイムモニタが強制終了しました。

aa…aa：理由コード

理由コードの意味と対策を表に示します。

bb…bb：詳細コード

システム分析支援がトラブルシュートで使用する情報です。

(S)

システム分析支援リアルタイムモニタを強制停止します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

SDP_FORCESTOP

ストリームデータ処理エンジンから強制終了要求がありました。

保守員に連絡してください。

THREAD_DOWN

スレッドが停止しました。

事前に出力されたエラーメッセージの対策をしてください。

OUT_OF_MEMORY

必要なメモリの確保に失敗しました。

OS全体のメモリ使用状況、およびJava VMオプションファイルSDP_MAX_MEM_SIZEの設定値を確認してください。

RUNTIME

内部矛盾が発生しました。

保守員に連絡してください。

KFSE64221-E　(Y) P

電文解析制御でエラーが発生しました。プロトコル＝aa…aa、理由コード＝bb…bb、詳細コード＝cc…cc

An error occurred in telegraph analysis control. protocol = aa…aa, reason code = bb…bb, detail code = cc…cc

システム分析支援リアルタイムモニタの電文解析制御でエラーが発生しました。

aa…aa：プロトコル

HTTP ：HTTPプロトコル

TCP ：TCPプロトコル

IIOP ：IIOPプロトコル

RPC ：RPCプロトコル

HIRDB：HiRDBプロトコル

bb…bb：理由コード

理由コードの意味と対策を表に示します。

cc…cc：詳細コード

システム分析支援がトラブルシュートで使用する情報です。

(S)

システム分析支援リアルタイムモニタを強制停止します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

TUPLE_SEND

ストリームデータ処理エンジンへの登録に失敗しました。

事前に出力されたKFSE64252-Eメッセージの対策をしてください。

JUDGMENT_PERSEINT

内部矛盾が発生しました。

保守員に連絡してください。

KFSE64251-E　(Y) E

ストリームオープン中にエラーが発生しました。理由コード＝aa…aa, 詳細コード＝bb…bb

An error occurred during the stream open operation. reason code = aa…aa, detail code = bb…bb

ストリームの初期化処理中にエラーが発生しました。

aa…aa：理由コード

理由コードの意味を表に示します。

bb…bb：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

システム分析支援リアルタイムモニタを強制停止します。

(O)

システム管理者に連絡してください。

[対策]

保守員に連絡してください。

理由コードの意味を次に示します。

理由コード

意味

ARGUMENT

内部矛盾　

NOT_OPEN_STREAM

指定したクエリグループまたはストリームが見つからない。

指定したストリームが入力ストリームではない。

同じSDPConnector を使用して、すでに同一入力ストリームへ接続をしている。

ストリームが閉じている。

KFSE64252-E　(Y) E

タプル送信中にエラーが発生しました。理由コード＝aa…aa, 詳細コード＝bb…bb

An error occurred when transmitting the tuple. reason code = aa…aa, detail code = bb…bb

ストリーム処理エンジンへのタプル登録中にエラーが発生しました。

aa…aa：理由コード

理由コードの意味を表に示します。

bb…bb：詳細情報

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

システム分析支援リアルタイムモニタを強制停止します。

(O)

システム管理者に連絡してください。

[対策]

保守員に連絡してください。

理由コードの意味を次に示します。

理由コード

意味

NOT_FOUND_STREAM

内部矛盾

ARGUMENT

内部矛盾　

INTERNAL

クエリグループが実行中でない。

タプルのカラム型がストリームと異なる。

ストリームが閉じている。

ストリームのキュー溢れが発生した。

11.5　KFSE84200からKFSE84299までのメッセージ

KFSE84211-I　(Y)P

システム分析支援リアルタイムモニタが開始しました。

The HSIC Real-Time Monitor started.

システム分析支援リアルタイムモニタが開始しました。

(S)

処理を続行します。

(O)

なし。

[対策]

なし。

KFSE84212-I　(Y)P

システム分析支援リアルタイムモニタが終了しました。

The HSIC Real-Time Monitor ended.

システム分析支援リアルタイムモニタが終了しました。

(S)

なし。

(O)

なし。

[対策]

なし。

KFSE84213-I　(Y)P

システム分析支援アダプタからの入力が開始しました。

Input from the HSIC Real-Time Monitor(adapter) started.

システム分析支援アダプタからの入力が開始しました。

(S)

処理を続行します。

(O)

なし。

[対策]

なし。

KFSE84214-I　(Y)P

統計情報を出力します。統計情報＝aa…aa

Statistics will be output. statistics = aa…aa

システム分析支援リアルタイムモニタの統計情報を出力します。

aa…aa：統計情報を下記形式で出力します。

bb…bb,cc…cc,dd…dd,ee…ee

bb…bb：稼働情報数

cc…cc：ストリーム処理エンジンへの稼働情報登録数

dd…dd：システム情報

ee…ee：システム情報

(S)

処理を続行します。

(O)

なし。

[対策]

なし。

KFSE84215-I　(Y) P

アラートを検知しました。システム名＝aa…aa、電文キー＝bb…bb、要因＝cc…cc、開始日時＝dd…dd、詳細コード＝ee…ee

An alert was detected. system name = aa…aa, message key = bb…bb, factor = cc…cc, start date and time = dd…dd, detail code = ee…ee

システム分析支援リアルタイムモニタでアラートを検知しました。

aa…aa：システム名

bb…bb：電文キー

cc…cc：要因

THRESHOLD ：閾値超過

TIMEOUT ：タイムアウト

PROTOCOL ：プロトコルレベルエラー

USER ：UOC画面出力指示

dd…dd：当該リクエストのトランザクション開始時刻

ee…ee：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

処理を続行します。

(O)

なし。

[対策]

なし。

KFSE84298-W　(Y) X

The condition of the search is invalid.

Reason code = aa…aa

The condition of the search is invalid.

Reason code = aa…aa

検索条件が不正です。

aa…aa：理由コード

理由コード

意味

対策

TIME_RANGE

関連付け情報検索画面の場合、検索範囲が設定されていません。

比較情報画面の場合、比較元開始日時と比較先開始日時に同じ日時が設定されています。

関連付け情報検索画面の場合、検索範囲を1ミリ秒以上に設定してください。

比較情報画面の場合、比較元開始日時と比較先開始日時に異なる日時を設定してください。

(S)

関連付け情報検索処理を中断します。

(O)

理由コード一覧に従って対策してください。

[対策]

なし。

11.6　KFSE94200からKFSE94299までのメッセージ

KFSE94200-E　(Y) E

The command execution environment is invalid. command name = aa…aa, detail code = bb…bb

コマンド実行環境が不正です。

aa…aa：コマンド名

bb…bb：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

コマンドの処理を中止します。

(O)

コマンドの実行環境を確認してください。

[対策]

なし。

KFSE94201-E　(Y) E

クエリ定義ファイル生成に失敗しました。理由コード＝aa…aa

Generation of a query definition file failed. reason code = aa…aa

クエリ定義ファイルの生成に失敗しました。

aa…aa：理由コード

理由コードの意味と対策を表に示します。

(S)

コマンドの処理を中止します。

(O)

システム管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

INSTALL

内部矛盾

保守員に連絡してください。

OPERATION

WRITE

クエリ定義ファイルへの書き込みに失敗しました。

CREATE

クエリ定義ファイルの生成に失敗しました。

SEARCH

内部矛盾

KFSE94211-E　(Y) E

Failed to start the HSIC Real-Time Monitor. reason code = aa…aa, detail code = bb…bb

システム分析支援リアルタイムモニタの起動に失敗しました。

aa…aa：理由コード

SDP_SERVER ：サーバの起動に失敗

WEB_SERVER ：WEBサーバの起動に失敗

bb…bb：詳細コード

システム分析支援リアルタイムモニタがトラブルシュートで使用する情報です。

(S)

コマンドの処理を中止します。

(O)

システム管理者に連絡してください。

[対策]

システムコンフィグプロパティファイルのrmi.serverPortプロパティの値が、ほかの実行環境の値と重複していないかどうかを確認してください。

標準エラー出力、またはメッセージログにエラーメッセージが出力されているときは、そのメッセージに従って障害を取り除き、再度コマンドを実行してください。

KFSE94212-I　(Y)S

Usage: esrtmstart

esrtmstartコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94213-I　(Y)S

The HSIC Real-Time Monitor started. adapter ID = aa…aa

システム分析支援リアルタイムモニタ、システム分析支援アダプタを起動しました。

aa…aa：アダプタ識別子

システム分析支援リアルタイムモニタのシステム定義adapter_idに指定した値を出力します。

値を取得できない場合、"*"を出力します。

(S)

なし。

(O)

なし。

[対策]

なし。

KFSE94214-E　(Y)E

Failed to start the HSIC Real-Time Monitor. reason code = aa…aa, detail code1 = bb…bb, detail code2 = cc…cc

システム分析支援リアルタイムモニタ、システム分析支援アダプタの起動に失敗しました。

aa…aa：理由コード

理由コード

意味

対策

USER

実行ユーザーが不正です。

スーパーユーザーでコマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

ENVIRONMENT

実行環境が不正です。

confディレクトリ内に定義ファイルがあるかどうかを確認してください。確認後、コマンドを再実行してください。

ADAPTER

システム分析支援アダプタの起動に失敗しました。

本メッセージの前にエラーメッセージが出力されていた場合は、そのメッセージ対策を実施してコマンドを再実行してください。

ほかのエラーメッセージが出力されていない場合は、システム分析支援アダプタのログを参照してエラーメッセージが出力されていないかどうかを確認してください。エラーメッセージが出力されていた場合は、そのメッセージの対策を実施してコマンドを再実行してください。

問題が解決しない場合は、保守員に連絡してください。

RTM

システム分析支援リアルタイムモニタの起動に失敗しました。

本メッセージの前にエラーメッセージが出力されていた場合は、そのメッセージ対策を実施してコマンドを再実行してください。

ほかのエラーメッセージが出力されていない場合は、システム分析支援リアルタイムモニタのログを参照してエラーメッセージが出力されていないかどうかを確認してください。エラーメッセージが出力されていた場合は、そのメッセージの対策を実施してコマンドを再実行してください。

問題が解決しない場合は、保守員に連絡してください。

INSIDE

内部矛盾が発生しました。

保守員に連絡してください。

bb…bb：詳細コード1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細コード2

システム分析支援がトラブルシュートで使用する情報です。

(S)

システム分析支援の開始を中断します。

(O)

システム管理者に連絡してください。

[対策]

理由コードの対策欄を参照して対策を実施してください。

KFSE94215-I　(Y)S

Usage: esrtmstop [-f [-d]]

esrtmstopコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94216-I　(Y)S

The HSIC Real-Time Monitor stopped. adapter ID = aa…aa

システム分析支援リアルタイムモニタ、システム分析支援アダプタを停止しました。

aa…aa：アダプタ識別子

システム分析支援リアルタイムモニタのシステム定義adapter_idに指定した値を出力します。

値を取得できない場合、"*"を出力します。

(S)

なし。

(O)

なし。

[対策]

なし。

KFSE94217-E　(Y)E

Failed to stop the HSIC Real-Time Monitor. reason code = aa…aa, detail code1 = bb…bb, detail code2 = cc…cc

システム分析支援リアルタイムモニタ、システム分析支援アダプタの停止に失敗しました。

aa…aa：理由コード

理由コード

意味

対策

USER

実行ユーザーが不正です。

スーパーユーザーでコマンドを再実行してください。何度もエラーが発生する場合は、保守員に連絡してください。

ADAPTER

システム分析支援アダプタの停止に失敗しました。

本メッセージの前にエラーメッセージが出力されていた場合は、そのメッセージ対策を実施してコマンドを再実行してください。

ほかのエラーメッセージが出力されていない場合は、システム分析支援アダプタのログを参照してエラーメッセージが出力されていないか確認してください。エラーメッセージが出力されていた場合は、そのメッセージの対策を実施してコマンドを再実行してください。

問題が解決しない場合は、保守員に連絡してください。

RTM

システム分析支援リアルタイムモニタの停止に失敗しました。

本メッセージの前にエラーメッセージが出力されていた場合は、そのメッセージ対策を実施してコマンドを再実行してください。

ほかのエラーメッセージが出力されていない場合は、システム分析支援リアルタイムモニタのログを参照してエラーメッセージが出力されていないかどうかを確認してください。エラーメッセージが出力されていた場合は、そのメッセージの対策を実施してコマンドを再実行してください。

問題が解決しない場合は、保守員に連絡してください。

INSIDE

内部矛盾が発生しました。

保守員に連絡してください。

bb…bb：詳細コード1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細コード2

システム分析支援がトラブルシュートで使用する情報です。

(S)

システム分析支援の停止を続行します。

(O)

システム管理者に連絡してください。

[対策]

理由コードの対策欄を参照して対策を実施してください。

KFSE94241-I　(Y)S

Usage: esrtmls [-s { all | rtm | adp }]

esrtmlsコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94242-I　(Y)S

Usage: esrtmtrced -f <control-statement-file-name>

esrtmtrcedコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合、形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94243-Q　(Y)S

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（YまたはNを含む）で応答します。

y：ファイルを上書きしてコマンド処理を続行します。

n：ファイルを上書きしないでコマンド処理を終了します。

[対策]

なし。

KFSE94244-E　(Y)E

Control-statement-file access error occurred. file name = aa…aa, reason code = bb…bb

コマンド実行中に制御文ファイルアクセスでエラーが発生したため、処理を中止しました。

aa…aa：エラーが発生したファイル名

bb…bb：理由コード

理由コードの意味と対策を表に示します。

(S)

コマンド処理を中止します。

(O)

システム効率化支援管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

NONE

制御文ファイルが存在していません。

制御文ファイルが存在しているかを確認してください。

IO_ERROR

制御文ファイルのアクセス時にエラーが発生しました。

制御文ファイルに対する権限が正しいかどうかを確認してください。

KFSE94245-E　(Y)E

An invalid value is specified in the control-statement-file. property name = aa…aa, reason code = bb…bb

制御文ファイルの設定値に誤りがあります。

aa…aa：プロパティ名

設定値に誤りがあるプロパティ名です。

bb…bb：理由コード

理由コードの意味と対策を表に示します。

(S)

コマンド処理を中止します。

(O)

システム効率化支援管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

NONE

必須プロパティが指定されていません。

出力されたプロパティ名の値を指定してください。

FORMAT

形式またはプロパティの設定値が不正です。

出力されたプロパティ名の値を見直してください。

VALUE

プロパティの設定値が不正です。

不正な値を指定した場合

数値指定の定義に数値以外の値を定義した場合

数値が指定範囲外の場合

OVER

指定できる最大数を超えています。

KFSE94246-E　(Y)E

The operation status edit output command failed. reason code = aa…aa, file name = bb…bb, detail code = cc…cc

esrtmtrcedコマンド実行時にエラーが発生しました。

aa…aa：理由コード

理由コードの意味と対策を表に示します。

bb…bb：ファイル名

次に示す理由コードの場合は、稼働情報ファイル格納ディレクトリ名を表示します。

NO DATA

次に示す理由コードの場合は、結果出力ファイルのファイル名を表示します。

CSV

上記以外の理由コードについては、*を表示します。

cc…cc：詳細コード

システム効率化支援がトラブルシュートで使用する情報です。

(S)

コマンド処理を中止します。

(O)

システム効率化支援管理者に連絡してください。

[対策]

理由コード一覧に従って対策してください。

理由コード

意味

対策

NO DATA

編集対象となる稼働情報がありません。

制御文ファイルの内容を確認してください。

INIT

稼働情報ファイルのアクセス時にエラーが発生しました。

保守員に連絡してください。

EXTRACT

稼働情報の抽出中にエラーが発生しました。

CSV

結果出力ファイル（CSV）のアクセス時にエラーが発生しました。

ファイルの権限が正しいかどうかを確認してください。

UNRESOLVABLE

内部矛盾が発生しました。

保守員に連絡してください。

KFSE94251-I　(Y)S

Usage: esrtmsetup [-d <setup-directory>] [-w <web-container-name>] [-o <rtm-dashboard-port>] [-c <webserver-connector-ajp13-port>] [-e <webserver-shutdown-port>] [-i <rtm-dashboard-info-max>] [-a <rtm-dashboard-alert-info-max>]

esrtmsetupコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94252-E　(Y)E

Failed to set up the execution environment. reason code = aa…aa, detail code1 = bb…bb, detail code2 = cc…cc

実行環境の作成、または更新に失敗しました。

aa…aa：理由コード

理由コード

意味

対策

USER

実行ユーザーが不正です。

スーパーユーザーでコマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

ENVIRONMENT

インストールディレクトリの環境が不正です。

保守員に連絡してください。

HSIC_DIRECTORY

構築済みの実行環境が不正です。

再セットアップを行い、環境を再作成してください。

RUNNING

システム分析支援リアルタイムモニタが起動中です。

システム分析支援リアルタイムモニタを終了後にコマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

INSIDE

内部矛盾が発生しました。

保守員に連絡してください。

OPERAND

実行環境の更新セットアップでは指定できないオプションフラグを指定しています。

指定するオプションフラグを見直してください。

OVER

実行環境の作成可能数を超過しています。

他実行環境を削除後にコマンドを再度実行してください。

bb…bb：詳細コード1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細コード2

システム分析支援がトラブルシュートで使用する情報です。

(S)

セットアップを中断します。

(O)

システム管理者に連絡してください。

[対策]

理由コードの対策欄を参照して対策を実施してください。

KFSE94254-I　(Y)S

The execution environment was set up. setup directory = aa…aa

システム分析支援リアルタイムモニタ実行環境の作成、または更新を終了します。

aa…aa：運用ディレクトリパス

(S)

なし。

(O)

なし。

[対策]

なし。

KFSE94255-Q　(Y)S

The execution environment will be set up. Do you want to continue? [y: Continue n: Cancel] setup mode = aa…aa, setup directory = bb…bb

-dオプションに指定したディレクトリに実行環境を構築してよいかどうか応答を求めます。

aa…aa：セットアップ方式

new : 実行環境の新規作成

update : 実行環境の更新

bb…bb：運用ディレクトリパス

(S)

オペレータが設定した応答に従って処理します。yまたはn以外を応答した場合は、再度応答を求めます。

(O)

yまたはn（YまたはNを含む）で応答します。

y：コマンドの処理を続行します。

n：コマンドの処理を終了します。

[対策]

なし。

KFSE94256-E　(Y)E

Failed to perform the unsetup of the execution environment. reason code = aa…aa, detail code1 = bb…bb, detail code2 = cc…cc

実行環境の削除に失敗しました。

aa…aa：理由コード

理由コード

意味

対策

USER

実行ユーザーが不正です。

スーパーユーザーでコマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

ENVIRONMENT

インストールディレクトリの環境が不正です。

保守員に連絡してください。

RUNNING

システム分析支援リアルタイムモニタが起動中です。

システム分析支援リアルタイムモニタを終了後にコマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

INSIDE

内部矛盾が発生しました。

保守員に連絡してください。

HSIC_DIRECTORY

実行環境が未構築のディレクトリを指定しています。

指定した運用ディレクトリに実行環境が構築済みかどうかを確認してください。確認後、コマンドを再実行してください。問題が解決しない場合は、保守員に連絡してください。

bb…bb：詳細コード1

システム分析支援がトラブルシュートで使用する情報です。

cc…cc：詳細コード2

システム分析支援がトラブルシュートで使用する情報です。

(S)

アンセットアップを中断します。

(O)

システム管理者に連絡してください。

[対策]

理由コードの対策欄を参照して対策を実施してください。

KFSE94257-I　(Y)S

Usage: esrtmunsetup [-d <setup-directory>]

esrtmunsetupコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94258-I　(Y)S

The unsetup of the execution environment was performed. setup directory = aa…aa

システム分析支援リアルタイムモニタ実行環境の削除を終了します。

aa…aa：運用ディレクトリパス

(S)

なし。

(O)

なし。

[対策]

なし。

KFSE94259-Q　(Y)S

Do you want to delete the execution environment? [y: Continue n: Cancel] operation directory = aa…aa

-dオプションに指定した実行環境を削除してよいかどうか応答を求めます。

aa…aa：運用ディレクトリパス

(S)

オペレータが設定した応答に従って処理します。yまたはn以外を応答した場合は、再度応答を求めます。

(O)

yまたはn（YまたはNを含む）で応答します。

y：コマンドの処理を続行します。

n：コマンドの処理を終了します。

[対策]

なし。

KFSE94261-I　(Y)S

Usage: esrtmrasget <acquisition-destination-file-name>

esrtmrasgetコマンドの使用方法を示します。コマンドヘルプを要求した場合、もしくはコマンドの形式が誤っている場合に出力します。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの形式に誤りがある場合は形式を正しく設定して再実行してください。

[対策]

なし。

KFSE94262-E　(Y)E

An error occurred for the command. command name = aa…aa, reason code = bb…bb

コマンド実行時エラーが発生しました。

aa…aa：コマンド名

bb…bb：コマンドで発生したエラーを示します。

TEMPORARY DIRECTORY：一時作業領域に十分な空き領域がありません。

OS COMMAND FAILED：オペレーティングシステムのコマンド処理に失敗しました。出力されているオペレーティングシステムのコマンドのメッセージに従って対処してください。

(S)

コマンド処理を終了します。

(O)

エラーの要因を取り除いたあと、コマンドを再度入力してください。

[対策]

なし。

KFSE94290-E　(Y)E

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)

正しい引数を設定してコマンドを再実行してください。

[対策]

なし。

KFSE94291-E　(Y)E

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：フラグ引数の設定値とコマンド引数の設定数の組み合わせが不正です。

DUPLICATE(xx)：オプションbbとオプションxxのフラグ引数が同じです。

(S)

コマンド処理を行わずに終了します。

(O)

正しいフラグ引数を設定してコマンドを再実行してください。

[対策]

なし。

KFSE94292-E　(Y)E

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)

正しいオプションを設定してコマンドを再実行してください。

[対策]

なし。

KFSE94293-E　(Y)E

No commands can be accepted now.

コマンドを受け付けることができません。

(S)

コマンド処理を行わずに終了します。

(O)

コマンドの受け付け条件を確認してください。

[対策]

なし。

KFSE94294-E　(Y)E

An error occurred for the command. command name = aa…aa, reason code = bb…bb, detail code = cc…cc

コマンド実行時エラーが発生しました。

aa…aa：コマンド名

bb…bb：理由コード

コマンド名

理由コード

対策

esrtmls

ADAPTER

時間を置いてコマンドを再実行してください。解決しない場合は保守員に連絡してください。

上記以外

上記以外

保守員に連絡してください。

cc…cc：詳細コード

システム分析支援がトラブルシュートで使用する情報です。

(S)

コマンド処理を中断します。

(O)

システム管理者に連絡してください。

[対策]

理由コードの対策欄を参照して対策を実施してください。

付録

付録A　アンインストール

システム分析支援リアルタイムモニタのアンインストールについて説明します。

アンインストールの流れ

システム分析支援リアルタイムモニタのアンインストールの流れを次に示します。

なお、これらの作業は、Administrators権限でログインして実行してください。

システム分析支援リアルタイムモニタの実行環境の削除

システム分析支援リアルタイムモニタのアンインストール

システム分析支援リアルタイムモニタのアンインストール

システム分析支援リアルタイムモニタをアンインストールする手順を次に示します。

Administrators権限でログインします。

システム分析支援リアルタイムモニタが起動している場合、esrtmstopコマンドを実行して、システム分析支援リアルタイムモニタを終了します。

esrtmunsetupコマンドを実行します。

システム分析支援リアルタイムモニタの実行環境が削除されます。

Windowsの［コントロールパネル］－［プログラムのアンインストール］を選択します。

一覧からアンインストールの対象となる「Hitachi System Information Capture - Real-Time Monitor」を選択して、［アンインストール］をクリックします。

指示に従いアンインストールを進めます。

再起動を要求された場合は再起動します。

システム分析支援リアルタイムモニタが削除しないファイルについては、必要に応じて削除してください。

アンインストールを実行中に［キャンセル］をクリックした場合、システム分析支援リアルタイムモニタが正常に動作しなくなるおそれがあります。また、アンインストールが正常に完了していません。再度、アンインストールを実行してください。

付録B　バージョンアップ

システム分析支援リアルタイムモニタのバージョンアップについて説明します。

システム分析支援リアルタイムモニタをバージョンアップする場合、次のどちらかの方法でバージョンアップします。

再インストール

上書きインストール

なお、これらの作業は、Administrators権限でログインして実行してください。

バージョンアップの流れ

再インストールの場合

システム分析支援リアルタイムモニタのアンインストール

アンインストールの詳細については、「付録A　アンインストール」を参照してください。

システム分析支援リアルタイムモニタのインストール

インストールの詳細については、「3.4　システム分析支援リアルタイムモニタのインストール」を参照してください。

運用ディレクトリ内に、システム分析支援リアルタイムモニタの実行環境を作成

実行環境の作成の詳細については、「3.5　実行環境の作成」を参照してください。

上書きインストールの場合

システム分析支援リアルタイムモニタの停止の確認

システム分析支援リアルタイムモニタが起動している場合、esrtmstopコマンドを実行して、システム分析支援リアルタイムモニタを終了します。

システム分析支援リアルタイムモニタのインストール

インストールの詳細については、「3.4　システム分析支援リアルタイムモニタのインストール」を参照してください。

運用ディレクトリ内の、システム分析支援リアルタイムモニタの実行環境の更新

実行環境の更新の詳細については、「3.5　実行環境の作成」を参照してください。

付録C　ディレクトリ構成

システム分析支援リアルタイムモニタ、およびシステム分析支援アダプタのディレクトリ構成について説明します。

付録C.1　システム分析支援リアルタイムモニタのディレクトリ構成

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

システム分析支援リアルタイムモニタのインストール時に作成されるファイルおよびディレクトリの構成を次に示します。

表C‒1　インストールディレクトリの構成

ファイル名またはディレクトリ名

説明

インストールディレクトリ（%HSICRealTimeMonitor_ROOT%）

システム分析支援リアルタイムモニタ環境ホームディレクトリ

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

システム分析支援リアルタイムモニタ実行ベースディレクトリ

インストールディレクトリ¥job¥HSICRTM00¥

システム分析支援リアルタイムモニタデフォルト運用ディレクトリ

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

運用コマンド格納ディレクトリ

インストールディレクトリ¥bin¥esrtmsetup.bat

実行環境のセットアップコマンド

インストールディレクトリ¥bin¥esrtmunsetup.bat

実行環境のアンセットアップコマンド

インストールディレクトリ¥bin¥esrtmrasget.bat

保守資料の取得コマンド

インストールディレクトリ¥bin¥esrtmstart.bat

システム分析支援の開始コマンド

インストールディレクトリ¥bin¥esrtmstop.bat

システム分析支援の停止コマンド

インストールディレクトリ¥bin¥esrtmls.bat

プロセスの状態表示コマンド

インストールディレクトリ¥bin¥esrtmtrced.bat

稼働情報ファイル編集コマンド

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

ライブラリ格納ディレクトリ

インストールディレクトリ¥lib¥hsicrtm.jar

システム分析支援リアルタイムモニタ用ライブラリ

インストールディレクトリ¥lib¥hsicrtm2.jar

システム分析支援リアルタイムモニタ用ライブラリ

インストールディレクトリ¥lib¥HSICRealTimeMonitor.war

システム分析支援リアルタイムモニタ用Webアプリケーション

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

システム分析支援リアルタイムモニタのシステムでの使用ファイル格納ディレクトリ

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

サンプルファイル配置用ディレクトリ

インストールディレクトリ¥examples¥hsic_rtm¥

システム分析支援リアルタイムモニタ提供のサンプルファイル配置用ディレクトリ

インストールディレクトリ¥examples¥hsic_rtm¥hitachi_hsic_rtm_attr_ja.conf

JP1/IM連携用イベント拡張属性定義ファイル(日本語)

インストールディレクトリ¥examples¥hsic_rtm¥hitachi_hsic_rtm_attr_en.conf

JP1/IM連携用イベント拡張属性定義ファイル(英語)

インストールディレクトリ¥examples¥hsic_rtm¥usrconf.cfg

Webコンテナサーバ用オプション定義ファイル

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

ツール格納ディレクトリ

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

Readme格納ディレクトリ

インストールディレクトリ¥readme¥hsic_rtm¥

システム分析支援リアルタイムモニタ用Readme格納ディレクトリ

インストールディレクトリ¥readme¥hsic_rtm¥readme.txt

システム分析支援リアルタイムモニタ用Readmeファイル

OSインストールドライブ:¥Program Files¥Hitachi¥HNTRLib2¥

日立トレース共通ライブラリ格納ディレクトリ※

注※

同ディレクトリに日立トレース共通ライブラリをインストール済みの場合、ディレクトリ内のファイルを上書きされることがあるため注意してください。

運用ディレクトリ

セットアップ時に作成されるファイルおよびディレクトリの構成を次に示します。

表C‒2　運用ディレクトリの構成

ファイル名またはディレクトリ名

（esrtmsetup -d 指定値）

説明

アンセットアップ対象

上書きセットアップ対象

運用ディレクトリ

システム分析支援リアルタイムモニタ運用ディレクトリ

－

－

運用ディレクトリ¥sys¥

システム分析支援リアルタイムモニタ内部情報格納ディレクトリ

○

－

運用ディレクトリ¥bin¥

運用コマンド格納ディレクトリ

○

○

運用ディレクトリ¥bin¥esrtmstart.bat

システム分析支援の開始コマンド

○

○

運用ディレクトリ¥bin¥esrtmstop.bat

システム分析支援の停止コマンド

○

○

運用ディレクトリ¥bin¥esrtmrasget.bat

保守資料の取得コマンド

○

○

運用ディレクトリ¥bin¥esrtmls.bat

プロセスの状態表示コマンド

○

○

運用ディレクトリ¥bin¥esrtmtrced.bat

稼働情報ファイル編集コマンド

○

○

運用ディレクトリ¥conf¥

定義格納ディレクトリ

○

○

運用ディレクトリ¥conf¥hsicrtm_config.properties

システム分析支援リアルタイムモニタ定義ファイル

×

△

運用ディレクトリ¥conf¥jvm_options.cfg

Java VMオプションファイル

×

△

運用ディレクトリ¥conf¥system_config.properties

システムコンフィグプロパティファイル

×

△

運用ディレクトリ¥conf¥xml¥

XML用定義格納ディレクトリ

○

○

運用ディレクトリ¥logs¥

ログファイル格納ディレクトリ

○

○

運用ディレクトリ¥trc¥

トレースファイル格納ディレクトリ

○

○

運用ディレクトリ¥spool¥

スプールディレクトリ

○

○

運用ディレクトリ¥spool¥cmd¥

コマンド実行結果格納ディレクトリ

○

○

運用ディレクトリ¥tmp¥

作業用ディレクトリ

○

×

運用ディレクトリ¥save¥

稼働情報格納ディレクトリ

×

×

運用ディレクトリ¥Webコンテナ名¥

Webコンテナサーバ情報格納ディレクトリ

○

×

（凡例）

アンセットアップ対象欄

○：アンセットアップ時に削除する

×：アンセットアップ時に削除しない

－：対象外

上書きセットアップ対象欄

○：アップデート時に上書きする

×：アップデート時に上書きしない

△：バックアップを作成後、上書きする

－：対象外

付録C.2　システム分析支援アダプタのディレクトリ構成

システム分析支援アダプタが起動されると、次のディレクトリおよびファイルが作成されます。

表C‒3　システム分析支援アダプタのディレクトリ構成

ファイル名またはディレクトリ名

説明

システム分析支援アダプタのインストールディレクトリ（%HSIC_ROOT%）

システム分析支援アダプタのホームディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥

システム分析支援アダプタのベースディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥

システムテスト支援実行環境※

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥run¥

実行ディレクトリ。システムテスト支援が異常終了した場合はこのディレクトリ下にcoreファイルが作成される。ユーザーは必要に応じて削除すること。

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥conf¥

定義ファイル退避ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥conf¥deffile

定義ファイル

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥conf¥deffile_save

定義ファイル（最後に正常終了した時のファイル）

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥

スプールディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥アダプタ識別子_env

実行時環境変数退避ファイル

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥

トラブルシュート情報格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥log¥

ログファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥log¥アダプタ識別子logxxx

ログファイル（xxxは通番）

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥tasktm¥

TASKTMファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥tasktm¥アダプタ識別子tasktmxxx

TASKTMファイル（xxxは通番）

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥mdl¥

モジュールトレースファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥mdl¥アダプタ識別子mdlxxx

モジュールトレースファイル（xxxは通番）

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥stc¥

統計情報ファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥stc¥アダプタ識別子stcxxx

統計情報ファイル（xxxは通番）

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥spool¥dceeinf¥cmp¥

比較エラー情報ファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥afile¥

蓄積ファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥pcapfile¥

pcap形式ファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥rtm¥

稼働情報蓄積機能管理ファイル格納ディレクトリ

システム分析支援アダプタのインストールディレクトリ¥job¥アダプタ識別子¥tmp¥

テンポラリディレクトリ

注※

アダプタ連携関連定義のadapter_idプロパティで指定したアダプタ識別子でディレクトリが作成されます。

付録D　ダウンロード可能なCSV ファイルの一覧

ダッシュボードからダウンロード、またはesrtmtrcedコマンドで出力するCSVファイルの一覧を示します。ダッシュボードからダウンロードするときの出力形式は自動決定されます。

CSVファイル一覧

名前

出力形式

機能

関連付け情報ファイル（ダッシュボード）

2

RPCパケット情報、およびサーバ間連携機能使用時に取得したPRFトレース情報とHiRDBパケット情報（オペレーション単位）を出力する。

3

サーバ間連携機能未使用時に取得したHiRDBパケット情報（オペレーション単位）を出力する。

結果出力ファイル（esrtmtrcedコマンド）

1

各プロトコルのパケット情報を出力する。

対象プロトコルはすべてである。

2

RPCパケット情報、およびサーバ間連携機能使用時に取得したPRFトレース情報とHiRDBパケット情報（オペレーション単位）を出力する。

3

HiRDBパケット情報をオペレーション単位で出力する。

対象プロトコルはHiRDBだけである。

4

HiRDBパケット情報をSQL文単位で出力する。

対象プロトコルはHiRDBだけである。

付録D.1　出力形式1

ファイルの出力形式

CSVファイルの出力形式1および出力内容を説明します。

図D‒1　CSVファイルの出力形式1

出力内容

データ行の内容については、「4.5.3　アラート検知画面」と「4.5.6　稼働情報詳細画面」もあわせて参照してください。

タイトル行の内容

データ行の内容

TEL Key

電文キー

Request time

トランザクション開始時刻

Reply time

トランザクション終了時刻

Response time

レスポンスタイム

Client IP address

クライアントIPアドレス ※1

Client port

クライアントポート番号 ※1

Server IP address

サーバIPアドレス ※1

Server port

サーバポート番号 ※1

Alert type

アラート種別

複数の種別が重複しているときは、ユーザ指示を優先します。

NONE ：アラート検知なし

PROTO ：プロトコルレベルエラー検知

TIMEOUT ：応答電文待ちタイムアウト検知

コネクション切断やパケットロストによって、応答電文を受信できない場合も含みます。

THRESHOLD ：閾値超過

USER ：ユーザ指示あり（稼働情報編集UOC）

Protocol type

プロトコル種別

TCP ：TCPプロトコル

HTTP ：HTTPプロトコル

IIOP ：IIOPプロトコル

RPC ：RPCプロトコル

RPC-PRF：RPCプロトコル（PRFトレース情報）

HiRDB ：HiRDBプロトコル

System name

システム名 ※2

User inf code

ユーザ情報コード

User inf

ユーザ情報文字列

Protocol 1

プロトコル情報1 ※2

Protocol 2

プロトコル情報2

Protocol 3

プロトコル情報3

注※1：プロトコル種別がRPC-PRFの場合、値を出力しません。

注※2：プロトコル種別がRPC-PRFの場合、サービスグループ名を出力します。

付録D.2　出力形式2

ファイルの出力形式

CSVファイルの出力形式2および出力内容を説明します。

図D‒2　CSVファイルの出力形式2

出力内容

タイトル行とデータ行の出力内容を次の表で示します。

タイトル行の内容

データ行の内容

PRF Key

PRFキー(電文キー)

Type

データ種別

RPC ：RPCパケット情報

PRF ：PRFトレース情報

HiRDB：HiRDBパケット情報

RPC Server OpenTP1 ID

RPCパケット情報のサーバOpenTP1識別子

RPC Client OpenTP1 ID

RPCパケット情報のクライアントOpenTP1識別子

RPC Client Communication number

RPCパケット情報のクライアント通信番号

RPC Request time

RPCパケット情報のトランザクション開始時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

RPC Reply time

RPCパケット情報のトランザクション終了時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

RPC Response time

RPCパケット情報のレスポンスタイム(μ秒単位)

RPC Information type

RPCパケット情報の稼働情報種別

内容は、「表4‒3　アラート検知画面に表示される項目」の稼働情報種別を参照。

RPC Client IP address

RPCパケット情報のクライアントIPアドレス

RPC Client port

RPCパケット情報のクライアントポート番号

RPC Server IP address

RPCパケット情報のサーバIPアドレス

RPC Server port

RPCパケット情報のサーバポート番号

RPC System name

RPCパケット情報のシステム名

RPC Uoc code

RPCパケット情報の稼働情報編集UOCで指定されたユーザ情報コード

RPC User information

RPCパケット情報のユーザ情報文字列

RPC Service group name

RPCパケット情報のサービスグループ名

RPC Service name

RPCパケット情報のサービス名

RPC Return code

RPCパケット情報のRPCリターンコード

RPC RPC type

RPCパケット情報のRPC形態

内容は、「表4‒9　RPCパケット情報詳細表示エリアの表示項目」のRPC形態を参照。

PRF Server OpenTP1 ID

PRFトレース情報のサーバOpenTP1識別子

PRF Client OpenTP1 ID

PRFトレース情報のクライアントOpenTP1識別子

PRF Client Communication number

PRFトレース情報のクライアント通信番号

PRF Request time

PRFトレース情報のサービス関数開始時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

PRF Reply time

PRFトレース情報のサービス関数終了時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

PRF Response time

PRFトレース情報のレスポンスタイム(μ秒単位)

PRF Service group name

PRFトレース情報のサービスグループ名

PRF Service name

PRFトレース情報のサービス名

PRF Return code

PRFトレース情報のリターンコード

PRF RPC type

PRFトレース情報のRPC形態

内容は、「表4‒10　PRFトレース情報詳細表示エリアの表示項目」のRPC形態を参照。

PRF Status

PRFトレース情報の情報取得ステータス

PRF Transaction branch start time

PRFトレース情報のトランザクションブランチ開始時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

PRF Transaction branch end time

PRFトレース情報のトランザクションブランチ終了時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

PRF Queue detention time

PRFトレース情報のキュー滞留時間（μ秒単位）

PRF RPC API time

RPC実行時間合計（μ秒単位）

PRF Lock wait time

排他待ち時間合計（μ秒単位）

PRF Lock time

排他占有時間合計（μ秒単位）

PRF Request receive time

要求受信時間（μ秒単位）

PRF Response receive time

応答受信時間（μ秒単位）

PRF Name search time

ネーム検索時間（μ秒単位）

PRF Name search count

ネーム検索回数

PRF RPC count

同期応答型RPC発行回数

PRF RPC success count

同期応答型RPC成功回数

PRF RPC nowait count

非同期応答型RPC発行回数

PRF RPC nowait success count

非同期応答型RPC成功回数

PRF RPC nowait delete count

非同期応答型RPC破棄回数

PRF RPC noreply count

非応答型RPC発行回数

PRF RPC noreply success count

非応答型RPC成功回数

PRF Lock count

排他回数

PRF Lock success count

排他成功回数

PRF Syncpoint count

同期点取得回数

HiRDB Server OpenTP1 ID

HiRDBパケット情報のサーバOpenTP1識別子

HiRDB Client OpenTP1 ID

HiRDBパケット情報のクライアントOpenTP1識別子

HiRDB Client Communication number

HiRDBパケット情報のクライアント通信番号

HiRDB Request time

HiRDBパケット情報のSQL要求時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

HiRDB Reply time

HiRDBパケット情報のSQL応答時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

HiRDB Response time

HiRDBパケット情報のレスポンスタイム(μ秒単位)

HiRDB SQL statement

HiRDBパケット情報のSQL文

最大で1023バイトまで出力

HiRDB IP address

HiRDBパケット情報の接続先IPアドレス

HiRDB Port

HiRDBパケット情報の接続先ポート番号

HiRDB Section number

HiRDBパケット情報のセクション番号

HiRDB Operation code

HiRDBパケット情報のオペレーションコード

HiRDB SQL code

HiRDBパケット情報のSQLコード

HiRDB Fetch line number

HiRDBパケット情報のFETCH文での検索行数

HiRDB SQL error message

HiRDBパケット情報のSQLエラーメッセージ

最大で127バイトまで出力

HiRDB SQLWARN6

HiRDBパケット情報のロールバックフラグ

HiRDB UAP statistics information existence

HiRDBパケット情報のUAP統計情報有無

Y：項番48～125にデータを出力

N：項番48～125に""を出力

HiRDB SVNAME

HiRDBパケット情報の接続先サーバ名

HiRDB CNCTNO

HiRDBパケット情報の接続先コネクト通番

HiRDB SVPID

HiRDBパケット情報の接続先プロセスID

HiRDB WAITT

HiRDBパケット情報の排他待ち時間

hh:mm:ss.SSSSSS形式

HiRDB CTIME

HiRDBパケット情報のCPU時間(ミリ秒)

HiRDB ROREQ

HiRDBパケット情報のストアドプロシジャオブジェクト取得要求回数

HiRDB ROHITS

HiRDBパケット情報のストアドプロシジャオブジェクトバッファヒット回数

HiRDB SOREQ

HiRDBパケット情報のSQLオブジェクト取得要求回数

HiRDB SOHITS

HiRDBパケット情報のSQLオブジェクトバッファヒット回数

HiRDB SOCRT

HiRDBパケット情報のSQLオブジェクト作成回数

HiRDB SOMAX

HiRDBパケット情報の作成したSQLオブジェクトサイズ最大値

HiRDB FROW

HiRDBパケット情報のFETCH-SELECT文での検索行数

HiRDB DROW

HiRDBパケット情報のDELETE文での削除行数

HiRDB IROW

HiRDBパケット情報のINSERT文での挿入行数

HiRDB UROW

HiRDBパケット情報のUPDATE文での更新行数

HiRDB SET

HiRDBパケット情報の前処理実行回数

HiRDB OPEN

HiRDBパケット情報のOPEN文実行回数

HiRDB FETC

HiRDBパケット情報のFETC文実行回数

HiRDB CLOS

HiRDBパケット情報のCLOSE文実行回数

HiRDB SEL

HiRDBパケット情報のSELECT文実行回数

HiRDB INS

HiRDBパケット情報のINSERT文実行回数

HiRDB UPD

HiRDBパケット情報のUPDATE文実行回数

HiRDB DEL

HiRDBパケット情報のDELETE文実行回数

HiRDB LOCK

HiRDBパケット情報のLOCK文実行回数

HiRDB CALL

HiRDBパケット情報のCALL文実行回数

HiRDB MAXIO

HiRDBパケット情報のディスク入出力時間の最大値

hh:mm:ss.SSSSSS形式

HiRDB MINIO

HiRDBパケット情報のディスク入出力時間の最小値

hh:mm:ss.SSSSSS形式

HiRDB IOTIM

HiRDBパケット情報のディスク入出力時間の累計

hh:mm:ss.SSSSSS形式

HiRDB DIDRC

HiRDBパケット情報のDBページ参照回数

HiRDB DIDUC

HiRDBパケット情報のDBページ更新回数

HiRDB DIDHC

HiRDBパケット情報のDBページバッファヒット回数

HiRDB DIDRD

HiRDBパケット情報のDBページディスク入力回数

HiRDB DIDWT

HiRDBパケット情報のDBページディスク出力回数

HiRDB LBRFC

HiRDBパケット情報のLOBページ参照回数

HiRDB LBUPC

HiRDBパケット情報のLOBページ更新回数

HiRDB LBRHC

HiRDBパケット情報のLOBページ参照バッファヒット回数

HiRDB LBUHC

HiRDBパケット情報のLOBページ更新バッファヒット回数

HiRDB LBRDC

HiRDBパケット情報のLOBページディスク入力回数

HiRDB LBWTC

HiRDBパケット情報のLOBページディスク出力回数

HiRDB BFSHC

HiRDBパケット情報のグローバルバッファフラッシュ回数

HiRDB BRDWC

HiRDBパケット情報のグローバルバッファディスク入力待ち回数

HiRDB BWTWC

HiRDBパケット情報のグローバルバッファディスク出力待ち回数

HiRDB BLKWC

HiRDBパケット情報のグローバルバッファの排他待ち回数

HiRDB MWFN

HiRDBパケット情報の作業表用ファイル数の最大値

HiRDB MWFEC

HiRDBパケット情報の作業表用ファイル最大増分回数

HiRDB MWFVL

HiRDBパケット情報の作業表用ファイル最大容量

HiRDB WFRDC

HiRDBパケット情報の作業表用ファイルディスク入力回数

HiRDB WFWTC

HiRDBパケット情報の作業表用ファイルディスク出力回数

HiRDB WBFOC

HiRDBパケット情報の作業表用バッファ強制出力回数

HiRDB MWHTS

HiRDBパケット情報のハッシュ表サイズ推定値

HiRDB MBSL1

HiRDBパケット情報の1レベル最大バケットサイズ

HiRDB MBSL2

HiRDBパケット情報の2レベル最大バケットサイズ

HiRDB MBSL3

HiRDBパケット情報の3レベル最大バケットサイズ

HiRDB SCHSKD

HiRDBパケット情報の空き領域再利用適用除外回数

HiRDB SCHCHG

HiRDBパケット情報の空き領域再利用適用回数

HiRDB LDIRC

HiRDBパケット情報のローカルバッファ参照回数

HiRDB LDIUC

HiRDBパケット情報のローカルバッファ更新回数

HiRDB LDIHC

HiRDBパケット情報のローカルバッファバッファヒット回数

HiRDB LDIRD

HiRDBパケット情報のローカルバッファディスク入力回数

HiRDB LDIWT

HiRDBパケット情報のローカルバッファディスク出力回数

HiRDB LBFSHC

HiRDBパケット情報のローカルバッファフラッシュ回数

HiRDB LCKCTC

HiRDBパケット情報の排他制御用プール排他要求回数

HiRDB LCKCWC

HiRDBパケット情報の排他制御用プール排他待ち回数

HiRDB LCKCWQ

HiRDBパケット情報の排他制御用プール排他待ち行列数合計値

HiRDB LCKCQM

HiRDBパケット情報の排他制御用プール排他待ち行列数最大値

HiRDB JNLFTC

HiRDBパケット情報のログフラッシュ要求回数

HiRDB JNLFWC

HiRDBパケット情報のログフラッシュ待ち回数

HiRDB JNLFWT

HiRDBパケット情報のログフラッシュ待ち時間合計値

hh:mm:ss.SSSSSS形式

HiRDB JNLFTM

HiRDBパケット情報のログフラッシュ待ち時間最大値

hh:mm:ss.SSSSSS形式

HiRDB JNLFWQ

HiRDBパケット情報のログフラッシュ待ち行列数合計値

HiRDB JNLFQM

HiRDBパケット情報のログフラッシュ待ち行列数最大値

HiRDB BUFHTC

HiRDBパケット情報のグローバルバッファプール排他要求回数

HiRDB BUFHWC

HiRDBパケット情報のグローバルバッファプール排他待ち回数

HiRDB BUFHWT

HiRDBパケット情報のグローバルバッファプール排他待ち時間合計値

hh:mm:ss.SSSSSS形式

HiRDB BUFHTM

HiRDBパケット情報のグローバルバッファプール排他待ち時間最大値

hh:mm:ss.SSSSSS形式

HiRDB BUFHWQ

HiRDBパケット情報のグローバルバッファプール排他待ち行列数合計値

HiRDB BUFHQM

HiRDBパケット情報のグローバルバッファプール排他待ち行列数最大値

HiRDB TUSEG

HiRDBパケット情報の一時表使用セグメント数合計

注：RPCパケット情報のとき、データ行は項番1～20だけに値を出力します。ほかは""を出力します。PRFトレース情報のとき、データ行は項番1、2、21～31だけに値を出力します。ほかは""を出力します。HiRDBパケット情報のとき、データ行は項番1、2、32～125だけに値を出力します。ほかは""を出力します。出力内容にマルチバイト文字がある場合、文字化けするおそれがあります。

付録D.3　出力形式3

ファイルの出力形式

CSVファイルの出力形式3および出力内容を説明します。

図D‒3　CSVファイルの出力形式3

出力内容

タイトル行とデータ行の出力内容を次の表で示します。

タイトル行の内容

データ行の内容

TEL Key

電文キー

Request time

SQL要求時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

Reply time

SQL応答時刻

YYYY-MM-DD hh:mm:ss.SSSSSS形式

Response time

レスポンスタイム(μ秒単位)

SQL statement

SQL文

最大で1023バイトまで出力

Client IP address

クライアントIPアドレス

Client Port

クライアントポート番号

Server IP address

サーバIPアドレス

Server Port

サーバポート番号

Section number

セクション番号

Operation code

オペレーションコード

SQL code

SQLコード

Fetch line number

FETCH文での検索行数

SQL error message

SQLエラーメッセージ

最大で127バイトまで出力

SQLWARN6

ロールバックフラグ

UAP statistics information existence

UAP統計情報有無

Y：項番17～94にデータを出力

N：項番17～94に""を出力

SVNAME

接続先サーバ名

CNCTNO

接続先コネクト通番

SVPID

接続先プロセスID

WAITT

排他待ち時間

hh:mm:ss.SSSSSS形式

CTIME

CPU時間(ミリ秒)

ROREQ

ストアドプロシジャオブジェクト取得要求回数

ROHITS

ストアドプロシジャオブジェクトバッファヒット回数

SOREQ

SQLオブジェクト取得要求回数

SOHITS

SQLオブジェクトバッファヒット回数

SOCRT

SQLオブジェクト作成回数

SOMAX

作成したSQLオブジェクトサイズ最大値

FROW

FETCH-SELECT文での検索行数

DROW

DELETE文での削除行数

IROW

INSERT文での挿入行数

UROW

UPDATE文での更新行数

SET

前処理実行回数

OPEN

OPEN文実行回数

FETC

FETC文実行回数

CLOS

CLOSE文実行回数

SEL

SELECT文実行回数

INS

INSERT文実行回数

UPD

UPDATE文実行回数

DEL

DELETE文実行回数

LOCK

LOCK文実行回数

CALL

CALL文実行回数

MAXIO

ディスク入出力時間の最大値

hh:mm:ss.SSSSSS形式

MINIO

ディスク入出力時間の最小値

hh:mm:ss.SSSSSS形式

IOTIM

ディスク入出力時間の累計

hh:mm:ss.SSSSSS形式

DIDRC

DBページ参照回数

DIDUC

DBページ更新回数

DIDHC

DBページバッファヒット回数

DIDRD

DBページディスク入力回数

DIDWT

DBページディスク出力回数

LBRFC

LOBページ参照回数

LBUPC

LOBページ更新回数

LBRHC

LOBページ参照バッファヒット回数

LBUHC

LOBページ更新バッファヒット回数

LBRDC

LOBページディスク入力回数

LBWTC

LOBページディスク出力回数

BFSHC

グローバルバッファフラッシュ回数

BRDWC

グローバルバッファディスク入力待ち回数

BWTWC

グローバルバッファディスク出力待ち回数

BLKWC

グローバルバッファの排他待ち回数

MWFN

作業表用ファイル数の最大値

MWFEC

作業表用ファイル最大増分回数

MWFVL

作業表用ファイル最大容量

WFRDC

作業表用ファイルディスク入力回数

WFWTC

作業表用ファイルディスク出力回数

WBFOC

作業表用バッファ強制出力回数

MWHTS

ハッシュ表サイズ推定値

MBSL1

1レベル最大バケットサイズ

MBSL2

2レベル最大バケットサイズ

MBSL3

3レベル最大バケットサイズ

SCHSKD

空き領域再利用適用除外回数

SCHCHG

空き領域再利用適用回数

LDIRC

ローカルバッファ参照回数

LDIUC

ローカルバッファ更新回数

LDIHC

ローカルバッファバッファヒット回数

LDIRD

ローカルバッファディスク入力回数

LDIWT

ローカルバッファディスク出力回数

LBFSHC

ローカルバッファフラッシュ回数

LCKCTC

排他制御用プール排他要求回数

LCKCWC

排他制御用プール排他待ち回数

LCKCWQ

排他制御用プール排他待ち行列数合計値

LCKCQM

排他制御用プール排他待ち行列数最大値

JNLFTC

ログフラッシュ要求回数

JNLFWC

ログフラッシュ待ち回数

JNLFWT

ログフラッシュ待ち時間合計値

hh:mm:ss.SSSSSS形式

JNLFTM

ログフラッシュ待ち時間最大値

hh:mm:ss.SSSSSS形式

JNLFWQ

ログフラッシュ待ち行列数合計値

JNLFQM

ログフラッシュ待ち行列数最大値

BUFHTC

グローバルバッファプール排他要求回数

BUFHWC

グローバルバッファプール排他待ち回数

BUFHWT

グローバルバッファプール排他待ち時間合計値

hh:mm:ss.SSSSSS形式

BUFHTM

グローバルバッファプール排他待ち時間最大値

hh:mm:ss.SSSSSS形式

BUFHWQ

グローバルバッファプール排他待ち行列数合計値

BUFHQM

グローバルバッファプール排他待ち行列数最大値

TUSEG

一時表使用セグメント数合計

付録D.4　出力形式4

ファイルの出力形式

CSVファイルの出力形式4および出力内容を説明します。

「付録D.3　出力形式3」を参照してください。

出力内容

「付録D.3　出力形式3」を参照してください。

SQL文が複数のオペレーションコードで実行されているときの出力形式3との相違点を次に示します。

Request timeは、先頭のオペレーションコードのSQL要求時刻を設定

Reply timeは、最終のオペレーションコードのSQL応答時刻を設定

Operation codeとSQL codeは、0以外のSQLCODEがあったときのOperation codeとSQLCODEを優先して設定

Fetch line numberは、全オペレーションコードの合計値を設定

索引

C

COUNT要求[1]

E

es_rtm_count[1]

es_rtm_get[1]

es_rtm_init[1]

es_rtm_term[1]

esipclscn[1]

esjobls[1]

esrtmls[1]

esrtmrasget[1]

esrtmsetup[1], [2]

esrtmstart[1], [2]

esrtmstced[1], [2]

esrtmstop[1]

esrtmtrced[1]

esrtmunsetup[1]

F

Flash Player[1], [2]

G

GET要求[1]

H

HiRDB[1]

HiRDBプロトコル[1]

HiRDBプロトコル定義[1]

Hitachi System Information Capture[1], [2]

Hitachi System Information Capture - Real-Time Monitor[1]

HSICRealTimeMonitor_ROOT[1]

HTTPプロトコル[1]

HTTPプロトコル定義[1]

I

IIOPプロトコル[1]

IIOPプロトコル定義[1]

INIT要求[1]

Internet Explorer[1], [2]

J

Java VMオプションファイル[1]

JP1/IM連携[1]

JP1/IM連携機能[1]

JP1/IM連携の設定[1]

P

PRFキー[1]

PRFトレース[1]

R

RPCプロトコル[1], [2]

RPCプロトコル定義[1]

S

SDP_HNTRCLASSPATH[1]

SOAPプロトコル[1]

T

TCPプロトコル[1]

TCPプロトコル定義[1]

TERM要求[1]

TP1/Client[1], [2]

TP1/Server Base[1], [2]

TPS分析[1], [2]

U

UOCの位置づけ[1]

UOCの作成[1]

W

Webコンテナサーバ用オプション定義ファイル[1]

Webブラウザ[1]

Webブラウザの「最新の情報に更新」[1]

あ

アダプタ連携関連定義[1]

アラート検知[1]

アラート検知画面[1]

アラートのメール通知の概要[1]

アンインストール[1]

い

インストールディレクトリの構成[1]

う

運用コマンドの一覧[1]

運用コマンドの記述形式[1]

運用ディレクトリの構成[1]

か

開始終了UOC[1]

稼働情報画面[1]

稼働情報管理ファイル[1]

稼働情報詳細画面[1]

稼働情報蓄積関連定義[1]

稼働情報抽出ユティリティ[1]

UAPの作成[1]

ライブラリ関数の概要[1]

ライブラリ関数の詳細[1]

ライブラリ関数の説明形式[1]

ライブラリ関数の発行順序[1]

稼働情報抽出ユティリティによる稼働情報の抽出[1]

稼働情報抽出ユティリティのライブラリ関数の一覧[1]

稼働情報の蓄積で使用するファイル[1]

稼働情報のファイル出力[1]

稼働情報ファイル[1]

稼働情報ファイルの編集出力[1]

稼働情報ファイルへの稼働情報の蓄積[1]

稼働情報分析関連定義[1]

稼働情報編集UOC[1]

画面情報関連定義[1]

関連付け情報画面[1]

関連付け情報検索画面[1]

き

起動[1]

く

グラフ画面[1]

グラフ比較画面[1]

こ

コネクションの表示[1]

コマンドによる稼働情報のファイル出力[1]

さ

サーバ間連携関連定義[1]

サーバ間連携機能[1]

サーバ間連携機能の注意事項[1]

サーバ間連携機能を使用する場合の環境設定[1]

サーバ間連携機能を使用する場合のシステム構成[1]

し

システム検証支援基盤（Hitachi System Information Capture）[1]

システム検証支援基盤のプロセスの状態表示[1]

システム構成[1]

システム構成（サーバ間連携機能を使用する場合）[1]

システムコンフィグプロパティファイル[1]

システム定義の一覧[1]

システム定義の記述形式[1]

システム定義の説明で使用する記号[1]

システムの運用時のトラブル[1]

システムの運用の流れ[1]

システムの稼働状況を確認する[1]

システムの起動[1]

システムの構築の準備[1]

システムの構築の流れ[1]

システム分析支援アダプタ[1]

システム分析支援アダプタで使用できるUOC[1]

システム分析支援アダプタのディレクトリ構成[1]

システム分析支援リアルタイムモニタ[1]

システム分析支援リアルタイムモニタが出力できるJP1イベント[1]

システム分析支援リアルタイムモニタ定義ファイルの定義の種類[1]

システム分析支援リアルタイムモニタのインストール[1]

システム分析支援リアルタイムモニタのディレクトリ構成[1]

システムを停止する[1]

実行環境のアンセットアップ[1]

実行環境の作成[1]

実行環境のセットアップ[1], [2]

出力形式1[1]

出力形式2[1]

出力形式3[1]

出力形式4[1]

せ

前提プログラムのインストール[1]

た

他システム連携関連定義[1]

ダッシュボード画面の一覧[1]

ダッシュボードの起動[1]

ダッシュボードの表示情報の更新[1]

ダッシュボードを表示するWebブラウザの設定[1]

つ

通信プロトコル[1]

て

定義ファイルの作成[1]

停止[1]

電文組立UOC[1]

電文情報設定UOC[1]

と

トラブルシュート関連定義[1]

トラブルシュートの手順[1]

トランザクション[1]

は

バージョンアップ[1]

外れ値検知[1]

ひ

比較情報画面[1]

ふ

ブラウザプラグイン[1]

プロセスの状態表示[1]

プロトコル関連定義[1], [2], [3], [4], [5]

へ

平均応答時間分析[1], [2]

ほ

保守資料の取得[1]

め

メイン画面[1]

メールの形式[1]

メッセージログの記述形式[1]

メッセージログのタイトルおよびラベル行形式[1]

メッセージログの注意事項[1]

メッセージログのレコード行形式[1]

ゆ

ユーザープログラム関連定義[1]

れ

レスポンス監視[1], [2]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号